[gmt] 03/03: Imported Upstream version 5.1.2+dfsg1
Sebastiaan Couwenberg
sebastic at moszumanska.debian.org
Sun Jun 7 18:32:52 UTC 2015
This is an automated email from the git hooks/post-receive script.
sebastic pushed a commit to branch upstream
in repository gmt.
commit 88e172abc9c19854d475535e0dad30f4a08dd112
Author: Bas Couwenberg <sebastic at xs4all.nl>
Date: Sun Jun 7 11:42:51 2015 +0200
Imported Upstream version 5.1.2+dfsg1
---
doc_release/html/.buildinfo | 4 -
doc_release/html/B.html | 146 -
doc_release/html/F.html | 145 -
doc_release/html/GM.html | 163 -
doc_release/html/GMT_API.html | 2917 ------
doc_release/html/GMT_Docs.html | 10471 -------------------
doc_release/html/GR.html | 171 -
doc_release/html/Gallery.html | 354 -
doc_release/html/I.html | 144 -
doc_release/html/K.html | 144 -
doc_release/html/M.html | 145 -
doc_release/html/N.html | 144 -
doc_release/html/P.html | 144 -
doc_release/html/PS.html | 159 -
doc_release/html/S.html | 151 -
doc_release/html/SUP_GSHHS.html | 144 -
doc_release/html/SUP_IMGSRC.html | 145 -
doc_release/html/SUP_MECA.html | 147 -
doc_release/html/SUP_MGD77.html | 151 -
doc_release/html/SUP_MISC.html | 144 -
doc_release/html/SUP_POTENTIAL.html | 148 -
doc_release/html/SUP_SEGY.html | 146 -
doc_release/html/SUP_SPOTTER.html | 150 -
doc_release/html/SUP_X2SYS.html | 153 -
doc_release/html/T.html | 146 -
doc_release/html/Users_contrib_script.html | 162 -
doc_release/html/Users_contrib_symbols.html | 154 -
doc_release/html/X.html | 144 -
doc_release/html/_images/GMT4_mode.png | Bin 65017 -> 0 bytes
doc_release/html/_images/GMT5_Summit_2011.jpg | Bin 154645 -> 0 bytes
doc_release/html/_images/GMT5_mode.png | Bin 180980 -> 0 bytes
doc_release/html/_images/GMT_-B_custom.png | Bin 10815 -> 0 bytes
doc_release/html/_images/GMT_-B_geo_1.png | Bin 3849 -> 0 bytes
doc_release/html/_images/GMT_-B_geo_2.png | Bin 10590 -> 0 bytes
doc_release/html/_images/GMT_-B_linear.png | Bin 5824 -> 0 bytes
doc_release/html/_images/GMT_-B_log.png | Bin 11816 -> 0 bytes
doc_release/html/_images/GMT_-B_pow.png | Bin 8640 -> 0 bytes
doc_release/html/_images/GMT_-B_time1.png | Bin 3353 -> 0 bytes
doc_release/html/_images/GMT_-B_time2.png | Bin 6488 -> 0 bytes
doc_release/html/_images/GMT_-B_time3.png | Bin 2335 -> 0 bytes
doc_release/html/_images/GMT_-B_time4.png | Bin 3382 -> 0 bytes
doc_release/html/_images/GMT_-B_time5.png | Bin 5140 -> 0 bytes
doc_release/html/_images/GMT_-B_time6.png | Bin 3147 -> 0 bytes
doc_release/html/_images/GMT_-B_time7.png | Bin 2707 -> 0 bytes
doc_release/html/_images/GMT_-J.png | Bin 31164 -> 0 bytes
doc_release/html/_images/GMT_-OK.png | Bin 18525 -> 0 bytes
doc_release/html/_images/GMT_-P.png | Bin 5368 -> 0 bytes
doc_release/html/_images/GMT_-R.png | Bin 76948 -> 0 bytes
doc_release/html/_images/GMT_-U.png | Bin 4925 -> 0 bytes
doc_release/html/_images/GMT_-XY.png | Bin 3347 -> 0 bytes
doc_release/html/_images/GMT_App_E.png | Bin 279552 -> 0 bytes
doc_release/html/_images/GMT_App_F_stand+_iso+.png | Bin 151389 -> 0 bytes
.../html/_images/GMT_App_F_symbol_dingbats.png | Bin 83962 -> 0 bytes
doc_release/html/_images/GMT_App_G.png | Bin 71129 -> 0 bytes
doc_release/html/_images/GMT_App_J_1.png | Bin 21330 -> 0 bytes
doc_release/html/_images/GMT_App_J_2.png | Bin 22808 -> 0 bytes
doc_release/html/_images/GMT_App_J_3.png | Bin 21671 -> 0 bytes
doc_release/html/_images/GMT_App_K_1.png | Bin 118035 -> 0 bytes
doc_release/html/_images/GMT_App_K_2.png | Bin 78219 -> 0 bytes
doc_release/html/_images/GMT_App_K_3.png | Bin 68820 -> 0 bytes
doc_release/html/_images/GMT_App_K_4.png | Bin 53841 -> 0 bytes
doc_release/html/_images/GMT_App_K_5.png | Bin 59337 -> 0 bytes
doc_release/html/_images/GMT_App_M_1a.png | Bin 46803 -> 0 bytes
doc_release/html/_images/GMT_App_M_1b.png | Bin 40421 -> 0 bytes
doc_release/html/_images/GMT_App_M_2.png | Bin 94649 -> 0 bytes
doc_release/html/_images/GMT_App_N_1.png | Bin 57074 -> 0 bytes
doc_release/html/_images/GMT_App_O_1.png | Bin 66382 -> 0 bytes
doc_release/html/_images/GMT_App_O_2.png | Bin 66055 -> 0 bytes
doc_release/html/_images/GMT_App_O_3.png | Bin 65556 -> 0 bytes
doc_release/html/_images/GMT_App_O_4.png | Bin 68452 -> 0 bytes
doc_release/html/_images/GMT_App_O_5.png | Bin 67636 -> 0 bytes
doc_release/html/_images/GMT_App_O_6.png | Bin 73998 -> 0 bytes
doc_release/html/_images/GMT_App_O_7.png | Bin 71522 -> 0 bytes
doc_release/html/_images/GMT_App_O_8.png | Bin 76784 -> 0 bytes
doc_release/html/_images/GMT_App_O_9.png | Bin 742238 -> 0 bytes
doc_release/html/_images/GMT_App_P_2.png | Bin 149195 -> 0 bytes
doc_release/html/_images/GMT_Defaults_1a.png | Bin 20520 -> 0 bytes
doc_release/html/_images/GMT_Defaults_1b.png | Bin 32393 -> 0 bytes
doc_release/html/_images/GMT_Defaults_1c.png | Bin 34892 -> 0 bytes
doc_release/html/_images/GMT_RGBchart_a4.png | Bin 486113 -> 0 bytes
doc_release/html/_images/GMT_TM.png | Bin 86946 -> 0 bytes
doc_release/html/_images/GMT_albers.png | Bin 60309 -> 0 bytes
doc_release/html/_images/GMT_arrows.png | Bin 18879 -> 0 bytes
doc_release/html/_images/GMT_az_equidistant.png | Bin 132086 -> 0 bytes
doc_release/html/_images/GMT_cassini.png | Bin 34771 -> 0 bytes
doc_release/html/_images/GMT_chunking.png | Bin 24332 -> 0 bytes
doc_release/html/_images/GMT_color_interpolate.png | Bin 15122 -> 0 bytes
doc_release/html/_images/GMT_eckert4.png | Bin 86893 -> 0 bytes
doc_release/html/_images/GMT_eckert6.png | Bin 89680 -> 0 bytes
doc_release/html/_images/GMT_equi_cyl.png | Bin 49729 -> 0 bytes
doc_release/html/_images/GMT_equidistant_conic.png | Bin 57692 -> 0 bytes
doc_release/html/_images/GMT_gall_stereo.png | Bin 90634 -> 0 bytes
doc_release/html/_images/GMT_general_cyl.png | Bin 71221 -> 0 bytes
doc_release/html/_images/GMT_gnomonic.png | Bin 117393 -> 0 bytes
doc_release/html/_images/GMT_grinten.png | Bin 126193 -> 0 bytes
doc_release/html/_images/GMT_hammer.png | Bin 65057 -> 0 bytes
doc_release/html/_images/GMT_lambert_az_hemi.png | Bin 58657 -> 0 bytes
doc_release/html/_images/GMT_lambert_az_rect.png | Bin 39283 -> 0 bytes
doc_release/html/_images/GMT_lambert_conic.png | Bin 118755 -> 0 bytes
doc_release/html/_images/GMT_linear.png | Bin 10658 -> 0 bytes
doc_release/html/_images/GMT_linear_cal.png | Bin 11732 -> 0 bytes
doc_release/html/_images/GMT_linear_d.png | Bin 97031 -> 0 bytes
doc_release/html/_images/GMT_linecap.png | Bin 4544 -> 0 bytes
doc_release/html/_images/GMT_log.png | Bin 9560 -> 0 bytes
doc_release/html/_images/GMT_mercator.png | Bin 37779 -> 0 bytes
doc_release/html/_images/GMT_miller.png | Bin 79694 -> 0 bytes
doc_release/html/_images/GMT_mollweide.png | Bin 71432 -> 0 bytes
doc_release/html/_images/GMT_obl_merc.png | Bin 64881 -> 0 bytes
doc_release/html/_images/GMT_orthographic.png | Bin 100832 -> 0 bytes
doc_release/html/_images/GMT_perspective.png | Bin 134252 -> 0 bytes
doc_release/html/_images/GMT_polar.png | Bin 56695 -> 0 bytes
doc_release/html/_images/GMT_polyconic.png | Bin 93953 -> 0 bytes
doc_release/html/_images/GMT_pow.png | Bin 9884 -> 0 bytes
doc_release/html/_images/GMT_registration.png | Bin 5850 -> 0 bytes
doc_release/html/_images/GMT_robinson.png | Bin 65364 -> 0 bytes
doc_release/html/_images/GMT_sinus_int.png | Bin 88760 -> 0 bytes
doc_release/html/_images/GMT_sinusoidal.png | Bin 67537 -> 0 bytes
.../html/_images/GMT_stereographic_general.png | Bin 45827 -> 0 bytes
.../html/_images/GMT_stereographic_polar.png | Bin 83375 -> 0 bytes
.../html/_images/GMT_stereographic_rect.png | Bin 79226 -> 0 bytes
doc_release/html/_images/GMT_stereonets.png | Bin 38870 -> 0 bytes
doc_release/html/_images/GMT_transverse_merc.png | Bin 59198 -> 0 bytes
doc_release/html/_images/GMT_utm_zones.png | Bin 141187 -> 0 bytes
doc_release/html/_images/GMT_volcano.png | Bin 50844 -> 0 bytes
doc_release/html/_images/GMT_winkel.png | Bin 79772 -> 0 bytes
doc_release/html/_images/anim_01.png | Bin 8414 -> 0 bytes
doc_release/html/_images/anim_02.png | Bin 657937 -> 0 bytes
doc_release/html/_images/anim_03.png | Bin 68990 -> 0 bytes
doc_release/html/_images/anim_04.png | Bin 820767 -> 0 bytes
doc_release/html/_images/example_01.png | Bin 480222 -> 0 bytes
doc_release/html/_images/example_02.png | Bin 702225 -> 0 bytes
doc_release/html/_images/example_03.png | Bin 99335 -> 0 bytes
doc_release/html/_images/example_04.png | Bin 625936 -> 0 bytes
doc_release/html/_images/example_05.png | Bin 313176 -> 0 bytes
doc_release/html/_images/example_06.png | Bin 76912 -> 0 bytes
doc_release/html/_images/example_07.png | Bin 254802 -> 0 bytes
doc_release/html/_images/example_08.png | Bin 592930 -> 0 bytes
doc_release/html/_images/example_09.png | Bin 394711 -> 0 bytes
doc_release/html/_images/example_10.png | Bin 266459 -> 0 bytes
doc_release/html/_images/example_11.png | Bin 312521 -> 0 bytes
doc_release/html/_images/example_12.png | Bin 262192 -> 0 bytes
doc_release/html/_images/example_13.png | Bin 170956 -> 0 bytes
doc_release/html/_images/example_14.png | Bin 123313 -> 0 bytes
doc_release/html/_images/example_15.png | Bin 323014 -> 0 bytes
doc_release/html/_images/example_16.png | Bin 313486 -> 0 bytes
doc_release/html/_images/example_17.png | Bin 1188376 -> 0 bytes
doc_release/html/_images/example_18.png | Bin 895766 -> 0 bytes
doc_release/html/_images/example_19.png | Bin 590248 -> 0 bytes
doc_release/html/_images/example_20.png | Bin 187948 -> 0 bytes
doc_release/html/_images/example_21.png | Bin 115420 -> 0 bytes
doc_release/html/_images/example_22.png | Bin 261474 -> 0 bytes
doc_release/html/_images/example_23.png | Bin 442811 -> 0 bytes
doc_release/html/_images/example_24.png | Bin 200943 -> 0 bytes
doc_release/html/_images/example_25.png | Bin 388104 -> 0 bytes
doc_release/html/_images/example_26.png | Bin 262196 -> 0 bytes
doc_release/html/_images/example_27.png | Bin 2076778 -> 0 bytes
doc_release/html/_images/example_28.png | Bin 1386164 -> 0 bytes
doc_release/html/_images/example_29.png | Bin 1264208 -> 0 bytes
doc_release/html/_images/example_30.png | Bin 58682 -> 0 bytes
doc_release/html/_images/example_31.png | Bin 274700 -> 0 bytes
doc_release/html/_images/example_32.png | Bin 230770 -> 0 bytes
doc_release/html/_images/example_33.png | Bin 1457726 -> 0 bytes
doc_release/html/_images/example_34.png | Bin 1074048 -> 0 bytes
doc_release/html/_images/example_35.png | Bin 677591 -> 0 bytes
doc_release/html/_images/example_36.png | Bin 479921 -> 0 bytes
doc_release/html/_images/example_37.png | Bin 1081959 -> 0 bytes
doc_release/html/_images/example_38.png | Bin 821787 -> 0 bytes
doc_release/html/_images/example_39.png | Bin 1350481 -> 0 bytes
doc_release/html/_images/example_40.png | Bin 140431 -> 0 bytes
doc_release/html/_images/formatpicture.png | Bin 52380 -> 0 bytes
doc_release/html/_images/gimp-sliders+panel.png | Bin 38656 -> 0 bytes
doc_release/html/_images/hsv-cone.png | Bin 192082 -> 0 bytes
.../014c6fe6e6a7f82a9e18633f9b981d8ffe99306a.png | Bin 444 -> 0 bytes
.../0278631977e0f39ca6a0d67360de82349f5c774a.png | Bin 1092 -> 0 bytes
.../068772bfc9e1712b9f59428fc167650df7791178.png | Bin 641 -> 0 bytes
.../09e7ee7c2a541bc883180197b413c80c4551895d.png | Bin 504 -> 0 bytes
.../0b38ec67684d250b4d0315f2c34f103be8e3e411.png | Bin 259 -> 0 bytes
.../0bb1e43191efcfe04a430d80616fa31c38a9ca40.png | Bin 535 -> 0 bytes
.../0e5f5d1f79ce0963ea633cffc0378758eb49eee4.png | Bin 833 -> 0 bytes
.../1019740221002dc58daf09a2184f50a7e91b4a38.png | Bin 1656 -> 0 bytes
.../10c14503c4ca38a5fd23f22f93567acbc9f34fab.png | Bin 338 -> 0 bytes
.../10e009bdb83f96c5f47c58b34d5d4b12ef268d5b.png | Bin 242 -> 0 bytes
.../17b38e3a5d0e4a294258e8c390605a620a9d2bb4.png | Bin 511 -> 0 bytes
.../195374909526226d6dd908206784056573e69009.png | Bin 344 -> 0 bytes
.../1abe0c9c17f3a82460dc45a38bd48c925c5b396b.png | Bin 351 -> 0 bytes
.../1b4f055cfa78bceb89a4c9c9c18402158f0ef0c4.png | Bin 643 -> 0 bytes
.../1da275241154bbf43844c575ae595078e429e04d.png | Bin 356 -> 0 bytes
.../1e5fe94895278bbdc7c2fcef3151fac1b8fa761b.png | Bin 431 -> 0 bytes
.../2298cf1485084afe72757a9c8483af49a138d81f.png | Bin 215 -> 0 bytes
.../2593411df0122575686389de04320006190b7322.png | Bin 434 -> 0 bytes
.../26c030c66862238374569a6e9f30af876c0c99c8.png | Bin 413 -> 0 bytes
.../288021fe133ecee94a15fbfad51a537adc9bc799.png | Bin 486 -> 0 bytes
.../296ab33356160c5a5d59477d3e898f58888f0bdb.png | Bin 245 -> 0 bytes
.../2a378fd7cd8686bb483dcc6f4790095409d59cdb.png | Bin 290 -> 0 bytes
.../2fd8d00206c7d35b6265096bb73a7a057d8ca82d.png | Bin 166 -> 0 bytes
.../30d032d772f65301dabe9c7b6fd5136bebd0efcd.png | Bin 413 -> 0 bytes
.../31ef81fb7b36be5589d39867b7d7e9bbfa764e6a.png | Bin 201 -> 0 bytes
.../35981e0b8a56ea987d1f7b8d208f011536161c25.png | Bin 743 -> 0 bytes
.../387801783066cdce72bb6d7a962d3179a9112f9e.png | Bin 262 -> 0 bytes
.../395ab6aba7689ba6e6b4289b0bbbcf2e3fed8887.png | Bin 281 -> 0 bytes
.../3ae01849dc5cdf884a6ca6c31cc84029073c9bbb.png | Bin 258 -> 0 bytes
.../46252e38f851c458622d9a7168b5c70ce0d24ff7.png | Bin 1487 -> 0 bytes
.../48b410286f2d12b6925c3a64fc876a850f1231a5.png | Bin 727 -> 0 bytes
.../4a6bc0b33fc0ffe9fb5b688659922045cc2e2322.png | Bin 292 -> 0 bytes
.../4a95a463cafda90b27a80aa8adeadb5434c1a154.png | Bin 349 -> 0 bytes
.../4bee6c8143f58f4fe181c0845298f4bd28cc61e1.png | Bin 295 -> 0 bytes
.../4cc59ba75365fde3a7a3a0972826e2602ffb9f74.png | Bin 547 -> 0 bytes
.../4d337ec017642f10dd1cbc47640678a90f5bf479.png | Bin 405 -> 0 bytes
.../50350164c952c03e2a680975542ac943b17ebc6f.png | Bin 351 -> 0 bytes
.../5380f0fc713ea8f057cef95a40f671076f4ea764.png | Bin 328 -> 0 bytes
.../5b146592a85ad23658360f6f0241129f95e3f9e6.png | Bin 392 -> 0 bytes
.../5cb03b9ea0160aacf2a8c57c8f87e00609b6baf6.png | Bin 667 -> 0 bytes
.../693faad2f042b0565c90df7cfced16cb9413c166.png | Bin 241 -> 0 bytes
.../6b75387ee6cca3f5d8be8ee597ddf999e89fddb6.png | Bin 390 -> 0 bytes
.../6fa7e33b3d861018ef49fe4b11d353763a0c7183.png | Bin 377 -> 0 bytes
.../6ff3988690ca5f07e1274bbc4e7536fda2a5f555.png | Bin 326 -> 0 bytes
.../70667f5a1cc0894b0fbd9abaf10ad9b13a2f65c1.png | Bin 219 -> 0 bytes
.../71fea5f956b7e847a34650b42ab079913ea710a1.png | Bin 920 -> 0 bytes
.../739563300258a3a4f54ff4e9b397dcf9c3f524f5.png | Bin 304 -> 0 bytes
.../795ea6abc60ad6201a8e025e49dff601315f867b.png | Bin 139 -> 0 bytes
.../7accc7b32c5ebf62f18c1c3b11d5fefe61e31f13.png | Bin 408 -> 0 bytes
.../7b3e5f3cd3642b0eb9132f765e143e4fd18f176a.png | Bin 691 -> 0 bytes
.../7c95f79979e59a8c813e6d3f842ecb7a1ca33cb7.png | Bin 530 -> 0 bytes
.../7cbe56ceca10d17d290aa6650dbb52cb30a56ad5.png | Bin 355 -> 0 bytes
.../7dc674e394ba36a90b8ddf5fcc87dbe1c092c1a8.png | Bin 813 -> 0 bytes
.../7e20a15268e648a91d5932a5212bcdb2b5b17922.png | Bin 263 -> 0 bytes
.../7e5891b0094f6bce182a4d436a76c2ff0371673f.png | Bin 1055 -> 0 bytes
.../83ee01e8e074450e92e4056d0f1fdda5442d34ba.png | Bin 322 -> 0 bytes
.../869a1cc0e74f4485021e0fa597dbabde276a7153.png | Bin 365 -> 0 bytes
.../8a11600e981f11d0873afeb7b6616e7d9bdd8aea.png | Bin 318 -> 0 bytes
.../8b9fdedc917a22959b26aa1933f3ba330975fa2a.png | Bin 855 -> 0 bytes
.../8c669a3486252783fe9a20e3b080f7ae97749928.png | Bin 265 -> 0 bytes
.../8cf361aac86ee78b34583ff56fc0ec842389daac.png | Bin 452 -> 0 bytes
.../92c25fa25f006cdfe8ef28f3d3141e558aaac740.png | Bin 222 -> 0 bytes
.../9b80b6afe46efc8f6defe96b68ff0c1a6992063e.png | Bin 374 -> 0 bytes
.../a893e2f5944325dd6dc9c50ea8e51619a1d6c4bb.png | Bin 1012 -> 0 bytes
.../a9cfbeb8ebee1f365919e147a79e242dcb67ee5d.png | Bin 241 -> 0 bytes
.../ad59b6e24a4a00ac621801f8d7513d68be654ab5.png | Bin 228 -> 0 bytes
.../aded9f7d4047915a113044df7b6a067b6c939130.png | Bin 418 -> 0 bytes
.../afd2a44a547679d529befa08e1e6c4699bf1dcee.png | Bin 726 -> 0 bytes
.../b257c3b1343de1fd2a489ff0cb82636e790a339f.png | Bin 256 -> 0 bytes
.../b31b1ea8e4fe3f618dedfb0e2d8c69a3df7a391d.png | Bin 235 -> 0 bytes
.../b35a9439ad8c8657b1b1d792ad5c2d77a52c0aef.png | Bin 231 -> 0 bytes
.../b5cde2c9425ca10f85e8313d3c932871df9bde64.png | Bin 496 -> 0 bytes
.../b9d9437b637001fdf6d0899ddf6c3258d8e04296.png | Bin 349 -> 0 bytes
.../ba965e654c5ec9abe8bf921fd41e7e3b43dde4b0.png | Bin 266 -> 0 bytes
.../bc72083139d50ca1c82eff5c34358cbf59681589.png | Bin 319 -> 0 bytes
.../bcee6c37dfd1a7a67d3822d10237dc01ce594b3b.png | Bin 504 -> 0 bytes
.../be491eb56d45c1acfd43c8ffd9faf848b245a47f.png | Bin 433 -> 0 bytes
.../bf648023c5ad7bdbf4d2216ab0c0c735a53cd195.png | Bin 445 -> 0 bytes
.../c25c28183d05c687a78814901f4c72cd533bad55.png | Bin 214 -> 0 bytes
.../c2f20eff2112fdc5d8e16ed16276fbf7a9e4b2aa.png | Bin 276 -> 0 bytes
.../c3c08496f07567285212e468b173bea9ca153fab.png | Bin 250 -> 0 bytes
.../c53a18c6d4f4b9e4ffcdcb4334fddc185bed5606.png | Bin 931 -> 0 bytes
.../c5dd45762fff5ecd449ce021d8c9d79e7ce0228f.png | Bin 437 -> 0 bytes
.../c69691d64985442217922c8d34e835a9dea60178.png | Bin 193 -> 0 bytes
.../c7ca48f867cc97d68b163a2af6d919e9c0946ecb.png | Bin 1189 -> 0 bytes
.../cce2bc22b994e1fe14f6bc3077fa77b64a0555f0.png | Bin 525 -> 0 bytes
.../d49f1c024407380df81f487799de241fa4e9d29f.png | Bin 248 -> 0 bytes
.../d60c41febe30c67efaee8216fe35af082d6cab6e.png | Bin 836 -> 0 bytes
.../de66977e7eb1a104b8a5f8ae0c626f7e6594f9b8.png | Bin 353 -> 0 bytes
.../e42055dc76c465a7738328232a9ed4a0e4d5d7bc.png | Bin 515 -> 0 bytes
.../e4af8dccac00219b863b8d3e54ec16c00b56bab2.png | Bin 484 -> 0 bytes
.../e6c0bd5b79c290b47b422e07545c3757ca182270.png | Bin 260 -> 0 bytes
.../e7dd26bab98d33d93cdd54aa2b75e8622cd88726.png | Bin 430 -> 0 bytes
.../ee7aa56d2b8706d40a5f2a2567ee71d67171d5b3.png | Bin 991 -> 0 bytes
.../ef43507b4741e98bc4b61f4db403014529dd469c.png | Bin 354 -> 0 bytes
.../f30c7e391f4cef1d7b14050b5916c857c0979cb5.png | Bin 252 -> 0 bytes
.../f71cb1117d2cc55d5b606da6f24200896cbad58b.png | Bin 308 -> 0 bytes
.../f7e73389b494d356293b5ad9e3601a3a61609e96.png | Bin 271 -> 0 bytes
.../f8117cd5193e9c43e4cac4a86cc0298690ef3f79.png | Bin 310 -> 0 bytes
.../f89c41c37bb6f9cb2ed3731079e099d908b0cfa0.png | Bin 711 -> 0 bytes
doc_release/html/_images/pirata.png | Bin 2554 -> 0 bytes
doc_release/html/_images/rendering.png | Bin 179765 -> 0 bytes
doc_release/html/_images/vertical_slice.png | Bin 109556 -> 0 bytes
doc_release/html/_sources/B.txt | 10 -
doc_release/html/_sources/F.txt | 9 -
doc_release/html/_sources/GM.txt | 27 -
doc_release/html/_sources/GMT_API.txt | 2772 -----
doc_release/html/_sources/GMT_Docs.txt | 9990 ------------------
doc_release/html/_sources/GR.txt | 35 -
doc_release/html/_sources/Gallery.txt | 276 -
doc_release/html/_sources/I.txt | 8 -
doc_release/html/_sources/K.txt | 8 -
doc_release/html/_sources/M.txt | 9 -
doc_release/html/_sources/N.txt | 8 -
doc_release/html/_sources/P.txt | 8 -
doc_release/html/_sources/PS.txt | 23 -
doc_release/html/_sources/S.txt | 15 -
doc_release/html/_sources/SUP_GSHHS.txt | 8 -
doc_release/html/_sources/SUP_IMGSRC.txt | 9 -
doc_release/html/_sources/SUP_MECA.txt | 11 -
doc_release/html/_sources/SUP_MGD77.txt | 15 -
doc_release/html/_sources/SUP_MISC.txt | 8 -
doc_release/html/_sources/SUP_POTENTIAL.txt | 12 -
doc_release/html/_sources/SUP_SEGY.txt | 10 -
doc_release/html/_sources/SUP_SPOTTER.txt | 14 -
doc_release/html/_sources/SUP_X2SYS.txt | 17 -
doc_release/html/_sources/T.txt | 10 -
doc_release/html/_sources/Users_contrib_script.txt | 21 -
.../html/_sources/Users_contrib_symbols.txt | 19 -
doc_release/html/_sources/X.txt | 8 -
doc_release/html/_sources/api.txt | 9 -
doc_release/html/_sources/blockmean.txt | 141 -
doc_release/html/_sources/blockmedian.txt | 163 -
doc_release/html/_sources/blockmode.txt | 166 -
doc_release/html/_sources/cookbook.txt | 9 -
doc_release/html/_sources/filter1d.txt | 178 -
doc_release/html/_sources/fitcircle.txt | 132 -
doc_release/html/_sources/gallery/anim01.txt | 30 -
doc_release/html/_sources/gallery/anim02.txt | 27 -
doc_release/html/_sources/gallery/anim03.txt | 20 -
doc_release/html/_sources/gallery/anim04.txt | 40 -
.../html/_sources/gallery/anim_introduction.txt | 111 -
doc_release/html/_sources/gallery/ex01.txt | 34 -
doc_release/html/_sources/gallery/ex02.txt | 53 -
doc_release/html/_sources/gallery/ex03.txt | 50 -
doc_release/html/_sources/gallery/ex04.txt | 47 -
doc_release/html/_sources/gallery/ex05.txt | 37 -
doc_release/html/_sources/gallery/ex06.txt | 23 -
doc_release/html/_sources/gallery/ex07.txt | 34 -
doc_release/html/_sources/gallery/ex08.txt | 21 -
doc_release/html/_sources/gallery/ex09.txt | 38 -
doc_release/html/_sources/gallery/ex10.txt | 27 -
doc_release/html/_sources/gallery/ex11.txt | 38 -
doc_release/html/_sources/gallery/ex12.txt | 25 -
doc_release/html/_sources/gallery/ex13.txt | 26 -
doc_release/html/_sources/gallery/ex14.txt | 34 -
doc_release/html/_sources/gallery/ex15.txt | 36 -
doc_release/html/_sources/gallery/ex16.txt | 63 -
doc_release/html/_sources/gallery/ex17.txt | 39 -
doc_release/html/_sources/gallery/ex18.txt | 32 -
doc_release/html/_sources/gallery/ex19.txt | 30 -
doc_release/html/_sources/gallery/ex20.txt | 98 -
doc_release/html/_sources/gallery/ex21.txt | 42 -
doc_release/html/_sources/gallery/ex22.txt | 35 -
doc_release/html/_sources/gallery/ex23.txt | 38 -
doc_release/html/_sources/gallery/ex24.txt | 39 -
doc_release/html/_sources/gallery/ex25.txt | 49 -
doc_release/html/_sources/gallery/ex26.txt | 30 -
doc_release/html/_sources/gallery/ex27.txt | 47 -
doc_release/html/_sources/gallery/ex28.txt | 36 -
doc_release/html/_sources/gallery/ex29.txt | 35 -
doc_release/html/_sources/gallery/ex30.txt | 22 -
doc_release/html/_sources/gallery/ex31.txt | 36 -
doc_release/html/_sources/gallery/ex32.txt | 52 -
doc_release/html/_sources/gallery/ex33.txt | 22 -
doc_release/html/_sources/gallery/ex34.txt | 21 -
doc_release/html/_sources/gallery/ex35.txt | 21 -
doc_release/html/_sources/gallery/ex36.txt | 25 -
doc_release/html/_sources/gallery/ex37.txt | 21 -
doc_release/html/_sources/gallery/ex38.txt | 18 -
doc_release/html/_sources/gallery/ex39.txt | 23 -
doc_release/html/_sources/gallery/ex40.txt | 18 -
.../users_contrib_script/vertical_slice.txt | 131 -
.../gallery/users_contrib_symbols/pirata.txt | 6 -
doc_release/html/_sources/gmt.conf.txt | 1181 ---
doc_release/html/_sources/gmt.txt | 187 -
doc_release/html/_sources/gmt2kml.txt | 358 -
doc_release/html/_sources/gmt5syntax.txt | 27 -
.../html/_sources/gmt_shell_functions.sh.txt | 144 -
doc_release/html/_sources/gmtcolors.txt | 1085 --
doc_release/html/_sources/gmtconnect.txt | 166 -
doc_release/html/_sources/gmtconvert.txt | 253 -
doc_release/html/_sources/gmtdefaults.txt | 89 -
doc_release/html/_sources/gmtget.txt | 67 -
doc_release/html/_sources/gmtinfo.txt | 177 -
doc_release/html/_sources/gmtlogo.txt | 48 -
doc_release/html/_sources/gmtmath.txt | 657 --
doc_release/html/_sources/gmtselect.txt | 274 -
doc_release/html/_sources/gmtset.txt | 81 -
doc_release/html/_sources/gmtsimplify.txt | 137 -
doc_release/html/_sources/gmtspatial.txt | 207 -
doc_release/html/_sources/gmtswitch.txt | 153 -
doc_release/html/_sources/gmtvector.txt | 200 -
doc_release/html/_sources/gmtwhich.txt | 60 -
doc_release/html/_sources/grd2cpt.txt | 193 -
doc_release/html/_sources/grd2rgb.txt | 101 -
doc_release/html/_sources/grd2xyz.txt | 158 -
doc_release/html/_sources/grdblend.txt | 172 -
doc_release/html/_sources/grdclip.txt | 94 -
doc_release/html/_sources/grdcontour.txt | 252 -
doc_release/html/_sources/grdcut.txt | 118 -
doc_release/html/_sources/grdedit.txt | 141 -
doc_release/html/_sources/grdfft.txt | 217 -
doc_release/html/_sources/grdfilter.txt | 210 -
doc_release/html/_sources/grdgradient.txt | 191 -
doc_release/html/_sources/grdhisteq.txt | 139 -
doc_release/html/_sources/grdimage.txt | 250 -
doc_release/html/_sources/grdinfo.txt | 112 -
doc_release/html/_sources/grdlandmask.txt | 104 -
doc_release/html/_sources/grdmask.txt | 156 -
doc_release/html/_sources/grdmath.txt | 629 --
doc_release/html/_sources/grdpaste.txt | 74 -
doc_release/html/_sources/grdproject.txt | 150 -
doc_release/html/_sources/grdraster.txt | 121 -
doc_release/html/_sources/grdreformat.txt | 269 -
doc_release/html/_sources/grdsample.txt | 113 -
doc_release/html/_sources/grdtrack.txt | 275 -
doc_release/html/_sources/grdtrend.txt | 117 -
doc_release/html/_sources/grdvector.txt | 160 -
doc_release/html/_sources/grdview.txt | 244 -
doc_release/html/_sources/grdvolume.txt | 151 -
doc_release/html/_sources/greenspline.txt | 390 -
doc_release/html/_sources/index.txt | 68 -
doc_release/html/_sources/isogmt.txt | 37 -
doc_release/html/_sources/kml2gmt.txt | 71 -
doc_release/html/_sources/makecpt.txt | 166 -
doc_release/html/_sources/man_pages.txt | 146 -
doc_release/html/_sources/mapproject.txt | 294 -
doc_release/html/_sources/nearneighbor.txt | 150 -
doc_release/html/_sources/project.txt | 271 -
doc_release/html/_sources/ps2raster.txt | 344 -
doc_release/html/_sources/psbasemap.txt | 494 -
doc_release/html/_sources/psclip.txt | 163 -
doc_release/html/_sources/pscoast.txt | 318 -
doc_release/html/_sources/pscontour.txt | 250 -
doc_release/html/_sources/pshistogram.txt | 196 -
doc_release/html/_sources/psimage.txt | 185 -
doc_release/html/_sources/pslegend.txt | 304 -
doc_release/html/_sources/pslib.txt | 882 --
doc_release/html/_sources/psmask.txt | 179 -
doc_release/html/_sources/psrose.txt | 198 -
doc_release/html/_sources/psscale.txt | 214 -
doc_release/html/_sources/pstext.txt | 288 -
doc_release/html/_sources/pswiggle.txt | 183 -
doc_release/html/_sources/psxy.txt | 281 -
doc_release/html/_sources/psxyz.txt | 241 -
doc_release/html/_sources/sample1d.txt | 176 -
doc_release/html/_sources/spectrum1d.txt | 260 -
doc_release/html/_sources/sph2grd.txt | 120 -
doc_release/html/_sources/sphdistance.txt | 138 -
doc_release/html/_sources/sphinterpolate.txt | 135 -
doc_release/html/_sources/sphtriangulate.txt | 141 -
doc_release/html/_sources/splitxyz.txt | 177 -
.../html/_sources/supplements/gshhg/gshhg.txt | 179 -
.../html/_sources/supplements/img/img2google.txt | 136 -
.../html/_sources/supplements/img/img2grd.txt | 254 -
.../html/_sources/supplements/meca/pscoupe.txt | 374 -
.../html/_sources/supplements/meca/psmeca.txt | 370 -
.../html/_sources/supplements/meca/pspolar.txt | 199 -
.../html/_sources/supplements/meca/psvelo.txt | 274 -
.../_sources/supplements/mgd77/mgd77convert.txt | 158 -
.../html/_sources/supplements/mgd77/mgd77info.txt | 155 -
.../html/_sources/supplements/mgd77/mgd77list.txt | 586 --
.../_sources/supplements/mgd77/mgd77magref.txt | 238 -
.../_sources/supplements/mgd77/mgd77manage.txt | 386 -
.../html/_sources/supplements/mgd77/mgd77path.txt | 90 -
.../_sources/supplements/mgd77/mgd77sniffer.txt | 501 -
.../html/_sources/supplements/mgd77/mgd77track.txt | 172 -
.../html/_sources/supplements/misc/dimfilter.txt | 220 -
.../supplements/potential/gmtgravmag3d.txt | 138 -
.../_sources/supplements/potential/gravfft.txt | 293 -
.../supplements/potential/grdgravmag3d.txt | 117 -
.../_sources/supplements/potential/grdredpol.txt | 124 -
.../_sources/supplements/potential/grdseamount.txt | 116 -
.../html/_sources/supplements/segy/pssegy.txt | 175 -
.../html/_sources/supplements/segy/pssegyz.txt | 173 -
.../html/_sources/supplements/segy/segy2grd.txt | 119 -
.../_sources/supplements/spotter/backtracker.txt | 193 -
.../_sources/supplements/spotter/grdpmodeler.txt | 148 -
.../_sources/supplements/spotter/grdrotater.txt | 162 -
.../_sources/supplements/spotter/grdspotter.txt | 183 -
.../_sources/supplements/spotter/hotspotter.txt | 148 -
.../_sources/supplements/spotter/originator.txt | 201 -
.../_sources/supplements/spotter/rotconverter.txt | 151 -
.../_sources/supplements/x2sys/x2sys_binlist.txt | 94 -
.../_sources/supplements/x2sys/x2sys_cross.txt | 183 -
.../_sources/supplements/x2sys/x2sys_datalist.txt | 169 -
.../html/_sources/supplements/x2sys/x2sys_get.txt | 121 -
.../html/_sources/supplements/x2sys/x2sys_init.txt | 354 -
.../html/_sources/supplements/x2sys/x2sys_list.txt | 157 -
.../_sources/supplements/x2sys/x2sys_merge.txt | 65 -
.../html/_sources/supplements/x2sys/x2sys_put.txt | 84 -
.../_sources/supplements/x2sys/x2sys_report.txt | 121 -
.../_sources/supplements/x2sys/x2sys_solve.txt | 153 -
doc_release/html/_sources/surface.txt | 205 -
doc_release/html/_sources/testapi.txt | 91 -
doc_release/html/_sources/trend1d.txt | 180 -
doc_release/html/_sources/trend2d.txt | 192 -
doc_release/html/_sources/triangulate.txt | 177 -
doc_release/html/_sources/xyz2grd.txt | 205 -
doc_release/html/_static/ajax-loader.gif | Bin 673 -> 0 bytes
doc_release/html/_static/basic.css | 537 -
doc_release/html/_static/bg-header1.png | Bin 6985 -> 0 bytes
doc_release/html/_static/bg-header2.png | Bin 5151 -> 0 bytes
doc_release/html/_static/comment-bright.png | Bin 3500 -> 0 bytes
doc_release/html/_static/comment-close.png | Bin 3578 -> 0 bytes
doc_release/html/_static/comment.png | Bin 3445 -> 0 bytes
doc_release/html/_static/default.css | 256 -
doc_release/html/_static/doctools.js | 238 -
doc_release/html/_static/down-pressed.png | Bin 368 -> 0 bytes
doc_release/html/_static/down.png | Bin 363 -> 0 bytes
doc_release/html/_static/file.png | Bin 392 -> 0 bytes
doc_release/html/_static/jquery.js | 2 -
doc_release/html/_static/minus.png | Bin 199 -> 0 bytes
doc_release/html/_static/plus.png | Bin 199 -> 0 bytes
doc_release/html/_static/pygments.css | 63 -
doc_release/html/_static/rtd-sidebar.js | 174 -
doc_release/html/_static/rtd.css | 807 --
doc_release/html/_static/searchtools.js | 622 --
doc_release/html/_static/sidebar.js | 159 -
doc_release/html/_static/underscore.js | 31 -
doc_release/html/_static/up-pressed.png | Bin 372 -> 0 bytes
doc_release/html/_static/up.png | Bin 363 -> 0 bytes
doc_release/html/_static/websupport.js | 808 --
doc_release/html/api.html | 148 -
doc_release/html/blockmean.html | 336 -
doc_release/html/blockmedian.html | 362 -
doc_release/html/blockmode.html | 362 -
doc_release/html/cookbook.html | 171 -
doc_release/html/filter1d.html | 337 -
doc_release/html/fitcircle.html | 303 -
doc_release/html/gallery/anim01.html | 242 -
doc_release/html/gallery/anim02.html | 228 -
doc_release/html/gallery/anim03.html | 217 -
doc_release/html/gallery/anim04.html | 251 -
doc_release/html/gallery/anim_introduction.html | 245 -
doc_release/html/gallery/ex01.html | 187 -
doc_release/html/gallery/ex02.html | 209 -
doc_release/html/gallery/ex03.html | 383 -
doc_release/html/gallery/ex04.html | 215 -
doc_release/html/gallery/ex05.html | 187 -
doc_release/html/gallery/ex06.html | 170 -
doc_release/html/gallery/ex07.html | 203 -
doc_release/html/gallery/ex08.html | 168 -
doc_release/html/gallery/ex09.html | 186 -
doc_release/html/gallery/ex10.html | 186 -
doc_release/html/gallery/ex11.html | 262 -
doc_release/html/gallery/ex12.html | 195 -
doc_release/html/gallery/ex13.html | 180 -
doc_release/html/gallery/ex14.html | 215 -
doc_release/html/gallery/ex15.html | 200 -
doc_release/html/gallery/ex16.html | 229 -
doc_release/html/gallery/ex17.html | 216 -
doc_release/html/gallery/ex18.html | 245 -
doc_release/html/gallery/ex19.html | 209 -
doc_release/html/gallery/ex20.html | 261 -
doc_release/html/gallery/ex21.html | 262 -
doc_release/html/gallery/ex22.html | 266 -
doc_release/html/gallery/ex23.html | 230 -
doc_release/html/gallery/ex24.html | 196 -
doc_release/html/gallery/ex25.html | 223 -
doc_release/html/gallery/ex26.html | 200 -
doc_release/html/gallery/ex27.html | 222 -
doc_release/html/gallery/ex28.html | 195 -
doc_release/html/gallery/ex29.html | 210 -
doc_release/html/gallery/ex30.html | 219 -
doc_release/html/gallery/ex31.html | 270 -
doc_release/html/gallery/ex32.html | 248 -
doc_release/html/gallery/ex33.html | 193 -
doc_release/html/gallery/ex34.html | 174 -
doc_release/html/gallery/ex35.html | 179 -
doc_release/html/gallery/ex36.html | 179 -
doc_release/html/gallery/ex37.html | 203 -
doc_release/html/gallery/ex38.html | 179 -
doc_release/html/gallery/ex39.html | 189 -
doc_release/html/gallery/ex40.html | 186 -
.../users_contrib_script/vertical_slice.html | 256 -
.../html/gallery/users_contrib_symbols/pirata.html | 889 --
doc_release/html/genindex.html | 768 --
doc_release/html/gmt.conf.html | 1202 ---
doc_release/html/gmt.html | 1559 ---
doc_release/html/gmt2kml.html | 477 -
doc_release/html/gmt5syntax.html | 168 -
doc_release/html/gmt_shell_functions.sh.html | 252 -
doc_release/html/gmtcolors.html | 2741 -----
doc_release/html/gmtconnect.html | 347 -
doc_release/html/gmtconvert.html | 424 -
doc_release/html/gmtdefaults.html | 240 -
doc_release/html/gmtget.html | 210 -
doc_release/html/gmtinfo.html | 350 -
doc_release/html/gmtlogo.html | 190 -
doc_release/html/gmtmath.html | 1140 --
doc_release/html/gmtselect.html | 477 -
doc_release/html/gmtset.html | 233 -
doc_release/html/gmtsimplify.html | 325 -
doc_release/html/gmtspatial.html | 402 -
doc_release/html/gmtswitch.html | 293 -
doc_release/html/gmtvector.html | 368 -
doc_release/html/gmtwhich.html | 215 -
doc_release/html/grd2cpt.html | 360 -
doc_release/html/grd2rgb.html | 278 -
doc_release/html/grd2xyz.html | 358 -
doc_release/html/grdblend.html | 379 -
doc_release/html/grdclip.html | 277 -
doc_release/html/grdcontour.html | 566 -
doc_release/html/grdcut.html | 324 -
doc_release/html/grdedit.html | 355 -
doc_release/html/grdfft.html | 437 -
doc_release/html/grdfilter.html | 385 -
doc_release/html/grdgradient.html | 373 -
doc_release/html/grdhisteq.html | 324 -
doc_release/html/grdimage.html | 465 -
doc_release/html/grdinfo.html | 301 -
doc_release/html/grdlandmask.html | 344 -
doc_release/html/grdmask.html | 381 -
doc_release/html/grdmath.html | 1227 ---
doc_release/html/grdpaste.html | 259 -
doc_release/html/grdproject.html | 333 -
doc_release/html/grdraster.html | 324 -
doc_release/html/grdreformat.html | 459 -
doc_release/html/grdsample.html | 338 -
doc_release/html/grdtrack.html | 498 -
doc_release/html/grdtrend.html | 299 -
doc_release/html/grdvector.html | 397 -
doc_release/html/grdview.html | 465 -
doc_release/html/grdvolume.html | 338 -
doc_release/html/greenspline.html | 543 -
doc_release/html/index.html | 491 -
doc_release/html/isogmt.html | 178 -
doc_release/html/kml2gmt.html | 227 -
doc_release/html/makecpt.html | 316 -
doc_release/html/man_pages.html | 289 -
doc_release/html/mapproject.html | 482 -
doc_release/html/nearneighbor.html | 352 -
doc_release/html/objects.inv | Bin 8084 -> 0 bytes
doc_release/html/project.html | 432 -
doc_release/html/ps2raster.html | 477 -
doc_release/html/psbasemap.html | 754 --
doc_release/html/psclip.html | 346 -
doc_release/html/pscoast.html | 547 -
doc_release/html/pscontour.html | 553 -
doc_release/html/pshistogram.html | 375 -
doc_release/html/psimage.html | 361 -
doc_release/html/pslegend.html | 471 -
doc_release/html/pslib.html | 965 --
doc_release/html/psmask.html | 392 -
doc_release/html/psrose.html | 411 -
doc_release/html/psscale.html | 395 -
doc_release/html/pstext.html | 461 -
doc_release/html/pswiggle.html | 363 -
doc_release/html/psxy.html | 792 --
doc_release/html/psxyz.html | 765 --
doc_release/html/sample1d.html | 359 -
doc_release/html/search.html | 141 -
doc_release/html/searchindex.js | 1 -
doc_release/html/spectrum1d.html | 414 -
doc_release/html/sph2grd.html | 346 -
doc_release/html/sphdistance.html | 361 -
doc_release/html/sphinterpolate.html | 342 -
doc_release/html/sphtriangulate.html | 306 -
doc_release/html/splitxyz.html | 349 -
doc_release/html/supplements/gshhg/gshhg.html | 322 -
doc_release/html/supplements/img/img2google.html | 287 -
doc_release/html/supplements/img/img2grd.html | 424 -
doc_release/html/supplements/meca/pscoupe.html | 562 -
doc_release/html/supplements/meca/psmeca.html | 542 -
doc_release/html/supplements/meca/pspolar.html | 382 -
doc_release/html/supplements/meca/psvelo.html | 496 -
.../html/supplements/mgd77/mgd77convert.html | 328 -
doc_release/html/supplements/mgd77/mgd77info.html | 321 -
doc_release/html/supplements/mgd77/mgd77list.html | 741 --
.../html/supplements/mgd77/mgd77magref.html | 360 -
.../html/supplements/mgd77/mgd77manage.html | 552 -
doc_release/html/supplements/mgd77/mgd77path.html | 259 -
.../html/supplements/mgd77/mgd77sniffer.html | 671 --
doc_release/html/supplements/mgd77/mgd77track.html | 379 -
doc_release/html/supplements/misc/dimfilter.html | 404 -
.../html/supplements/potential/gmtgravmag3d.html | 285 -
.../html/supplements/potential/gravfft.html | 514 -
.../html/supplements/potential/grdgravmag3d.html | 288 -
.../html/supplements/potential/grdredpol.html | 270 -
.../html/supplements/potential/grdseamount.html | 289 -
doc_release/html/supplements/segy/pssegy.html | 357 -
doc_release/html/supplements/segy/pssegyz.html | 355 -
doc_release/html/supplements/segy/segy2grd.html | 290 -
.../html/supplements/spotter/backtracker.html | 370 -
.../html/supplements/spotter/grdpmodeler.html | 317 -
.../html/supplements/spotter/grdrotater.html | 363 -
.../html/supplements/spotter/grdspotter.html | 373 -
.../html/supplements/spotter/hotspotter.html | 356 -
.../html/supplements/spotter/originator.html | 363 -
.../html/supplements/spotter/rotconverter.html | 297 -
.../html/supplements/x2sys/x2sys_binlist.html | 265 -
.../html/supplements/x2sys/x2sys_cross.html | 366 -
.../html/supplements/x2sys/x2sys_datalist.html | 350 -
doc_release/html/supplements/x2sys/x2sys_get.html | 295 -
doc_release/html/supplements/x2sys/x2sys_init.html | 690 --
doc_release/html/supplements/x2sys/x2sys_list.html | 331 -
.../html/supplements/x2sys/x2sys_merge.html | 207 -
doc_release/html/supplements/x2sys/x2sys_put.html | 242 -
.../html/supplements/x2sys/x2sys_report.html | 295 -
.../html/supplements/x2sys/x2sys_solve.html | 304 -
doc_release/html/surface.html | 398 -
doc_release/html/testapi.html | 211 -
doc_release/html/trend1d.html | 350 -
doc_release/html/trend2d.html | 361 -
doc_release/html/triangulate.html | 359 -
doc_release/html/xyz2grd.html | 432 -
doc_release/pdf/GMT_API.pdf | Bin 461620 -> 0 bytes
doc_release/pdf/GMT_Docs.pdf | Bin 18144663 -> 0 bytes
doc_release/pdf/GMT_Manpages.pdf | Bin 2447714 -> 0 bytes
doc_release/pdf/GMT_RGBchart_a4.pdf | Bin 45568 -> 0 bytes
doc_release/pdf/GMT_RGBchart_letter.pdf | Bin 45029 -> 0 bytes
doc_release/pdf/GMT_RGBchart_tabloid.pdf | Bin 49404 -> 0 bytes
man_release/backtracker.1.gz | Bin 3964 -> 0 bytes
man_release/blockmean.1.gz | Bin 3383 -> 0 bytes
man_release/blockmedian.1.gz | Bin 3817 -> 0 bytes
man_release/blockmode.1.gz | Bin 3892 -> 0 bytes
man_release/dimfilter.1.gz | Bin 4958 -> 0 bytes
man_release/filter1d.1.gz | Bin 3393 -> 0 bytes
man_release/fitcircle.1.gz | Bin 2781 -> 0 bytes
man_release/gmt.1.gz | Bin 17064 -> 0 bytes
man_release/gmt.conf.5.gz | Bin 15855 -> 0 bytes
man_release/gmt2kml.1.gz | Bin 5754 -> 0 bytes
man_release/gmt5syntax.1.gz | Bin 618 -> 0 bytes
man_release/gmt_shell_functions.sh.1.gz | Bin 1975 -> 0 bytes
man_release/gmtcolors.5.gz | Bin 5312 -> 0 bytes
man_release/gmtconnect.1.gz | Bin 3469 -> 0 bytes
man_release/gmtconvert.1.gz | Bin 4135 -> 0 bytes
man_release/gmtdefaults.1.gz | Bin 1683 -> 0 bytes
man_release/gmtget.1.gz | Bin 1006 -> 0 bytes
man_release/gmtgravmag3d.1.gz | Bin 2594 -> 0 bytes
man_release/gmtinfo.1.gz | Bin 3501 -> 0 bytes
man_release/gmtlogo.1.gz | Bin 834 -> 0 bytes
man_release/gmtmath.1.gz | Bin 9085 -> 0 bytes
man_release/gmtselect.1.gz | Bin 5772 -> 0 bytes
man_release/gmtset.1.gz | Bin 1670 -> 0 bytes
man_release/gmtsimplify.1.gz | Bin 2923 -> 0 bytes
man_release/gmtspatial.1.gz | Bin 4740 -> 0 bytes
man_release/gmtswitch.1.gz | Bin 2705 -> 0 bytes
man_release/gmtvector.1.gz | Bin 3549 -> 0 bytes
man_release/gmtwhich.1.gz | Bin 1252 -> 0 bytes
man_release/gravfft.1.gz | Bin 6960 -> 0 bytes
man_release/grd2cpt.1.gz | Bin 4227 -> 0 bytes
man_release/grd2rgb.1.gz | Bin 2561 -> 0 bytes
man_release/grd2xyz.1.gz | Bin 3835 -> 0 bytes
man_release/grdblend.1.gz | Bin 4574 -> 0 bytes
man_release/grdclip.1.gz | Bin 2525 -> 0 bytes
man_release/grdcontour.1.gz | Bin 7380 -> 0 bytes
man_release/grdcut.1.gz | Bin 3422 -> 0 bytes
man_release/grdedit.1.gz | Bin 3813 -> 0 bytes
man_release/grdfft.1.gz | Bin 5270 -> 0 bytes
man_release/grdfilter.1.gz | Bin 4628 -> 0 bytes
man_release/grdgradient.1.gz | Bin 4529 -> 0 bytes
man_release/grdgravmag3d.1.gz | Bin 2784 -> 0 bytes
man_release/grdhisteq.1.gz | Bin 3566 -> 0 bytes
man_release/grdimage.1.gz | Bin 5594 -> 0 bytes
man_release/grdinfo.1.gz | Bin 3032 -> 0 bytes
man_release/grdlandmask.1.gz | Bin 4421 -> 0 bytes
man_release/grdmask.1.gz | Bin 4392 -> 0 bytes
man_release/grdmath.1.gz | Bin 9881 -> 0 bytes
man_release/grdpaste.1.gz | Bin 2153 -> 0 bytes
man_release/grdpmodeler.1.gz | Bin 2837 -> 0 bytes
man_release/grdproject.1.gz | Bin 3506 -> 0 bytes
man_release/grdraster.1.gz | Bin 3532 -> 0 bytes
man_release/grdredpol.1.gz | Bin 2408 -> 0 bytes
man_release/grdreformat.1.gz | Bin 4490 -> 0 bytes
man_release/grdrotater.1.gz | Bin 3914 -> 0 bytes
man_release/grdsample.1.gz | Bin 3802 -> 0 bytes
man_release/grdseamount.1.gz | Bin 2717 -> 0 bytes
man_release/grdspotter.1.gz | Bin 4641 -> 0 bytes
man_release/grdtrack.1.gz | Bin 6855 -> 0 bytes
man_release/grdtrend.1.gz | Bin 2926 -> 0 bytes
man_release/grdvector.1.gz | Bin 4207 -> 0 bytes
man_release/grdview.1.gz | Bin 5446 -> 0 bytes
man_release/grdvolume.1.gz | Bin 3351 -> 0 bytes
man_release/greenspline.1.gz | Bin 7318 -> 0 bytes
man_release/gshhg.1.gz | Bin 3626 -> 0 bytes
man_release/hotspotter.1.gz | Bin 4077 -> 0 bytes
man_release/img2grd.1.gz | Bin 5290 -> 0 bytes
man_release/isogmt.1.gz | Bin 737 -> 0 bytes
man_release/kml2gmt.1.gz | Bin 1391 -> 0 bytes
man_release/makecpt.1.gz | Bin 3027 -> 0 bytes
man_release/mapproject.1.gz | Bin 6063 -> 0 bytes
man_release/mgd77convert.1.gz | Bin 3179 -> 0 bytes
man_release/mgd77info.1.gz | Bin 3237 -> 0 bytes
man_release/mgd77list.1.gz | Bin 10446 -> 0 bytes
man_release/mgd77magref.1.gz | Bin 3887 -> 0 bytes
man_release/mgd77manage.1.gz | Bin 8347 -> 0 bytes
man_release/mgd77path.1.gz | Bin 1868 -> 0 bytes
man_release/mgd77sniffer.1.gz | Bin 8118 -> 0 bytes
man_release/mgd77track.1.gz | Bin 4046 -> 0 bytes
man_release/nearneighbor.1.gz | Bin 3780 -> 0 bytes
man_release/originator.1.gz | Bin 3934 -> 0 bytes
man_release/project.1.gz | Bin 5015 -> 0 bytes
man_release/ps2raster.1.gz | Bin 6747 -> 0 bytes
man_release/psbasemap.1.gz | Bin 6894 -> 0 bytes
man_release/psclip.1.gz | Bin 2938 -> 0 bytes
man_release/pscoast.1.gz | Bin 7893 -> 0 bytes
man_release/pscontour.1.gz | Bin 6981 -> 0 bytes
man_release/pscoupe.1.gz | Bin 5509 -> 0 bytes
man_release/pshistogram.1.gz | Bin 3321 -> 0 bytes
man_release/psimage.1.gz | Bin 3195 -> 0 bytes
man_release/pslegend.1.gz | Bin 6124 -> 0 bytes
man_release/pslib.3.gz | Bin 15001 -> 0 bytes
man_release/psmask.1.gz | Bin 3877 -> 0 bytes
man_release/psmeca.1.gz | Bin 5306 -> 0 bytes
man_release/pspolar.1.gz | Bin 3614 -> 0 bytes
man_release/psrose.1.gz | Bin 4261 -> 0 bytes
man_release/psscale.1.gz | Bin 4621 -> 0 bytes
man_release/pssegy.1.gz | Bin 3595 -> 0 bytes
man_release/pssegyz.1.gz | Bin 3723 -> 0 bytes
man_release/pstext.1.gz | Bin 5677 -> 0 bytes
man_release/psvelo.1.gz | Bin 5429 -> 0 bytes
man_release/pswiggle.1.gz | Bin 3222 -> 0 bytes
man_release/psxy.1.gz | Bin 10276 -> 0 bytes
man_release/psxyz.1.gz | Bin 9919 -> 0 bytes
man_release/rotconverter.1.gz | Bin 2539 -> 0 bytes
man_release/sample1d.1.gz | Bin 3494 -> 0 bytes
man_release/segy2grd.1.gz | Bin 2779 -> 0 bytes
man_release/spectrum1d.1.gz | Bin 5752 -> 0 bytes
man_release/sph2grd.1.gz | Bin 3928 -> 0 bytes
man_release/sphdistance.1.gz | Bin 4036 -> 0 bytes
man_release/sphinterpolate.1.gz | Bin 3665 -> 0 bytes
man_release/sphtriangulate.1.gz | Bin 2907 -> 0 bytes
man_release/splitxyz.1.gz | Bin 3844 -> 0 bytes
man_release/surface.1.gz | Bin 4869 -> 0 bytes
man_release/trend1d.1.gz | Bin 3704 -> 0 bytes
man_release/trend2d.1.gz | Bin 4000 -> 0 bytes
man_release/triangulate.1.gz | Bin 3598 -> 0 bytes
man_release/x2sys_binlist.1.gz | Bin 2265 -> 0 bytes
man_release/x2sys_cross.1.gz | Bin 4027 -> 0 bytes
man_release/x2sys_datalist.1.gz | Bin 4001 -> 0 bytes
man_release/x2sys_get.1.gz | Bin 2634 -> 0 bytes
man_release/x2sys_init.1.gz | Bin 6336 -> 0 bytes
man_release/x2sys_list.1.gz | Bin 3454 -> 0 bytes
man_release/x2sys_merge.1.gz | Bin 1045 -> 0 bytes
man_release/x2sys_put.1.gz | Bin 1685 -> 0 bytes
man_release/x2sys_report.1.gz | Bin 2720 -> 0 bytes
man_release/x2sys_solve.1.gz | Bin 2500 -> 0 bytes
man_release/xyz2grd.1.gz | Bin 5572 -> 0 bytes
823 files changed, 132208 deletions(-)
diff --git a/doc_release/html/.buildinfo b/doc_release/html/.buildinfo
deleted file mode 100644
index c8f693b..0000000
--- a/doc_release/html/.buildinfo
+++ /dev/null
@@ -1,4 +0,0 @@
-# Sphinx build info version 1
-# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: a454f7f2c61adb884fd098d800bb5ca6
-tags: 645f666f9bcd5a90fca523b33c5a78b7
diff --git a/doc_release/html/B.html b/doc_release/html/B.html
deleted file mode 100644
index 6f50577..0000000
--- a/doc_release/html/B.html
+++ /dev/null
@@ -1,146 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>B — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="next" title="blockmean" href="blockmean.html" />
- <link rel="prev" title="x2sys_solve" href="supplements/x2sys/x2sys_solve.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="blockmean.html" title="blockmean"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="supplements/x2sys/x2sys_solve.html" title="x2sys_solve"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="b">
-<h1>B<a class="headerlink" href="#b" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="blockmean.html">blockmean</a></li>
-<li class="toctree-l1"><a class="reference internal" href="blockmedian.html">blockmedian</a></li>
-<li class="toctree-l1"><a class="reference internal" href="blockmode.html">blockmode</a></li>
-</ul>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="supplements/x2sys/x2sys_solve.html"
- title="previous chapter">x2sys_solve</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="blockmean.html"
- title="next chapter">blockmean</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/B.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="blockmean.html" title="blockmean"
- >next</a> </li>
- <li class="right" >
- <a href="supplements/x2sys/x2sys_solve.html" title="x2sys_solve"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/F.html b/doc_release/html/F.html
deleted file mode 100644
index 296c9c4..0000000
--- a/doc_release/html/F.html
+++ /dev/null
@@ -1,145 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>F — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="next" title="filter1d" href="filter1d.html" />
- <link rel="prev" title="blockmode" href="blockmode.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="filter1d.html" title="filter1d"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="blockmode.html" title="blockmode"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="f">
-<h1>F<a class="headerlink" href="#f" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="filter1d.html">filter1d</a></li>
-<li class="toctree-l1"><a class="reference internal" href="fitcircle.html">fitcircle</a></li>
-</ul>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="blockmode.html"
- title="previous chapter">blockmode</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="filter1d.html"
- title="next chapter">filter1d</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/F.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="filter1d.html" title="filter1d"
- >next</a> </li>
- <li class="right" >
- <a href="blockmode.html" title="blockmode"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/GM.html b/doc_release/html/GM.html
deleted file mode 100644
index 41dc737..0000000
--- a/doc_release/html/GM.html
+++ /dev/null
@@ -1,163 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>GM — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="next" title="gmt.conf" href="gmt.conf.html" />
- <link rel="prev" title="fitcircle" href="fitcircle.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="gmt.conf.html" title="gmt.conf"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="fitcircle.html" title="fitcircle"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gm">
-<h1>GM<a class="headerlink" href="#gm" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="gmt.conf.html">gmt.conf</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmt.html">gmt</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmt2kml.html">gmt2kml</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmt5syntax.html">gmt5syntax</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmtcolors.html">gmtcolors</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmtconnect.html">gmtconnect</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmtconvert.html">gmtconvert</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmtdefaults.html">gmtdefaults</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmtget.html">gmtget</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmtinfo.html">gmtinfo</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmtlogo.html">gmtlogo</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmtmath.html">gmtmath</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmtselect.html">gmtselect</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmtset.html">gmtset</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmt_shell_functions.sh.html">gmt_shell_functions.sh</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmtsimplify.html">gmtsimplify</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmtspatial.html">gmtspatial</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmtswitch.html">gmtswitch</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmtvector.html">gmtvector</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmtwhich.html">gmtwhich</a></li>
-</ul>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="fitcircle.html"
- title="previous chapter">fitcircle</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="gmt.conf.html"
- title="next chapter">gmt.conf</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/GM.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="gmt.conf.html" title="gmt.conf"
- >next</a> </li>
- <li class="right" >
- <a href="fitcircle.html" title="fitcircle"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/GMT_API.html b/doc_release/html/GMT_API.html
deleted file mode 100644
index 0be9b5b..0000000
--- a/doc_release/html/GMT_API.html
+++ /dev/null
@@ -1,2917 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>1. Introduction — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GMT_API" href="api.html" />
- <link rel="prev" title="GMT_API" href="api.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="api.html" title="GMT_API"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="api.html" accesskey="U">GMT_API</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <p><strong>The Generic Mapping Tools</strong></p>
-<p><strong>C/C++ Application Programming Interface</strong></p>
-<p><strong>Pål (Paul) Wessel</strong></p>
-<p><strong>SOEST, University of Hawai’i at Manoa</strong></p>
-<p><strong>Walter H. F. Smith</strong></p>
-<p><strong>Laboratory for Satellite Altimetry, NOAA/NESDIS/STAR</strong></p>
-<p><strong>Remko Scharroo</strong></p>
-<p><strong>EUMETSAT, Darmstadt, Germany</strong></p>
-<p><strong>Joaquim F. Luis</strong></p>
-<p><strong>Universidade do Algarve, Faro, Portugal</strong></p>
-<p><strong>Florian Wobbe</strong></p>
-<p><strong>Alfred Wegener Institute, Germany</strong></p>
-<div class="section" id="introduction">
-<h1>1. Introduction<a class="headerlink" href="#introduction" title="Permalink to this headline">¶</a></h1>
-<div class="section" id="preamble">
-<span id="index-0"></span><h2>1.1. Preamble<a class="headerlink" href="#preamble" title="Permalink to this headline">¶</a></h2>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT4_mode.png"><img alt="_images/GMT4_mode.png" src="_images/GMT4_mode.png" style="width: 506.5px; height: 267.5px;" /></a>
-<p class="caption">GMT 4 programs contain all the high-level functionality.</p>
-</div>
-<p>Prior to version 5, the bulk of GMT functionality was coded directly
-in the standard GMT C program modules (e.g., <tt class="docutils literal"><span class="pre">surface.c</span></tt>, <tt class="docutils literal"><span class="pre">psxy.c</span></tt>, <tt class="docutils literal"><span class="pre">grdimage.c</span></tt>, etc.). The
-GMT library only offered access to low-level functions from which
-those high-level GMT programs were built. The standard GMT programs
-have been very successful, with tens of thousands of users world-wide.
-However, the design of the main programs prevented developers from
-leveraging GMT functionality from within other programming
-environments since access to GMT tools could only be achieved via
-system calls <a class="footnote-reference" href="#id7" id="id1">[1]</a>. Consequently, all data i/o had to be done via
-temporary files. The design also prevented the GMT developers
-themselves from taking advantage of these modules directly. For
-instance, the tool <a class="reference internal" href="pslegend.html"><em>pslegend</em></a> needed to
-make extensive use of system calls to <a class="reference internal" href="psxy.html"><em>psxy</em></a> and
-<a class="reference internal" href="pstext.html"><em>pstext</em></a> in order to plot the lines,
-symbols and text that make up a map legend, making it a very awkward
-program to maintain.</p>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT5_mode.png"><img alt="_images/GMT5_mode.png" src="_images/GMT5_mode.png" style="width: 506.5px; height: 284.5px;" /></a>
-<p class="caption">GMT 5 programs contain all the high-level functionality.</p>
-</div>
-<p>Starting with GMT version 5, all standard GMT programs have been
-split into a short driver program (the “new” GMT programs) and a
-function “module”. The drivers simply call the corresponding
-GMT modules; it is these modules that do all the work. These new
-functions have been placed in a new GMT high-level API library and can
-be called from a variety of environments (C/C++, Fortran, Julia, Python,
-Matlab, Visual Basic, R, etc.) <a class="footnote-reference" href="#id8" id="id2">[2]</a>. For example, the main
-program <tt class="docutils literal"><span class="pre">blockmean.c</span></tt> has been reconfigured as a high-level function
-<tt class="docutils literal"><span class="pre">GMT_blockmean()</span></tt>, which does the actual spatial averaging and can
-pass the result back to the calling program (or write it to file). The
-previous behavior of <tt class="docutils literal"><span class="pre">blockmean.c</span></tt> is replicated by a short driver program that simply
-collects user arguments and then calls <tt class="docutils literal"><span class="pre">GMT_blockmean()</span></tt>. Indeed, the
-driver programs for all the standard GMT programs are identical so
-that the makefile generates them on-the-fly when it compiles and links
-them with the GMT library into executables. Thus, <tt class="docutils literal"><span class="pre">blockmean.c</span></tt> and others do in
-fact no longer exist.</p>
-</div>
-<div class="section" id="the-i-o-abstraction-layer">
-<h2>1.2. The i/o abstraction layer<a class="headerlink" href="#the-i-o-abstraction-layer" title="Permalink to this headline">¶</a></h2>
-<p>In order for this interface to be as flexible as possible we have
-generalized the notion of input and output. Data that already reside in
-an application’s memory may serve as input to a GMT function. Other
-sources of input may be file pointers and file descriptors (as well as
-the already-supported mechanism for passing file names). For standard
-data table i/o, the GMT API takes care of the task of assembling any
-combination of files, pointers, and memory locations into <em>a single
-virtual data set</em> from which the GMT function may read (a) all
-records at once into memory, or (b) read one record at a time. Likewise,
-GMT functions may write their output to a virtual destination, which
-might be a memory location in the user’s application, a file pointer or
-descriptor, or an output file. The GMT functions are unaware of these
-details and simply read from a “source” and write to a “destination”.</p>
-</div>
-<div class="section" id="our-audience">
-<h2>1.3. Our audience<a class="headerlink" href="#our-audience" title="Permalink to this headline">¶</a></h2>
-<p>Here, we document the new functions in the GMT API library for
-application developers who wish to call these functions from their own
-custom programs. At this point, only the new high-level GMT API is
-fully documented and intended for public use. The structure and
-documentation of the under-lying lower-level GMT library is not
-finalized. Developers using these functions may risk disruption to their
-programs due to changes we may make in the library in support of the
-GMT API. However, developers who wish to make supplemental packages to
-be distributed as part of GMT will (other than talk to us) probably
-want to access the entire low-level GMT library as well. It is
-unlikely that the low-level library will ever be fully documented.</p>
-</div>
-<div class="section" id="definitions">
-<h2>1.4. Definitions<a class="headerlink" href="#definitions" title="Permalink to this headline">¶</a></h2>
-<p>For the purpose of this documentation a few definitions are needed:</p>
-<ol class="arabic simple">
-<li>“Standard GMT program” refers to one of the traditional stand-alone
-command-line executables known to all GMT users, e.g.,
-<a class="reference internal" href="blockmean.html"><em>blockmean</em></a>, <a class="reference internal" href="psxy.html"><em>psxy</em></a>,
-<a class="reference internal" href="grdimage.html"><em>grdimage</em></a>, etc. Prior to version 5,
-these were the only GMT executables available.</li>
-<li>“GMT module” refers to the function in the GMT API library that
-is responsible for all the action taken by the corresponding
-GMT program. All such modules are given the same name as the
-corresponding program but carry the prefix <tt class="docutils literal"><span class="pre">GMT_</span></tt>, e.g.,
-<tt class="docutils literal"><span class="pre">GMT_blockmean</span></tt>.</li>
-<li>“GMT application” refers to a new application written by any
-developer and may call one or more GMT functions to create a new
-GMT-compatible executable.</li>
-<li>In the API description that follows we will use the type <tt class="docutils literal"><span class="pre">int</span></tt> to
-mean a 4-byte integer. All integers used in the API are 4-byte
-integers with the exception of one function where a longer integer is
-used. Since different operating systems have their own way of
-defining 8-byte integers we use C99’s <tt class="docutils literal"><span class="pre">int64_t</span></tt> for this purpose;
-it is guaranteed to yield the correct type that the GMT function
-expect.</li>
-</ol>
-<p>In version 5, the standard GMT programs are themselves specific but
-overly simple examples of GMT applications that only call the single
-GMT function they are associated with. However, some programs such as
-<a class="reference internal" href="pslegend.html"><em>pslegend</em></a>, <a class="reference internal" href="gmtconvert.html"><em>gmtconvert</em></a>,
-<a class="reference internal" href="grdblend.html"><em>grdblend</em></a>,
-<a class="reference internal" href="grdfilter.html"><em>grdfilter</em></a> and others call several modules.</p>
-</div>
-<div class="section" id="recognized-resources">
-<h2>1.5. Recognized resources<a class="headerlink" href="#recognized-resources" title="Permalink to this headline">¶</a></h2>
-<p>The GMT API knows how to read and write five types of data common to
-GMT operations: CPT palette tables, data tables (ASCII or binary),
-text tables, GMT grids and images (reading only). In addition, we
-present two data types to facilitate the passing of simple user arrays
-(one or more equal-length data columns of any data type, e.g., double,
-char) and 2-D or 3-D user matrices (of any data type and column/row
-organization <a class="footnote-reference" href="#id9" id="id3">[3]</a>). We refer to these data types as GMT <em>resources</em>.
-There are many attributes for each of these resources and therefore we
-use a top-level structure for each type to keep them all in one
-container. These containers are given or returned by the GMT API
-functions using opaque pointers (<tt class="docutils literal"><span class="pre">void</span> <span class="pre">*</span></tt>). Below we discuss these
-containers in some detail; we will later present how they are used when
-importing or exporting them to or from files, memory locations, or
-streams. The first five are the standard GMT objects, while the latter
-two are the special user data containers to facilitate passing user
-data into and out of GMT modules. These resources are defined in the include
-file <tt class="docutils literal"><span class="pre">gmt_resources.h</span></tt>; please consult this file to ensure correctness
-in case the documentation is not up-to-date.</p>
-<div class="section" id="data-tables">
-<h3>1.5.1. Data tables<a class="headerlink" href="#data-tables" title="Permalink to this headline">¶</a></h3>
-<p>Much data processed in GMT come in the form of ASCII, netCDF, or
-native binary data tables. These may have any number of header records
-(ASCII files only) and perhaps segment headers. GMT programs will read
-one or more such tables when importing data. However, to avoid memory
-duplication or data limitations some programs may prefer to read records one
-at the time. The GMT API has functions that let you read
-record-by-record by presenting a virtual data set that combines all the
-data tables specified as input. This simplifies record processing
-considerably. A <tt class="docutils literal"><span class="pre">struct</span> <span class="pre">GMT_DATASET</span></tt> may contain any number of tables,
-each with any number of segments, each segment with any number of
-records, and each record with any number of columns. Thus, the arguments
-to GMT API functions that handle such data sets expect this type of
-variable. All segments are expected to have the same number of columns.</p>
-<div class="highlight-c" id="struct-dataset"><div class="highlight"><pre><span class="k">struct</span> <span class="n">GMT_DATASET</span> <span class="p">{</span> <span class="cm">/* Single container for an array of GMT tables (files) */</span>
- <span class="cm">/* Variables we document for the API: */</span>
- <span class="kt">uint64_t</span> <span class="n">n_tables</span><span class="p">;</span> <span class="cm">/* The total number of tables (files) contained */</span>
- <span class="kt">uint64_t</span> <span class="n">n_columns</span><span class="p">;</span> <span class="cm">/* The number of data columns */</span>
- <span class="kt">uint64_t</span> <span class="n">n_segments</span><span class="p">;</span> <span class="cm">/* The total number of segments across all tables */</span>
- <span class="kt">uint64_t</span> <span class="n">n_records</span><span class="p">;</span> <span class="cm">/* The total number of data records across all tables */</span>
- <span class="kt">double</span> <span class="o">*</span><span class="n">min</span><span class="p">;</span> <span class="cm">/* Minimum coordinate for each column */</span>
- <span class="kt">double</span> <span class="o">*</span><span class="n">max</span><span class="p">;</span> <span class="cm">/* Maximum coordinate for each column */</span>
- <span class="k">struct</span> <span class="n">GMT_DATATABLE</span> <span class="o">**</span><span class="n">table</span><span class="p">;</span> <span class="cm">/* Pointer to array of tables */</span>
- <span class="cm">/* ---- Variables "hidden" from the API ---- */</span>
- <span class="kt">uint64_t</span> <span class="n">id</span><span class="p">;</span> <span class="cm">/* The internal number of the data set */</span>
- <span class="kt">size_t</span> <span class="n">n_alloc</span><span class="p">;</span> <span class="cm">/* The current allocation length of tables */</span>
- <span class="kt">uint64_t</span> <span class="n">dim</span><span class="p">[</span><span class="mi">4</span><span class="p">];</span> <span class="cm">/* Only used by GMT_Duplicate_Data to override dimensions */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">geometry</span><span class="p">;</span> <span class="cm">/* The geometry of this dataset */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">alloc_level</span><span class="p">;</span> <span class="cm">/* The level it was allocated at */</span>
- <span class="k">enum</span> <span class="n">GMT_enum_dest</span> <span class="n">io_mode</span><span class="p">;</span> <span class="cm">/* -1 means write OGR format (requires proper -a),</span>
-<span class="cm"> 0 means write everything to one destination [Default],</span>
-<span class="cm"> 1 means use table->file[GMT_OUT] to write separate table,</span>
-<span class="cm"> 2 means use segment->file[GMT_OUT] to write separate segments.</span>
-<span class="cm"> 3 is same as 2 but with no filenames we create filenames from</span>
-<span class="cm"> tbl and seg numbers */</span>
- <span class="k">enum</span> <span class="n">GMT_enum_alloc</span> <span class="n">alloc_mode</span><span class="p">;</span> <span class="cm">/* Allocation mode [GMT_ALLOCATED_BY_GMT] */</span>
- <span class="kt">char</span> <span class="o">*</span><span class="n">file</span><span class="p">[</span><span class="mi">2</span><span class="p">];</span> <span class="cm">/* Name of file or source [0 = in, 1 = out] */</span>
-<span class="p">};</span>
-</pre></div>
-</div>
-</div>
-<div class="section" id="text-tables">
-<h3>1.5.2. Text tables<a class="headerlink" href="#text-tables" title="Permalink to this headline">¶</a></h3>
-<p>Some data needed by GMT are simply free-form ASCII text tables. In many respects these
-are handled similarly to data tables. E.g., they may have any number of
-header records and even segment headers, and GMT programs can read one
-or more tables or get text records one at the time. A
-<tt class="docutils literal"><span class="pre">struct</span> <span class="pre">GMT_TEXTSET</span></tt> may contain any number of tables, each with any
-number of segments, and each segment with any number of records. Thus,
-the arguments to GMT API functions that handle such data sets expect
-this type of variable. The user’s program may then parse and process
-such text records as required. This resources is particularly useful
-when your data consist of a mix or data coordinates and ordinary text
-since regular data tables will be parsed for floating-point columns
-only.</p>
-<div class="highlight-c" id="struct-textset"><div class="highlight"><pre>struct GMT_TEXTSET { /* Single container for an array of GMT text tables (files) */
- /* Variables we document for the API: */
- uint64_t n_tables; /* The total number of tables (files) contained */
- uint64_t n_segments; /* The total number of segments across all tables */
- uint64_t n_records; /* The total number of data records across all tables */
- struct GMT_TEXTTABLE **table; /* Pointer to array of tables */
- /* ---- Variables "hidden" from the API ---- */
- uint64_t id; /* The internal number of the data set */
- size_t n_alloc; /* The current allocation length of tables */
- unsigned int geometry; /* The geometry of this dataset */
- unsigned int alloc_level; /* The level it was allocated at */
- enum GMT_enum_dest io_mode; /* -1 means write OGR format (requires proper -a),
- 0 means write everything to one destination [Default],
- 1 means use table->file[GMT_OUT] to write separate table,
- 2 means use segment->file[GMT_OUT] to write separate segments.
- 3 is same as 2 but with no filenames we create filenames */
- from tbl and seg numbers */
- enum GMT_enum_alloc alloc_mode; /* Allocation mode [GMT_ALLOCATED_BY_GMT] */
- char *file[2]; /* Name of file or source [0 = in, 1 = out] */
-};
-</pre></div>
-</div>
-</div>
-<div class="section" id="gmt-grids">
-<h3>1.5.3. GMT grids<a class="headerlink" href="#gmt-grids" title="Permalink to this headline">¶</a></h3>
-<p>GMT grids are used to represent equidistant and organized 2-D
-surfaces. These can be plotted as contour maps, color images, or as
-perspective surfaces. Because the native GMT grid is simply a 1-D
-float array with all the metadata kept in a separate header, we pass
-this information via a <tt class="docutils literal"><span class="pre">struct</span> <span class="pre">GMT_GRID</span></tt>, which is a container that
-holds both items. Thus, the arguments to GMT API functions that handle
-GMT grids expect this type of variable.</p>
-<div class="highlight-c" id="struct-grid"><div class="highlight"><pre><span class="k">struct</span> <span class="n">GMT_GRID</span> <span class="p">{</span> <span class="cm">/* To hold a GMT float grid and its header in one container */</span>
- <span class="k">struct</span> <span class="n">GMT_GRID_HEADER</span> <span class="o">*</span><span class="n">header</span><span class="p">;</span> <span class="cm">/* Pointer to full GMT header for the grid */</span>
- <span class="kt">float</span> <span class="o">*</span><span class="n">data</span><span class="p">;</span> <span class="cm">/* Pointer to the float grid */</span>
- <span class="cm">/* ---- Variables "hidden" from the API ---- */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">id</span><span class="p">;</span> <span class="cm">/* The internal number of the grid */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">alloc_level</span><span class="p">;</span> <span class="cm">/* The level it was allocated at */</span>
- <span class="k">enum</span> <span class="n">GMT_enum_alloc</span> <span class="n">alloc_mode</span><span class="p">;</span> <span class="cm">/* Allocation mode [GMT_ALLOCATED_BY_GMT] */</span>
- <span class="kt">void</span> <span class="o">*</span><span class="n">extra</span><span class="p">;</span> <span class="cm">/* Row-by-row machinery information [NULL] */</span>
-<span class="p">};</span>
-</pre></div>
-</div>
-</div>
-<div class="section" id="gmt-images">
-<h3>1.5.4. GMT images<a class="headerlink" href="#gmt-images" title="Permalink to this headline">¶</a></h3>
-<p>GMT images are used to represent bit-mapped images typically obtained
-via the GDAL bridge. These can be reprojected internally, such as when
-used in grdimage. Since images and grids share the concept of a header,
-we use the same header structure for grids as for images; however, some
-additional metadata attributes are also needed. Finally, the image
-itself may be of any data type and have more than one band (channel).
-Both image and header information are passed via a <tt class="docutils literal"><span class="pre">struct</span> <span class="pre">GMT_IMAGE</span></tt>,
-which is a container that holds both items. Thus, the arguments to
-GMT API functions that handle GMT images expect this type of
-variable. Unlike the other objects, writting images has only partial
-support via <tt class="docutils literal"><span class="pre">GMT_grdimage</span></tt> <a class="footnote-reference" href="#id10" id="id4">[4]</a>.</p>
-<div class="highlight-c" id="struct-image"><div class="highlight"><pre><span class="k">struct</span> <span class="n">GMT_IMAGE</span> <span class="p">{</span>
- <span class="k">enum</span> <span class="n">GMT_enum_type</span> <span class="n">type</span><span class="p">;</span> <span class="cm">/* Data type, e.g. GMT_FLOAT */</span>
- <span class="kt">int</span> <span class="o">*</span><span class="n">ColorMap</span><span class="p">;</span> <span class="cm">/* Array with color lookup values */</span>
- <span class="k">struct</span> <span class="n">GMT_GRID_HEADER</span> <span class="o">*</span><span class="n">header</span><span class="p">;</span> <span class="cm">/* Pointer to full GMT header for the image */</span>
- <span class="kt">unsigned</span> <span class="kt">char</span> <span class="o">*</span><span class="n">data</span><span class="p">;</span> <span class="cm">/* Pointer to actual image */</span>
- <span class="cm">/* ---- Variables "hidden" from the API ---- */</span>
- <span class="kt">uint64_t</span> <span class="n">id</span><span class="p">;</span> <span class="cm">/* The internal number of the data set */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">alloc_level</span><span class="p">;</span> <span class="cm">/* Level of initial allocation */</span>
- <span class="k">enum</span> <span class="n">GMT_enum_alloc</span> <span class="n">alloc_mode</span><span class="p">;</span> <span class="cm">/* Allocation info [0] */</span>
- <span class="k">const</span> <span class="kt">char</span> <span class="o">*</span><span class="n">ColorInterp</span><span class="p">;</span>
-<span class="p">};</span>
-</pre></div>
-</div>
-</div>
-<div class="section" id="cpt-palette-tables">
-<h3>1.5.5. CPT palette tables<a class="headerlink" href="#cpt-palette-tables" title="Permalink to this headline">¶</a></h3>
-<p>The color palette table files, or just CPT tables, contain colors and
-patterns used for plotting data such as surfaces (i.e., GMT grids) or
-symbols, lines and polygons (i.e., GMT tables). GMT programs will
-generally read in a CPT palette table, make it the current palette, do
-the plotting, and destroy the table when done. The information is
-referred to via a pointer to <tt class="docutils literal"><span class="pre">struct</span> <span class="pre">GMT_PALETTE</span></tt>. Thus, the arguments
-to GMT API functions that handle palettes expect this type of
-variable. It is not expected that users will wish to manipulate a CPT
-table directly, but rather use this mechanism to hold them in memory and
-pass as arguments to GMT modules.</p>
-<div class="highlight-c" id="struct-palette"><div class="highlight"><pre><span class="k">struct</span> <span class="n">GMT_PALETTE</span> <span class="p">{</span> <span class="cm">/* Holds all pen, color, and fill-related parameters */</span>
- <span class="cm">/* Variables we document for the API: */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">n_headers</span><span class="p">;</span> <span class="cm">/* Number of CPT file header records (0 if no header) */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">n_colors</span><span class="p">;</span> <span class="cm">/* Number of colors in CPT lookup table */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">cpt_flags</span><span class="p">;</span> <span class="cm">/* Flags controling use of BFN colors */</span>
- <span class="k">struct</span> <span class="n">GMT_LUT</span> <span class="o">*</span><span class="n">range</span><span class="p">;</span> <span class="cm">/* CPT lookup table read by GMT_read_cpt */</span>
- <span class="k">struct</span> <span class="n">GMT_BFN_COLOR</span> <span class="n">patch</span><span class="p">[</span><span class="mi">3</span><span class="p">];</span> <span class="cm">/* Structures with back/fore/nan colors */</span>
- <span class="kt">char</span> <span class="o">**</span><span class="n">header</span><span class="p">;</span> <span class="cm">/* Array with all CPT file header records, if any) */</span>
- <span class="cm">/* ---- Variables "hidden" from the API ---- */</span>
- <span class="kt">uint64_t</span> <span class="n">id</span><span class="p">;</span> <span class="cm">/* The internal number of the data set */</span>
- <span class="k">enum</span> <span class="n">GMT_enum_alloc</span> <span class="n">alloc_mode</span><span class="p">;</span> <span class="cm">/* Allocation mode [GMT_ALLOCATED_BY_GMT] */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">alloc_level</span><span class="p">;</span> <span class="cm">/* The level it was allocated at */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">model</span><span class="p">;</span> <span class="cm">/* RGB, HSV, CMYK */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">is_gray</span><span class="p">;</span> <span class="cm">/* true if only grayshades are needed */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">is_bw</span><span class="p">;</span> <span class="cm">/* true if only black and white are needed */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">is_continuous</span><span class="p">;</span> <span class="cm">/* true if continuous color tables have been given */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">has_pattern</span><span class="p">;</span> <span class="cm">/* true if cpt file contains any patterns */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">skip</span><span class="p">;</span> <span class="cm">/* true if current z-slice is to be skipped */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">categorical</span><span class="p">;</span> <span class="cm">/* true if CPT applies to categorical data */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">z_adjust</span><span class="p">[</span><span class="mi">2</span><span class="p">];</span> <span class="cm">/* 1 if +u<unit> was parsed and scale set, 3 if z has been adjusted, 0 otherwise */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">z_mode</span><span class="p">[</span><span class="mi">2</span><span class="p">];</span> <span class="cm">/* 1 if +U<unit> was parsed, 0 otherwise */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">z_unit</span><span class="p">[</span><span class="mi">2</span><span class="p">];</span> <span class="cm">/* Unit enum specified via +u<unit> */</span>
- <span class="kt">double</span> <span class="n">z_unit_to_meter</span><span class="p">[</span><span class="mi">2</span><span class="p">];</span> <span class="cm">/* Scale, given z_unit, to convert z from <unit> to meters */</span>
-<span class="p">};</span>
-</pre></div>
-</div>
-</div>
-<div class="section" id="user-data-columns-gmt-vectors">
-<h3>1.5.6. User data columns (GMT vectors)<a class="headerlink" href="#user-data-columns-gmt-vectors" title="Permalink to this headline">¶</a></h3>
-<p>Programs that wish to call GMT modules may hold data in their own
-particular data structures. For instance, the user’s program may have
-three column arrays of type float and wishes to use these as the input
-source to the <tt class="docutils literal"><span class="pre">GMT_surface</span></tt> module, which normally expects double
-precision triplets via a <tt class="docutils literal"><span class="pre">struct</span> <span class="pre">GMT_DATASET</span></tt> read from a file or
-given by memory reference. Simply create a new <tt class="docutils literal"><span class="pre">struct</span> <span class="pre">GMT_VECTOR</span></tt>
-(see section <a class="reference internal" href="#sec-create"><em>Create empty resources</em></a>) and assign the union array pointers (see
-<a class="reference internal" href="#struct-univector"><em>univector</em></a>) to your data columns and provide the required
-information on length, data types, and optionally range (see
-<a class="reference internal" href="#struct-vector"><em>GMT_VECTOR</em></a>). By letting the GMT module know you are passing a
-data set <em>via</em> a <tt class="docutils literal"><span class="pre">struct</span> <span class="pre">GMT_VECTOR</span></tt> it will know how to read the data correctly.</p>
-<div class="highlight-c" id="struct-univector"><div class="highlight"><pre><span class="k">union</span> <span class="n">GMT_UNIVECTOR</span> <span class="p">{</span>
- <span class="kt">uint8_t</span> <span class="o">*</span><span class="n">uc1</span><span class="p">;</span> <span class="cm">/* Pointer for unsigned 1-byte array */</span>
- <span class="kt">int8_t</span> <span class="o">*</span><span class="n">sc1</span><span class="p">;</span> <span class="cm">/* Pointer for signed 1-byte array */</span>
- <span class="kt">uint16_t</span> <span class="o">*</span><span class="n">ui2</span><span class="p">;</span> <span class="cm">/* Pointer for unsigned 2-byte array */</span>
- <span class="kt">int16_t</span> <span class="o">*</span><span class="n">si2</span><span class="p">;</span> <span class="cm">/* Pointer for signed 2-byte array */</span>
- <span class="kt">uint32_t</span> <span class="o">*</span><span class="n">ui4</span><span class="p">;</span> <span class="cm">/* Pointer for unsigned 4-byte array */</span>
- <span class="kt">int32_t</span> <span class="o">*</span><span class="n">si4</span><span class="p">;</span> <span class="cm">/* Pointer for signed 4-byte array */</span>
- <span class="kt">uint64_t</span> <span class="o">*</span><span class="n">ui8</span><span class="p">;</span> <span class="cm">/* Pointer for unsigned 8-byte array */</span>
- <span class="kt">int64_t</span> <span class="o">*</span><span class="n">si8</span><span class="p">;</span> <span class="cm">/* Pointer for signed 8-byte array */</span>
- <span class="kt">float</span> <span class="o">*</span><span class="n">f4</span><span class="p">;</span> <span class="cm">/* Pointer for float array */</span>
- <span class="kt">double</span> <span class="o">*</span><span class="n">f8</span><span class="p">;</span> <span class="cm">/* Pointer for double array */</span>
-<span class="p">};</span>
-</pre></div>
-</div>
-<p>Table 1.1: Definition of the <tt class="docutils literal"><span class="pre">GMT_UNIVECTOR</span></tt> union that holds a pointer to any array type.</p>
-<div class="highlight-c" id="struct-vector"><div class="highlight"><pre><span class="k">struct</span> <span class="n">GMT_VECTOR</span> <span class="p">{</span>
- <span class="kt">uint64_t</span> <span class="n">n_columns</span><span class="p">;</span> <span class="cm">/* Number of vectors */</span>
- <span class="kt">uint64_t</span> <span class="n">n_rows</span><span class="p">;</span> <span class="cm">/* Number of rows in each vector */</span>
- <span class="k">enum</span> <span class="n">GMT_enum_reg</span> <span class="n">registration</span><span class="p">;</span> <span class="cm">/* 0 for gridline and 1 for pixel registration */</span>
- <span class="k">enum</span> <span class="n">GMT_enum_type</span> <span class="o">*</span><span class="n">type</span><span class="p">;</span> <span class="cm">/* Array with data type for each vector */</span>
- <span class="k">union</span> <span class="n">GMT_UNIVECTOR</span> <span class="o">*</span><span class="n">data</span><span class="p">;</span> <span class="cm">/* Array with unions for each column */</span>
- <span class="kt">double</span> <span class="n">range</span><span class="p">[</span><span class="mi">2</span><span class="p">];</span> <span class="cm">/* The min and max limits on t-range (or 0,0) */</span>
- <span class="kt">char</span> <span class="n">command</span><span class="p">[</span><span class="n">GMT_GRID_COMMAND_LEN320</span><span class="p">];</span> <span class="cm">/* name of generating command */</span>
- <span class="kt">char</span> <span class="n">remark</span><span class="p">[</span><span class="n">GMT_GRID_REMARK_LEN160</span><span class="p">];</span> <span class="cm">/* comments re this data set */</span>
- <span class="cm">/* ---- Variables "hidden" from the API ---- */</span>
- <span class="kt">uint64_t</span> <span class="n">id</span><span class="p">;</span> <span class="cm">/* An identification number */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">alloc_level</span><span class="p">;</span> <span class="cm">/* Level of initial allocation */</span>
- <span class="k">enum</span> <span class="n">GMT_enum_alloc</span> <span class="n">alloc_mode</span><span class="p">;</span> <span class="cm">/* Determines if we may free the vectors or not */</span>
-<span class="p">};</span>
-</pre></div>
-</div>
-</div>
-<div class="section" id="user-data-matrices-gmt-matrices">
-<h3>1.5.7. User data matrices (GMT matrices)<a class="headerlink" href="#user-data-matrices-gmt-matrices" title="Permalink to this headline">¶</a></h3>
-<p>Likewise, programs may have an integer 2-D matrix in memory and wish to
-use that as the input grid to the <tt class="docutils literal"><span class="pre">GMT_grdfilter</span></tt> module, which
-normally expects a <tt class="docutils literal"><span class="pre">struct</span> <span class="pre">GMT_GRID</span></tt> with floating point data via a
-file or provided by memory reference. As for user vectors, we create a
-<tt class="docutils literal"><span class="pre">struct</span> <span class="pre">GMT_MATRIX</span></tt> (see <a class="reference internal" href="#sec-create"><em>Create empty resources</em></a>), assign the appropriate
-union pointer to your data matrix and provide information on dimensions
-and data type. Let the GMT module know you
-are passing a grid via a <tt class="docutils literal"><span class="pre">struct</span> <span class="pre">GMT_MATRIX</span></tt> and it will know how to
-read the matrix properly.</p>
-<div class="highlight-c" id="struct-matrix"><div class="highlight"><pre><span class="k">struct</span> <span class="n">GMT_MATRIX</span> <span class="p">{</span>
- <span class="kt">uint64_t</span> <span class="n">n_rows</span><span class="p">;</span> <span class="cm">/* Number of rows in the matrix */</span>
- <span class="kt">uint64_t</span> <span class="n">n_columns</span><span class="p">;</span> <span class="cm">/* Number of columns in the matrix */</span>
- <span class="kt">uint64_t</span> <span class="n">n_layers</span><span class="p">;</span> <span class="cm">/* Number of layers in a 3-D matrix */</span>
- <span class="k">enum</span> <span class="n">GMT_enum_fmt</span> <span class="n">shape</span><span class="p">;</span> <span class="cm">/* 0 = C (rows) and 1 = Fortran (cols) */</span>
- <span class="k">enum</span> <span class="n">GMT_enum_reg</span> <span class="n">registration</span><span class="p">;</span> <span class="cm">/* 0 for gridline and 1 for pixel registration */</span>
- <span class="kt">size_t</span> <span class="n">dim</span><span class="p">;</span> <span class="cm">/* Allocated length of longest C or Fortran dim */</span>
- <span class="kt">size_t</span> <span class="n">size</span><span class="p">;</span> <span class="cm">/* Byte length of data */</span>
- <span class="k">enum</span> <span class="n">GMT_enum_type</span> <span class="n">type</span><span class="p">;</span> <span class="cm">/* Data type, e.g. GMT_FLOAT */</span>
- <span class="kt">double</span> <span class="n">range</span><span class="p">[</span><span class="mi">6</span><span class="p">];</span> <span class="cm">/* Contains xmin/xmax/ymin/ymax[/zmin/zmax] */</span>
- <span class="k">union</span> <span class="n">GMT_UNIVECTOR</span> <span class="n">data</span><span class="p">;</span> <span class="cm">/* Union with pointer to actual matrix of the chosen type */</span>
- <span class="kt">char</span> <span class="n">command</span><span class="p">[</span><span class="n">GMT_GRID_COMMAND_LEN320</span><span class="p">];</span> <span class="cm">/* name of generating command */</span>
- <span class="kt">char</span> <span class="n">remark</span><span class="p">[</span><span class="n">GMT_GRID_REMARK_LEN160</span><span class="p">];</span> <span class="cm">/* comments re this data set */</span>
- <span class="cm">/* ---- Variables "hidden" from the API ---- */</span>
- <span class="kt">uint64_t</span> <span class="n">id</span><span class="p">;</span> <span class="cm">/* The internal number of the data set */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">alloc_level</span><span class="p">;</span> <span class="cm">/* The level it was allocated at */</span>
- <span class="k">enum</span> <span class="n">GMT_enum_alloc</span> <span class="n">alloc_mode</span><span class="p">;</span> <span class="cm">/* Allocation mode [GMT_ALLOCATED_BY_GMT] */</span>
-<span class="p">};</span>
-</pre></div>
-</div>
-<p>The <tt class="docutils literal"><span class="pre">enum</span></tt> types referenced in <a class="reference internal" href="#struct-vector"><em>GMT_VECTOR</em></a> and
-Table <a class="reference internal" href="#struct-matrix"><em>GMT_MATRIX</em></a> and summarized in Table <a class="reference internal" href="#tbl-types"><em>types</em></a>.</p>
-<table border="1" class="docutils" id="tbl-types">
-<colgroup>
-<col width="25%" />
-<col width="75%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head">constant</th>
-<th class="head">description</th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>GMT_CHAR</td>
-<td>int8_t, 1-byte signed integer type</td>
-</tr>
-<tr class="row-odd"><td>GMT_UCHAR</td>
-<td>int8_t, 1-byte unsigned integer type</td>
-</tr>
-<tr class="row-even"><td>GMT_SHORT</td>
-<td>int16_t, 2-byte signed integer type</td>
-</tr>
-<tr class="row-odd"><td>GMT_USHORT</td>
-<td>uint16_t, 2-byte unsigned integer type</td>
-</tr>
-<tr class="row-even"><td>GMT_INT</td>
-<td>int32_t, 4-byte signed integer type</td>
-</tr>
-<tr class="row-odd"><td>GMT_UINT</td>
-<td>uint32_t, 4-byte unsigned integer type</td>
-</tr>
-<tr class="row-even"><td>GMT_LONG</td>
-<td>int64_t, 8-byte signed integer type</td>
-</tr>
-<tr class="row-odd"><td>GMT_ULONG</td>
-<td>uint64_t, 8-byte unsigned integer type</td>
-</tr>
-<tr class="row-even"><td>GMT_FLOAT</td>
-<td>4-byte data float type</td>
-</tr>
-<tr class="row-odd"><td>GMT_DOUBLE</td>
-<td>8-byte data float type</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-</div>
-<div class="section" id="overview-of-the-gmt-c-application-program-interface">
-<span id="chapter-overview"></span><h1>2. Overview of the GMT C Application Program Interface<a class="headerlink" href="#overview-of-the-gmt-c-application-program-interface" title="Permalink to this headline">¶</a></h1>
-<p>Users who wish to create their own GMT application based on the API
-must make sure their program goes through the steps below; details for
-each step will be revealed in the following chapter. We have kept the
-API simple: In addition to the GMT modules, there are only 52 public
-functions to become familiar with, but most applications will only use a
-small subset of this selection. Functions either return an integer error
-code (when things go wrong; otherwise it is set to <tt class="docutils literal"><span class="pre">GMT_OK</span> <span class="pre">(0)</span></tt>), or they
-return a void pointer to a GMT resources (or NULL if things go wrong).
-In either case the API will report what the error is. The layout here
-assumes you wish to use data in memory as input sources; if the data are
-simply command-line files then things simplify considerably.</p>
-<ol class="arabic simple">
-<li>Initialize a new GMT session with <a class="reference internal" href="#gmt-create-session">GMT_Create_Session</a>, which
-allocates a hidden GMT API control structure and returns an opaque
-pointer to it. This pointer is the first argument to all subsequent
-GMT API function calls within the session.</li>
-<li>For each intended call to a GMT module, several steps are involved:<ol class="loweralpha">
-<li>Register input sources and output destination with <a class="reference internal" href="#gmt-register-io">GMT_Register_IO</a>.</li>
-<li>Each resource registration generates a unique ID number. For
-memory resources, we embed these numbers in unique filenames of
-the form “@GMTAPI@-######” with <a class="reference internal" href="#gmt-encode-id">GMT_Encode_ID</a>. When GMT i/o library
-functions encounter such filenames they extract the ID and make a
-connection to the corresponding resource. Multiple table data or text
-sources are combined into a single virtual source for GMT modules to
-operate on. In contrast, CPT, Grid, and Image resources are
-operated on individually.</li>
-<li>Enable data import once all registrations are complete
-(<a class="reference internal" href="#sec-res-init"><em>Resources init</em></a>).</li>
-<li>Read data into memory. You may choose to read everything at once
-or read record-by-record.</li>
-<li>Prepare required arguments and call the GMT module you wish to use.</li>
-<li>For non-mapping modules, process any results returned to memory via
-pointers rather than written to files.</li>
-<li>Destroy the resources allocated by GMT modules to hold results,
-or let the garbage collector do this automatically at the end of
-the session.</li>
-</ol>
-</li>
-<li>Repeat steps a–f as many times as your application requires.</li>
-<li>We terminate the GMT session by calling <a class="reference internal" href="#gmt-destroy-session">GMT_Destroy_Session</a>.</li>
-</ol>
-<p>The steps a–d collapse into a single step if data are simply read from files.</p>
-<p>Advanced programs may be calling more than one GMT session and thus
-run several sessions, perhaps concurrently as different threads on
-multi-core machines. We will now discuss these steps in more detail.
-Throughout, we will introduce upper-case GMT C enum constants <em>in
-lieu</em> of simple integer constants. These are considered part of the API
-and are available for developers via the <tt class="docutils literal"><span class="pre">gmt_resources.h</span></tt> include file.</p>
-<p>The C/C++ API is deliberately kept small to make it easy to use.
-Next table gives a list of all the functions and their purpose.</p>
-<table border="1" class="docutils" id="tbl-api">
-<colgroup>
-<col width="33%" />
-<col width="67%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head">constant</th>
-<th class="head">description</th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td><a class="reference internal" href="#gmt-append-option">GMT_Append_Option</a></td>
-<td>Append new option structure to linked list</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="#gmt-begin-io">GMT_Begin_IO</a></td>
-<td>Enable record-by-record i/o</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="#gmt-call-module">GMT_Call_Module</a></td>
-<td>Call any of the GMT modules</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="#gmt-create-args">GMT_Create_Args</a></td>
-<td>Convert linked list of options to text array</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="#gmt-create-cmd">GMT_Create_Cmd</a></td>
-<td>Convert linked list of options to command line</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="#gmt-create-data">GMT_Create_Data</a></td>
-<td>Create an empty data resource</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="#gmt-create-options">GMT_Create_Options</a></td>
-<td>Convert command line options to linked list</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="#gmt-create-session">GMT_Create_Session</a></td>
-<td>Initialize a new GMT session</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="#gmt-delete-option">GMT_Delete_Option</a></td>
-<td>Delete an option structure from the linked list</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="#gmt-destroy-args">GMT_Destroy_Args</a></td>
-<td>Delete text array of arguments</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="#gmt-destroy-cmd">GMT_Destroy_Cmd</a></td>
-<td>Delete text command of arguments</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="#gmt-destroy-data">GMT_Destroy_Data</a></td>
-<td>Delete a data resource</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="#gmt-destroy-options">GMT_Destroy_Options</a></td>
-<td>Delete the linked list of option structures</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="#gmt-destroy-session">GMT_Destroy_Session</a></td>
-<td>Terminate a GMT session</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="#gmt-duplicate-data">GMT_Duplicate_Data</a></td>
-<td>Make an identical copy of a data resources</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="#gmt-encode-id">GMT_Encode_ID</a></td>
-<td>Encode a resources ID as a special filename</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="#gmt-end-io">GMT_End_IO</a></td>
-<td>Disable further record-by-record i/o</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="#gmt-fft">GMT_FFT</a></td>
-<td>Take the Fast Fourier Transform of data object</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="#gmt-fft-1d">GMT_FFT_1D</a></td>
-<td>Take the Fast Fourier Transform of 1-D float data</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="#gmt-fft-2d">GMT_FFT_2D</a></td>
-<td>Take the Fast Fourier Transform of 2-D float data</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="#gmt-fft-create">GMT_FFT_Create</a></td>
-<td>Initialize the FFT machinery</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="#gmt-fft-destroy">GMT_FFT_Destroy</a></td>
-<td>Terminate the FFT machinery</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="#gmt-fft-option">GMT_FFT_Option</a></td>
-<td>Explain the FFT options and modifiers</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="#gmt-fft-parse">GMT_FFT_Parse</a></td>
-<td>Parse argument with FFT options and modifiers</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="#gmt-fft-wavenumber">GMT_FFT_Wavenumber</a></td>
-<td>Return wavenumber given data index</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="#gmt-find-option">GMT_Find_Option</a></td>
-<td>Find an option in the linked list</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="#gmt-get-common">GMT_Get_Common</a></td>
-<td>Determine if a GMT common option was set</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="#gmt-get-coord">GMT_Get_Coord</a></td>
-<td>Create a coordinate array</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="#gmt-get-data">GMT_Get_Data</a></td>
-<td>Import a registered data resources</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="#gmt-get-default">GMT_Get_Default</a></td>
-<td>Obtain as string one of the GMT default settings</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="#gmt-get-id">GMT_Get_ID</a></td>
-<td>Obtain the ID of a given resource</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="#gmt-get-index">GMT_Get_Index</a></td>
-<td>Convert row, col into a grid or image index</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="#gmt-get-record">GMT_Get_Record</a></td>
-<td>Import a single data record</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="#gmt-get-row">GMT_Get_Row</a></td>
-<td>Import a single grid row</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="#gmt-get-value">GMT_Get_Value</a></td>
-<td>Convert string into coordinates or dimensions</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="#gmt-init-io">GMT_Init_IO</a></td>
-<td>Initialize i/o given registered resources</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="#gmt-make-option">GMT_Make_Option</a></td>
-<td>Create an option structure</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="#gmt-message">GMT_Message</a></td>
-<td>Issue a message, optionally with time stamp</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="#gmt-option">GMT_Option</a></td>
-<td>Explain one or more GMT common options</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="#gmt-parse-common">GMT_Parse_Common</a></td>
-<td>Parse the GMT common options</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="#gmt-put-data">GMT_Put_Data</a></td>
-<td>Export to a registered data resource given by ID</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="#gmt-put-record">GMT_Put_Record</a></td>
-<td>Export a data record</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="#gmt-put-row">GMT_Put_Row</a></td>
-<td>Export a grid row</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="#gmt-read-data">GMT_Read_Data</a></td>
-<td>Import a data resource or file</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="#gmt-register-io">GMT_Register_IO</a></td>
-<td>Register a resources for i/o</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="#gmt-report">GMT_Report</a></td>
-<td>Issue a message contingent upon verbosity level</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="#gmt-retrieve-data">GMT_Retrieve_Data</a></td>
-<td>Obtained link to data in memory via ID</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="#gmt-set-comment">GMT_Set_Comment</a></td>
-<td>Assign a comment to a data resource</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="#gmt-status-io">GMT_Status_IO</a></td>
-<td>Check status of record-by-record i/o</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="#gmt-update-option">GMT_Update_Option</a></td>
-<td>Modify an option structure</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="#gmt-write-data">GMT_Write_Data</a></td>
-<td>Export a data resource</td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="the-gmt-c-application-program-interface">
-<h1>3. The GMT C Application Program Interface<a class="headerlink" href="#the-gmt-c-application-program-interface" title="Permalink to this headline">¶</a></h1>
-<div class="section" id="initialize-a-new-gmt-session">
-<h2>3.1. Initialize a new GMT session<a class="headerlink" href="#initialize-a-new-gmt-session" title="Permalink to this headline">¶</a></h2>
-<p>Most applications will need to initialize only a single GMT session.
-This is true of all the standard GMT programs since they only call one
-GMT module and then exit. Most user-developed GMT applications are
-likely to only initialize one session even though they may call many
-GMT modules. However, the GMT API supports any number of
-simultaneous sessions should the programmer wish to take advantage of
-it. This might be useful when you have access to several CPUs and want
-to spread the computing load <a class="footnote-reference" href="#id11" id="id5">[5]</a>. In the following discussion we will
-simplify our treatment to the use of a single session only.</p>
-<p>To initiate the new session we use</p>
-<blockquote id="gmt-create-session">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">void</span> <span class="o">*</span><span class="nf">GMT_Create_Session</span> <span class="p">(</span><span class="kt">char</span> <span class="o">*</span><span class="n">tag</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">pad</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">mode</span><span clas [...]
- <span class="kt">int</span> <span class="p">(</span><span class="o">*</span><span class="n">print_func</span><span class="p">)</span> <span class="p">(</span><span class="kt">FILE</span> <span class="o">*</span><span class="p">,</span> <span class="k">const</span> <span class="kt">char</span> <span class="o">*</span><span class="p">));</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>and you will typically call it thus:</p>
-<blockquote>
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">void</span> <span class="o">*</span><span class="n">API</span> <span class="o">=</span> <span class="nb">NULL</span><span class="p">;</span>
-<span class="n">API</span> <span class="o">=</span> <span class="n">GMT_Create_Session</span> <span class="p">(</span><span class="s">"Session name"</span><span class="p">,</span> <span class="mi">2</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="nb">NULL</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>where <a class="reference internal" href="#struct-api"><em>API</em></a> is an opaque pointer to the hidden GMT API control
-structure. You will need to pass this pointer to <em>all</em> subsequent
-GMT API functions; this is how essential internal information is
-passed from module to module. The key task of this initialization is to
-set up the GMT machinery and its internal variables used for map
-projections, plotting, i/o, etc. The initialization also allocates space
-for internal structures used to register resources. The <tt class="docutils literal"><span class="pre">pad</span></tt> argument
-sets how many rows and columns should be used as padding for grids and
-images so that boundary conditions can be applied. GMT uses 2 so we
-recommend that value. The <tt class="docutils literal"><span class="pre">mode</span></tt> argument is only used for external APIs
-that need to replace GMT’s calls to a hard exit upon failure with a soft return. Likewise,
-the <tt class="docutils literal"><span class="pre">print_func</span></tt> argument is a pointer to a function that is used to print
-messages via <a class="reference internal" href="#gmt-message">GMT_Message</a> or <a class="reference internal" href="#gmt-report">GMT_Report</a> from APIs that cannot use the
-standard printf (this is the case for the Matlab API, for instance).
-All other uses should simply pass 0 and NULL for these two arguments.
-Should something go wrong then <tt class="docutils literal"><span class="pre">API</span></tt> will be returned as <tt class="docutils literal"><span class="pre">NULL</span></tt>.</p>
-<div class="highlight-c" id="struct-api"><div class="highlight"><pre><span class="k">struct</span> <span class="n">GMTAPI_CTRL</span> <span class="p">{</span>
- <span class="cm">/* Master controller which holds all GMT API related information at run-time for a single session.</span>
-<span class="cm"> * Users can run several GMT sessions concurrently; each session requires its own structure.</span>
-<span class="cm"> * Use GMTAPI_Create_Session to initialize a new session and GMTAPI_Destroy_Session to end it. */</span>
- <span class="kt">uint64_t</span> <span class="n">current_rec</span><span class="p">[</span><span class="mi">2</span><span class="p">];</span> <span class="cm">/* Current record number >= 0 in the combined virtual dataset (in and out) */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">n_objects</span><span class="p">;</span> <span class="cm">/* Number of currently active input and output data objects */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">unique_ID</span><span class="p">;</span> <span class="cm">/* Used to create unique IDs for duration of session */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">session_ID</span><span class="p">;</span> <span class="cm">/* ID of this session */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">unique_var_ID</span><span class="p">;</span> <span class="cm">/* Used to create unique object IDs (grid,dataset, etc) for duration of session */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">current_item</span><span class="p">[</span><span class="mi">2</span><span class="p">];</span> <span class="cm">/* Array number of current dataset being processed (in and out)*/</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">pad</span><span class="p">;</span> <span class="cm">/* Session default for number of rows/cols padding for grids [2] */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">mode</span><span class="p">;</span> <span class="cm">/* 1 if called via external API (Matlab, Python) [0] */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">leave_grid_scaled</span><span class="p">;</span> <span class="cm">/* 1 if we dont want to unpack a grid after we packed it for writing [0] */</span>
- <span class="kt">bool</span> <span class="n">registered</span><span class="p">[</span><span class="mi">2</span><span class="p">];</span> <span class="cm">/* true if at least one source/destination has been registered (in and out) */</span>
- <span class="kt">bool</span> <span class="n">io_enabled</span><span class="p">[</span><span class="mi">2</span><span class="p">];</span> <span class="cm">/* true if access has been allowed (in and out) */</span>
- <span class="kt">size_t</span> <span class="n">n_objects_alloc</span><span class="p">;</span> <span class="cm">/* Allocation counter for data objects */</span>
- <span class="kt">int</span> <span class="n">error</span><span class="p">;</span> <span class="cm">/* Error code from latest API call [GMT_OK] */</span>
- <span class="kt">int</span> <span class="n">last_error</span><span class="p">;</span> <span class="cm">/* Error code from previous API call [GMT_OK] */</span>
- <span class="kt">int</span> <span class="n">shelf</span><span class="p">;</span> <span class="cm">/* Place to pass hidden values within API */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">io_mode</span><span class="p">[</span><span class="mi">2</span><span class="p">];</span> <span class="cm">/* 1 if access as set, 0 if record-by-record */</span>
- <span class="k">struct</span> <span class="n">GMT_CTRL</span> <span class="o">*</span><span class="n">GMT</span><span class="p">;</span> <span class="cm">/* Key structure with low-level GMT internal parameters */</span>
- <span class="k">struct</span> <span class="n">GMTAPI_DATA_OBJECT</span> <span class="o">**</span><span class="n">object</span><span class="p">;</span> <span class="cm">/* List of registered data objects */</span>
- <span class="kt">char</span> <span class="o">*</span><span class="n">session_tag</span><span class="p">;</span> <span class="cm">/* Name tag for this session (or NULL) */</span>
- <span class="kt">bool</span> <span class="n">internal</span><span class="p">;</span> <span class="cm">/* true if session was initiated by gmt.c */</span>
- <span class="kt">bool</span> <span class="n">deep_debug</span><span class="p">;</span> <span class="cm">/* temporary for debugging */</span>
- <span class="kt">int</span> <span class="p">(</span><span class="o">*</span><span class="n">print_func</span><span class="p">)</span> <span class="p">(</span><span class="kt">FILE</span> <span class="o">*</span><span class="p">,</span> <span class="k">const</span> <span class="kt">char</span> <span class="o">*</span><span class="p">);</span> <span class="cm">/* Pointer to fprintf function (may be reset by external APIs like MEX) */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">do_not_exit</span><span class="p">;</span> <span class="cm">/* 0 by default, meaning it is OK to call exit (otherwise call return instead) */</span>
- <span class="k">struct</span> <span class="n">Gmt_libinfo</span> <span class="o">*</span><span class="n">lib</span><span class="p">;</span> <span class="cm">/* List of shared libs to consider */</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">n_shared_libs</span><span class="p">;</span> <span class="cm">/* How many in lib */</span>
-<span class="p">};</span>
-</pre></div>
-</div>
-<div class="highlight-c"><div class="highlight"><pre>struct GMTAPI_DATA_OBJECT {
- /* Information for each input or output data entity, including information
- * needed while reading/writing from a table (file or array) */
- uint64_t n_rows; /* Number or rows in this array [GMT_DATASET and GMT_TEXTSET to/from MATRIX/VETOR only] */
- uint64_t n_columns; /* Number of columns to process in this dataset [GMT_DATASET only] */
- uint64_t n_expected_fields; /* Number of expected columns for this dataset [GMT_DATASET only] */
- size_t n_alloc; /* Number of items allocated so far if writing to memory */
- unsigned int ID; /* Unique identifier which is >= 0 */
- unsigned int alloc_level; /* Nested module level when object was allocated */
- unsigned int status; /* 0 when first registered, 1 after reading/writing has started, 2 when finished */
- bool selected; /* true if requested by current module, false otherwise */
- bool close_file; /* true if we opened source as a file and thus need to close it when done */
- bool region; /* true if wesn was passed, false otherwise */
- bool no_longer_owner; /* true if the data pointed to by the object was passed on to another object */
- bool messenger; /* true for output objects passed from the outside to receive data from GMT. */
- If true we destroy data pointer before writing */
- enum GMT_enum_alloc alloc_mode; /* GMT_ALLOCATED_{BY_GMT|EXTERNALLY} */
- enum GMT_io_enum direction; /* GMT_IN or GMT_OUT */
- enum GMT_enum_family family; /* One of GMT_IS_{DATASET|TEXTSET|CPT|IMAGE|GRID|MATRIX|VECTOR|COORD} */
- enum GMT_enum_family actual_family; /* May be GMT_IS_MATRIX|VECTOR when one of the others are created via those */
- unsigned method; /* One of GMT_IS_{FILE,STREAM,FDESC,DUPLICATE,REFERENCE} or sum with enum */
- GMT_enum_via (GMT_VIA_{NONE,VECTOR,MATRIX,OUTPUT}); using unsigned type
- because sum exceeds enum GMT_enum_method */
- enum GMT_enum_geometry geometry; /* One of GMT_IS_{POINT|LINE|POLY|PLP|SURFACE|NONE} */
- double wesn[GMTAPI_N_GRID_ARGS]; /* Grid domain limits */
- void *resource; /* Points to registered filename, memory location, etc., where data can be */
- obtained from with GMT_Get_Data. */
- void *data; /* Points to GMT object that was read from a resource */
- FILE *fp; /* Pointer to source/destination stream [For rec-by-rec procession, NULL if mem location] */
- char *filename; /* Filename, stream, of file handle (otherwise NULL) */
- void *(*import) (struct GMT_CTRL *, FILE *, uint64_t *, int *); /* Pointer to input function (for DATASET/TEXTSET only) */
-#ifdef DEBUG
- struct GMT_GRID *G;
- struct GMT_DATASET *D;
- struct GMT_TEXTSET *T;
- struct GMT_PALETTE *C;
- struct GMT_MATRIX *M;
- struct GMT_VECTOR *V;
-#endif
-#ifdef HAVE_GDAL
- struct GMT_IMAGE *I;
-#endif
-};
-</pre></div>
-</div>
-</div>
-<div class="section" id="register-input-or-output-resources">
-<h2>3.2. Register input or output resources<a class="headerlink" href="#register-input-or-output-resources" title="Permalink to this headline">¶</a></h2>
-<p>When using the standard GMT programs, you specify input files on the
-command line or via special program options (e.g.,
-<strong>-I</strong><em>intensity.nc</em>). The output of the programs are either written
-to standard output (which you redirect to files or pipe to other
-programs) or to files specified by specific program options (e.g.,
-<strong>-G</strong><em>output.nc</em>). Alternatively, the GMT API allows you to specify
-input (and output) to be associated with open file handles or program
-variables. We will examine this more closely below. Registering a
-resource is a required step before attempting to import or export data
-that <em>do not</em> come from files or standard input/output.</p>
-<div class="section" id="resource-registration">
-<h3>3.2.1. Resource registration<a class="headerlink" href="#resource-registration" title="Permalink to this headline">¶</a></h3>
-<p>Registration involves a direct or indirect call to</p>
-<blockquote id="gmt-register-io">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="nf">GMT_Register_IO</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">family</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">method</span><span class="p">,</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">geometry</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">direction</span><span class="p">,</span>
- <span class="kt">double</span> <span class="n">wesn</span><span class="p">[],</span> <span class="kt">void</span> <span class="o">*</span><span class="n">ptr</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>where <a class="reference internal" href="#tbl-family"><em>family</em></a> specifies what kind of resource is to be registered,
-<a class="reference internal" href="#tbl-methods"><em>method</em></a> specifies
-how we to access this resource (see Table <a class="reference internal" href="#tbl-methods"><em>methods</em></a> for recognized
-methods), <a class="reference internal" href="#tbl-geometry"><em>geometry</em></a> specifies the geometry of the data, <tt class="docutils literal"><span class="pre">ptr</span></tt> is the address of the
-pointer to the named resource. If <tt class="docutils literal"><span class="pre">direction</span></tt> is <tt class="docutils literal"><span class="pre">GMT_OUT</span></tt> and the
-<tt class="docutils literal"><span class="pre">method</span></tt> is not related to a file (filename, stream, or handle), then
-<tt class="docutils literal"><span class="pre">ptr</span></tt> must be NULL. After the GMT module has written the data you
-can use <a class="reference internal" href="#gmt-retrieve-data">GMT_Retrieve_Data</a> to assign a pointer to the memory location
-(variable) where the output was allocated. For grid (and image)
-resources you may request to obtain a subset via the <a class="reference internal" href="#tbl-wesn"><em>wesn</em></a> array; otherwise, pass NULL
-(or an array with at least 4 items all set to 0) to obtain the
-entire grid (or image). The <tt class="docutils literal"><span class="pre">direction</span></tt> indicates input or output and
-is either <tt class="docutils literal"><span class="pre">GMT_IN</span></tt> or <tt class="docutils literal"><span class="pre">GMT_OUT</span></tt>. Finally, the function returns a
-unique resource ID, or <tt class="docutils literal"><span class="pre">GMT_NOTSET</span></tt> if there was an error.</p>
-</div>
-<div class="section" id="object-id-encoding">
-<h3>3.2.2. Object ID encoding<a class="headerlink" href="#object-id-encoding" title="Permalink to this headline">¶</a></h3>
-<p>To use registered resources as program input or output arguments you
-must pass them via a text string that acts as a special file name
-(Chapter <a class="reference internal" href="#chapter-overview"><em>Overview</em></a>). The proper filename formatting is guaranteed by
-using the function</p>
-<blockquote id="gmt-encode-id">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="nf">GMT_Encode_ID</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">char</span> <span class="o">*</span><span class="n">filename</span><span class="p">,</span> <span class="kt">int</span> <span class="n">ID</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>which accepts the unique <tt class="docutils literal"><span class="pre">ID</span></tt> and writes the corresponding
-<tt class="docutils literal"><span class="pre">filename</span></tt>. The variable <tt class="docutils literal"><span class="pre">filename</span></tt> must have enough space to hold
-16 bytes. The function returns 1 if there is an error; otherwise
-it returns 0.</p>
-<table border="1" class="docutils" id="tbl-family">
-<colgroup>
-<col width="36%" />
-<col width="64%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head">family</th>
-<th class="head">source points to</th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>GMT_IS_DATASET</td>
-<td>A [multi-segment] table file</td>
-</tr>
-<tr class="row-odd"><td>GMT_IS_TEXTSET</td>
-<td>A [multi-segment] text file</td>
-</tr>
-<tr class="row-even"><td>GMT_IS_GRID</td>
-<td>A GMT grid file</td>
-</tr>
-<tr class="row-odd"><td>GMT_IS_CPT</td>
-<td>A CPT file</td>
-</tr>
-<tr class="row-even"><td>GMT_IS_IMAGE</td>
-<td>A GMT image</td>
-</tr>
-</tbody>
-</table>
-<table border="1" class="docutils" id="tbl-methods">
-<colgroup>
-<col width="31%" />
-<col width="7%" />
-<col width="62%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head">method</th>
-<th class="head">value</th>
-<th class="head">how to read/write data</th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>GMT_IS_FILE</td>
-<td>0</td>
-<td>Pointer to name of a file</td>
-</tr>
-<tr class="row-odd"><td>GMT_IS_STREAM</td>
-<td>1</td>
-<td>Pointer to open stream (or process)</td>
-</tr>
-<tr class="row-even"><td>GMT_IS_FDESC</td>
-<td>2</td>
-<td>Pointer to integer file descriptor</td>
-</tr>
-<tr class="row-odd"><td>GMT_IS_DUPLICATE</td>
-<td>3</td>
-<td>Pointer to memory we may <em>duplicate</em> data from</td>
-</tr>
-<tr class="row-even"><td>GMT_IS_REFERENCE</td>
-<td>4</td>
-<td>Pointer to memory we may <em>reference</em> data from</td>
-</tr>
-<tr class="row-odd"><td>GMT_IS_DUPLICATE_VIA_VECTOR</td>
-<td>103</td>
-<td>Pointer to memory we may <em>duplicate</em> data from via vectors</td>
-</tr>
-<tr class="row-even"><td>GMT_IS_REFERENCE_VIA_VECTOR</td>
-<td>104</td>
-<td>Pointer to memory we may <em>reference</em> data from via vectors</td>
-</tr>
-<tr class="row-odd"><td>GMT_IS_DUPLICATE_VIA_MATRIX</td>
-<td>203</td>
-<td>Pointer to memory we may <em>duplicate</em> data from via a matrix</td>
-</tr>
-<tr class="row-even"><td>GMT_IS_REFERENCE_VIA_MATRIX</td>
-<td>204</td>
-<td>Pointer to memory we may <em>reference</em> data from via a matrix</td>
-</tr>
-</tbody>
-</table>
-<table border="1" class="docutils" id="tbl-via">
-<colgroup>
-<col width="23%" />
-<col width="78%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head">approach</th>
-<th class="head">how method is modified</th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>GMT_VIA_VECTOR</td>
-<td>User’s data columns are accessed via a GMT_VECTOR structure</td>
-</tr>
-<tr class="row-odd"><td>GMT_VIA_MATRIX</td>
-<td>User’s matrix is accessed via a GMT_MATRIX structure</td>
-</tr>
-</tbody>
-</table>
-<table border="1" class="docutils" id="tbl-geometry">
-<colgroup>
-<col width="30%" />
-<col width="70%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head">geometry</th>
-<th class="head">description</th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>GMT_IS_TEXT</td>
-<td>Not a geographic item</td>
-</tr>
-<tr class="row-odd"><td>GMT_IS_POINT</td>
-<td>Multi-dimensional point data</td>
-</tr>
-<tr class="row-even"><td>GMT_IS_LINE</td>
-<td>Geographic or Cartesian line segments</td>
-</tr>
-<tr class="row-odd"><td>GMT_IS_POLYGON</td>
-<td>Geographic or Cartesian closed polygons</td>
-</tr>
-<tr class="row-even"><td>GMT_IS_SURFACE</td>
-<td>2-D gridded surface</td>
-</tr>
-</tbody>
-</table>
-<table border="1" class="docutils" id="tbl-wesn">
-<colgroup>
-<col width="16%" />
-<col width="84%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head">index</th>
-<th class="head">description</th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>GMT_XLO</td>
-<td>x_min (west) boundary of grid subset</td>
-</tr>
-<tr class="row-odd"><td>GMT_XHI</td>
-<td>x_max (east) boundary of grid subset</td>
-</tr>
-<tr class="row-even"><td>GMT_YLO</td>
-<td>y_min (south) boundary of grid subset</td>
-</tr>
-<tr class="row-odd"><td>GMT_YHI</td>
-<td>y_max (north) boundary of grid subset</td>
-</tr>
-<tr class="row-even"><td>GMT_ZLO</td>
-<td>z_min (bottom) boundary of 3-D matrix subset</td>
-</tr>
-<tr class="row-odd"><td>GMT_ZHI</td>
-<td>z_max (top) boundary of 3-D matrix subset</td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="resource-initialization">
-<span id="sec-res-init"></span><h3>3.2.3. Resource initialization<a class="headerlink" href="#resource-initialization" title="Permalink to this headline">¶</a></h3>
-<p>All GMT programs dealing with input or output files given on the
-command line, and perhaps defaulting to the standard input or output
-streams if no files are given, must call the i/o initializer function
-<a class="reference internal" href="#gmt-init-io">GMT_Init_IO</a> once for each direction required (i.e., input and output
-separately). For input it determines how many input sources have already
-been registered. If none has been registered then it scans the program
-arguments for any filenames given on the command line and register these
-input resources. Finally, if we still have found no input sources we
-assign the standard input stream as the single input source. For output
-it is similar: If no single destination has been registered we specify
-the standard output stream as the output destination. Only one main
-output destination is allowed to be active when a module writes data
-(some modules also write additional output via program-specific
-options). The prototype for this function is</p>
-<blockquote id="gmt-init-io">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="nf">GMT_Init_IO</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">family</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">geometry</span><span class="p">,</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">direction</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">mode</span><span class="p">,</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">n_args</span><span class="p">,</span> <span class="kt">void</span> <span class="o">*</span><span class="n">args</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>where <a class="reference internal" href="#tbl-family"><em>family</em></a> specifies what kind of resource is to be registered,
-<a class="reference internal" href="#tbl-geometry"><em>geometry</em></a> specifies the geometry of the data, <tt class="docutils literal"><span class="pre">direction</span></tt> is either
-<tt class="docutils literal"><span class="pre">GMT_IN</span></tt> or <tt class="docutils literal"><span class="pre">GMT_OUT</span></tt>, and <tt class="docutils literal"><span class="pre">mode</span></tt> is a bit flag that determines
-what we do if no resources have been registered. The choices are</p>
-<blockquote>
-<div><p><strong>GMT_ADD_FILES_IF_NONE</strong> (1) means “add command line (option)
-files if none have been registered already”</p>
-<p><strong>GMT_ADD_FILES_ALWAYS</strong> (2) means “always add any command line files”</p>
-<p><strong>GMT_ADD_STDIO_IF_NONE</strong> (4) means “add std* if no other
-input/output have been specified”</p>
-<p><strong>GMT_ADD_STDIO_ALWAYS</strong> (8) means “always add std* even if
-resources have been registered”.</p>
-<p><strong>GMT_ADD_EXISTING</strong> (16) means “only use already registered resources”.</p>
-</div></blockquote>
-<p>The standard behavior is <tt class="docutils literal"><span class="pre">GMT_REG_DEFAULT</span></tt> (5). Next, <tt class="docutils literal"><span class="pre">n_args</span></tt> is 0
-if <tt class="docutils literal"><span class="pre">args</span></tt> is the head of a linked list of options (further discussed
-in <a class="reference internal" href="#sec-func"><em>Prepare modules opts</em></a>); otherwise <tt class="docutils literal"><span class="pre">args</span></tt> is an array of <tt class="docutils literal"><span class="pre">n_args</span></tt>
-strings (i.e., the int argc, char *argv[] model)</p>
-<p>Many programs will register an export location where results of a
-GMT function (say, a filtered grid) should be returned, but may then
-wish to use that variable as an <em>input</em> resource in a subsequent module
-call. This is accomplished by re-registering the resource as an <em>input</em>
-source, thereby changing the <em>direction</em> of the data set. The function
-returns 1 if there is an error; otherwise it returns 0.</p>
-</div>
-<div class="section" id="dimension-parameters-for-user-1-d-column-vectors">
-<h3>3.2.4. Dimension parameters for user 1-D column vectors<a class="headerlink" href="#dimension-parameters-for-user-1-d-column-vectors" title="Permalink to this headline">¶</a></h3>
-<p>We refer to Table <a class="reference internal" href="#struct-vector"><em>vector</em></a>. The <tt class="docutils literal"><span class="pre">type</span></tt> array must hold the data
-type of each data column in the user’s program. All types other than
-GMT_DOUBLE will be converted internally in GMT to <tt class="docutils literal"><span class="pre">double</span></tt>, thus
-possibly increasing memory requirements. If the type is <tt class="docutils literal"><span class="pre">GMT_DOUBLE</span></tt> then
-GMT will be able to use the column directly by reference. The
-<tt class="docutils literal"><span class="pre">n_columns</span></tt> and <tt class="docutils literal"><span class="pre">n_rows</span></tt> parameters indicate the number of vectors
-and their common length. For output these may not yet be known so you should
-pass 0 for these values.</p>
-</div>
-<div class="section" id="dimension-parameters-for-user-2-d-table-arrays">
-<h3>3.2.5. Dimension parameters for user 2-D table arrays<a class="headerlink" href="#dimension-parameters-for-user-2-d-table-arrays" title="Permalink to this headline">¶</a></h3>
-<p>We refer to Table <a class="reference internal" href="#struct-matrix"><em>matrix</em></a>. The <tt class="docutils literal"><span class="pre">type</span></tt> parameter specifies the
-data type used for the array in the user’s program. All types other than
-GMT_FLOAT will be converted internally in GMT to <tt class="docutils literal"><span class="pre">float</span></tt>, thus
-possibly increasing memory requirements. If the type is <tt class="docutils literal"><span class="pre">GMT_FLOAT</span></tt> then
-GMT may be able to use the matrix directly by reference. The
-<tt class="docutils literal"><span class="pre">n_rows</span></tt> and <tt class="docutils literal"><span class="pre">n_columns</span></tt> parameters indicate the dimensions of the
-matrix. If these are not yet known you may pass 0 for these values and
-set <tt class="docutils literal"><span class="pre">alloc_mode</span></tt> to <tt class="docutils literal"><span class="pre">GMT_ALLOCATED_BY_GMT</span></tt>; this will make sure GMT will
-allocate the necessary memory at the location you specify. Fortran users
-will instead have to specify a size large enough to hold the anticipated
-output data. The <tt class="docutils literal"><span class="pre">registration</span></tt> and <tt class="docutils literal"><span class="pre">range</span></tt> gives the grid
-registration and domain. Finally, use <tt class="docutils literal"><span class="pre">dim</span></tt> to indicate if the memory
-matrix has a dimension that exceeds that of the leading row (or column)
-dimension. Note: For <tt class="docutils literal"><span class="pre">GMT_IS_TEXTSET</span></tt> the user matrix is expected to be
-a 2-D character array with a fixed row length of <tt class="docutils literal"><span class="pre">dim</span></tt> but we only
-consider the first <tt class="docutils literal"><span class="pre">n_columns</span></tt> characters. For data grids you will
-also need to specify the <tt class="docutils literal"><span class="pre">registration</span></tt> (see the GMT Cookbook and
-Reference, <a class="reference internal" href="GMT_Docs.html#app-file-formats"><em>B. GMT File Formats</em></a> for description of the two forms of registration)
-and data domain <tt class="docutils literal"><span class="pre">range</span></tt>.</p>
-</div>
-</div>
-<div class="section" id="create-empty-resources">
-<span id="sec-create"></span><h2>3.3. Create empty resources<a class="headerlink" href="#create-empty-resources" title="Permalink to this headline">¶</a></h2>
-<p>If your application needs to build and populate GMT resources in ways
-that do not depend on external resources (files, memory locations,
-etc.), then you can obtain a “blank slate” by calling</p>
-<blockquote id="gmt-create-data">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">void</span> <span class="o">*</span><span class="n">GMT_Create_Data</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">family</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">geometry</span><span c [...]
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">mode</span><span class="p">,</span> <span class="kt">uint64_t</span> <span class="n">par</span><span class="p">[],</span> <span class="kt">double</span> <span class="o">*</span><span class="n">wesn</span><span class="p">,</span>
- <span class="kt">double</span> <span class="o">*</span><span class="n">inc</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">registration</span><span class="p">,</span> <span class="kt">int</span> <span class="n">pad</span><span class="p">,</span> <span class="kt">void</span> <span class="o">*</span><span class="n">data</span><span class="p">)</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>which returns a pointer to the allocated resource. Pass <a class="reference internal" href="#tbl-family"><em>family</em></a> as
-one of <tt class="docutils literal"><span class="pre">GMT_IS_GRID</span></tt>, <tt class="docutils literal"><span class="pre">GMT_IS_IMAGE</span></tt>, <tt class="docutils literal"><span class="pre">GMT_IS_DATASET</span></tt>,
-<tt class="docutils literal"><span class="pre">GMT_IS_TEXTSET</span></tt>, or <tt class="docutils literal"><span class="pre">GMT_IS_CPT</span></tt>, or via the modifiers <tt class="docutils literal"><span class="pre">GMT_IS_VECTOR</span></tt>
-or <tt class="docutils literal"><span class="pre">GMT_IS_MATRIX</span></tt> when handling user data. Also pass a compatible
-<a class="reference internal" href="#tbl-geometry"><em>geometry</em></a>. Depending on the family and your particular way of
-representing dimensions you may pass the additional parameters in one of
-two ways:</p>
-<ol class="arabic simple">
-<li>Actual integer dimensions of items needed.</li>
-<li>Physical distances and increments of each dimension.</li>
-</ol>
-<p>For the first case pass <tt class="docutils literal"><span class="pre">wesn</span></tt>, <tt class="docutils literal"><span class="pre">inc</span></tt> as NULL (or arrays with elements all set to 0),
-and pass the <tt class="docutils literal"><span class="pre">par</span></tt> array as indicated below:</p>
-<blockquote>
-<div><dl class="docutils">
-<dt><strong>GMT_IS_GRID</strong></dt>
-<dd>An empty <a class="reference internal" href="#struct-grid"><em>GMT_GRID</em></a> structure with a header is allocated; the data
-array is NULL. The <tt class="docutils literal"><span class="pre">par</span></tt> argument is not used. Here <tt class="docutils literal"><span class="pre">wesn</span></tt> and <tt class="docutils literal"><span class="pre">inc</span></tt> can
-be NULL but than <strong>-R</strong> and <strong>-I</strong> must have been set because they are inquired to
-get the necessary info. If they were not set, than <tt class="docutils literal"><span class="pre">wesn</span></tt> and <tt class="docutils literal"><span class="pre">inc</span></tt> must in
-fact be transmitted.</dd>
-<dt><strong>GMT_IS_IMAGE</strong></dt>
-<dd>Same as <strong>GMT_IS_GRID</strong> above but return an empty <a class="reference internal" href="#struct-image"><em>GMT_IMAGE</em></a></dd>
-<dt><strong>GMT_IS_DATASET</strong></dt>
-<dd>An empty <a class="reference internal" href="#struct-dataset"><em>GMT_DATASET</em></a> structure consisting of <tt class="docutils literal"><span class="pre">par[0]</span></tt> tables,
-each with <tt class="docutils literal"><span class="pre">par[1]</span></tt> segments, each with <tt class="docutils literal"><span class="pre">par[2]</span></tt> rows, all
-with <tt class="docutils literal"><span class="pre">par[3]</span></tt> columns, is allocated.
-The <tt class="docutils literal"><span class="pre">wesn</span></tt>, <tt class="docutils literal"><span class="pre">inc</span></tt>, and <tt class="docutils literal"><span class="pre">registration</span></tt> argument are ignored. The <tt class="docutils literal"><span class="pre">data</span></tt> argument should be NULL.</dd>
-<dt><strong>GMT_IS_TEXTSET</strong></dt>
-<dd>An empty <a class="reference internal" href="#struct-textset"><em>GMT_TEXTSET</em></a> structure consisting of <tt class="docutils literal"><span class="pre">par[0]</span></tt> tables,
-each with <tt class="docutils literal"><span class="pre">par[1]</span></tt> segments, all with <tt class="docutils literal"><span class="pre">par[2]</span></tt> text records (rows), is allocated.
-The <tt class="docutils literal"><span class="pre">wesn</span></tt>, <tt class="docutils literal"><span class="pre">inc</span></tt>, and <tt class="docutils literal"><span class="pre">registration</span></tt> argument are ignored. The <tt class="docutils literal"><span class="pre">data</span></tt> argument should be NULL.</dd>
-<dt><strong>GMT_IS_CPT</strong></dt>
-<dd>An empty <a class="reference internal" href="#struct-palette"><em>GMT_PALETTE</em></a> structure with <tt class="docutils literal"><span class="pre">par[0]</span></tt> palette entries is allocated.
-The <tt class="docutils literal"><span class="pre">wesn</span></tt>, <tt class="docutils literal"><span class="pre">inc</span></tt>, and <tt class="docutils literal"><span class="pre">registration</span></tt> argument are ignored. The <tt class="docutils literal"><span class="pre">data</span></tt> argument should be NULL.</dd>
-<dt><strong>GMT_IS_VECTOR</strong></dt>
-<dd>An empty <a class="reference internal" href="#struct-vector"><em>GMT_VECTOR</em></a> structure with <tt class="docutils literal"><span class="pre">par[0]</span></tt> column entries is allocated.
-The <tt class="docutils literal"><span class="pre">wesn</span></tt>, <tt class="docutils literal"><span class="pre">inc</span></tt>, and <tt class="docutils literal"><span class="pre">registration</span></tt> argument are ignored. The <tt class="docutils literal"><span class="pre">data</span></tt> argument should be NULL.</dd>
-<dt><strong>GMT_IS_MATRIX</strong></dt>
-<dd>An empty <a class="reference internal" href="#struct-matrix"><em>GMT_MATRIX</em></a> structure is allocated. <tt class="docutils literal"><span class="pre">par[2]</span></tt> indicates
-the number of layers for a 3-D matrix, or pass 0, 1, or NULL for a 2-D matrix. Here,
-par[0] is the number of columns while par[1] has the number of rows. The <tt class="docutils literal"><span class="pre">data</span></tt> argument should be NULL.</dd>
-</dl>
-</div></blockquote>
-<p>For the second approach, you
-instead pass <tt class="docutils literal"><span class="pre">wesn</span></tt>, <tt class="docutils literal"><span class="pre">inc</span></tt>, and <tt class="docutils literal"><span class="pre">registration</span></tt> and leave <tt class="docutils literal"><span class="pre">par</span></tt> as NULL
-(or with all elements equal 0).
-For grids and images you may pass <tt class="docutils literal"><span class="pre">pad</span></tt> to set the padding, or -1 to
-accept the GMT default. The <tt class="docutils literal"><span class="pre">mode</span></tt> determines what is actually
-allocated when you have chosen grids or images. As for <a class="reference internal" href="#gmt-read-data">GMT_Read_Data</a>
-you can pass <tt class="docutils literal"><span class="pre">GMT_GRID_ALL</span></tt> to initialize the header and allocate
-space for the array; here <tt class="docutils literal"><span class="pre">data</span></tt> must be NULL. Alternatively, you can pass
-<tt class="docutils literal"><span class="pre">GMT_GRID_HEADER_ONLY</span></tt> to just initialize the grid or image header,
-and call a second time, passing <tt class="docutils literal"><span class="pre">GMT_GRID_DATA_ONLY</span></tt>, to allocate
-space for the array. In that second call you pass the pointer returned
-by the first call as <tt class="docutils literal"><span class="pre">data</span></tt> and specify the family; all other
-arguments should be NULL or 0. Normally, resources created by this
-function are considered to be input (i.e., have a direction that is <tt class="docutils literal"><span class="pre">GMT_IN</span></tt>).
-The exception to this is for vectors and matrices which will have a direction
-set to <tt class="docutils literal"><span class="pre">GMT_OUT</span></tt> when the dimensions specified are not complete (i.e., the
-row dimension of vectors is 0 and both dimensions are zero for matrices).
-The function returns a pointer to the
-data container. In case of an error we return a NULL pointer and pass an
-error code via <tt class="docutils literal"><span class="pre">API->error</span></tt>.</p>
-</div>
-<div class="section" id="duplicate-resources">
-<h2>3.4. Duplicate resources<a class="headerlink" href="#duplicate-resources" title="Permalink to this headline">¶</a></h2>
-<p>Often you have read or created a data resource and then need an
-identical copy, presumably to make modifications to. Or, you want a copy
-with the same dimensions and allocated memory, except data values should
-not be duplicated. Alternatively, perhaps you just want to duplicate the
-header and skip the allocation and duplication of the data. These tasks
-are addressed by</p>
-<blockquote id="gmt-duplicate-data">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">void</span> <span class="o">*</span><span class="nf">GMT_Duplicate_Data</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">family</span><span class="p">,</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">mode</span><span class="p">,</span> <span class="kt">void</span> <span class="o">*</span><span class="n">data</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>which returns a pointer to the allocated resource. Specify which
-<a class="reference internal" href="#tbl-family"><em>family</em></a> and select <tt class="docutils literal"><span class="pre">mode</span></tt> from <tt class="docutils literal"><span class="pre">GMT_DUPLICATE_DATA</span></tt>,
-<tt class="docutils literal"><span class="pre">GMT_DUPLICATE_ALLOC</span></tt>, and <tt class="docutils literal"><span class="pre">GMT_DUPLICATE_NONE</span></tt>, as discussed above
-(also see <tt class="docutils literal"><span class="pre">mode</span></tt> discussion above). For datasets and textsets you can
-add modifiers <tt class="docutils literal"><span class="pre">GMT_ALLOC_VERTICAL</span></tt> or <tt class="docutils literal"><span class="pre">GMT_ALLOC_HORIZONTAL</span></tt> if you
-wish to put all data in a single long table or to paste all tables
-side-by-side, respectively (thus getting one wide table instead).
-Additional note for datasets: Normally we allocate the output given the
-corresponding input dimensions. You can override these by specifying your
-alternative dimensions in the input dataset variable dim[].
-The <tt class="docutils literal"><span class="pre">data</span></tt> is a pointer to the resource you wish to duplicate. In case
-of an error we return a NULL pointer and pass an error code via
-<tt class="docutils literal"><span class="pre">API->error</span></tt>.</p>
-</div>
-<div class="section" id="get-resource-id">
-<h2>3.5. Get resource ID<a class="headerlink" href="#get-resource-id" title="Permalink to this headline">¶</a></h2>
-<p>Resources created by these two methods can be used as in various ways.
-Sometimes you want to pass them as input to other modules, in which
-case you need to registration ID of that resource. This task
-are performed by</p>
-<blockquote id="gmt-get-id">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">void</span> <span class="o">*</span><span class="nf">GMT_Get_ID</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">family</span><span class="p">,</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">direction</span><span class="p">,</span> <span class="kt">void</span> <span class="o">*</span><span class="n">data</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>which returns the ID number of the allocated resource. Specify which
-<a class="reference internal" href="#tbl-family"><em>family</em></a> and select <tt class="docutils literal"><span class="pre">direction</span></tt> from <tt class="docutils literal"><span class="pre">GMT_IN</span></tt> or <tt class="docutils literal"><span class="pre">GMT_OUT</span></tt>.
-The <tt class="docutils literal"><span class="pre">data</span></tt> is a pointer to the resource you whose ID you need. In case
-of an error we return <tt class="docutils literal"><span class="pre">GMT_NOTSET</span></tt> and pass an error code via
-<tt class="docutils literal"><span class="pre">API->error</span></tt>.</p>
-</div>
-<div class="section" id="import-data">
-<h2>3.6. Import Data<a class="headerlink" href="#import-data" title="Permalink to this headline">¶</a></h2>
-<p>If your main program needs to read any of the five recognized data types
-(CPT files, data tables, text tables, GMT grids, or images) you will
-use the <a class="reference internal" href="#gmt-get-data">GMT_Get_Data</a> or <a class="reference internal" href="#gmt-read-data">GMT_Read_Data</a> functions, which both
-return entire data sets. In the case of data and text tables you may
-also select record-by-record reading using the <a class="reference internal" href="#gmt-get-record">GMT_Get_Record</a>
-function. As a general rule, your program development simplifies if you
-can read entire resources into memory with <a class="reference internal" href="#gmt-get-data">GMT_Get_Data</a> or
-<a class="reference internal" href="#gmt-read-data">GMT_Read_Data</a>. However, if this leads to unacceptable memory usage
-or if the program logic is particularly simple, you may obtain one data
-record at the time via <a class="reference internal" href="#gmt-get-record">GMT_Get_Record</a>.</p>
-<p>All input functions takes a parameter called <tt class="docutils literal"><span class="pre">mode</span></tt>. The <tt class="docutils literal"><span class="pre">mode</span></tt>
-parameter generally has different meanings for the different data types
-and will be discussed below. However, one bit setting is common to all
-types: By default, you are only allowed to read a data source once; the
-source is then flagged as having been read and subsequent attempts to
-read from the same source will result in a warning and no reading takes
-place. In the unlikely event you need to re-read a source you can
-override this default behavior by adding <tt class="docutils literal"><span class="pre">GMT_IO_RESET</span></tt> to your <tt class="docutils literal"><span class="pre">mode</span></tt>
-parameter. Note that this override does not apply to sources that are
-streams or file handles, as it may not be possible to re-read their
-contents.</p>
-<div class="section" id="enable-data-import">
-<h3>3.6.1. Enable Data Import<a class="headerlink" href="#enable-data-import" title="Permalink to this headline">¶</a></h3>
-<p>Once all input resources have been registered, we signal the API that we
-are done with the registration phase and are ready to start the actual
-data import. This step is only required when reading one record at the
-time. We initialize record-by-record reading by calling
-<a class="reference internal" href="#gmt-begin-io">GMT_Begin_IO</a> This function enables dataset and textset
-record-by-record reading and prepares the registered sources for the
-upcoming import. The prototype is</p>
-<blockquote id="gmt-begin-io">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="nf">GMT_Begin_IO</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">family</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">direction</span><span class="p">,</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">mode</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">header</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>where <a class="reference internal" href="#tbl-family"><em>family</em></a> specifies the resource type to be read or written
-(only <tt class="docutils literal"><span class="pre">GMT_IS_DATASET</span></tt> and <tt class="docutils literal"><span class="pre">GMT_IS_TEXTSET</span></tt> are
-available for record-by-record handling). The <tt class="docutils literal"><span class="pre">direction</span></tt> is either
-<tt class="docutils literal"><span class="pre">GMT_IN</span></tt> or <tt class="docutils literal"><span class="pre">GMT_OUT</span></tt>, so for import we obviously use <tt class="docutils literal"><span class="pre">GMT_IN</span></tt>. The
-function determines the first input source and sets up procedures for
-skipping to the next input source in a virtual data set. The
-<a class="reference internal" href="#gmt-get-record">GMT_Get_Record</a> function will not be able to read any data before
-<a class="reference internal" href="#gmt-begin-io">GMT_Begin_IO</a> has been called. As you might guess, there is a
-companion <a class="reference internal" href="#gmt-end-io">GMT_End_IO</a> function that completes, then disables
-record-by-record data access. You can use these several times to switch
-modes between registering data resources, doing the importing/exporting,
-and disabling further data access, perhaps to do more registration. We
-will discuss <a class="reference internal" href="#gmt-end-io">GMT_End_IO</a> once we are done with the data import. The
-<tt class="docutils literal"><span class="pre">mode</span></tt> option is used to allow output to write table header
-information (<tt class="docutils literal"><span class="pre">GMT_HEADER_ON</span></tt>) or not (<tt class="docutils literal"><span class="pre">GMT_HEADER_OFF</span></tt>). This is
-usually on unless you are writing messages and other non-data. The final
-<tt class="docutils literal"><span class="pre">header</span></tt> argument determines if the common header-block should be
-written during initialization; choose between <tt class="docutils literal"><span class="pre">GMT_HEADER_ON</span></tt> and
-<tt class="docutils literal"><span class="pre">GMT_HEADER_OFF</span></tt>. The function returns 1 if there is an
-error; otherwise it returns 0.</p>
-</div>
-<div class="section" id="import-a-data-set">
-<h3>3.6.2. Import a data set<a class="headerlink" href="#import-a-data-set" title="Permalink to this headline">¶</a></h3>
-<p>If your program needs to import any of the five recognized data types
-(CPT table, data table, text table, GMT grid, or image) you will use
-either the <a class="reference internal" href="#gmt-read-data">GMT_Read_Data</a> or <a class="reference internal" href="#gmt-get-data">GMT_Get_Data</a> functions. The former
-is typically used when reading from files, streams (e.g., <tt class="docutils literal"><span class="pre">stdin</span></tt>), or
-an open file handle, while the latter is only used with a registered
-resource via its unique ID. Because of the similarities of these five
-import functions we use an generic form that covers all of them.</p>
-<div class="section" id="import-from-a-file-stream-or-handle">
-<h4>3.6.2.1. Import from a file, stream, or handle<a class="headerlink" href="#import-from-a-file-stream-or-handle" title="Permalink to this headline">¶</a></h4>
-<p>To read an entire resource from a file, stream, or file handle, use</p>
-<blockquote id="gmt-read-data">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">void</span> <span class="o">*</span><span class="nf">GMT_Read_Data</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">family</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">method</span><span clas [...]
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">geometry</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">mode</span><span class="p">,</span> <span class="kt">double</span> <span class="n">wesn</span><span class="p">[],</span>
- <span class="kt">char</span> <span class="o">*</span><span class="n">input</span><span class="p">,</span> <span class="kt">void</span> <span class="o">*</span><span class="n">ptr</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<ul class="simple">
-<li><a class="reference internal" href="#gmt-create-session"><em>API</em></a></li>
-<li><a class="reference internal" href="#tbl-family"><em>family</em></a></li>
-<li><a class="reference internal" href="#tbl-methods"><em>method</em></a></li>
-<li><a class="reference internal" href="#tbl-geometry"><em>geometry</em></a></li>
-<li>mode – <em>see below</em></li>
-<li><a class="reference internal" href="#tbl-wesn"><em>wesn</em></a></li>
-<li>input – a pointer to char holding the file name to read.</li>
-<li>ptr – NULL or the pointer returned by this function after a first call (when reading grids in two steps)</li>
-<li>Return: Pointer to data container, or NULL if there were errors (passed back via API->error)</li>
-</ul>
-<p>where <tt class="docutils literal"><span class="pre">ptr</span></tt> is NULL except when reading grids in two steps (i.e.,
-first get a grid structure with a header, then read the data). Most of
-these arguments have been discussed earlier. This function can be called
-in three different situations:</p>
-<ol class="arabic simple">
-<li>If you have a single source (filename, stream pointer, etc.) you can
-call <a class="reference internal" href="#gmt-read-data">GMT_Read_Data</a> directly; there is no need to first register
-the source with <a class="reference internal" href="#gmt-register-io">GMT_Register_IO</a> or gather the sources with
-<a class="reference internal" href="#gmt-init-io">GMT_Init_IO</a>. However, if you did register a single source you can
-still pass it via an encoded filename (see <a class="reference internal" href="#gmt-encode-id">GMT_Encode_ID</a>) or you
-can instead use <a class="reference internal" href="#gmt-get-data">GMT_Get_Data</a> using the integer ID directly (see
-next section).</li>
-<li>If you want to specify <tt class="docutils literal"><span class="pre">stdin</span></tt> as source then use <tt class="docutils literal"><span class="pre">input</span></tt> as NULL.</li>
-<li>If you already registered all desired sources with <a class="reference internal" href="#gmt-init-io">GMT_Init_IO</a>
-then you indicate this by passing <tt class="docutils literal"><span class="pre">geometry</span></tt> = 0.</li>
-</ol>
-<p>Space will be allocated to hold the results, if needed, and a pointer to
-the object is returned. If there are errors we simply return NULL and
-report the error. The <tt class="docutils literal"><span class="pre">mode</span></tt> parameter has different meanings for
-different data types.</p>
-<dl class="docutils">
-<dt><strong>CPT table</strong></dt>
-<dd><tt class="docutils literal"><span class="pre">mode</span></tt> contains bit-flags that control how the CPT file’s back-,
-fore-, and NaN-colors should be initialized. Select 0 to use the CPT
-file’s back-, fore-, and NaN-colors, 2 to replace these with the
-GMT default values, or 4 to replace them with the color table’s
-entries for highest and lowest value.</dd>
-<dt><strong>Data table</strong></dt>
-<dd><tt class="docutils literal"><span class="pre">mode</span></tt> is currently not used.</dd>
-<dt><strong>Text table</strong></dt>
-<dd><tt class="docutils literal"><span class="pre">mode</span></tt> is currently not used.</dd>
-<dt><strong>GMT grid</strong></dt>
-<dd>Here, <tt class="docutils literal"><span class="pre">mode</span></tt> determines how we read the grid: To read the entire
-grid and its header, pass <tt class="docutils literal"><span class="pre">GMT_GRID_ALL</span></tt>. However, if you need to
-extract a sub-region you must first read the header by passing
-<tt class="docutils literal"><span class="pre">GMT_GRID_HEADER_ONLY</span></tt>, then examine the header structure range
-attributes and to specify a subset via the array <tt class="docutils literal"><span class="pre">wesn</span></tt>, and
-finally call <a class="reference internal" href="#gmt-read-data">GMT_Read_Data</a> a second time, now with <tt class="docutils literal"><span class="pre">mode</span></tt> =
-<tt class="docutils literal"><span class="pre">GMT_GRID_DATA_ONLY</span></tt> and passing your <tt class="docutils literal"><span class="pre">wesn</span></tt> array and the grid
-structure returned from the first call as <tt class="docutils literal"><span class="pre">ptr</span></tt>. In the event your
-data array should be allocated to hold both the real and imaginary
-parts of a complex data set you must add either
-<tt class="docutils literal"><span class="pre">GMT_GRID_IS_COMPLEX_REAL</span></tt> or <tt class="docutils literal"><span class="pre">GMT_GRID_IS_COMPLEX_IMAG</span></tt> to
-<tt class="docutils literal"><span class="pre">mode</span></tt> so as to allow for the extra memory needed and to stride
-the input values correctly. If your grid is huge and you must read
-it row-by-row, set <tt class="docutils literal"><span class="pre">mode</span></tt> to <tt class="docutils literal"><span class="pre">GMT_GRID_HEADER_ONLY</span></tt> |
-<tt class="docutils literal"><span class="pre">GMT_GRID_ROW_BY_ROW</span></tt>. You can then access the grid row-by-row
-using <a class="reference internal" href="#gmt-get-row">GMT_Get_Row</a> By default the rows will be automatically
-processed in order. To completely specify which row to be read, use
-<tt class="docutils literal"><span class="pre">GMT_GRID_ROW_BY_ROW_MANUAL</span></tt> instead.</dd>
-</dl>
-</div>
-<div class="section" id="import-from-a-memory-location">
-<h4>3.6.2.2. Import from a memory location<a class="headerlink" href="#import-from-a-memory-location" title="Permalink to this headline">¶</a></h4>
-<p>If you are importing via variables or prefer to first register the
-source, then you should use <a class="reference internal" href="#gmt-get-data">GMT_Get_Data</a> instead. This function
-requires fewer arguments since you simply pass the unique ID number of
-the resource. The function is described as follows:</p>
-<blockquote id="gmt-get-data">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">void</span> <span class="o">*</span><span class="nf">GMT_Get_Data</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">int</span> <span class="n">ID</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">mode</span><span class="p">,</span> <span class="kt">void</sp [...]
-</pre></div>
-</div>
-</div></blockquote>
-<p>The <tt class="docutils literal"><span class="pre">ID</span></tt> is the unique object ID you received when registering the
-resource, <tt class="docutils literal"><span class="pre">mode</span></tt> controls some aspects of the import (see
-<a class="reference internal" href="#gmt-read-data">GMT_Read_Data</a> above), while <tt class="docutils literal"><span class="pre">ptr</span></tt> is NULL except when reading
-grids in two steps (i.e., first get a grid structure with a header, then
-read the data). Other arguments have been discussed earlier. Space will
-be allocated to hold the results, if needed, and a pointer to the object
-is returned. If there are errors we simply return NULL and report the error.</p>
-</div>
-<div class="section" id="retrieve-an-allocated-result">
-<h4>3.6.2.3. Retrieve an allocated result<a class="headerlink" href="#retrieve-an-allocated-result" title="Permalink to this headline">¶</a></h4>
-<p>Finally, if you need to access the result that a GMT module wrote to a
-memory location, then you must register an output destination with
-<a class="reference internal" href="#gmt-register-io">GMT_Register_IO</a> first (passing <tt class="docutils literal"><span class="pre">ptr</span></tt> == NULL). The GMT module will
-then allocate space to hold the output and let the API know where this
-memory resides. You can then use <a class="reference internal" href="#gmt-retrieve-data">GMT_Retrieve_Data</a> to get a pointer
-to the container where the data set was stored. This function requires
-fewer arguments since you simply pass the unique ID number of the
-resource. The function is described as follows:</p>
-<blockquote id="gmt-retrieve-data">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">void</span> <span class="o">*</span><span class="nf">GMT_Retrieve_Data</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">int</span> <span class="n">ID</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>The <tt class="docutils literal"><span class="pre">ID</span></tt> is the unique object ID you received when registering the
-NULL resource earlier, Since this container has already been created, a
-pointer to the object is returned. If there are errors we simply return
-NULL and report the error.</p>
-</div>
-</div>
-<div class="section" id="importing-a-data-record">
-<h3>3.6.3. Importing a data record<a class="headerlink" href="#importing-a-data-record" title="Permalink to this headline">¶</a></h3>
-<p>If your program will read data table records one-by-one you must first
-enable this input mechanism with <a class="reference internal" href="#gmt-begin-io">GMT_Begin_IO</a> and then read the
-records in a loop using</p>
-<blockquote id="gmt-get-record">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">void</span> <span class="o">*</span><span class="nf">GMT_Get_Record</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">mode</span><span class="p">,</span> <span class="kt">int</span> <span class="o">*</span><span class="n">nfields</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>where the returned value is either a pointer to a double array with the
-current row values or to a character string with the current row,
-depending on <tt class="docutils literal"><span class="pre">mode</span></tt>. In either case these pointers point to memory
-internal to GMT and should be considered read-only. When we reach
-end-of-file, encounter conversion problems, read header comments, or
-identify segment headers we return a NULL pointer. The <tt class="docutils literal"><span class="pre">nfields</span></tt>
-pointer will return the number of fields returned; pass NULL if your
-program should ignore this information.</p>
-<p>Normally (<tt class="docutils literal"><span class="pre">mode</span></tt> == <tt class="docutils literal"><span class="pre">GMT_READ_DOUBLE</span></tt>), we return a pointer to
-the double array. To read text records, supply instead <tt class="docutils literal"><span class="pre">mode</span></tt> ==
-<tt class="docutils literal"><span class="pre">GMT_READ_TEXT</span></tt> and we instead return a pointer to the text
-record. However, if you have input records that mixes organized
-floating-point columns with text items you could pass <tt class="docutils literal"><span class="pre">mode</span></tt> ==
-<tt class="docutils literal"><span class="pre">GMT_READ_MIXED</span></tt>. Then, GMT will attempt to extract the
-floating-point values; you can still access the record string, as
-discussed below. Finally, if your application needs to be notified when
-GMT closes one file and opens the next, add <tt class="docutils literal"><span class="pre">GMT_FILE_BREAK</span></tt> to
-<tt class="docutils literal"><span class="pre">mode</span></tt> and check for the status code <tt class="docutils literal"><span class="pre">GMT_IO_NEXT_FILE</span></tt> (by default,
-we treat the concatenation of many input files as a single virtual
-file). Using <a class="reference internal" href="#gmt-get-record">GMT_Get_Record</a> requires you to first initialize the
-source(s) with <a class="reference internal" href="#gmt-init-io">GMT_Init_IO</a>. For certain records, <a class="reference internal" href="#gmt-get-record">GMT_Get_Record</a>
-will return NULL and sets status codes that your program will need to
-examine to take appropriate response. Table [tbl:iostatus] list the
-various status codes you can check for, using <tt class="docutils literal"><span class="pre">GMT_Status_IO</span></tt> (see
-next section).</p>
-</div>
-<div class="section" id="examining-record-status">
-<h3>3.6.4. Examining record status<a class="headerlink" href="#examining-record-status" title="Permalink to this headline">¶</a></h3>
-<p>Programs that read record-by-record must be aware of what the current
-record represents. Given the presence of headers, data gaps, NaN-record,
-etc., the developer will want to check the status after reading the next
-record. The internal i/o status mode can be interrogated with the function</p>
-<blockquote id="gmt-status-io">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="nf">GMT_Status_IO</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">mode</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>which returns 0 (false) or 1 (true) if the current status is reflected
-by the specified <tt class="docutils literal"><span class="pre">mode</span></tt>. There are 11 different modes available to
-programmers; for a list see Table <a class="reference internal" href="#tbl-iostatus"><em>IO-status</em></a> For an example of how
-these may be used, see the test program <tt class="docutils literal"><span class="pre">testgmtio.c</span></tt>. Developers who plan to import
-data on a record-by-record basis may also consult the source code of,
-say, <tt class="docutils literal"><span class="pre">blockmean.c</span></tt> or <tt class="docutils literal"><span class="pre">pstext.c</span></tt>, to see examples of working code.</p>
-<table border="1" class="docutils" id="tbl-iostatus">
-<colgroup>
-<col width="33%" />
-<col width="67%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head">mode</th>
-<th class="head">description and return value</th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>GMT_IO_DATA_RECORD</td>
-<td>1 if we read a data record</td>
-</tr>
-<tr class="row-odd"><td>GMT_IO_TABLE_HEADER</td>
-<td>1 if we read a table header</td>
-</tr>
-<tr class="row-even"><td>GMT_IO_SEGMENT_HEADER</td>
-<td>1 if we read a segment header</td>
-</tr>
-<tr class="row-odd"><td>GMT_IO_ANY_HEADER</td>
-<td>1 if we read either header record</td>
-</tr>
-<tr class="row-even"><td>GMT_IO_MISMATCH</td>
-<td>1 if we read incorrect number of columns</td>
-</tr>
-<tr class="row-odd"><td>GMT_IO_EOF</td>
-<td>1 if we reached the end of the file (EOF)</td>
-</tr>
-<tr class="row-even"><td>GMT_IO_NAN</td>
-<td>1 if we only read NaNs</td>
-</tr>
-<tr class="row-odd"><td>GMT_IO_GAP</td>
-<td>1 if this record implies a data gap</td>
-</tr>
-<tr class="row-even"><td>GMT_IO_NEW_SEGMENT</td>
-<td>1 if we enter a new segment</td>
-</tr>
-<tr class="row-odd"><td>GMT_IO_LINE_BREAK</td>
-<td>1 if we encountered a segment header, EOF, NaNs or gap</td>
-</tr>
-<tr class="row-even"><td>GMT_IO_NEXT_FILE</td>
-<td>1 if we finished one file but not the last</td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="importing-a-grid-row">
-<h3>3.6.5. Importing a grid row<a class="headerlink" href="#importing-a-grid-row" title="Permalink to this headline">¶</a></h3>
-<p>If your program must read a grid file row-by-row you must first enable
-row-by-row reading with <a class="reference internal" href="#gmt-read-data"><em>GMT_Read_Data</em></a> and then use the
-<tt class="docutils literal"><span class="pre">GMT_Get_Row</span></tt> function in a loop; the prototype is</p>
-<blockquote id="gmt-get-row">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="nf">GMT_Get_Row</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">int</span> <span class="n">row_no</span><span class="p">,</span> <span class="k">struct</span> <span class="n">GMT_GRID</span> <span class="o">*</span><span class="n">G</span><span class="p">,</span> <span class="kt">float</s [...]
-</pre></div>
-</div>
-</div></blockquote>
-<p>where <tt class="docutils literal"><span class="pre">row</span></tt> is a pointer to a single-precision array to receive the
-current row, <tt class="docutils literal"><span class="pre">G</span></tt> is the grid in question, and <tt class="docutils literal"><span class="pre">row_no</span></tt> is the number
-of the current row to be read. Note this value is only considered if the
-row-by-row mode was initialized with <tt class="docutils literal"><span class="pre">GMT_GRID_ROW_BY_ROW_MANUAL</span></tt>.
-The user must allocate enough space to hold the entire row in memory.</p>
-</div>
-<div class="section" id="disable-data-import">
-<h3>3.6.6. Disable Data Import<a class="headerlink" href="#disable-data-import" title="Permalink to this headline">¶</a></h3>
-<p>Once the record-by-record input processing has completed we disable
-further input to prevent accidental reading from occurring (due to poor
-program structure, bugs, etc.). We do so by calling <tt class="docutils literal"><span class="pre">GMT_End_IO</span></tt>. This
-function disables further record-by-record data import; its prototype is</p>
-<blockquote id="gmt-end-io">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="nf">GMT_End_IO</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">direction</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">mode</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>and we specify <tt class="docutils literal"><span class="pre">direction</span></tt> = <tt class="docutils literal"><span class="pre">GMT_IN</span></tt>. At the moment, <tt class="docutils literal"><span class="pre">mode</span></tt> is not
-used. This call will also reallocate any arrays obtained into their
-proper lengths. The function returns 1 if there is an error
-(which is passed back with <tt class="docutils literal"><span class="pre">API->error</span></tt>), otherwise it returns 0.</p>
-</div>
-</div>
-<div class="section" id="manipulate-data">
-<span id="sec-manipulate"></span><h2>3.7. Manipulate data<a class="headerlink" href="#manipulate-data" title="Permalink to this headline">¶</a></h2>
-<p>Once you have created and allocated empty resources, or read in
-resources from the outside, you will wish to manipulate their contents.
-This section discusses how to set up loops and access the important
-variables for the various data families. For grids and images it may
-be required to know what the coordinates are at each node point. This
-can be obtained via arrays of coordinates for each dimension, obtained by</p>
-<blockquote id="gmt-get-coord">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">double</span> <span class="o">*</span><span class="nf">GMT_Get_Coord</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">family</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">dim</span><span class [...]
-</pre></div>
-</div>
-</div></blockquote>
-<p>where <a class="reference internal" href="#tbl-family"><em>family</em></a> must be <tt class="docutils literal"><span class="pre">GMT_IS_GRID</span></tt> or <tt class="docutils literal"><span class="pre">GMT_IS_DATASET</span></tt>, <tt class="docutils literal"><span class="pre">dim</span></tt> is either
-<tt class="docutils literal"><span class="pre">GMT_IS_X</span></tt> or <tt class="docutils literal"><span class="pre">GMT_IS_Y</span></tt>, and <tt class="docutils literal"><span class="pre">data</span></tt> is the grid or image pointer. This
-function will be used below in our example on grid manipulation.</p>
-<p>Another aspect of dealing with grids and images is to convert a row and column
-2-D reference to our 1-D array index. Because of grid and image boundary padding
-the relationship is not straightforward, hence we supply</p>
-<blockquote id="gmt-get-index">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int64_t</span> <span class="nf">GMT_Get_Index</span> <span class="p">(</span><span class="k">struct</span> <span class="n">GMT_GRID_HEADER</span> <span class="o">*</span><span class="n">header</span><span class="p">,</span> <span class="kt">int</span> <span class="n">row</span><span class="p">,</span> <span class="kt">int</span> <span class="n">col</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>where the <tt class="docutils literal"><span class="pre">header</span></tt> is the header of either a grid or image, and <tt class="docutils literal"><span class="pre">row</span></tt> and
-<tt class="docutils literal"><span class="pre">col</span></tt> is the 2-D position in the grid or image. We return the 1-D array
-position; again this function is used below in our example.</p>
-<div class="section" id="manipulate-grids">
-<h3>3.7.1. Manipulate grids<a class="headerlink" href="#manipulate-grids" title="Permalink to this headline">¶</a></h3>
-<p>Most applications wishing to manipulate grids will want to loop over all
-the nodes, typically in a manner organized by rows and columns. In doing
-so, the coordinates at each node may also be required for a calculation.
-Below is a snippet of code that shows how to do visit all nodes in a
-grid and assign each node the product x * y:</p>
-<blockquote>
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="n">row</span><span class="p">,</span> <span class="n">col</span><span class="p">,</span> <span class="n">node</span><span class="p">;</span>
-<span class="kt">double</span> <span class="o">*</span><span class="n">x_coord</span> <span class="o">=</span> <span class="nb">NULL</span><span class="p">,</span> <span class="o">*</span><span class="n">y_coord</span> <span class="o">=</span> <span class="nb">NULL</span><span class="p">;</span>
-<span class="o"><</span> <span class="p">...</span> <span class="n">create</span> <span class="n">a</span> <span class="n">grid</span> <span class="n">G</span> <span class="n">or</span> <span class="n">read</span> <span class="n">one</span> <span class="p">...</span> <span class="o">></span>
-<span class="n">x_coord</span> <span class="o">=</span> <span class="n">GMT_Get_Coord</span> <span class="p">(</span><span class="n">API</span><span class="p">,</span> <span class="n">GMT_IS_GRID</span><span class="p">,</span> <span class="n">GMT_X</span><span class="p">,</span> <span class="n">G</span><span class="p">);</span>
-<span class="n">y_coord</span> <span class="o">=</span> <span class="n">GMT_Get_Coord</span> <span class="p">(</span><span class="n">API</span><span class="p">,</span> <span class="n">GMT_IS_GRID</span><span class="p">,</span> <span class="n">GMT_Y</span><span class="p">,</span> <span class="n">G</span><span class="p">);</span>
-<span class="k">for</span> <span class="p">(</span><span class="n">row</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="n">row</span> <span class="o"><</span> <span class="n">G</span><span class="o">-></span><span class="n">header</span><span class="o">-></span><span class="n">ny</span><span class="p">)</span> <span class="p">{</span>
- <span class="k">for</span> <span class="p">(</span><span class="n">col</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="n">col</span> <span class="o"><</span> <span class="n">G</span><span class="o">-></span><span class="n">header</span><span class="o">-></span><span class="n">nx</span><span class="p">;</span> <span class="n">col</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span>
- <span class="n">node</span> <span class="o">=</span> <span class="n">GMT_Get_Index</span> <span class="p">(</span><span class="n">G</span><span class="o">-></span><span class="n">header</span><span class="p">,</span> <span class="n">row</span><span class="p">,</span> <span class="n">col</span><span class="p">);</span>
- <span class="n">G</span><span class="o">-></span><span class="n">data</span><span class="p">[</span><span class="n">node</span><span class="p">]</span> <span class="o">=</span> <span class="n">x_coord</span><span class="p">[</span><span class="n">col</span><span class="p">]</span> <span class="o">*</span> <span class="n">y_coord</span><span class="p">[</span><span class="n">row</span><span class="p">];</span>
- <span class="p">}</span>
-<span class="p">}</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>Note the use of <a class="reference internal" href="#gmt-get-index"><em>GMT_Get_Index</em></a> to get the grid node number associated
-with the <tt class="docutils literal"><span class="pre">row</span></tt> and <tt class="docutils literal"><span class="pre">col</span></tt> we are visiting. Because GMT grids have
-padding (for boundary conditions) the relationship between rows,
-columns, and node indices is more complicated and hence we hide that
-complexity in <a class="reference internal" href="#gmt-get-index"><em>GMT_Get_Index</em></a>. Note that for trivial procedures such
-setting all grid nodes to a constant (e.g., -9999.0) where the row and
-column does not enter you can instead do a single loop:</p>
-<blockquote>
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="n">node</span><span class="p">;</span>
-<span class="o"><</span> <span class="p">...</span> <span class="n">create</span> <span class="n">a</span> <span class="n">grid</span> <span class="n">G</span> <span class="n">or</span> <span class="n">read</span> <span class="n">one</span> <span class="p">...</span> <span class="o">></span>
-<span class="k">for</span> <span class="p">(</span><span class="n">node</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="n">node</span> <span class="o"><</span> <span class="n">G</span><span class="o">-></span><span class="n">header</span><span class="o">-></span><span class="n">size</span><span class="p">)</span> <span class="n">G</span><span class="o">-></span><span class="n">data</span><span class="p">[</span><span class="n">no [...]
-</pre></div>
-</div>
-</div></blockquote>
-<p>Note we must use <tt class="docutils literal"><span class="pre">G->header->size</span></tt> (size of allocated array) and not
-<tt class="docutils literal"><span class="pre">G->header->nm</span></tt> (number of nodes in grid) since the latter is smaller
-due to the padding and a single loop like the above treats the pad as
-part of the “inside” grid.</p>
-</div>
-<div class="section" id="manipulate-data-tables">
-<h3>3.7.2. Manipulate data tables<a class="headerlink" href="#manipulate-data-tables" title="Permalink to this headline">¶</a></h3>
-<p>Another common application is to process the records in a data table.
-Because GMT consider the <tt class="docutils literal"><span class="pre">GMT_DATASET</span></tt> resources to contain one or more
-tables, each of which may contain one or more segments, all of which may
-contain one or more columns, you will need to have multiple loops to
-visit all entries. The following code snippet will visit all data
-records and add 1 to all columns beyond the first two (x and y):</p>
-<blockquote>
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">uint64_t</span> <span class="n">tbl</span><span class="p">,</span> <span class="n">seg</span><span class="p">,</span> <span class="n">row</span><span class="p">,</span> <span class="n">col</span><span class="p">;</span>
-<span class="k">struct</span> <span class="n">GMT_DATATABLE</span> <span class="o">*</span><span class="n">T</span> <span class="o">=</span> <span class="nb">NULL</span><span class="p">;</span>
-<span class="k">struct</span> <span class="n">GMT_DATASEGMENT</span> <span class="o">*</span><span class="n">S</span> <span class="o">=</span> <span class="nb">NULL</span><span class="p">;</span>
-
-<span class="o"><</span> <span class="p">...</span> <span class="n">create</span> <span class="n">a</span> <span class="n">dataset</span> <span class="n">D</span> <span class="n">or</span> <span class="n">read</span> <span class="n">one</span> <span class="p">...</span> <span class="o">></span>
-<span class="k">for</span> <span class="p">(</span><span class="n">tbl</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="n">tbl</span> <span class="o"><</span> <span class="n">D</span><span class="o">-></span><span class="n">n_tables</span><span class="p">;</span> <span class="n">tbl</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span> <span class="cm">/* For each table */</span>
- <span class="n">T</span> <span class="o">=</span> <span class="n">D</span><span class="o">-></span><span class="n">table</span><span class="p">[</span><span class="n">tbl</span><span class="p">];</span> <span class="cm">/* Convenient shorthand for current table */</span>
- <span class="k">for</span> <span class="p">(</span><span class="n">seg</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="n">seg</span> <span class="o"><</span> <span class="n">T</span><span class="o">-></span><span class="n">n_segments</span><span class="p">;</span> <span class="n">seg</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span> <span class="cm">/* For all segments */</span>
- <span class="n">S</span> <span class="o">=</span> <span class="n">T</span><span class="o">-></span><span class="n">segment</span><span class="p">[</span><span class="n">seg</span><span class="p">];</span> <span class="cm">/* Convenient shorthand for current segment */</span>
- <span class="k">for</span> <span class="p">(</span><span class="n">row</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="n">row</span> <span class="o"><</span> <span class="n">S</span><span class="o">-></span><span class="n">n_rows</span><span class="p">;</span> <span class="n">row</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span>
- <span class="k">for</span> <span class="p">(</span><span class="n">col</span> <span class="o">=</span> <span class="mi">2</span><span class="p">;</span> <span class="n">col</span> <span class="o"><</span> <span class="n">T</span><span class="o">-></span><span class="n">n_columns</span><span class="p">;</span> <span class="n">col</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span>
- <span class="n">S</span><span class="o">-></span><span class="n">coord</span><span class="p">[</span><span class="n">col</span><span class="p">][</span><span class="n">row</span><span class="p">]</span> <span class="o">+=</span> <span class="mf">1.0</span><span class="p">;</span>
- <span class="p">}</span>
- <span class="p">}</span>
- <span class="p">}</span>
-<span class="p">}</span>
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="manipulate-text-tables">
-<h3>3.7.3. Manipulate text tables<a class="headerlink" href="#manipulate-text-tables" title="Permalink to this headline">¶</a></h3>
-<p>When data file contain text mixed in with numbers you must open the file
-as a <tt class="docutils literal"><span class="pre">GMT_TEXTSET</span></tt> and do your own parsing of the data records. The
-following code snippet will visit all text records and print them out:</p>
-<blockquote>
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">uint64_t</span> <span class="n">tbl</span><span class="p">,</span> <span class="n">seg</span><span class="p">,</span> <span class="n">row</span><span class="p">,</span> <span class="n">col</span><span class="p">;</span>
-<span class="k">struct</span> <span class="n">GMT_TEXTTABLE</span> <span class="o">*</span><span class="n">T</span> <span class="o">=</span> <span class="nb">NULL</span><span class="p">;</span>
-<span class="k">struct</span> <span class="n">GMT_TEXTSEGMENT</span> <span class="o">*</span><span class="n">S</span> <span class="o">=</span> <span class="nb">NULL</span><span class="p">;</span>
-
-<span class="o"><</span> <span class="p">...</span> <span class="n">create</span> <span class="n">a</span> <span class="n">textset</span> <span class="n">D</span> <span class="n">or</span> <span class="n">read</span> <span class="n">one</span> <span class="p">...</span> <span class="o">></span>
-<span class="k">for</span> <span class="p">(</span><span class="n">tbl</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="n">tbl</span> <span class="o"><</span> <span class="n">D</span><span class="o">-></span><span class="n">n_tables</span><span class="p">;</span> <span class="n">tbl</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span> <span class="cm">/* For each table */</span>
- <span class="n">T</span> <span class="o">=</span> <span class="n">D</span><span class="o">-></span><span class="n">table</span><span class="p">[</span><span class="n">tbl</span><span class="p">];</span> <span class="cm">/* Convenient shorthand for current table */</span>
- <span class="k">for</span> <span class="p">(</span><span class="n">seg</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="n">seg</span> <span class="o"><</span> <span class="n">T</span><span class="o">-></span><span class="n">n_segments</span><span class="p">;</span> <span class="n">seg</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span> <span class="cm">/* For all segments */</span>
- <span class="n">S</span> <span class="o">=</span> <span class="n">T</span><span class="o">-></span><span class="n">segment</span><span class="p">[</span><span class="n">seg</span><span class="p">];</span> <span class="cm">/* Convenient shorthand for current segment */</span>
- <span class="k">for</span> <span class="p">(</span><span class="n">row</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="n">row</span> <span class="o"><</span> <span class="n">S</span><span class="o">-></span><span class="n">n_rows</span><span class="p">;</span> <span class="n">row</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span>
- <span class="n">printf</span> <span class="p">(</span><span class="s">"T=%d S=%d R=%d : %s</span><span class="se">\n</span><span class="s">"</span><span class="p">,</span> <span class="n">tbl</span><span class="p">,</span> <span class="n">seg</span><span class="p">,</span> <span class="n">row</span><span class="p">,</span> <span class="n">S</span><span class="o">-></span><span class="n">record</span><span class="p">[</span><span class="n">row</span><span class="p">]);</span>
- <span class="p">}</span>
- <span class="p">}</span>
-<span class="p">}</span>
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-</div>
-<div class="section" id="message-and-verbose-reporting">
-<h2>3.8. Message and Verbose Reporting<a class="headerlink" href="#message-and-verbose-reporting" title="Permalink to this headline">¶</a></h2>
-<p>The API provides two functions for your program to present information
-to the user during the run of the program. One is used for messages that
-are always written while the other is used for reports that must exceed
-the verbosity settings specified via <strong>-V</strong>.</p>
-<blockquote id="gmt-report">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="nf">GMT_Report</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">level</span><span class="p">,</span> <span class="kt">char</span> <span class="o">*</span><span class="n">message</span><span class="p">,</span> <span class="p">...);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>This function takes a verbosity level and a multi-part message (e.g., a
-format statement and zero or more variables). The verbosity <tt class="docutils literal"><span class="pre">level</span></tt> is
-an integer in the 0–5 range; these are listed in Table [tbl:verbosity].
-You assign an appropriate verbosity level to your message, and depending
-on the chosen run-time verbosity level set via <strong>-V</strong> your message may
-or may not be reported. Only messages whose stated verbosity level is
-lower or equal to the <strong>-V</strong><em>level</em> will be printed.</p>
-<table border="1" class="docutils" id="tbl-verbosity">
-<colgroup>
-<col width="33%" />
-<col width="67%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head">constant</th>
-<th class="head">description</th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>GMT_MSG_QUIET</td>
-<td>No messages whatsoever</td>
-</tr>
-<tr class="row-odd"><td>GMT_MSG_NORMAL</td>
-<td>Default output, e.g., warnings and errors only</td>
-</tr>
-<tr class="row-even"><td>GMT_MSG_COMPAT</td>
-<td>Compatibility warnings</td>
-</tr>
-<tr class="row-odd"><td>GMT_MSG_VERBOSE</td>
-<td>Verbose level</td>
-</tr>
-<tr class="row-even"><td>GMT_MSG_LONG_VERBOSE</td>
-<td>Longer verbose</td>
-</tr>
-<tr class="row-odd"><td>GMT_MSG_DEBUG</td>
-<td>Debug messages for developers mostly</td>
-</tr>
-</tbody>
-</table>
-<blockquote id="gmt-message">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="nf">GMT_Message</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">mode</span><span class="p">,</span> <span class="kt">char</span> <span class="o">*</span><span class="n">format</span><span class="p">,</span> <span class="p">...);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>This function always prints its message to the standard output. Use the
-<tt class="docutils literal"><span class="pre">mode</span></tt> value to control if a time stamp should preface the message.
-and if selected how the time information should be formatted. See
-Table <a class="reference internal" href="#tbl-timemodes"><em>timemodes</em></a> for the various modes.</p>
-<table border="1" class="docutils" id="tbl-timemodes">
-<colgroup>
-<col width="33%" />
-<col width="67%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head">constant</th>
-<th class="head">description</th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>GMT_TIME_NONE</td>
-<td>Display no time information</td>
-</tr>
-<tr class="row-odd"><td>GMT_TIME_CLOCK</td>
-<td>Display current local time</td>
-</tr>
-<tr class="row-even"><td>GMT_TIME_ELAPSED</td>
-<td>Display elapsed time since last reset</td>
-</tr>
-<tr class="row-odd"><td>GMT_TIME_RESET</td>
-<td>Reset the elapsed time to 0</td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="presenting-and-accessing-gmt-options">
-<span id="sec-parsopt"></span><h2>3.9. Presenting and accessing GMT options<a class="headerlink" href="#presenting-and-accessing-gmt-options" title="Permalink to this headline">¶</a></h2>
-<p>As you develop a program you may need to rely on some of
-the GMT common options. For instance, you may wish to have your
-program present the <tt class="docutils literal"><span class="pre">-R</span></tt> option to the user, let GMT handle the
-parsing, and examine the values. You may also wish to encode your own
-custom options that may require you to parse user text into the
-corresponding floating point dimensions, constants, coordinates, time, etc.
-The API provides several functions to simplify these tedious parsing
-tasks. This section is intended to show how the programmer will obtain
-information from the user that is necessary to do the task at hand
-(e.g., special options to provide values and settings for the program).
-In the following section we will concern ourselves with preparing
-arguments for calling any of the GMT modules.</p>
-<div class="section" id="display-usage-syntax-for-gmt-common-options">
-<h3>3.9.1. Display usage syntax for GMT common options<a class="headerlink" href="#display-usage-syntax-for-gmt-common-options" title="Permalink to this headline">¶</a></h3>
-<p>You can have your program menu display the standard usage message for a
-GMT common option by calling the function</p>
-<blockquote id="gmt-option">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="nf">GMT_Option</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">char</span> <span class="o">*</span><span class="n">options</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>where <tt class="docutils literal"><span class="pre">options</span></tt> is a comma-separated list of GMT common options
-(e.g., “R,J,O,X”). You can repeat this function with different sets of
-options in order to intersperse your own custom options with in an
-overall alphabetical order; see any GMT module for examples of typical
-layouts.</p>
-</div>
-<div class="section" id="parsing-the-gmt-common-options">
-<h3>3.9.2. Parsing the GMT common options<a class="headerlink" href="#parsing-the-gmt-common-options" title="Permalink to this headline">¶</a></h3>
-<p>The parsing of all GMT common option is done by</p>
-<blockquote id="gmt-parse-common">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="nf">GMT_Parse_Common</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">char</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="k">struct</span> <span class="n">GMT_OPTION</span> <span class="o">*</span><span class="n">list</span><span class="p">) [...]
-</pre></div>
-</div>
-</div></blockquote>
-<p>where <tt class="docutils literal"><span class="pre">args</span></tt> is a string of the common GMT options your program may
-use. An error will be reported if any of the common GMT options fail
-to parse, and if so we return TRUE; if not errors we return FALSE. All
-other options, including file names, will be silently ignored. The
-parsing will update the internal GMT information structure that
-affects program operations.</p>
-</div>
-<div class="section" id="inquiring-about-the-gmt-common-options">
-<h3>3.9.3. Inquiring about the GMT common options<a class="headerlink" href="#inquiring-about-the-gmt-common-options" title="Permalink to this headline">¶</a></h3>
-<p>The API provide only a limited window into the full GMT machinery
-accessible to the modules. You can determine if a particular common
-option has been parsed and in some cases determine the values that was set with</p>
-<blockquote id="gmt-get-common">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="nf">GMT_Get_Common</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">option</span><span class="p">,</span> <span class="kt">double</span> <span class="o">*</span><span class="n">par</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>where <tt class="docutils literal"><span class="pre">option</span></tt> is a single option character (e.g., ‘R’) and <tt class="docutils literal"><span class="pre">par</span></tt> is
-a double array with at least a length of 6. If the particular option has
-been parsed then the function returns the number of parameters passed
-back via <tt class="docutils literal"><span class="pre">par</span></tt>; otherwise we return -1. For instance, to determine if
-the <tt class="docutils literal"><span class="pre">-R</span></tt> was set and what the resulting region was set to you may call</p>
-<blockquote>
-<div><div class="highlight-c"><div class="highlight"><pre><span class="k">if</span> <span class="p">(</span><span class="n">GMT_Get_Common</span> <span class="p">(</span><span class="n">API</span><span class="p">,</span> <span class="sc">'R'</span><span class="p">,</span> <span class="n">wesn</span><span class="p">))</span> <span class="o">!=</span> <span class="o">-</span><span class="mi">1</span><span class="p">)</span> <span class="p">{</span>
- <span class="cm">/* wesn now contains the boundary information */</span>
-<span class="p">}</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>The <tt class="docutils literal"><span class="pre">wesn</span></tt> array could now be passed to the various read and create
-functions for GMT resources.</p>
-</div>
-<div class="section" id="parsing-text-values">
-<h3>3.9.4. Parsing text values<a class="headerlink" href="#parsing-text-values" title="Permalink to this headline">¶</a></h3>
-<p>Your program may need to request values from the user, such as
-distances, plot dimensions, coordinates, and other data. The conversion
-from such text to actual distances, taking units into account, is
-tedious to program. You can simplify this by using</p>
-<blockquote id="gmt-get-value">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="nf">GMT_Get_Value</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">char</span> <span class="o">*</span><span class="n">arg</span><span class="p">,</span> <span class="kt">double</span> <span class="n">par</span><span class="p">[]);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>where <tt class="docutils literal"><span class="pre">arg</span></tt> is the text item with one or more values that are
-separated by commas, spaces, tabs, semi-colons, or slashes, and <tt class="docutils literal"><span class="pre">par</span></tt> is an array long
-enough to hold all the items you are parsing. The function returns the
-number of items parsed, or -1 if there is an error. For instance, assume
-the character string <tt class="docutils literal"><span class="pre">origin</span></tt> was given by the user as two geographic
-coordinates separated by a slash (e.g., <tt class="docutils literal"><span class="pre">"35:45W/19:30:55.3S"</span></tt>). We
-obtain the two coordinates as decimal degrees by calling</p>
-<blockquote>
-<div><div class="highlight-c"><div class="highlight"><pre><span class="n">n</span> <span class="o">=</span> <span class="n">GMT_Get_Value</span> <span class="p">(</span><span class="n">API</span><span class="p">,</span> <span class="n">origin</span><span class="p">,</span> <span class="n">pair</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>Your program can now check that <tt class="docutils literal"><span class="pre">n</span></tt> equals 2 and then use the values
-in <tt class="docutils literal"><span class="pre">pairs</span></tt>. Note: Dimensions given with units of inches, cm, or points
-are converted to the GMT default length unit (<a class="reference internal" href="gmt.conf.html#proj-length-unit"><em>PROJ_LENGTH_UNIT</em></a>)
-[cm], while distances given in km, nautical miles, miles, feet, or
-survey feet are returned in meters. Arc lengths in minutes and seconds
-are returned in decimal degrees, and date/time values are returned in
-seconds since the epoch (1970).</p>
-</div>
-<div class="section" id="inquiring-about-a-gmt-default-parameter">
-<h3>3.9.5. Inquiring about a GMT default parameter<a class="headerlink" href="#inquiring-about-a-gmt-default-parameter" title="Permalink to this headline">¶</a></h3>
-<p>If your program needs to determine one or more of the current
-GMT default settings you can do so via</p>
-<blockquote id="gmt-get-default">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="nf">GMT_Get_Default</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">char</span> <span class="o">*</span><span class="n">keyword</span><span class="p">,</span> <span class="kt">char</span> <span class="o">*</span><span class="n">value</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>where <tt class="docutils literal"><span class="pre">keyword</span></tt> is one such keyword (e.g., <a class="reference internal" href="gmt.conf.html#proj-length-unit"><em>PROJ_LENGTH_UNIT</em></a>) and
-<tt class="docutils literal"><span class="pre">value</span></tt> must be a character array long enough to hold the answer.
-Depending on what parameter you selected you could further convert it to
-a numerical value with <tt class="docutils literal"><span class="pre">GMT_Get_Value</span></tt> or just use it in a text comparison.</p>
-</div>
-</div>
-<div class="section" id="prepare-module-options">
-<span id="sec-func"></span><h2>3.10. Prepare module options<a class="headerlink" href="#prepare-module-options" title="Permalink to this headline">¶</a></h2>
-<p>One of the advantages of programming with the API is that you
-have access to the high-level GMT modules. For example, if your
-program must compute the distance from a point to all other points on
-the node you can simply set up options and call <tt class="docutils literal"><span class="pre">GMT_grdmath</span></tt> to do it
-for you and accept the result back as an input grid. All the module
-interfaces are identical are looks like</p>
-<blockquote id="gmt-call-module">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="nf">GMT_Call_Module</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="k">const</span> <span class="kt">char</span> <span class="o">*</span><span class="n">module</span><span class="p">,</span> <span class="kt">int</span> <span class="n">mode</span><span class="p">,</span> <span class="kt">void< [...]
-</pre></div>
-</div>
-</div></blockquote>
-<p>Here, <tt class="docutils literal"><span class="pre">module</span></tt> can be any of the GMT modules, such as
-<tt class="docutils literal"><span class="pre">psxy</span></tt> or <tt class="docutils literal"><span class="pre">grdvolume</span></tt>. All GMT modules may be called with one of
-three sets of <tt class="docutils literal"><span class="pre">args</span></tt> depending on <tt class="docutils literal"><span class="pre">mode</span></tt>. The three modes differ in
-how the options are passed to the module:</p>
-<blockquote>
-<div><dl class="docutils">
-<dt><em>mode</em> == <tt class="docutils literal"><span class="pre">GMT_MODULE_EXIST</span></tt></dt>
-<dd>Return GMT_NOERROR (0) if module exists, GMT_NOT_A_VALID_MODULE otherwise.</dd>
-<dt><em>mode</em> == <tt class="docutils literal"><span class="pre">GMT_MODULE_PURPOSE</span></tt></dt>
-<dd>Just prints the purpose of the module; args should be NULL.</dd>
-<dt><em>mode</em> == <tt class="docutils literal"><span class="pre">GMT_MODULE_OPT</span></tt></dt>
-<dd>Expects <tt class="docutils literal"><span class="pre">args</span></tt> to be a pointer to a doubly-linked list of objects with individual
-options for the current program. We will see
-how API functions can help prepare such lists.</dd>
-<dt><em>mode</em> == <tt class="docutils literal"><span class="pre">GMT_MODULE_CMD</span></tt></dt>
-<dd>Expects <tt class="docutils literal"><span class="pre">args</span></tt> to be a single text string with all required options.</dd>
-<dt><em>mode > 0</em></dt>
-<dd>Expects <tt class="docutils literal"><span class="pre">args</span></tt> to be an array of text options and <tt class="docutils literal"><span class="pre">mode</span></tt> to be a count of how many
-options are passed (i.e., the <tt class="docutils literal"><span class="pre">argc,</span> <span class="pre">argv[]</span></tt> model used by the GMT programs themselves).</dd>
-</dl>
-</div></blockquote>
-<p>If <tt class="docutils literal"><span class="pre">module</span></tt> equals NULL and <tt class="docutils literal"><span class="pre">mode</span> <span class="pre">==</span> <span class="pre">GMT_MODULE_PURPOSE</span></tt> then we list summaries for all the modules
-If no module by the given name is found we return -1.</p>
-<div class="section" id="set-program-options-via-text-array-arguments">
-<h3>3.10.1. Set program options via text array arguments<a class="headerlink" href="#set-program-options-via-text-array-arguments" title="Permalink to this headline">¶</a></h3>
-<p>When <tt class="docutils literal"><span class="pre">mode</span> <span class="pre">></span> <span class="pre">0</span></tt> we expect an array <tt class="docutils literal"><span class="pre">args</span></tt> of character
-strings that each holds a single command line options (e.g.,
-“-R120:30/134:45/8S/3N”) and interpret <tt class="docutils literal"><span class="pre">mode</span></tt> to be the count of how
-many options are passed. This, of course, is almost exactly how the
-stand-alone GMT programs are called (and reflects how they themselves
-are activated internally). We call this the “argc-argv” mode. Depending
-on how your program obtains the necessary options you may find that this
-interface offers all you need.</p>
-</div>
-<div class="section" id="set-program-options-via-text-command">
-<h3>3.10.2. Set program options via text command<a class="headerlink" href="#set-program-options-via-text-command" title="Permalink to this headline">¶</a></h3>
-<p>If <tt class="docutils literal"><span class="pre">mode</span> <span class="pre">==</span></tt> 0 then <tt class="docutils literal"><span class="pre">args</span></tt> will be examined to see if it contains
-several options within a single command string. If so we will break
-these into separate options. This is useful if you wish to pass a single
-string such as “-R120:30/134:45/8S/3N -JM6i mydata.txt -Sc0.2c”. We call
-this the “command” mode.</p>
-</div>
-<div class="section" id="set-program-options-via-linked-structures">
-<h3>3.10.3. Set program options via linked structures<a class="headerlink" href="#set-program-options-via-linked-structures" title="Permalink to this headline">¶</a></h3>
-<p>The third, linked-list interface allows developers using higher-level
-programming languages to pass all command options via a pointer to a
-NULL-terminated, doubly-linked list of option structures, each
-containing information about a single option. Here, instead of text
-arguments we pass the pointer to the linked list of options mentioned
-above, and <tt class="docutils literal"><span class="pre">mode</span></tt> must be passed as -1 (or any negative value). Using
-this interface can be more involved since you need to generate the
-linked list of program options; however, utility functions exist to
-simplify its use. This interface is intended for programs whose internal
-workings are better suited to generate such arguments – we call this the
-“options” mode. The order in the list is not important as GMT will
-sort it internally according to need. The option structure is defined below.</p>
-<blockquote id="options">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="k">struct</span> <span class="n">GMT_OPTION</span> <span class="p">{</span>
- <span class="kt">char</span> <span class="n">option</span><span class="p">;</span> <span class="cm">/* Single character of the option (e.g., 'G' for -G) */</span>
- <span class="kt">char</span> <span class="o">*</span><span class="n">arg</span><span class="p">;</span> <span class="cm">/* String pointer with arguments (NULL if not used) */</span>
- <span class="k">struct</span> <span class="n">GMT_OPTION</span> <span class="o">*</span><span class="n">next</span><span class="p">;</span> <span class="cm">/* Pointer to next option (NULL for last option) */</span>
- <span class="k">struct</span> <span class="n">GMT_OPTION</span> <span class="o">*</span><span class="n">prev</span><span class="p">;</span> <span class="cm">/* Pointer to previous option (NULL for first option) */</span>
-<span class="p">};</span>
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="convert-between-text-and-linked-structures">
-<h3>3.10.4. Convert between text and linked structures<a class="headerlink" href="#convert-between-text-and-linked-structures" title="Permalink to this headline">¶</a></h3>
-<p>To assist programmers there are also two convenience functions that
-allow you to convert between the two argument formats. They are</p>
-<blockquote id="gmt-create-options">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="k">struct</span> <span class="n">GMT_OPTION</span> <span class="o">*</span><span class="nf">GMT_Create_Options</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">int</span> <span class="n">argc</span><span class="p">,</span> <span class="kt">void</span> <span class="o">*</span><span class="n">args</span><span class="p" [...]
-</pre></div>
-</div>
-</div></blockquote>
-<p>This function accepts your array of text arguments (cast via a void
-pointer), allocates the necessary space, performs the conversion, and
-returns a pointer to the head of the linked list of program options.
-However, in case of an error we return a NULL pointer and set
-<tt class="docutils literal"><span class="pre">API->error</span></tt> to indicate the nature of the problem. Otherwise, the
-pointer may now be passed to the relevant <tt class="docutils literal"><span class="pre">GMT_module</span></tt>. Note that if
-your list of text arguments were obtained from a C <tt class="docutils literal"><span class="pre">main()</span></tt> function
-then <tt class="docutils literal"><span class="pre">argv[0]</span></tt> will contain the name of the calling program. To avoid
-passing this as a file name option, call <a class="reference internal" href="#gmt-create-options">GMT_Create_Options</a> with
-<tt class="docutils literal"><span class="pre">argc-1</span></tt> and <tt class="docutils literal"><span class="pre">argv+1</span></tt>. If you wish to pass a single text string with
-multiple options (in lieu of an array of text strings), then pass
-<tt class="docutils literal"><span class="pre">argc</span></tt> = 0. When no longer needed you can remove the entire list by calling</p>
-<blockquote id="gmt-destroy-options">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="nf">GMT_Destroy_Options</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="k">struct</span> <span class="n">GMT_OPTION</span> <span class="o">**</span><span class="n">list</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>The function returns 1 if there is an error (which is passed back
-with <tt class="docutils literal"><span class="pre">API->error</span></tt>), otherwise it returns 0.</p>
-<p>The inverse function prototype is</p>
-<blockquote id="gmt-create-args">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">char</span> <span class="o">**</span><span class="nf">GMT_Create_Args</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">int</span> <span class="o">*</span><span class="n">argc</span><span class="p">,</span> <span class="k">struct</span> <span class="n">GMT_OPTION</span> <span class="o">*</span><span class="n">list [...]
-</pre></div>
-</div>
-</div></blockquote>
-<p>which allocates space for the text strings and performs the conversion;
-it passes back the count of the arguments via <tt class="docutils literal"><span class="pre">argc</span></tt> and returns a
-pointer to the text array. In the case of an error we return a NULL
-pointer and set <tt class="docutils literal"><span class="pre">API->error</span></tt> to reflect the error type. Note that
-<tt class="docutils literal"><span class="pre">argv[0]</span></tt> will not contain the name of the program as is the case the
-arguments presented by a C <tt class="docutils literal"><span class="pre">main()</span></tt> function. When you no longer have
-any use for the text array, call</p>
-<blockquote id="gmt-destroy-args">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="nf">GMT_Destroy_Args</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">int</span> <span class="n">argc</span><span class="p">,</span> <span class="kt">char</span> <span class="o">**</span><span class="n">argv</span><span class="p">[]);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>to deallocate the space used. This function returns 1 if there is
-an error (which is passed back with <tt class="docutils literal"><span class="pre">API->error</span></tt>), otherwise it returns 0.</p>
-<p>Finally, to convert the linked list of option structures to a single
-text string command, use</p>
-<blockquote id="gmt-create-cmd">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">char</span> <span class="o">*</span><span class="nf">GMT_Create_Cmd</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="k">struct</span> <span class="n">GMT_OPTION</span> <span class="o">*</span><span class="n">list</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>Developers who plan to import and export GMT shell scripts might find
-it convenient to use these functions. In case of an error we return a
-NULL pointer and set <tt class="docutils literal"><span class="pre">API->error</span></tt>, otherwise a pointer to an allocated
-string is returned. When you no longer have
-any use for the text string, call</p>
-<blockquote id="gmt-destroy-cmd">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="nf">GMT_Destroy_Cmd</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">char</span> <span class="o">**</span><span class="n">argv</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>to deallocate the space used. This function returns 1 if there is
-an error (which is passed back with <tt class="docutils literal"><span class="pre">API->error</span></tt>), otherwise it
-returns 0.</p>
-</div>
-<div class="section" id="manage-the-linked-list-of-options">
-<h3>3.10.5. Manage the linked list of options<a class="headerlink" href="#manage-the-linked-list-of-options" title="Permalink to this headline">¶</a></h3>
-<p>Several additional utility functions are available for programmers who
-wish to manipulate program option structures within their own programs.
-These allow you to create new option structures, append them to the
-linked list, replace existing options with new values, find a particular
-option, and remove options from the list. Note: The order in which the
-options appear in the linked list is of no consequence to GMT.
-Internally, GMT will sort and process the options in the manner
-required. Externally, you are free to maintain your own order.</p>
-<div class="section" id="make-a-new-option-structure">
-<h4>3.10.5.1. Make a new option structure<a class="headerlink" href="#make-a-new-option-structure" title="Permalink to this headline">¶</a></h4>
-<p><tt class="docutils literal"><span class="pre">GMT_Make_Option</span></tt> will allocate a new option structure, assign it
-values given the <tt class="docutils literal"><span class="pre">option</span></tt> and <tt class="docutils literal"><span class="pre">arg</span></tt> parameter (pass NULL if there is
-no argument for this option), and returns a pointer to the allocated
-structure. The prototype is</p>
-<blockquote id="gmt-make-option">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="k">struct</span> <span class="n">GMT_OPTION</span> <span class="o">*</span><span class="nf">GMT_Make_Option</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">char</span> <span class="n">option</span><span class="p">,</span> <span class="kt">char</span> <span class="o">*</span><span class="n">arg</span><span class="p"> [...]
-</pre></div>
-</div>
-</div></blockquote>
-<p>Should memory allocation fail the function will print an error message
-set an error code via <tt class="docutils literal"><span class="pre">API->error</span></tt>, and return NULL.</p>
-</div>
-<div class="section" id="append-an-option-to-the-linked-list">
-<h4>3.10.5.2. Append an option to the linked list<a class="headerlink" href="#append-an-option-to-the-linked-list" title="Permalink to this headline">¶</a></h4>
-<p><tt class="docutils literal"><span class="pre">GMT_Append_Option</span></tt> will append the specified <tt class="docutils literal"><span class="pre">option</span></tt> to the end of
-the doubly-linked <tt class="docutils literal"><span class="pre">list</span></tt>. The prototype is</p>
-<blockquote id="gmt-append-option">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="k">struct</span> <span class="n">GMT_OPTION</span> <span class="o">*</span><span class="nf">GMT_Append_Option</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="k">struct</span> <span class="n">GMT_OPTION</span> <span class="o">*</span><span class="n">option</span><span class="p">,</span>
- <span class="k">struct</span> <span class="n">GMT_OPTION</span> <span class="o">*</span><span class="n">list</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>We return the list back, and if <tt class="docutils literal"><span class="pre">list</span></tt> is given as NULL we return
-<tt class="docutils literal"><span class="pre">option</span></tt> as the start of the new list. Any errors results in a NULL
-pointer with <tt class="docutils literal"><span class="pre">API->error</span></tt> holding the error type.</p>
-</div>
-<div class="section" id="find-an-option-in-the-linked-list">
-<h4>3.10.5.3. Find an option in the linked list<a class="headerlink" href="#find-an-option-in-the-linked-list" title="Permalink to this headline">¶</a></h4>
-<p><tt class="docutils literal"><span class="pre">GMT_Find_Option</span></tt> will return a pointer <tt class="docutils literal"><span class="pre">ptr</span></tt> to the first option in
-the linked list starting at <tt class="docutils literal"><span class="pre">list</span></tt> whose option character equals
-<tt class="docutils literal"><span class="pre">option</span></tt>. If not found we return NULL. While this is not necessarily
-an error we still set <tt class="docutils literal"><span class="pre">API->error</span></tt> accordingly. The prototype is</p>
-<blockquote id="gmt-find-option">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="k">struct</span> <span class="n">GMT_OPTION</span> <span class="o">*</span><span class="nf">GMT_Find_Option</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">char</span> <span class="n">option</span><span class="p">,</span>
- <span class="k">struct</span> <span class="n">GMT_OPTION</span> <span class="o">*</span><span class="n">list</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>If you need to look for multiple occurrences of a certain option you
-will need to call <a class="reference internal" href="#gmt-find-option">GMT_Find_Option</a> again, passing the option
-following the previously found option as the <tt class="docutils literal"><span class="pre">list</span></tt> entry, i.e.,</p>
-<blockquote>
-<div><div class="highlight-c"><div class="highlight"><pre><span class="n">list</span> <span class="o">=</span> <span class="o">*</span><span class="n">ptr</span><span class="o">-></span><span class="n">next</span><span class="p">;</span>
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="update-an-existing-option-in-the-list">
-<h4>3.10.5.4. Update an existing option in the list<a class="headerlink" href="#update-an-existing-option-in-the-list" title="Permalink to this headline">¶</a></h4>
-<p><a class="reference internal" href="#gmt-update-option">GMT_Update_Option</a> will replace the argument of <tt class="docutils literal"><span class="pre">current</span></tt> with the
-new argument <tt class="docutils literal"><span class="pre">arg</span></tt> and otherwise leave the option at its place in the
-list. The prototype is</p>
-<blockquote id="gmt-update-option">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="nf">GMT_Update_Option</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="k">struct</span> <span class="n">GMT_OPTION</span> <span class="o">*</span><span class="n">current</span><span class="p">,</span> <span class="kt">char</span> <span class="o">*</span><span class="n">arg</span><span class="p [...]
-</pre></div>
-</div>
-</div></blockquote>
-<p>An error will be reported if (a) <tt class="docutils literal"><span class="pre">current</span></tt> is NULL or (b) <tt class="docutils literal"><span class="pre">arg</span></tt> is
-NULL. The function returns 1 if there is an error, otherwise it returns 0.</p>
-</div>
-<div class="section" id="delete-an-existing-option-in-the-linked-list">
-<h4>3.10.5.5. Delete an existing option in the linked list<a class="headerlink" href="#delete-an-existing-option-in-the-linked-list" title="Permalink to this headline">¶</a></h4>
-<p>You may use <tt class="docutils literal"><span class="pre">GMT_Delete_Option</span></tt> to remove <tt class="docutils literal"><span class="pre">option</span></tt> from the linked
-<tt class="docutils literal"><span class="pre">list</span></tt>. The prototype is</p>
-<blockquote id="gmt-delete-option">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="nf">GMT_Delete_Option</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="k">struct</span> <span class="n">GMT_OPTION</span> <span class="o">*</span><span class="n">current</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>We return TRUE if the option is not found in the list and set
-<tt class="docutils literal"><span class="pre">API->error</span></tt> accordingly. Note: Only the first occurrence of the
-specified option will be deleted. If you need to delete all such options
-you will need to call this function in a loop until it returns a
-non-zero status.</p>
-</div>
-<div class="section" id="specify-a-file-via-an-linked-option">
-<h4>3.10.5.6. Specify a file via an linked option<a class="headerlink" href="#specify-a-file-via-an-linked-option" title="Permalink to this headline">¶</a></h4>
-<p>To specify an input file name via an option, simply use < as the
-option (this is what <a class="reference internal" href="#gmt-create-options">GMT_Create_Options</a> does when it finds filenames
-on the command line). Likewise, > can be used to explicitly
-indicate an output file. In order to append to an existing file, use
->>. For example the following command would read from file.A and
-append to file.B:</p>
-<blockquote>
-<div><div class="highlight-c"><div class="highlight"><pre><span class="n">gmtconvert</span> <span class="o">-<</span><span class="n">file</span><span class="p">.</span><span class="n">A</span> <span class="o">->></span><span class="n">file</span><span class="p">.</span><span class="n">B</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>These options also work on the command line but usually one would have
-to escape the special characters < and > as they are
-used for file redirection.</p>
-</div>
-</div>
-</div>
-<div class="section" id="calling-a-gmt-module">
-<h2>3.11. Calling a GMT module<a class="headerlink" href="#calling-a-gmt-module" title="Permalink to this headline">¶</a></h2>
-<p>Given your linked list of program options (or text array) and possibly
-some registered resources, you can now call the required GMT module
-using one of the two flavors discussed in <a class="reference internal" href="#sec-func"><em>section</em></a> All
-modules return an error or status code that your program should consider
-before processing the results.</p>
-</div>
-<div class="section" id="adjusting-headers-and-comments">
-<h2>3.12. Adjusting headers and comments<a class="headerlink" href="#adjusting-headers-and-comments" title="Permalink to this headline">¶</a></h2>
-<p>All header records in incoming datasets are stored in memory. You may
-wish to replace these records with new information, or append new
-information to the existing headers. This is achieved with</p>
-<blockquote id="gmt-set-comment">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="n">GMT_Set_Comment</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">family</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">mode</span>
- <span class="kt">void</span> <span class="o">*</span><span class="n">arg</span><span class="p">,</span> <span class="kt">void</span> <span class="o">*</span><span class="n">data</span><span class="p">)</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>Again, <a class="reference internal" href="#tbl-family"><em>family</em></a> selects which kind of resource is passed via <tt class="docutils literal"><span class="pre">data</span></tt>.
-The <tt class="docutils literal"><span class="pre">mode</span></tt> determines what kind of comment is being considered, how it
-should be included, and in what form the comment passed via <tt class="docutils literal"><span class="pre">arg</span></tt> is.
-Table <a class="reference internal" href="#tbl-comments"><em>comments</em></a> lists the available options, which may be combined
-by adding (bitwise “or”). The <tt class="docutils literal"><span class="pre">GMT_Set_Comment</span></tt> does not actually
-output anything but sets the relevant comment and header records in the
-relevant structure. When a file is written out the information will be
-output as well (Note: Users can always decide if they wish to turn
-header output on or off via the common GMT option <tt class="docutils literal"><span class="pre">-h</span></tt>. For
-record-by-record writing you must enable the header block output when
-you call <a class="reference internal" href="#gmt-begin-io">GMT_Begin_IO</a></p>
-<table border="1" class="docutils" id="tbl-comments">
-<colgroup>
-<col width="33%" />
-<col width="67%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head">constant</th>
-<th class="head">description</th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>GMT_COMMENT_IS_TEXT</td>
-<td>Comment is a text string</td>
-</tr>
-<tr class="row-odd"><td>GMT_COMMENT_IS_OPTION</td>
-<td>Comment is a linked list of GMT_OPTION structures</td>
-</tr>
-<tr class="row-even"><td>GMT_COMMENT_IS_COMMAND</td>
-<td>Comment is the command</td>
-</tr>
-<tr class="row-odd"><td>GMT_COMMENT_IS_REMARK</td>
-<td>Comment is the remark</td>
-</tr>
-<tr class="row-even"><td>GMT_COMMENT_IS_TITLE</td>
-<td>Comment is the title</td>
-</tr>
-<tr class="row-odd"><td>GMT_COMMENT_IS_NAME_X</td>
-<td>Comment is the x variable name (grids only)</td>
-</tr>
-<tr class="row-even"><td>GMT_COMMENT_IS_NAME_Y</td>
-<td>Comment is the y variable name (grids only)</td>
-</tr>
-<tr class="row-odd"><td>GMT_COMMENT_IS_NAME_Z</td>
-<td>Comment is the z variable name (grids only)</td>
-</tr>
-<tr class="row-even"><td>GMT_COMMENT_IS_COLNAMES</td>
-<td>Comment is the column names header</td>
-</tr>
-<tr class="row-odd"><td>GMT_COMMENT_IS_RESET</td>
-<td>Comment replaces existing information</td>
-</tr>
-</tbody>
-</table>
-<p>The named modes (<em>command</em>, <em>remark</em>, <em>title</em>, <em>name_x,y,z</em> and
-<em>colnames</em> are used to distinguish regular text comments from specific
-fields in the header structures of the data resources, such as
-<tt class="docutils literal"><span class="pre">GMT_GRID</span></tt>. For the various table resources (e.g., <tt class="docutils literal"><span class="pre">GMT_DATASET</span></tt>)
-these modifiers result in a specially formatted comments beginning with
-“Command: ” or “Remark: ”, reflecting how this type of information is
-encoded in the headers.</p>
-</div>
-<div class="section" id="exporting-data">
-<h2>3.13. Exporting Data<a class="headerlink" href="#exporting-data" title="Permalink to this headline">¶</a></h2>
-<p>If your program needs to write any of the four recognized data types
-(CPT files, data tables, text tables, or GMT grids) you can use the
-<a class="reference internal" href="#gmt-put-data">GMT_Put_Data</a>. In the case of data and text tables, you may also
-consider the <a class="reference internal" href="#gmt-put-record">GMT_Put_Record</a> function. As a general rule, your
-program organization may simplify if you can write and export the entire
-resource with <a class="reference internal" href="#gmt-put-data">GMT_Put_Data</a>. However, if the program logic is simple
-or already involves using <a class="reference internal" href="#gmt-get-record">GMT_Get_Record</a>, it may be better to export
-one data record at the time via <a class="reference internal" href="#gmt-put-record">GMT_Put_Record</a>.</p>
-<p>Both of these output functions takes a parameter called <tt class="docutils literal"><span class="pre">mode</span></tt>. The
-<tt class="docutils literal"><span class="pre">mode</span></tt> parameter generally takes on different meanings for the
-different data types and will be discussed below. However, one bit
-setting is common to all types: By default, you are only allowed to
-write a data resource once; the resource is then flagged to have been
-written and subsequent attempts to write to the same resource will
-quietly be ignored. In the unlikely event you need to re-write a
-resource you can override this default behavior by adding <tt class="docutils literal"><span class="pre">GMT_IO_RESET</span></tt>
-to your <tt class="docutils literal"><span class="pre">mode</span></tt> parameter.</p>
-<div class="section" id="enable-data-export">
-<h3>3.13.1. Enable Data Export<a class="headerlink" href="#enable-data-export" title="Permalink to this headline">¶</a></h3>
-<p>Similar to the data import procedures, once all output destinations have
-been registered, we signal the API that we are done with the
-registration phase and are ready to start the actual data export. As for
-input, this step is only needed when dealing with record-by-record
-writing. Again, we enable record-by-record writing by calling
-<a class="reference internal" href="#gmt-begin-io">GMT_Begin_IO</a>, this time with <tt class="docutils literal"><span class="pre">direction</span></tt> = <tt class="docutils literal"><span class="pre">GMT_OUT</span></tt>. This function
-enables data export and prepares the registered destinations for the
-upcoming writing.</p>
-</div>
-<div class="section" id="exporting-a-data-set">
-<h3>3.13.2. Exporting a data set<a class="headerlink" href="#exporting-a-data-set" title="Permalink to this headline">¶</a></h3>
-<p>To have your program accept results from GMT modules and write them
-separately requires you to use the <a class="reference internal" href="#gmt-write-data">GMT_Write_Data</a> or
-<a class="reference internal" href="#gmt-put-data">GMT_Put_Data</a> functions. They are very similar to the
-<a class="reference internal" href="#gmt-read-data">GMT_Read_Data</a> and <a class="reference internal" href="#gmt-get-data">GMT_Get_Data</a> functions encountered earlier.</p>
-<div class="section" id="exporting-a-data-set-to-a-file-stream-or-handle">
-<h4>3.13.2.1. Exporting a data set to a file, stream, or handle<a class="headerlink" href="#exporting-a-data-set-to-a-file-stream-or-handle" title="Permalink to this headline">¶</a></h4>
-<p>The prototype for writing to a file (via name, stream, or file handle) is</p>
-<blockquote id="gmt-write-data">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="nf">GMT_Write_Data</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">family</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">method</span><span class="p">,</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">geometry</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">mode</span><span class="p">,</span>
- <span class="kt">double</span> <span class="n">wesn</span><span class="p">[],</span> <span class="kt">void</span> <span class="o">*</span><span class="n">output</span><span class="p">,</span> <span class="kt">void</span> <span class="o">*</span><span class="n">data</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<ul class="simple">
-<li><a class="reference internal" href="#gmt-create-session"><em>API</em></a></li>
-<li><a class="reference internal" href="#tbl-family"><em>family</em></a></li>
-<li><a class="reference internal" href="#tbl-methods"><em>method</em></a></li>
-<li><a class="reference internal" href="#tbl-geometry"><em>geometry</em></a></li>
-<li>mode – specific to each data type (<em>see below</em>)</li>
-<li><a class="reference internal" href="#tbl-wesn"><em>wesn</em></a></li>
-<li>output –</li>
-<li>data – A pointer to any of the four structures <a class="reference internal" href="#struct-vector"><em>GMT_VECTOR</em></a>,
-<a class="reference internal" href="#struct-matrix"><em>GMT_MATRIX</em></a>, <a class="reference internal" href="#struct-grid"><em>GMT_GRID</em></a>, <a class="reference internal" href="#struct-palette"><em>GMT_PALETTE</em></a></li>
-<li>Return: 0 on success, otherwise return -1 and set API->error to reflect to cause.</li>
-</ul>
-<p>where <tt class="docutils literal"><span class="pre">data</span></tt> is a pointer to any of the four structures discussed previously.</p>
-<dl class="docutils">
-<dt><strong>CPT table</strong></dt>
-<dd><tt class="docutils literal"><span class="pre">mode</span></tt> controls if the CPT table’s back-, fore-, and NaN-colors
-should be written (1) or not (0).</dd>
-<dt><strong>Data table</strong></dt>
-<dd><p class="first">If <tt class="docutils literal"><span class="pre">method</span></tt> is <tt class="docutils literal"><span class="pre">GMT_IS_FILE</span></tt>, then the value of <tt class="docutils literal"><span class="pre">mode</span></tt> affects
-how the data set is written:</p>
-<dl class="last docutils">
-<dt><strong>GMT_WRITE_SET</strong></dt>
-<dd>The entire data set will be written to the single file [0].</dd>
-<dt><strong>GMT_WRITE_TABLE</strong></dt>
-<dd>Each table in the data set is written to individual files [1].
-You can either specify an output file name that <em>must</em> contain
-one C-style format specifier for a int variable (e.g.,
-“New_Table_%06d.txt”), which will be replaced with the table
-number (a running number from 0) <em>or</em> you must assign to each
-table <em>i</em> a unique output file name via the
-<tt class="docutils literal"><span class="pre">D->table[i]->file[GMT_OUT]</span></tt> variables prior to calling the
-function.</dd>
-<dt><strong>GMT_WRITE_SEGMENT</strong></dt>
-<dd>Each segment in the data set is written to an individual file
-[2]. Same setup as for <tt class="docutils literal"><span class="pre">GMT_WRITE_TABLE</span></tt> except we use
-sequential segment numbers to build the file names.</dd>
-<dt><strong>GMT_WRITE_TABLE_SEGMENT</strong></dt>
-<dd>Each segment in the data set is written to an individual file
-[3]. You can either specify an output file name that <em>must</em>
-contain two C-style format specifiers for two int variables
-(e.g., “New_Table_%06d_Segment_%03d.txt”), which will be
-replaced with the table and segment numbers, <em>or</em> you must
-assign to each segment <em>j</em> in each table <em>i</em> a unique output
-file name via the <tt class="docutils literal"><span class="pre">D->table[i]->segment[j]->file[GMT_OUT]</span></tt>
-variables prior to calling the function.</dd>
-<dt><strong>GMT_WRITE_OGR</strong></dt>
-<dd>Writes the dataset in OGR/GMT format in conjunction with the
-<tt class="docutils literal"><span class="pre">-a</span></tt> setting [4].</dd>
-</dl>
-</dd>
-<dt><strong>Text table</strong></dt>
-<dd>The <tt class="docutils literal"><span class="pre">mode</span></tt> is used the same way as for data tables.</dd>
-<dt><strong>GMT grid</strong></dt>
-<dd>Here, <tt class="docutils literal"><span class="pre">mode</span></tt> may be <tt class="docutils literal"><span class="pre">GMT_GRID_HEADER_ONLY</span></tt> to only update a
-file’s header structure, but normally it is simply <tt class="docutils literal"><span class="pre">GMT_GRID_ALL</span></tt>
-so the entire grid and its header will be exported (a subset is
-not allowed during export). However, in the event your data array
-holds both the real and imaginary parts of a complex data set you
-must add either <tt class="docutils literal"><span class="pre">GMT_GRID_IS_COMPLEX_REAL</span></tt> or
-<tt class="docutils literal"><span class="pre">GMT_GRID_IS_COMPLEX_IMAG</span></tt> to <tt class="docutils literal"><span class="pre">mode</span></tt> so as to export the
-corresponding grid values correctly. Finally, for native binary
-grids you may skip writing the grid header by adding
-<tt class="docutils literal"><span class="pre">GMT_GRID_NO_HEADER</span></tt>; this setting is ignored for other grid
-formats. If your output grid is huge and you are building it
-row-by-row, set <tt class="docutils literal"><span class="pre">mode</span></tt> to <tt class="docutils literal"><span class="pre">GMT_GRID_HEADER_ONLY</span></tt> |
-<tt class="docutils literal"><span class="pre">GMT_GRID_ROW_BY_ROW</span></tt>. You can then write the grid row-by-row
-using <a class="reference internal" href="#gmt-put-row">GMT_Put_Row</a>. By default the rows will be automatically
-processed in order. To completely specify which row to be written,
-use <tt class="docutils literal"><span class="pre">GMT_GRID_ROW_BY_ROW_MANUAL</span></tt> instead.</dd>
-</dl>
-<p>Note: If <tt class="docutils literal"><span class="pre">method</span></tt> is GMT_IS_FILE, <a class="reference internal" href="#tbl-family"><em>family</em></a> is <tt class="docutils literal"><span class="pre">GMT_IS_GRID</span></tt>,
-and the filename implies a change from NaN to another value then the grid is
-modified accordingly. If you continue to use that grid after writing please be
-aware that the changes you specified were applied to the grid.</p>
-</div>
-<div class="section" id="exporting-a-data-set-to-memory">
-<h4>3.13.2.2. Exporting a data set to memory<a class="headerlink" href="#exporting-a-data-set-to-memory" title="Permalink to this headline">¶</a></h4>
-<p>If writing to a memory destination you will want to first register that
-destination and then use the returned ID with <tt class="docutils literal"><span class="pre">GMT_Put_Data</span></tt> instead:</p>
-<blockquote id="gmt-put-data">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="nf">GMT_Put_Data</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">int</span> <span class="n">ID</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">mode</span><span class="p">,</span> <span class="kt">void</span> <span class="o">*</sp [...]
-</pre></div>
-</div>
-</div></blockquote>
-<p>where <tt class="docutils literal"><span class="pre">ID</span></tt> is the unique ID of the registered destination, <tt class="docutils literal"><span class="pre">mode</span></tt> is
-specific to each data type (and controls aspects of the output
-structuring), and <tt class="docutils literal"><span class="pre">data</span></tt> is a pointer to any of the four structures
-discussed previously. For more detail, see <a class="reference internal" href="#gmt-write-data">GMT_Write_Data</a> above. If
-successful the function returns 0; otherwise we return 1
-and set <tt class="docutils literal"><span class="pre">API->error</span></tt> to reflect to cause.</p>
-</div>
-</div>
-<div class="section" id="exporting-a-data-record">
-<h3>3.13.3. Exporting a data record<a class="headerlink" href="#exporting-a-data-record" title="Permalink to this headline">¶</a></h3>
-<p>If your program must write data table records one-by-one you must first
-enable record-by-record writing with <a class="reference internal" href="#gmt-begin-io">GMT_Begin_IO</a> and then use the
-<tt class="docutils literal"><span class="pre">GMT_Put_Record</span></tt> function in a loop; the prototype is</p>
-<blockquote id="gmt-put-record">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="nf">GMT_Put_Record</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">mode</span><span class="p">,</span> <span class="kt">void</span> <span class="o">*</span><span class="n">rec</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>where <tt class="docutils literal"><span class="pre">rec</span></tt> is a pointer to either (a) a double-precision array with
-the current row. Then, <tt class="docutils literal"><span class="pre">rec</span></tt> is expected to hold at least as many
-items as the current setting of <tt class="docutils literal"><span class="pre">n_col[GMT_OUT]</span></tt>, which represents the
-number of columns in the output destination. Alternatively (b), <tt class="docutils literal"><span class="pre">rec</span></tt>
-points to a text string. The <tt class="docutils literal"><span class="pre">mode</span></tt> parameter must be set to reflect
-what is passed. Using <a class="reference internal" href="#gmt-put-record">GMT_Put_Record</a> requires you to first
-initialize the destination with <a class="reference internal" href="#gmt-init-io">GMT_Init_IO</a>. Note that for families
-GMT_IS_DATASET and <tt class="docutils literal"><span class="pre">GMT_IS_TEXTSET</span></tt> the methods <tt class="docutils literal"><span class="pre">GMT_IS_DUPLICATE</span></tt> and
-GMT_IS_REFERENCE are not supported since you can simply populate the
-GMT_DATASET structure directly. As mentioned, <tt class="docutils literal"><span class="pre">mode</span></tt> affects what is
-actually written:</p>
-<dl class="docutils">
-<dt><strong>GMT_WRITE_DOUBLE</strong></dt>
-<dd>Normal operation that builds the current output record from the values in <tt class="docutils literal"><span class="pre">rec</span></tt>.</dd>
-<dt><strong>GMT_WRITE_TEXT</strong></dt>
-<dd>For ASCII output mode we write the text string <tt class="docutils literal"><span class="pre">rec</span></tt>. If <tt class="docutils literal"><span class="pre">rec</span></tt>
-is NULL then we use the current (last imported) text record. If
-binary output mode we quietly skip writing this record.</dd>
-<dt><strong>GMT_WRITE_TABLE_HEADER</strong></dt>
-<dd>For ASCII output mode we write the text string <tt class="docutils literal"><span class="pre">rec</span></tt>. If <tt class="docutils literal"><span class="pre">rec</span></tt>
-is NULL then we write the last read header record (and ensures it
-starts with #). If binary output mode we quietly skip writing this record.</dd>
-<dt><strong>GMT_WRITE_SEGMENT_HEADER</strong></dt>
-<dd>For ASCII output mode we use the text string <tt class="docutils literal"><span class="pre">rec</span></tt> as the
-segment header. If <tt class="docutils literal"><span class="pre">rec</span></tt> is NULL then we use the current (last
-read) segment header record. If binary output mode instead we write
-a record composed of NaNs.</dd>
-</dl>
-<p>The function returns 1 if there was an error associated with the
-writing (which is passed back with <tt class="docutils literal"><span class="pre">API->error</span></tt>), otherwise it returns
-0.</p>
-</div>
-<div class="section" id="exporting-a-grid-row">
-<h3>3.13.4. Exporting a grid row<a class="headerlink" href="#exporting-a-grid-row" title="Permalink to this headline">¶</a></h3>
-<p>If your program must write a grid file row-by-row you must first enable
-row-by-row writing with <a class="reference internal" href="#gmt-read-data">GMT_Read_Data</a> and then use the
-<tt class="docutils literal"><span class="pre">GMT_Put_Row</span></tt> function in a loop; the prototype is</p>
-<blockquote id="gmt-put-row">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="nf">GMT_Put_Row</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">int</span> <span class="n">row_no</span><span class="p">,</span> <span class="k">struct</span> <span class="n">GMT_GRID</span> <span class="o">*</span><span class="n">G</span><span class="p">,</span> <span class="kt">float</s [...]
-</pre></div>
-</div>
-</div></blockquote>
-<p>where <tt class="docutils literal"><span class="pre">row</span></tt> is a pointer to a single-precision array with the current
-row, <tt class="docutils literal"><span class="pre">G</span></tt> is the grid in question, and <tt class="docutils literal"><span class="pre">row_no</span></tt> is the number of the
-current row to be written. Note this value is only considered if the
-row-by-row mode was initialized with <tt class="docutils literal"><span class="pre">GMT_GRID_ROW_BY_ROW_MANUAL</span></tt>.</p>
-</div>
-<div class="section" id="disable-data-export">
-<h3>3.13.5. Disable Data Export<a class="headerlink" href="#disable-data-export" title="Permalink to this headline">¶</a></h3>
-<p>Once the record-by-record output has completed we disable further output
-to prevent accidental writing from occurring (due to poor program
-structure, bugs, etc.). We do so by calling <tt class="docutils literal"><span class="pre">GMT_End_IO</span></tt>. This
-function disables further record-by-record data export; here, we
-obviously pass <tt class="docutils literal"><span class="pre">direction</span></tt> as <tt class="docutils literal"><span class="pre">GMT_OUT</span></tt>.</p>
-</div>
-</div>
-<div class="section" id="destroy-allocated-resources">
-<h2>3.14. Destroy allocated resources<a class="headerlink" href="#destroy-allocated-resources" title="Permalink to this headline">¶</a></h2>
-<p>If your session imported any data sets into memory then you may
-explicitly free this memory once it is no longer needed and before
-terminating the session. This is done with the <tt class="docutils literal"><span class="pre">GMT_Destroy_Data</span></tt>
-function, whose prototype is</p>
-<blockquote id="gmt-destroy-data">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="nf">GMT_Destroy_Data</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">void</span> <span class="o">*</span><span class="n">data</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>where <tt class="docutils literal"><span class="pre">data</span></tt> is the address of the pointer to a data container. Note that
-when each module completes it will automatically free memory created by
-the API; similarly, when the session is destroyed we also automatically
-free up memory. Thus, <tt class="docutils literal"><span class="pre">GMT_Destroy_Data</span></tt> is therefore generally only
-needed when you wish to directly free up memory to avoid running out of
-it. The function returns 1 if there is an error when trying to
-free the memory (the error code is passed back with <tt class="docutils literal"><span class="pre">API->error</span></tt>),
-otherwise it returns 0.</p>
-</div>
-<div class="section" id="terminate-a-gmt-session">
-<h2>3.15. Terminate a GMT session<a class="headerlink" href="#terminate-a-gmt-session" title="Permalink to this headline">¶</a></h2>
-<p>Before your program exits it should properly terminate the
-GMT session, which involves a call to</p>
-<blockquote id="gmt-destroy-session">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="nf">GMT_Destroy_Session</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>which simply takes the pointer to the GMT API control structure as its
-only arguments. It terminates the GMT machinery and deallocates all
-memory used by the GMT API book-keeping. It also unregisters any
-remaining resources previously registered with the session. The
-GMT API will only close files that it was responsible for opening in
-the first place. Finally, the API structure itself is freed so your main
-program does not need to do so. The function returns 1 if there
-is an error when trying to free the memory (the error code is passed
-back with <tt class="docutils literal"><span class="pre">API->error</span></tt>), otherwise it returns 0.</p>
-</div>
-</div>
-<div class="section" id="the-gmt-fft-interface">
-<h1>4. The GMT FFT Interface<a class="headerlink" href="#the-gmt-fft-interface" title="Permalink to this headline">¶</a></h1>
-<p>While the i/o options presented so far lets you easily read in a data
-table or grid and manipulated them, if you need to do so in the
-wavenumber domain then this chapter is for you. Here we outline how to
-take the Fourier transform of such data, perform calculations in the
-wavenumber domain, and take the inverse transform before writing the
-results. To assist programmers we also distribute fully functioning
-demonstration programs that takes you through the steps we are about to
-discuss; these demo programs may be used as your starting point for
-further development.</p>
-<div class="section" id="presenting-and-parsing-the-fft-options">
-<h2>4.1. Presenting and Parsing the FFT options<a class="headerlink" href="#presenting-and-parsing-the-fft-options" title="Permalink to this headline">¶</a></h2>
-<p>Several GMT programs using FFTs present the same unified option and
-modifier sets to the user. The API makes these available as well. If
-your program needs to present the option usage you can call</p>
-<blockquote id="gmt-fft-option">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">unsigned</span> <span class="kt">int</span> <span class="nf">GMT_FFT_Option</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">char</span> <span class="n">option</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">dim</span><span class="p">,</span>
- <span class="kt">char</span> <span class="o">*</span><span class="n">string</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>Here, <tt class="docutils literal"><span class="pre">option</span></tt> is the unique character used for this particular
-program option (most GMT programs have standardized on using ‘N’ but
-you are free to choose whatever you want except existing GMT common
-options). The <tt class="docutils literal"><span class="pre">dim</span></tt> sets the dimension of the transform, currently you
-must choose 1 or 2, while the <tt class="docutils literal"><span class="pre">string</span></tt> is a one-line message that
-states what the option does; you should tailor this to your program. If
-NULL then a generic message is placed instead.</p>
-<p>To parse the user’s selection you call</p>
-<blockquote id="gmt-fft-parse">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">void</span> <span class="o">*</span><span class="nf">GMT_FFT_Parse</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">char</span> <span class="n">option</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">dim</span><span class="p">,</span> <span class="kt">cha [...]
-</pre></div>
-</div>
-</div></blockquote>
-<p>which accepts the user’s string option via <tt class="docutils literal"><span class="pre">args</span></tt>; the other arguments
-are the same as those above. The function returns an opaque pointer to a
-structure with the chosen parameters.</p>
-</div>
-<div class="section" id="initializing-the-fft-machinery">
-<h2>4.2. Initializing the FFT machinery<a class="headerlink" href="#initializing-the-fft-machinery" title="Permalink to this headline">¶</a></h2>
-<p>Before your can take any transforms you must initialize the FFT
-machinery. This process involves a series of preparatory steps that are
-conveniently performed for you by</p>
-<blockquote id="gmt-fft-create">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">void</span> <span class="o">*</span><span class="nf">GMT_FFT_Create</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">void</span> <span class="o">*</span><span class="n">X</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">dim</span><span class="p">,</span>
- <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">mode</span><span class="p">,</span> <span class="kt">void</span> <span class="o">*</span><span class="n">F</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>Here, <tt class="docutils literal"><span class="pre">X</span></tt> is either your dataset or grid pointer, <tt class="docutils literal"><span class="pre">dim</span></tt> is the
-dimension of the transform (1 or 2 only), <tt class="docutils literal"><span class="pre">mode</span></tt> passes various flags to the setup, such as whether
-the data is real, imaginary, or complex, and <tt class="docutils literal"><span class="pre">F</span></tt> is the opaque pointer
-returned by <a class="reference internal" href="#gmt-fft-parse">GMT_FFT_Parse</a>. Depending on the options you chose to
-pass to <a class="reference internal" href="#gmt-fft-parse">GMT_FFT_Parse</a>, the data may have a constant or a trend
-removed, reflected and extended by various symmetries, padded and
-tapered to desired transform dimensions, and possibly there are
-temporary files written out before the transform takes place. See the <a class="reference internal" href="grdfft.html"><em>grdfft</em></a>
-man page for a full explanation of the options presented by <a class="reference internal" href="#gmt-fft-option">GMT_FFT_Option</a>.</p>
-</div>
-<div class="section" id="taking-the-fft">
-<h2>4.3. Taking the FFT<a class="headerlink" href="#taking-the-fft" title="Permalink to this headline">¶</a></h2>
-<p>Now that everything has been set up you can perform the transform with</p>
-<blockquote id="gmt-fft">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">void</span> <span class="o">*</span><span class="nf">GMT_FFT</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">void</span> <span class="o">*</span><span class="n">X</span><span class="p">,</span> <span class="kt">int</span> <span class="n">direction</span><span class="p">,</span> <span class="kt">unsigned</span> < [...]
-</pre></div>
-</div>
-</div></blockquote>
-<p>which takes as <tt class="docutils literal"><span class="pre">direction</span></tt> either <tt class="docutils literal"><span class="pre">GMT_FFT_FWD</span></tt> or <tt class="docutils literal"><span class="pre">GMT_FFT_INV</span></tt>. The
-mode is used to specify if we pass a real (GMT_FFT_REAL) or complex
-(GMT_FFT_COMPLEX) data set, and <tt class="docutils literal"><span class="pre">K</span></tt> is the opaque pointer returned
-by <a class="reference internal" href="#gmt-fft-create">GMT_FFT_Create</a>. The transform is performed in place and returned
-via <tt class="docutils literal"><span class="pre">X</span></tt>. When done with your manipulations (below) you can call it
-again with the inverse flag to recover the corresponding space-domain
-version of your data. The FFT is fully normalized so that calling
-forward followed by inverse yields the original data set. The information
-passed via <tt class="docutils literal"><span class="pre">K</span></tt> determines if a 1-D or 2-D transform takes place; the
-key work is done via <tt class="docutils literal"><span class="pre">GMT_FFT_1D</span></tt> or <tt class="docutils literal"><span class="pre">GMT_FFT_2D</span></tt> below.</p>
-</div>
-<div class="section" id="taking-the-1-d-fft">
-<h2>4.4. Taking the 1-D FFT<a class="headerlink" href="#taking-the-1-d-fft" title="Permalink to this headline">¶</a></h2>
-<p>A lower-level 1-D FFT is also available via</p>
-<blockquote id="gmt-fft-1d">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="nf">GMT_FFT_1D</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">float</span> <span class="o">*</span><span class="n">data</span><span class="p">,</span> <span class="kt">uint64_t</span> <span class="n">n</span><span class="p">,</span> <span class="kt">int</span> <span class="n">direction</ [...]
-</pre></div>
-</div>
-</div></blockquote>
-<p>which takes as <tt class="docutils literal"><span class="pre">direction</span></tt> either <tt class="docutils literal"><span class="pre">GMT_FFT_FWD</span></tt> or <tt class="docutils literal"><span class="pre">GMT_FFT_INV</span></tt>. The
-mode is used to specify if we pass a real (GMT_FFT_REAL) or complex
-(GMT_FFT_COMPLEX) data set, and <tt class="docutils literal"><span class="pre">data</span></tt> is the 1-D data array of length
-<tt class="docutils literal"><span class="pre">n</span></tt> that we wish
-to transform. The transform is performed in place and returned
-via <tt class="docutils literal"><span class="pre">data</span></tt>. When done with your manipulations (below) you can call it
-again with the inverse flag to recover the corresponding space-domain
-version of your data. The 1-D FFT is fully normalized so that calling
-forward followed by inverse yields the original data set. Note that unlike
-<tt class="docutils literal"><span class="pre">GMT_FFT</span></tt>, this function does not do any data extension, mirroring, detrending,
-etc. but operates directly on the data array given.</p>
-</div>
-<div class="section" id="taking-the-2-d-fft">
-<h2>4.5. Taking the 2-D FFT<a class="headerlink" href="#taking-the-2-d-fft" title="Permalink to this headline">¶</a></h2>
-<p>A lower-level 2-D FFT is also available via</p>
-<blockquote id="gmt-fft-2d">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="nf">GMT_FFT_2D</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">float</span> <span class="o">*</span><span class="n">data</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">nx</span><span class="p">,</span> <span class="kt">unsigned< [...]
- <span class="kt">int</span> <span class="n">direction</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">mode</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>which takes as <tt class="docutils literal"><span class="pre">direction</span></tt> either <tt class="docutils literal"><span class="pre">GMT_FFT_FWD</span></tt> or <tt class="docutils literal"><span class="pre">GMT_FFT_INV</span></tt>. The
-mode is used to specify if we pass a real (GMT_FFT_REAL) or complex
-(GMT_FFT_COMPLEX) data set, and <tt class="docutils literal"><span class="pre">data</span></tt> is the 2-D data array in
-row-major format, with row length <tt class="docutils literal"><span class="pre">nx</span></tt> and column length <tt class="docutils literal"><span class="pre">ny</span></tt>.
-The transform is performed in place and returned
-via <tt class="docutils literal"><span class="pre">data</span></tt>. When done with your manipulations (below) you can call it
-again with the inverse flag to recover the corresponding space-domain
-version of your data. The 2-D FFT is fully normalized so that calling
-forward followed by inverse yields the original data set. Note that unlike
-<tt class="docutils literal"><span class="pre">GMT_FFT</span></tt>, this function does not do any data extension, mirroring, detrending,
-etc. but operates directly on the data array given.</p>
-</div>
-<div class="section" id="wavenumber-calculations">
-<h2>4.6. Wavenumber calculations<a class="headerlink" href="#wavenumber-calculations" title="Permalink to this headline">¶</a></h2>
-<p>As your data have been transformed to the wavenumber domain you may wish
-to operate on the various values as a function of wavenumber. We will
-show how this is done for datasets and grids separately. First, we
-present the function that returns an individual wavenumber:</p>
-<blockquote id="gmt-fft-wavenumber">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">double</span> <span class="nf">GMT_FFT_Wavenumber</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">uint64_t</span> <span class="n">k</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">mode</span><span class="p">,</span> <span class="kt">void</span> <span cl [...]
-</pre></div>
-</div>
-</div></blockquote>
-<p>where <tt class="docutils literal"><span class="pre">k</span></tt> is the index into the array or grid, <tt class="docutils literal"><span class="pre">mode</span></tt> specifies
-which wavenumber we want (it is not used for 1-D transform but for the
-2-D transform we can select either the x-wavenumber (0), the
-y-wavenumber (1), or the radial wavenumber (2)), and finally the opaque
-vector used earlier.</p>
-<div class="section" id="d-fft-manipulation">
-<h3>4.6.1. 1-D FFT manipulation<a class="headerlink" href="#d-fft-manipulation" title="Permalink to this headline">¶</a></h3>
-<p>To be added after gmtfft has been added as new module.</p>
-</div>
-<div class="section" id="id6">
-<h3>4.6.2. 2-D FFT manipulation<a class="headerlink" href="#id6" title="Permalink to this headline">¶</a></h3>
-<p>The number of complex pairs in the grid is given by the header’s <tt class="docutils literal"><span class="pre">nm</span></tt>
-variable, while <tt class="docutils literal"><span class="pre">size</span></tt> will be twice that value as it holds the number
-of components. To visit all the complex values and obtain the
-corresponding wavenumber we simply need to loop over <tt class="docutils literal"><span class="pre">size</span></tt> and call
-<tt class="docutils literal"><span class="pre">GMT_FFT_Wavenumber</span></tt>. This code snippet multiples the complex grid by
-the radial wavenumber:</p>
-<blockquote>
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">uint64_t</span> <span class="n">k</span><span class="p">;</span>
-<span class="k">for</span> <span class="p">(</span><span class="n">k</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="n">k</span> <span class="o"><</span> <span class="n">Grid</span><span class="o">-></span><span class="n">header</span><span class="o">-></span><span class="n">size</span><span class="p">;</span> <span class="n">k</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span>
- <span class="n">wave</span> <span class="o">=</span> <span class="n">GMT_FFT_Wavenumber</span> <span class="p">(</span><span class="n">API</span><span class="p">,</span> <span class="n">k</span><span class="p">,</span> <span class="mi">2</span><span class="p">,</span> <span class="n">K</span><span class="p">);</span>
- <span class="n">Grid</span><span class="o">-></span><span class="n">data</span><span class="p">[</span><span class="n">k</span><span class="p">]</span> <span class="o">*=</span> <span class="n">wave</span><span class="p">;</span>
-<span class="p">}</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>Alternatively, you may choose to be more specific about which components
-are real and imaginary (especially if they are to be treated
-differently), and set up the loop this way:</p>
-<blockquote>
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">uint64_t</span> <span class="n">re</span><span class="p">,</span> <span class="n">im</span><span class="p">;</span>
-<span class="k">for</span> <span class="p">(</span><span class="n">re</span> <span class="o">=</span> <span class="mi">0</span><span class="p">,</span> <span class="n">im</span> <span class="o">=</span> <span class="mi">1</span><span class="p">;</span> <span class="n">re</span> <span class="o"><</span> <span class="n">Grid</span><span class="o">-></span><span class="n">header</span><span class="o">-></span><span class="n">size</span><span class="p">;</span> <span class="n">re</s [...]
- <span class="n">wave</span> <span class="o">=</span> <span class="n">GMT_FFT_Wavenumber</span> <span class="p">(</span><span class="n">API</span><span class="p">,</span> <span class="n">re</span><span class="p">,</span> <span class="mi">2</span><span class="p">,</span> <span class="n">K</span><span class="p">);</span>
- <span class="n">Grid</span><span class="o">-></span><span class="n">data</span><span class="p">[</span><span class="n">re</span><span class="p">]</span> <span class="o">*=</span> <span class="n">wave</span><span class="p">;</span>
- <span class="n">Grid</span><span class="o">-></span><span class="n">data</span><span class="p">[</span><span class="n">im</span><span class="p">]</span> <span class="o">*=</span> <span class="mf">2.0</span> <span class="o">*</span> <span class="n">wave</span><span class="p">;</span>
-<span class="p">}</span>
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-</div>
-<div class="section" id="destroying-the-fft-machinery">
-<h2>4.7. Destroying the FFT machinery<a class="headerlink" href="#destroying-the-fft-machinery" title="Permalink to this headline">¶</a></h2>
-<p>When done you terminate the FFT machinery with</p>
-<blockquote id="gmt-fft-destroy">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">double</span> <span class="nf">GMT_FFT_Destroy</span> <span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">API</span><span class="p">,</span> <span class="kt">void</span> <span class="o">*</span><span class="n">K</span><span class="p">);</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>which simply frees up the memory allocated by the FFT machinery.</p>
-</div>
-</div>
-<div class="section" id="fortran-interfaces">
-<h1>5. FORTRAN interfaces<a class="headerlink" href="#fortran-interfaces" title="Permalink to this headline">¶</a></h1>
-<p>FORTRAN 90 developers who wish to use the GMT API may use the same
-API functions as discussed in Chapter 2. As we do not have much (i.e., any) experience
-with modern Fortran we are not sure to what extent you are able to access
-the members of the various structures, such as the <tt class="docutils literal"><span class="pre">GMT_GRID</span></tt> structure. Thus,
-this part will depend on feedback and for the time being is to be considered
-preliminary and subject to change. We encourage you to take contact should you
-wish to use the API with your Fortran 90 programs.</p>
-<div class="section" id="fortran-77-grid-i-o">
-<h2>5.1. FORTRAN 77 Grid i/o<a class="headerlink" href="#fortran-77-grid-i-o" title="Permalink to this headline">¶</a></h2>
-<p>Because of a lack of structure pointers we can only provide a low level of
-support for Fortran 77. This API is limited to help you inquire, read and write
-GMT grids directly from Fortran 77.
-To inquire about the range of information in a grid, use</p>
-<blockquote id="gmt-f77-readgrdinfo">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="n">GMT_F77_readgrdinfo</span> <span class="p">(</span><span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">dim</span><span class="p">[],</span> <span class="kt">double</span> <span class="n">limits</span><span class="p">[],</span> <span class="kt">double</span> <span class="n">inc</span><span class="p">[],</span>
- <span class="kt">char</span> <span class="o">*</span><span class="n">title</span><span class="p">,</span> <span class="kt">char</span> <span class="o">*</span><span class="n">remark</span><span class="p">,</span> <span class="kt">char</span> <span class="o">*</span><span class="n">file</span><span class="p">)</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>where <tt class="docutils literal"><span class="pre">dim</span></tt> returns the grid width, height, and registration, <tt class="docutils literal"><span class="pre">limits</span></tt> returns the min and max values for x, y, and z
-as three consecutive pairs, <tt class="docutils literal"><span class="pre">inc</span></tt> returns the x and y increment, the <tt class="docutils literal"><span class="pre">title</span></tt> and <tt class="docutils literal"><span class="pre">remark</span></tt>
-returns the values of these strings. The <tt class="docutils literal"><span class="pre">file</span></tt>
-argument is the name of the file we wish to inquire about. The function returns 0 unless there is an error.
-Note that you must declare your variables so that <tt class="docutils literal"><span class="pre">limits</span></tt> has at least 6 elements and <tt class="docutils literal"><span class="pre">inc</span></tt> and <tt class="docutils literal"><span class="pre">dime</span></tt> have at least 2 each.</p>
-<p>To actually read the grid, we use</p>
-<blockquote id="gmt-f77-readgrd">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="n">GMT_F77_readgrd</span> <span class="p">(</span><span class="kt">float</span> <span class="o">*</span><span class="n">array</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">dim</span><span class="p">[],</span> <span class="kt">double</span> <span class="n">wesn</span><span class="p">[],</span>
- <span class="kt">double</span> <span class="n">inc</span><span class="p">[],</span> <span class="kt">char</span> <span class="o">*</span><span class="n">title</span><span class="p">,</span> <span class="kt">char</span> <span class="o">*</span><span class="n">remark</span><span class="p">,</span> <span class="kt">char</span> <span class="o">*</span><span class="n">file</span><span class="p">)</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>where <tt class="docutils literal"><span class="pre">array</span></tt> is the 1-D grid data array, <tt class="docutils literal"><span class="pre">dim</span></tt> returns the grid width, height, and registration,
-<tt class="docutils literal"><span class="pre">limits</span></tt> returns the min and max values for x, y, and z, <tt class="docutils literal"><span class="pre">inc</span></tt> returns the x and y increments,
-the <tt class="docutils literal"><span class="pre">title</span></tt> and <tt class="docutils literal"><span class="pre">remark</span></tt> returns the values of these strings. The <tt class="docutils literal"><span class="pre">file</span></tt>
-argument is the name of the file we wish to read from. The function returns 0 unless there is an error.
-Note on input, <tt class="docutils literal"><span class="pre">dim[2]</span></tt> can be set to 1 which means we will allocate the array for you; otherwise
-we assume space has already been secured. Also, if <tt class="docutils literal"><span class="pre">dim[3]</span></tt> is set to 1 we will in-place transpose
-the array from C-style row-major array order to Fortran column-major array order.</p>
-<p>Finally, to write a grid to file you can use</p>
-<blockquote id="gmt-f77-writegrd">
-<div><div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="n">GMT_F77_writegrd_</span><span class="p">(</span><span class="kt">float</span> <span class="o">*</span><span class="n">array</span><span class="p">,</span> <span class="kt">unsigned</span> <span class="kt">int</span> <span class="n">dim</span><span class="p">[],</span> <span class="kt">double</span> <span class="n">wesn</span><span class="p">[],</span>
- <span class="kt">double</span> <span class="n">inc</span><span class="p">[],</span> <span class="kt">char</span> <span class="o">*</span><span class="n">title</span><span class="p">,</span> <span class="kt">char</span> <span class="o">*</span><span class="n">remark</span><span class="p">,</span> <span class="kt">char</span> <span class="o">*</span><span class="n">file</span><span class="p">)</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>where <tt class="docutils literal"><span class="pre">array</span></tt> is the 1-D grid data array, <tt class="docutils literal"><span class="pre">dim</span></tt> specifies the grid width, height, and registration,
-<tt class="docutils literal"><span class="pre">limits</span></tt> may be used to specify a subset (normally, just pass zeros), <tt class="docutils literal"><span class="pre">inc</span></tt> specifies the x and y increments,
-the <tt class="docutils literal"><span class="pre">title</span></tt> and <tt class="docutils literal"><span class="pre">remark</span></tt> supplies the values of these strings. The <tt class="docutils literal"><span class="pre">file</span></tt>
-argument is the name of the file we wish to write to. The function returns 0 unless there is an error.
-If <tt class="docutils literal"><span class="pre">dim[3]</span></tt> is set to 1 we will in-place transpose
-the array from Fortran column-major array order to C-style row-major array order before writing. Note
-this means array will have been transposed when the function returns.</p>
-<table class="docutils footnote" frame="void" id="id7" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id1">[1]</a></td><td>or via a very confusing and ever-changing myriad of low-level library
-functions for bold programmers.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id8" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id2">[2]</a></td><td>Currently, C/C++, FORTRAN, Matlab and Julia are being tested.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id9" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id3">[3]</a></td><td>At the moment, GMT does not have native support for 3-D grids.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id10" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id4">[4]</a></td><td>This may change in later releases.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id11" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id5">[5]</a></td><td>However, there is no thread-support yet.</td></tr>
-</tbody>
-</table>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">1. Introduction</a><ul>
-<li><a class="reference internal" href="#preamble">1.1. Preamble</a></li>
-<li><a class="reference internal" href="#the-i-o-abstraction-layer">1.2. The i/o abstraction layer</a></li>
-<li><a class="reference internal" href="#our-audience">1.3. Our audience</a></li>
-<li><a class="reference internal" href="#definitions">1.4. Definitions</a></li>
-<li><a class="reference internal" href="#recognized-resources">1.5. Recognized resources</a><ul>
-<li><a class="reference internal" href="#data-tables">1.5.1. Data tables</a></li>
-<li><a class="reference internal" href="#text-tables">1.5.2. Text tables</a></li>
-<li><a class="reference internal" href="#gmt-grids">1.5.3. GMT grids</a></li>
-<li><a class="reference internal" href="#gmt-images">1.5.4. GMT images</a></li>
-<li><a class="reference internal" href="#cpt-palette-tables">1.5.5. CPT palette tables</a></li>
-<li><a class="reference internal" href="#user-data-columns-gmt-vectors">1.5.6. User data columns (GMT vectors)</a></li>
-<li><a class="reference internal" href="#user-data-matrices-gmt-matrices">1.5.7. User data matrices (GMT matrices)</a></li>
-</ul>
-</li>
-</ul>
-</li>
-<li><a class="reference internal" href="#overview-of-the-gmt-c-application-program-interface">2. Overview of the GMT C Application Program Interface</a></li>
-<li><a class="reference internal" href="#the-gmt-c-application-program-interface">3. The GMT C Application Program Interface</a><ul>
-<li><a class="reference internal" href="#initialize-a-new-gmt-session">3.1. Initialize a new GMT session</a></li>
-<li><a class="reference internal" href="#register-input-or-output-resources">3.2. Register input or output resources</a><ul>
-<li><a class="reference internal" href="#resource-registration">3.2.1. Resource registration</a></li>
-<li><a class="reference internal" href="#object-id-encoding">3.2.2. Object ID encoding</a></li>
-<li><a class="reference internal" href="#resource-initialization">3.2.3. Resource initialization</a></li>
-<li><a class="reference internal" href="#dimension-parameters-for-user-1-d-column-vectors">3.2.4. Dimension parameters for user 1-D column vectors</a></li>
-<li><a class="reference internal" href="#dimension-parameters-for-user-2-d-table-arrays">3.2.5. Dimension parameters for user 2-D table arrays</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#create-empty-resources">3.3. Create empty resources</a></li>
-<li><a class="reference internal" href="#duplicate-resources">3.4. Duplicate resources</a></li>
-<li><a class="reference internal" href="#get-resource-id">3.5. Get resource ID</a></li>
-<li><a class="reference internal" href="#import-data">3.6. Import Data</a><ul>
-<li><a class="reference internal" href="#enable-data-import">3.6.1. Enable Data Import</a></li>
-<li><a class="reference internal" href="#import-a-data-set">3.6.2. Import a data set</a><ul>
-<li><a class="reference internal" href="#import-from-a-file-stream-or-handle">3.6.2.1. Import from a file, stream, or handle</a></li>
-<li><a class="reference internal" href="#import-from-a-memory-location">3.6.2.2. Import from a memory location</a></li>
-<li><a class="reference internal" href="#retrieve-an-allocated-result">3.6.2.3. Retrieve an allocated result</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#importing-a-data-record">3.6.3. Importing a data record</a></li>
-<li><a class="reference internal" href="#examining-record-status">3.6.4. Examining record status</a></li>
-<li><a class="reference internal" href="#importing-a-grid-row">3.6.5. Importing a grid row</a></li>
-<li><a class="reference internal" href="#disable-data-import">3.6.6. Disable Data Import</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#manipulate-data">3.7. Manipulate data</a><ul>
-<li><a class="reference internal" href="#manipulate-grids">3.7.1. Manipulate grids</a></li>
-<li><a class="reference internal" href="#manipulate-data-tables">3.7.2. Manipulate data tables</a></li>
-<li><a class="reference internal" href="#manipulate-text-tables">3.7.3. Manipulate text tables</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#message-and-verbose-reporting">3.8. Message and Verbose Reporting</a></li>
-<li><a class="reference internal" href="#presenting-and-accessing-gmt-options">3.9. Presenting and accessing GMT options</a><ul>
-<li><a class="reference internal" href="#display-usage-syntax-for-gmt-common-options">3.9.1. Display usage syntax for GMT common options</a></li>
-<li><a class="reference internal" href="#parsing-the-gmt-common-options">3.9.2. Parsing the GMT common options</a></li>
-<li><a class="reference internal" href="#inquiring-about-the-gmt-common-options">3.9.3. Inquiring about the GMT common options</a></li>
-<li><a class="reference internal" href="#parsing-text-values">3.9.4. Parsing text values</a></li>
-<li><a class="reference internal" href="#inquiring-about-a-gmt-default-parameter">3.9.5. Inquiring about a GMT default parameter</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#prepare-module-options">3.10. Prepare module options</a><ul>
-<li><a class="reference internal" href="#set-program-options-via-text-array-arguments">3.10.1. Set program options via text array arguments</a></li>
-<li><a class="reference internal" href="#set-program-options-via-text-command">3.10.2. Set program options via text command</a></li>
-<li><a class="reference internal" href="#set-program-options-via-linked-structures">3.10.3. Set program options via linked structures</a></li>
-<li><a class="reference internal" href="#convert-between-text-and-linked-structures">3.10.4. Convert between text and linked structures</a></li>
-<li><a class="reference internal" href="#manage-the-linked-list-of-options">3.10.5. Manage the linked list of options</a><ul>
-<li><a class="reference internal" href="#make-a-new-option-structure">3.10.5.1. Make a new option structure</a></li>
-<li><a class="reference internal" href="#append-an-option-to-the-linked-list">3.10.5.2. Append an option to the linked list</a></li>
-<li><a class="reference internal" href="#find-an-option-in-the-linked-list">3.10.5.3. Find an option in the linked list</a></li>
-<li><a class="reference internal" href="#update-an-existing-option-in-the-list">3.10.5.4. Update an existing option in the list</a></li>
-<li><a class="reference internal" href="#delete-an-existing-option-in-the-linked-list">3.10.5.5. Delete an existing option in the linked list</a></li>
-<li><a class="reference internal" href="#specify-a-file-via-an-linked-option">3.10.5.6. Specify a file via an linked option</a></li>
-</ul>
-</li>
-</ul>
-</li>
-<li><a class="reference internal" href="#calling-a-gmt-module">3.11. Calling a GMT module</a></li>
-<li><a class="reference internal" href="#adjusting-headers-and-comments">3.12. Adjusting headers and comments</a></li>
-<li><a class="reference internal" href="#exporting-data">3.13. Exporting Data</a><ul>
-<li><a class="reference internal" href="#enable-data-export">3.13.1. Enable Data Export</a></li>
-<li><a class="reference internal" href="#exporting-a-data-set">3.13.2. Exporting a data set</a><ul>
-<li><a class="reference internal" href="#exporting-a-data-set-to-a-file-stream-or-handle">3.13.2.1. Exporting a data set to a file, stream, or handle</a></li>
-<li><a class="reference internal" href="#exporting-a-data-set-to-memory">3.13.2.2. Exporting a data set to memory</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#exporting-a-data-record">3.13.3. Exporting a data record</a></li>
-<li><a class="reference internal" href="#exporting-a-grid-row">3.13.4. Exporting a grid row</a></li>
-<li><a class="reference internal" href="#disable-data-export">3.13.5. Disable Data Export</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#destroy-allocated-resources">3.14. Destroy allocated resources</a></li>
-<li><a class="reference internal" href="#terminate-a-gmt-session">3.15. Terminate a GMT session</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#the-gmt-fft-interface">4. The GMT FFT Interface</a><ul>
-<li><a class="reference internal" href="#presenting-and-parsing-the-fft-options">4.1. Presenting and Parsing the FFT options</a></li>
-<li><a class="reference internal" href="#initializing-the-fft-machinery">4.2. Initializing the FFT machinery</a></li>
-<li><a class="reference internal" href="#taking-the-fft">4.3. Taking the FFT</a></li>
-<li><a class="reference internal" href="#taking-the-1-d-fft">4.4. Taking the 1-D FFT</a></li>
-<li><a class="reference internal" href="#taking-the-2-d-fft">4.5. Taking the 2-D FFT</a></li>
-<li><a class="reference internal" href="#wavenumber-calculations">4.6. Wavenumber calculations</a><ul>
-<li><a class="reference internal" href="#d-fft-manipulation">4.6.1. 1-D FFT manipulation</a></li>
-<li><a class="reference internal" href="#id6">4.6.2. 2-D FFT manipulation</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#destroying-the-fft-machinery">4.7. Destroying the FFT machinery</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#fortran-interfaces">5. FORTRAN interfaces</a><ul>
-<li><a class="reference internal" href="#fortran-77-grid-i-o">5.1. FORTRAN 77 Grid i/o</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="api.html"
- title="previous chapter">GMT_API</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/GMT_API.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="api.html" title="GMT_API"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="api.html" >GMT_API</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/GMT_Docs.html b/doc_release/html/GMT_Docs.html
deleted file mode 100644
index e1a7537..0000000
--- a/doc_release/html/GMT_Docs.html
+++ /dev/null
@@ -1,10471 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>1. Acknowledgments — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="CookBook" href="cookbook.html" />
- <link rel="next" title="GMT_API" href="api.html" />
- <link rel="prev" title="CookBook" href="cookbook.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="api.html" title="GMT_API"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="cookbook.html" title="CookBook"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="cookbook.html" accesskey="U">CookBook</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <p><strong>The Generic Mapping Tools</strong></p>
-<p><strong>Technical Reference and Cookbook</strong></p>
-<p><strong>Pål (Paul) Wessel</strong></p>
-<p><strong>SOEST, University of Hawai’i at Manoa</strong></p>
-<p><strong>Walter H. F. Smith</strong></p>
-<p><strong>Laboratory for Satellite Altimetry, NOAA/NESDIS/STAR</strong></p>
-<p><strong>Remko Scharroo</strong></p>
-<p><strong>EUMETSAT, Darmstadt, Germany</strong></p>
-<p><strong>Joaquim F. Luis</strong></p>
-<p><strong>Universidade do Algarve, Faro, Portugal</strong></p>
-<p><strong>Florian Wobbe</strong></p>
-<p><strong>Alfred Wegener Institute, Germany</strong></p>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT5_Summit_2011.jpg"><img alt="_images/GMT5_Summit_2011.jpg" src="_images/GMT5_Summit_2011.jpg" style="width: 506.5px; height: 299.5px;" /></a>
-<p class="caption">The four horsemen of the GMT apocalypse: Remko Scharroo, Paul Wessel, Walter H.F. Smith,
-and Joaquim Luis at the GMT Developer Summit in Honolulu, Hawaii during February 14–18, 2011.</p>
-</div>
-<div class="section" id="acknowledgments">
-<h1>1. Acknowledgments<a class="headerlink" href="#acknowledgments" title="Permalink to this headline">¶</a></h1>
-<p>The Generic Mapping Tools (GMT) could not have been designed without
-the generous support of several people. The Founders (Wessel and Smith)
-gratefully acknowledge A. B.
-Watts and the late W. F. Haxby for supporting their efforts on the
-original version 1.0 while they were their graduate students at
-Lamont-Doherty Earth Observatory. Doug Shearer and Roger Davis patiently
-answered many questions over e-mail. The subroutine <tt class="docutils literal"><span class="pre">gauss</span></tt> was
-written and supplied by Bill Menke. Further development of versions
-2.0–2.1 at SOEST would not have been possible without the support from
-the HIGP/SOEST Post-Doctoral Fellowship program to Paul Wessel. Walter
-H. F. Smith gratefully acknowledges the generous support of the C. H.
-and I. M. Green Foundation for Earth Sciences at the Institute of
-Geophysics and Planetary Physics, Scripps Institution of Oceanography,
-University of California at San Diego. GMT series 3.x, 4.x, and 5.x
-owe their existence to grants EAR-93-02272, OCE-95-29431, OCE-00-82552,
-OCE-04-52126, and OCE-1029874 from the National Science Foundation,
-which we gratefully acknowledge.</p>
-<p>We would also like to acknowledge feedback, suggestions and bug reports
-from Michael Barck, Manfred Brands, Allen Cogbill, Stephan Eickschen,
-Ben Horner-Johnson, John Kuhn, Angel Li, Andrew Macrae, Alex Madon, Ken
-McLean, Greg Neumann, Ameet Raval, Georg Schwarz, Richard Signell, Peter
-Schmidt, Dirk Stoecker, Eduardo Suárez, Mikhail Tchernychev, Malte
-Thoma, David Townsend, Garry Vaughan, William Weibel, and many others,
-including their advice on how to make GMT portable to a wide range of
-platforms. John Lillibridge and Stephan Eickschen provided the original
-examples 11 and 32, respectively; Hanno von Lom helped resolve early
-problems with DLL libraries for Win32; Lloyd Parkes enabled indexed
-color images in PostScript; Kurt Schwehr maintains the packages; Wayne
-Wilson implemented the full general perspective projection; and William
-Yip helped translate GMT to POSIX ANSI C and incorporate netCDF 3. The
-SOEST RCF staff (Ross Ishida, Pat Townsend, and Sharon Stahl) provided
-valuable help on Linux and web server support.</p>
-<p>Honolulu, HI, College Park, MD, Faro, Portugal, Darmstadt and
-Bremerhaven, Germany, March 2014</p>
-</div>
-<div class="section" id="a-reminder">
-<h1>2. A Reminder<a class="headerlink" href="#a-reminder" title="Permalink to this headline">¶</a></h1>
-<p>If you feel it is appropriate, you may consider paying us back by citing
-our EOS articles on GMT and technical papers on algorithms when you
-publish papers containing results or illustrations obtained using GMT.
-The EOS articles on GMT are</p>
-<ul class="simple">
-<li>Wessel, P., W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe,
-Generic Mapping Tools: Improved Version Released, <em>EOS Trans. AGU</em>, 94(45),
-p. 409-410, 2013. <a class="reference external" href="http://dx.doi.org/10.1002/2013EO450001">doi:10.1002/2013EO450001</a>.</li>
-<li>Wessel, P., and W. H. F. Smith, New, improved version of Generic
-Mapping Tools released, <em>EOS Trans. AGU</em>, 79(47),
-p. 579, 1998. <a class="reference external" href="http://dx.doi.org/10.1029/98EO00426">doi:10.1029/98EO00426</a>.</li>
-<li>Wessel, P., and W. H. F. Smith, New version of the Generic Mapping
-Tools released, <em>EOS Trans. AGU</em>, 76(33), 329, 1995. <a class="reference external" href="http://dx.doi.org/10.1029/95EO00198">doi:10.1029/95EO00198</a>.</li>
-<li>Wessel, P., and W. H. F. Smith, Free software helps map and display
-data, <em>EOS Trans. AGU</em>, 72(41), 445–446, 1991. <a class="reference external" href="http://dx.doi.org/10.1029/90EO00319">doi:10.1029/90EO00319</a>.</li>
-</ul>
-<p>Some GMT programs are based on algorithms we have developed and
-published separately, such as</p>
-<ul class="simple">
-<li>Kim, S.-S., and P. Wessel, Directional median filtering for
-regional-residual separation of bathymetry, <em>Geochem. Geophys.
-Geosyst.</em>, 9, Q03005, 2008. <a class="reference external" href="http://dx.doi.org/10.1029/2007GC001850">doi:10.1029/2007GC001850</a>.
-[<a class="reference internal" href="supplements/misc/dimfilter.html"><em>dimfilter</em></a>, <strong>misc</strong> supplement]</li>
-<li>Luis, J. F. and J. M. Miranda, Reevaluation of magnetic chrons in the
-North Atlantic between 35ºN and 47ºN: Implications for the formation of the
-Azores Triple Junction and associated plateau,
-<em>J. Geophys. Res.</em>, 113, B10105, 2008. <a class="reference external" href="http://dx.doi.org/10.1029/2007JB005573">doi:10.1029/2007JB005573</a>.
-[<a class="reference internal" href="supplements/potential/grdredpol.html"><em>grdredpol</em></a>, <strong>potential</strong> supplement]</li>
-<li>Smith, W. H. F., and P. Wessel, Gridding with continuous curvature
-splines in tension, <em>Geophysics</em>, 55(3), 293–305, 1990. <a class="reference external" href="http://dx.doi.org/10.1190/1.1442837">doi:10.1190/1.1442837</a>.
-[<a class="reference internal" href="surface.html"><em>surface</em></a>]</li>
-<li>Wessel, P., Tools for analyzing intersecting tracks: The x2sys
-package, <em>Computers & Geosciences</em>, 36, 348–354, 2010. <a class="reference external" href="http://dx.doi.org/10.1016/j.cageo.2009.05.009">doi:10.1016/j.cageo.2009.05.009</a>.
-[<a class="reference internal" href="supplements/x2sys/x2sys_init.html"><em>x2sys</em></a> supplement]</li>
-<li>Wessel, P., A General-purpose Green’s function-based interpolator,
-<em>Computers & Geosciences</em>, 35, 1247–1254, 2009. <a class="reference external" href="http://dx.doi.org/10.1016/j.cageo.2008.08.012">doi:10.1016/j.cageo.2008.08.012</a>.
-[<a class="reference internal" href="greenspline.html"><em>greenspline</em></a>]</li>
-<li>Wessel, P. and J. M. Becker, Interpolation using a generalized
-Green’s function for a spherical surface spline in tension, <em>Geophys.
-J. Int.</em>, 174, 21–28, 2008. <a class="reference external" href="http://dx.doi.org/10.1111/j.1365-246X.2008.03829.x">doi:10.1111/j.1365-246X.2008.03829.x</a>.
-[<a class="reference internal" href="greenspline.html"><em>greenspline</em></a>]</li>
-</ul>
-<p>Finally, GMT includes some code supplied by others, in particular the
-Triangle code used for Delaunay triangulation. Its author, <a class="reference external" href="http://www.cs.berkeley.edu/~jrs/">Jonathan
-Shewchuk</a>, says</p>
-<blockquote>
-<div>“If you use Triangle, and especially if you use it to accomplish
-real work, I would like very much to hear from you. A short letter
-or email describing how you use Triangle will
-mean a lot to me. The more people I know are using this program, the
-more easily I can justify spending time on improvements and on the
-three-dimensional successor to Triangle, which in turn will benefit
-you.”</div></blockquote>
-<p>A few GMT users take the time to write us letters, telling us of the
-difference GMT is making in their work. We appreciate receiving these
-letters. On days when we wonder why we ever released GMT we pull these
-letters out and read them. Seriously, as financial support for
-GMT depends on how well we can “sell” the idea to funding agencies and
-our superiors, letter-writing is one area where GMT users can affect
-such decisions by supporting the GMT project.</p>
-</div>
-<div class="section" id="copyright-and-caveat-emptor">
-<h1>3. Copyright and Caveat Emptor!<a class="headerlink" href="#copyright-and-caveat-emptor" title="Permalink to this headline">¶</a></h1>
-<p>Copyright ©1991–2015 by P. Wessel, W. H. F. Smith, R. Scharroo, J.
-Luis and F. Wobbe</p>
-<p>The Generic Mapping Tools (GMT) is free software; you can
-redistribute it and/or modify it under the terms of the GNU Lesser
-General Public License as published by the Free Software Foundation.</p>
-<p>The GMT package is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file
-<tt class="docutils literal"><span class="pre">LICENSE.TXT</span></tt> in the GMT directory or the for more details.</p>
-<p>Permission is granted to make and distribute verbatim copies of this
-manual provided that the copyright notice and these paragraphs are
-preserved on all copies. The GMT package may be included in a bundled
-distribution of software for which a reasonable fee may be charged.</p>
-<p>GMT does not come with any warranties, nor
-is it guaranteed to work on your computer. The user assumes full
-responsibility for the use of this system. In particular, the University
-of Hawaii School of Ocean and Earth Science and Technology, the National
-Oceanic and Atmospheric Administration, EUMETSAT, the
-Universidade do Algarve, Alfred Wegener Institute, the National Science
-Foundation, Paul Wessel, Walter H. F. Smith, Remko Scharroo, Joaquim F.
-Luis, Florian Wobbe or any other individuals involved in the design and
-maintenance of GMT are NOT responsible for any damage that may follow
-from correct or incorrect use of these programs.</p>
-</div>
-<div class="section" id="preface">
-<h1>4. Preface<a class="headerlink" href="#preface" title="Permalink to this headline">¶</a></h1>
-<p>While GMT has served the map-making and data processing needs of
-scientists since 1988 <a class="footnote-reference" href="#id48" id="id1">[1]</a>, the current global use was heralded by the
-first official release in <em>EOS Trans. AGU</em> in the fall of 1991. Since
-then, GMT has grown to become a standard tool for many users,
-particularly in the Earth and Ocean Sciences but the global collective
-of GMT users is incredibly diverse. Development has at times been
-rapid, and numerous releases have seen the light of day since the early
-versions. For a detailed history of the changes from release to release,
-see file <tt class="docutils literal"><span class="pre">ChangeLog</span></tt> in the main GMT directory. For a nightly snapshot of ongoing
-activity, see the online page. For a historical perspective of the
-origins and development of GMT see the video podcast “20 Years with
-GMT – The Generic Mapping Tools” produced following a seminar given by
-Paul Wessel on the 20th anniversary of GMT; a link is available on the
-GMT website.</p>
-<p>The success of GMT is to a large degree due to the input of the user
-community. In fact, most of the capabilities and options in
-GMT programs originated as user requests. We would like to hear from
-you should you have any suggestions for future enhancements and
-modification. Please send your comments to the GMT help list or create
-an issue in the bug tracker
-(see <a class="reference external" href="http://gmt.soest.hawaii.edu/projects/gmt/issues/">http://gmt.soest.hawaii.edu/projects/gmt/issues/</a>).</p>
-</div>
-<div class="section" id="new-features-in-gmt-5">
-<h1>5. New Features in GMT 5<a class="headerlink" href="#new-features-in-gmt-5" title="Permalink to this headline">¶</a></h1>
-<p>GMT 5 represents a new branch of GMT development that mostly preserves the
-capabilities of the previous versions while adding over 200 new features
-to an already extensive bag of tricks. Our PostScript library
-<a class="reference internal" href="pslib.html"><em>PSL</em></a> has seen a complete rewrite as well
-and produce shorter and more compact PostScript. However, the big news
-is aimed for developers who wish to leverage GMT in their own applications.
-We have completely revamped the code base so that high-level
-GMT functionality is now accessible via GMT “modules”. These are
-high-level functions named after their corresponding programs (e.g.,
-<tt class="docutils literal"><span class="pre">GMT_grdimage</span></tt>) that contains all of the functionality of that program
-within the function. While currently callable from C/C++ only (with some
-support for F77), we are making progress on the Matlab interface as well
-and there are plans to start on the Python version. Developers should
-consult the <a class="reference internal" href="GMT_API.html"><em>GMT API</em></a> documentation for more details.</p>
-<p>We recommend that users of GMT 4 consider learning the new rules and defaults
-since eventually (in some years) GMT 4 will be obsolete.
-To ease the transition to GMT 5 you may run it in compatibility mode,
-thus allowing the use of many obsolete default names and command
-switches (you will receive a warning instead). This is discussed below.</p>
-<p>Below are six key areas of improvements in GMT 5.</p>
-<div class="section" id="new-programs">
-<h2>5.1. New programs<a class="headerlink" href="#new-programs" title="Permalink to this headline">¶</a></h2>
-<p>First, a few new programs have been added and some have been
-promoted (and possibly renamed) from earlier supplements:</p>
-<dl class="docutils">
-<dt><a class="reference internal" href="gmt.html"><em>gmt</em></a></dt>
-<dd>This is the <strong>only</strong> program executable that is distributed with GMT 5. To avoid
-problems with namespace conflicts (e.g., there are other, non-GMT programs
-with generic names like triangulate, surface, etc.) all GMT 5 modules are
-launched from the gmt executable via “gmt module” calls (e.g, gmt pscoast).
-For backwards compatibility (see below) we also offer symbolic links with
-the old executable names that simply point to the gmt program, which then
-can start the correct module. Any module whose name starts with “gmt” can
-be abbreviated, e.g., “gmt gmtconvert” may be called as “gmt convert”.</dd>
-<dt><a class="reference internal" href="gmt2kml.html"><em>gmt2kml</em></a></dt>
-<dd>A <a class="reference internal" href="psxy.html"><em>psxy</em></a> -like tool to produce KML overlays for Google Earth. Previously
-found in the misc supplement.</dd>
-<dt><a class="reference internal" href="gmtconnect.html"><em>gmtconnect</em></a></dt>
-<dd>Connect individual lines whose end points match within given tolerance.
-Previously known as gmtstitch in the misc supplement (this name is recognized
-when GMT is running in compatibility mode).</dd>
-<dt><a class="reference internal" href="gmtget.html"><em>gmtget</em></a></dt>
-<dd>Return the values of the specified GMT defaults. Previously only
-implemented as a shell script and thus not available on all platforms.</dd>
-<dt><a class="reference internal" href="gmtinfo.html"><em>gmtinfo</em></a></dt>
-<dd>Report information about data tables. Previously known by the name minmax
-(this name is still recognized when GMT is running in compatibility mode).</dd>
-<dt><a class="reference internal" href="gmtsimplify.html"><em>gmtsimplify</em></a></dt>
-<dd>A line-reduction tool for coastlines and similar lines. Previously found
-in the misc supplement under the name gmtdp (this name is recognized when
-GMT is running in compatibility mode).</dd>
-<dt><a class="reference internal" href="gmtspatial.html"><em>gmtspatial</em></a></dt>
-<dd>Perform various geospatial operations on lines and polygons.</dd>
-<dt><a class="reference internal" href="gmtvector.html"><em>gmtvector</em></a></dt>
-<dd>Perform basic vector manipulation in 2-D and 3-D.</dd>
-<dt><a class="reference internal" href="gmtwhich.html"><em>gmtwhich</em></a></dt>
-<dd>Return the full path to specified data files.</dd>
-<dt><a class="reference internal" href="grdraster.html"><em>grdraster</em></a></dt>
-<dd>Extracts subsets from large global grids. Previously
-found in the dbase supplement.</dd>
-<dt><a class="reference internal" href="kml2gmt.html"><em>kml2gmt</em></a></dt>
-<dd>Extract GMT data tables from Google Earth KML files. Previously
-found in the misc supplement.</dd>
-<dt><a class="reference internal" href="sph2grd.html"><em>sph2grd</em></a></dt>
-<dd>Compute grid from list of spherical harmonic coefficients [We will add its
-natural complement grd2sph at a later date].</dd>
-<dt><a class="reference internal" href="sphdistance.html"><em>sphdistance</em></a></dt>
-<dd>Make grid of distances to nearest points on a sphere. Previously
-found in the sph supplement.</dd>
-<dt><a class="reference internal" href="sphinterpolate.html"><em>sphinterpolate</em></a></dt>
-<dd>Spherical gridding in tension of data on a sphere. Previously
-found in the sph supplement.</dd>
-<dt><a class="reference internal" href="sphtriangulate.html"><em>sphtriangulate</em></a></dt>
-<dd>Delaunay or Voronoi construction of spherical lon,lat data. Previously
-found in the sph supplement.</dd>
-</dl>
-<p>We have also added a new supplement called potential that contains these five modules:</p>
-<dl class="docutils">
-<dt><a class="reference internal" href="supplements/potential/gmtgravmag3d.html"><em>gmtgravmag3d</em></a>:</dt>
-<dd>Compute the gravity/magnetic anomaly of a body by the method of Okabe.</dd>
-<dt><a class="reference internal" href="supplements/potential/gravfft.html"><em>gravfft</em></a>:</dt>
-<dd>Compute gravitational attraction of 3-D surfaces and a little more by the method of Parker.</dd>
-<dt><a class="reference internal" href="supplements/potential/grdgravmag3d.html"><em>grdgravmag3d</em></a>:</dt>
-<dd>Computes the gravity effect of one (or two) grids by the method of Okabe.</dd>
-<dt><a class="reference internal" href="supplements/potential/grdredpol.html"><em>grdredpol</em></a>:</dt>
-<dd>Compute the Continuous Reduction To the Pole, also known as differential RTP.</dd>
-<dt><a class="reference internal" href="supplements/potential/grdseamount.html"><em>grdseamount</em></a>:</dt>
-<dd>Compute synthetic seamount (Gaussian or cone, circular or elliptical) bathymetry.</dd>
-</dl>
-<p>Finally, the spotter supplement has added one new module:</p>
-<dl class="docutils">
-<dt><a class="reference internal" href="supplements/spotter/grdpmodeler.html"><em>grdpmodeler</em></a>:</dt>
-<dd>Evaluate a plate model on a geographic grid.</dd>
-</dl>
-</div>
-<div class="section" id="new-common-options">
-<h2>5.2. New common options<a class="headerlink" href="#new-common-options" title="Permalink to this headline">¶</a></h2>
-<p>First we discuss changes that have been
-implemented by a series of new lower-case GMT common options:</p>
-<ul class="simple">
-<li>Programs that read data tables can now process the aspatial metadata
-in OGR/GMT files with the new <strong>-a</strong> option. These can be produced by
-<strong>ogr2ogr</strong> (a GDAL tool) when selecting the -f “GMT” output
-format. See Appendix <a class="reference internal" href="#p-the-gmt-vector-data-format-for-ogr-compatibility">P. The GMT Vector Data Format for OGR Compatibility</a>
-for an explanation of the OGR/GMT file format.
-Because all GIS information is encoded via GMT comment lines these
-files can also be used in GMT 4 (the GIS metadata is simply
-skipped).</li>
-<li>Programs that read or write data tables can specify a custom binary format
-using the enhanced <strong>-b</strong> option.</li>
-<li>Programs that read data tables can control which columns to read and
-in what order (and optionally supply scaling relations) with the new <strong>-i</strong> option</li>
-<li>Programs that read grids can use new common option <strong>-n</strong> to control
-grid interpolation settings and boundary conditions.</li>
-<li>Programs that write data tables can control which columns to write
-and in what order (and optionally supply scaling relations) with the new <strong>-o</strong> option.</li>
-<li>All plot programs can take a new <strong>-p</strong> option for perspective view
-from infinity. In GMT 4, only some programs could do this (e.g.,
-<a class="reference internal" href="pscoast.html"><em>pscoast</em></a>) and it took a
-program-specific option, typically <strong>-E</strong> and sometimes an option
-<strong>-Z</strong> would be needed as well. This information is now all passed
-via <strong>-p</strong> and applies across all GMT plotting programs.</li>
-<li>Programs that read data tables can control how records with NaNs are
-handled with the new <strong>-s</strong> option.</li>
-<li>All plot programs can take a new <strong>-t</strong> option to modify the PDF
-transparency level for that layer. However, as PostScript has no provision for
-transparency you can only see the effect if you convert it to PDF.</li>
-</ul>
-</div>
-<div class="section" id="updated-common-options">
-<h2>5.3. Updated common options<a class="headerlink" href="#updated-common-options" title="Permalink to this headline">¶</a></h2>
-<p>Some of the established GMT common options have seen significant
-improvements; these include:</p>
-<ul class="simple">
-<li>The completely revised <strong>-B</strong> option can now handle irregular and custom annotations
-(see Section <a class="reference internal" href="#custom-axes">Custom axes</a>). It also has a new automatic mode which
-will select optimal intervals given data range and plot size. The 3-D base maps can now have
-horizontal gridlines on xz and yz back walls.</li>
-<li>The <strong>-R</strong> option may now accept a leading unit which implies the
-given coordinates are projected map coordinates and should be
-replaced with the corresponding geographic coordinates given the
-specified map projection. For linear projections such units imply a
-simple unit conversion for the given coordinates (e.g., km to meter).</li>
-<li>Introduced <strong>-fp</strong>[<em>unit</em>] which allows data input to be in
-projected values, e.g., UTM coordinates while <strong>-Ju</strong> is given.</li>
-</ul>
-<p>While just giving - (the hyphen) as argument presents just the synopsis of the command
-line arguments, we now also support giving + which in addition will list
-the explanations for all options that are not among the GMT common set.</p>
-</div>
-<div class="section" id="new-default-parameters">
-<h2>5.4. New default parameters<a class="headerlink" href="#new-default-parameters" title="Permalink to this headline">¶</a></h2>
-<p>Most of the GMT default parameters have changed names in order to
-group parameters into logical groups and to use more consistent naming.
-However, under compatibility mode (see below) the old names are still recognized.
-New capabilities have been implemented by introducing new GMT default settings:</p>
-<ul class="simple">
-<li><a class="reference internal" href="gmt.conf.html#dir-parameters"><em>DIR_DCW</em></a> specifies where to look for the optional
-Digital Charts of the World database (for country coloring or selections).</li>
-<li><a class="reference internal" href="gmt.conf.html#dir-parameters"><em>DIR_GSHHG</em></a> specifies where to look for the required
-Global Self-consistent Hierarchical High-resolution Geography database.</li>
-<li><a class="reference internal" href="gmt.conf.html#gmt-compatibility"><em>GMT_COMPATIBILITY</em></a> can be set to 4 to allow
-backwards compatibility with GMT 4 command-line syntax or 5 to impose
-strict GMT5 syntax checking.</li>
-<li><a class="reference internal" href="gmt.conf.html#io-nc4-chunk-size"><em>IO_NC4_CHUNK_SIZE</em></a> is used to set the default
-chunk size for the <strong>lat</strong> and <strong>lon</strong> dimension of the <strong>z</strong> variable of
-netCDF version 4 files.</li>
-<li><a class="reference internal" href="gmt.conf.html#io-nc4-deflation-level"><em>IO_NC4_DEFLATION_LEVEL</em></a> is used to set
-the compression level for netCDF4 files upon output.</li>
-<li><a class="reference internal" href="gmt.conf.html#io-segment-marker"><em>IO_SEGMENT_MARKER</em></a> can be used to change the
-character that GMT uses to identify new segment header records [>].</li>
-<li><a class="reference internal" href="gmt.conf.html#map-annot-ortho"><em>MAP_ANNOT_ORTHO</em></a> controls whether axes annotations
-for Cartesian plots are horizontal or orthogonal to the individual axes.</li>
-<li><a class="reference internal" href="gmt.conf.html#gmt-fft"><em>GMT_FFT</em></a> controls which algorithms to use for Fourier
-transforms.</li>
-<li><a class="reference internal" href="gmt.conf.html#gmt-triangulate"><em>GMT_TRIANGULATE</em></a> controls which algorithm to use
-for Delaunay triangulation.</li>
-<li>Great circle distance approximations can now be fine-tuned via new GMT default parameters
-<a class="reference internal" href="gmt.conf.html#proj-mean-radius"><em>PROJ_MEAN_RADIUS</em></a> and <a class="reference internal" href="gmt.conf.html#proj-aux-latitude"><em>PROJ_AUX_LATITUDE</em></a>.
-Geodesics are now even more accurate by using the Vincenty [1975] algorithm instead of
-Rudoe’s method.</li>
-<li><a class="reference internal" href="gmt.conf.html#gmt-extrapolate-val"><em>GMT_EXTRAPOLATE_VAL</em></a> controls what splines should do if
-requested to extrapolate beyond the given data domain.</li>
-<li><a class="reference internal" href="gmt.conf.html#ps-transparency"><em>PS_TRANSPARENCY</em></a> allows users to modify how transparency will be
-processed when converted to PDF [Normal].</li>
-</ul>
-<p>A few parameters have been introduced in GMT 5 in the past and have been removed again.
-Among these are:</p>
-<ul class="simple">
-<li><em>DIR_USER</em>: was supposed to set the directory in which the user configuration files, or data are stored, but
-this creates problems, because it needs to be known already before it is potentially set in <em>DIR_USER</em>/gmt.conf.
-The environment variable <strong>$GMT_USERDIR</strong> is used for this instead.</li>
-<li><em>DIR_TMP</em>: was supposed to indicate the directory in which to store temporary files. But needs to be known without
-gmt.conf file as well. So the environment variable <strong>$GMT_TMPDIR</strong> is used instead.</li>
-</ul>
-</div>
-<div class="section" id="general-improvements">
-<h2>5.5. General improvements<a class="headerlink" href="#general-improvements" title="Permalink to this headline">¶</a></h2>
-<p>Other wide-ranging changes have been implemented in different
-ways, such as</p>
-<ul class="simple">
-<li>All programs now use consistent, standardized choices for plot
-dimension units (<strong>c</strong>m, <strong>i</strong>nch, or <strong>p</strong>oint; we no longer
-consider <strong>m</strong>eter a plot length unit), and actual distances
-(choose spherical arc lengths in <strong>d</strong>egree, <strong>m</strong>inute, and
-<strong>s</strong>econd [was <strong>c</strong>], or distances in m<strong>e</strong>ter [Default],
-<strong>f</strong>oot [new], <strong>k</strong>m, <strong>M</strong>ile [was sometimes <strong>i</strong> or
-<strong>m</strong>], <strong>n</strong>autical mile, and s<strong>u</strong>rvey foot [new]).</li>
-<li>Programs that read data tables can now process multi-segment tables
-automatically. This means programs that did not have this capability
-(e.g., <a class="reference internal" href="filter1d.html"><em>filter1d</em></a>) can now all operate on the
-segments separately; consequently, there is no longer a <strong>-m</strong>
-option.</li>
-<li>While we support the scaling of z-values in grids via the filename convention
-name[=<em>ID</em>[/<em>scale</em>/<em>offset</em>[/<em>nan</em>]]] mechanism, there are times
-when we wish to scale the x,y domain as well. Users can now
-append <strong>+u</strong><em>unit</em> to their gridfile names, where <em>unit</em> is one of non-arc units listed
-in Table <a class="reference internal" href="#tbl-distunits"><em>distunits</em></a>. This will convert your Cartesian
-x and y coordinates <em>from</em> the given unit <em>to</em> meters. We also support the inverse
-option <strong>+U</strong><em>unit</em>, which can be used to convert your grid
-coordinates <em>from</em> meters <em>to</em> the specified unit.</li>
-<li>CPT files also support the <strong>+u</strong>|<strong>U</strong><em>unit</em> mechanism. Here, the scaling
-applies to the z values. By appending these modifiers to your CPT filenames you
-can avoid having two CPT files (one for meter and one for km) since only one is needed.</li>
-<li>Programs that read grids can now directly handle Arc/Info float binary
-files (GRIDFLOAT) and ESRI .hdr formats.</li>
-<li>Programs that read grids now set boundary conditions to aid further
-processing. If a subset then the boundary conditions are taken from
-the surrounding grid values.</li>
-<li>All text can now optionally be filled with patterns and/or drawn with
-outline pens. In the past, only <a class="reference internal" href="pstext.html"><em>pstext</em></a> could plot outline fonts via
-<strong>-S</strong><em>pen</em>. Now, any text can be an outline text by manipulating
-the corresponding FONT defaults (e.g., <a class="reference internal" href="gmt.conf.html#font-title"><em>FONT_TITLE</em></a>).</li>
-<li>All color or fill specifications may append @<em>transparency</em> to
-change the PDF transparency level for that item. See <strong>-t</strong> for
-limitations on how to visualize this transparency.</li>
-<li>GMT now ships with 36 standard color palette tables (CPT), up from 24.</li>
-</ul>
-</div>
-<div class="section" id="program-specific-improvements">
-<h2>5.6. Program-specific improvements<a class="headerlink" href="#program-specific-improvements" title="Permalink to this headline">¶</a></h2>
-<p>Finally, here is a list of numerous enhancements to individual programs:</p>
-<ul class="simple">
-<li><a class="reference internal" href="blockmean.html"><em>blockmean</em></a> added <strong>-Ep</strong> for error propagation and
-<strong>-Sn</strong> to report the number of data points per block.</li>
-<li><a class="reference internal" href="blockmedian.html"><em>blockmedian</em></a> added <strong>-Er</strong>[-]
-to return as last column the record number that gave the median
-value. For ties, we return the record number of the higher data value
-unless <strong>-Er</strong>- is given (return lower). Added <strong>-Es</strong> to read and
-output source id for median value.</li>
-<li><a class="reference internal" href="blockmode.html"><em>blockmode</em></a> added <strong>-Er</strong>[-] but
-for modal value. Added <strong>-Es</strong> to read and output source id for modal
-value.</li>
-<li><a class="reference internal" href="gmtconvert.html"><em>gmtconvert</em></a> now has optional PCRE (regular expression) support,
-as well as a new option to select a subset of segments specified by
-segment running numbers (<strong>-Q</strong>) and improved options to extract a
-subset of records (<strong>-E</strong>) and support for a list of search strings
-via <strong>-S+f</strong><em>patternfile</em>.</li>
-<li><a class="reference internal" href="gmtinfo.html"><em>gmtinfo</em></a> has new option <strong>-A</strong> to
-select what group to report on (all input, per file, or per segment).
-Also, use <strong>-If</strong> to report an extended region optimized for fastest results in FFTs.
-and <strong>-Is</strong> to report an extended region optimized for fastest results in <a class="reference internal" href="surface.html"><em>surface</em></a>.
-Finally, new option <strong>-D</strong>[<em>inc</em>] to align regions found via <strong>-I</strong> with the center
-of the data.</li>
-<li><a class="reference internal" href="gmtmath.html"><em>gmtmath</em></a> with <strong>-N</strong><em>ncol</em> and input
-files will add extra blank columns, if needed. A new option <strong>-E</strong>
-sets the minimum eigenvalue used by operators LSQFIT and SVDFIT.
-Option <strong>-L</strong> applies operators on a per-segment basis instead of
-accumulating operations across the entire file. Many new
-operators have been added (BITAND, BITLEFT, BITNOT, BITOR, BITRIGHT,
-BITTEST, BITXOR, DIFF, IFELSE, ISFINITE, SVDFIT, TAPER). Finally,
-we have implemented user macros for long or commonly used expressions,
-as well as ability to store and recall using named variables.</li>
-<li><a class="reference internal" href="gmtselect.html"><em>gmtselect</em></a> Takes <strong>-E</strong> to indicate if points exactly on a polygon
-boundary are inside or outside, and <strong>-Z</strong> can now be extended to apply
-to other columns than the third.</li>
-<li><a class="reference internal" href="grd2cpt.html"><em>grd2cpt</em></a> takes <strong>-F</strong> to specify output color model and <strong>-G</strong> to
-truncate incoming CPT to be limited to a given range.</li>
-<li><a class="reference internal" href="grd2xyz.html"><em>grd2xyz</em></a> takes <strong>-C</strong> to write row, col instead of x,y. Append <strong>f</strong>
-to start at 1, else start at 0. Alternatively, use <strong>-Ci</strong> to write just
-the two columns <em>index</em> and <em>z</em>, where <em>index</em>
-is the 1-D indexing that GMT uses when referring to grid nodes.</li>
-<li><a class="reference internal" href="grdblend.html"><em>grdblend</em></a> can now take list of grids on
-the command line and blend, and now has more blend choices (see <strong>-C</strong>). Grids no
-longer have to have same registration or spacing.</li>
-<li><a class="reference internal" href="grdclip.html"><em>grdclip</em></a> has new option <strong>-Si</strong> to set all data >= low and <= high
-to the <em>between</em> value, and <strong>-Sr</strong> to set all data == old to the <em>new</em> value.</li>
-<li><a class="reference internal" href="grdcontour.html"><em>grdcontour</em></a> can specify a single contour with <strong>-C+</strong><em>contour</em> and
-<strong>-A+</strong><em>contour</em>.</li>
-<li><a class="reference internal" href="grdcut.html"><em>grdcut</em></a> can use <strong>-S</strong> to specify an origin and radius and cut the
-corresponding rectangular area, and <strong>-N</strong> to extend the region if the new
-<strong>-R</strong> domain exceeds existing boundaries.</li>
-<li><a class="reference internal" href="grdfft.html"><em>grdfft</em></a> can now accept two grids and let <strong>-E</strong> compute the cross-spectra.
-The <strong>-N</strong> option allows for many new and special settings, including ability
-to control data mirroring, detrending, tapering, and output of intermediate
-results.</li>
-<li><a class="reference internal" href="grdfilter.html"><em>grdfilter</em></a> can now do spherical
-filtering (with wrap around longitudes and over poles) for non-global
-grids. We have also begun implementing Open MP threads to speed up
-calculations on multi-core machines. We have added rectangular
-filtering and automatic resampling to input resolution for high-pass
-filters. There is also <strong>-Ff</strong><em>weightgrd</em> which reads the gridfile
-<em>weightgrd</em> for a custom Cartesian grid convolution. The <em>weightgrd</em>
-must have odd dimensions. Similarly added <strong>-Fo</strong><em>opgrd</em> for
-operators (via coefficients in the grdfile <em>opgrd</em>) whose weight sum
-is zero (hence we do not sum and divide the convolution by the weight
-sum).</li>
-<li><a class="reference internal" href="grdgradient.html"><em>grdgradient</em></a> now has <strong>-Em</strong> that gives results close to ESRI’s
-“hillshade”’” (but faster).</li>
-<li><a class="reference internal" href="grdinfo.html"><em>grdinfo</em></a> now has modifier
-<strong>-Ts</strong><em>dz</em> which returns a symmetrical range about zero. Also,
-if <strong>-Ib</strong> is given then the grid’s bounding box polygon is written.</li>
-<li><a class="reference internal" href="grdimage.html"><em>grdimage</em></a> with GDAL support can write a raster image directly to
-a raster file (<strong>-A</strong>) and may plot raster images as well (<strong>-Dr</strong>).
-It also automatically assigns a color table if none is given and can use
-any of the 36 GMT color tables and scale them to fit the grid range.</li>
-<li><a class="reference internal" href="grdmask.html"><em>grdmask</em></a> has new option
-<strong>-Ni</strong>|I|p|P to set inside of
-polygons to the polygon IDs. These may come from OGR aspatial values,
-segment head <strong>-L</strong>ID, or a running number, starting at a specified
-origin [0]. Now correctly handles polygons with perimeters and holes.
-Added z as possible radius value in <strong>-S</strong> which means read radii
-from 3rd input column.</li>
-<li><a class="reference internal" href="grdmath.html"><em>grdmath</em></a> added many new operators such as BITAND, BITLEFT, BITNOT, BITOR, BITRIGHT,
-BITTEST, BITXOR, DEG2KM, IFELSE, ISFINITE, KM2DEG, and TAPER. Finally,
-we have implemented user macros for long or commonly used expressions,
-as well as ability to store and recall using named variables.</li>
-<li><a class="reference internal" href="grdtrack.html"><em>grdtrack</em></a> has many new options. The <strong>-A</strong> option controls how the
-input track is resampled when <strong>-C</strong> is selected, the new <strong>-C</strong>, <strong>-D</strong>
-options automatically create an equidistant set of cross-sectional
-profiles given input line segments; one or more grids can then be
-sampled at these locations. The <strong>-E</strong> option allows users to quickly specify
-tracks for sampling without needed input tracks. Also added <strong>-S</strong> which stack
-cross-profiles generated with <strong>-C</strong>. The <strong>-N</strong> will not skip
-points that are outside the grid domain but return NaN as sampled
-value. Finally, <strong>-T</strong> will return the nearest non-NaN node if the initial
-location only finds a NaN value.</li>
-<li><a class="reference internal" href="grdvector.html"><em>grdvector</em></a> can now take <strong>-Si</strong><em>scale</em> to give the reciprocal scale,
-i.e., cm/ unit or km/unit. Also, the vector heads in GMT have completely been overhauled
-and includes geo-vector heads that follow great or small circles.</li>
-<li><a class="reference internal" href="grdview.html"><em>grdview</em></a> will automatically assigns a color table if none is given and can use
-any of the 36 GMT color tables and scale them to fit the grid range.</li>
-<li><a class="reference internal" href="grdvolume.html"><em>grdvolume</em></a> can let <strong>-S</strong> accept more distance units than just km. It also
-has a modified <strong>-T</strong>[<strong>c</strong>|<strong>h</strong>] for ORS estimates based on max
-curvature or height. <strong>-Cr</strong> to compute the <em>outside</em> volume between two contours
-(for instances, the volume of water from a bathymetry grid).</li>
-<li><a class="reference internal" href="greenspline.html"><em>greenspline</em></a> has an improved <strong>-C</strong> option to control how many eigenvalues are used
-in the fitting, and <strong>-Sl</strong> adds a linear (or bilinear) spline.</li>
-<li><a class="reference internal" href="makecpt.html"><em>makecpt</em></a> has a new <strong>-F</strong> option to
-specify output color representation, e.g., to output the CPT table in
-h-s-v format despite originally being given in r/g/b, and <strong>-G</strong> to
-truncate incoming CPT to be limited to a given range. It also adds <strong>Di</strong>
-to match the bottom/top values in the input cpt file.</li>
-<li><a class="reference internal" href="mapproject.html"><em>mapproject</em></a> has a new <strong>-N</strong>
-option to do geodetic/geocentric conversions; it combines with <strong>-I</strong>
-for inverse conversions. Also, we have extended <strong>-A</strong> to accept
-<strong>-A</strong><strong>o</strong>| <strong>O</strong> to compute line orientations (-90/90).
-In <strong>-G</strong>, prepend - to the unit for (fast) flat Earth or + for (slow) geodesic calculations.</li>
-<li><a class="reference internal" href="project.html"><em>project</em></a> has added <strong>-G</strong>...[+] so
-if + is appended we get a segment header with information about the
-pole for the circle. Optionally, append /<em>colat</em> in <strong>-G</strong> for a small circle path.</li>
-<li><a class="reference internal" href="ps2raster.html"><em>ps2raster</em></a> has added a <strong>-TF</strong> option to create multi-page PDF files. There is
-also modification to <strong>-A</strong> to add user-specified margins, and it automatically detects
-if transparent elements have been included (and a detour via PDF might be needed).</li>
-<li><a class="reference internal" href="psbasemap.html"><em>psbasemap</em></a> has added a <strong>-D</strong> option to place a map-insert box.</li>
-<li><a class="reference internal" href="psclip.html"><em>psclip</em></a> has added an extended <strong>-C</strong> option to close different types of clip paths.</li>
-<li><a class="reference internal" href="pscoast.html"><em>pscoast</em></a> has added a new option <strong>-F</strong> which lets users specify one or more countries
-to paint, fill, extract, or use as plot domain (requires DCW to be installed).</li>
-<li><a class="reference internal" href="pscontour.html"><em>pscontour</em></a> is now similar to <a class="reference internal" href="grdcontour.html"><em>grdcontour</em></a> in the options it
-takes, e.g., <strong>-C</strong> in particular. In GMT 4, the program could only
-read a CPT file and not take a specific contour interval.</li>
-<li><a class="reference internal" href="pshistogram.html"><em>pshistogram</em></a> now takes <strong>-D</strong> to place histogram count labels on top of each bar
-and <strong>-N</strong> to draw the equivalent normal distributions.</li>
-<li><a class="reference internal" href="pslegend.html"><em>pslegend</em></a> no longer uses system calls to do the plotting. The modified <strong>-D</strong>
-allows for minor offsets, while <strong>-F</strong> offers more control over the frame and fill.</li>
-<li><a class="reference internal" href="psrose.html"><em>psrose</em></a> has added <strong>-Wv</strong><em>pen</em> to
-specify pen for vector (specified in <strong>-C</strong>). Added <strong>-Zu</strong> to set all radii to
-unity (i.e., for analysis of angles only).</li>
-<li><a class="reference internal" href="psscale.html"><em>psscale</em></a> has a new option <strong>-T</strong> that paints a rectangle behind the color bar.
-The <strong>+n</strong> modifier to <strong>-E</strong> draws a rectangle with NaN color and adds a label.
-The <strong>-G</strong> option will truncate incoming CPT to be limited to the specified z-range.
-Modification <strong>-Np</strong> indicates a preference to use polygons to draw the color bar.</li>
-<li><a class="reference internal" href="pstext.html"><em>pstext</em></a> can take simplified input
-via new option <strong>-F</strong> to set fixed font (including size), angle, and
-justification. If these parameters are fixed for all the text strings
-then the input can simply be <em>x y text</em>. It also has enhanced <strong>-DJ</strong> option
-to shorten diagonal offsets by <img class="math" src="_images/math/f8117cd5193e9c43e4cac4a86cc0298690ef3f79.png" alt="\sqrt{2}"/> to maintain the same
-radial distance from point to annotation. Change all text to upper or
-lower case with <strong>-Q</strong>.</li>
-<li><a class="reference internal" href="psxy.html"><em>psxy</em></a> and <a class="reference internal" href="psxyz.html"><em>psxyz</em></a> both support the revised custom symbol macro
-language which has been expanded considerably to allow for complicated,
-multi-parameter symbols; see Appendix <a class="reference internal" href="#m-custom-plot-symbols">M. Custom Plot Symbols</a>
-for details. Finally, we allow the base for bars and columns optionally to be
-read from data file by not specifying the base value.</li>
-<li><a class="reference internal" href="sample1d.html"><em>sample1d</em></a> offers <strong>-A</strong> to control resampling of spatial curves (with <strong>-I</strong>).</li>
-<li><a class="reference internal" href="spectrum1d.html"><em>spectrum1d</em></a> has added <strong>-L</strong> to control removal of trend, mean value or mid value.</li>
-<li><a class="reference internal" href="surface.html"><em>surface</em></a> has added <strong>-r</strong> to create pixel-registered grids and knows about
-periodicity in longitude (given <strong>-fg</strong>). There is also <strong>-D</strong> to supply a “sort” break line.</li>
-<li><a class="reference internal" href="triangulate.html"><em>triangulate</em></a> now offers <strong>-S</strong>
-to write triangle polygons and can handle 2-column input if <strong>-Z</strong> is given.
-Can also write triangle edges as line with <strong>-M</strong>.</li>
-<li><a class="reference internal" href="xyz2grd.html"><em>xyz2grd</em></a> now also offers <strong>-Af</strong> (first value encountered),
-<strong>-Am</strong> (mean, the default), <strong>-Ar</strong> (rms), and <strong>-As</strong> (last value encountered).</li>
-</ul>
-<p>Several supplements have new features as well:</p>
-<ul class="simple">
-<li><a class="reference internal" href="supplements/img/img2grd.html"><em>img2grd</em></a>
-used to be a shell script but is now a C program and can be used on all platforms.</li>
-<li><a class="reference internal" href="supplements/mgd77/mgd77convert.html"><em>mgd77convert</em></a>
-added <strong>-C</strong> option to assemble *.mgd77 files from *.h77/*.a77 pairs.</li>
-<li>The spotter programs can now read GPlates rotation files directly as well
-as write this format. Also,
-<a class="reference internal" href="supplements/spotter/rotconverter.html"><em>rotconverter</em></a> can extract plate
-circuit rotations on-the-fly from the GPlates rotation file.</li>
-</ul>
-<p>Note: GMT 5 only produces PostScript and no longer has a setting for
-Encapsulated PostScript (EPS). We made this decision since (a) our EPS determination
-was always very approximate (no consideration of font metrics, etc.) and quite often wrong,
-and (b) <a class="reference internal" href="ps2raster.html"><em>ps2raster</em></a> handles it exactly. Hence, users who need EPS plots should
-simply process their PostScript files via <a class="reference internal" href="ps2raster.html"><em>ps2raster</em></a>.</p>
-</div>
-<div class="section" id="command-line-completion">
-<span id="id2"></span><h2>5.7. Command-line completion<a class="headerlink" href="#command-line-completion" title="Permalink to this headline">¶</a></h2>
-<p>GMT provides basic command-line completion (tab completion) for bash.
-The easiest way to use the feature is to install the
-<a class="reference external" href="http://bash-completion.alioth.debian.org/">bash-completion</a> package
-which is available in many operating system distributions.</p>
-<p>Depending on the distribution, you may still need to source it from
-<tt class="docutils literal"><span class="pre">~/.bashrc</span></tt>, e.g.:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c"># Use bash-completion, if available</span>
-<span class="k">if</span> <span class="o">[</span> -r /usr/share/bash-completion/bash_completion <span class="o">]</span><span class="p">;</span> <span class="k">then</span>
- . /usr/share/bash-completion/bash_completion
-<span class="k">fi</span>
-</pre></div>
-</div>
-<p>When you install GMT from a distribution package, the completion rules
-are installed in <tt class="docutils literal"><span class="pre">/etc/bash_completion.d/gmt</span></tt> and loaded automatically.
-Custom GMT builds provide <tt class="docutils literal"><span class="pre"><prefix>/share/tools/gmt_completion.bash</span></tt>
-which needs to be manually sourced from either <tt class="docutils literal"><span class="pre">~/.bash_completion</span></tt> or
-<tt class="docutils literal"><span class="pre">~/.bashrc</span></tt>.</p>
-<p>Mac users should note that bash-completion >=2.0 requires bash >=4.1.
-However, OS X won’t ship anything that’s licensed under GPL version 3.
-The last version of bash available under the GPLv2 is 3.2 from 2006.
-It is recommended that <em>bash-completion</em> is installed together with
-<em>bash</em> via <a class="reference external" href="http://www.macports.org/">MacPorts</a>,
-<a class="reference external" href="http://finkproject.org/">Fink</a>, or <a class="reference external" href="http://brew.sh/">Homebrew</a>.
-You then need to change the shell used by your terminal application.
-The <a class="reference external" href="http://trac.macports.org/wiki/howto/bash-completion">bash-completion HOWTO from MacPorts</a>
-explains how to change the preferences of Terminal.app and iTerm.app.
-Another way is to change the default shell by editing of the user
-database:</p>
-<div class="highlight-bash"><div class="highlight"><pre>Add /opt/local/bin/bash to /etc/shells
-chsh -s /opt/local/bin/bash
-</pre></div>
-</div>
-<p>Modify the path to bash, <tt class="docutils literal"><span class="pre">/opt/local/bin/bash</span></tt>, in the example above
-accordingly.</p>
-</div>
-<div class="section" id="incompatibilities-between-gmt-5-and-gmt-4">
-<h2>5.8. Incompatibilities between GMT 5 and GMT 4<a class="headerlink" href="#incompatibilities-between-gmt-5-and-gmt-4" title="Permalink to this headline">¶</a></h2>
-<p>As features are added and bugs are discovered, it is occasionally
-necessary to break the established syntax of a GMT program option, such as when
-the intent of the option is non-unique due to a modifier key being the
-same as a distance unit indicator. Other times we see a greatly improved
-commonality across similar options by making minor adjustments. However,
-we are aware that such changes may cause grief and trouble with
-established scripts and the habits of many GMT users. To alleviate this
-situation we have introduced a configuration that allows GMT to tolerate and process
-obsolete program syntax (to the extent possible). To activate you must
-make sure <a class="reference internal" href="gmt.conf.html#gmt-compatibility"><em>GMT_COMPATIBILITY</em></a> is set to 4 in your gmt.conf file.
-When not running in compatibility mode any obsolete syntax will be considered as
-errors. We recommend that users with prior GMT 4 experience run
-GMT 5 in compatibility mode, heed the warnings about obsolete syntax, and
-correct their scripts or habits accordingly. When this transition has been
-successfully navigated it is better to turn compatibility mode off and leave
-the past behind. Occasionally, users will supply an ancient
-GMT 3 syntax which may have worked in GMT 4 but is not honored in GMT 5.</p>
-<p>Here are a list of known incompatibilities that are correctly processed
-with a warning under compatibility mode:</p>
-<ul class="simple">
-<li>GMT <strong>default names</strong>: We have
-organized the default parameters logically by group and renamed several to
-be easier to remember and to group. Old and new names can be found in
-Table <a class="reference internal" href="#tbl-obsoletedefs"><em>obsolete</em></a>.
-In addition, a few defaults are no longer recognized,
-such as N_COPIES, PS_COPIES, DOTS_PR_INCH, GMT_CPTDIR, PS_DPI, and PS_EPS,
-TRANSPARENCY. This also means the old common option <strong>-c</strong> for specifying
-PostScript copies is no longer available.</li>
-<li><strong>Units</strong>: The unit abbreviation for arc seconds is finally <strong>s</strong>
-instead of <strong>c</strong>, with the same change for upper case in some clock
-format statements.</li>
-<li><strong>Contour labels</strong>: The modifiers <strong>+k</strong><em>fontcolor</em> and
-<strong>+s</strong><em>fontsize</em> are obsolete, now being part of <strong>+f</strong><em>font</em>.</li>
-<li><strong>Ellipsoids</strong>: Assigning <a class="reference internal" href="gmt.conf.html#proj-ellipsoid"><em>PROJ_ELLIPSOID</em></a> a file name is
-deprecated, use comma-separated parameters <img class="math" src="_images/math/83ee01e8e074450e92e4056d0f1fdda5442d34ba.png" alt="a, f^{-1}"/> instead.</li>
-<li><strong>Custom symbol macros:</strong> Circle macro symbol <strong>C</strong> is deprecated; use <strong>c</strong> instead.</li>
-<li><strong>Map scale</strong>: Used by <a class="reference internal" href="psbasemap.html"><em>psbasemap</em></a>
-and others. Here, the unit <strong>m</strong> is deprecated; use <strong>M</strong> for statute miles.</li>
-<li><strong>3-D perspective</strong>: Some programs used a combination of <strong>-E</strong>,
-<strong>-Z</strong> to set up a 3-D perspective view, but these options were not
-universal. The new 3-D perspective in
-GMT 5 means you instead use the
-common option <strong>-p</strong> to configure the 3-D projection.</li>
-<li><strong>Pixel vs. gridline registration:</strong> Some programs used to have a
-local <strong>-F</strong> to turn on pixel registration; now this is a common
-option <strong>-r</strong>.</li>
-<li><strong>Table file headers</strong>: For consistency with other common i/o options
-we now use <strong>-h</strong> instead of <strong>-H</strong>.</li>
-<li><strong>Segment headers</strong>: These are now automatically detected and hence
-there is no longer a <strong>-m</strong> (or the older <strong>-M</strong> option).</li>
-<li><strong>Front symbol</strong>: The syntax for the front symbol has changed from
-<strong>-Sf</strong><em>spacing/size</em>[<strong>+d</strong>][<strong>+t</strong>][:<em>offset</em>] to
-<strong>-Sf</strong><em>spacing</em>[/<em>size</em>][<strong>+r+l</strong>][<strong>+f+t+s+c+b</strong>][<strong>+o</strong><em>offset</em>].</li>
-<li><strong>Vector symbol</strong>: With the introduction of geo-vectors there are
-three kinds of vectors that can be drawn: Cartesian (straight)
-vectors with <strong>-Sv</strong> or <strong>-SV</strong>, geo-vectors (great circles) with
-<strong>-S=</strong>, and circular vectors with <strong>-Sm</strong>. These are all composed of
-a line (controlled by pen settings) and 0–2 arrow heads (control by
-fill and outline settings). Many modifiers common to all arrows have
-been introduced using the <strong>+key</strong>[<em>arg</em>] format. The <em>size</em> of a
-vector refers to the length of its head; all other quantities are
-given via modifiers (which have sensible default values). In
-particular, giving size as <em>vectorwidth/headlength/headwidth</em> is
-deprecated. See the <a class="reference internal" href="psxy.html"><em>psxy</em></a> man page for
-a clear description of all modifiers.</li>
-<li><a class="reference internal" href="blockmean.html"><em>blockmean</em></a>: The <strong>-S</strong> and <strong>-Sz</strong>
-options are deprecated; use <strong>-Ss</strong> instead.</li>
-<li><a class="reference internal" href="filter1d.html"><em>filter1d</em></a>: The <strong>-N</strong><em>ncol/tcol</em>
-option is deprecated; use <strong>-N</strong><em>tcol</em> instead as we automatically
-determine the number of columns in the file.</li>
-<li><a class="reference internal" href="gmt2kml.html"><em>gmt2kml</em></a>: The <strong>-L</strong> option no longer expects column numbers,
-just the column names. This allows the extra columns to contain text
-strings but means users have to supply the data columns in the order
-specified by <strong>-L</strong>.</li>
-<li><a class="reference internal" href="gmtconvert.html"><em>gmtconvert</em></a>: <strong>-F</strong> is
-deprecated; use common option <strong>-o</strong> instead.</li>
-<li><a class="reference internal" href="gmtdefaults.html"><em>gmtdefaults</em></a>: <strong>-L</strong> is
-deprecated; this is now the default behavior.</li>
-<li><a class="reference internal" href="gmtmath.html"><em>gmtmath</em></a>: <strong>-F</strong> is deprecated; use
-common option <strong>-o</strong> instead.</li>
-<li><a class="reference internal" href="gmtselect.html"><em>gmtselect</em></a>: <strong>-Cf</strong> is deprecated;
-use common specification format <strong>-C-</strong> instead. Also,
-<strong>-N</strong>...<strong>o</strong> is deprecated; use <strong>-E</strong> instead.</li>
-<li><a class="reference internal" href="grd2xyz.html"><em>grd2xyz</em></a>: <strong>-E</strong> is deprecated as
-the ESRI ASCII exchange format is now detected automatically.</li>
-<li><a class="reference internal" href="grdcontour.html"><em>grdcontour</em></a>: <strong>-m</strong> is deprecated
-as segment headers are handled automatically.</li>
-<li><a class="reference internal" href="grdfft.html"><em>grdfft</em></a>: <strong>-M</strong> is deprecated; use
-common option <strong>-fg</strong> instead.</li>
-<li><a class="reference internal" href="grdgradient.html"><em>grdgradient</em></a>: <strong>-L</strong> is
-deprecated; use common option <strong>-n</strong> instead. Also, <strong>-M</strong> is
-deprecated; use common option <strong>-fg</strong> instead.</li>
-<li><a class="reference internal" href="grdlandmask.html"><em>grdlandmask</em></a>: <strong>-N</strong>...<strong>o</strong>
-is deprecated; use <strong>-E</strong> instead.</li>
-<li><a class="reference internal" href="grdimage.html"><em>grdimage</em></a>: <strong>-S</strong> is deprecated;
-use <strong>-n</strong><em>mode</em>[<strong>+a</strong>][<strong>+t</strong><em>threshold</em>] instead.</li>
-<li><a class="reference internal" href="grdmath.html"><em>grdmath</em></a>: LDIST and PDIST now return
-distances in spherical degrees; while in
-GMT 4 it returned km; use
-DEG2KM for conversion, if needed.</li>
-<li><a class="reference internal" href="grdproject.html"><em>grdproject</em></a>: <strong>-S</strong> is
-deprecated; use <strong>-n</strong><em>mode</em>[<strong>+a</strong>][<strong>+t</strong><em>threshold</em>]
-instead. Also, <strong>-N</strong> is deprecated; use <strong>-D</strong> instead.</li>
-<li><a class="reference internal" href="grdsample.html"><em>grdsample</em></a>: <strong>-Q</strong> is deprecated;
-use <strong>-n</strong><em>mode</em>[<strong>+a</strong>][<strong>+t</strong><em>threshold</em>] instead. Also,
-<strong>-L</strong> is deprecated; use common option <strong>-n</strong> instead, and
-<strong>-N</strong><em>nx>/<ny</em> is deprecated; use <strong>-I</strong><em>nx+>/<ny+</em> instead.</li>
-<li><a class="reference internal" href="grdtrack.html"><em>grdtrack</em></a>: <strong>-Q</strong> is deprecated;
-use <strong>-n</strong><em>mode</em>[<strong>+a</strong>][<strong>+t</strong><em>threshold</em>] instead. Also,
-<strong>-L</strong> is deprecated; use common option <strong>-n</strong> instead, and <strong>-S</strong> is
-deprecated; use common option <strong>-sa</strong> instead.</li>
-<li><a class="reference internal" href="grdvector.html"><em>grdvector</em></a>: <strong>-E</strong> is deprecated;
-use the vector modifier <strong>+jc</strong> as well as the general vector
-specifications discussed earlier.</li>
-<li><a class="reference internal" href="grdview.html"><em>grdview</em></a>: <strong>-L</strong> is deprecated; use common option <strong>-n</strong> instead.</li>
-<li><a class="reference internal" href="nearneighbor.html"><em>nearneighbor</em></a>: <strong>-L</strong> is
-deprecated; use common option <strong>-n</strong> instead.</li>
-<li><a class="reference internal" href="project.html"><em>project</em></a>: <strong>-D</strong> is deprecated; use <strong>-</strong><strong>-</strong><a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a> instead.</li>
-<li><a class="reference internal" href="psbasemap.html"><em>psbasemap</em></a>: <strong>-G</strong> is deprecated;
-specify canvas color via <strong>-B</strong> modifier <strong>+g</strong><em>color</em>.</li>
-<li><a class="reference internal" href="pscoast.html"><em>pscoast</em></a>: <strong>-m</strong> is deprecated and
-have reverted to <strong>-M</strong> for selecting data output instead of plotting.</li>
-<li><a class="reference internal" href="pscontour.html"><em>pscontour</em></a>: <strong>-T</strong><em>indexfile</em> is deprecated; use <strong>-Q</strong><em>indexfile</em>.</li>
-<li><a class="reference internal" href="pshistogram.html"><em>pshistogram</em></a>: <strong>-T</strong><em>col</em> is
-deprecated; use common option <strong>-i</strong> instead.</li>
-<li><a class="reference internal" href="pslegend.html"><em>pslegend</em></a>: Paragraph text header flag > is deprecated; use P instead.</li>
-<li><a class="reference internal" href="psmask.html"><em>psmask</em></a>: <strong>-D</strong>...<strong>+n</strong><em>min</em> is deprecated; use <strong>-Q</strong> instead.</li>
-<li><a class="reference internal" href="psrose.html"><em>psrose</em></a>: Old vector specifications in
-Option <strong>-M</strong> are deprecated; see new explanations.</li>
-<li><a class="reference internal" href="pstext.html"><em>pstext</em></a>: <strong>-m</strong> is deprecated; use
-<strong>-M</strong> to indicate paragraph mode. Also, <strong>-S</strong> is deprecated as
-fonts attributes are now specified via the font itself.</li>
-<li><a class="reference internal" href="pswiggle.html"><em>pswiggle</em></a>: <strong>-D</strong> is deprecated;
-use common option <strong>-g</strong> to indicate data gaps. Also, <strong>-N</strong> is
-deprecated as all fills are set via the <strong>-G</strong> option.</li>
-<li><a class="reference internal" href="psxy.html"><em>psxy</em></a>: Old vector specifications in
-Option <strong>-S</strong> are deprecated; see new explanations.</li>
-<li><a class="reference internal" href="psxyz.html"><em>psxyz</em></a>: Old vector specifications in
-Option <strong>-S</strong> are deprecated; see new explanations.</li>
-<li><a class="reference internal" href="splitxyz.html"><em>splitxyz</em></a>: <strong>-G</strong> is deprecated;
-use common option <strong>-g</strong> to indicate data gaps. Also, <strong>-M</strong> is
-deprecated; use common option <strong>-fg</strong> instead.</li>
-<li><a class="reference internal" href="triangulate.html"><em>triangulate</em></a>: <strong>-m</strong> is
-deprecated; use <strong>-M</strong> to output triangle vertices.</li>
-<li><a class="reference internal" href="xyz2grd.html"><em>xyz2grd</em></a>: <strong>-E</strong> is deprecated as
-the ESRI ASCII exchange format is one of our recognized formats.
-Also, <strong>-A</strong> (no arguments) is deprecated; use <strong>-Az</strong> instead.</li>
-<li><a class="reference internal" href="grdraster.html"><em>grdraster</em></a>: Now in the main GMT core. The
-<strong>H</strong><em>skip</em> field in <tt class="docutils literal"><span class="pre">grdraster.info</span></tt> is no longer expected as we automatically
-determine if a raster has a GMT header. Also, to output
-<em>x,y,z</em> triplets instead of writing a grid now requires <strong>-T</strong>.</li>
-<li><a class="reference internal" href="supplements/img/img2grd.html"><em>img2grd</em></a>: <strong>-m</strong><em>inc</em> is
-deprecated; use <strong>-I</strong><em>inc</em> instead.</li>
-<li><a class="reference internal" href="supplements/meca/psvelo.html"><em>psvelo</em></a>: Old vector
-specifications are deprecated; see new explanations.</li>
-<li><a class="reference internal" href="supplements/mgd77/mgd77convert.html"><em>mgd77convert</em></a>:
-<strong>-4</strong> is deprecated; use <strong>-D</strong> instead.</li>
-<li><a class="reference internal" href="supplements/mgd77/mgd77list.html"><em>mgd77list</em></a>: The unit
-<strong>m</strong> is deprecated; use <strong>M</strong> for statute miles.</li>
-<li><a class="reference internal" href="supplements/mgd77/mgd77manage.html"><em>mgd77manage</em></a>: The
-unit <strong>m</strong> is deprecated; use <strong>M</strong> for statute miles. The <strong>-Q</strong> is
-deprecated; use <strong>-n</strong><em>mode</em>[<strong>+a</strong>][<strong>+t</strong><em>threshold</em>] instead</li>
-<li><a class="reference internal" href="supplements/mgd77/mgd77path.html"><em>mgd77path</em></a>: <strong>-P</strong> is
-deprecated (clashes with
-GMT common options); use <strong>-A</strong> instead.</li>
-<li><a class="reference internal" href="supplements/spotter/backtracker.html"><em>backtracker</em></a>:
-<strong>-C</strong> is deprecated as stage vs. finite rotations are detected
-automatically.</li>
-<li><a class="reference internal" href="supplements/spotter/grdrotater.html"><em>grdrotater</em></a>:
-<strong>-C</strong> is deprecated as stage vs. finite rotations are detected
-automatically. Also, <strong>-T</strong><em>lon/lat/angle</em> is now set via
-<strong>-e</strong><em>lon/lat/angle</em>.</li>
-<li><a class="reference internal" href="supplements/spotter/grdspotter.html"><em>grdspotter</em></a>:
-<strong>-C</strong> is deprecated as stage vs. finite rotations are detected
-automatically.</li>
-<li><a class="reference internal" href="supplements/spotter/hotspotter.html"><em>hotspotter</em></a>: <strong>-C</strong>
-is deprecated as stage vs. finite rotations are detected
-automatically.</li>
-<li><a class="reference internal" href="supplements/spotter/originator.html"><em>originator</em></a>:
-<strong>-C</strong> is deprecated as stage vs. finite rotations are detected
-automatically.</li>
-<li><a class="reference internal" href="supplements/spotter/rotconverter.html"><em>rotconverter</em></a>:
-<strong>-Ff</strong> selection is deprecated, use <strong>-Ft</strong> instead.</li>
-<li><a class="reference internal" href="supplements/x2sys/x2sys_datalist.html"><em>x2sys_datalist</em></a>:
-The unit <strong>m</strong> is deprecated; use <strong>M</strong> for statute miles.</li>
-</ul>
-<table border="1" class="docutils" id="tbl-obsoletedefs">
-<colgroup>
-<col width="45%" />
-<col width="55%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"><strong>Old Name</strong></th>
-<th class="head"><strong>New Name</strong></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td><strong>ANNOT_FONT_PRIMARY</strong></td>
-<td><strong>FONT_ANNOT_PRIMARY</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>ANNOT_FONT_SECONDARY</strong></td>
-<td><strong>FONT_ANNOT_SECONDARY</strong></td>
-</tr>
-<tr class="row-even"><td><strong>ANNOT_FONT_SIZE_PRIMARY</strong></td>
-<td><strong>FONT_ANNOT_PRIMARY</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>ANNOT_FONT_SIZE_SECONDARY</strong></td>
-<td><strong>FONT_ANNOT_SECONDARY</strong></td>
-</tr>
-<tr class="row-even"><td><strong>ANNOT_MIN_ANGLE</strong></td>
-<td><strong>MAP_ANNOT_MIN_SPACING</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>ANNOT_OFFSET_PRIMARY</strong></td>
-<td><strong>MAP_ANNOT_OFFSET_PRIMARY</strong></td>
-</tr>
-<tr class="row-even"><td><strong>ANNOT_OFFSET_SECONDARY</strong></td>
-<td><strong>MAP_ANNOT_OFFSET_SECONDARY</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>BASEMAP_AXES</strong></td>
-<td><strong>MAP_FRAME_AXES</strong></td>
-</tr>
-<tr class="row-even"><td><strong>BASEMAP_FRAME_RGB</strong></td>
-<td><strong>MAP_DEFAULT_PEN</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>BASEMAP_TYPE</strong></td>
-<td><strong>MAP_FRAME_TYPE</strong></td>
-</tr>
-<tr class="row-even"><td><strong>CHAR_ENCODING</strong></td>
-<td><strong>PS_CHAR_ENCODING</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>D_FORMAT</strong></td>
-<td><strong>FORMAT_FLOAT_OUT</strong></td>
-</tr>
-<tr class="row-even"><td><strong>DEGREE_SYMBOL</strong></td>
-<td><strong>MAP_DEGREE_SYMBOL</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>ELLIPSOID</strong></td>
-<td><strong>PROJ_ELLIPSOID</strong></td>
-</tr>
-<tr class="row-even"><td><strong>FIELD_DELIMITER</strong></td>
-<td><strong>IO_COL_SEPARATOR</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>FRAME_PEN</strong></td>
-<td><strong>MAP_FRAME_PEN</strong></td>
-</tr>
-<tr class="row-even"><td><strong>FRAME_WIDTH</strong></td>
-<td><strong>MAP_FRAME_WIDTH</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>GLOBAL_X_SCALE</strong></td>
-<td><strong>PS_SCALE_X</strong></td>
-</tr>
-<tr class="row-even"><td><strong>GLOBAL_Y_SCALE</strong></td>
-<td><strong>PS_SCALE_Y</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>GRID_CROSS_SIZE_PRIMARY</strong></td>
-<td><strong>MAP_GRID_CROSS_SIZE_PRIMARY</strong></td>
-</tr>
-<tr class="row-even"><td><strong>GRID_CROSS_SIZE_SECONDARY</strong></td>
-<td><strong>MAP_GRID_CROSS_SIZE_SECONDARY</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>GRID_PEN_PRIMARY</strong></td>
-<td><strong>MAP_GRID_PEN_PRIMARY</strong></td>
-</tr>
-<tr class="row-even"><td><strong>GRID_PEN_SECONDARY</strong></td>
-<td><strong>MAP_GRID_PEN_SECONDARY</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>GRIDFILE_FORMAT</strong></td>
-<td><strong>IO_GRIDFILE_FORMAT</strong></td>
-</tr>
-<tr class="row-even"><td><strong>GRIDFILE_SHORTHAND</strong></td>
-<td><strong>IO_GRIDFILE_SHORTHAND</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>HEADER_FONT_SIZE</strong></td>
-<td><strong>FONT_TITLE</strong></td>
-</tr>
-<tr class="row-even"><td><strong>HEADER_FONT</strong></td>
-<td><strong>FONT_TITLE</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>HEADER_OFFSET</strong></td>
-<td><strong>MAP_TITLE_OFFSET</strong></td>
-</tr>
-<tr class="row-even"><td><strong>HISTORY</strong></td>
-<td><strong>GMT_HISTORY</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>HSV_MAX_SATURATION</strong></td>
-<td><strong>COLOR_HSV_MAX_S</strong></td>
-</tr>
-<tr class="row-even"><td><strong>HSV_MAX_VALUE</strong></td>
-<td><strong>COLOR_HSV_MAX_V</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>HSV_MIN_SATURATION</strong></td>
-<td><strong>COLOR_HSV_MIN_S</strong></td>
-</tr>
-<tr class="row-even"><td><strong>HSV_MIN_VALUE</strong></td>
-<td><strong>COLOR_HSV_MIN_V</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>INPUT_CLOCK_FORMAT</strong></td>
-<td><strong>FORMAT_CLOCK_IN</strong></td>
-</tr>
-<tr class="row-even"><td><strong>INPUT_DATE_FORMAT</strong></td>
-<td><strong>FORMAT_DATE_IN</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>INTERPOLANT</strong></td>
-<td><strong>GMT_INTERPOLANT</strong></td>
-</tr>
-<tr class="row-even"><td><strong>LABEL_FONT</strong></td>
-<td><strong>FONT_LABEL</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>LABEL_OFFSET</strong></td>
-<td><strong>MAP_LABEL_OFFSET</strong></td>
-</tr>
-<tr class="row-even"><td><strong>LINE_STEP</strong></td>
-<td><strong>MAP_LINE_STEP</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>MAP_SCALE_FACTOR</strong></td>
-<td><strong>PROJ_SCALE_FACTOR</strong></td>
-</tr>
-<tr class="row-even"><td><strong>MEASURE_UNIT</strong></td>
-<td><strong>PROJ_LENGTH_UNIT</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>NAN_RECORDS</strong></td>
-<td><strong>IO_NAN_RECORDS</strong></td>
-</tr>
-<tr class="row-even"><td><strong>OBLIQUE_ANNOTATION</strong></td>
-<td><strong>MAP_ANNOT_OBLIQUE</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>OUTPUT_CLOCK_FORMAT</strong></td>
-<td><strong>FORMAT_CLOCK_OUT</strong></td>
-</tr>
-<tr class="row-even"><td><strong>OUTPUT_DATE_FORMAT</strong></td>
-<td><strong>FORMAT_DATE_OUT</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>OUTPUT_DEGREE_FORMAT</strong></td>
-<td><strong>FORMAT_GEO_OUT</strong></td>
-</tr>
-<tr class="row-even"><td><strong>PAGE_COLOR</strong></td>
-<td><strong>PS_PAGE_COLOR</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>PAGE_ORIENTATION</strong></td>
-<td><strong>PS_PAGE_ORIENTATION</strong></td>
-</tr>
-<tr class="row-even"><td><strong>PAPER_MEDIA</strong></td>
-<td><strong>PS_MEDIA</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>PLOT_CLOCK_FORMAT</strong></td>
-<td><strong>FORMAT_CLOCK_MAP</strong></td>
-</tr>
-<tr class="row-even"><td><strong>PLOT_DATE_FORMAT</strong></td>
-<td><strong>FORMAT_DATE_MAP</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>PLOT_DEGREE_FORMAT</strong></td>
-<td><strong>FORMAT_GEO_MAP</strong></td>
-</tr>
-<tr class="row-even"><td><strong>POLAR_CAP</strong></td>
-<td><strong>MAP_POLAR_CAP</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>PS_COLOR</strong></td>
-<td><strong>COLOR_HSV_MAX_V</strong></td>
-</tr>
-<tr class="row-even"><td><strong>TICK_LENGTH</strong></td>
-<td><strong>MAP_TICK_LENGTH_PRIMARY|SECONDARY</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>TICK_PEN</strong></td>
-<td><strong>MAP_TICK_PEN_PRIMARY|SECONDARY</strong></td>
-</tr>
-<tr class="row-even"><td><strong>TIME_FORMAT_PRIMARY</strong></td>
-<td><strong>FORMAT_TIME_PRIMARY_MAP</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>TIME_FORMAT_SECONDARY</strong></td>
-<td><strong>FORMAT_TIME_SECONDARY_MAP</strong></td>
-</tr>
-<tr class="row-even"><td><strong>UNIX_TIME_FORMAT</strong></td>
-<td><strong>FORMAT_TIME_STAMP</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>UNIX_TIME_POS</strong></td>
-<td><strong>MAP_LOGO_POS</strong></td>
-</tr>
-<tr class="row-even"><td><strong>UNIX_TIME</strong></td>
-<td><strong>MAP_LOGO</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>VECTOR_SHAPE</strong></td>
-<td><strong>MAP_VECTOR_SHAPE</strong></td>
-</tr>
-<tr class="row-even"><td><strong>VERBOSE</strong></td>
-<td><strong>GMT_VERBOSE</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>WANT_LEAP_SECONDS</strong></td>
-<td><strong>TIME_LEAP_SECONDS</strong></td>
-</tr>
-<tr class="row-even"><td><strong>X_ORIGIN</strong></td>
-<td><strong>MAP_ORIGIN_X</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>XY_TOGGLE</strong></td>
-<td><strong>IO_LONLAT_TOGGLE</strong></td>
-</tr>
-<tr class="row-even"><td><strong>Y_AXIS_TYPE</strong></td>
-<td><strong>MAP_ANNOT_ORTHO</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>Y_ORIGIN</strong></td>
-<td><strong>MAP_ORIGIN_Y</strong></td>
-</tr>
-<tr class="row-even"><td><strong>Y2K_OFFSET_YEAR</strong></td>
-<td><strong>TIME_Y2K_OFFSET_YEAR</strong></td>
-</tr>
-</tbody>
-</table>
-<p>Note: While <strong>TIME_LEAP_SECONDS</strong> is a recognized keyword it is
-currently not implemented and has no effect. We reserve the right
-to enable this feature in the future.</p>
-</div>
-</div>
-<div class="section" id="switching-between-different-gmt-versions">
-<h1>6. Switching between different GMT versions<a class="headerlink" href="#switching-between-different-gmt-versions" title="Permalink to this headline">¶</a></h1>
-<p>We encourage all GMT users to start using version 5 immediately; it
-has been tested extensively by the GMT team and has benefitted from
-bug reports for the 4.5.x versions. Users who still worry about the new
-version breaking things may install GMT 4.5.x and 5 side by side.</p>
-<p>Because GMT 5 is backwards compatible with the 4.5.x series
-(provided you configured it that way) yet maintains its parameters and
-history in separate files (e.g. <tt class="docutils literal"><span class="pre">.gmtdefaults4</span></tt>, versus <tt class="docutils literal"><span class="pre">gmt.conf</span></tt>)
-it is possible to install and use both versions on the same workstation.
-Switching between different GMT versions can be accomplished in several
-ways, two of which will be addressed here:</p>
-<ol class="arabic simple">
-<li>By using the <a class="reference internal" href="gmtswitch.html"><em>gmtswitch</em></a> utility to select the current working version.
-<strong>Pro:</strong> easy, interactive way to switch versions on the command line; works with
-previous GMT syntax. <strong>Con:</strong> editing of shell startup files required; needs write
-access in <tt class="docutils literal"><span class="pre">$HOME</span></tt>-directory; manual intervention necessary if symlink
-<tt class="docutils literal"><span class="pre">$HOME/this_gmt</span></tt> is broken.</li>
-<li>By using the recommended <tt class="docutils literal"><span class="pre">gmt</span> <span class="pre"><module></span></tt>-syntax in conjunction with a shell
-helper function that points to the desired GMT executable. <strong>Pro:</strong> no need to
-create symlinks and edit shell startup files; scripts are more portable.
-<strong>Con:</strong> different syntax required.</li>
-</ol>
-<div class="section" id="setup-of-gmtswitch">
-<h2>6.1. Setup of gmtswitch<a class="headerlink" href="#setup-of-gmtswitch" title="Permalink to this headline">¶</a></h2>
-<p>Run <a class="reference internal" href="gmtswitch.html"><em>gmtswitch</em></a> after you have finished installing all
-GMT versions of interest. The first time you run <a class="reference internal" href="gmtswitch.html"><em>gmtswitch</em></a> it
-will try to find all the available versions installed on your file
-system. The versions found will be listed in the file <tt class="docutils literal"><span class="pre">.gmtversions</span></tt> in your home
-directory; each line is the full path to a GMT root directory (e.g.,
-/usr/local/GMT4.5.9). You may manually add or remove entries there at
-any time. You are then instructed to make two changes to your
-environment (the details are shell-dependent but explained by <a class="reference internal" href="gmtswitch.html"><em>gmtswitch</em></a>):</p>
-<ol class="arabic simple">
-<li><a class="reference internal" href="gmtswitch.html"><em>gmtswitch</em></a> creates and maintains a symbolic link <tt class="docutils literal"><span class="pre">this_gmt</span></tt> in your home
-directory that will point to a directory with one of the installed
-GMT versions.</li>
-<li>Make sure <tt class="docutils literal"><span class="pre">$HOME/this_gmt/bin</span></tt> is in your executable PATH.</li>
-</ol>
-<p>Make those edits, logout, and login again. The next time you
-run <a class="reference internal" href="gmtswitch.html"><em>gmtswitch</em></a> you will be able to switch between versions. Typing
-<a class="reference internal" href="gmtswitch.html"><em>gmtswitch</em></a> with no argument will list the available versions in a
-numerical menu and prompt you to choose one, whereas <a class="reference internal" href="gmtswitch.html"><em>gmtswitch</em></a>
-<em>version</em> will immediately switch to that version (<em>version</em> must be a
-piece of unique text making up the full path to a version, e.g., 4.5.9).
-If you use <strong>bash</strong>, <strong>tcsh</strong>, or <strong>csh</strong> you may have to type <tt class="docutils literal"><span class="pre">hash</span> <span class="pre">-r</span></tt> or
-<tt class="docutils literal"><span class="pre">rehash</span></tt> to initiate the path changes.</p>
-<p>On Windows, the process is somewhat similar. The GMT bin directory has one batch file
-<tt class="docutils literal"><span class="pre">gmtswitch.bat</span></tt> that works by changing the Windows PATH variable so that the BIN
-directory of the preferred version always comes first. To do that the batch works in two
-alternative modes.</p>
-<ol class="arabic simple">
-<li>Permanent mode</li>
-<li>Temporary mode</li>
-</ol>
-<p>The permanent mode makes use of the free executable program <a class="reference external" href="http://www.softpedia.com/get/Tweak/Registry-Tweak/EditPath.shtml">EditPath</a>
-to change the user path in the registry. It’s called permanent because the changes
-remains until ... next change.
-Off course the editpath.exe binary must be in your system’s path as well.
-WARNING: The path change will not be visible on the shell cmd where it was executed.
-For the change to be active you will need to open a new cmd window.</p>
-<p>The second mode is temporary because the path to the selected GMT binary dir is
-prepended to previous path via a shell command line. This modification disappears
-when the shell cmd window where it was executes is deleted.</p>
-<p>For further details the user should read the entire help section at the header of the
-<tt class="docutils literal"><span class="pre">gmtswitch.bat</span></tt>.</p>
-<p>The <tt class="docutils literal"><span class="pre">gmtswitch.bat</span></tt> solution, however, has the drawback that the batch file must be located
-elsewhere and in a directory that is on the user’s PATH, otherwise it wont be located after
-first use unless the other GMT bin directory has a similar batch file. A better solution is to install the
-<a class="reference external" href="http://sourceforge.net/projects/console">Windows console enhancement</a>
-that includes multiple tabs and configure the different tabs to start the different GMT versions.
-All it takes is in the Tab setting to call a batch that modifies the PATH locally. That PATH
-modifying batch will have a single line with something like:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre><span class="nb">set </span><span class="nv">path</span><span class="o">=</span>C:<span class="se">\p</span>rograms<span class="se">\g</span>mt5<span class="se">\b</span>in<span class="p">;</span>%PATH%
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="version-selection-with-helper-function">
-<h2>6.2. Version selection with helper function<a class="headerlink" href="#version-selection-with-helper-function" title="Permalink to this headline">¶</a></h2>
-<p>A shell function can be used as a wrapper around the gmt executable. This even
-works when a gmt application is in the search PATH as it would shadow the real
-command. This method can easily be applied on the command line or in scripts
-when the recommended <tt class="docutils literal"><span class="pre">gmt</span> <span class="pre"><module></span></tt>-syntax is used. Shell scripts using
-old-style GMT commands would have to be converted first. The syntax conversion
-can be accomplished with the <a class="reference internal" href="gmt5syntax.html"><em>gmt5syntax</em></a> utility. A suitable bash wrapper
-function for GMT 5 would look like this:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="k">function</span> gmt<span class="o">()</span> <span class="o">{</span> /path/to/gmt5/bin/gmt <span class="s2">"</span><span class="nv">$@</span><span class="s2">"</span><span class="p">;</span> <span class="o">}</span>
-<span class="nb">export</span> -f gmt
-</pre></div>
-</div>
-<p>Exporting the function is necessary to make it available to subshells and
-scripts. This wrapper function can be either set in your working shell or
-inside a GMT shell script. The latter is useful to switch to a certain GMT
-version on a per-script basis.</p>
-<p>For GMT releases prior to GMT 5 which only provide the module commands,
-we need a slightly modified version of the wrapper script:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="k">function</span> gmt<span class="o">()</span> <span class="o">{</span> <span class="nv">module</span><span class="o">=</span><span class="nv">$1</span><span class="p">;</span> <span class="nb">shift</span><span class="p">;</span> /path/to/gmt4/bin/<span class="si">${</span><span class="nv">module</span><span class="si">}</span> <span class="s2">"</span><span class="nv">$@</span><span class="s2">"</span><span [...]
-<span class="nb">export</span> -f gmt
-</pre></div>
-</div>
-<p>On the command line this might be too much typing to switch between
-versions. So we might as well put everything together in a script file
-<tt class="docutils literal"><span class="pre">gmtfun</span></tt>:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="k">case</span> <span class="nv">$1</span> in
- 4<span class="o">)</span>
- <span class="k">function</span> gmt<span class="o">()</span> <span class="o">{</span>
- <span class="nv">module</span><span class="o">=</span><span class="nv">$1</span><span class="p">;</span> <span class="nb">shift</span><span class="p">;</span> /path/to/gmt4/bin/<span class="si">${</span><span class="nv">module</span><span class="si">}</span> <span class="s2">"</span><span class="nv">$@</span><span class="s2">"</span>
- <span class="o">}</span>
- <span class="p">;;</span>
- 5<span class="o">)</span>
- <span class="k">function</span> gmt<span class="o">()</span> <span class="o">{</span>
- /path/to/gmt5/bin/gmt <span class="s2">"</span><span class="nv">$@</span><span class="s2">"</span>
- <span class="o">}</span>
- <span class="p">;;</span>
- *<span class="o">)</span>
- <span class="k">return</span>
- <span class="p">;;</span>
-<span class="k">esac</span>
-<span class="nb">export</span> -f gmt
-</pre></div>
-</div>
-<p>Source the file with either <tt class="docutils literal"><span class="pre">.</span> <span class="pre">gmtfun</span> <span class="pre">4</span></tt> or <tt class="docutils literal"><span class="pre">.</span> <span class="pre">gmtfun</span> <span class="pre">5</span></tt> to switch
-between versions.</p>
-</div>
-</div>
-<div class="section" id="introduction">
-<h1>7. Introduction<a class="headerlink" href="#introduction" title="Permalink to this headline">¶</a></h1>
-<p>Most scientists are familiar with the sequence: <em>raw data</em> →
-<em>processing</em> → <em>final illustration</em>.
-In order to finalize papers for submission to scientific journals,
-prepare proposals, and create overheads and slides for various
-presentations, many scientists spend large amounts of time and money to
-create camera-ready figures. This process can be tedious and is often
-done manually, since available commercial or in-house software usually
-can do only part of the job. To expedite this process we introduce the
-Generic Mapping Tools (GMT for short), which is a free <a class="footnote-reference" href="#id49" id="id3">[2]</a>, software
-package that can be used to manipulate columns of tabular data,
-time-series, and gridded data sets, and display these data in a variety
-of forms ranging from simple <em>x</em>–<em>y</em> plots to maps and color,
-perspective, and shaded-relief illustrations. GMT uses the
-PostScript page description language [<em>Adobe Systems Inc.</em>, 1990].
-With PostScript, multiple plot files can easily be superimposed to
-create arbitrarily complex images in gray tones or 24-bit true color.
-Line drawings, bitmapped images, and text can be easily combined in one
-illustration. PostScript plot files are device-independent: The same
-file can be printed at 300 dots per inch (dpi) on an ordinary
-laserwriter or at 2470 dpi on a phototypesetter when ultimate quality is
-needed. GMT software is written as a set of UNIX tools <a class="footnote-reference" href="#id50" id="id4">[3]</a> and is
-totally self-contained and fully documented. The system is offered free
-of charge and is distributed over the computer network (Internet)
-[<em>Wessel and Smith, 1991; 1995; 1998</em>].</p>
-<p>The original version 1.0 of GMT was released in the summer of 1988
-when the authors were graduate students at Lamont-Doherty Earth
-Observatory of Columbia University. During our tenure as graduate
-students, L-DEO changed its computing environment to a distributed
-network of UNIX workstations, and we wrote GMT to run in this
-environment. It became a success at L-DEO, and soon spread to numerous
-other institutions in the US, Canada, Europe, and Japan. The current
-version benefits from the many suggestions contributed by users of the
-earlier versions, and now includes more than 50 tools, more than 30
-projections, and many other new, more flexible features. GMT provides
-scientists with a variety of tools for data manipulation and display,
-including routines to sample, filter, compute spectral estimates, and
-determine trends in time series, grid or triangulate arbitrarily spaced
-data, perform mathematical operations (including filtering) on 2-D data
-sets both in the space and frequency domain, sample surfaces along
-arbitrary tracks or onto a new grid, calculate volumes, and find trend
-surfaces. The plotting programs will let the user make linear,
-log<img class="math" src="_images/math/70667f5a1cc0894b0fbd9abaf10ad9b13a2f65c1.png" alt="_{10}"/>, and <img class="math" src="_images/math/b9d9437b637001fdf6d0899ddf6c3258d8e04296.png" alt="x^a - y^b"/> diagrams, polar
-and rectangular histograms, maps with filled continents and coastlines
-choosing from many common map projections, contour plots, mesh plots,
-monochrome or color images, and artificially illuminated shaded-relief
-and 3-D perspective illustrations.</p>
-<p>GMT is written in the highly portable ANSI C programming language
-[<em>Kernighan and Ritchie</em>, 1988], is fully POSIX compliant [<em>Lewine</em>,
-1991], has no Year 2000 problems, and may be used with any hardware
-running some flavor of UNIX, possibly with minor modifications. In
-writing GMT, we have followed the modular design philosophy of UNIX:
-The <em>raw data</em> → <em>processing</em> → <em>final illustration</em> flow is broken
-down to a series of elementary steps; each
-step is accomplished by a separate GMT or UNIX tool. This modular
-approach brings several benefits: (1) only a few programs are needed,
-(2) each program is small and easy to update and maintain, (3) each step
-is independent of the previous step and the data type and can therefore
-be used in a variety of applications, and (4) the programs can be
-chained together in shell scripts or with pipes, thereby creating a
-process tailored to do a user-specific task. The decoupling of the data
-retrieval step from the subsequent massage and plotting is particularly
-important, since each institution will typically have its own data base
-formats. To use GMT with custom data bases, one has only to write a
-data extraction tool which will put out data in a form readable by
-GMT (discussed below). After writing the extractor, all other
-GMT modules will work as they are.</p>
-<p>GMT makes full use of the PostScript page description language, and
-can produce color illustrations if a color PostScript device is
-available. One does not necessarily have to have access to a
-top-of-the-line color printer to take advantage of the color
-capabilities offered by GMT: Several companies offer imaging services
-where the customer provides a PostScript plot file and gets color
-slides or hardcopies in return. Furthermore, general-purpose
-PostScript raster image processors (RIPs) are now becoming available,
-letting the user create raster images from PostScript and plot these
-bitmaps on raster devices like computer screens, dot-matrix printers,
-large format raster plotters, and film writers <a class="footnote-reference" href="#id51" id="id5">[4]</a>. Because the
-publication costs of color illustrations are high, GMT offers 90
-common bit and hachure patterns, including many geologic map symbol
-types, as well as complete graytone shading operations. Additional bit
-and hachure patterns may also be designed by the user. With these tools,
-it is possible to generate publication-ready monochrome originals on a
-common laserwriter.</p>
-<p>GMT is thoroughly documented and comes with a technical reference and
-cookbook which explains the purpose of the package and its many
-features, and provides numerous examples to help new users quickly
-become familiar with the operation and philosophy of the system. The
-cookbook contains the shell scripts that were used for each example;
-PostScriptfiles of each illustration are also provided. All programs
-have individual manual pages which can be installed as part of the
-on-line documentation under the UNIX <strong>man</strong> utility or as web
-pages. In addition, the programs offer friendly help messages which make
-them essentially self-teaching – if a user enters invalid or ambiguous
-command arguments, the program will print a warning to the screen with a
-synopsis of the valid arguments. All the documentation is available for
-web browsing and may be installed at the user’s site.</p>
-<p>The processing and display routines within GMT are completely general
-and will handle any (<em>x,y</em>) or (<em>x,y,z</em>) data as input. For many
-purposes the (<em>x,y</em>) coordinates will be (longitude, latitude) but in
-most cases they could equally well be any other variables (e.g.,
-wavelength, power spectral density). Since the GMTplot tools will
-map these (<em>x,y</em>) coordinates to positions on a plot or map using a
-variety of transformations (linear, log-log, and several map
-projections), they can be used with any data that are given by two or
-three coordinates. In order to simplify and standardize input and
-output, GMT uses two file formats only. Arbitrary sequences of (<em>x,y</em>)
-or (<em>x,y,z</em>) data are read from multi-column ASCII tables, i.e., each
-file consists of several records, in which each coordinate is confined
-to a separate column <a class="footnote-reference" href="#id52" id="id6">[5]</a>. This format is straightforward and allows the
-user to perform almost any simple (or complicated) reformatting or
-processing task using standard UNIX utilities such as <strong>cut</strong>,
-<strong>paste</strong>, <strong>grep</strong>, <strong>sed</strong> and <strong>awk</strong>. Two-dimensional data
-that have been sampled on an equidistant grid are read and written by
-GMT in a binary grid file using the functions provided with the netCDF
-library (a free, public-domain software library available separately
-from UCAR, the University Corporation of Atmospheric Research [<em>Treinish
-and Gough</em>, 1987]). This XDR (External Data Representation) based format
-is architecture independent, which allows the user to transfer the
-binary data files from one computer system to another <a class="footnote-reference" href="#id53" id="id7">[6]</a>.
-GMT contains programs that will read ASCII (<em>x,y,z</em>) files and produce
-grid files. One such program, <a class="reference internal" href="surface.html"><em>surface</em></a>,
-includes new modifications to the gridding algorithm developed by <em>Smith
-and Wessel</em> [1990] using continuous splines in tension.</p>
-<p>Most of the programs will produce some form of output, which falls into
-four categories. Several of the programs may produce more than one of
-these types of output:</p>
-<ul class="simple">
-<li>1-D ASCII Tables — For example, a (<em>x,y</em>) series may be
-filtered and the filtered values output. ASCII output is written to
-the standard output stream.</li>
-<li>2-D binary (netCDF or user-defined) grid files – Programs that grid
-ASCII (<em>x,y,z</em>) data or operate on existing grid files produce
-this type of output.</li>
-<li>PostScript – The plotting programs all use the PostScriptpage
-description language to define plots. These commands are stored as
-ASCII text and can be edited should you want to customize the plot
-beyond the options available in the programs themselves.</li>
-<li>Reports – Several GMT programs read input files and report
-statistics and other information. Nearly all programs have an
-optional “verbose” operation, which reports on the progress of
-computation. All programs feature usage messages, which prompt the
-user if incorrect commands have been given. Such text is written to
-the standard error stream and can therefore be separated from ASCII
-table output.</li>
-</ul>
-<p>GMT is available over the Internet at no charge. To obtain a copy,
-goto GMT home page <a class="reference external" href="http://gmt.soest.hawaii.edu/">http://gmt.soest.hawaii.edu/</a> and follow instructions.
-We also maintain two electronic
-mailing lists you may subscribe to in order to stay informed about bug
-fixes and upgrades.</p>
-<p>For those without net-access that need to obtain GMT: Geoware makes
-and distributes CD-R and DVD-R media with the GMT package, compatible
-supplements, and several Gb of useful Earth and ocean science data sets.
-For more information send e-mail to <a class="reference external" href="mailto:geoware%40geoware-online.com">geoware<span>@</span>geoware-online<span>.</span>com</a>.</p>
-<p>GMT has served a multitude of scientists very well, and their
-responses have prompted us to develop these programs even further. It is
-our hope that the new version will satisfy these users and attract new
-users as well. We present this system to the community in order to
-promote sharing of research software among investigators in the US and abroad.</p>
-<div class="section" id="references">
-<h2>7.1. References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<ul class="simple">
-<li>Adobe Systems Inc., <em>PostScript Language Reference Manual</em>, 2nd
-edition, 764, Addison-Wesley, Reading, Massachusetts, 1990.</li>
-<li>Kernighan, B. W., and D. M. Ritchie, <em>The C programming language</em>,
-2nd edition, 272, Prentice-Hall, Englewood Cliffs, New Jersey, 1988.</li>
-<li>Lewine, D., POSIX programmer’s guide, 1st edition, 607, O’Reilly &
-Associates, Sebastopol, California, 1991.</li>
-<li>Treinish, L. A., and M. L. Gough, A software package for the
-data-independent management of multidimensional data, <em>EOS Trans.
-AGU</em>, 68(28), 633–635, 1987. <a class="reference external" href="http://dx.doi.org/10.1029/EO068i028p00633">doi:10.1029/EO068i028p00633</a>.</li>
-</ul>
-</div>
-</div>
-<div class="section" id="gmt-overview-and-quick-reference">
-<h1>8. GMT Overview and Quick Reference<a class="headerlink" href="#gmt-overview-and-quick-reference" title="Permalink to this headline">¶</a></h1>
-<div class="section" id="gmt-summary">
-<h2>8.1. GMT summary<a class="headerlink" href="#gmt-summary" title="Permalink to this headline">¶</a></h2>
-<p>The following is a summary of all the programs supplied with GMT and
-a very short description of their purpose. For more details, see the
-individual UNIX manual pages or the online web documentation. For a
-listing sorted by program purpose, see Section <a class="reference internal" href="#gmt-quick-reference">GMT quick reference</a>.</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="25%" />
-<col width="75%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"> </th>
-<th class="head"> </th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td><a class="reference internal" href="blockmean.html"><em>blockmean</em></a></td>
-<td>L<img class="math" src="_images/math/31ef81fb7b36be5589d39867b7d7e9bbfa764e6a.png" alt="_2"/> (<em>x</em>,<em>y</em>,<em>z</em>) table data filter/decimator</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="blockmedian.html"><em>blockmedian</em></a></td>
-<td>L<img class="math" src="_images/math/2fd8d00206c7d35b6265096bb73a7a057d8ca82d.png" alt="_1"/> (<em>x</em>,<em>y</em>,<em>z</em>) table data filter/decimator</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="blockmode.html"><em>blockmode</em></a></td>
-<td>Mode estimate (<em>x</em>,<em>y</em>,<em>z</em>) table data filter/decimator</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="filter1d.html"><em>filter1d</em></a></td>
-<td>Filter 1-D table data sets (time series)</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="fitcircle.html"><em>fitcircle</em></a></td>
-<td>Finds the best-fitting great or small circle for a set of points</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="gmt2kml.html"><em>gmt2kml</em></a></td>
-<td>Like <a class="reference internal" href="psxy.html"><em>psxy</em></a> but plots KML for use in Google Earth</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="gmtconnect.html"><em>gmtconnect</em></a></td>
-<td>Connect segments into more complete lines or polygons</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="gmtconvert.html"><em>gmtconvert</em></a></td>
-<td>Convert data tables from one format to another</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="gmtdefaults.html"><em>gmtdefaults</em></a></td>
-<td>List the current default settings</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="gmtget.html"><em>gmtget</em></a></td>
-<td>Retrieve selected parameters in current <tt class="docutils literal"><span class="pre">gmt.conf</span></tt> file</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="gmtinfo.html"><em>gmtinfo</em></a></td>
-<td>Get information about table data files</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="gmtmath.html"><em>gmtmath</em></a></td>
-<td>Mathematical operations on table data</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="gmtselect.html"><em>gmtselect</em></a></td>
-<td>Select subsets of table data based on multiple spatial criteria</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="gmtset.html"><em>gmtset</em></a></td>
-<td>Change selected parameters in current <tt class="docutils literal"><span class="pre">gmt.conf</span></tt> file</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="gmtsimplify.html"><em>gmtsimplify</em></a></td>
-<td>Line reduction using the Douglas-Peucker algorithm</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="gmtspatial.html"><em>gmtspatial</em></a></td>
-<td>Geospatial operations on lines and polygons</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="gmtvector.html"><em>gmtvector</em></a></td>
-<td>Basic operations on vectors in 2-D and 3-D</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="gmtwhich.html"><em>gmtwhich</em></a></td>
-<td>Find full path to specified data files</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="grd2cpt.html"><em>grd2cpt</em></a></td>
-<td>Make color palette table from a grid files</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="grd2rgb.html"><em>grd2rgb</em></a></td>
-<td>Convert Sun raster or grid file to red, green, blue component grids</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="grd2xyz.html"><em>grd2xyz</em></a></td>
-<td>Conversion from 2-D grid file to table data</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="grdblend.html"><em>grdblend</em></a></td>
-<td>Blend several partially over-lapping grid files onto one grid</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="grdclip.html"><em>grdclip</em></a></td>
-<td>Limit the <em>z</em>-range in gridded data sets</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="grdcontour.html"><em>grdcontour</em></a></td>
-<td>Contouring of 2-D gridded data sets</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="grdcut.html"><em>grdcut</em></a></td>
-<td>Cut a sub-region from a grid file</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="grdedit.html"><em>grdedit</em></a></td>
-<td>Modify header information in a 2-D grid file</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="grdfft.html"><em>grdfft</em></a></td>
-<td>Perform operations on grid files in the frequency domain</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="grdfilter.html"><em>grdfilter</em></a></td>
-<td>Filter 2-D gridded data sets in the space domain</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="grdgradient.html"><em>grdgradient</em></a></td>
-<td>Compute directional gradient from grid files</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="grdhisteq.html"><em>grdhisteq</em></a></td>
-<td>Histogram equalization for grid files</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="grdimage.html"><em>grdimage</em></a></td>
-<td>Produce images from 2-D gridded data sets</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="grdinfo.html"><em>grdinfo</em></a></td>
-<td>Get information about grid files</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="grdlandmask.html"><em>grdlandmask</em></a></td>
-<td>Create masking grid files from shoreline data base</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="grdmask.html"><em>grdmask</em></a></td>
-<td>Reset grid nodes in/outside a clip path to constants</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="grdmath.html"><em>grdmath</em></a></td>
-<td>Mathematical operations on grid files</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="grdpaste.html"><em>grdpaste</em></a></td>
-<td>Paste together grid files along a common edge</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="grdproject.html"><em>grdproject</em></a></td>
-<td>Project gridded data sets onto a new coordinate system</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a></td>
-<td>Converts grid files into other grid formats</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="grdsample.html"><em>grdsample</em></a></td>
-<td>Resample a 2-D gridded data set onto a new grid</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="grdtrack.html"><em>grdtrack</em></a></td>
-<td>Sampling of 2-D gridded data set(s) along 1-D track</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="grdtrend.html"><em>grdtrend</em></a></td>
-<td>Fits polynomial trends to grid files</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="grdvector.html"><em>grdvector</em></a></td>
-<td>Plotting of 2-D gridded vector fields</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="grdview.html"><em>grdview</em></a></td>
-<td>3-D perspective imaging of 2-D gridded data sets</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="grdvolume.html"><em>grdvolume</em></a></td>
-<td>Calculate volumes under a surface within specified contour</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="greenspline.html"><em>greenspline</em></a></td>
-<td>Interpolation with Green’s functions for splines in 1–3 D</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="kml2gmt.html"><em>kml2gmt</em></a></td>
-<td>Extracts coordinates from Google Earth KML files</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="makecpt.html"><em>makecpt</em></a></td>
-<td>Make color palette tables</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="mapproject.html"><em>mapproject</em></a></td>
-<td>Transformation of coordinate systems for table data</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="nearneighbor.html"><em>nearneighbor</em></a></td>
-<td>Nearest-neighbor gridding scheme</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="project.html"><em>project</em></a></td>
-<td>Project table data onto lines or great circles</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="ps2raster.html"><em>ps2raster</em></a></td>
-<td>Crop and convert PostScript files to raster images, EPS, and PDF</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="psbasemap.html"><em>psbasemap</em></a></td>
-<td>Create a basemap plot</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="psclip.html"><em>psclip</em></a></td>
-<td>Use polygon files to define clipping paths</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="pscoast.html"><em>pscoast</em></a></td>
-<td>Plot (and fill) coastlines, borders, and rivers on maps</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="pscontour.html"><em>pscontour</em></a></td>
-<td>Contour or image raw table data by triangulation</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="pshistogram.html"><em>pshistogram</em></a></td>
-<td>Plot a histogram</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="psimage.html"><em>psimage</em></a></td>
-<td>Plot Sun raster files on a map</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="pslegend.html"><em>pslegend</em></a></td>
-<td>Plot a legend on a map</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="psmask.html"><em>psmask</em></a></td>
-<td>Create overlay to mask out regions on maps</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="psrose.html"><em>psrose</em></a></td>
-<td>Plot sector or rose diagrams</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="psscale.html"><em>psscale</em></a></td>
-<td>Plot gray scale or color scale on maps</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="pstext.html"><em>pstext</em></a></td>
-<td>Plot text strings on maps</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="pswiggle.html"><em>pswiggle</em></a></td>
-<td>Draw table data time-series along track on maps</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="psxy.html"><em>psxy</em></a></td>
-<td>Plot symbols, polygons, and lines on maps</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="psxyz.html"><em>psxyz</em></a></td>
-<td>Plot symbols, polygons, and lines in 3-D</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="sample1d.html"><em>sample1d</em></a></td>
-<td>Resampling of 1-D table data sets</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="spectrum1d.html"><em>spectrum1d</em></a></td>
-<td>Compute various spectral estimates from time-series</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="sph2grd.html"><em>sph2grd</em></a></td>
-<td>Compute grid from spherical harmonic coefficients</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="sphdistance.html"><em>sphdistance</em></a></td>
-<td>Make grid of distances to nearest points on a sphere</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="sphinterpolate.html"><em>sphinterpolate</em></a></td>
-<td>Spherical gridding in tension of data on a sphere</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="sphtriangulate.html"><em>sphtriangulate</em></a></td>
-<td>Delaunay or Voronoi construction of spherical lon,lat data</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="splitxyz.html"><em>splitxyz</em></a></td>
-<td>Split <em>xyz</em> files into several segments</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="surface.html"><em>surface</em></a></td>
-<td>A continuous curvature gridding algorithm</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="trend1d.html"><em>trend1d</em></a></td>
-<td>Fits polynomial or Fourier trends to <img class="math" src="_images/math/1e5fe94895278bbdc7c2fcef3151fac1b8fa761b.png" alt="y = f(x)"/> series</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="trend2d.html"><em>trend2d</em></a></td>
-<td>Fits polynomial trends to <img class="math" src="_images/math/e4af8dccac00219b863b8d3e54ec16c00b56bab2.png" alt="z = f(x,y)"/> series</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="triangulate.html"><em>triangulate</em></a></td>
-<td>Perform optimal Delauney triangulation and gridding</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="xyz2grd.html"><em>xyz2grd</em></a></td>
-<td>Convert an equidistant table <em>xyz</em> file to a 2-D grid file</td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="gmt-quick-reference">
-<h2>8.2. GMT quick reference<a class="headerlink" href="#gmt-quick-reference" title="Permalink to this headline">¶</a></h2>
-<p>Instead of an alphabetical listing, this section
-contains a summary sorted by program purpose. Also included is a quick
-summary of the standard command line options and a breakdown of the
-<strong>-J</strong> option for each of the over 30 projections available in GMT.</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="25%" />
-<col width="75%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"> </th>
-<th class="head"><em>Filtering of 1-D and 2-D Data</em></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td><a class="reference internal" href="blockmean.html"><em>blockmean</em></a></td>
-<td>L<img class="math" src="_images/math/31ef81fb7b36be5589d39867b7d7e9bbfa764e6a.png" alt="_2"/> (<em>x</em>,<em>y</em>,<em>z</em>) table data filter/decimator</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="blockmedian.html"><em>blockmedian</em></a></td>
-<td>L<img class="math" src="_images/math/2fd8d00206c7d35b6265096bb73a7a057d8ca82d.png" alt="_1"/> (<em>x</em>,<em>y</em>,<em>z</em>) table data filter/decimator</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="blockmode.html"><em>blockmode</em></a></td>
-<td>Mode estimate (<em>x</em>,<em>y</em>,<em>z</em>) table data filter/decimator</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="filter1d.html"><em>filter1d</em></a></td>
-<td>Filter 1-D table data sets (time series)</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="grdfilter.html"><em>grdfilter</em></a></td>
-<td>Filter 2-D gridded data sets in the space domain</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td><em>Plotting of 1-D and 2-D Data</em></td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="grdcontour.html"><em>grdcontour</em></a></td>
-<td>Contouring of 2-D gridded data sets</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="grdimage.html"><em>grdimage</em></a></td>
-<td>Produce images from 2-D gridded data sets</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="grdvector.html"><em>grdvector</em></a></td>
-<td>Plotting of 2-D gridded vector fields</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="grdview.html"><em>grdview</em></a></td>
-<td>3-D perspective imaging of 2-D gridded data sets</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="psbasemap.html"><em>psbasemap</em></a></td>
-<td>Create a basemap plot</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="psclip.html"><em>psclip</em></a></td>
-<td>Use polygon files to define clipping paths</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="pscoast.html"><em>pscoast</em></a></td>
-<td>Plot (and fill) coastlines, borders, and rivers on maps</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="pscontour.html"><em>pscontour</em></a></td>
-<td>Contour or image raw table data by triangulation</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="pshistogram.html"><em>pshistogram</em></a></td>
-<td>Plot a histogram</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="psimage.html"><em>psimage</em></a></td>
-<td>Plot Sun raster files on a map</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="pslegend.html"><em>pslegend</em></a></td>
-<td>Plot a legend on a map</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="psmask.html"><em>psmask</em></a></td>
-<td>Create overlay to mask out regions on maps</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="psrose.html"><em>psrose</em></a></td>
-<td>Plot sector or rose diagrams</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="psscale.html"><em>psscale</em></a></td>
-<td>Plot gray scale or color scale on maps</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="pstext.html"><em>pstext</em></a></td>
-<td>Plot text strings on maps</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="pswiggle.html"><em>pswiggle</em></a></td>
-<td>Draw table data time-series along track on maps</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="psxy.html"><em>psxy</em></a></td>
-<td>Plot symbols, polygons, and lines on maps</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="psxyz.html"><em>psxyz</em></a></td>
-<td>Plot symbols, polygons, and lines in 3-D</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td><em>Gridding of Data Tables</em></td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="greenspline.html"><em>greenspline</em></a></td>
-<td>Interpolation with Green’s functions for splines in 1–3 D</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="nearneighbor.html"><em>nearneighbor</em></a></td>
-<td>Nearest-neighbor gridding scheme</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="sphinterpolate.html"><em>sphinterpolate</em></a></td>
-<td>Spherical gridding in tension of data on a sphere</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="surface.html"><em>surface</em></a></td>
-<td>A continuous curvature gridding algorithm</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="triangulate.html"><em>triangulate</em></a></td>
-<td>Perform optimal Delauney triangulation and gridding</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td><em>Sampling of 1-D and 2-D Data</em></td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="gmtsimplify.html"><em>gmtsimplify</em></a></td>
-<td>Line reduction using the Douglas-Peucker algorithm</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="grdsample.html"><em>grdsample</em></a></td>
-<td>Resample a 2-D gridded data set onto a new grid</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="grdtrack.html"><em>grdtrack</em></a></td>
-<td>Sampling of 2-D gridded data set(s) along 1-D track</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="sample1d.html"><em>sample1d</em></a></td>
-<td>Resampling of 1-D table data sets</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td><em>Projection and Map-transformation</em></td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="grdproject.html"><em>grdproject</em></a></td>
-<td>Project gridded data sets onto a new coordinate system</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="mapproject.html"><em>mapproject</em></a></td>
-<td>Transformation of coordinate systems for table data</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="project.html"><em>project</em></a></td>
-<td>Project table data onto lines or great circles</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td><em>Retrieve Information</em></td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="gmtdefaults.html"><em>gmtdefaults</em></a></td>
-<td>List the current default settings</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="gmtget.html"><em>gmtget</em></a></td>
-<td>Retrieve selected parameters in current file</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="gmtinfo.html"><em>gmtinfo</em></a></td>
-<td>Get information about table data files</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="gmtset.html"><em>gmtset</em></a></td>
-<td>Change selected parameters in current file</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="grdinfo.html"><em>grdinfo</em></a></td>
-<td>Get information about grid files</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td><em>Mathematical Operations on Tables or Grids</em></td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="gmtmath.html"><em>gmtmath</em></a></td>
-<td>Mathematical operations on table data</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="makecpt.html"><em>makecpt</em></a></td>
-<td>Make color palette tables</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="spectrum1d.html"><em>spectrum1d</em></a></td>
-<td>Compute various spectral estimates from time-series</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="sph2grd.html"><em>sph2grd</em></a></td>
-<td>Compute grid from spherical harmonic coefficients</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="sphdistance.html"><em>sphdistance</em></a></td>
-<td>Make grid of distances to nearest points on a sphere</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="sphtriangulate.html"><em>sphtriangulate</em></a></td>
-<td>Delaunay or Voronoi construction of spherical lon,lat data</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td><em>Convert or Extract Subsets of Data</em></td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="gmtconnect.html"><em>gmtconnect</em></a></td>
-<td>Connect segments into more complete lines or polygons</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="gmtconvert.html"><em>gmtconvert</em></a></td>
-<td>Convert data tables from one format to another</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="gmtselect.html"><em>gmtselect</em></a></td>
-<td>Select subsets of table data based on multiple spatial criteria</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="gmtspatial.html"><em>gmtspatial</em></a></td>
-<td>Geospatial operations on lines and polygons</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="gmtvector.html"><em>gmtvector</em></a></td>
-<td>Basic operations on vectors in 2-D and 3-D</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="grd2rgb.html"><em>grd2rgb</em></a></td>
-<td>Convert Sun raster or grid file to red, green, blue component grids</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="grd2xyz.html"><em>grd2xyz</em></a></td>
-<td>Conversion from 2-D grid file to table data</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="grdblend.html"><em>grdblend</em></a></td>
-<td>Blend several partially over-lapping grid files onto one grid</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="grdcut.html"><em>grdcut</em></a></td>
-<td>Cut a sub-region from a grid file</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="grdpaste.html"><em>grdpaste</em></a></td>
-<td>Paste together grid files along a common edge</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a></td>
-<td>Converts grid files into other grid formats</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="splitxyz.html"><em>splitxyz</em></a></td>
-<td>Split <em>xyz</em> files into several segments</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="xyz2grd.html"><em>xyz2grd</em></a></td>
-<td>Convert an equidistant table <em>xyz</em> file to a 2-D grid file</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td><em>Determine Trends in 1-D and 2-D Data</em></td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="fitcircle.html"><em>fitcircle</em></a></td>
-<td>Finds the best-fitting great or small circle for a set of points</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="grdtrack.html"><em>grdtrack</em></a></td>
-<td>Sampling of 2-D gridded data set(s) along 1-D track</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="trend1d.html"><em>trend1d</em></a></td>
-<td>Fits polynomial or Fourier trends to <img class="math" src="_images/math/1e5fe94895278bbdc7c2fcef3151fac1b8fa761b.png" alt="y = f(x)"/> series</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="trend2d.html"><em>trend2d</em></a></td>
-<td>Fits polynomial trends to <img class="math" src="_images/math/e4af8dccac00219b863b8d3e54ec16c00b56bab2.png" alt="z = f(x,y)"/> series</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td><em>Other Operations on 2-D Grids</em></td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="grd2cpt.html"><em>grd2cpt</em></a></td>
-<td>Make color palette table from a grid files</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="grdclip.html"><em>grdclip</em></a></td>
-<td>Limit the <em>z</em>-range in gridded data sets</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="grdedit.html"><em>grdedit</em></a></td>
-<td>Modify header information in a 2-D grid file</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="grdfft.html"><em>grdfft</em></a></td>
-<td>Perform operations on grid files in the frequency domain</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="grdgradient.html"><em>grdgradient</em></a></td>
-<td>Compute directional gradient from grid files</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="grdhisteq.html"><em>grdhisteq</em></a></td>
-<td>Histogram equalization for grid files</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="grdlandmask.html"><em>grdlandmask</em></a></td>
-<td>Create masking grid files from shoreline data base</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="grdmask.html"><em>grdmask</em></a></td>
-<td>Reset grid nodes in/outside a clip path to constants</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="grdmath.html"><em>grdmath</em></a></td>
-<td>Mathematical operations on grid files</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="grdvolume.html"><em>grdvolume</em></a></td>
-<td>Calculate volumes under a surface within specified contour</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td><em>Miscellaneous Tools</em></td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="gmt2kml.html"><em>gmt2kml</em></a></td>
-<td>Like <a class="reference internal" href="psxy.html"><em>psxy</em></a> but plots KML for use in Google Earth</td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="kml2gmt.html"><em>kml2gmt</em></a></td>
-<td>Extracts coordinates from Google Earth KML files</td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="ps2raster.html"><em>ps2raster</em></a></td>
-<td>Crop and convert PostScript files to raster images, EPS, and PDF</td>
-</tr>
-</tbody>
-</table>
-<p>GMT offers 31 map projections. These are specified using the <strong>-J</strong>
-common option. There are two conventions you may use: (a) GMT-style
-syntax and (b) <strong>Proj4</strong>-style syntax. The projection codes for the
-GMT-style are tabulated below.</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="51%" />
-<col width="49%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head" colspan="2"><strong>WITH GMT PROJECTION CODES</strong></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td colspan="2"><strong>-J</strong> (upper case for <em>width</em>, lower case for <em>scale</em>) Map projection</td>
-</tr>
-<tr class="row-odd"><td><strong>-JA</strong>lon<sub>0</sub>/lat<sub>0</sub>[/<em>horizon</em>]/<em>width</em></td>
-<td>Lambert azimuthal equal area</td>
-</tr>
-<tr class="row-even"><td><strong>-JB</strong>lon<sub>0</sub>/lat<sub>0</sub>/lat<sub>1</sub>/lat<sub>2</sub><em>width</em></td>
-<td>Albers conic equal area</td>
-</tr>
-<tr class="row-odd"><td><strong>-JC</strong>lon<sub>0</sub>/lat<sub>0</sub><em>width</em></td>
-<td>Cassini cylindrical</td>
-</tr>
-<tr class="row-even"><td><strong>-JCyl_stere/</strong>[lon<sub>0</sub>[/lat<sub>0</sub>/]]<em>width</em></td>
-<td>Cylindrical stereographic</td>
-</tr>
-<tr class="row-odd"><td><strong>-JD</strong>lon<sub>0</sub>/lat<sub>0</sub>/lat<sub>1</sub>/lat<sub>2</sub><em>width</em></td>
-<td>Equidistant conic</td>
-</tr>
-<tr class="row-even"><td><strong>-JE</strong>lon<sub>0</sub>/lat<sub>0</sub>[/<em>horizon</em>]/<em>width</em></td>
-<td>Azimuthal equidistant</td>
-</tr>
-<tr class="row-odd"><td><strong>-JF</strong>lon<sub>0</sub>/lat<sub>0</sub>[/<em>horizon</em>]/<em>width</em></td>
-<td>Azimuthal gnomonic</td>
-</tr>
-<tr class="row-even"><td><strong>-JG</strong>lon<sub>0</sub>/lat<sub>0</sub>[/<em>horizon</em>]/<em>width</em></td>
-<td>Azimuthal orthographic</td>
-</tr>
-<tr class="row-odd"><td><strong>-JG</strong>lon<sub>0</sub>/lat<sub>0</sub><em>alt</em>/<em>azim</em>/<em>tilt</em>/<em>twist</em>/<em>W</em>/<em>H/width</em></td>
-<td>General perspective</td>
-</tr>
-<tr class="row-even"><td><strong>-JH</strong>lon<sub>0</sub><em>width</em></td>
-<td>Hammer equal area</td>
-</tr>
-<tr class="row-odd"><td><strong>-JI</strong>lon<sub>0</sub><em>width</em></td>
-<td>Sinusoidal equal area</td>
-</tr>
-<tr class="row-even"><td><strong>-JJ</strong>lon<sub>0</sub><em>width</em></td>
-<td>Miller cylindrical</td>
-</tr>
-<tr class="row-odd"><td><strong>-JKf</strong>lon<sub>0</sub><em>width</em></td>
-<td>Eckert IV equal area</td>
-</tr>
-<tr class="row-even"><td><strong>-JKs</strong>lon<sub>0</sub><em>width</em></td>
-<td>Eckert VI equal area</td>
-</tr>
-<tr class="row-odd"><td><strong>-JL</strong>lon<sub>0</sub>/lat<sub>0</sub>/lat<sub>1</sub>/lat<sub>2</sub><em>width</em></td>
-<td>Lambert conic conformal</td>
-</tr>
-<tr class="row-even"><td><strong>-JM</strong>[lon<sub>0</sub>[/lat<sub>0</sub>/]]<em>width</em></td>
-<td>Mercator cylindrical</td>
-</tr>
-<tr class="row-odd"><td><strong>-JN</strong>[lon<sub>0</sub>/]<em>width</em></td>
-<td>Robinson</td>
-</tr>
-<tr class="row-even"><td><strong>-JOa</strong>lon<sub>0</sub>/lat<sub>0</sub><em>azim</em>/<em>width</em></td>
-<td>Oblique Mercator, 1: origin and azimuth</td>
-</tr>
-<tr class="row-odd"><td><strong>-JOb</strong>lon<sub>0</sub>/lat<sub>0</sub>/lon<sub>1</sub>/lat<sub>1</sub><em>width</em></td>
-<td>Oblique Mercator, 2: two points</td>
-</tr>
-<tr class="row-even"><td><strong>-JOc</strong>lon<sub>0</sub>/lat<sub>0</sub>/lon<sub>p</sub>/lat<sub>p</sub><em>width</em></td>
-<td>Oblique Mercator, 3: origin and pole</td>
-</tr>
-<tr class="row-odd"><td><strong>-JP</strong>[<strong>a</strong>]<em>width</em>[/<em>origin</em>]</td>
-<td>Polar [azimuthal] (<img class="math" src="_images/math/2a378fd7cd8686bb483dcc6f4790095409d59cdb.png" alt="\theta, r"/>) (or cylindrical)</td>
-</tr>
-<tr class="row-even"><td><strong>-JPoly</strong>[lon<sub>0</sub>[/lat<sub>0</sub>/]]<em>width</em></td>
-<td>(American) polyconic</td>
-</tr>
-<tr class="row-odd"><td><strong>-JQ</strong>[lon<sub>0</sub>[/lat<sub>0</sub>/]]<em>width</em></td>
-<td>Equidistant cylindrical</td>
-</tr>
-<tr class="row-even"><td><strong>-JR</strong>[lon<sub>0</sub>/]<em>width</em></td>
-<td>Winkel Tripel</td>
-</tr>
-<tr class="row-odd"><td><strong>-JS</strong>lon<sub>0</sub>/lat<sub>0</sub>[/<em>horizon</em>]/<em>width</em></td>
-<td>General stereographic</td>
-</tr>
-<tr class="row-even"><td><strong>-JT</strong>[lon<sub>0</sub>[/lat<sub>0</sub>/]]<em>width</em></td>
-<td>Transverse Mercator</td>
-</tr>
-<tr class="row-odd"><td><strong>-JU</strong><em>zone</em>/<em>width</em></td>
-<td>Universal Transverse Mercator (UTM)</td>
-</tr>
-<tr class="row-even"><td><strong>-JV</strong>[lon<sub>0</sub>/]<em>width</em></td>
-<td>Van der Grinten</td>
-</tr>
-<tr class="row-odd"><td><strong>-JW</strong>[lon<sub>0</sub>/]<em>width</em></td>
-<td>Mollweide</td>
-</tr>
-<tr class="row-even"><td><strong>-JX</strong><em>width</em>[<strong>l</strong>|<strong>p</strong><em>exp</em>|<strong>T</strong>|<strong>t</strong>][/<em>height</em>[<strong>l</strong>|<strong>p</strong><em>exp</em>|<strong>T</strong>|<strong>t</strong>]][<strong>d</strong>]</td>
-<td>Linear, log<img class="math" src="_images/math/70667f5a1cc0894b0fbd9abaf10ad9b13a2f65c1.png" alt="_{10}"/>, <img class="math" src="_images/math/4a95a463cafda90b27a80aa8adeadb5434c1a154.png" alt="x^a-y^b"/>, and time</td>
-</tr>
-<tr class="row-odd"><td><strong>-JY</strong>lon<sub>0</sub>/lat<sub>0</sub><em>width</em></td>
-<td>Cylindrical equal area</td>
-</tr>
-</tbody>
-</table>
-<p>The projection codes for the <strong>Proj4</strong>-style are tabulated below;
-these all accept a map <em>scale</em>.</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="52%" />
-<col width="48%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head" colspan="2"><strong>WITH Proj4 PROJECTION CODES</strong></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td colspan="2"><strong>-J</strong> (lower case for <em>scale</em> only) Map projection</td>
-</tr>
-<tr class="row-odd"><td><strong>-Jaea/</strong>lon<sub>0</sub>/lat<sub>0</sub>/lat<sub>1</sub>/lat<sub>2</sub><em>scale</em></td>
-<td>Albers conic equal area</td>
-</tr>
-<tr class="row-even"><td><strong>-Jaeqd/</strong>lon<sub>0</sub>/lat<sub>0</sub>[/<em>horizon</em>]/<em>scale</em></td>
-<td>Azimuthal equidistant</td>
-</tr>
-<tr class="row-odd"><td><strong>-Jcass/</strong>lon<sub>0</sub>/lat<sub>0</sub><em>scale</em></td>
-<td>Cassini cylindrical</td>
-</tr>
-<tr class="row-even"><td><strong>-Jcea/</strong>lon<sub>0</sub>/lat<sub>0</sub><em>scale</em></td>
-<td>Cylindrical equal area</td>
-</tr>
-<tr class="row-odd"><td><strong>-Jcyl_stere/</strong>[lon<sub>0</sub>[/lat<sub>0</sub>/]]<em>scale</em></td>
-<td>Cylindrical stereographic</td>
-</tr>
-<tr class="row-even"><td><strong>-Jeqc/</strong>[lon<sub>0</sub>[/lat<sub>0</sub>/]]<em>scale</em></td>
-<td>Equidistant cylindrical</td>
-</tr>
-<tr class="row-odd"><td><strong>-Jeqdc/</strong>lon<sub>0</sub>/lat<sub>0</sub>/lat<sub>1</sub>/lat<sub>2</sub><em>scale</em></td>
-<td>Equidistant conic</td>
-</tr>
-<tr class="row-even"><td><strong>-Jgnom/</strong>lon<sub>0</sub>/lat<sub>0</sub>[/<em>horizon</em>]/<em>scale</em></td>
-<td>Azimuthal gnomonic</td>
-</tr>
-<tr class="row-odd"><td><strong>-Jhammer/</strong>lon<sub>0</sub><em>scale</em></td>
-<td>Hammer equal area</td>
-</tr>
-<tr class="row-even"><td><strong>-Jeck4/</strong>lon<sub>0</sub><em>scale</em></td>
-<td>Eckert IV equal area</td>
-</tr>
-<tr class="row-odd"><td><strong>-Jeck6/</strong>lon<sub>0</sub><em>scale</em></td>
-<td>Eckert VI equal area</td>
-</tr>
-<tr class="row-even"><td><strong>-Jlaea/</strong>lon<sub>0</sub>/lat<sub>0</sub>[/<em>horizon</em>]/<em>scale</em></td>
-<td>Lambert azimuthal equal area</td>
-</tr>
-<tr class="row-odd"><td><strong>-Jlcc/</strong>lon<sub>0</sub>/lat<sub>0</sub>/lat<sub>1</sub>/lat<sub>2</sub><em>scale</em></td>
-<td>Lambert conic conformal</td>
-</tr>
-<tr class="row-even"><td><strong>-Jmerc/</strong>[lon<sub>0</sub>[/lat<sub>0</sub>/]]<em>scale</em></td>
-<td>Mercator cylindrical</td>
-</tr>
-<tr class="row-odd"><td><strong>-Jmill/</strong>lon<sub>0</sub><em>scale</em></td>
-<td>Miller cylindrical</td>
-</tr>
-<tr class="row-even"><td><strong>-Jmoll/</strong>[lon<sub>0</sub>/]<em>scale</em></td>
-<td>Mollweide</td>
-</tr>
-<tr class="row-odd"><td><strong>-Jnsper/</strong>lon<sub>0</sub>/lat<sub>0</sub><em>alt/azim/tilt/twist/W/H/scale</em></td>
-<td>General perspective</td>
-</tr>
-<tr class="row-even"><td><strong>-Jomerc/</strong>lon<sub>0</sub>/lat<sub>0</sub><em>azim</em>/<em>scale</em></td>
-<td>Oblique Mercator, 1: origin and azimuth</td>
-</tr>
-<tr class="row-odd"><td><strong>-Jomerc/</strong>lon<sub>0</sub>/lat<sub>0</sub>/lon<sub>1</sub>/lat<sub>1</sub><em>scale</em></td>
-<td>Oblique Mercator, 2: two points</td>
-</tr>
-<tr class="row-even"><td><strong>-Jomercp/</strong>:lon<sub>0</sub>/lat<sub>0</sub>/lon<sub>p</sub>/lat<sub>p</sub><em>scale</em></td>
-<td>Oblique Mercator, 3: origin and pole</td>
-</tr>
-<tr class="row-odd"><td><strong>-Jortho/</strong>lon<sub>0</sub>/lat<sub>0</sub>[/<em>horizon</em>]/<em>scale</em></td>
-<td>Azimuthal orthographic</td>
-</tr>
-<tr class="row-even"><td><strong>-Jpolar/</strong>[<strong>a</strong>]<em>scale</em>[/<em>origin</em>]</td>
-<td>Polar [azimuthal] (<img class="math" src="_images/math/2a378fd7cd8686bb483dcc6f4790095409d59cdb.png" alt="\theta, r"/>) (or cylindrical)</td>
-</tr>
-<tr class="row-odd"><td><strong>-Jpoly/</strong>[lon<sub>0</sub>[/lat<sub>0</sub>/]]<em>scale</em></td>
-<td>(American) polyconic</td>
-</tr>
-<tr class="row-even"><td><strong>-Jrobin/</strong>[lon<sub>0</sub>/]<em>scale</em></td>
-<td>Robinson</td>
-</tr>
-<tr class="row-odd"><td><strong>-Jsinu/</strong>lat<sub>0</sub><em>scale</em></td>
-<td>Sinusoidal equal area</td>
-</tr>
-<tr class="row-even"><td><strong>-Jstere/</strong>lon<sub>0</sub>/lat<sub>0</sub>[/<em>horizon</em>]/<em>scale</em></td>
-<td>General stereographic</td>
-</tr>
-<tr class="row-odd"><td><strong>-Jtmerc/</strong>[lon<sub>0</sub>[/lat<sub>0</sub>/]]<em>scale</em></td>
-<td>Transverse Mercator</td>
-</tr>
-<tr class="row-even"><td><strong>-Jutm/</strong><em>zone</em>/<em>scale</em></td>
-<td>Universal Transverse Mercator (UTM)</td>
-</tr>
-<tr class="row-odd"><td><strong>-Jvandg/</strong>[lon<sub>0</sub>/]<em>scale</em></td>
-<td>Van der Grinten</td>
-</tr>
-<tr class="row-even"><td><strong>-Jwintri/</strong>[lon<sub>0</sub>/]<em>scale</em></td>
-<td>Winkel Tripel</td>
-</tr>
-<tr class="row-odd"><td><strong>-Jxy</strong><em>xscale</em>[<strong>l</strong>|<strong>p</strong><em>exp</em>|<strong>T</strong>|<strong>t</strong>][/<em>yscale</em>[<strong>l</strong>|<strong>p</strong><em>exp</em>|<strong>T</strong>|<strong>t</strong>]][<strong>d</strong>]</td>
-<td>Linear, log<img class="math" src="_images/math/70667f5a1cc0894b0fbd9abaf10ad9b13a2f65c1.png" alt="_{10}"/>, <img class="math" src="_images/math/4a95a463cafda90b27a80aa8adeadb5434c1a154.png" alt="x^a-y^b"/>, and time</td>
-</tr>
-</tbody>
-</table>
-<p>Finally, the rest of the GMT common options are given below:</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="52%" />
-<col width="48%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head" colspan="2"><strong>STANDARDIZED COMMAND LINE OPTIONS</strong></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td><strong>-B</strong><em>information</em></td>
-<td>Specify map frame and axes parameters</td>
-</tr>
-<tr class="row-odd"><td><strong>-K</strong></td>
-<td>Append more PS later</td>
-</tr>
-<tr class="row-even"><td><strong>-O</strong></td>
-<td>This is an overlay plot</td>
-</tr>
-<tr class="row-odd"><td><strong>-P</strong></td>
-<td>Select Portrait orientation</td>
-</tr>
-<tr class="row-even"><td><strong>-R</strong><em>west/east/south/north</em>[<em>/zmin/zmax</em>][<strong>r</strong>]</td>
-<td>Specify Region of interest</td>
-</tr>
-<tr class="row-odd"><td><strong>-U</strong>[[<em>just</em>]/<em>dx</em>/<em>dy</em>/][<em>label</em>]</td>
-<td>Plot time-stamp on plot</td>
-</tr>
-<tr class="row-even"><td><strong>-V</strong></td>
-<td>Run in verbose mode</td>
-</tr>
-<tr class="row-odd"><td><strong>-X</strong>[<strong>a</strong>| <strong>c</strong>| <strong>r</strong>]<em>off</em>[<strong>u</strong>]</td>
-<td>Shift plot origin in <em>x</em>-direction</td>
-</tr>
-<tr class="row-even"><td><strong>-Y</strong>[<strong>a</strong>| <strong>c</strong>| <strong>r</strong>]<em>off</em>[<strong>u</strong>]</td>
-<td>Shift plot origin in <em>y</em>-direction</td>
-</tr>
-<tr class="row-odd"><td><strong>-a</strong><em>name=col,...</em></td>
-<td>Associates aspatial data with columns</td>
-</tr>
-<tr class="row-even"><td><strong>-b</strong>[<strong>i</strong>| <strong>o</strong>][<em>ncol</em>][<strong>t</strong>]</td>
-<td>Select binary input or output</td>
-</tr>
-<tr class="row-odd"><td><strong>-c</strong><em>copies</em></td>
-<td>Set number of plot copies [1]</td>
-</tr>
-<tr class="row-even"><td><strong>-f</strong>[<strong>i</strong>| <strong>o</strong>]<em>colinfo</em></td>
-<td>Set formatting of ASCII input or output</td>
-</tr>
-<tr class="row-odd"><td><strong>-g</strong>[<strong>+</strong>]<strong>x</strong>| <strong>X</strong>| <strong>y</strong>| <strong>Y</strong>| <strong>d</strong>| <strong>D</strong><em>gap</em>[<strong>u</strong>]</td>
-<td>Segment data by detecting gaps</td>
-</tr>
-<tr class="row-even"><td><strong>-h</strong>[<strong>i</strong>| <strong>o</strong>][<em>n_headers</em>]</td>
-<td>ASCII [input| output] tables have header record[s]</td>
-</tr>
-<tr class="row-odd"><td><strong>-i</strong><em>columns</em></td>
-<td>Selection of input columns</td>
-</tr>
-<tr class="row-even"><td><strong>-o</strong><em>columns</em></td>
-<td>Selection of output columns</td>
-</tr>
-<tr class="row-odd"><td><strong>-n</strong>[<em>type</em>][<strong>+a</strong>][<strong>+b</strong><em>BC</em>]
-[<strong>+c</strong>][<strong>+t</strong><em>threshold</em>]</td>
-<td>Set grid interpolation mode</td>
-</tr>
-<tr class="row-even"><td><strong>-p</strong><em>azim/elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0/lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0/y0</em>]</td>
-<td>Control 3-D perspective view</td>
-</tr>
-<tr class="row-odd"><td><strong>-r</strong></td>
-<td>Sets grid registration</td>
-</tr>
-<tr class="row-even"><td><strong>-s</strong>[<strong>z</strong>| <em>cols</em>]</td>
-<td>Control treatment of NaN records</td>
-</tr>
-<tr class="row-odd"><td><strong>-t</strong><em>transparency</em></td>
-<td>Set layer PDF transparency</td>
-</tr>
-<tr class="row-even"><td><strong>-:</strong>[<strong>i</strong>| <strong>o</strong>]</td>
-<td>Expect <em>y</em>/<em>x</em> input rather than <em>x</em>/<em>y</em></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="section" id="general-features">
-<h1>9. General Features<a class="headerlink" href="#general-features" title="Permalink to this headline">¶</a></h1>
-<p>This section explains features common to all the programs in GMT and
-summarizes the philosophy behind the system. Some of the features
-described here may make more sense once you reach the cook-book section
-where we present actual examples of their use.</p>
-<div class="section" id="gmt-units">
-<h2>9.1. GMT units<a class="headerlink" href="#gmt-units" title="Permalink to this headline">¶</a></h2>
-<p>While GMT has default units for both actual Earth distances and plot
-lengths (dimensions) of maps, it is recommended that you specifically
-indicate the units of your arguments by appending the unit character, as
-discussed below. This will aid you in debugging, let others understand your
-scripts, and remove any uncertainty as to what unit you thought you wanted.</p>
-<div class="section" id="distance-units">
-<h3>9.1.1. Distance units<a class="headerlink" href="#distance-units" title="Permalink to this headline">¶</a></h3>
-<table border="1" class="docutils" id="tbl-distunits">
-<colgroup>
-<col width="16%" />
-<col width="35%" />
-<col width="16%" />
-<col width="33%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"> </th>
-<th class="head"> </th>
-<th class="head"> </th>
-<th class="head"> </th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td><strong>d</strong></td>
-<td>Degree of arc</td>
-<td><strong>M</strong></td>
-<td>Statute mile</td>
-</tr>
-<tr class="row-odd"><td><strong>e</strong></td>
-<td>Meter [Default]</td>
-<td><strong>n</strong></td>
-<td>Nautical mile</td>
-</tr>
-<tr class="row-even"><td><strong>f</strong></td>
-<td>Foot</td>
-<td><strong>s</strong></td>
-<td>Second of arc</td>
-</tr>
-<tr class="row-odd"><td><strong>k</strong></td>
-<td>Kilometer</td>
-<td><strong>u</strong></td>
-<td>US Survey foot</td>
-</tr>
-<tr class="row-even"><td><strong>m</strong></td>
-<td>Minute of arc</td>
-<td> </td>
-<td> </td>
-</tr>
-</tbody>
-</table>
-<p>For Cartesian data and scaling the data units do not normally matter
-(they could be kg or Lumens for all we know) and are never entered.
-Geographic data are different as distances can be specified in a variety
-of ways. GMT programs that accept actual Earth length scales like
-search radii or distances can therefore handle a variety of units. These
-choices are listed in Table <a class="reference internal" href="#tbl-distunits"><em>distunits</em></a>; simply append the desired
-unit to the distance value you supply. A value without a unit suffix
-will be consider to be in meters. For example, a distance of 30 nautical
-miles should be given as 30<strong>n</strong>.</p>
-</div>
-<div class="section" id="distance-calculations">
-<h3>9.1.2. Distance calculations<a class="headerlink" href="#distance-calculations" title="Permalink to this headline">¶</a></h3>
-<p>The calculation of distances on Earth (or other planetary bodies)
-depends on the ellipsoidal parameters of the body (via
-<a class="reference internal" href="gmt.conf.html#proj-ellipsoid"><em>PROJ_ELLIPSOID</em></a>) and the method of computation. GMT offers three
-alternatives that trade off accuracy and computation time.</p>
-<div class="section" id="flat-earth-distances">
-<h4>1. Flat Earth distances<a class="headerlink" href="#flat-earth-distances" title="Permalink to this headline">¶</a></h4>
-<p>Quick, but approximate “Flat Earth” calculations make a first-order
-correction for the spherical nature of a planetary body by computing the
-distance between two points A and B as</p>
-<div class="math">
-<p><img src="_images/math/46252e38f851c458622d9a7168b5c70ce0d24ff7.png" alt="d_f = R \sqrt{(\theta_A - \theta_B)^2 + \cos \left [ \frac{\theta_A +
-\theta_B}{2} \right ] \Delta \lambda^2}, \label{eq:flatearth}"/></p>
-</div><p>where <em>R</em> is the representative (or spherical) radius of the
-planet, <img class="math" src="_images/math/a9cfbeb8ebee1f365919e147a79e242dcb67ee5d.png" alt="\theta"/> is latitude, and the difference in longitudes,
-<img class="math" src="_images/math/288021fe133ecee94a15fbfad51a537adc9bc799.png" alt="\Delta \lambda = \lambda_A - \lambda_B"/>, is adjusted for any
-jumps that might occur across Greenwich or the Dateline. As written, the
-geographic coordinates are given in radians. This approach is suitable
-when the points you use to compute <img class="math" src="_images/math/395ab6aba7689ba6e6b4289b0bbbcf2e3fed8887.png" alt="d_f"/> do not greatly differ in
-latitude and computation speed is paramount. You can specify this mode
-of computation by using the <strong>-</strong> prefix to the specified distance (or
-to the unit itself in cases where no distance is required and only a
-unit is expected). For instance, a search radius of 50 statute miles
-using this mode of computation might be specified via <strong>-S-</strong>50<strong>M</strong>.</p>
-</div>
-<div class="section" id="great-circle-distances">
-<h4>1. Great circle distances<a class="headerlink" href="#great-circle-distances" title="Permalink to this headline">¶</a></h4>
-<p>This is the default distance calculation, which will also approximate
-the planetary body by a sphere of mean radius <em>R</em>. However, we
-compute an exact distance between two points A and B on such a sphere
-via the Haversine equation</p>
-<div class="math">
-<p><img src="_images/math/1019740221002dc58daf09a2184f50a7e91b4a38.png" alt="d_g = 2R \sin^{-1} {\sqrt{\sin^2\frac{\theta_A - \theta_B}{2} + \cos
-\theta_A \cos \theta_B \sin^2 \frac{\lambda_A - \lambda_B}{2}} },
-\label{eq:greatcircle}"/></p>
-</div><p>This approach is suitable for most situations unless exact calculations
-for an ellipsoid is required (typically for a limited surface area). For
-instance, a search radius of 5000 feet using this mode of computation
-would be specified as <strong>-S</strong>5000<strong>f</strong>.</p>
-<p>Note: There are two additional
-GMT defaults that control how
-great circle (and Flat Earth) distances are computed. One concerns the
-selection of the “mean radius”. This is selected by
-<a class="reference internal" href="gmt.conf.html#proj-mean-radius"><em>PROJ_MEAN_RADIUS</em></a>, which selects one of several possible
-representative radii. The second is <a class="reference internal" href="gmt.conf.html#proj-aux-latitude"><em>PROJ_AUX_LATITUDE</em></a>, which
-converts geodetic latitudes into one of several possible auxiliary
-latitudes that are better suited for the spherical approximation. While
-both settings have default values to best approximate geodesic distances
-(<em>authalic</em> mean radius and latitudes), expert users can choose from a
-range of options as detailed in the <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> man page.</p>
-</div>
-<div class="section" id="geodesic-distances">
-<h4>1. Geodesic distances<a class="headerlink" href="#geodesic-distances" title="Permalink to this headline">¶</a></h4>
-<p>For the most accurate calculations we use a full ellipsoidal
-formulation. Currently, we are using Vincenty’s [1975] formula <a class="footnote-reference" href="#id54" id="id8">[7]</a>. You
-select this mode of computation by using the <strong>+</strong> prefix to the
-specified distance (or to the unit itself in cases where no distance is
-required). For instance, a search radius of 20 km using this mode of
-computation would be set by <strong>-S+</strong>20<strong>k</strong>.</p>
-</div>
-</div>
-<div class="section" id="length-units">
-<h3>9.1.3. Length units<a class="headerlink" href="#length-units" title="Permalink to this headline">¶</a></h3>
-<p>GMT programs can accept dimensional quantities and plot lengths in
-<strong>c</strong>m, <strong>i</strong>nch, or <strong>p</strong>oint (1/72 of an inch) <a class="footnote-reference" href="#id55" id="id9">[8]</a>. There are
-two ways to ensure that GMT understands which unit you intend to use:</p>
-<ol class="arabic simple">
-<li>Append the desired unit to the dimension you supply. This way is
-explicit and clearly communicates what you intend, e.g.,
-<strong>-X</strong>4<strong>c</strong> means the length being passed to the <strong>-X</strong> switch
-is 4 cm.</li>
-<li>Set the parameter <a class="reference internal" href="gmt.conf.html#proj-length-unit"><em>PROJ_LENGTH_UNIT</em></a> to the desired unit. Then,
-all dimensions without explicit unit will be interpreted accordingly.</li>
-</ol>
-<p>The latter method is less secure as other users may have a different
-unit set and your script may not work as intended. We therefore
-recommend you always supply the desired unit explicitly.</p>
-</div>
-</div>
-<div class="section" id="gmt-defaults">
-<h2>9.2. GMT defaults<a class="headerlink" href="#gmt-defaults" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="overview-and-the-gmt-conf-file">
-<h3>9.2.1. Overview and the gmt.conf file<a class="headerlink" href="#overview-and-the-gmt-conf-file" title="Permalink to this headline">¶</a></h3>
-<p>There are about 100 parameters which can be adjusted individually to
-modify the appearance of plots or affect the manipulation of data. When
-a program is run, it initializes all parameters to the
-GMTdefaults <a class="footnote-reference" href="#id56" id="id10">[9]</a>, then tries to open the file <tt class="docutils literal"><span class="pre">gmt.conf</span></tt> in the current
-directory <a class="footnote-reference" href="#id57" id="id11">[10]</a>. If not found, it will look for that file in a
-sub-directory <tt class="docutils literal"><span class="pre">/.gmt</span></tt> of your home directory, and finally in your home directory
-itself. If successful, the program will read the contents and set the
-default values to those provided in the file. By editing this file you
-can affect features such as pen thicknesses used for maps, fonts and
-font sizes used for annotations and labels, color of the pens,
-dots-per-inch resolution of the hardcopy device, what type of spline
-interpolant to use, and many other choices. A complete list of all the
-parameters and their default values can be found in the
-<a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> manual pages. Figures
-<a class="reference internal" href="#gmt-defaults-a"><em>GMT Parameters a</em></a>,
-<a class="reference internal" href="#gmt-defaults-b"><em>b</em></a>, and
-<a class="reference internal" href="#gmt-defaults-c"><em>c</em></a> show the parameters that affect
-plots. You may create your own <tt class="docutils literal"><span class="pre">gmt.conf</span></tt> files by running
-<a class="reference internal" href="gmtdefaults.html"><em>gmtdefaults</em></a> and then modify those
-parameters you want to change. If you want to use the parameter settings
-in another file you can do so by specifying <tt class="docutils literal"><span class="pre">+<defaultfile></span></tt> on the
-command line. This makes it easy to maintain several distinct parameter
-settings, corresponding perhaps to the unique styles required by
-different journals or simply reflecting font changes necessary to make
-readable overheads and slides. Note that any arguments given on the
-command line (see below) will take precedent over the default values.
-E.g., if your <tt class="docutils literal"><span class="pre">gmt.conf</span></tt> file has <em>x</em> offset = 1<strong>i</strong> as default, the
-<strong>-X</strong>1.5<strong>i</strong> option will override the default and set the offset to 1.5 inches.</p>
-<div class="figure align-center" id="gmt-defaults-a">
-<a class="reference internal image-reference" href="_images/GMT_Defaults_1a.png"><img alt="_images/GMT_Defaults_1a.png" src="_images/GMT_Defaults_1a.png" style="width: 500px;" /></a>
-<p class="caption">Some GMT parameters that affect plot appearance.</p>
-</div>
-<div class="figure align-center" id="gmt-defaults-b">
-<a class="reference internal image-reference" href="_images/GMT_Defaults_1b.png"><img alt="_images/GMT_Defaults_1b.png" src="_images/GMT_Defaults_1b.png" style="width: 500px;" /></a>
-<p class="caption">More GMT parameters that affect plot appearance.</p>
-</div>
-<div class="figure align-center" id="gmt-defaults-c">
-<a class="reference internal image-reference" href="_images/GMT_Defaults_1c.png"><img alt="_images/GMT_Defaults_1c.png" src="_images/GMT_Defaults_1c.png" style="width: 500px;" /></a>
-<p class="caption">Even more GMT parameters that affect plot appearance.</p>
-</div>
-<p>There are at least two good reasons why the GMT default options are
-placed in a separate parameter file:</p>
-<ol class="arabic simple">
-<li>It would not be practical to allow for command-line syntax covering
-so many options, many of which are rarely or never changed (such as
-the ellipsoid used for map projections).</li>
-<li>It is convenient to keep separate <tt class="docutils literal"><span class="pre">gmt.conf</span></tt> files for specific projects, so
-that one may achieve a special effect simply by running
-GMT commands in the directory whose <tt class="docutils literal"><span class="pre">gmt.conf</span></tt> file has the desired settings.
-For example, when making final illustrations for a journal article
-one must often standardize on font sizes and font types, etc. Keeping
-all those settings in a separate <tt class="docutils literal"><span class="pre">gmt.conf</span></tt> file simplifies this process and
-will allow you to generate those illustrations with the same settings
-later on. Likewise, GMT scripts that make figures for PowerPoint
-presentations often use a different color scheme and font size than
-output intended for laser printers. Organizing these various
-scenarios into separate <tt class="docutils literal"><span class="pre">gmt.conf</span></tt> files will minimize headaches associated with
-micro-editing of illustrations.</li>
-</ol>
-</div>
-<div class="section" id="changing-gmt-defaults">
-<h3>9.2.2. Changing GMT defaults<a class="headerlink" href="#changing-gmt-defaults" title="Permalink to this headline">¶</a></h3>
-<p>As mentioned, GMT programs will attempt to open a file named <tt class="docutils literal"><span class="pre">gmt.conf</span></tt>. At
-times it may be desirable to override that default. There are several
-ways in which this can be accomplished.</p>
-<ul>
-<li><p class="first">One method is to start each script by saving a copy of the current <tt class="docutils literal"><span class="pre">gmt.conf</span></tt>,
-then copying the desired <tt class="docutils literal"><span class="pre">gmt.conf</span></tt> file to the current directory, and finally
-reverting the changes at the end of the script. Possible side effects
-include premature ending of the script due to user error or bugs
-which means the final resetting does not take place (unless you write
-your script very carefully.)</p>
-</li>
-<li><p class="first">To permanently change some of the GMT parameters on the fly
-inside a script the <a class="reference internal" href="gmtset.html"><em>gmtset</em></a> utility
-can be used. E.g., to change the primary annotation font to 12 point
-Times-Bold in red we run</p>
-<div class="highlight-bash"><div class="highlight"><pre>gmt gmtset FONT_ANNOT_PRIMARY 12p,Times-Bold,red
-</pre></div>
-</div>
-<p>These changes will remain in effect until they are overridden.</p>
-</li>
-<li><p class="first">If all you want to achieve is to change a few parameters during the
-execution of a single command but otherwise leave the environment
-intact, consider passing the parameter changes on the command line
-via the <strong>-</strong><strong>-</strong><em>PAR=value</em> mechanism. For instance, to temporarily
-set the output format for floating points to have lots of decimals,
-say, for map projection coordinate output, append
-<strong>-</strong><strong>-</strong><a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>=%.16lg to the command in question.</p>
-</li>
-<li><p class="first">Finally, GMT provides to possibility to override the settings only
-during the running of a single script, reverting to the original
-settings after the script is run, as if the script was run in
-“isolation”. The isolation mode is discussed in
-Section <a class="reference internal" href="#running-gmt-in-isolation-mode">Running GMT in isolation mode</a>.</p>
-</li>
-</ul>
-<p>In addition to those parameters that directly affect the plot there are
-numerous parameters than modify units, scales, etc. For a complete
-listing, see the <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> man pages.
-We suggest that you go through all the available parameters at least
-once so that you know what is available to change via one of the
-described mechanisms.</p>
-</div>
-</div>
-<div class="section" id="command-line-arguments">
-<h2>9.3. Command line arguments<a class="headerlink" href="#command-line-arguments" title="Permalink to this headline">¶</a></h2>
-<p>Each program requires certain arguments specific to its operation. These
-are explained in the manual pages and in the usage messages. Most
-programs are “case-sensitive”; almost all options must start with an
-upper-case letter. We have tried to choose letters of the alphabet which
-stand for the argument so that they will be easy to remember. Each
-argument specification begins with a hyphen (except input file names;
-see below), followed by a letter, and sometimes a number or character
-string immediately after the letter. <em>Do not</em> space between the hyphen,
-letter, and number or string. <em>Do</em> space between options. Example:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -R0/20/0/20 -Ggray -JM6i -Wthin -B5 -V -P > map.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="standardized-command-line-options">
-<h2>9.4. Standardized command line options<a class="headerlink" href="#standardized-command-line-options" title="Permalink to this headline">¶</a></h2>
-<p>Most of the programs take many of the same arguments like those related
-to setting the data region, the map projection, etc. The 24 switches in
-Table <a class="reference internal" href="#tbl-switches"><em>switches</em></a> have the same meaning in all the programs (although
-some programs may not use all of them). These options will be described
-here as well as in the manual pages, as is vital that you understand how
-to use these options. We will present these options in order of
-importance (some are use a lot more than others).</p>
-<table border="1" class="docutils" id="tbl-switches">
-<colgroup>
-<col width="13%" />
-<col width="87%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"> </th>
-<th class="head"> </th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td><strong>-B</strong></td>
-<td>Define tickmarks, annotations, and labels for basemaps and axes</td>
-</tr>
-<tr class="row-odd"><td><strong>-J</strong></td>
-<td>Select a map projection or coordinate transformation</td>
-</tr>
-<tr class="row-even"><td><strong>-K</strong></td>
-<td>Allow more plot code to be appended to this plot later</td>
-</tr>
-<tr class="row-odd"><td><strong>-O</strong></td>
-<td>Allow this plot code to be appended to an existing plot</td>
-</tr>
-<tr class="row-even"><td><strong>-P</strong></td>
-<td>Select Portrait plot orientation [Default is landscape]</td>
-</tr>
-<tr class="row-odd"><td><strong>-R</strong></td>
-<td>Define the extent of the map/plot region</td>
-</tr>
-<tr class="row-even"><td><strong>-U</strong></td>
-<td>Plot a time-stamp, by default in the lower left corner of page</td>
-</tr>
-<tr class="row-odd"><td><strong>-V</strong></td>
-<td>Select verbose operation; reporting on progress</td>
-</tr>
-<tr class="row-even"><td><strong>-X</strong></td>
-<td>Set the <em>x</em>-coordinate for the plot origin on the page</td>
-</tr>
-<tr class="row-odd"><td><strong>-Y</strong></td>
-<td>Set the <em>y</em>-coordinate for the plot origin on the page</td>
-</tr>
-<tr class="row-even"><td><strong>-a</strong></td>
-<td>Associate aspatial data from OGR/GMT files with data columns</td>
-</tr>
-<tr class="row-odd"><td><strong>-b</strong></td>
-<td>Select binary input and/or output</td>
-</tr>
-<tr class="row-even"><td><strong>-c</strong></td>
-<td>Specify the number of plot copies</td>
-</tr>
-<tr class="row-odd"><td><strong>-f</strong></td>
-<td>Specify the data format on a per column basis</td>
-</tr>
-<tr class="row-even"><td><strong>-g</strong></td>
-<td>Identify data gaps based on supplied criteria</td>
-</tr>
-<tr class="row-odd"><td><strong>-h</strong></td>
-<td>Specify that input/output tables have header record(s)</td>
-</tr>
-<tr class="row-even"><td><strong>-i</strong></td>
-<td>Specify which input columns to read</td>
-</tr>
-<tr class="row-odd"><td><strong>-n</strong></td>
-<td>Specify grid interpolation settings</td>
-</tr>
-<tr class="row-even"><td><strong>-o</strong></td>
-<td>Specify which output columns to write</td>
-</tr>
-<tr class="row-odd"><td><strong>-p</strong></td>
-<td>Control perspective views for plots</td>
-</tr>
-<tr class="row-even"><td><strong>-r</strong></td>
-<td>Set the grid registration to pixel [Default is gridline]</td>
-</tr>
-<tr class="row-odd"><td><strong>-s</strong></td>
-<td>Control output of records containing one or more NaNs</td>
-</tr>
-<tr class="row-even"><td><strong>-t</strong></td>
-<td>Change layer PDF transparency</td>
-</tr>
-<tr class="row-odd"><td><strong>-:</strong></td>
-<td>Assume input geographic data are (<em>lat,lon</em>) and not (<em>lon,lat</em>)</td>
-</tr>
-</tbody>
-</table>
-<div class="section" id="data-domain-or-map-region-the-r-option">
-<h3>9.4.1. Data domain or map region: The <strong>-R</strong> option<a class="headerlink" href="#data-domain-or-map-region-the-r-option" title="Permalink to this headline">¶</a></h3>
-<p>The <strong>-R</strong> option defines the map region or data domain of interest. It
-may be specified in one of three ways, two of which are shown in Figure
-<a class="reference internal" href="#gmt-region"><em>Map region</em></a>:</p>
-<ol class="arabic simple">
-<li><strong>-R</strong><em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>. This is the standard way to
-specify Cartesian data domains and geographical regions when using
-map projections where meridians and parallels are rectilinear.</li>
-<li><strong>-R</strong><em>xlleft</em>/<em>ylleft</em>/<em>xuright</em>/<em>yuright</em><strong>r</strong>. This form is
-used with map projections that are oblique, making meridians and
-parallels poor choices for map boundaries. Here, we instead specify
-the lower left corner and upper right corner geographic coordinates,
-followed by the suffix <strong>r</strong>. This form guarantees a rectangular map
-even though lines of equal longitude and latitude are not straight lines.</li>
-<li><strong>-R</strong><em>gridfile</em>. This will copy the domain settings found for the
-grid in specified file. Note that depending on the nature of the
-calling program, this mechanism will also set grid spacing and
-possibly the grid registration (see
-Section <a class="reference internal" href="#grid-registration-the-r-option">Grid registration: The -r option</a>).</li>
-</ol>
-<div class="figure align-center" id="gmt-region">
-<a class="reference internal image-reference" href="_images/GMT_-R.png"><img alt="_images/GMT_-R.png" src="_images/GMT_-R.png" style="width: 500px;" /></a>
-<p class="caption">The plot region can be specified in two different ways. (a) Extreme values
-for each dimension, or (b) coordinates of lower left and upper right corners.</p>
-</div>
-<p>For rectilinear projections the first two forms give identical results.
-Depending on the selected map projection (or the kind of expected input
-data), the boundary coordinates may take on several different formats:</p>
-<dl class="docutils">
-<dt>Geographic coordinates:</dt>
-<dd><p class="first">These are longitudes and latitudes and may be given in decimal
-degrees (e.g., -123.45417) or in the
-[]*ddd*[:<em>mm</em>[:<em>ss</em>[<em>.xxx</em>]]][<strong>W</strong>|<strong>E</strong>|<strong>S</strong>|<strong>N</strong>]
-format (e.g., 123:27:15W). Note that <strong>-Rg</strong> and <strong>-Rd</strong> are
-shorthands for “global domain” <strong>-R</strong><em>0</em>/<em>360</em>/<em>-90</em>/<em>90</em> and
-<strong>-R</strong><em>-180</em>/<em>180</em>/<em>-90</em>/<em>90</em>, respectively.</p>
-<p>When used in conjunction with the Cartesian Linear Transformation
-(<strong>-Jx</strong> or <strong>-JX</strong>) —which can be used to map floating point data,
-geographical coordinates, as well as time coordinates— it is prudent
-to indicate that you are using geographical coordinates in one of
-the following ways:</p>
-<ul class="simple">
-<li>Use <strong>-Rg</strong> or <strong>-Rd</strong> to indicate the global domain.</li>
-<li>Use <strong>-Rg</strong><em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em> to indicate a limited
-geographic domain.</li>
-<li>Add <strong>W</strong>, <strong>E</strong>, <strong>S</strong>, or <strong>N</strong> to the coordinate limits or add
-the generic <strong>D</strong> or <strong>G</strong>. Example:
-<strong>-R</strong><em>0</em>/<em>360G</em>/<em>-90</em>/<em>90N</em>.</li>
-</ul>
-<p class="last">Alternatively, you may indicate geographical coordinates by
-supplying <strong>-fg</strong>; see Section <a class="reference internal" href="#data-type-selection-the-f-option">Data type selection: The -f option</a>.</p>
-</dd>
-<dt>Projected coordinates:</dt>
-<dd>These are Cartesian projected coordinates compatible with the chosen
-projection and are given with a leading length <em>unit</em>, (e.g.,
-<strong>k</strong>-200/200/-300/300 for a 400 by 600 km rectangular area centered
-on the projection center (0, 0). These coordinates are internally
-converted to the corresponding geographic (longitude, latitude)
-coordinates for the lower left and upper right corners. This form is
-convenient when you want to specify a region directly in the
-projected units (e.g., UTM meters). For allowable units, see
-Table <a class="reference internal" href="#tbl-distunits"><em>distunits</em></a>.</dd>
-<dt>Calendar time coordinates:</dt>
-<dd><p class="first">These are absolute time coordinates referring to a Gregorian or ISO
-calendar. The general format is [<em>date</em>]<strong>T</strong>[<em>clock</em>],
-where <em>date</em> must be in the <em>yyyy</em>[<em>-mm</em>[<em>-dd</em>]] (year, month,
-day-of-month) or <em>yyyy</em>[<em>-jjj</em>] (year and day-of-year) for
-Gregorian calendars and <em>yyyy</em>[<em>-</em><strong>W</strong><em>ww</em>[<em>-d</em>]] (year,
-week, and day-of-week) for the ISO calendar. If no <em>date</em> is given
-we assume the current day. The <strong>T</strong> flag is required if a <em>clock</em> is given.</p>
-<p class="last">The optional <em>clock</em> string is a 24-hour clock in
-<em>hh</em>[<em>:mm</em>[<em>:ss</em>[<em>.xxx</em>]]] format. If no <em>clock</em> is given it
-implies 00:00:00, i.e., the start of the specified day. Note that
-not all of the specified entities need be present in the data. All
-calendar date-clock strings are internally represented as double
-precision seconds since proleptic Gregorian date Monday January 1
-00:00:00 0001. Proleptic means we assume that the modern calendar
-can be extrapolated forward and backward; a year zero is used, and
-Gregory’s reforms <a class="footnote-reference" href="#id58" id="id12">[11]</a> are extrapolated backward. Note that this is
-not historical.</p>
-</dd>
-<dt>Relative time coordinates:</dt>
-<dd>These are coordinates which count seconds, hours, days or years
-relative to a given epoch. A combination of the parameters
-<a class="reference internal" href="gmt.conf.html#time-epoch"><em>TIME_EPOCH</em></a> and <a class="reference internal" href="gmt.conf.html#time-unit"><em>TIME_UNIT</em></a> define the epoch and time unit.
-The parameter <a class="reference internal" href="gmt.conf.html#time-system"><em>TIME_SYSTEM</em></a> provides a few shorthands for common
-combinations of epoch and unit, like <strong>j2000</strong> for days since noon
-of 1 Jan 2000. The default relative time coordinate is that of UNIX
-computers: seconds since 1 Jan 1970. Denote relative time
-coordinates by appending the optional lower case <strong>t</strong> after the
-value. When it is otherwise apparent that the coordinate is relative
-time (for example by using the <strong>-f</strong> switch), the <strong>t</strong> can be omitted.</dd>
-<dt>Other coordinates:</dt>
-<dd>These are simply any coordinates that are not related to geographic
-or calendar time or relative time and are expected to be simple
-floating point values such as
-[]<em>xxx.xxx</em>[E: | e| D| d[]xx], i.e.,
-regular or exponential notations, with the enhancement to understand
-FORTRAN double precision output which may use D instead of E for
-exponents. These values are simply converted as they are to internal
-representation. <a class="footnote-reference" href="#id59" id="id13">[12]</a></dd>
-</dl>
-</div>
-<div class="section" id="coordinate-transformations-and-map-projections-the-j-option">
-<h3>9.4.2. Coordinate transformations and map projections: The <strong>-J</strong> option<a class="headerlink" href="#coordinate-transformations-and-map-projections-the-j-option" title="Permalink to this headline">¶</a></h3>
-<p>This option selects the coordinate transformation or map projection. The
-general format is</p>
-<ul class="simple">
-<li><strong>-J</strong><img class="math" src="_images/math/b35a9439ad8c8657b1b1d792ad5c2d77a52c0aef.png" alt="\delta"/>[<em>parameters</em>/]<em>scale</em>. Here, <img class="math" src="_images/math/b35a9439ad8c8657b1b1d792ad5c2d77a52c0aef.png" alt="\delta"/>
-is a <em>lower-case</em> letter of the alphabet that selects a particular
-map projection, the <em>parameters</em> is zero or more slash-delimited
-projection parameter, and <em>scale</em> is map scale given in distance
-units per degree or as 1:xxxxx.</li>
-<li><strong>-J</strong><img class="math" src="_images/math/296ab33356160c5a5d59477d3e898f58888f0bdb.png" alt="\Delta"/>[<em>parameters</em>/]<em>width</em>. Here, <img class="math" src="_images/math/296ab33356160c5a5d59477d3e898f58888f0bdb.png" alt="\Delta"/>
-is an <em>upper-case</em> letter of the alphabet that selects a particular
-map projection, the <em>parameters</em> is zero or more slash-delimited
-projection parameter, and <em>width</em> is map width (map height is
-automatically computed from the implied map scale and region).</li>
-</ul>
-<p>Since GMT version 4.3.0, there is an alternative way to specify the
-projections: use the same abbreviation as in the mapping package
-<strong>Proj4</strong>. The options thus either look like:</p>
-<ul class="simple">
-<li><strong>-J</strong><em>abbrev</em>/[<em>parameters</em>/]<em>scale</em>. Here, <strong>abbrev</strong> is a
-<em>lower-case</em> abbreviation that selects a particular map projection,
-the <em>parameters</em> is zero or more slash-delimited projection
-parameter, and <em>scale</em> is map scale given in distance units per
-degree or as 1:xxxxx.</li>
-<li><strong>-J</strong><em>Abbrev</em>/[<em>parameters</em>/]<em>width</em>. Here, <strong>Abbrev</strong> is an
-<em>capitalized</em> abbreviation that selects a particular map projection,
-the <em>parameters</em> is zero or more slash-delimited projection
-parameter, and <em>width</em> is map width (map height is automatically
-computed from the implied map scale and region).</li>
-</ul>
-<p>The projections available in GMT are presented in Figure
-<a class="reference internal" href="#gmt-projections"><em>The 30+ map projections and coordinate transformations available in GMT</em></a>. For details on all GMT projections and the required
-parameters, see the <a class="reference internal" href="psbasemap.html"><em>psbasemap</em></a> man page. We will also show examples of
-every projection in the next Chapters, and a quick summary of projection
-syntax was given in Chapter <cite>GMT overview and quick reference</cite>.</p>
-<div class="figure align-center" id="gmt-projections">
-<a class="reference internal image-reference" href="_images/GMT_-J.png"><img alt="_images/GMT_-J.png" src="_images/GMT_-J.png" style="width: 500px;" /></a>
-<p class="caption">The 30+ map projections and coordinate transformations available in GMT</p>
-</div>
-</div>
-<div class="section" id="map-frame-and-axes-annotations-the-b-option">
-<h3>9.4.3. Map frame and axes annotations: The <strong>-B</strong> option<a class="headerlink" href="#map-frame-and-axes-annotations-the-b-option" title="Permalink to this headline">¶</a></h3>
-<p>This is potentially the most complicated option in GMT,
-but most examples of its usage are actually quite simple. We distinguish
-between to sets of information: Frame settings and Axes parameters. These
-are set separately by their own <strong>-B</strong> invocations; hence multiple <strong>-B</strong>
-specifications may be specified. The frame settings covers things such
-as which axes should be plotted, canvas fill, plot title, and what type
-of gridlines be drawn, whereas the Axes settings deal with annotation,
-tick, and gridline intervals, axes labels, and annotation units.</p>
-<p>The Frame settings are specified by</p>
-<ul class="simple">
-<li><strong>-B</strong>[<em>axes</em>][<strong>+b</strong>][<strong>+g</strong><em>fill</em>][<strong>+o</strong><em>lon/lat</em>][<strong>+t</strong><em>title</em>]</li>
-</ul>
-<p>Here, the optional <em>axes</em> dictates which of the axes should be drawn
-and possibly annotated. By default, all 4 map boundaries (or plot axes)
-are plotted (denoted <strong>W</strong>, <strong>E</strong>, <strong>S</strong>, <strong>N</strong>). To change this selection,
-append the codes for those you want (e.g., <strong>WSn</strong>). In this example,
-the lower case <strong>n</strong> denotes to draw the axis and (major and minor) tick
-marks on the “northern” (top) edge of the plot. The upper case <strong>WS</strong> will
-annotate the “western” and “southern” axes with numerals and plot the
-any axis labels in addition to draw axis/tick-marks. For 3-D plots you can
-also specify <strong>Z</strong> or <strong>z</strong>. By default a single vertical axes will then be
-plotted at the most suitable map corner. You can override this by appending
-any combination of corner ids <strong>1234</strong>, where <strong>1</strong> represents the lower left
-corner and the order goes counter-clockwise. Append <strong>+b</strong> to draw the outline
-of the 3-D box defined by <strong>-R</strong>; this modifier is also needed to display
-gridlines in the x–z, y–z planes. You may paint the
-map canvas by appending the <strong>+g</strong><em>fill</em> modifier [Default is no fill].
-If gridlines are specified via the Axes parameters (discussed below) then
-by default these are referenced to the North pole. If, however, you wish
-to produce oblique gridlines about another pole you can append <strong>+o</strong><em>lon/lat</em>
-to change this behavior (the modifier is ignored if no gridlines are requested).
-Finally, you may optionally add <strong>+t</strong><em>title</em> to place a title that
-will appear centered above the plot frame.</p>
-<p>The Axes settings are specified by</p>
-<ul class="simple">
-<li><strong>-B</strong>[<strong>p</strong>|<strong>s</strong>][<strong>x</strong>|<strong>x</strong>|<strong>z</strong>]<em>intervals</em>[<strong>+l</strong><em>label</em>][<strong>+p</strong><em>prefix</em>][<strong>+u</strong><em>unit</em>]</li>
-</ul>
-<p>but you may also split this into two separate invocations for clarity, i.e.,</p>
-<ul class="simple">
-<li><strong>-B</strong>[<strong>p</strong>|<strong>s</strong>][<strong>x</strong>|<strong>y</strong>|<strong>z</strong>][<strong>+l</strong><em>label</em>][<strong>+p</strong><em>prefix</em>][<strong>+u</strong><em>unit</em>]</li>
-<li><strong>-B</strong>[<strong>p</strong>|<strong>s</strong>][<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>intervals</em></li>
-</ul>
-<p>The first optional flag following <strong>-B</strong> selects <strong>p</strong> (rimary) [Default] or
-<strong>s</strong> (econdary) axes information (which is mostly used for time axes
-annotations; see examples below). The next optional flags specifies which
-axes you are providing information for. This can be an individual axis
-(e.g., just <strong>x</strong>) or a combination (e.g., <strong>xz</strong>). If none are given then
-we default to <strong>xy</strong>. Thus, if you wish to give different annotation intervals
-or labels for the various axes then you must repeat the <strong>B</strong> option for
-each axis. To add a label to an axis, just append <strong>+l</strong><em>label</em>. If the
-axis annotation should have a leading text prefix (e.g., dollar sign for those
-plots of your net worth) you can append <strong>+p</strong><em>prefix</em>. For geographic maps
-the addition of degree symbols, etc. is automatic (and controlled by the GMT
-default setting <a class="reference internal" href="gmt.conf.html#format-geo-map"><em>FORMAT_GEO_MAP</em></a>). However, for other plots you can add
-specific units by adding <strong>+u</strong><em>unit</em>. If any of these text strings contain
-spaces or special UNIX characters you will need to enclose them in quotes.
-The <em>intervals</em> specification is a concatenated string made up of substrings of the form</p>
-<p>[<strong>t</strong>]<em>stride</em>[<em>phase</em>][<strong>u</strong>].</p>
-<p>The <strong>t</strong> flag sets the axis
-item of interest; the available items are listed in Table <a class="reference internal" href="#tbl-inttype"><em>inttype</em></a>.
-Normally, equidistant annotations occur at multiples of <em>stride</em>; you
-can phase-shift this by appending <em>phase</em>, which can be a positive or
-negative number.</p>
-<table border="1" class="docutils" id="tbl-inttype">
-<colgroup>
-<col width="24%" />
-<col width="76%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"><strong>Flag</strong></th>
-<th class="head"><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td><strong>a</strong></td>
-<td>Annotation and major tick spacing</td>
-</tr>
-<tr class="row-odd"><td><strong>f</strong></td>
-<td>Minor tick spacing</td>
-</tr>
-<tr class="row-even"><td><strong>g</strong></td>
-<td>Grid line spacing</td>
-</tr>
-</tbody>
-</table>
-<p>Note that the appearance of certain time annotations (month-, week-, and
-day-names) may be affected by the <a class="reference internal" href="gmt.conf.html#time-language"><em>TIME_LANGUAGE</em></a>,
-<a class="reference internal" href="gmt.conf.html#format-time-primary-map"><em>FORMAT_TIME_PRIMARY_MAP</em></a>, and
-<a class="reference internal" href="gmt.conf.html#format-time-secondary-map"><em>FORMAT_TIME_SECONDARY_MAP</em></a> settings.</p>
-<p>For automated plots the region may not always be the same and thus it
-can be difficult to determine the appropriate <em>stride</em> in advance. Here
-GMT provides the opportunity to autoselect the spacing between the
-major and minor ticks and the grid lines, by not specifying the <em>stride</em>
-value. For example, <strong>-Bafg</strong> will select all three spacings
-automatically for both axes. In case of longitude–latitude plots, this
-will keep the spacing the same on both axes. You can also use
-<strong>-Bafg/afg</strong> to autoselect them separately.</p>
-<p>In the case of automatic spacing, when the <em>stride</em> argument is omitted
-after <strong>g</strong>, the grid line spacing is chosen the same as the minor tick
-spacing; unless <strong>g</strong> is used in consort with <strong>a</strong>, then the grid lines
-are spaced the same as the annotations.</p>
-<p>The unit flag <strong>u</strong> can take on one of 18 codes; these are listed in
-Table <a class="reference internal" href="#tbl-units"><em>units</em></a>. Almost all of these units are time-axis specific.
-However, the <strong>m</strong> and <strong>s</strong> units will be interpreted as arc minutes
-and arc seconds, respectively, when a map projection is in effect.</p>
-<table border="1" class="docutils" id="tbl-units">
-<colgroup>
-<col width="12%" />
-<col width="17%" />
-<col width="71%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"><strong>Flag</strong></th>
-<th class="head"><strong>Unit</strong></th>
-<th class="head"><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td><strong>Y</strong></td>
-<td>year</td>
-<td>Plot using all 4 digits</td>
-</tr>
-<tr class="row-odd"><td><strong>y</strong></td>
-<td>year</td>
-<td>Plot using last 2 digits</td>
-</tr>
-<tr class="row-even"><td><strong>O</strong></td>
-<td>month</td>
-<td>Format annotation using <strong>FORMAT_DATE_MAP</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>o</strong></td>
-<td>month</td>
-<td>Plot as 2-digit integer (1–12)</td>
-</tr>
-<tr class="row-even"><td><strong>U</strong></td>
-<td>ISO week</td>
-<td>Format annotation using <strong>FORMAT_DATE_MAP</strong></td>
-</tr>
-<tr class="row-odd"><td><strong>u</strong></td>
-<td>ISO week</td>
-<td>Plot as 2-digit integer (1–53)</td>
-</tr>
-<tr class="row-even"><td><strong>r</strong></td>
-<td>Gregorian week</td>
-<td>7-day stride from start of week (see <strong>TIME_WEEK_START</strong>)</td>
-</tr>
-<tr class="row-odd"><td><strong>K</strong></td>
-<td>ISO weekday</td>
-<td>Plot name of weekday in selected language</td>
-</tr>
-<tr class="row-even"><td><strong>k</strong></td>
-<td>weekday</td>
-<td>Plot number of day in the week (1–7) (see <strong>TIME_WEEK_START</strong>)</td>
-</tr>
-<tr class="row-odd"><td><strong>D</strong></td>
-<td>date</td>
-<td>Format annotation using <strong>FORMAT_DATE_MAP</strong></td>
-</tr>
-<tr class="row-even"><td><strong>d</strong></td>
-<td>day</td>
-<td>Plot day of month (1–31) or day of year (1–366)</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>(see <strong>FORMAT_DATE_MAP</strong></td>
-</tr>
-<tr class="row-even"><td><strong>R</strong></td>
-<td>day</td>
-<td>Same as <strong>d</strong>; annotations aligned with week (see <strong>TIME_WEEK_START</strong>)</td>
-</tr>
-<tr class="row-odd"><td><strong>H</strong></td>
-<td>hour</td>
-<td>Format annotation using <strong>FORMAT_CLOCK_MAP</strong></td>
-</tr>
-<tr class="row-even"><td><strong>h</strong></td>
-<td>hour</td>
-<td>Plot as 2-digit integer (0–24)</td>
-</tr>
-<tr class="row-odd"><td><strong>M</strong></td>
-<td>minute</td>
-<td>Format annotation using <strong>FORMAT_CLOCK_MAP</strong></td>
-</tr>
-<tr class="row-even"><td><strong>m</strong></td>
-<td>minute</td>
-<td>Plot as 2-digit integer (0–60)</td>
-</tr>
-<tr class="row-odd"><td><strong>S</strong></td>
-<td>seconds</td>
-<td>Format annotation using <strong>FORMAT_CLOCK_MAP</strong></td>
-</tr>
-<tr class="row-even"><td><strong>s</strong></td>
-<td>seconds</td>
-<td>Plot as 2-digit integer (0–60)</td>
-</tr>
-</tbody>
-</table>
-<p>As mentioned, there may be two levels of annotations. Here, “primary” refers to the
-annotation that is closest to the axis (this is the primary annotation),
-while “secondary” refers to the secondary annotation that is plotted
-further from the axis. The examples below will clarify what is meant.
-Note that the terms “primary” and “secondary” do not reflect any
-hierarchical order of units: The “primary” annotation interval is
-usually smaller (e.g., days) while the “secondary” annotation interval
-typically is larger (e.g., months).</p>
-<div class="section" id="geographic-basemaps">
-<h4>1. Geographic basemaps<a class="headerlink" href="#geographic-basemaps" title="Permalink to this headline">¶</a></h4>
-<p>Geographic basemaps may differ from regular plot axis in that some
-projections support a “fancy” form of axis and is selected by the
-<a class="reference internal" href="gmt.conf.html#map-frame-type"><em>MAP_FRAME_TYPE</em></a> setting. The annotations will be formatted
-according to the <a class="reference internal" href="gmt.conf.html#format-geo-map"><em>FORMAT_GEO_MAP</em></a> template and
-<a class="reference internal" href="gmt.conf.html#map-degree-symbol"><em>MAP_DEGREE_SYMBOL</em></a> setting. A simple example of part of a basemap
-is shown in Figure <a class="reference internal" href="#basemap-border"><em>Geographic map border</em></a>.</p>
-<div class="figure align-center" id="basemap-border">
-<a class="reference internal image-reference" href="_images/GMT_-B_geo_1.png"><img alt="_images/GMT_-B_geo_1.png" src="_images/GMT_-B_geo_1.png" style="width: 500px;" /></a>
-<p class="caption">Geographic map border using separate selections for annotation,
-frame, and grid intervals. Formatting of the annotation is controlled by
-the parameter <a class="reference internal" href="gmt.conf.html#format-geo-map"><em>FORMAT_GEO_MAP</em></a> in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>.</p>
-</div>
-<p>The machinery for primary and secondary annotations introduced for
-time-series axes can also be utilized for geographic basemaps. This may
-be used to separate degree annotations from minutes- and
-seconds-annotations. For a more complicated basemap example using
-several sets of intervals, including different intervals and pen
-attributes for grid lines and grid crosses, see Figure <a class="reference internal" href="#complex-basemap"><em>Complex basemap</em></a>.</p>
-<div class="figure align-center" id="complex-basemap">
-<a class="reference internal image-reference" href="_images/GMT_-B_geo_2.png"><img alt="_images/GMT_-B_geo_2.png" src="_images/GMT_-B_geo_2.png" style="width: 500px;" /></a>
-<p class="caption">Geographic map border with both primary (P) and secondary (S) components.</p>
-</div>
-</div>
-<div class="section" id="cartesian-linear-axes">
-<h4>1. Cartesian linear axes<a class="headerlink" href="#cartesian-linear-axes" title="Permalink to this headline">¶</a></h4>
-<p>For non-geographic axes, the <a class="reference internal" href="gmt.conf.html#map-frame-type"><em>MAP_FRAME_TYPE</em></a> setting is implicitly
-set to plain. Other than that, cartesian linear axes are very similar to
-geographic axes. The annotation format may be controlled with the
-<a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> parameter. By default, it is set to “%g”, which
-is a C language format statement for floating point numbers <a class="footnote-reference" href="#id60" id="id14">[13]</a>, and
-with this setting the various axis routines will automatically determine
-how many decimal points should be used by inspecting the <em>stride</em>
-settings. If <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> is set to another format it will be
-used directly (.e.g, “%.2f” for a fixed, two decimals format). Note that
-for these axes you may use the <em>unit</em> setting to add a unit string to
-each annotation (see Figure <a class="reference internal" href="#axis-label-basemap"><em>Axis label</em></a>).</p>
-<div class="figure align-center" id="axis-label-basemap">
-<a class="reference internal image-reference" href="_images/GMT_-B_linear.png"><img alt="_images/GMT_-B_linear.png" src="_images/GMT_-B_linear.png" style="width: 500px;" /></a>
-<p class="caption">Linear Cartesian projection axis. Long tickmarks accompany
-annotations, shorter ticks indicate frame interval. The axis label is
-optional. For this example we used <tt class="docutils literal"><span class="pre">-R0/12/0/0.95</span> <span class="pre">-JX3i/0.3i</span> <span class="pre">-Ba4f2g1+lFrequency+u"</span> <span class="pre">%"</span> <span class="pre">-BS</span></tt></p>
-</div>
-</div>
-<div class="section" id="cartesian-log10-axes">
-<h4>1. Cartesian log<sub>10</sub> axes<a class="headerlink" href="#cartesian-log10-axes" title="Permalink to this headline">¶</a></h4>
-<p>Due to the logarithmic nature of annotation spacings, the <em>stride</em>
-parameter takes on specific meanings. The following concerns are
-specific to log axes (see Figure <a class="reference internal" href="#log-projection"><em>Logarithmic projection axis</em></a>):</p>
-<ul class="simple">
-<li><em>stride</em> must be 1, 2, 3, or a negative integer -n.
-Annotations/ticks will then occur at 1, 1-2-5, or 1,2,3,4,...,9,
-respectively, for each magnitude range. For <em>-n</em> the
-annotations will take place every <em>n</em>‘th magnitude.</li>
-<li>Append <strong>l</strong> to <em>stride</em>. Then, log<sub>10</sub> of the annotation
-is plotted at every integer log<sub>10</sub> value (e.g.,
-<em>x = 100</em> will be annotated as “2”) [Default annotates <em>x</em> as is].</li>
-<li>Append <strong>p</strong> to <em>stride</em>. Then, annotations appear as 10 raised to
-log<sub>10</sub> of the value (e.g., 10<sup>-5</sup>).</li>
-</ul>
-<div class="figure align-center" id="log-projection">
-<a class="reference internal image-reference" href="_images/GMT_-B_log.png"><img alt="_images/GMT_-B_log.png" src="_images/GMT_-B_log.png" style="width: 500px;" /></a>
-<p class="caption">Logarithmic projection axis using separate values for annotation,
-frame, and grid intervals. (top) Here, we have chosen to annotate the actual
-values. Interval = 1 means every whole power of 10, 2 means 1, 2, 5 times
-powers of 10, and 3 means every 0.1 times powers of 10. We used
--R1/1000/0/1 -JX3il/0.25i -Ba1f2g3. (middle) Here, we have chosen to
-annotate <img class="math" src="_images/math/195374909526226d6dd908206784056573e69009.png" alt="\log_{10}"/> of the actual values, with -Ba1f2g3l.
-(bottom) We annotate every power of 10 using <img class="math" src="_images/math/195374909526226d6dd908206784056573e69009.png" alt="\log_{10}"/> of the actual
-values as exponents, with -Ba1f2g3p.</p>
-</div>
-</div>
-<div class="section" id="cartesian-exponential-axes">
-<h4>1. Cartesian exponential axes<a class="headerlink" href="#cartesian-exponential-axes" title="Permalink to this headline">¶</a></h4>
-<p>Normally, <em>stride</em> will be used to create equidistant (in the user’s
-unit) annotations or ticks, but because of the exponential nature of the
-axis, such annotations may converge on each other at one end of the
-axis. To avoid this problem, you can append <strong>p</strong> to <em>stride</em>, and the
-annotation interval is expected to be in transformed units, yet the
-annotation itself will be plotted as un-transformed units (see Figure
-<a class="reference internal" href="#pow-projection"><em>Power projection axis</em></a>). E.g., if
-<em>stride</em> = 1 and power = 0.5 (i.e., sqrt), then equidistant annotations
-labeled 1, 4, 9, ... will appear.</p>
-<div class="figure align-center" id="pow-projection">
-<a class="reference internal image-reference" href="_images/GMT_-B_pow.png"><img alt="_images/GMT_-B_pow.png" src="_images/GMT_-B_pow.png" style="width: 500px;" /></a>
-<p class="caption">Exponential or power projection axis. (top) Using an exponent of 0.5
-yields a <img class="math" src="_images/math/014c6fe6e6a7f82a9e18633f9b981d8ffe99306a.png" alt="sqrt(x)"/> axis. Here, intervals refer to actual data values,
-in -R0/100/0/0.9 -JX3ip0.5/0.25i -Ba20f10g5.
-(bottom) Here, intervals refer to projected values, although the annotation
-uses the corresponding unprojected values, as in -Ba3f2g1p.</p>
-</div>
-</div>
-<div class="section" id="cartesian-time-axes">
-<h4>1. Cartesian time axes<a class="headerlink" href="#cartesian-time-axes" title="Permalink to this headline">¶</a></h4>
-<p>What sets time axis apart from the other kinds of plot axes is the
-numerous ways in which we may want to tick and annotate the axis. Not
-only do we have both primary and secondary annotation items but we also
-have interval annotations versus tickmark annotations, numerous time
-units, and several ways in which to modify the plot. We will demonstrate
-this flexibility with a series of examples. While all our examples will
-only show a single <em>x</em>-axis (south, selected via <strong>-BS</strong>), time-axis
-annotations are supported for all axes.</p>
-<p>Our first example shows a time period of almost two months in Spring
-2000. We want to annotate the month intervals as well as the date at the start of each week:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt <span class="nb">set </span><span class="nv">FORMAT_DATE_MAP</span><span class="o">=</span>-o FONT_ANNOT_PRIMARY +9p
-gmt psbasemap -R2000-4-1T/2000-5-25T/0/1 -JX5i/0.2i -Bpa7Rf1d -Bsa1O -BS -P > GMT_-B_time1.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>These commands result in Figure <a class="reference internal" href="#cartesian-axis1"><em>Cartesian time axis</em></a>.
-Note the leading hyphen in the <a class="reference internal" href="gmt.conf.html#format-date-map"><em>FORMAT_DATE_MAP</em></a>
-removes leading zeros from calendar items (e.g., 02 becomes 2).</p>
-<div class="figure align-center" id="cartesian-axis1">
-<a class="reference internal image-reference" href="_images/GMT_-B_time1.png"><img alt="_images/GMT_-B_time1.png" src="_images/GMT_-B_time1.png" style="width: 500px;" /></a>
-<p class="caption">Cartesian time axis, example 1</p>
-</div>
-<p>The next example shows two different ways to annotate an axis portraying 2 days in July 1969:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt <span class="nb">set </span>FORMAT_DATE_MAP <span class="s2">"o dd"</span> FORMAT_CLOCK_MAP hh:mm FONT_ANNOT_PRIMARY +9p
-gmt psbasemap -R1969-7-21T/1969-7-23T/0/1 -JX5i/0.2i -Bpa6Hf1h -Bsa1K -BS -P -K > GMT_-B_time2.ps
-gmt psbasemap -R -J -Bpa6Hf1h -Bsa1D -BS -O -Y0.65i >> GMT_-B_time2.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>The lower example (Figure <a class="reference internal" href="#cartesian-axis2"><em>Cartesian time axis, example 2</em></a>) chooses to annotate the weekdays (by
-specifying <strong>a</strong>1<strong>K</strong>) while the upper example choses dates (by
-specifying <strong>a</strong>1<strong>D</strong>). Note how the clock format only selects
-hours and minutes (no seconds) and the date format selects a month name,
-followed by one space and a two-digit day-of-month number.</p>
-<div class="figure align-center" id="cartesian-axis2">
-<a class="reference internal image-reference" href="_images/GMT_-B_time2.png"><img alt="_images/GMT_-B_time2.png" src="_images/GMT_-B_time2.png" style="width: 500px;" /></a>
-<p class="caption">Cartesian time axis, example 2</p>
-</div>
-<p>The third example (Figure <a class="reference internal" href="#cartesian-axis3"><em>Cartesian time axis, example 3</em></a>) presents two years, annotating
-both the years and every 3rd month.</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt <span class="nb">set </span>FORMAT_DATE_MAP o FORMAT_TIME_PRIMARY_MAP Character FONT_ANNOT_PRIMARY +9p
-gmt psbasemap -R1997T/1999T/0/1 -JX5i/0.2i -Bpa3Of1o -Bsa1Y -BS -P > GMT_-B_time3.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>Note that while the year annotation is centered on the 1-year interval,
-the month annotations must be centered on the corresponding month and
-<em>not</em> the 3-month interval. The <a class="reference internal" href="gmt.conf.html#format-date-map"><em>FORMAT_DATE_MAP</em></a> selects month name
-only and <a class="reference internal" href="gmt.conf.html#format-time-primary-map"><em>FORMAT_TIME_PRIMARY_MAP</em></a> selects the 1-character, upper
-case abbreviation of month names using the current language (selected by
-<a class="reference internal" href="gmt.conf.html#time-language"><em>TIME_LANGUAGE</em></a>).</p>
-<div class="figure align-center" id="cartesian-axis3">
-<a class="reference internal image-reference" href="_images/GMT_-B_time3.png"><img alt="_images/GMT_-B_time3.png" src="_images/GMT_-B_time3.png" style="width: 500px;" /></a>
-<p class="caption">Cartesian time axis, example 3</p>
-</div>
-<p>The fourth example (Figure <a class="reference internal" href="#cartesian-axis4"><em>Cartesian time axis, example 4</em></a>) only shows a few hours of a day, using
-relative time by specifying <strong>t</strong> in the <strong>-R</strong> option while the
-<a class="reference internal" href="gmt.conf.html#time-unit"><em>TIME_UNIT</em></a> is <strong>d</strong> (for days). We select both primary and secondary
-annotations, ask for a 12-hour clock, and let time go from right to left:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt <span class="nb">set </span><span class="nv">FORMAT_CLOCK_MAP</span><span class="o">=</span>-hham FONT_ANNOT_PRIMARY +9p
-gmt psbasemap -R0.2t/0.35t/0/1 -JX-5i/0.2i -Bpa15mf5m -Bsa1H -BS -P > GMT_-B_time4.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center" id="cartesian-axis4">
-<a class="reference internal image-reference" href="_images/GMT_-B_time4.png"><img alt="_images/GMT_-B_time4.png" src="_images/GMT_-B_time4.png" style="width: 500px;" /></a>
-<p class="caption">Cartesian time axis, example 4</p>
-</div>
-<p>The fifth example shows a few weeks of time (Figure <a class="reference internal" href="#cartesian-axis5"><em>Cartesian time axis, example 5</em></a>). The lower axis
-shows ISO weeks with week numbers and abbreviated names of the weekdays.
-The upper uses Gregorian weeks (which start at the day chosen by
-<a class="reference internal" href="gmt.conf.html#time-week-start"><em>TIME_WEEK_START</em></a>); they do not have numbers.</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt <span class="nb">set </span>FORMAT_DATE_MAP u FORMAT_TIME_PRIMARY_MAP Character <span class="se">\</span>
- FORMAT_TIME_SECONDARY_MAP full FONT_ANNOT_PRIMARY +9p
-gmt psbasemap -R1969-7-21T/1969-8-9T/0/1 -JX5i/0.2i -Bpa1K -Bsa1U -BS -P -K > GMT_-B_time5.ps
-gmt <span class="nb">set </span>FORMAT_DATE_MAP o TIME_WEEK_START Sunday FORMAT_TIME_SECONDARY_MAP Chararacter
-gmt psbasemap -R -J -Bpa3Kf1k -Bsa1r -BS -O -Y0.65i >> GMT_-B_time5.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center" id="cartesian-axis5">
-<a class="reference internal image-reference" href="_images/GMT_-B_time5.png"><img alt="_images/GMT_-B_time5.png" src="_images/GMT_-B_time5.png" style="width: 500px;" /></a>
-<p class="caption">Cartesian time axis, example 5</p>
-</div>
-<p>Our sixth example (Figure <a class="reference internal" href="#cartesian-axis6"><em>Cartesian time axis, example 6</em></a>) shows the first five months of
-1996, and we have annotated each month with an abbreviated, upper case name and
-2-digit year. Only the primary axes information is specified.</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt <span class="nb">set </span>FORMAT_DATE_MAP <span class="s2">"o yy"</span> FORMAT_TIME_PRIMARY_MAP Abbreviated
-gmt psbasemap -R1996T/1996-6T/0/1 -JX5i/0.2i -Ba1Of1d -BS -P > GMT_-B_time6.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center" id="cartesian-axis6">
-<a class="reference internal image-reference" href="_images/GMT_-B_time6.png"><img alt="_images/GMT_-B_time6.png" src="_images/GMT_-B_time6.png" style="width: 500px;" /></a>
-<p class="caption">Cartesian time axis, example 6</p>
-</div>
-<p>Our seventh and final example (Figure <a class="reference internal" href="#cartesian-axis7"><em>Cartesian time axis, example 7</em></a>) illustrates
-annotation of year-days. Unless we specify the formatting with a leading hyphen
-in <a class="reference internal" href="gmt.conf.html#format-date-map"><em>FORMAT_DATE_MAP</em></a> we get 3-digit integer days. Note that
-in order to have the two years annotated we need to allow for the annotation of
-small fractional intervals; normally such truncated interval must be at
-least half of a full interval.</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt <span class="nb">set </span>FORMAT_DATE_MAP jjj TIME_INTERVAL_FRACTION 0.05 FONT_ANNOT_PRIMARY +9p
-gmt psbasemap -R2000-12-15T/2001-1-15T/0/1 -JX5i/0.2i -Bpa5Df1d -Bsa1Y -BS -P > GMT_-B_time7.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center" id="cartesian-axis7">
-<a class="reference internal image-reference" href="_images/GMT_-B_time7.png"><img alt="_images/GMT_-B_time7.png" src="_images/GMT_-B_time7.png" style="width: 500px;" /></a>
-<p class="caption">Cartesian time axis, example 7</p>
-</div>
-</div>
-<div class="section" id="custom-axes">
-<h4>1. Custom axes<a class="headerlink" href="#custom-axes" title="Permalink to this headline">¶</a></h4>
-<p>Irregularly spaced annotations or annotations based on
-look-up tables can be implemented using the <em>custom</em> annotation
-mechanism. Here, we given the <strong>c</strong> (custom) type to the <strong>-B</strong> option
-followed by a filename that contains the annotations (and
-tick/grid-lines specifications) for one axis. The file can contain any
-number of comments (lines starting with #) and any number of records of
-the format</p>
-<div class="line-block">
-<div class="line"><em>coord</em> <em>type</em> [<em>label</em>]</div>
-</div>
-<p>The <em>coord</em> is the location of the desired annotation, tick, or
-grid-line, whereas <em>type</em> is a string composed of letters from <strong>a</strong>
-(annotation), <strong>i</strong> interval annotation, <strong>f</strong> frame tick, and <strong>g</strong>
-gridline. You must use either <strong>a</strong> or <strong>i</strong> within one file; no mixing
-is allowed. The coordinates should be arranged in increasing order. If
-<em>label</em> is given it replaces the normal annotation based on the <em>coord</em>
-value. Our last example (Figure <a class="reference internal" href="#custom-annotations"><em>Custom and irregular annotations</em></a>) shows such a custom basemap with an interval
-annotations on the <em>x</em>-axis and irregular annotations on the <em>y</em>-axis.</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>cat <span class="s"><< EOF > xannots.txt</span>
-<span class="s">416.0 ig Devonian</span>
-<span class="s">443.7 ig Silurian</span>
-<span class="s">488.3 ig Ordovician</span>
-<span class="s">542 ig Cambrian</span>
-<span class="s">EOF</span>
-cat <span class="s"><< EOF > yannots.txt</span>
-<span class="s">0 a</span>
-<span class="s">1 a</span>
-<span class="s">2 f</span>
-<span class="s">2.71828 ag e</span>
-<span class="s">3 f</span>
-<span class="s">3.1415926 ag @~p@~</span>
-<span class="s">4 f</span>
-<span class="s">5 f</span>
-<span class="s">6 f</span>
-<span class="s">6.2831852 ag 2@~p@~</span>
-<span class="s">EOF</span>
-gmt psbasemap -R416/542/0/6.2831852 -JX-5i/2.5i -Bpx25f5g25+u<span class="s2">" Ma"</span> -Bpycyannots.txt <span class="se">\</span>
- -BWS+glightblue -P -K > GMT_-B_custom.ps
-gmt psbasemap -R416/542/0/6.2831852 -JX-5i/2.5i -Bsxcxannots.txt -BWS -O <span class="se">\</span>
- --MAP_ANNOT_OFFSET_SECONDARY<span class="o">=</span>10p --MAP_GRID_PEN_SECONDARY<span class="o">=</span>2p >> GMT_-B_custom.ps
-rm -f <span class="o">[</span>xy<span class="o">]</span>annots.txt
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center" id="custom-annotations">
-<a class="reference internal image-reference" href="_images/GMT_-B_custom.png"><img alt="_images/GMT_-B_custom.png" src="_images/GMT_-B_custom.png" style="width: 500px;" /></a>
-<p class="caption">Custom and irregular annotations, tick-marks, and gridlines.</p>
-</div>
-</div>
-</div>
-<div class="section" id="portrait-plot-orientation-the-p-option">
-<h3>9.4.4. Portrait plot orientation: The <strong>-P</strong> option<a class="headerlink" href="#portrait-plot-orientation-the-p-option" title="Permalink to this headline">¶</a></h3>
-<p>The <strong>-P</strong> option selects Portrait plotting mode <a class="footnote-reference" href="#id61" id="id15">[14]</a>. In general, a
-plot has an <em>x</em>-axis increasing from left to right and a <em>y</em>-axis
-increasing from bottom to top. If the paper is turned so that the long
-dimension of the paper is parallel to the <em>x</em>-axis then the plot is said
-to have <em>Landscape</em> orientation. If the long dimension of the paper
-parallels the <em>y</em>-axis the orientation is called <em>Portrait</em> (think of
-taking pictures with a camera and these words make sense). The default
-Landscape orientation is obtained by translating the origin in the
-<em>x</em>-direction (by the width of the chosen paper <a class="reference internal" href="gmt.conf.html#ps-media"><em>PS_MEDIA</em></a>) and then
-rotating the coordinate system counterclockwise by 90. By default the
-<a class="reference internal" href="gmt.conf.html#ps-media"><em>PS_MEDIA</em></a> is set to Letter (or A4 if SI is chosen); this value must
-be changed when using different media, such as 11” x 17” or large format
-plotters (Figure <a class="reference internal" href="#p-option"><em>Plot orientation</em></a>).</p>
-<div class="figure align-center" id="p-option">
-<a class="reference internal image-reference" href="_images/GMT_-P.png"><img alt="_images/GMT_-P.png" src="_images/GMT_-P.png" style="width: 500px;" /></a>
-<p class="caption">Users can specify Landscape [Default] or Portrait -P) orientation.</p>
-</div>
-</div>
-<div class="section" id="plot-overlays-the-k-o-options">
-<h3>9.4.5. Plot overlays: The <strong>-K</strong> <strong>-O</strong> options<a class="headerlink" href="#plot-overlays-the-k-o-options" title="Permalink to this headline">¶</a></h3>
-<p>The <strong>-K</strong> and <strong>-O</strong> options control the generation of
-PostScript code for multiple overlay plots. All PostScript files
-must have a header (for initializations), a body (drawing the figure),
-and a trailer (printing it out) (see Figure <a class="reference internal" href="#ok-options"><em>Multiple overlay plots</em></a>). Thus, when overlaying
-several GMT plots we must make sure that the first plot call omits the
-trailer, that all intermediate calls omit both header and trailer, and
-that the final overlay omits the header. The <strong>-K</strong> omits the trailer
-which implies that more PostScript code will be appended later
-[Default terminates the plot system]. The <strong>-O</strong> selects Overlay plot
-mode and omits the header information [Default initializes a new plot
-system]. Most unexpected results for multiple overlay plots can be
-traced to the incorrect use of these options. If you run only one plot
-program, ignore both the <strong>-O</strong> and <strong>-K</strong> options; they are only used
-when stacking plots.</p>
-<div class="figure align-center" id="ok-options">
-<a class="reference internal image-reference" href="_images/GMT_-OK.png"><img alt="_images/GMT_-OK.png" src="_images/GMT_-OK.png" style="width: 500px;" /></a>
-<p class="caption">A final PostScript file consists of any number of individual pieces.</p>
-</div>
-</div>
-<div class="section" id="timestamps-on-plots-the-u-option">
-<h3>9.4.6. Timestamps on plots: The <strong>-U</strong> option<a class="headerlink" href="#timestamps-on-plots-the-u-option" title="Permalink to this headline">¶</a></h3>
-<p>The <strong>-U</strong> option draws UNIX System time stamp. Optionally, append an
-arbitrary text string (surrounded by double quotes), or the code <strong>c</strong>,
-which will plot the current command string (Figure
-<a class="reference internal" href="#u-option"><em>Time stamp</em></a>).</p>
-<div class="figure align-center" id="u-option">
-<a class="reference internal image-reference" href="_images/GMT_-U.png"><img alt="_images/GMT_-U.png" src="_images/GMT_-U.png" style="width: 500px;" /></a>
-<p class="caption">The -U option makes it easy to date a plot.</p>
-</div>
-</div>
-<div class="section" id="verbose-feedback-the-v-option">
-<h3>9.4.7. Verbose feedback: The <strong>-V</strong> option<a class="headerlink" href="#verbose-feedback-the-v-option" title="Permalink to this headline">¶</a></h3>
-<p>The <strong>-V</strong> option selects verbose mode, which will send
-progress reports to standard error. Even more verbose levels are <strong>-Vl</strong>
-(long verbose) and <strong>-Vd</strong> (debug). Normal verbosity level produces only
-error and warning messages. This is the default or can be selected by
-using <strong>-Vn</strong>. If compiled with backward-compatibility support, the
-default is <strong>-Vc</strong>, which includes warnings about deprecated usage.
-Finally, <strong>-Vq</strong> can be used to run without any warnings or errors. This
-option can also be set by specifying the default <a class="reference internal" href="gmt.conf.html#gmt-verbose"><em>GMT_VERBOSE</em></a>, as
-<strong>quiet</strong>, <strong>normal</strong>, <strong>compat</strong>, <strong>verbose</strong>, <strong>long_verbose</strong>, or
-<strong>debug</strong>, in order of increased verbosity.</p>
-</div>
-<div class="section" id="plot-positioning-and-layout-the-x-y-options">
-<h3>9.4.8. Plot positioning and layout: The <strong>-X</strong> <strong>-Y</strong> options<a class="headerlink" href="#plot-positioning-and-layout-the-x-y-options" title="Permalink to this headline">¶</a></h3>
-<p>The <strong>-X</strong> and <strong>-Y</strong> options shift origin of plot by (<em>xoff</em>,<em>yoff</em>)
-inches (Default is (<a class="reference internal" href="gmt.conf.html#map-origin-x"><em>MAP_ORIGIN_X</em></a>, <a class="reference internal" href="gmt.conf.html#map-origin-y"><em>MAP_ORIGIN_Y</em></a>) for new
-plots <a class="footnote-reference" href="#id62" id="id16">[15]</a> and (0,0) for overlays (<strong>-O</strong>)). By default, all
-translations are relative to the previous origin (see Figure
-<a class="reference internal" href="#xy-options"><em>Plot positioning</em></a>). Supply
-offset as <strong>c</strong> to center the plot in that direction relative to the
-page margin. Absolute translations (i.e., relative to a fixed point
-(0,0) at the lower left corner of the paper) can be achieve by
-prepending “a” to the offsets. Subsequent overlays will be co-registered
-with the previous plot unless the origin is shifted using these options.
-The offsets are measured in the current coordinates system (which can be
-rotated using the initial <strong>-P</strong> option; subsequent <strong>-P</strong> options for
-overlays are ignored).</p>
-<div class="figure align-center" id="xy-options">
-<a class="reference internal image-reference" href="_images/GMT_-XY.png"><img alt="_images/GMT_-XY.png" src="_images/GMT_-XY.png" style="width: 300px;" /></a>
-<p class="caption">Plot origin can be translated freely with -X -Y.</p>
-</div>
-</div>
-<div class="section" id="ogr-gmt-gis-i-o-the-a-option">
-<h3>9.4.9. OGR/GMT GIS i/o: The <strong>-a</strong> option<a class="headerlink" href="#ogr-gmt-gis-i-o-the-a-option" title="Permalink to this headline">¶</a></h3>
-<p>GMT relies on external tools to translate geospatial files such as
-shapefiles into a format we can read. The tool <strong>ogr2ogr</strong> in the GDAL
-package can do such translations and preserve the aspatial metadata via
-a new OGR/GMT format specification (See Appendix <a class="reference internal" href="#p-the-gmt-vector-data-format-for-ogr-compatibility">P. The GMT Vector Data Format for OGR Compatibility</a>).
-For this to be useful we need a mechanism to associate certain metadata values with
-required input and output columns expected by GMT programs. The <strong>-a</strong>
-option allows you to supply one or more comma-separated associations
-<em>col=name</em>, where <em>name</em> is the name of an aspatial attribute field in a
-OGR/GMT file and whose value we wish to as data input for column <em>col</em>.
-The given aspatial field thus replaces any other value already set. Note
-that <em>col = 0</em> is the first data columns. Note that if no aspatial
-attributes are needed then the <strong>-a</strong> option is not needed – GMT will
-still process and read such data files.</p>
-<div class="section" id="ogr-gmt-input-with-a-option">
-<h4>1. OGR/GMT input with <strong>-a</strong> option<a class="headerlink" href="#ogr-gmt-input-with-a-option" title="Permalink to this headline">¶</a></h4>
-<p>If you need to populate GMT data columns with (constant) values
-specified by aspatial attributes, use <strong>-a</strong> and append any number of
-comma-separated <em>col=name</em> associations. E.g., <em>2=depth</em> will read the
-spatial <em>x,y</em> columns from the file and add a third (<em>z</em>) column based
-on the value of the aspatial field called <em>depth</em>. You can also
-associate aspatial fields with other settings such as labels, fill
-colors, pens, and values used to look-up colors. Do so by letting the
-<em>col</em> value be one of <strong>D</strong>, <strong>G</strong>, <strong>L</strong>, <strong>T</strong>, <strong>W</strong>, or <strong>Z</strong>. This
-works analogously to how standard multi-segment files can pass such
-options via its segment headers (See Appendix <a class="reference internal" href="#b-gmt-file-formats">B. GMT file formats</a>).</p>
-</div>
-<div class="section" id="ogr-gmt-output-with-a-option">
-<h4>1. OGR/GMT output with <strong>-a</strong> option<a class="headerlink" href="#ogr-gmt-output-with-a-option" title="Permalink to this headline">¶</a></h4>
-<p>You can also make GMT table-writing tools output the OGR/GMT format
-directly. Again, specify if certain GMT data columns with constant
-values should be stored as aspatial metadata using the
-<em>col=name</em>[:<em>type</em>], where you can optionally specify what data type
-it should be (double, integer, string, logical, byte, or datetime)
-[double is default]. As for input, you can also use the special <em>col</em>
-entries of <strong>D</strong>, <strong>G</strong>, <strong>L</strong>, <strong>T</strong>, <strong>W</strong>, or <strong>Z</strong> to have values
-stored as options in segment headers be used as the source for the name
-aspatial field. Finally, for output you must append
-+<strong>g</strong><em>geometry</em>, where <em>geometry</em> can be any of
-[<strong>M</strong>]<strong>POINT</strong>|<strong>LINE</strong>|<strong>POLY</strong>; the
-<strong>M</strong> represent the multi-versions of these three geometries. Use
-upper-case +<strong>G</strong> to signal that you want to split any line or polygon
-features that straddle the Dateline.</p>
-</div>
-</div>
-<div class="section" id="binary-table-i-o-the-b-option">
-<h3>9.4.10. Binary table i/o: The <strong>-b</strong> option<a class="headerlink" href="#binary-table-i-o-the-b-option" title="Permalink to this headline">¶</a></h3>
-<p>All GMT programs that accept table data input may read ASCII, native
-binary, or netCDF data. Native binary files may have a header section
-and the <strong>-h</strong><em>n</em> option (see Section <a class="reference internal" href="#header-data-records-the-h-option">Header data records: The -h option</a>) can be used to
-skip the first <em>n</em> bytes. The data record can be in any format, mixing
-different data types and even containing byte-swapped items. When using
-native binary data the user must be aware of the fact that GMT has no
-way of determining the actual number of columns in the file. You must
-therefore pass that information to GMT via the binary
-<strong>-bi</strong> option, where <em>n</em> is the actual number of data
-columns and <strong>t</strong> must be one of <strong>c</strong> (signed 1-byte character,
-int8_t), <strong>u</strong> (unsigned 1-byte character, uint8_t), <strong>h</strong> (signed
-2-byte int, int16_t), <strong>H</strong> (unsigned 2-byte int, uint16_t), <strong>i</strong>
-(signed 4-byte int, int32_t), <strong>I</strong> (unsigned 4-byte int, uint32_t),
-<strong>l</strong> (signed 8-byte int, int64_t), <strong>L</strong> (unsigned 8-byte int,
-uint64_t), <strong>f</strong> (4-byte single-precision float), and <strong>d</strong> (8-byte
-double-precision float). In addition, use <strong>x</strong> to skip <em>n</em> bytes
-anywhere in the record. For a mixed-type data record you can concatenate
-several [<em>n</em>]<strong>t</strong> combinations, separated by commas. You may append
-<strong>w</strong> to any of the items to force byte-swapping. Alternatively, append
-<strong>+L</strong>|<strong>B</strong> to indicate that the entire data file should be
-read or written as little- or big-endian, respectively. Here, <em>n</em> is the
-number of each item in your binary file. Note that <em>n</em> may be larger
-than <em>m</em>, the number of columns that the GMT program requires to do
-its task. If <em>n</em> is not given then it defaults to <em>m</em> and all columns
-are assumed to be of the single specified type <strong>t</strong> [<strong>d</strong> (double), if
-not set]. If <em>n</em> < <em>m</em> an error is generated. Multiple segment
-files are allowed and the segment headers are assumed to be records
-where all the fields equal NaN.</p>
-<p>For binary output, use the <strong>-bo</strong> option; see <strong>-bi</strong> for further details.</p>
-<p>Because of its meta data, reading netCDF tables (i.e., netCDF files
-containing 1-dimensional arrays) is quite a bit less complex than
-reading native binary files. When feeding netCDF tables to programs like
-<a class="reference internal" href="psxy.html"><em>psxy</em></a>, the program will automatically
-recognize the format and read whatever amount of columns are needed for
-that program. To steer which columns are to be read, the user can append
-the suffix <strong>?</strong><em>var1</em><strong>/</strong><em>var2</em><strong>/</strong><em>...</em> to the netCDF file
-name, where <em>var1</em>, <em>var2</em>, etc. are the names of the variables to be
-processed. No <strong>-bi</strong> option is needed in this case.</p>
-<p>Currently, netCDF tables can only be input, not output. For more
-information, see Appendix [app:B].</p>
-</div>
-<div class="section" id="number-of-copies-the-c-option">
-<h3>9.4.11. Number of Copies: The <strong>-c</strong> option<a class="headerlink" href="#number-of-copies-the-c-option" title="Permalink to this headline">¶</a></h3>
-<p>The <strong>-c</strong> option specifies the number of plot copies [Default is 1].
-This value is embedded in the PostScript file and will make a printer
-issue the chosen number of copies without respooling.</p>
-</div>
-<div class="section" id="data-type-selection-the-f-option">
-<h3>9.4.12. Data type selection: The <strong>-f</strong> option<a class="headerlink" href="#data-type-selection-the-f-option" title="Permalink to this headline">¶</a></h3>
-<p>When map projections are not required we must explicitly state what kind
-of data each input or output column contains. This is accomplished with
-the <strong>-f</strong> option. Following an optional <strong>i</strong> (for input only) or <strong>o</strong>
-(for output only), we append a text string with information about each
-column (or range of columns) separated by commas. Each string starts
-with the column number (0 is first column) followed by either <strong>x</strong>
-(longitude), <strong>y</strong> (latitude), <strong>T</strong> (absolute calendar time) or <strong>t</strong>
-(relative time). If several consecutive columns have the same format you
-may specify a range of columns rather than a single column, i.e., 0–4
-for the first 5 columns. For example, if our input file has geographic
-coordinates (latitude, longitude) with absolute calendar coordinates in
-the columns 3 and 4, we would specify
-<strong>fi</strong>0<strong>y</strong>,1<strong>x</strong>,3–4<strong>T</strong>. All other columns are assumed to
-have the default, floating point format and need not be set
-individually. The shorthand <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<strong>g</strong>
-means <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]0x,1y (i.e., geographic
-coordinates). A special use of <strong>-f</strong> is to select <strong>-fp</strong>[<em>unit</em>],
-which <em>requires</em> <strong>-J</strong> and lets you use <em>projected</em> map coordinates
-(e.g., UTM meters) as data input. Such coordinates are automatically
-inverted to longitude, latitude during the data import. Optionally,
-append a length <em>unit</em> (see Table <a class="reference internal" href="#tbl-distunits"><em>distunits</em></a>) [meter]. For more
-information, see Sections <a class="reference internal" href="#input-data-formats">Input data formats</a> and <a class="reference internal" href="#output-data-formats">Output data formats</a>.</p>
-</div>
-<div class="section" id="data-gap-detection-the-g-option">
-<h3>9.4.13. Data gap detection: The <strong>-g</strong> option<a class="headerlink" href="#data-gap-detection-the-g-option" title="Permalink to this headline">¶</a></h3>
-<p>GMT has several mechanisms that can determine line
-segmentation. Typically, data segments are separated by multiple segment
-header records (see Appendix <a class="reference internal" href="#b-gmt-file-formats">B. GMT file formats</a>). However, if key data columns contain a
-NaN we may also use that information to break lines into multiple
-segments. This behavior is modified by the parameter
-<strong>IO_NAN_RECORDS</strong> which by default is set to <em>skip</em>, meaning such
-records are considered bad and simply skipped. If you wish such records
-to indicate a segment boundary then set this parameter to <em>pass</em>.
-Finally, you may wish to indicate gaps based on the data values
-themselves. The <strong>-g</strong> option is used to detect gaps based on one or
-more criteria (use <strong>-g+</strong> if <em>all</em> the criteria must be met; otherwise
-only one of the specified criteria needs to be met to signify a data
-gap). Gaps can be based on excessive jumps in the <em>x</em>- or
-<em>y</em>-coordinates (<strong>-gx</strong> or <strong>-gy</strong>), or on the distance between points
-(<strong>-gd</strong>). Append the <em>gap</em> distance and optionally a unit for actual
-distances. For geographic data the optional unit may be arc
-<strong>d</strong>egree, <strong>m</strong>inute, and <strong>s</strong>econd, or m<strong>e</strong>ter
-[Default], <strong>f</strong>eet, <strong>k</strong>ilometer, <strong>M</strong>iles, or <strong>n</strong>autical
-miles. For programs that map data to map coordinates you can optionally
-specify these criteria to apply to the projected coordinates (by using
-upper-case <strong>-gX</strong>, <strong>-gY</strong> or <strong>-gD</strong>). In that case, choose from
-<strong>c</strong>entimeter, <strong>i</strong>nch or <strong>p</strong>oint [Default unit is controlled
-by <strong>PROJ_LENGTH_UNIT</strong>]. Note: For <strong>-gx</strong> or <strong>-gy</strong> with time data
-the unit is instead controlled by <a class="reference internal" href="gmt.conf.html#time-unit"><em>TIME_UNIT</em></a>.</p>
-</div>
-<div class="section" id="header-data-records-the-h-option">
-<h3>9.4.14. Header data records: The <strong>-h</strong> option<a class="headerlink" href="#header-data-records-the-h-option" title="Permalink to this headline">¶</a></h3>
-<p>The <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n_recs</em>] option
-lets GMT know that input file(s) have <em>n_recs</em> header records [0]. If
-there are more than one header record you must specify the number after
-the <strong>-h</strong> option, e.g., <strong>-h</strong>4. Note that blank lines and records
-that start with the character # are automatically considered header
-records and skipped. Thus, <em>n_recs</em> refers to general text lines that
-do <em>not</em> start with # and thus must specifically be skipped in order for
-the programs to function properly. The default number of such header
-records if <strong>-h</strong> is used is one of the many parameters in the <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file
-(<strong>IO_N_HEADER_RECS</strong>, by default 0), but can be overridden by
-<strong>-h</strong><em>n_header_recs</em>. Normally, programs that both read and write
-tables will output the header records that are found on input. Use
-<strong>-hi</strong> to suppress the writing of header records. You can use the
-<strong>-h</strong> options modifiers to to tell programs to output extra header
-records for titles, remarks or column names identifying each data column.</p>
-<p>When <strong>-b</strong> is used to indicate binary data the <strong>-h</strong> takes on a
-slightly different meaning. Now, the <em>n_recs</em> argument is taken to mean
-how many <em>bytes</em> should be skipped (on input) or padded with the space
-character (on output).</p>
-</div>
-<div class="section" id="input-columns-selection-the-i-option">
-<h3>9.4.15. Input columns selection: The <strong>-i</strong> option<a class="headerlink" href="#input-columns-selection-the-i-option" title="Permalink to this headline">¶</a></h3>
-<p>The <strong>-i</strong><em>columns</em> option allows you to specify which
-input file data columns to use and in what order. By default, GMT will
-read all the data columns in the file, starting with the first column
-(0). Using <strong>-i</strong> modifies that process. For instance, to use the 4th,
-7th, and 3rd data column as the required <em>x,y,z</em> to
-<a class="reference internal" href="blockmean.html"><em>blockmean</em></a> you would specify
-<strong>-i</strong>3,6,2 (since 0 is the first column). The chosen data columns
-will be used as is. Optionally, you can specify that input columns
-should be transformed according to a linear or logarithmic conversion.
-Do so by appending [<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>] to
-each column (or range of columns). All items are optional: The <strong>l</strong>
-implies we should first take <img class="math" src="_images/math/195374909526226d6dd908206784056573e69009.png" alt="\log_{10}"/> of the data [leave as
-is]. Next, we may scale the result by the given <em>scale</em> [1]. Finally, we
-add in the specified <em>offset</em> [0].</p>
-</div>
-<div class="section" id="grid-interpolation-parameters-the-n-option">
-<h3>9.4.16. Grid interpolation parameters: The <strong>-n</strong> option<a class="headerlink" href="#grid-interpolation-parameters-the-n-option" title="Permalink to this headline">¶</a></h3>
-<p>The <strong>-n</strong><em>type</em> option controls parameters used for
-2-D grids resampling. You can select the type of spline used (<strong>-nb</strong>
-for B-spline smoothing, <strong>-nc</strong> for bicubic [Default], <strong>-nl</strong> for
-bilinear, or <strong>-nn</strong> for nearest-node value). For programs that support
-it, antialiasing is by default on; optionally, append <strong>+a</strong> to switch
-off antialiasing. By default, boundary conditions are set according to
-the grid type and extent. Change boundary conditions by appending
-<strong>+b</strong><em>BC</em>, where <em>BC</em> is either <strong>g</strong> for geographic boundary
-conditions or one (or both) of <strong>n</strong> and <strong>p</strong> for natural or periodic
-boundary conditions, respectively. Append <strong>x</strong> or <strong>y</strong> to only apply
-the condition in one dimension. E.g., <strong>-nb+nxpy</strong> would imply natural
-boundary conditions in the <em>x</em> direction and periodic conditions in the
-<em>y</em> direction. Finally, append <strong>+t</strong><em>threshold</em> to control how close
-to nodes with NaN the interpolation should go. A <em>threshold</em> of 1.0
-requires all (4 or 16) nodes involved in the interpolation to be
-non-NaN. 0.5 will interpolate about half way from a non-NaN value; 0.1
-will go about 90% of the way, etc.</p>
-</div>
-<div class="section" id="output-columns-selection-the-o-option">
-<h3>9.4.17. Output columns selection: The <strong>-o</strong> option<a class="headerlink" href="#output-columns-selection-the-o-option" title="Permalink to this headline">¶</a></h3>
-<p>The <strong>-o</strong><em>columns</em> option allows you to specify which
-columns to write on output and in what order. By default, GMT will
-write all the data columns produced by the program. Using <strong>-o</strong>
-modifies that process. For instance, to write just the 4th and 2nd data
-column to the output you would use <strong>-o</strong>3,1 (since 0 is the first column).</p>
-</div>
-<div class="section" id="perspective-view-the-p-option">
-<h3>9.4.18. Perspective view: The <strong>-p</strong> option<a class="headerlink" href="#perspective-view-the-p-option" title="Permalink to this headline">¶</a></h3>
-<p>All plotting programs that normally produce a flat, two-dimensional
-illustration can be told to view this flat illustration from a
-particular vantage point, resulting in a perspective view. You can
-select perspective view with the <strong>-p</strong> option by setting the azimuth
-and elevation of the viewpoint [Default is 180/90]. When <strong>-p</strong> is used
-in consort with <strong>-Jz</strong> or <strong>-JZ</strong>, a third value can be appended which
-indicates at which <em>z</em>-level all 2-D material, like the plot frame, is
-plotted (in perspective) [Default is at the bottom of the z-axis]. For
-frames used for animation, you may want to append <strong>+</strong> to fix the
-center of your data domain (or specify a particular world coordinate
-point with <strong>+w</strong><em>lon0/lat</em>[<em>z</em>]) which will project to the center
-of your page size (or you may specify the coordinates of the <em>projected</em>
-view point with <strong>+v</strong><em>x0/y0</em>. When <strong>-p</strong> is used without any further
-arguments, the values from the last use of <strong>-p</strong> in a previous
-GMTcommand will be used.</p>
-</div>
-<div class="section" id="grid-registration-the-r-option">
-<span id="grid-registration"></span><h3>9.4.19. Grid registration: The <strong>-r</strong> option<a class="headerlink" href="#grid-registration-the-r-option" title="Permalink to this headline">¶</a></h3>
-<p>All 2-D grids in GMT have their nodes
-organized in one of two ways, known as <em>gridline</em>- and <em>pixel</em>
-registration. The GMT default is gridline registration; programs that
-allow for the creation of grids can use the <strong>-r</strong> option to select
-pixel registration instead.</p>
-<div class="section" id="gridline-registration">
-<h4>1. Gridline registration<a class="headerlink" href="#gridline-registration" title="Permalink to this headline">¶</a></h4>
-<p>In this registration, the nodes are centered on the grid line
-intersections and the data points represent the average value in a cell
-of dimensions (<img class="math" src="_images/math/30d032d772f65301dabe9c7b6fd5136bebd0efcd.png" alt="x_{inc} \cdot y_{inc}"/>) centered on each node
-(left side of Figure <a class="reference internal" href="#id17"><em>Grid registration</em></a>).
-In the case of grid line registration the number of nodes are related
-to region and grid spacing by</p>
-<div class="math">
-<p><img src="_images/math/c7ca48f867cc97d68b163a2af6d919e9c0946ecb.png" alt="\begin{array}{ccl}
-nx & = & (x_{max} - x_{min}) / x_{inc} + 1 \\
-ny & = & (y_{max} - y_{min}) / y_{inc} + 1
-\end{array}"/></p>
-</div><p>which for the example in left side of Figure <a class="reference internal" href="#id17"><em>Gridline registration</em></a> yields nx = ny = 4.</p>
-</div>
-<div class="section" id="pixel-registration">
-<h4>1. Pixel registration<a class="headerlink" href="#pixel-registration" title="Permalink to this headline">¶</a></h4>
-<p>Here, the nodes are centered in the grid cells, i.e., the areas
-between grid lines, and the data points represent the average values
-within each cell (right side of Figure <a class="reference internal" href="#id17"><em>Grid registration</em></a>). In the case of
-pixel registration the number of nodes are related to region and grid
-spacing by</p>
-<div class="figure align-center" id="id17">
-<a class="reference internal image-reference" href="_images/GMT_registration.png"><img alt="_images/GMT_registration.png" src="_images/GMT_registration.png" style="width: 500px;" /></a>
-<p class="caption">Gridline- and pixel-registration of data nodes.</p>
-</div>
-<div class="math">
-<p><img src="_images/math/0278631977e0f39ca6a0d67360de82349f5c774a.png" alt="\begin{array}{ccl}
-nx & = & (x_{max} - x_{min}) / x_{inc} \\
-ny & = & (y_{max} - y_{min}) / y_{inc}
-\end{array}"/></p>
-</div><p>Thus, given the same region (<strong>-R</strong>) and grid spacing, the
-pixel-registered grids have one less column and one less row than the
-gridline-registered grids; here we find nx = ny = 3.</p>
-</div>
-</div>
-<div class="section" id="nan-record-treatment-the-s-option">
-<h3>9.4.20. NaN-record treatment: The <strong>-s</strong> option<a class="headerlink" href="#nan-record-treatment-the-s-option" title="Permalink to this headline">¶</a></h3>
-<p>We can use this option to suppress output for records whose <em>z</em>-value
-equals NaN (by default we output all records). Alternatively, append
-<strong>r</strong> to reverse the suppression, i.e., only output the records whose
-<em>z</em>-value equals NaN. Use <strong>-sa</strong> to suppress output records where one
-or more fields (and not necessarily <em>z</em>) equal NaN. Finally, you can
-supply a comma-separated list of all columns or column ranges to
-consider for this NaN test.</p>
-</div>
-<div class="section" id="layer-pdf-transparency-the-t-option">
-<h3>9.4.21. Layer PDF transparency: The <strong>-t</strong> option<a class="headerlink" href="#layer-pdf-transparency-the-t-option" title="Permalink to this headline">¶</a></h3>
-<p>While the PostScript language does not support transparency, PDF does,
-and via PostScript extensions one can manipulate the transparency
-levels of objects. The <strong>-t</strong> option allows you to change the
-transparency level for the current overlay by appending a percentage in
-the 0–100 range; the default is 0, or opaque. Transparency may also be
-controlled on a feature by feature basis when setting color or fill (see
-section <a class="reference internal" href="#specifying-area-fill-attributes">Specifying area fill attributes</a>).</p>
-</div>
-<div class="section" id="latitude-longitude-or-longitude-latitude-the-option">
-<h3>9.4.22. Latitude/Longitude or Longitude/Latitude?: The <strong>-:</strong> option<a class="headerlink" href="#latitude-longitude-or-longitude-latitude-the-option" title="Permalink to this headline">¶</a></h3>
-<p>For geographical data, the first column is expected to contain
-longitudes and the second to contain latitudes. To reverse this
-expectation you must apply the <strong>-:</strong> option. Optionally, append <strong>i</strong>
-or <strong>o</strong> to restrict the effect to input or output only. Note that
-command line arguments that may take geographic coordinates (e.g.,
-<strong>-R</strong>) <em>always</em> expect longitude before latitude. Also, geographical
-grids are expected to have the longitude as first (minor) dimension.</p>
-</div>
-</div>
-<div class="section" id="command-line-history">
-<h2>9.5. Command line history<a class="headerlink" href="#command-line-history" title="Permalink to this headline">¶</a></h2>
-<p>GMT programs “remember” the standardized command line options (See
-Section <a class="reference internal" href="#standardized-command-line-options">Standardized command line options</a>) given during their previous invocations and this
-provides a shorthand notation for complex options. For example, if a
-basemap was created with an oblique Mercator projection, specified as</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>-Joc170W/25:30S/33W/56:20N/1:500000
-</pre></div>
-</div>
-</div></blockquote>
-<p>then a subsequent <a class="reference internal" href="psxy.html"><em>psxy</em></a> command to plot
-symbols only needs to state <strong>-J</strong>o in order to activate the same
-projection. In contrast, note that <strong>-J</strong> by itself will pick the most
-recently used projection. Previous commands are maintained in the file <tt class="docutils literal"><span class="pre">gmt.history</span></tt>,
-of which there will be one in each directory you run the programs from.
-This is handy if you create separate directories for separate projects
-since chances are that data manipulations and plotting for each project
-will share many of the same options. Note that an option spelled out on
-the command line will always override the previous entry in the <tt class="docutils literal"><span class="pre">gmt.history</span></tt> file and, if
-execution is successful, will replace this entry as the previous option
-argument in the <tt class="docutils literal"><span class="pre">gmt.history</span></tt> file. If you call several GMT modules piped together
-then GMT cannot guarantee that the <tt class="docutils literal"><span class="pre">gmt.history</span></tt> file is processed in the intended
-order from left to right. The only guarantee is that the file will not
-be clobbered since GMT uses advisory file locking. The uncertainty in
-processing order makes the use of shorthands in pipes unreliable. We
-therefore recommend that you only use shorthands in single process
-command lines, and spell out the full command option when using chains
-of commands connected with pipes.</p>
-</div>
-<div class="section" id="usage-messages-syntax-and-general-error-messages">
-<h2>9.6. Usage messages, syntax- and general error messages<a class="headerlink" href="#usage-messages-syntax-and-general-error-messages" title="Permalink to this headline">¶</a></h2>
-<p>Each program carries a usage message. If you enter the program name
-without any arguments, the program will write the complete usage message
-to standard error (your screen, unless you redirect it). This message
-explains in detail what all the valid arguments are. If you enter the
-program name followed by a <em>hyphen</em> (-) only you will get a shorter
-version which only shows the command line syntax and no detailed
-explanations. If you incorrectly specify an option or omit a required
-option, the program will produce syntax errors and explain what the
-correct syntax for these options should be. If an error occurs during
-the running of a program, the program will in some cases recognize this
-and give you an error message. Usually this will also terminate the run.
-The error messages generally begin with the name of the program in which
-the error occurred; if you have several programs piped together this
-tells you where the trouble is.</p>
-</div>
-<div class="section" id="standard-input-or-file-header-records">
-<h2>9.7. Standard input or file, header records<a class="headerlink" href="#standard-input-or-file-header-records" title="Permalink to this headline">¶</a></h2>
-<p>Most of the programs which expect table data input can read either
-standard input or input in one or several files. These programs will try
-to read <em>stdin</em> unless you type the filename(s) on the command line
-without the above hyphens. (If the program sees a hyphen, it reads the
-next character as an instruction; if an argument begins without a
-hyphen, it tries to open this argument as a filename). This feature
-allows you to connect programs with pipes if you like. If your input is
-ASCII and has one or more header records that do not begin with #, you
-must use the <strong>-h</strong> option (see Section <a class="reference internal" href="#header-data-records-the-h-option">Header data records: The -h
-option</a>). ASCII files may in many cases also contain segment-headers
-separating data segments. These are called “multi-segment files”. For
-binary table data the <strong>-h</strong> option may specify how many bytes should be
-skipped before the data section is reached. Binary files may also
-contain segment-headers separating data segments. These segment-headers
-are simply data records whose fields are all set to NaN; see Appendix
-[app:B] for complete documentation.</p>
-<p>If filenames are given for reading, GMT programs will first look for
-them in the current directory. If the file is not found, the programs
-will look in two other directories pointed to by the
-<a class="reference internal" href="gmt.conf.html#dir-parameters"><em>directory parameters</em></a> <strong>DIR_DATA</strong>
-or by the environmental parameters <strong>$GMT_USERDIR</strong> and
-<strong>$GMT_DATADIR</strong> (if set). They may be set by the user to point to
-directories that contain data sets of general use, thus eliminating the
-need to specify a full path to these files. Usually, the <strong>DIR_DATA</strong>
-directory will hold data sets of a general nature (tables, grids),
-whereas the <strong>$GMT_USERDIR</strong> directory (its default value is $HOME/.gmt)
-may hold miscellaneous data sets more
-specific to the user; this directory also stores GMT defaults and other
-configuration files. See <a class="reference internal" href="gmt.conf.html#dir-parameters"><em>directory parameters</em></a>
-for details. Program output is always written to the current directory
-unless a full path has been specified.</p>
-</div>
-<div class="section" id="verbose-operation">
-<h2>9.8. Verbose operation<a class="headerlink" href="#verbose-operation" title="Permalink to this headline">¶</a></h2>
-<p>Most of the programs take an optional <strong>-V</strong> argument which will run the
-program in the “verbose” mode (see Section <a class="reference internal" href="#verbose-feedback-the-v-option">Verbose feedback: The -V
-option</a>). Verbose will write to standard error information about the
-progress of the operation you are running. Verbose reports things such
-as counts of points read, names of data files processed, convergence of
-iterative solutions, and the like. Since these messages are written to
-<em>stderr</em>, the verbose talk remains separate from your data output. You
-may optionally choose among five models of <em>verbosity</em>; each mode adds
-more messages with an increasing level of details. The modes are</p>
-<blockquote>
-<div><p><strong>q</strong> Complete silence, not even fatal error messages.</p>
-<p><strong>n</strong> Warnings and progress messages [Default].</p>
-<p><strong>c</strong> Warnings about deprecated usage (if compiled for compatibility).</p>
-<p><strong>l</strong> Detailed progress messages.</p>
-<p><strong>d</strong> Debugging messages.</p>
-</div></blockquote>
-<p>The verbosity is cumulative, i.e., mode <strong>l</strong> means all messages of mode
-<strong>n</strong> as well. will be reported.</p>
-</div>
-<div class="section" id="program-output">
-<h2>9.9. Program output<a class="headerlink" href="#program-output" title="Permalink to this headline">¶</a></h2>
-<p>Most programs write their results, including PostScriptplots, to
-standard output. The exceptions are those which may create binary netCDF
-grid files such as <a class="reference internal" href="surface.html"><em>surface</em></a> (due to the
-design of netCDF a filename must be provided; however, alternative
-binary output formats allowing piping are available; see Section
-<a class="reference internal" href="#grid-file-format-specifications">Grid file format specifications</a>).
-Most operating systems let you can redirect
-standard output to a file or pipe it into another process. Error
-messages, usage messages, and verbose comments are written to standard
-error in all cases. You can usually redirect standard error as well, if
-you want to create a log file of what you are doing. The syntax for
-redirection differ among the main shells (Bash and C-shell) and is a bit
-limited in DOS.</p>
-</div>
-<div class="section" id="input-data-formats">
-<h2>9.10. Input data formats<a class="headerlink" href="#input-data-formats" title="Permalink to this headline">¶</a></h2>
-<p>Most of the time, GMT will know what kind of <em>x</em> and <em>y</em>
-coordinates it is reading because you have selected a particular
-coordinate transformation or map projection. However, there may be times
-when you must explicitly specify what you are providing as input using
-the <strong>-f</strong> switch. When binary input data are expected (<strong>-bi</strong>) you
-must specify exactly the format of the records. However, for ASCII input
-there are numerous ways to encode data coordinates (which may be
-separated by white-space or commas). Valid input data are generally of
-the same form as the arguments to the <strong>-R</strong> option (see
-Section <a class="reference internal" href="#data-domain-or-map-region-the-r-option">Data domain or map region: The -R option</a>), with additional flexibility for calendar data.
-Geographical coordinates, for example, can be given in decimal degrees
-(e.g., -123.45417) or in the
-[]*ddd*[:<em>mm</em>[:<em>ss</em>[<em>.xxx</em>]]][<strong>W</strong>| <strong>E</strong>| <strong>S</strong>| <strong>N</strong>]
-format (e.g., 123:27:15W). With <strong>-fp</strong> you may even supply projected
-data like UTM coordinates.</p>
-<p>Because of the widespread use of incompatible and ambiguous formats, the
-processing of input date components is guided by the template
-<a class="reference internal" href="gmt.conf.html#format-date-in"><em>FORMAT_DATE_IN</em></a> in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file; it is by default set to <em>yyyy-mm-dd</em>.
-Y2K-challenged input data such as 29/05/89 can be processed by setting
-<a class="reference internal" href="gmt.conf.html#format-date-in"><em>FORMAT_DATE_IN</em></a> to dd/mm/yy. A complete description of possible
-formats is given in the <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> man
-page. The <em>clock</em> string is more standardized but issues like 12- or
-24-hour clocks complicate matters as well as the presence or absence of
-delimiters between fields. Thus, the processing of input clock
-coordinates is guided by the template <a class="reference internal" href="gmt.conf.html#format-clock-in"><em>FORMAT_CLOCK_IN</em></a> which
-defaults to <em>hh:mm:ss.xxx</em>.</p>
-<p>GMT programs that require a map projection argument will implicitly
-know what kind of data to expect, and the input processing is done
-accordingly. However, some programs that simply report on minimum and
-maximum values or just do a reformatting of the data will in general not
-know what to expect, and furthermore there is no way for the programs to
-know what kind of data other columns (beyond the leading <em>x</em> and
-<em>y</em> columns) contain. In such instances we must explicitly tell
-GMT that we are feeding it data in the specific geographic or calendar
-formats (floating point data are assumed by default). We specify the
-data type via the <strong>-f</strong> option (which sets both input and output
-formats; use <strong>-fi</strong> and <strong>-fo</strong> to set input and output separately).
-For instance, to specify that the the first two columns are longitude
-and latitude, and that the third column (e.g., <em>z</em>) is absolute
-calendar time, we add <strong>-fi</strong>0x,1y,2T to the command line. For more
-details, see the man page for the program you need to use.</p>
-</div>
-<div class="section" id="output-data-formats">
-<h2>9.11. Output data formats<a class="headerlink" href="#output-data-formats" title="Permalink to this headline">¶</a></h2>
-<p>The numerical output from GMT programs can be binary (when <strong>-bo</strong> is
-used) or ASCII [Default]. In the latter case the issue of formatting
-becomes important. GMT provides extensive machinery for allowing just
-about any imaginable format to be used on output. Analogous to the
-processing of input data, several templates guide the formatting
-process. These are <a class="reference internal" href="gmt.conf.html#format-date-out"><em>FORMAT_DATE_OUT</em></a> and <a class="reference internal" href="gmt.conf.html#format-clock-out"><em>FORMAT_CLOCK_OUT</em></a> for
-calendar-time coordinates, <a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a> for geographical
-coordinates, and <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> for generic floating point data.
-In addition, the user have control over how columns are separated via
-the <a class="reference internal" href="gmt.conf.html#io-col-separator"><em>IO_COL_SEPARATOR</em></a> parameter. Thus, as an example, it is possible
-to create limited FORTRAN-style card records by setting
-<a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> to %7.3lf and <a class="reference internal" href="gmt.conf.html#io-col-separator"><em>IO_COL_SEPARATOR</em></a> to none
-[Default is tab].</p>
-</div>
-<div class="section" id="postscript-features">
-<h2>9.12. PostScript features<a class="headerlink" href="#postscript-features" title="Permalink to this headline">¶</a></h2>
-<p>PostScript is a command language for driving graphics devices such as
-laser printers. It is ASCII text which you can read and edit as you wish
-(assuming you have some knowledge of the syntax). We prefer this to
-binary metafile plot systems since such files cannot easily be modified
-after they have been created. GMT programs also write many comments to
-the plot file which make it easier for users to orient themselves should
-they need to edit the file (e.g., % Start of x-axis) <a class="footnote-reference" href="#id63" id="id18">[16]</a>. All
-GMT programs create PostScript code by calling the <a class="reference internal" href="pslib.html"><em>PSL</em></a> plot
-library (The user may call these functions from his/her own C or FORTRAN
-plot programs. See the manual pages for <a class="reference internal" href="pslib.html"><em>PSL</em></a> syntax). Although
-GMT programs can create very individualized plot code, there will
-always be cases not covered by these programs. Some knowledge of
-PostScript will enable the user to add such features directly into the
-plot file. By default, GMT will produce freeform PostScript output
-with embedded printer directives. To produce Encapsulated
-PostScript (EPS) that can be imported into graphics programs such as
-<strong>CorelDraw</strong>, <strong>Illustrator</strong> or <strong>InkScape</strong> for further
-embellishment, simply run <a class="reference internal" href="ps2raster.html"><em>ps2raster</em></a>
-<strong>-Te</strong>. See Appendix [app:C] for an extensive discussion of converting
-PostScript to other formats.</p>
-</div>
-<div class="section" id="specifying-pen-attributes">
-<span id="wpen-attrib"></span><h2>9.13. Specifying pen attributes<a class="headerlink" href="#specifying-pen-attributes" title="Permalink to this headline">¶</a></h2>
-<p>A pen in GMT has three attributes: <em>width</em>, <em>color</em>, and
-<em>style</em>. Most programs will accept pen attributes in the form of an
-option argument, with commas separating the given attributes, e.g.,</p>
-<p><strong>-W</strong>[<em>width</em>[<strong>c|i|p</strong>]],[<em>color</em>],[<em>style</em>[<strong>c|i|p|</strong>]]</p>
-<blockquote>
-<div><em>Width</em> is by default measured in points (1/72 of an inch). Append
-<strong>c</strong>, <strong>i</strong>, or <strong>p</strong> to specify pen width in cm, inch, or points,
-respectively. Minimum-thickness pens can be achieved by giving zero
-width, but the result is device-dependent. Finally, a few predefined
-pen names can be used: default, faint, and {thin, thick,
-fat}[er|est], and obese. Table <a class="reference internal" href="#tbl-pennames"><em>pennames</em></a> shows this
-list and the corresponding pen widths.</div></blockquote>
-<blockquote id="tbl-pennames">
-<div><table border="1" class="docutils">
-<colgroup>
-<col width="29%" />
-<col width="22%" />
-<col width="29%" />
-<col width="20%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"> </th>
-<th class="head"> </th>
-<th class="head"> </th>
-<th class="head"> </th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>faint</td>
-<td>0</td>
-<td>thicker</td>
-<td>1.5p</td>
-</tr>
-<tr class="row-odd"><td>default</td>
-<td>0.25p</td>
-<td>thickest</td>
-<td>2p</td>
-</tr>
-<tr class="row-even"><td>thinnest</td>
-<td>0.25p</td>
-<td>fat</td>
-<td>3p</td>
-</tr>
-<tr class="row-odd"><td>thinner</td>
-<td>0.50p</td>
-<td>fatter</td>
-<td>6p</td>
-</tr>
-<tr class="row-even"><td>thin</td>
-<td>0.75p</td>
-<td>fattest</td>
-<td>12p</td>
-</tr>
-<tr class="row-odd"><td>thick</td>
-<td>1.0p</td>
-<td>obese</td>
-<td>18p</td>
-</tr>
-</tbody>
-</table>
-<p>The <em>color</em> can be specified in five different ways:</p>
-<ol class="arabic simple">
-<li>Gray. Specify a <em>gray</em> shade in the range 0–255 (linearly going
-from black [0] to white [255]).</li>
-<li>RGB. Specify <em>r</em>/<em>g</em>/<em>b</em>, each ranging from 0–255. Here 0/0/0 is
-black, 255/255/255 is white, 255/0/0 is red, etc.</li>
-<li>HSV. Specify <em>hue</em>-<em>saturation</em>-<em>value</em>, with the former in the
-0–360 degree range while the latter two take on the range 0–1 <a class="footnote-reference" href="#id64" id="id19">[17]</a>.</li>
-<li>CMYK. Specify <em>cyan</em>/<em>magenta</em>/<em>yellow</em>/<em>black</em>, each ranging
-from 0–100%.</li>
-<li>Name. Specify one of 663 valid color names. Use <strong>man
-gmtcolors</strong> to list all valid names. A very small yet versatile
-subset consists of the 29 choices <em>white</em>, <em>black</em>, and
-[light:|dark]{<em>red, orange, yellow, green, cyan, blue,
-magenta, gray|grey, brown</em>}. The color names are
-case-insensitive, so mixed upper and lower case can be used (like
-<em>DarkGreen</em>).</li>
-</ol>
-<p>The <em>style</em> attribute controls the appearance of the line. Giving “dotted” or ”.”
-yields a dotted line, whereas a dashed pen is requested with “dashed” or “-”.
-Also combinations of dots and dashes, like ”.-” for a dot-dashed
-line, are allowed. To override a default style and secure a solid line you can
-specify “solid” for style. The lengths of dots and dashes are scaled
-relative to the pen width (dots has a length that equals the pen
-width while dashes are 8 times as long; gaps between segments are 4
-times the pen width). For more detailed attributes including exact
-dimensions you may specify <em>string</em>:<em>offset</em>, where <em>string</em> is a
-series of numbers separated by underscores. These numbers represent
-a pattern by indicating the length of line segments and the gap
-between segments. The <em>offset</em> phase-shifts the pattern from the
-beginning the line. For example, if you want a yellow line of width
-0.1 cm that alternates between long dashes (4 points), an 8 point
-gap, then a 5 point dash, then another 8 point gap, with pattern
-offset by 2 points from the origin, specify
-<strong>-W</strong>0.1c,yellow,4_8_5_8:2p. Just as with pen width, the
-default style units are points, but can also be explicitly specified
-in cm, inch, or points (see <em>width</em> discussion above).</p>
-</div></blockquote>
-<p>Table <a class="reference internal" href="#tbl-penex"><em>penex</em></a> contains additional examples of pen specifications
-suitable for, say, <a class="reference internal" href="psxy.html"><em>psxy</em></a>.</p>
-<table border="1" class="docutils" id="tbl-penex">
-<colgroup>
-<col width="37%" />
-<col width="63%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"> </th>
-<th class="head"> </th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td><strong>-W</strong>0.5p</td>
-<td>0.5 point wide line of default color and style</td>
-</tr>
-<tr class="row-odd"><td><strong>-W</strong>green</td>
-<td>Green line with default width and style</td>
-</tr>
-<tr class="row-even"><td><strong>-W</strong>thin,red,-</td>
-<td>Dashed, thin red line</td>
-</tr>
-<tr class="row-odd"><td><strong>-W</strong>fat,.</td>
-<td>Fat dotted line with default color</td>
-</tr>
-<tr class="row-even"><td><strong>-W</strong>0.1c,120-1-1</td>
-<td>Green (in h-s-v) pen, 1 mm thick</td>
-</tr>
-<tr class="row-odd"><td><strong>-W</strong>faint,100/0/0/0,..-</td>
-<td>Very thin, cyan (in c/m/y/k), dot-dot-dashed line</td>
-</tr>
-</tbody>
-</table>
-<p>In addition to these pen settings there are several
-PostScript settings that can affect the appearance of lines. These are
-controlled via the GMT defaults settings <a class="reference internal" href="gmt.conf.html#ps-line-cap"><em>PS_LINE_CAP</em></a>,
-<a class="reference internal" href="gmt.conf.html#ps-line-join"><em>PS_LINE_JOIN</em></a>, and <a class="reference internal" href="gmt.conf.html#ps-miter-limit"><em>PS_MITER_LIMIT</em></a>. They determine how a line
-segment ending is rendered, be it at the termination of a solid line or
-at the end of all dashed line segments making up a line, and how a
-straight lines of finite thickness should behave when joined at a common
-point. By default, line segments have rectangular ends, but this can
-change to give rounded ends. When <a class="reference internal" href="gmt.conf.html#ps-line-cap"><em>PS_LINE_CAP</em></a> is set to round the
-a segment length of zero will appear as a circle. This can be used to
-created circular dotted lines, and by manipulating the phase shift in
-the <em>style</em> attribute and plotting the same line twice one can even
-alternate the color of adjacent items.
-Figure <a class="reference internal" href="#line-appearance"><em>Line appearance</em></a> shows various lines made in this
-fashion. See the <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> man page for more information.</p>
-<div class="figure align-center" id="line-appearance">
-<a class="reference internal image-reference" href="_images/GMT_linecap.png"><img alt="_images/GMT_linecap.png" src="_images/GMT_linecap.png" style="width: 500px;" /></a>
-<p class="caption">Line appearance can be varied by using <a class="reference internal" href="gmt.conf.html#ps-line-cap"><em>PS_LINE_CAP</em></a></p>
-</div>
-</div>
-<div class="section" id="specifying-area-fill-attributes">
-<h2>9.14. Specifying area fill attributes<a class="headerlink" href="#specifying-area-fill-attributes" title="Permalink to this headline">¶</a></h2>
-<p>Many plotting programs will allow the user to draw filled polygons or
-symbols. The fill specification may take two forms:</p>
-<p><strong>-G</strong><em>fill</em></p>
-<p><strong>-Gp</strong><em>dpi/pattern</em>[:<strong>B</strong><em>color</em>[<strong>F</strong><em>color</em>]]</p>
-<dl class="docutils">
-<dt>fill:</dt>
-<dd>In the first case we may specify a <em>gray</em> shade (0–255), RGB color
-(<em>r</em>/<em>g</em>/<em>b</em> all in the 0–255 range or in hexadecimal <em>#rrggbb</em>),
-HSV color (<em>hue</em>-<em>saturation</em>-<em>value</em> in the 0–360, 0–1, 0–1 range),
-CMYK color (<em>cyan</em>/<em>magenta</em>/<em>yellow</em>/<em>black</em>, each ranging from
-0–100%), or a valid color <em>name</em>; in that respect it is similar to
-specifying the pen color settings (see pen color discussion under
-Section <a class="reference internal" href="#specifying-pen-attributes">Specifying pen attributes</a>).</dd>
-<dt>pattern:</dt>
-<dd>The second form allows us to use a predefined bit-image pattern.
-<em>pattern</em> can either be a number in the range 1–90 or the name of a
-1-, 8-, or 24-bit Sun raster file. The former will result in one of
-the 90 predefined 64 x 64 bit-patterns provided with GMT and
-reproduced in Appendix [app:E]. The latter allows the user to create
-customized, repeating images using standard Sun raster files <a class="footnote-reference" href="#id65" id="id20">[18]</a>.
-The <em>dpi</em> parameter sets the resolution of this image on the page;
-the area fill is thus made up of a series of these “tiles”.
-Specifying <em>dpi</em> as 0 will result in highest resolution obtainable
-given the present dpi setting in <tt class="docutils literal"><span class="pre">gmt.history</span></tt>. By specifying upper case <strong>-GP</strong>
-instead of <strong>-Gp</strong> the image will be bit-reversed, i.e., white and
-black areas will be interchanged (only applies to 1-bit images or
-predefined bit-image patterns). For these patterns and other 1-bit
-images one may specify alternative background and foreground colors
-(by appending :<strong>B</strong><em>color</em>[<strong>F</strong><em>color</em>]) that will replace
-the default white and black pixels, respectively. Setting one of the
-fore- or background colors to - yields a <em>transparent</em> image where
-only the back- <em>or</em> foreground pixels will be painted.</dd>
-</dl>
-<p>Due to PostScript implementation limitations the raster images used
-with <strong>-G</strong> must be less than 146 x 146 pixels in size; for larger
-images see <a class="reference internal" href="psimage.html"><em>psimage</em></a>. The format of Sun
-raster files is outlined in Appendix [app:B]. Note that under
-PostScript Level 1 the patterns are filled by using the polygon as a
-<em>clip path</em>. Complex clip paths may require more memory than the
-PostScript interpreter has been assigned. There is therefore the
-possibility that some PostScript interpreters (especially those
-supplied with older laserwriters) will run out of memory and abort.
-Should that occur we recommend that you use a regular gray-shade fill
-instead of the patterns. Installing more memory in your printer <em>may or
-may not</em> solve the problem!</p>
-<p>Table <a class="reference internal" href="#tbl-fillex"><em>fillex</em></a> contains a few examples of fill specifications.</p>
-<table border="1" class="docutils" id="tbl-fillex">
-<colgroup>
-<col width="34%" />
-<col width="66%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"> </th>
-<th class="head"> </th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td><strong>-G</strong>128</td>
-<td>Solid gray</td>
-</tr>
-<tr class="row-odd"><td><strong>-G</strong>127/255/0</td>
-<td>Chartreuse, R/G/B-style</td>
-</tr>
-<tr class="row-even"><td><strong>-G</strong>#00ff00</td>
-<td>Green, hexadecimal RGB code</td>
-</tr>
-<tr class="row-odd"><td><strong>-G</strong>25-0.86-0.82</td>
-<td>Chocolate, h-s-v-style</td>
-</tr>
-<tr class="row-even"><td><strong>-G</strong>DarkOliveGreen1</td>
-<td>One of the named colors</td>
-</tr>
-<tr class="row-odd"><td><strong>-Gp</strong>300/7</td>
-<td>Simple diagonal hachure pattern in b/w at 300 dpi</td>
-</tr>
-<tr class="row-even"><td><strong>-Gp</strong>300/7:Bred</td>
-<td>Same, but with red lines on white</td>
-</tr>
-<tr class="row-odd"><td><strong>-Gp</strong>300/7:BredF-</td>
-<td>Now the gaps between red lines are transparent</td>
-</tr>
-<tr class="row-even"><td><strong>-Gp</strong>100/marble.ras</td>
-<td>Using user image of marble as the fill at 100 dpi</td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="specifying-fonts">
-<h2>9.15. Specifying Fonts<a class="headerlink" href="#specifying-fonts" title="Permalink to this headline">¶</a></h2>
-<p>The fonts used by GMT are typically set indirectly via the
-GMT defaults parameters. However, some programs, like
-<a class="reference internal" href="pstext.html"><em>pstext</em></a> may wish to have this
-information passed directly. A font is specified by a comma-delimited
-attribute list of <em>size</em>, <em>fonttype</em> and <em>fill</em>, each of which is
-optional. The <em>size</em> is the font size (usually in points) but <strong>c</strong>,
-<strong>i</strong> or <strong>p</strong> can be added to indicate a specific unit. The <em>fonttype</em>
-is the name (case sensitive!) of the font or its equivalent numerical ID
-(e.g., Helvetica-Bold or 1). <em>fill</em> specifies the gray shade, color or
-pattern of the text (see section <a class="reference internal" href="#specifying-area-fill-attributes">Specifying area fill attributes</a> above). Optionally, you may
-append <strong>=</strong><em>pen</em> to the <em>fill</em> value in order to draw the text
-outline with the specified <em>pen</em>; if used you may optionally skip the
-filling of the text by setting <em>fill</em> to <strong>-</strong>. If any of the attributes
-is omitted their default or previous setting will be retained. See
-Appendix <a class="reference internal" href="#g-postscript-fonts-used-by-gmt">G. PostScript fonts used by GMT</a> for a list of all fonts recognized by GMT.</p>
-</div>
-<div class="section" id="stroke-fill-and-font-transparency">
-<h2>9.16. Stroke, Fill and Font Transparency<a class="headerlink" href="#stroke-fill-and-font-transparency" title="Permalink to this headline">¶</a></h2>
-<p>The PostScript language has no built-in mechanism for transparency.
-However, PostScriptextensions make it possible to request
-transparency, and tools that can render such extensions will produce
-transparency effects. We specify transparency in percent: 0 is opaque
-[Default] while 100 is fully transparent (i.e., nothing will show). As
-noted in section <a class="reference internal" href="#layer-pdf-transparency-the-t-option">Layer PDF transparency: The -t option</a>, we can control transparency on a
-layer-by-layer basis using the <strong>-t</strong> option. However, we may also set
-transparency as an attribute of stroke or fill (including for fonts)
-settings. Here, transparency is requested by appending @<em>transparency</em>
-to colors or pattern fills. The transparency <em>mode</em> can be changed by
-using the GMT default parameter <a class="reference internal" href="gmt.conf.html#ps-transparency"><em>PS_TRANSPARENCY</em></a>; the default is
-Normal but you can choose among Color, ColorBurn, ColorDodge, Darken,
-Difference, Exclusion, HardLight, Hue, Lighten, Luminosity, Multiply,
-Normal, Overlay, Saturation, SoftLight, and Screen. For more
-information, see for instance (search online for) the Adobe pdfmark
-Reference Manual. Most printers and many PostScript viewers can
-neither print nor show transparency. They will simply ignore your
-attempt to create transparency and will plot any material as opaque.
-Ghostscript and its derivatives such as GMT’s
-<a class="reference internal" href="ps2raster.html"><em>ps2raster</em></a> support transparency (if
-compiled with the correct build option). Note: If you use <strong>Acrobat
-Distiller</strong> to create a PDF file you must first change some settings to
-make transparency effective: change the parameter /AllowTransparency to
-true in your *.joboptions file.</p>
-</div>
-<div class="section" id="color-palette-tables">
-<h2>9.17. Color palette tables<a class="headerlink" href="#color-palette-tables" title="Permalink to this headline">¶</a></h2>
-<p>Several programs, such as those which read 2-D gridded data sets and
-create colored images or shaded reliefs, need to be told what colors to
-use and over what <em>z</em>-range each color applies. This is the purpose of
-the color palette table (CPT file). These files may also be used by
-<a class="reference internal" href="psxy.html"><em>psxy</em></a> and
-<a class="reference internal" href="psxyz.html"><em>psxyz</em></a> to plot color-filled symbols. For
-most applications, you will simply create a CPT file using the tool
-<a class="reference internal" href="makecpt.html"><em>makecpt</em></a> which will take an existing
-color table and resample it to fit your chosen data range, or use
-<a class="reference internal" href="grd2cpt.html"><em>grd2cpt</em></a> to build a CPT file based on
-the data distribution in one or more given grid files. However, in some
-situations you will need to make a CPT file by hand or using text tools
-like <strong>awk</strong> or <strong>perl</strong>.</p>
-<p>Color palette tables (CPT) comes in two flavors: (1) Those designed to
-work with categorical data (e.g., data where interpolation of values is
-undefined) and (2) those designed for regular, continuously-varying
-data. In both cases the <em>fill</em> information follows the format given in
-Section <a class="reference internal" href="#specifying-area-fill-attributes">Specifying area fill attributes</a>. The z-values in CPT files can
-be scaled by using the <strong>+u</strong>|<strong>U</strong><em>unit</em> mechanism. Append these
-modifiers to your CPT filenames when used in GMT commands. The <strong>+u</strong><em>unit</em>
-modifier will scale z <em>from unit to</em> meters, while <strong>+U</strong><em>unit</em> does
-the inverse (scale z <em>from meters to unit</em>).</p>
-<div class="section" id="categorical-cpt-files">
-<h3>9.17.1. Categorical CPT files<a class="headerlink" href="#categorical-cpt-files" title="Permalink to this headline">¶</a></h3>
-<p>Categorical data are information on which normal numerical operations
-are not defined. As an example, consider various land classifications
-(desert, forest, glacier, etc.) and it is clear that even if we assigned
-a numerical value to these categories (e.g., desert = 1, forest = 2,
-etc) it would be meaningless to compute average values (what would 1.5
-mean?). For such data a special format of the CPT files are provided.
-Here, each category is assigned a unique key, a color or pattern, and an
-optional label (usually the category name) marked by a leading
-semi-colon. Keys must be monotonically increasing but do not need to be
-consecutive. The format is</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="44%" />
-<col width="21%" />
-<col width="36%" />
-</colgroup>
-<tbody valign="top">
-<tr class="row-odd"><td>key<sub>1</sub></td>
-<td><em>Fill</em></td>
-<td>[;<em>label</em>]</td>
-</tr>
-<tr class="row-even"><td>...</td>
-<td> </td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td>key<sub>n</sub></td>
-<td><em>Fill</em></td>
-<td>[;<em>label</em>]</td>
-</tr>
-</tbody>
-</table>
-<p>The <em>Fill</em> information follows the format given in Section <a class="reference internal" href="#specifying-area-fill-attributes">Specifying area fill attributes</a>.
-While not always applicable to categorical data, the background color
-(for <em>key</em>-values < <img class="math" src="_images/math/10c14503c4ca38a5fd23f22f93567acbc9f34fab.png" alt="key_1"/>), foreground color (for
-<em>key</em>-values > <img class="math" src="_images/math/50350164c952c03e2a680975542ac943b17ebc6f.png" alt="key_{n}"/>), and not-a-number (NaN)
-color (for <em>key</em>-values = NaN) are all defined in the <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file, but can be
-overridden by the statements</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="19%" />
-<col width="81%" />
-</colgroup>
-<tbody valign="top">
-<tr class="row-odd"><td>B</td>
-<td>Fill<sub>back</sub></td>
-</tr>
-<tr class="row-even"><td>F</td>
-<td>Fill<sub>fore</sub></td>
-</tr>
-<tr class="row-odd"><td>N</td>
-<td>Fill<sub>nan</sub></td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="regular-cpt-files">
-<h3>9.17.2. Regular CPT files<a class="headerlink" href="#regular-cpt-files" title="Permalink to this headline">¶</a></h3>
-<p>Suitable for continuous data types and allowing for color
-interpolations, the format of the regular CPT files is:</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="16%" />
-<col width="21%" />
-<col width="16%" />
-<col width="21%" />
-<col width="11%" />
-<col width="15%" />
-</colgroup>
-<tbody valign="top">
-<tr class="row-odd"><td>z<sub>0</sub></td>
-<td>Color<sub>min</sub></td>
-<td>z<sub>1</sub></td>
-<td>Color<sub>max</sub></td>
-<td>[<strong>A</strong>]</td>
-<td>[;<em>label</em>]</td>
-</tr>
-<tr class="row-even"><td colspan="6">...</td>
-</tr>
-<tr class="row-odd"><td>z<sub>n-2</sub></td>
-<td>Color<sub>min</sub></td>
-<td>z<sub>n-1</sub></td>
-<td>Color<sub>max</sub></td>
-<td>[<strong>A</strong>]</td>
-<td>[;<em>label</em>]</td>
-</tr>
-</tbody>
-</table>
-<p>Thus, for each “<em>z</em>-slice”, defined as the interval between two
-boundaries (e.g., <img class="math" src="_images/math/693faad2f042b0565c90df7cfced16cb9413c166.png" alt="z_0"/> to <img class="math" src="_images/math/92c25fa25f006cdfe8ef28f3d3141e558aaac740.png" alt="z_1"/>), the color can be
-constant (by letting Color<img class="math" src="_images/math/b257c3b1343de1fd2a489ff0cb82636e790a339f.png" alt="_{max}"/> = Color<img class="math" src="_images/math/7e20a15268e648a91d5932a5212bcdb2b5b17922.png" alt="_{min}"/> or -)
-or a continuous, linear function of <em>z</em>. If patterns are used then the
-second (max) pattern must be set to -. The optional flag <strong>A</strong> is used
-to indicate annotation of the color scale when plotted using
-<a class="reference internal" href="psscale.html"><em>psscale</em></a>. The optional flag <strong>A</strong> may
-be <strong>L</strong>, <strong>U</strong>, or <strong>B</strong> to select annotation of the lower, upper, or
-both limits of the particular <em>z</em>-slice, respectively. However,
-the standard <strong>-B</strong> option can be used by
-<a class="reference internal" href="psscale.html"><em>psscale</em></a> to affect annotation and
-ticking of color scales. Just as other GMT programs, the <em>stride</em> can
-be omitted to determine the annotation and tick interval automatically
-(e.g., <strong>-Baf</strong>). The optional semicolon followed by a text label will
-make <a class="reference internal" href="psscale.html"><em>psscale</em></a>, when used with the
-<strong>-L</strong> option, place the supplied label instead of formatted <em>z</em>-values.</p>
-<p>As for categorical tables, the background color (for <em>z</em>-values
-< <img class="math" src="_images/math/693faad2f042b0565c90df7cfced16cb9413c166.png" alt="z_0"/>), foreground color (for <em>z</em>-values >
-<img class="math" src="_images/math/387801783066cdce72bb6d7a962d3179a9112f9e.png" alt="z_{n-1}"/>), and not-a-number (NaN) color (for <em>z</em>-values =
-NaN) are all defined in the <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file, but can be overridden by the
-statements</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="19%" />
-<col width="81%" />
-</colgroup>
-<tbody valign="top">
-<tr class="row-odd"><td>B</td>
-<td>Fill<sub>back</sub></td>
-</tr>
-<tr class="row-even"><td>F</td>
-<td>Fill<sub>fore</sub></td>
-</tr>
-<tr class="row-odd"><td>N</td>
-<td>Fill<sub>nan</sub></td>
-</tr>
-</tbody>
-</table>
-<p>which can be inserted into the beginning or end of the CPT file. If you
-prefer the HSV system, set the <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> parameter accordingly and replace red,
-green, blue with hue, saturation, value. Color palette tables that
-contain gray-shades only may replace the <em>r/g/b</em> triplets with a single
-gray-shade in the 0–255 range. For CMYK, give <em>c/m/y/k</em> values in the
-0–100 range.</p>
-<p>A few programs (i.e., those that plot polygons such as
-<a class="reference internal" href="grdview.html"><em>grdview</em></a>, <a class="reference internal" href="psscale.html"><em>psscale</em></a>,
-<a class="reference internal" href="psxy.html"><em>psxy</em></a> and
-<a class="reference internal" href="psxyz.html"><em>psxyz</em></a>) can accept pattern fills instead
-of gray-shades. You must specify the pattern as in Section <a class="reference internal" href="#specifying-area-fill-attributes">Specifying area fill attributes</a>
-(no leading <strong>-G</strong> of course), and only the first pattern (for low
-<em>z</em>) is used (we cannot interpolate between patterns). Finally,
-some programs let you skip features whose <em>z</em>-slice in the CPT
-file has gray-shades set to -. As an example, consider</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="15%" />
-<col width="26%" />
-<col width="38%" />
-<col width="21%" />
-</colgroup>
-<tbody valign="top">
-<tr class="row-odd"><td>30</td>
-<td>p200/16</td>
-<td>80</td>
-<td>-</td>
-</tr>
-<tr class="row-even"><td>80</td>
-<td>-</td>
-<td>100</td>
-<td>-</td>
-</tr>
-<tr class="row-odd"><td>100</td>
-<td>200/0/0</td>
-<td>200/255/255</td>
-<td>0</td>
-</tr>
-<tr class="row-even"><td>200</td>
-<td>yellow</td>
-<td>300</td>
-<td>green</td>
-</tr>
-</tbody>
-</table>
-<p>where slice 30 < z < 80 is painted with pattern # 16 at 200 dpi,
-slice 80 < z < 100 is skipped, slice 100 < z < 200 is
-painted in a range of dark red to yellow, whereas the slice
-200 < z < 300 will linearly yield colors from yellow to green,
-depending on the actual value of <em>z</em>.</p>
-<p>Some programs like <a class="reference internal" href="grdimage.html"><em>grdimage</em></a> and
-<a class="reference internal" href="grdview.html"><em>grdview</em></a> apply artificial illumination
-to achieve shaded relief maps. This is typically done by finding the
-directional gradient in the direction of the artificial light source and
-scaling the gradients to have approximately a normal distribution on the
-interval [-1,+1]. These intensities are used to add “white” or “black”
-to the color as defined by the <em>z</em>-values and the CPT file. An intensity
-of zero leaves the color unchanged. Higher values will brighten the
-color, lower values will darken it, all without changing the original
-hue of the color (see Appendix [app:I] for more details). The
-illumination is decoupled from the data grid file in that a separate
-grid file holding intensities in the [-1,+1] range must be provided.
-Such intensity files can be derived from the data grid using
-<a class="reference internal" href="grdgradient.html"><em>grdgradient</em></a> and modified with
-<a class="reference internal" href="grdhisteq.html"><em>grdhisteq</em></a>, but could equally well be
-a separate data set. E.g., some side-scan sonar systems collect both
-bathymetry and backscatter intensities, and one may want to use the
-latter information to specify the illumination of the colors defined by
-the former. Similarly, one could portray magnetic anomalies superimposed
-on topography by using the former for colors and the latter for shading.</p>
-</div>
-</div>
-<div class="section" id="the-drawing-of-vectors">
-<h2>9.18. The Drawing of Vectors<a class="headerlink" href="#the-drawing-of-vectors" title="Permalink to this headline">¶</a></h2>
-<p>GMT supports plotting vectors in various forms. A vector is one of
-many symbols that may be plotted by <a class="reference internal" href="psxy.html"><em>psxy</em></a>
-and <a class="reference internal" href="psxyz.html"><em>psxyz</em></a>, is the main feature in
-<a class="reference internal" href="grdvector.html"><em>grdvector</em></a>, and is indirectly used by
-other programs. All vectors plotted by GMT consist of two separate
-parts: The vector line (controlled by the chosen pen attributes) and the
-optional vector head(s) (controlled by the chosen fill). We distinguish
-between three types of vectors:</p>
-<ol class="arabic simple">
-<li>Cartesian vectors are plotted as straight lines. They can be
-specified by a start point and the direction and length (in map
-units) of the vector, or by its beginning and end point. They may
-also be specified giving the azimuth and length (in km) instead.</li>
-<li>Circular vectors are (as the name implies) drawn as circular arcs and
-can be used to indicate opening angles. It accepts an origin, a
-radius, and the beginning and end angles.</li>
-<li>Geo-vectors are drawn using great circle arcs. They are specified by
-a beginning point and the azimuth and length (in km) of the vector,
-or by its beginning and end point.</li>
-</ol>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_arrows.png"><img alt="_images/GMT_arrows.png" src="_images/GMT_arrows.png" style="width: 500px;" /></a>
-<p class="caption">Examples of Cartesian (left), circular (middle), and geo-vectors (right)
-for different attribute specifications. Note that both full and half
-arrow-heads can be specified, as well as no head at all.</p>
-</div>
-<p>There are numerous attributes you can modify, including how the vector
-should be justified relative to the given point (beginning, center, or
-end), where heads (if any) should be placed, if the head should just be
-the left or right half, if the vector attributes should shrink for
-vectors whose length are less than a given cutoff length, and the size
-and shape of the head. These attributes are detailed further in the
-relevant manual pages.</p>
-</div>
-<div class="section" id="character-escape-sequences">
-<h2>9.19. Character escape sequences<a class="headerlink" href="#character-escape-sequences" title="Permalink to this headline">¶</a></h2>
-<p>For annotation labels or text strings plotted with
-<a class="reference internal" href="pstext.html"><em>pstext</em></a>, GMT provides several escape
-sequences that allow the user to temporarily switch to the symbol font,
-turn on sub- or superscript, etc., within words. These conditions are
-toggled on/off by the escape sequence @<strong>x</strong>, where <strong>x</strong> can be one
-of several types. The escape sequences recognized in GMT are listed in
-Table <a class="reference internal" href="#tbl-escape"><em>escape</em></a>. Only one level of sub- or superscript is supported.
-Note that under Windows the percent symbol indicates a batch variable,
-hence you must use two percent-signs for each one required in the escape
-sequence for font switching.</p>
-<table border="1" class="docutils" id="tbl-escape">
-<colgroup>
-<col width="23%" />
-<col width="77%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"> </th>
-<th class="head"> </th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>@~</td>
-<td>Turns symbol font on or off</td>
-</tr>
-<tr class="row-odd"><td>@+</td>
-<td>Turns superscript on or off</td>
-</tr>
-<tr class="row-even"><td>@-</td>
-<td>Turns subscript on or off</td>
-</tr>
-<tr class="row-odd"><td>@#</td>
-<td>Turns small caps on or off</td>
-</tr>
-<tr class="row-even"><td>@_</td>
-<td>Turns underline on or off</td>
-</tr>
-<tr class="row-odd"><td>@%<em>fontno</em>%</td>
-<td>Switches to another font; @%% resets to previous font</td>
-</tr>
-<tr class="row-even"><td>@:<em>size</em>:</td>
-<td>Switches to another font size; @:: resets to previous size</td>
-</tr>
-<tr class="row-odd"><td>@;<em>color</em>;</td>
-<td>Switches to another font color; @;; resets to previous color</td>
-</tr>
-<tr class="row-even"><td>@!</td>
-<td>Creates one composite character of the next two characters</td>
-</tr>
-<tr class="row-odd"><td>@@</td>
-<td>Prints the @ sign itself</td>
-</tr>
-</tbody>
-</table>
-<p>Shorthand notation for a few special European characters has also been added:</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="23%" />
-<col width="27%" />
-<col width="23%" />
-<col width="27%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"><em>Code</em></th>
-<th class="head"><em>Effect</em></th>
-<th class="head"><em>Code</em></th>
-<th class="head"><em>Effect</em></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>@E</td>
-<td>Æ</td>
-<td>@e</td>
-<td>æ</td>
-</tr>
-<tr class="row-odd"><td>@O</td>
-<td>Ø</td>
-<td>@o</td>
-<td>ø</td>
-</tr>
-<tr class="row-even"><td>@A</td>
-<td>Å</td>
-<td>@a</td>
-<td>å</td>
-</tr>
-<tr class="row-odd"><td>@C</td>
-<td>Ç</td>
-<td>@c</td>
-<td>ç</td>
-</tr>
-<tr class="row-even"><td>@N</td>
-<td>Ñ</td>
-<td>@n</td>
-<td>ñ</td>
-</tr>
-<tr class="row-odd"><td>@U</td>
-<td>Ü</td>
-<td>@u</td>
-<td>ü</td>
-</tr>
-<tr class="row-even"><td>@s</td>
-<td>ß</td>
-<td> </td>
-<td> </td>
-</tr>
-</tbody>
-</table>
-<p>PostScript fonts used in GMT may be re-encoded to include several
-accented characters used in many European languages. To access these,
-you must specify the full octal code \xxx allowed for
-your choice of character encodings determined by the
-<a class="reference internal" href="gmt.conf.html#ps-char-encoding"><em>PS_CHAR_ENCODING</em></a> setting described in the
-<a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> man page. Only the special
-characters belonging to a particular encoding will be available. Many
-characters not directly available by using single octal codes may be
-constructed with the composite character mechanism @!.</p>
-<p>Some examples of escape sequences and embedded octal codes in
-GMT strings using the Standard+ encoding:</p>
-<div class="line-block">
-<div class="line"><tt class="docutils literal"><span class="pre">2@~p@~r@+2@+h@-0@-</span> <span class="pre">E\363tv\363s</span></tt> = 2<img class="math" src="_images/math/6b75387ee6cca3f5d8be8ee597ddf999e89fddb6.png" alt="\pi r^2h_0"/> Eötvös</div>
-<div class="line"><tt class="docutils literal"><span class="pre">10@+-3</span> <span class="pre">@Angstr@om</span></tt> = 10<img class="math" src="_images/math/c25c28183d05c687a78814901f4c72cd533bad55.png" alt="^{-3}"/> Ångstrøm</div>
-<div class="line"><tt class="docutils literal"><span class="pre">Se@nor</span> <span class="pre">Gar@con</span></tt> = Señor Garçon</div>
-<div class="line"><tt class="docutils literal"><span class="pre">M@!\305anoa</span> <span class="pre">stra@se</span></tt> = Manoa straße</div>
-<div class="line"><tt class="docutils literal"><span class="pre">A@\#cceleration@\#</span> <span class="pre">(ms@+-2@+)</span></tt> =</div>
-</div>
-<p>The option in <a class="reference internal" href="pstext.html"><em>pstext</em></a> to draw a
-rectangle surrounding the text will not work for strings with escape
-sequences. A chart of characters and their octal codes is given in
-Appendix [app:F].</p>
-</div>
-<div class="section" id="grid-file-format-specifications">
-<span id="grid-file-format"></span><h2>9.20. Grid file format specifications<a class="headerlink" href="#grid-file-format-specifications" title="Permalink to this headline">¶</a></h2>
-<p>GMT has the ability to read and write grids using
-more than one grid file format (see Table <a class="reference internal" href="#tbl-grdformats"><em>grdformats</em></a> for supported
-format and their IDs). For reading, GMT will automatically determine
-the format of grid files, while for writing you will normally have to
-append <em>=ID</em> to the filename if you want GMT to use a different format
-than the default.</p>
-<p>By default, GMT will create new grid files using the <strong>nf</strong> format;
-however, this behavior can be overridden by setting the
-<a class="reference internal" href="gmt.conf.html#io-gridfile-format"><em>IO_GRIDFILE_FORMAT</em></a> defaults parameter to any of the other
-recognized values (or by appending <em>=ID</em>).</p>
-<p>GMT can also read netCDF grid files produced by other software
-packages, provided the grid files satisfy the COARDS and Hadley Centre
-conventions for netCDF grids. Thus, products created under those
-conventions (provided the grid is 2-, 3-, 4-, or 5-dimensional) can be
-read directly by GMT and the netCDF grids written by GMT can be read
-by other programs that conform to those conventions. Three such programs are
-<a class="reference external" href="http://meteora.ucsd.edu/~pierce/ncview_home_page.html">ncview</a>, <a class="reference external" href="http://www.giss.nasa.gov/tools/panoply/">Panoply</a>, and <a class="reference external" href="http://www.epic.noaa.gov/java/ncBrowse/">ncBrowse</a> ; others can be found on the
-<a class="reference external" href="http://www.unidata.ucar.edu/software/netcdf/software.html">netCDF website</a>.</p>
-<p>In addition, users with some C-programming experience may add their own
-read/write functions and link them with the GMT library to extend the
-number of predefined formats. Technical information on this topic can be
-found in the source file <tt class="docutils literal"><span class="pre">gmt_customio.c</span></tt>. Users who are considering this approach
-should contact the GMT team.</p>
-<table border="1" class="docutils" id="tbl-grdformats">
-<colgroup>
-<col width="14%" />
-<col width="86%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"><strong>ID</strong></th>
-<th class="head"><strong>Explanation</strong></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td> </td>
-<td><em>GMT 4 netCDF standard formats</em></td>
-</tr>
-<tr class="row-odd"><td>nb</td>
-<td>GMT netCDF format (8-bit integer, COARDS, CF-1.5)</td>
-</tr>
-<tr class="row-even"><td>ns</td>
-<td>GMT netCDF format (16-bit integer, COARDS, CF-1.5)</td>
-</tr>
-<tr class="row-odd"><td>ni</td>
-<td>GMT netCDF format (32-bit integer, COARDS, CF-1.5)</td>
-</tr>
-<tr class="row-even"><td>nf</td>
-<td>GMT netCDF format (32-bit float, COARDS, CF-1.5)</td>
-</tr>
-<tr class="row-odd"><td>nd</td>
-<td>GMT netCDF format (64-bit float, COARDS, CF-1.5)</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td><em>GMT 3 netCDF legacy formats</em></td>
-</tr>
-<tr class="row-odd"><td>cb</td>
-<td>GMT netCDF format (8-bit integer, depreciated)</td>
-</tr>
-<tr class="row-even"><td>cs</td>
-<td>GMT netCDF format (16-bit integer, depreciated)</td>
-</tr>
-<tr class="row-odd"><td>ci</td>
-<td>GMT netCDF format (32-bit integer, depreciated)</td>
-</tr>
-<tr class="row-even"><td>cf</td>
-<td>GMT netCDF format (32-bit float, depreciated)</td>
-</tr>
-<tr class="row-odd"><td>cd</td>
-<td>GMT netCDF format (64-bit float, depreciated)</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td><em>GMT native binary formats</em></td>
-</tr>
-<tr class="row-odd"><td>bm</td>
-<td>GMT native, C-binary format (bit-mask)</td>
-</tr>
-<tr class="row-even"><td>bb</td>
-<td>GMT native, C-binary format (8-bit integer)</td>
-</tr>
-<tr class="row-odd"><td>bs</td>
-<td>GMT native, C-binary format (16-bit integer)</td>
-</tr>
-<tr class="row-even"><td>bi</td>
-<td>GMT native, C-binary format (32-bit integer)</td>
-</tr>
-<tr class="row-odd"><td>bf</td>
-<td>GMT native, C-binary format (32-bit float)</td>
-</tr>
-<tr class="row-even"><td>bd</td>
-<td>GMT native, C-binary format (32-bit float)</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td><em>Miscellaneous grid formats</em></td>
-</tr>
-<tr class="row-even"><td>rb</td>
-<td>SUN raster file format (8-bit standard)</td>
-</tr>
-<tr class="row-odd"><td>rf</td>
-<td>GEODAS grid format GRD98 (NGDC)</td>
-</tr>
-<tr class="row-even"><td>sf</td>
-<td>Golden Software Surfer format 6 (32-bit float)</td>
-</tr>
-<tr class="row-odd"><td>sd</td>
-<td>Golden Software Surfer format 7 (64-bit float)</td>
-</tr>
-<tr class="row-even"><td>af</td>
-<td>Atlantic Geoscience Center AGC (32-bit float)</td>
-</tr>
-<tr class="row-odd"><td>ei</td>
-<td>ESRI Arc/Info ASCII Grid Interchange format (ASCII integer)</td>
-</tr>
-<tr class="row-even"><td>ef</td>
-<td>ESRI Arc/Info ASCII Grid Interchange format (ASCII float)</td>
-</tr>
-<tr class="row-odd"><td>gd</td>
-<td>Import/export via GDAL <a class="footnote-reference" href="#id66" id="id21">[19]</a></td>
-</tr>
-</tbody>
-</table>
-<p>Because some formats have limitations on the range of values they can
-store it is sometimes necessary to provide more than simply the name of
-the file and its ID on the command line. For instance, a native short
-integer file may use a unique value to signify an empty node or NaN, and
-the data may need translation and scaling prior to use. Therefore, all
-GMT programs that read or write grid files will decode the given
-filename as follows:</p>
-<p>name[=<em>ID</em>[/<em>scale</em>/<em>offset</em>[/<em>nan</em>]]]</p>
-<p>where everything in brackets is optional. If you are reading a grid then
-no options are needed: just continue to pass the name of the grid file.
-However, if you write another format you must append the =<em>ID</em> string,
-where <em>ID</em> is the format code listed above. In addition, should you want
-to (1) multiply the data by a scale factor, and (2) add a constant
-offset you must append the /<em>scale</em>/<em>offset</em> modifier. Finally, if you
-need to indicate that a certain data value should be interpreted as a
-NaN (not-a-number) you must append the /<em>nan</em> suffix to the scaling
-string (it cannot go by itself; note the nesting of the brackets!). The
-/<em>scale</em> and /<em>offset</em> modifiers may be left empty to select default
-values (scale = 1, offset = 0), or you may specify <em>a</em> for
-auto-adjusting the scale and/or offset of packed integer grids
-(=<em>ID</em>/<em>a</em> is a shorthand for =<em>ID</em>/<em>a</em>/<em>a</em>).</p>
-<p>Some of the grid formats allow writing to standard output and reading
-from standard input which means you can connect GMT programs that
-operate on grid files with pipes, thereby speeding up execution and
-eliminating the need for large, intermediate grid files. You specify
-standard input/output by leaving out the filename entirely. That means
-the “filename” will begin with “=<em>ID</em>”. Note, that the netCDF format
-does not allow piping.</p>
-<p>Everything looks clearer after a few examples:</p>
-<ul class="simple">
-<li>To write a native binary float grid file, specify the name as <tt class="docutils literal"><span class="pre">my_file.f4=bf</span></tt> .</li>
-<li>To read a native short integer grid file, multiply the data by 10 and
-then add 32000, but first let values that equal 32767 be set to NaN,
-use the filename <tt class="docutils literal"><span class="pre">my_file.i2=bs/10/32000/32767</span></tt>.</li>
-<li>To read a Golden Software “surfer” format 6 grid file, just pass the
-file name, e.g., <tt class="docutils literal"><span class="pre">my_surferfile.grd</span></tt>.</li>
-<li>To read a 8-bit standard Sun raster file (with values in the 0–255
-range) and convert it to a 1 range, give the name as <tt class="docutils literal"><span class="pre">rasterfile=rb/7.84313725e-3/-1</span></tt> (i.e., 1/127.5).</li>
-<li>To write a native binary short integer grid file to standard output
-after subtracting 32000 and dividing its values by 10, give filename
-as <tt class="docutils literal"><span class="pre">=bs/0.1/-3200</span></tt>.</li>
-<li>To write an 8-bit integer netCDF grid file with an auto-adjusted
-offset, give filename as <tt class="docutils literal"><span class="pre">=nb//a</span></tt>.</li>
-</ul>
-<p>Programs that both read and/or write more than one grid file may specify
-different formats and/or scaling for the files involved. The only
-restriction with the embedded grid specification mechanism is that no
-grid files may actually use the “=” character as part of their name
-(presumably, a small sacrifice).</p>
-<p>One can also define special file suffixes to imply a specific file
-format; this approach represents a more intuitive and user-friendly way
-to specify the various file formats. The user may create a file called
-<tt class="docutils literal"><span class="pre">gmt.io</span></tt> in the current directory or home directory, or in the directory
-<tt class="docutils literal"><span class="pre">~/.gmt</span></tt> and define any number of custom formats. The following is an example of
-a <tt class="docutils literal"><span class="pre">gmt.io</span></tt> file:</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="10%" />
-<col width="7%" />
-<col width="7%" />
-<col width="4%" />
-<col width="10%" />
-<col width="61%" />
-</colgroup>
-<tbody valign="top">
-<tr class="row-odd"><td colspan="6"># suffix format_id scale offset NaNxxxComments # GMT i/o shorthand file
-# It can have any number of comment lines like this one anywhere
-# suffix format_id scale offset NaNComments</td>
-</tr>
-<tr class="row-even"><td>grd</td>
-<td>nf</td>
-<td>-</td>
-<td>-</td>
-<td>-</td>
-<td>Default format</td>
-</tr>
-<tr class="row-odd"><td>b</td>
-<td>bf</td>
-<td>-</td>
-<td>-</td>
-<td>-</td>
-<td>Native binary floats</td>
-</tr>
-<tr class="row-even"><td>i2</td>
-<td>bs</td>
-<td>-</td>
-<td>-</td>
-<td>32767</td>
-<td>2-byte integers with NaN value</td>
-</tr>
-<tr class="row-odd"><td>ras</td>
-<td>rb</td>
-<td>-</td>
-<td>-</td>
-<td>-</td>
-<td>Sun raster files</td>
-</tr>
-<tr class="row-even"><td>byte</td>
-<td>bb</td>
-<td>-</td>
-<td>-</td>
-<td>255</td>
-<td>Native binary 1-byte grids</td>
-</tr>
-<tr class="row-odd"><td>bit</td>
-<td>bm</td>
-<td>-</td>
-<td>-</td>
-<td>-</td>
-<td>Native binary 0 or 1 grids</td>
-</tr>
-<tr class="row-even"><td>mask</td>
-<td>bm</td>
-<td>-</td>
-<td>-</td>
-<td>0</td>
-<td>Native binary 1 or NaN masks</td>
-</tr>
-<tr class="row-odd"><td>faa</td>
-<td>bs</td>
-<td>0.1</td>
-<td>-</td>
-<td>32767</td>
-<td>Native binary gravity in 0.1 mGal</td>
-</tr>
-<tr class="row-even"><td>ns</td>
-<td>ns</td>
-<td>a</td>
-<td>a</td>
-<td>-</td>
-<td>16-bit integer netCDF grid with
-auto-scale and auto-offset</td>
-</tr>
-</tbody>
-</table>
-<p>These suffices can be anything that makes sense to the user. To activate
-this mechanism, set parameter <a class="reference internal" href="gmt.conf.html#io-gridfile-shorthand"><em>IO_GRIDFILE_SHORTHAND</em></a> to TRUE in
-your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file. Then, using the filename <tt class="docutils literal"><span class="pre">stuff.i2</span></tt> is equivalent to saying <tt class="docutils literal"><span class="pre">stuff.i2=bs///32767</span></tt>, and the
-filename <tt class="docutils literal"><span class="pre">wet.mask</span></tt> means wet.mask=bm/1/0/0. For a file intended for masking, i.e.,
-the nodes are either 1 or NaN, the bit or mask format file may be as
-small as 1/32 the size of the corresponding grid float format file.</p>
-</div>
-<div class="section" id="modifiers-for-changing-the-grid-coordinates">
-<h2>9.21. Modifiers for changing the grid coordinates<a class="headerlink" href="#modifiers-for-changing-the-grid-coordinates" title="Permalink to this headline">¶</a></h2>
-<p>A few GMT tools require that the two horizontal dimensions be
-specified in meters. One example is
-<a class="reference internal" href="grdfft.html"><em>grdfft</em></a> which must compute the 2-D
-Fourier transform of a grid and evaluate wavenumbers in the proper units
-(1/meter). There are two situations where the user may need to change
-the coordinates of the grid passed to such programs:</p>
-<ul class="simple">
-<li>You have a geographic grid (i.e., in longitude and latitude). Simply
-supply the <strong>-fg</strong> option and your grid coordinates will
-automatically be converted to meters via a “Flat Earth” approximation
-on the currently selected ellipsoid (Note: this is only possible in
-those few programs that require this capability. In general, <strong>-fg</strong>
-is used to specify table coordinates).</li>
-<li>You have a Cartesian grid but the units are not meters (e.g., they
-may perhaps be in km or miles). In this case you may append the file
-modifier <strong>+u</strong><em>unit</em>, where <em>unit</em> is one of non-arc units listed
-in Table <a class="reference internal" href="#tbl-distunits"><em>distunits</em></a>. For example, reading in the grid (which has
-distance units of km) and converting them to meters is done by
-specifying the filename as <em>filename</em><strong>+u</strong>k. On output, any derived grids will revert
-to their original units <em>unless</em> you specify another unit modifier to
-the output grid. This may be used, for instance, to save the original
-grid with distances in meters using some other unit.</li>
-</ul>
-<p>For convenience, we also support the inverse translation, i.e.,
-<strong>+U</strong><em>unit</em>. This modifier can be used to convert your grid
-coordinates <em>from</em> meters <em>to</em> the specified unit. Example 28 shows a
-case where this is being used to change an UTM grid in meters to km.
-These modifiers are only allowed when map projections are not selected
-(or are Cartesian).</p>
-</div>
-<div class="section" id="modifiers-for-coards-compliant-netcdf-files">
-<h2>9.22. Modifiers for COARDS-compliant netCDF files<a class="headerlink" href="#modifiers-for-coards-compliant-netcdf-files" title="Permalink to this headline">¶</a></h2>
-<p>When the netCDF grid file contains more than one 2-dimensional variable,
-GMT programs will load the first such variable in the file and ignore
-all others. Alternatively, the user can select the required variable by
-adding the suffix ”?<em>varname</em>” to the grid file name. For example, to
-get information on the variable “slp” in file , use:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt grdinfo <span class="s2">"file.nc?slp"</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>Since COARDS-compliant netCDF files are the default, the additional
-suffix “=nf” can be omitted.</p>
-<p>In case the named grid is 3-dimensional, GMT will load the first
-(bottom) layer. If another layer is required, either add “[<em>index</em>]”
-or “(<em>level</em>)”, where <em>index</em> is the index of the third (depth) variable
-(starting at 0 for the first layer) and <em>level</em> is the numerical value
-of the third (depth) variable associated with the requested layer. To
-indicate the second layer of the 3-D variable “slp” use as file name: <tt class="docutils literal"><span class="pre">file.nc?slp[1]</span></tt>.</p>
-<p>When you supply the numerical value for the third variable using
-“(<em>level</em>)”, GMT will pick the layer closest to that value. No
-interpolation is performed.</p>
-<p>Note that the question mark, brackets and parentheses have special
-meanings on Unix-based platforms. Therefore, you will need to either
-<em>escape</em> these characters, by placing a backslash in front of them, or
-place the whole file name plus modifiers between single quotes or double
-quotes.</p>
-<p>A similar approach is followed for loading 4-dimensional grids. Consider
-a 4-dimensional grid with the following variables:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>lat<span class="o">(</span>lat<span class="o">)</span>: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9
-lon<span class="o">(</span>lon<span class="o">)</span>: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9
-depth<span class="o">(</span>depth<span class="o">)</span>: 0, 10, 20, 30, 40, 50, 60, 70, 80, 90
-<span class="nb">time</span><span class="o">(</span><span class="nb">time</span><span class="o">)</span>: 0, 12, 24, 36, 48
-pressure<span class="o">(</span><span class="nb">time</span>,depth,lat,lon<span class="o">)</span>: <span class="o">(</span><span class="m">5000</span> values<span class="o">)</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>To get information on the 10x10 grid of pressure at
-depth 10 and at time 24, one would use:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt grdinfo <span class="s2">"file.nc?pressure[2,1]"</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>or (only in case the coordinates increase linearly):</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt grdinfo <span class="s2">"file.nc?pressure(24,10)"</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>Programs that generally deal with columns of one-dimensional data, like
-or can use multi-dimensional netCDF files in a very similar way. If a
-variable in a netCDF file is one-dimensional, there is nothing more
-needed than name the variables on the command line. For example:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt psxy <span class="s2">"file.nc?lon/lat"</span> ...
-gmt gmtconvert <span class="s2">"file.nc?time/lat/lon"</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>If one or more of the selected variables are two-dimensional, and have
-the same leading dimension as the other selected variables they will be
-plotted in their entirety. For example, if a netCDF files contains 6
-time steps recording temperature at 4 points, and the variable <tt class="docutils literal"><span class="pre">temp</span></tt> is a 6 by
-4 array, then the command <tt class="docutils literal"><span class="pre">gmtconvert</span> <span class="pre">"file.nc?time/temp"</span></tt> can result in:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>2012-06-25T00:00:00 20.1 20.2 20.1 20.3
-2012-06-25T12:00:00 24.2 23.2 24.5 23.5
-2012-06-26T00:00:00 16.1 16.2 16.1 16.3
-2012-06-26T12:00:00 22.1 23.0 23.9 23.5
-2012-06-27T00:00:00 17.5 16.9 17.2 16.8
-2012-06-27T12:00:00 27.2 27.2 27.5 27.5
-</pre></div>
-</div>
-</div></blockquote>
-<p>If, for example, only the second temperature column is needed, use
-<tt class="docutils literal"><span class="pre">gmt</span> <span class="pre">gmtconvert</span> <span class="pre">"file.nc?time/temp[1]"</span></tt> (indices start counting at 0).</p>
-<p>The COARDS conventions set restrictions on the names that can be used
-for the units of the variables and coordinates. For example, the units
-of longitude and latitude are “degrees_east” and “degrees_north”,
-respectively. Here is an example of the header of a COARDS compliant
-netCDF file (to be obtained using <strong>ncdump</strong>):</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>netcdf M2_fes2004 <span class="o">{</span>
-dimensions:
- <span class="nv">lon</span> <span class="o">=</span> <span class="m">2881</span> <span class="p">;</span>
- <span class="nv">lat</span> <span class="o">=</span> <span class="m">1441</span> <span class="p">;</span>
-variables:
- float lon<span class="o">(</span>lon<span class="o">)</span> <span class="p">;</span>
- lon:long_name <span class="o">=</span> <span class="s2">"longitude"</span> <span class="p">;</span>
- lon:units <span class="o">=</span> <span class="s2">"degrees_east"</span> <span class="p">;</span>
- lon:actual_range <span class="o">=</span> 0., 360. <span class="p">;</span>
- float lat<span class="o">(</span>lat<span class="o">)</span> <span class="p">;</span>
- lat:long_name <span class="o">=</span> <span class="s2">"latitude"</span> <span class="p">;</span>
- lat:units <span class="o">=</span> <span class="s2">"degrees_north"</span> <span class="p">;</span>
- lat:actual_range <span class="o">=</span> -90., 90. <span class="p">;</span>
- short amp<span class="o">(</span>lat, lon<span class="o">)</span> <span class="p">;</span>
- amp:long_name <span class="o">=</span> <span class="s2">"amplitude"</span> <span class="p">;</span>
- amp:unit <span class="o">=</span> <span class="s2">"m"</span> <span class="p">;</span>
- amp:scale_factor <span class="o">=</span> 0.0001 <span class="p">;</span>
- amp:add_offset <span class="o">=</span> 3. <span class="p">;</span>
- amp:_FillValue <span class="o">=</span> -32768s <span class="p">;</span>
- short pha<span class="o">(</span>lat, lon<span class="o">)</span> <span class="p">;</span>
- pha:long_name <span class="o">=</span> <span class="s2">"phase"</span> <span class="p">;</span>
- pha:unit <span class="o">=</span> <span class="s2">"degrees"</span> <span class="p">;</span>
- pha:scale_factor <span class="o">=</span> 0.01 <span class="p">;</span>
- pha:_FillValue <span class="o">=</span> -32768s <span class="p">;</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>This file contains two grids, which can be plotted separately using the
-names <tt class="docutils literal"><span class="pre">M2_fes2004.nc?amp</span></tt> and <tt class="docutils literal"><span class="pre">M2_fes2004.nc?pha</span></tt>. The attributes <tt class="docutils literal"><span class="pre">long_name</span></tt> and <tt class="docutils literal"><span class="pre">unit</span></tt> for each variable
-are combined in GMT to a single unit string. For example, after
-reading the grid <tt class="docutils literal"><span class="pre">y_unit</span></tt> equals <tt class="docutils literal"><span class="pre">latitude</span> <span class="pre">[degrees_north]</span></tt>. The
-same method can be used in reverse to set the proper variable names and
-units when writing a grid. However, when the coordinates are set
-properly as geographical or time axes, GMT will take care of this. The
-user is, however, still responsible for setting the variable name and
-unit of the z-coordinate. The default is simply “z”.</p>
-</div>
-<div class="section" id="modifiers-to-read-and-write-grids-and-images-via-gdal">
-<h2>9.23. Modifiers to read and write grids and images via GDAL<a class="headerlink" href="#modifiers-to-read-and-write-grids-and-images-via-gdal" title="Permalink to this headline">¶</a></h2>
-<p>If the support has been configured during installation, then GMT can
-read and write a variety of grid and image formats via GDAL. This
-extends the capability of GMT to handle data sets from a variety of
-sources.</p>
-<div class="section" id="reading-multi-band-images">
-<h3>9.23.1. Reading multi-band images<a class="headerlink" href="#reading-multi-band-images" title="Permalink to this headline">¶</a></h3>
-<p><a class="reference internal" href="grdimage.html"><em>grdimage</em></a> and <a class="reference internal" href="psimage.html"><em>psimage</em></a> both lets the user select
-individual bands in a multi-band image file and treats the result as an
-image (that is the values, in the 0–255 range, are treated as colors,
-not data). To select individual bands you use the <strong>+b</strong><em>band-number</em>
-mechanism that must be appended to the image filename. Here,
-<em>band-number</em> can be the number of one individual band (the counting
-starts at zero), or it could be a comma-separated list of bands. For example</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt psimage jpeg_image_with_three_bands.jpg+b0
-</pre></div>
-</div>
-</div></blockquote>
-<p>will plot only the first band (i.e., the red band) of the jpeg image as
-a gray-scale image, and</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt psimage jpeg_image_with_three_bands.jpg+b2,1,0
-</pre></div>
-</div>
-</div></blockquote>
-<p>will plot the same image in color but where the RGB band order has been reversed.</p>
-<p>Instead of treating them as images, all other GMT programs that
-process grids can read individual bands from an image but will consider
-the values to be regular data. For example, let <tt class="docutils literal"><span class="pre">multiband</span></tt> be the name of a
-multi-band file with a near infrared component in band 4 and red in band
-3. We will compute the NDVI (Normalized Difference Vegetation Index),
-which is defined as NDVI = (NIR - R) / (NIR + R), as</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt grdmath <span class="nv">multiband</span><span class="o">=</span>gd+b3 <span class="nv">multiband</span><span class="o">=</span>gd+b2 SUB <span class="nv">multiband</span><span class="o">=</span>gd+b3 <span class="se">\</span>
- <span class="nv">multiband</span><span class="o">=</span>gd+b2 ADD <span class="nv">DIV</span> <span class="o">=</span> ndvi.nc
-</pre></div>
-</div>
-</div></blockquote>
-<p>The resulting grid <tt class="docutils literal"><span class="pre">ndvi.nc</span></tt> can then be plotted as usual.</p>
-</div>
-<div class="section" id="reading-more-complex-multi-band-images-or-grids">
-<h3>9.23.2. Reading more complex multi-band IMAGES or GRIDS<a class="headerlink" href="#reading-more-complex-multi-band-images-or-grids" title="Permalink to this headline">¶</a></h3>
-<p>It is also possible to access to sub-datasets in a multi-band grid. The
-next example shows how we can extract the SST from the MODIS file <tt class="docutils literal"><span class="pre">A20030012003365.L3m_YR_NSST_9</span></tt>
-that is stored in the HDF “format”. We need to run the GDAL program
-<strong>gdalinfo</strong> on the file because we first
-must extract the necessary metadata from the file:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gdalinfo A20030012003365.L3m_YR_NSST_9
-Driver: HDF4/Hierarchical Data Format Release 4
-Files: A20030012003365.L3m_YR_NSST_9
-Size is 512, 512
-Coordinate System is `'
-Metadata:
- Product Name=A20030012003365.L3m_YR_NSST_9
- Sensor Name=MODISA
- Sensor=
- Title=MODISA Level-3 Standard Mapped Image
-...
- Scaling=linear
- Scaling Equation=(Slope*l3m_data) + Intercept = Parameter value
- Slope=0.000717185
- Intercept=-2
- Scaled Data Minimum=-2
- Scaled Data Maximum=45
- Data Minimum=-1.999999
- Data Maximum=34.76
-Subdatasets:
- SUBDATASET_1_NAME=HDF4_SDS:UNKNOWN:"A20030012003365.L3m_YR_NSST_9":0
- SUBDATASET_1_DESC=[2160x4320] l3m_data (16-bit unsigned integer)
- SUBDATASET_2_NAME=HDF4_SDS:UNKNOWN:"A20030012003365.L3m_YR_NSST_9":1
- SUBDATASET_2_DESC=[2160x4320] l3m_qual (8-bit unsigned integer)
-</pre></div>
-</div>
-</div></blockquote>
-<p>Now, to access this file with GMT we need to use the =gd mechanism and
-append the name of the sub-dataset that we want to extract. Here, a
-simple example using <a class="reference internal" href="grdinfo.html"><em>grdinfo</em></a> would be</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>grdinfo A20030012003365.L3m_YR_NSST_9<span class="o">=</span>gd?HDF4_SDS:UNKNOWN:<span class="s2">"A20030012003365.L3m_YR_NSST_9:0"</span>
-
-HDF4_SDS:UNKNOWN:A20030012003365.L3m_YR_NSST_9:0: Title: Grid imported via GDAL
-HDF4_SDS:UNKNOWN:A20030012003365.L3m_YR_NSST_9:0: Command:
-HDF4_SDS:UNKNOWN:A20030012003365.L3m_YR_NSST_9:0: Remark:
-HDF4_SDS:UNKNOWN:A20030012003365.L3m_YR_NSST_9:0: Gridline node registration used
-HDF4_SDS:UNKNOWN:A20030012003365.L3m_YR_NSST_9:0: Grid file format: <span class="nv">gd</span> <span class="o">=</span> Import through GDAL <span class="o">(</span>convert to float<span class="o">)</span>
-HDF4_SDS:UNKNOWN:A20030012003365.L3m_YR_NSST_9:0: x_min: 0.5 x_max: 4319.5 x_inc: <span class="m">1</span> name: x nx: 4320
-HDF4_SDS:UNKNOWN:A20030012003365.L3m_YR_NSST_9:0: y_min: 0.5 y_max: 2159.5 y_inc: <span class="m">1</span> name: y ny: 2160
-HDF4_SDS:UNKNOWN:A20030012003365.L3m_YR_NSST_9:0: z_min: <span class="m">0</span> z_max: <span class="m">65535</span> name: z
-HDF4_SDS:UNKNOWN:A20030012003365.L3m_YR_NSST_9:0: scale_factor: <span class="m">1</span> add_offset: 0
-</pre></div>
-</div>
-</div></blockquote>
-<p>Be warned, however, that things are not yet completed because while the
-data are scaled according to the equation printed above (“Scaling
-Equation=(Slope*l3m_data) + Intercept = Parameter value”), this
-scaling is not applied by GDAL on reading so it cannot be done
-automatically by GMT. One solution is to do the reading and scaling
-via <a class="reference internal" href="grdmath.html"><em>grdmath</em></a> first, i.e.,</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt grdmath A20030012003365.L3m_YR_NSST_9<span class="o">=</span>gd?HDF4_SDS:UNKNOWN:<span class="s2">"A20030012003365.L3m_YR_NSST_9:0"</span> <span class="se">\</span>
- 0.000717185 MUL -2 <span class="nv">ADD</span> <span class="o">=</span> sst.nc
-</pre></div>
-</div>
-</div></blockquote>
-<p>then plot the <tt class="docutils literal"><span class="pre">sst.nc</span></tt> directly.</p>
-</div>
-<div class="section" id="writing-grids-and-images">
-<h3>9.23.3. Writing grids and images<a class="headerlink" href="#writing-grids-and-images" title="Permalink to this headline">¶</a></h3>
-<p>Saving images in the common raster formats is possible but, for the time
-being, only from <a class="reference internal" href="grdimage.html"><em>grdimage</em></a> and even
-that is restricted to raster type information. That is, vector data (for
-instance, coast lines) or text will not be saved. To save an image with
-<a class="reference internal" href="grdimage.html"><em>grdimage</em></a> use the
-<strong>-A</strong><em>outimg=driver</em> mechanism, where <em>driver</em> is the driver code
-name used by GDAL (e.g. GTiff).</p>
-<p>For all other programs that create grids, it is also possible to save
-them using GDAL. To do it one need to use the =gd appended with the
-necessary information regarding the driver and the data type to use.
-Generically, =<strong>gd</strong>[/<em>scale</em>/<em>offset</em>[/<em>nan</em>][:<<em>driver</em>>[/<em>dataType</em>]]
-where <em>driver</em> is the same as explained above and <em>dataType</em> is a 2 or 3
-chars code from: u8|u16|i16|u32|i32|float32, and where i|u denotes
-signed|unsigned. If not provided the default type is float32. Both
-driver names and data types are case insensitive. Note, that you have to
-specify <em>nan</em> for integer types unless you whish that all NaN data values
-are replaced by zero.</p>
-</div>
-</div>
-<div class="section" id="the-nan-data-value">
-<h2>9.24. The NaN data value<a class="headerlink" href="#the-nan-data-value" title="Permalink to this headline">¶</a></h2>
-<p>For a variety of data processing and plotting tasks there is a need to
-acknowledge that a data point is missing or unassigned. In the “old
-days” such information was passed by letting a value like -9999.99 take
-on the special meaning of “this is not really a value, it is missing”.
-The problem with this scheme is that -9999.99 (or any other floating
-point value) may be a perfectly reasonable data value and in such a
-scenario would be skipped. The solution adopted in GMT is to use the
-IEEE concept Not-a-Number (NaN) for this purpose. Mathematically, a NaN
-is what you get if you do an undefined mathematical operation like
-0/0; in ASCII data files they appear as the textstring NaN. This
-value is internally stored with a particular bit pattern defined by IEEE
-so that special action can be taken when it is encountered by programs.
-In particular, a standard library function called <tt class="docutils literal"><span class="pre">isnan</span></tt> is used to
-test if a floating point is a NaN. GMT uses these tests extensively to
-determine if a value is suitable for plotting or processing (if a NaN is
-used in a calculation the result would become NaN as well). Data points
-whose values equal NaN are not normally plotted (or plotted with the
-special NaN color given in <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>). Several tools such as
-<a class="reference internal" href="xyz2grd.html"><em>xyz2grd</em></a>, <a class="reference internal" href="gmtmath.html"><em>gmtmath</em></a>, and
-<a class="reference internal" href="grdmath.html"><em>grdmath</em></a> can convert user data to NaN
-and vice versa, thus facilitating arbitrary masking and clipping of data
-sets. Note that a few computers do not have native IEEE hardware
-support. At this point, this applies to some of the older Cray
-super-computers. Users on such machines may have to adopt the old
-‘-9999.99’ scheme to achieve the desired results.</p>
-<p>Data records that contain NaN values for the <em>x</em> or <em>y</em> columns (or the
-<em>z</em> column for cases when 3-D Cartesian data are expected) are usually
-skipped during reading. However, the presence of these bad records can
-be interpreted in two different ways, and this behavior is controlled by
-the <a class="reference internal" href="gmt.conf.html#io-nan-records"><em>IO_NAN_RECORDS</em></a> defaults parameter. The default setting (<em>gap</em>)
-considers such records to indicate a gap in an otherwise continuous
-series of points (e.g., a line), and programs can act upon this
-information, e.g., not to draw a line across the gap or to break the
-line into separate segments. The alternative setting (<em>bad</em>) makes no
-such interpretation and simply reports back how many bad records were
-skipped during reading; see Section <a class="reference internal" href="#data-gap-detection-the-g-option">Data gap detection: The -g option</a> for details.</p>
-</div>
-<div class="section" id="directory-parameters">
-<span id="id22"></span><h2>9.25. Directory parameters<a class="headerlink" href="#directory-parameters" title="Permalink to this headline">¶</a></h2>
-<p>GMT versions prior to GMT 5 relied solely on several environment variables
-($GMT_SHAREDIR, $GMT_DATADIR, $GMT_USERDIR, and $GMT_TMPDIR), pointing
-to folders with data files and program settings. Beginning with version
-5, some of these locations are now (also or exclusively) configurable
-with the <a class="reference internal" href="gmtset.html"><em>gmtset</em></a> utility.
-When an environment variable has an equivalent parameter in the <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file,
-then the parameter setting will take precedence over the environment variable.</p>
-<dl class="docutils">
-<dt>Variable $GMT_SHAREDIR</dt>
-<dd>was sometimes required in previous GMT versions to locate the GMT
-share directory where all run-time support files such as coastlines,
-custom symbols, PostScript macros, color tables, and much more reside.
-If this parameter is not set (default), GMT will make a reasonable
-guess of the location of its share folder. Setting this variable is
-usually not required and recommended only under special circumstances.</dd>
-<dt>Variable $GMT_DATADIR and parameter DIR_DATA</dt>
-<dd>may point to one or more directories where large and/or widely used
-data files can be placed. All GMT programs look in these directories
-when a file is specified on the command line and it is not present in
-the current directory. This allows maintainers to consolidate large
-data files and to simplify scripting that use these files since the
-absolute path need not be specified. Separate multiple directories
-with colons (:) – under Windows use semi-colons (;). Any directory
-name that ends in a trailing slash (/) will be searched recursively
-(not under Windows).</dd>
-<dt>Variable $GMT_USERDIR</dt>
-<dd>may point to a directory where the user places custom configuration
-files (e.g., an alternate <tt class="docutils literal"><span class="pre">coastline.conf</span></tt> file, preferred default
-settings in <tt class="docutils literal"><span class="pre">gmt.conf</span></tt>, custom symbols and color palettes, math
-macros for <a class="reference internal" href="gmtmath.html"><em>gmtmath</em></a> and <a class="reference internal" href="grdmath.html"><em>grdmath</em></a>, and shorthands for
-gridfile extensions via <tt class="docutils literal"><span class="pre">gmt_io</span></tt>). When $GMT_USERDIR is not defined,
-then the default value $HOME/.gmt will be assumed. Users may also place their own
-data files in this directory as GMT programs will search for files
-given on the command line in both DIR_DATA and $GMT_USERDIR.</dd>
-<dt>Variable $GMT_TMPDIR</dt>
-<dd>may indicate the location, where GMT will write its state parameters
-via the two files <tt class="docutils literal"><span class="pre">gmt.history</span></tt> and <tt class="docutils literal"><span class="pre">gmt.conf</span></tt>. If $GMT_TMPDIR is not
-set, these files are written to the current directory. See Section
-<a class="reference internal" href="#isolation-mode">Isolation mode</a> for more information.</dd>
-<dt>Parameter DIR_DCW</dt>
-<dd>specifies where to look for the optional Digital Charts of the World
-database (for country coloring or selections).</dd>
-<dt>Parameter DIR_GSHHG</dt>
-<dd>specifies where to look for the required
-Global Self-consistent Hierarchical High-resolution Geography database.</dd>
-</dl>
-<p>Note that files whose full path is given will never be searched for in
-any of these directories.</p>
-</div>
-</div>
-<div class="section" id="gmt-coordinate-transformations">
-<h1>10. GMT Coordinate Transformations<a class="headerlink" href="#gmt-coordinate-transformations" title="Permalink to this headline">¶</a></h1>
-<p>GMT programs read real-world coordinates and convert them to positions
-on a plot. This is achieved by selecting one of several coordinate
-transformations or projections. We distinguish between three sets of
-such conversions:</p>
-<ul class="simple">
-<li>Cartesian coordinate transformations</li>
-<li>Polar coordinate transformations</li>
-<li>Map coordinate transformations</li>
-</ul>
-<p>The next chapter will be dedicated to GMT map projections in its
-entirety. Meanwhile, the present chapter will summarize the properties
-of the Cartesian and Polar coordinate transformations available in
-GMT, list which parameters define them, and demonstrate how they are
-used to create simple plot axes. We will mostly be using
-<a class="reference internal" href="psbasemap.html"><em>psbasemap</em></a> (and occasionally
-<a class="reference internal" href="psxy.html"><em>psxy</em></a>) to demonstrate the various
-transformations. Our illustrations may differ from those you reproduce
-with the same commands because of different settings in our <tt class="docutils literal"><span class="pre">gmt.conf</span></tt> file.)
-Finally, note that while we will specify dimensions in inches (by
-appending <strong>i</strong>), you may want to use cm (<strong>c</strong>), or points (<strong>p</strong>) as
-unit instead (see the <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> man page).</p>
-<div class="section" id="cartesian-transformations">
-<h2>10.1. Cartesian transformations<a class="headerlink" href="#cartesian-transformations" title="Permalink to this headline">¶</a></h2>
-<p>GMT Cartesian coordinate transformations come in three flavors:</p>
-<ul class="simple">
-<li>Linear coordinate transformation</li>
-<li>Log<img class="math" src="_images/math/70667f5a1cc0894b0fbd9abaf10ad9b13a2f65c1.png" alt="_{10}"/> coordinate transformation</li>
-<li>Power (exponential) coordinate transformation</li>
-</ul>
-<p>These transformations convert input coordinates <em>(x,y)</em> to
-locations <em>(x’, y’)</em> on a plot. There is no coupling between
-<em>x</em> and <em>y</em> (i.e., <em>x’ = f(x)</em> and <em>y’ = f(y)</em>);
-it is a <strong>one-dimensional</strong> projection. Hence, we may use separate
-transformations for the <em>x</em>- and <em>y</em>-axes (and
-<em>z</em>-axes for 3-D plots). Below, we will use the expression
-<em>u’ = f(u)</em>, where <em>u</em> is either <em>x</em> or <em>y</em> (or
-<em>z</em> for 3-D plots). The coefficients in <em>f(u)</em> depend on the
-desired plot size (or scale), the chosen <em>(x,y)</em> domain, and the
-nature of <em>f</em> itself.</p>
-<p>Two subsets of linear will be discussed separately; these are a polar
-(cylindrical) projection and a linear projection applied to geographic
-coordinates (with a 360º periodicity in the <em>x</em>-coordinate). We
-will show examples of all of these projections using dummy data sets
-created with <a class="reference internal" href="gmtmath.html"><em>gmtmath</em></a>, a “Reverse
-Polish Notation” (RPN) calculator that operates on or creates table data:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt gmtmath -T0/100/1 T <span class="nv">SQRT</span> <span class="o">=</span> sqrt.d
-gmt gmtmath -T0/100/10 T <span class="nv">SQRT</span> <span class="o">=</span> sqrt.d10
-</pre></div>
-</div>
-</div></blockquote>
-<div class="section" id="cartesian-linear-transformation-jx-jx">
-<h3>10.1.1. Cartesian linear transformation (<strong>-Jx</strong> <strong>-JX</strong>)<a class="headerlink" href="#cartesian-linear-transformation-jx-jx" title="Permalink to this headline">¶</a></h3>
-<p>There are in fact three different uses of the Cartesian linear
-transformation, each associated with specific command line options. The
-different manifestations result from specific properties of three kinds
-of data:</p>
-<ol class="arabic">
-<li><p class="first">Regular floating point coordinates</p>
-</li>
-<li><p class="first">Geographic coordinates</p>
-</li>
-<li><p class="first">Calendar time coordinates</p>
-<p>Examples of Cartesian (left), circular (middle), and geo-vectors (right) for different
-attribute specifications. Note that both full and half arrow-heads can be specified, as well as no head at all.</p>
-</li>
-</ol>
-<div class="section" id="regular-floating-point-coordinates">
-<h4>1. Regular floating point coordinates<a class="headerlink" href="#regular-floating-point-coordinates" title="Permalink to this headline">¶</a></h4>
-<p>Selection of the Cartesian linear transformation with regular floating
-point coordinates will result in a simple linear scaling
-<em>u’ = au + b</em> of the input coordinates. The projection is defined
-by stating scale in inches/unit (<strong>-Jx</strong>) or axis length in inches (<strong>-JX</strong>).
-If the <em>y</em>-scale or <em>y</em>-axis length is different from that of the
-<em>x</em>-axis (which is most often the case), separate the two scales (or
-lengths) by a slash, e.g., <strong>-Jx</strong>0.1i/0.5i or <strong>-JX</strong>8i/5i. Thus,
-our <img class="math" src="_images/math/6fa7e33b3d861018ef49fe4b11d353763a0c7183.png" alt="y = \sqrt{x}"/> data sets will plot as shown in
-Figure <a class="reference internal" href="#gmt-linear"><em>Linear transformation of Cartesian coordinates</em></a>.</p>
-<div class="figure align-center" id="gmt-linear">
-<a class="reference internal image-reference" href="_images/GMT_linear.png"><img alt="_images/GMT_linear.png" src="_images/GMT_linear.png" style="width: 400px;" /></a>
-<p class="caption">Linear transformation of Cartesian coordinates.</p>
-</div>
-<p>The complete commands given to produce this plot were</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt psxy -R0/100/0/10 -JX3i/1.5i -Bag -BWSne+gsnow -Wthick,blue,- -P -K sqrt.d > GMT_linear.ps
-gmt psxy -R -J -St0.1i -N -Gred -Wfaint -O sqrt.d10 >> GMT_linear.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>Normally, the user’s <em>x</em>-values will increase to the right and the
-<em>y</em>-values will increase upwards. It should be noted that in many
-situations it is desirable to have the direction of positive coordinates
-be reversed. For example, when plotting depth on the <em>y</em>-axis it makes
-more sense to have the positive direction downwards. All that is
-required to reverse the sense of positive direction is to supply a
-negative scale (or axis length). Finally, sometimes it is convenient to
-specify the width (or height) of a map and let the other dimension be
-computed based on the implied scale and the range of the other axis. To
-do this, simply specify the length to be recomputed as 0.</p>
-</div>
-<div class="section" id="geographic-coordinates">
-<h4>1. Geographic coordinates<a class="headerlink" href="#geographic-coordinates" title="Permalink to this headline">¶</a></h4>
-<div class="figure align-center" id="gmt-linear-d">
-<a class="reference internal image-reference" href="_images/GMT_linear_d.png"><img alt="_images/GMT_linear_d.png" src="_images/GMT_linear_d.png" style="width: 500px;" /></a>
-<p class="caption">Linear transformation of map coordinates.</p>
-</div>
-<p>While the Cartesian linear projection is primarily designed for regular
-floating point <em>x</em>,<em>y</em> data, it is sometimes necessary to plot
-geographical data in a linear projection. This poses a problem since
-longitudes have a 360º periodicity. GMT therefore needs to be informed
-that it has been given geographical coordinates even though a linear
-transformation has been chosen. We do so by adding a <strong>g</strong> (for
-geographical) or <strong>d</strong> (for degrees) directly after <strong>-R</strong> or by
-appending a <strong>g</strong> or <strong>d</strong> to the end of the <strong>-Jx</strong> (or <strong>-JX</strong>)
-option. As an example, we want to plot a crude world map centered on
-125ºE. Our command will be</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt <span class="nb">set </span>MAP_GRID_CROSS_SIZE_PRIMARY 0.1i MAP_FRAME_TYPE FANCY FORMAT_GEO_MAP ddd:mm:ssF
-gmt pscoast -Rg-55/305/-90/90 -Jx0.014i -Bagf -BWSen -Dc -A1000 -Glightbrown -Wthinnest <span class="se">\</span>
- -P -Slightblue > GMT_linear_d.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>with the result reproduced in
-Figure <a class="reference internal" href="#gmt-linear-d"><em>Linear transformation of map coordinates</em></a>.</p>
-</div>
-<div class="section" id="calendar-time-coordinates">
-<h4>1. Calendar time coordinates<a class="headerlink" href="#calendar-time-coordinates" title="Permalink to this headline">¶</a></h4>
-<div class="figure align-center" id="gmt-linear-cal">
-<a class="reference internal image-reference" href="_images/GMT_linear_cal.png"><img alt="_images/GMT_linear_cal.png" src="_images/GMT_linear_cal.png" style="width: 400px;" /></a>
-<p class="caption">Linear transformation of calendar coordinates.</p>
-</div>
-<p>Several particular issues arise when we seek to make linear plots using
-calendar date/time as the input coordinates. As far as setting up the
-coordinate transformation we must indicate whether our input data have
-absolute time coordinates or relative time coordinates. For the former
-we append <strong>T</strong> after the axis scale (or width), while for the latter we
-append <strong>t</strong> at the end of the <strong>-Jx</strong> (or <strong>-JX</strong>) option. However,
-other command line arguments (like the <strong>-R</strong> option) may already
-specify whether the time coordinate is absolute or relative. An absolute
-time entry must be given as [<em>date</em>]<strong>T</strong>[<em>clock</em>] (with <em>date</em>
-given as <em>yyyy</em>[-<em>mm</em>[-<em>dd</em>]], <em>yyyy</em>[-<em>jjj</em>], or
-<em>yyyy</em>[-<strong>W</strong><em>ww</em>[-<em>d</em>]], and <em>clock</em> using the
-<em>hh</em>[:<em>mm</em>[:<em>ss</em>[<em>.xxx</em>]]] 24-hour clock format) whereas the
-relative time is simply given as the units of time since the epoch
-followed by <strong>t</strong> (see <a class="reference internal" href="gmt.conf.html#time-unit"><em>TIME_UNIT</em></a> and <a class="reference internal" href="gmt.conf.html#time-epoch"><em>TIME_EPOCH</em></a> for
-information on specifying the time unit and the epoch). As a simple
-example, we will make a plot of a school week calendar
-(Figure <a class="reference internal" href="#gmt-linear-cal"><em>Linear transformation of calendar coordinates</em></a>).</p>
-<p>When the coordinate ranges provided by the <strong>-R</strong> option and the
-projection type given by <strong>-JX</strong> (including the optional <strong>d</strong>, <strong>g</strong>,
-<strong>t</strong> or <strong>T</strong>) conflict, GMT will warn the users about it. In
-general, the options provided with <strong>-JX</strong> will prevail.</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt <span class="nb">set </span>FORMAT_DATE_MAP o TIME_WEEK_START Sunday <span class="nv">FORMAT_CLOCK_MAP</span><span class="o">=</span>-hham <span class="se">\</span>
- FORMAT_TIME_PRIMARY_MAP full
-gmt psbasemap -R2001-9-24T/2001-9-29T/T07:0/T15:0 -JX4i/-2i -Bxa1Kf1kg1d <span class="se">\</span>
- -Bya1Hg1h -BWsNe+glightyellow -P > GMT_linear_cal.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-</div>
-<div class="section" id="cartesian-logarithmic-projection">
-<h3>10.1.2. Cartesian logarithmic projection<a class="headerlink" href="#cartesian-logarithmic-projection" title="Permalink to this headline">¶</a></h3>
-<div class="figure align-center" id="gmt-log">
-<a class="reference internal image-reference" href="_images/GMT_log.png"><img alt="_images/GMT_log.png" src="_images/GMT_log.png" style="width: 400px;" /></a>
-<p class="caption">Logarithmic transformation of x–coordinates.</p>
-</div>
-<p>The <img class="math" src="_images/math/195374909526226d6dd908206784056573e69009.png" alt="\log_{10}"/> transformation is simply
-<img class="math" src="_images/math/5cb03b9ea0160aacf2a8c57c8f87e00609b6baf6.png" alt="u' = a \log_{10}(u) + b"/> and is selected by appending an <strong>l</strong>
-(lower case L) immediately following the scale (or axis length) value.
-Hence, to produce a plot in which the <em>x</em>-axis is logarithmic (the
-<em>y</em>-axis remains linear, i.e., a semi-log plot), try (Figure <a class="reference internal" href="#gmt-log"><em>Logarithmic
-transformation</em></a>)</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt psxy -R1/100/0/10 -Jx1.5il/0.15i -Bx2g3 -Bya2f1g2 -BWSne+gbisque <span class="se">\</span>
- -Wthick,blue,- -P -K -h sqrt.d > GMT_log.ps
-gmt psxy -R -J -Ss0.1i -N -Gred -W -O -h sqrt.d10 >> GMT_log.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>Note that if <em>x</em>- and <em>y</em>-scaling are different and a
-<img class="math" src="_images/math/e42055dc76c465a7738328232a9ed4a0e4d5d7bc.png" alt="\log_{10}-\log_{10}"/> plot is desired, the <strong>l</strong> must be
-appended twice: Once after the <em>x</em>-scale (before the /) and once after
-the <em>y</em>-scale.</p>
-</div>
-<div class="section" id="cartesian-power-projection">
-<h3>10.1.3. Cartesian power projection <a class="reference internal" href="gmt.html#jx-full"><em>...</em></a><a class="headerlink" href="#cartesian-power-projection" title="Permalink to this headline">¶</a></h3>
-<div class="figure align-center" id="gmt-pow">
-<a class="reference internal image-reference" href="_images/GMT_pow.png"><img alt="_images/GMT_pow.png" src="_images/GMT_pow.png" style="width: 400px;" /></a>
-<p class="caption">Exponential or power transformation of x–coordinates.</p>
-</div>
-<p>This projection uses <img class="math" src="_images/math/7accc7b32c5ebf62f18c1c3b11d5fefe61e31f13.png" alt="u' = a u^b + c"/> and allows us to explore
-exponential relationships like <img class="math" src="_images/math/3ae01849dc5cdf884a6ca6c31cc84029073c9bbb.png" alt="x^p"/> versus <img class="math" src="_images/math/c2f20eff2112fdc5d8e16ed16276fbf7a9e4b2aa.png" alt="y^q"/>.
-While <em>p</em> and <em>q</em> can be any values, we will select <em>p
-= 0.5</em> and <em>q = 1</em> which means we will plot <em>x</em> versus
-<img class="math" src="_images/math/739563300258a3a4f54ff4e9b397dcf9c3f524f5.png" alt="\sqrt{x}"/>. We indicate this scaling by appending a <strong>p</strong> (lower
-case P) followed by the desired exponent, in our case 0.5. Since
-<em>q = 1</em> we do not need to specify <strong>p</strong>1 since it is identical
-to the linear transformation. Thus our command becomes (Figure <a class="reference internal" href="#gmt-pow"><em>Power
-transformation</em></a>)</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt psxy -R0/100/0/10 -Jx0.3ip0.5/0.15i -Bxa1p -Bya2f1 -BWSne+givory <span class="se">\</span>
- -Wthick -P -K sqrt.d > GMT_pow.ps
-gmt psxy -R -J -Sc0.075i -Ggreen -W -O sqrt.d10 >> GMT_pow.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-</div>
-<div class="section" id="linear-projection-with-polar-coordinates-jp-jp">
-<h2>10.2. Linear projection with polar coordinates (<strong>-Jp</strong> <strong>-JP</strong>) <a class="reference internal" href="gmt.html#jp-full"><em>...</em></a><a class="headerlink" href="#linear-projection-with-polar-coordinates-jp-jp" title="Permalink to this headline">¶</a></h2>
-<div class="figure align-center" id="gmt-polar">
-<a class="reference internal image-reference" href="_images/GMT_polar.png"><img alt="_images/GMT_polar.png" src="_images/GMT_polar.png" style="width: 400px;" /></a>
-<p class="caption">Polar (Cylindrical) transformation of (<img class="math" src="_images/math/2a378fd7cd8686bb483dcc6f4790095409d59cdb.png" alt="\theta, r"/>) coordinates.</p>
-</div>
-<p>This transformation converts polar coordinates (angle <img class="math" src="_images/math/a9cfbeb8ebee1f365919e147a79e242dcb67ee5d.png" alt="\theta"/> and
-radius <em>r</em>) to positions on a plot. Now <img class="math" src="_images/math/b5cde2c9425ca10f85e8313d3c932871df9bde64.png" alt="x' = f(\theta,r)"/>
-and <img class="math" src="_images/math/17b38e3a5d0e4a294258e8c390605a620a9d2bb4.png" alt="y' = g(\theta,r)"/>, hence it is similar to a regular map
-projection because <em>x</em> and <em>y</em> are coupled and <em>x</em>
-(i.e., <img class="math" src="_images/math/a9cfbeb8ebee1f365919e147a79e242dcb67ee5d.png" alt="\theta"/>) has a 360º periodicity. With input and output
-points both in the plane it is a <strong>two-dimensional</strong> projection. The
-transformation comes in two flavors:</p>
-<ol class="arabic simple">
-<li>Normally, <img class="math" src="_images/math/a9cfbeb8ebee1f365919e147a79e242dcb67ee5d.png" alt="\theta"/> is understood to be directions
-counter-clockwise from the horizontal axis, but we may choose to
-specify an angular offset [whose default value is zero]. We will call
-this offset <img class="math" src="_images/math/8c669a3486252783fe9a20e3b080f7ae97749928.png" alt="\theta_0"/>. Then,
-<img class="math" src="_images/math/71fea5f956b7e847a34650b42ab079913ea710a1.png" alt="x' = f(\theta, r) = ar \cos (\theta-\theta_0) + b"/> and
-<img class="math" src="_images/math/d60c41febe30c67efaee8216fe35af082d6cab6e.png" alt="y' = g(\theta, r) = ar \sin (\theta-\theta_0) + c"/>.</li>
-<li>Alternatively, <img class="math" src="_images/math/a9cfbeb8ebee1f365919e147a79e242dcb67ee5d.png" alt="\theta"/> can be interpreted to be azimuths
-clockwise from the vertical axis, yet we may again choose to specify
-the angular offset [whose default value is zero]. Then,
-<img class="math" src="_images/math/7e5891b0094f6bce182a4d436a76c2ff0371673f.png" alt="x' = f(\theta, r) = ar \cos (90 - (\theta-\theta_0)) + b"/> and
-<img class="math" src="_images/math/a893e2f5944325dd6dc9c50ea8e51619a1d6c4bb.png" alt="y' = g(\theta, r) = ar \sin (90 - (\theta-\theta_0)) + c"/>.</li>
-</ol>
-<p>Consequently, the polar transformation is defined by providing</p>
-<ul class="simple">
-<li>scale in inches/unit (<strong>-Jp</strong>) or full width of plot in inches (<strong>-JP</strong>)</li>
-<li>Optionally, insert <strong>a</strong> after <strong>p| P</strong> to indicate CW
-azimuths rather than CCW directions</li>
-<li>Optionally, append /<em>origin</em> in degrees to indicate an angular offset [0]</li>
-<li>Optionally, append <strong>r</strong> to reverse the radial direction (here,
-<em>south</em> and <em>north</em> must be elevations in 0–90 range).</li>
-<li>Optionally, append <strong>z</strong> to annotate depths rather than radius.</li>
-</ul>
-<p>As an example of this projection we will create a gridded data set in
-polar coordinates <img class="math" src="_images/math/1b4f055cfa78bceb89a4c9c9c18402158f0ef0c4.png" alt="z(\theta, r) = r^2 \cdot \cos{4\theta}"/> using
-<a class="reference internal" href="grdmath.html"><em>grdmath</em></a>, a RPN calculator that
-operates on or creates grid files.</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt grdmath -R0/360/2/4 -I6/0.1 X <span class="m">4</span> MUL PI MUL <span class="m">180</span> DIV COS Y <span class="m">2</span> POW <span class="nv">MUL</span> <span class="o">=</span> tt.nc
-gmt grdcontour tt.nc -JP3i -B30 -BNs+ghoneydew -P -C2 -S4 --FORMAT_GEO_MAP<span class="o">=</span>+ddd > GMT_polar.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>We used <a class="reference internal" href="grdcontour.html"><em>grdcontour</em></a> to make a
-contour map of this data. Because the data file only contains values
-with <img class="math" src="_images/math/4d337ec017642f10dd1cbc47640678a90f5bf479.png" alt="2 \leq r \leq 4"/>, a donut shaped plot appears in
-Figure <a class="reference internal" href="#gmt-polar"><em>Polar transformation</em></a>.</p>
-</div>
-</div>
-<div class="section" id="gmt-map-projections">
-<h1>11. GMT Map Projections<a class="headerlink" href="#gmt-map-projections" title="Permalink to this headline">¶</a></h1>
-<p>GMT implements more than 30 different projections. They all project
-the input coordinates longitude and latitude to positions on a map. In
-general, <em>x’ = f(x,y,z)</em> and <em>y’ = g(x,y,z)</em>, where
-<em>z</em> is implicitly given as the radial vector length to the
-<em>(x,y)</em> point on the chosen ellipsoid. The functions <em>f</em> and
-<em>g</em> can be quite nasty and we will refrain from presenting details
-in this document. The interested read is referred to <em>Snyder</em>
-[1987] <a class="footnote-reference" href="#id67" id="id23">[20]</a>. We will mostly be using the
-<a class="reference internal" href="pscoast.html"><em>pscoast</em></a> command to demonstrate each of
-the projections. GMT map projections are grouped into four categories
-depending on the nature of the projection. The groups are</p>
-<ol class="arabic simple">
-<li>Conic map projections</li>
-<li>Azimuthal map projections</li>
-<li>Cylindrical map projections</li>
-<li>Miscellaneous projections</li>
-</ol>
-<p>Because <em>x</em> and <em>y</em> are coupled we can only specify one
-plot-dimensional scale, typically a map <em>scale</em> (for lower-case map
-projection code) or a map <em>width</em> (for upper-case map projection code).
-However, in some cases it would be more practical to specify map
-<em>height</em> instead of <em>width</em>, while in other situations it would be nice
-to set either the <em>shortest</em> or <em>longest</em> map dimension. Users may
-select these alternatives by appending a character code to their map
-dimension. To specify map <em>height</em>, append <strong>h</strong> to the given dimension;
-to select the minimum map dimension, append <strong>-</strong>, whereas you may
-append <strong>+</strong> to select the maximum map dimension. Without the modifier
-the map width is selected by default.</p>
-<p>In GMT version 4.3.0 we noticed we ran out of the alphabet for
-1-letter (and sometimes 2-letter) projection codes. To allow more
-flexibility, and to make it easier to remember the codes, we implemented
-the option to use the abbreviations used by the <strong>Proj4</strong> mapping
-package. Since some of the GMT projections are not in <strong>Proj4</strong>, we
-invented some of our own as well. For a full list of both the old 1- and
-2-letter codes, as well as the <strong>Proj4</strong>-equivalents see the quick
-reference cards in Section <a class="reference internal" href="#gmt-quick-reference">GMT quick reference</a>. For example, <strong>-JM</strong>15c and
-<strong>-JMerc</strong>/15c have the same meaning.</p>
-<div class="section" id="conic-projections">
-<h2>11.1. Conic projections<a class="headerlink" href="#conic-projections" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="albers-conic-equal-area-projection-jb-jb">
-<h3>11.1.1. Albers conic equal-area projection (<strong>-Jb</strong> <strong>-JB</strong>) <a class="reference internal" href="gmt.html#jb-full"><em>...</em></a><a class="headerlink" href="#albers-conic-equal-area-projection-jb-jb" title="Permalink to this headline">¶</a></h3>
-<p>This projection, developed by Albers in 1805, is predominantly used to
-map regions of large east-west extent, in particular the United States.
-It is a conic, equal-area projection, in which parallels are unequally
-spaced arcs of concentric circles, more closely spaced at the north and
-south edges of the map. Meridians, on the other hand, are equally spaced
-radii about a common center, and cut the parallels at right angles.
-Distortion in scale and shape vanishes along the two standard parallels.
-Between them, the scale along parallels is too small; beyond them it is
-too large. The opposite is true for the scale along meridians. To define
-the projection in GMT you need to provide the following information:</p>
-<ul class="simple">
-<li>Longitude and latitude of the projection center.</li>
-<li>Two standard parallels.</li>
-<li>Map scale in inch/degree or 1:xxxxx notation (<strong>-Jb</strong>), or map width (<strong>-JB</strong>).</li>
-</ul>
-<p>Note that you must include the “1:” if you choose to specify the scale
-that way. E.g., you can say 0.5 which means 0.5 inch/degree or 1:200000
-which means 1 inch on the map equals 200,000 inches along the standard
-parallels. The projection center defines the origin of the rectangular
-map coordinates. As an example we will make a map of the region near
-Taiwan. We choose the center of the projection to be at 125ºE/20ºN and
-25ºN and 45ºN as our two standard parallels. We desire a map that is 5
-inches wide. The complete command needed to generate the map below is
-therefore given by:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt <span class="nb">set </span>MAP_GRID_CROSS_SIZE_PRIMARY 0
-gmt pscoast -R110/140/20/35 -JB125/20/25/45/5i -Bag -Dl -Ggreen -Wthinnest <span class="se">\</span>
- -A250 -P > GMT_albers.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_albers.png"><img alt="_images/GMT_albers.png" src="_images/GMT_albers.png" style="width: 500px;" /></a>
-<p class="caption">Albers equal-area conic map projection.</p>
-</div>
-</div>
-<div class="section" id="equidistant-conic-projection-jd-jd">
-<h3>11.1.2. Equidistant conic projection (<strong>-Jd</strong> <strong>-JD</strong>) <a class="reference internal" href="gmt.html#jd-full"><em>...</em></a><a class="headerlink" href="#equidistant-conic-projection-jd-jd" title="Permalink to this headline">¶</a></h3>
-<p>The equidistant conic projection was described by the Greek philosopher
-Claudius Ptolemy about A.D. 150. It is neither conformal or equal-area,
-but serves as a compromise between them. The scale is true along all
-meridians and the standard parallels. To select this projection in
-GMT you must provide the same information as for the other conic
-projection, i.e.,</p>
-<ul class="simple">
-<li>Longitude and latitude of the projection center.</li>
-<li>Two standard parallels.</li>
-<li>Map scale in inch/degree or 1:xxxxx notation (<strong>-Jd</strong>), or map width (<strong>-JD</strong>).</li>
-</ul>
-<p>The equidistant conic projection is often used for atlases with maps of
-small countries. As an example, we generate a map of Cuba:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt <span class="nb">set </span>FORMAT_GEO_MAP ddd:mm:ssF MAP_GRID_CROSS_SIZE_PRIMARY 0.05i
-gmt pscoast -R-88/-70/18/24 -JD-79/21/19/23/4.5i -Bag -Di -N1/thick,red <span class="se">\</span>
- -Glightgreen -Wthinnest -P > GMT_equidistant_conic.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_equidistant_conic.png"><img alt="_images/GMT_equidistant_conic.png" src="_images/GMT_equidistant_conic.png" style="width: 500px;" /></a>
-<p class="caption">Equidistant conic map projection.</p>
-</div>
-</div>
-<div class="section" id="lambert-conic-conformal-projection-jl-jl">
-<h3>11.1.3. Lambert conic conformal projection (<strong>-Jl</strong> <strong>-JL</strong>) <a class="reference internal" href="gmt.html#jl-full"><em>...</em></a><a class="headerlink" href="#lambert-conic-conformal-projection-jl-jl" title="Permalink to this headline">¶</a></h3>
-<p>This conic projection was designed by the Alsatian mathematician Johann
-Heinrich Lambert (1772) and has been used extensively for mapping of
-regions with predominantly east-west orientation, just like the Albers
-projection. Unlike the Albers projection, Lambert’s conformal projection
-is not equal-area. The parallels are arcs of circles with a common
-origin, and meridians are the equally spaced radii of these circles. As
-with Albers projection, it is only the two standard parallels that are
-distortion-free. To select this projection in GMT you must provide the
-same information as for the Albers projection, i.e.,</p>
-<ul class="simple">
-<li>Longitude and latitude of the projection center.</li>
-<li>Two standard parallels.</li>
-<li>Map scale in inch/degree or 1:xxxxx notation (<strong>-Jl</strong>), or map width (<strong>-JL</strong>).</li>
-</ul>
-<p>The Lambert conformal projection has been used for basemaps for all the
-48 contiguous States with the two fixed standard parallels 33ºN and 45ºN.
-We will generate a map of the continental USA using these parameters.
-Note that with all the projections you have the option of selecting a
-rectangular border rather than one defined by meridians and parallels.
-Here, we choose the regular WESN region, a “fancy” basemap frame, and
-use degrees west for longitudes. The generating commands used were</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt <span class="nb">set </span>MAP_FRAME_TYPE FANCY FORMAT_GEO_MAP ddd:mm:ssF MAP_GRID_CROSS_SIZE_PRIMARY 0.05i
-gmt pscoast -R-130/-70/24/52 -Jl-100/35/33/45/1:50000000 -Bag -Dl -N1/thick,red <span class="se">\</span>
- -N2/thinner -A500 -Gtan -Wthinnest,white -Sblue -P > GMT_lambert_conic.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_lambert_conic.png"><img alt="_images/GMT_lambert_conic.png" src="_images/GMT_lambert_conic.png" style="width: 500px;" /></a>
-<p class="caption">Lambert conformal conic map projection.</p>
-</div>
-<p>The choice for projection center does not affect the projection but it
-indicates which meridian (here 100ºW) will be vertical on the map. The
-standard parallels were originally selected by Adams to provide a
-maximum scale error between latitudes 30.5ºN and 47.5ºN of 0.5–1%. Some
-areas, like Florida, experience scale errors of up to 2.5%.</p>
-</div>
-<div class="section" id="american-polyconic-projection-jpoly-jpoly">
-<h3>11.1.4. (American) polyconic projection (<strong>-Jpoly</strong> <strong>-JPoly</strong>) <a class="reference internal" href="gmt.html#jpoly-full"><em>...</em></a><a class="headerlink" href="#american-polyconic-projection-jpoly-jpoly" title="Permalink to this headline">¶</a></h3>
-<p>The polyconic projection, in Europe usually referred to as the American
-polyconic projection, was introduced shortly before 1820 by the
-Swiss-American cartographer Ferdinand Rodulph Hassler (1770–1843). As
-head of the Survey of the Coast, he was looking for a projection that
-would give the least distortion for mapping the coast of the United
-States. The projection acquired its name from the construction of each
-parallel, which is achieved by projecting the parallel onto the cone
-while it is rolled around the globe, along the central meridian, tangent
-to that parallel. As a consequence, the projection involves many cones
-rather than a single one used in regular conic projections.</p>
-<p>The polyconic projection is neither equal-area, nor conformal. It is
-true to scale without distortion along the central meridian. Each
-parallel is true to scale as well, but the meridians are not as they get
-further away from the central meridian. As a consequence, no parallel is
-standard because conformity is lost with the lengthening of the meridians.</p>
-<p>Below we reproduce the illustration by <em>Snyder</em> [1987], with a gridline
-every 10 and annotations only every 30º in longitude:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -R-180/-20/0/90 -JPoly/4i -Bx30g10 -By10g10 -Dc -A1000 -Glightgray <span class="se">\</span>
- -Wthinnest -P > GMT_polyconic.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_polyconic.png"><img alt="_images/GMT_polyconic.png" src="_images/GMT_polyconic.png" style="width: 500px;" /></a>
-<p class="caption">(American) polyconic projection.</p>
-</div>
-</div>
-</div>
-<div class="section" id="azimuthal-projections">
-<h2>11.2. Azimuthal projections<a class="headerlink" href="#azimuthal-projections" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="lambert-azimuthal-equal-area-ja-ja">
-<h3>11.2.1. Lambert Azimuthal Equal-Area (<strong>-Ja</strong> <strong>-JA</strong>)<a class="headerlink" href="#lambert-azimuthal-equal-area-ja-ja" title="Permalink to this headline">¶</a></h3>
-<p>This projection was developed by Lambert in 1772 and is typically used
-for mapping large regions like continents and hemispheres. It is an
-azimuthal, equal-area projection, but is not perspective. Distortion is
-zero at the center of the projection, and increases radially away from
-this point. To define this projection in GMT you must provide the
-following information:</p>
-<ul class="simple">
-<li>Longitude and latitude of the projection center.</li>
-<li>Optionally, the horizon, i.e., the number of degrees from the center
-to the edge (<= 180, default is 90).</li>
-<li>Scale as 1:xxxxx or as radius/latitude where radius is the projected
-distance on the map from projection center to an oblique latitude where 0
-would be the oblique Equator
-(<strong>-Ja</strong>), or map width (<strong>-JA</strong>).</li>
-</ul>
-<p>Two different types of maps can be made with this projection depending
-on how the region is specified. We will give examples of both types.</p>
-<div class="section" id="rectangular-map">
-<h4>1. Rectangular map<a class="headerlink" href="#rectangular-map" title="Permalink to this headline">¶</a></h4>
-<p>In this mode we define our region by specifying the longitude/latitude
-of the lower left and upper right corners instead of the usual <em>west,
-east, south, north</em> boundaries. The reason for specifying our area this
-way is that for this and many other projections, lines of equal
-longitude and latitude are not straight lines and are thus poor choices
-for map boundaries. Instead we require that the map boundaries be
-rectangular by defining the corners of a rectangular map boundary. Using
-0ºE/40ºS (lower left) and 60ºE/10ºS (upper right) as our corners we try</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt <span class="nb">set </span>FORMAT_GEO_MAP ddd:mm:ssF MAP_GRID_CROSS_SIZE_PRIMARY 0
-gmt pscoast -R0/-40/60/-10r -JA30/-30/4.5i -Bag -Dl -A500 -Gp300/10 <span class="se">\</span>
- -Wthinnest -P > GMT_lambert_az_rect.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_lambert_az_rect.png"><img alt="_images/GMT_lambert_az_rect.png" src="_images/GMT_lambert_az_rect.png" style="width: 500px;" /></a>
-<p class="caption">Rectangular map using the Lambert azimuthal equal-area projection.</p>
-</div>
-<p>Note that an “r” is appended to the <strong>-R</strong> option to inform GMT that
-the region has been selected using the rectangle technique, otherwise it
-would try to decode the values as <em>west, east, south, north</em> and report
-an error since <em>‘east’</em> < <em>‘west’</em>.</p>
-</div>
-<div class="section" id="hemisphere-map">
-<h4>1. Hemisphere map<a class="headerlink" href="#hemisphere-map" title="Permalink to this headline">¶</a></h4>
-<p>Here, you must specify the world as your region (<strong>-Rg</strong> or
-<strong>-Rd</strong>). E.g., to obtain a hemisphere view that shows the Americas, try</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -Rg -JA280/30/3.5i -Bg -Dc -A1000 -Gnavy -P > GMT_lambert_az_hemi.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_lambert_az_hemi.png"><img alt="_images/GMT_lambert_az_hemi.png" src="_images/GMT_lambert_az_hemi.png" style="width: 400px;" /></a>
-<p class="caption">Hemisphere map using the Lambert azimuthal equal-area projection.</p>
-</div>
-<p>To geologists, the Lambert azimuthal equal-area projection (with origin
-at 0/0) is known as the <em>equal-area</em> (Schmidt) stereonet and used for
-plotting fold axes, fault planes, and the like. An <em>equal-angle</em> (Wulff)
-stereonet can be obtained by using the stereographic projection
-(discussed later). The stereonets produced by these two projections appear below.</p>
-<div class="figure align-center" id="gmt-stereonets">
-<a class="reference internal image-reference" href="_images/GMT_stereonets.png"><img alt="_images/GMT_stereonets.png" src="_images/GMT_stereonets.png" style="width: 500px;" /></a>
-<p class="caption">Equal-Area (Schmidt) and Equal-Angle (Wulff) stereo nets.</p>
-</div>
-</div>
-</div>
-<div class="section" id="stereographic-equal-angle-projection-js-js">
-<h3>11.2.2. Stereographic Equal-Angle projection (<strong>-Js</strong> <strong>-JS</strong>) <a class="reference internal" href="gmt.html#js-full"><em>...</em></a><a class="headerlink" href="#stereographic-equal-angle-projection-js-js" title="Permalink to this headline">¶</a></h3>
-<p>This is a conformal, azimuthal projection that dates back to the Greeks.
-Its main use is for mapping the polar regions. In the polar aspect all
-meridians are straight lines and parallels are arcs of circles. While
-this is the most common use it is possible to select any point as the
-center of projection. The requirements are</p>
-<ul class="simple">
-<li>Longitude and latitude of the projection center.</li>
-<li>Optionally, the horizon, i.e., the number of degrees from the center
-to the edge (< 180, default is 90).</li>
-<li>Scale as 1:xxxxx (true scale at pole), slat/1:xxxxx (true scale at
-standard parallel slat), or radius/latitude where radius is distance
-on map in inches from projection center to a particular
-oblique latitude (<strong>-Js</strong>), or simply map width (<strong>-JS</strong>).</li>
-</ul>
-<p>A default map scale factor of 0.9996 will be applied by default
-(although you may change this with <a class="reference internal" href="gmt.conf.html#proj-scale-factor"><em>PROJ_SCALE_FACTOR</em></a>). However,
-the setting is ignored when a standard parallel has been specified since
-the scale is then implicitly given. We will look at two different types
-of maps.</p>
-<div class="section" id="polar-stereographic-map">
-<h4>1. Polar Stereographic Map <a class="reference internal" href="gmt.html#js-full"><em>...</em></a><a class="headerlink" href="#polar-stereographic-map" title="Permalink to this headline">¶</a></h4>
-<p>In our first example we will let the projection center be at the north
-pole. This means we have a polar stereographic projection and the map
-boundaries will coincide with lines of constant longitude and latitude.
-An example is given by</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -R-30/30/60/72 -Js0/90/4.5i/60 -B10g -Dl -A250 -Groyalblue <span class="se">\</span>
- -Sseashell -P > GMT_stereographic_polar.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_stereographic_polar.png"><img alt="_images/GMT_stereographic_polar.png" src="_images/GMT_stereographic_polar.png" style="width: 500px;" /></a>
-<p class="caption">Polar stereographic conformal projection.</p>
-</div>
-</div>
-<div class="section" id="rectangular-stereographic-map">
-<h4>1. Rectangular stereographic map<a class="headerlink" href="#rectangular-stereographic-map" title="Permalink to this headline">¶</a></h4>
-<p>As with Lambert’s azimuthal equal-area projection we have the option to
-use rectangular boundaries rather than the wedge-shape typically
-associated with polar projections. This choice is defined by selecting
-two points as corners in the rectangle and appending an “r” to the
-<strong>-R</strong> option. This command produces a map as presented in
-Figure <a class="reference internal" href="#gmt-stereographic-rect"><em>Polar stereographic</em></a>:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt <span class="nb">set </span>MAP_ANNOT_OBLIQUE 30
-gmt pscoast -R-25/59/70/72r -JS10/90/11c -B20g -Dl -A250 -Gdarkbrown -Wthinnest <span class="se">\</span>
- -Slightgray -P > GMT_stereographic_rect.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center" id="gmt-stereographic-rect">
-<a class="reference internal image-reference" href="_images/GMT_stereographic_rect.png"><img alt="_images/GMT_stereographic_rect.png" src="_images/GMT_stereographic_rect.png" style="width: 500px;" /></a>
-<p class="caption">Polar stereographic conformal projection with rectangular borders.</p>
-</div>
-</div>
-<div class="section" id="general-stereographic-map">
-<h4>1. General stereographic map<a class="headerlink" href="#general-stereographic-map" title="Permalink to this headline">¶</a></h4>
-<p>In terms of usage this projection is identical to the Lambert azimuthal
-equal-area projection. Thus, one can make both rectangular and
-hemispheric maps. Our example shows Australia using a projection pole at
-130ºE/30ºS. The command used was</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt <span class="nb">set </span>MAP_ANNOT_OBLIQUE 0
-gmt pscoast -R100/-42/160/-8r -JS130/-30/4i -Bag -Dl -A500 -Ggreen -Slightblue <span class="se">\</span>
- -Wthinnest -P > GMT_stereographic_general.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_stereographic_general.png"><img alt="_images/GMT_stereographic_general.png" src="_images/GMT_stereographic_general.png" style="width: 500px;" /></a>
-<p class="caption">General stereographic conformal projection with rectangular borders.</p>
-</div>
-<p>By choosing 0/0 as the pole, we obtain the conformal stereonet presented
-next to its equal-area cousin in the Section <a class="reference internal" href="#lambert-azimuthal-equal-area-ja-ja">Lambert Azimuthal Equal-Area (-Ja -JA)</a> on the Lambert
-azimuthal equal-area projection (Figure <a class="reference internal" href="#gmt-stereonets"><em>Stereonets</em></a>).</p>
-</div>
-</div>
-<div class="section" id="perspective-projection-jg-jg">
-<h3>11.2.3. Perspective projection (<strong>-Jg</strong> <strong>-JG</strong>) <a class="reference internal" href="gmt.html#jg-full"><em>...</em></a><a class="headerlink" href="#perspective-projection-jg-jg" title="Permalink to this headline">¶</a></h3>
-<p>The perspective projection imitates in 2 dimensions the 3-dimensional
-view of the earth from space. The implementation in GMT is very
-flexible, and thus requires many input variables. Those are listed and
-explained below, with the values used in
-Figure <a class="reference internal" href="#gmt-perspective"><em>Perspective projection</em></a> between brackets.</p>
-<ul class="simple">
-<li>Longitude and latitude of the projection center (4ºE/52ºN).</li>
-<li>Altitude of the viewer above sea level in kilometers (230 km). If
-this value is less than 10, it is assumed to be the distance of the
-viewer from the center of the earth in earth radii. If an “r” is
-appended, it is the distance from the center of the earth in
-kilometers.</li>
-<li>Azimuth in degrees (90, due east). This is the direction in which you
-are looking, measured clockwise from north.</li>
-<li>Tilt in degrees (60). This is the viewing angle relative to zenith.
-So a tilt of 0º is looking straight down, 60º is looking from 30º above
-the horizon.</li>
-<li>Twist in degrees (180). This is the boresight rotation (clockwise) of
-the image. The twist of 180º in the example mimics the fact that the
-Space Shuttle flies upside down.</li>
-<li>Width and height of the viewpoint in degrees (60). This number
-depends on whether you are looking with the naked eye (in which case
-you view is about 60º wide), or with binoculars, for example.</li>
-<li>Scale as 1:xxxxx or as radius/latitude where radius is distance on
-map in inches from projection center to a particular
-oblique latitude (<strong>-Jg</strong>), or map width (<strong>-JG</strong>) (5 inches).</li>
-</ul>
-<p>The imagined view of northwest Europe from a Space Shuttle at 230 km
-looking due east is thus accomplished by the following
-<a class="reference internal" href="pscoast.html"><em>pscoast</em></a> command:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -Rg -JG4/52/230/90/60/180/60/60/5i -Bx2g2 -By1g1 -Ia -Di -Glightbrown <span class="se">\</span>
- -Wthinnest -P -Slightblue --MAP_ANNOT_MIN_SPACING<span class="o">=</span>0.25i > GMT_perspective.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center" id="gmt-perspective">
-<a class="reference internal image-reference" href="_images/GMT_perspective.png"><img alt="_images/GMT_perspective.png" src="_images/GMT_perspective.png" style="width: 500px;" /></a>
-<p class="caption">View from the Space Shuttle in Perspective projection.</p>
-</div>
-</div>
-<div class="section" id="orthographic-projection-jg-jg">
-<h3>11.2.4. Orthographic projection (<strong>-Jg</strong> <strong>-JG</strong>) <a class="reference internal" href="gmt.html#jg-full"><em>...</em></a><a class="headerlink" href="#orthographic-projection-jg-jg" title="Permalink to this headline">¶</a></h3>
-<p>The orthographic azimuthal projection is a perspective projection from
-infinite distance. It is therefore often used to give the appearance of
-a globe viewed from outer space. As with Lambert’s equal-area and the
-stereographic projection, only one hemisphere can be viewed at any time.
-The projection is neither equal-area nor conformal, and much distortion
-is introduced near the edge of the hemisphere. The directions from the
-center of projection are true. The projection was known to the Egyptians
-and Greeks more than 2,000 years ago. Because it is mainly used for
-pictorial views at a small scale, only the spherical form is necessary.</p>
-<p>To specify the orthographic projection the same options <strong>-Jg</strong> or
-<strong>-JG</strong> as the perspective projection are used, but with fewer variables to supply:</p>
-<ul class="simple">
-<li>Longitude and latitude of the projection center.</li>
-<li>Optionally, the horizon, i.e., the number of degrees from the center
-to the edge (<= 90, default is 90).</li>
-<li>Scale as 1:xxxxx or as radius/latitude where radius is distance on
-map in inches from projection center to a particular
-oblique latitude (<strong>-Jg</strong>), or map width (<strong>-JG</strong>).</li>
-</ul>
-<p>Our example of a perspective view centered on 75ºW/40ºN can therefore be
-generated by the following <a class="reference internal" href="pscoast.html"><em>pscoast</em></a> command:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -Rg -JG-75/41/4.5i -Bg -Dc -A5000 -Gpink -Sthistle -P > GMT_orthographic.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_orthographic.png"><img alt="_images/GMT_orthographic.png" src="_images/GMT_orthographic.png" style="width: 400px;" /></a>
-<p class="caption">Hemisphere map using the Orthographic projection.</p>
-</div>
-</div>
-<div class="section" id="azimuthal-equidistant-projection-je-je">
-<h3>11.2.5. Azimuthal Equidistant projection (<strong>-Je</strong> <strong>-JE</strong>) <a class="reference internal" href="gmt.html#je-full"><em>...</em></a><a class="headerlink" href="#azimuthal-equidistant-projection-je-je" title="Permalink to this headline">¶</a></h3>
-<p>The most noticeable feature of this azimuthal projection is the fact
-that distances measured from the center are true. Therefore, a circle
-about the projection center defines the locus of points that are equally
-far away from the plot origin. Furthermore, directions from the center
-are also true. The projection, in the polar aspect, is at least several
-centuries old. It is a useful projection for a global view of locations
-at various or identical distance from a given point (the map center).</p>
-<p>To specify the azimuthal equidistant projection you must supply:</p>
-<ul class="simple">
-<li>Longitude and latitude of the projection center.</li>
-<li>Optionally, the horizon, i.e., the number of degrees from the center
-to the edge (<= 180, default is 180).</li>
-<li>Scale as 1:xxxxx or as radius/latitude where radius is distance on
-map in inches from projection center to a particular
-oblique latitude (<strong>-Je</strong>), or map width (<strong>-JE</strong>).</li>
-</ul>
-<p>Our example of a global view centered on 100ºW/40ºN can therefore be
-generated by the following <a class="reference internal" href="pscoast.html"><em>pscoast</em></a>
-command. Note that the antipodal point is 180º away from the center, but
-in this projection this point plots as the entire map perimeter:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -Rg -JE-100/40/4.5i -Bg -Dc -A10000 -Glightgray -Wthinnest -P <span class="se">\</span>
- > GMT_az_equidistant.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_az_equidistant.png"><img alt="_images/GMT_az_equidistant.png" src="_images/GMT_az_equidistant.png" style="width: 400px;" /></a>
-<p class="caption">World map using the equidistant azimuthal projection.</p>
-</div>
-</div>
-<div class="section" id="gnomonic-projection-jf-jf">
-<h3>11.2.6. Gnomonic projection (<strong>-Jf</strong> <strong>-JF</strong>) <a class="reference internal" href="gmt.html#je-full"><em>...</em></a><a class="headerlink" href="#gnomonic-projection-jf-jf" title="Permalink to this headline">¶</a></h3>
-<p>The Gnomonic azimuthal projection is a perspective projection from the
-center onto a plane tangent to the surface. Its origin goes back to the
-old Greeks who used it for star maps almost 2500 years ago. The
-projection is neither equal-area nor conformal, and much distortion is
-introduced near the edge of the hemisphere; in fact, less than a
-hemisphere may be shown around a given center. The directions from the
-center of projection are true. Great circles project onto straight
-lines. Because it is mainly used for pictorial views at a small scale,
-only the spherical form is necessary.</p>
-<p>To specify the Gnomonic projection you must supply:</p>
-<ul class="simple">
-<li>Longitude and latitude of the projection center.</li>
-<li>Optionally, the horizon, i.e., the number of degrees from the center
-to the edge (< 90, default is 60).</li>
-<li>Scale as 1:xxxxx or as radius/latitude where radius is distance on
-map in inches from projection center to a particular
-oblique latitude (<strong>-Jf</strong>), or map width (<strong>-JF</strong>).</li>
-</ul>
-<p>Using a horizon of 60, our example of this projection centered on
-120ºW/35ºN can therefore be generated by the following <a class="reference internal" href="pscoast.html"><em>pscoast</em></a> command:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -Rg -JF-120/35/60/4.5i -B30g15 -Dc -A10000 -Gtan -Scyan -Wthinnest <span class="se">\</span>
- -P > GMT_gnomonic.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_gnomonic.png"><img alt="_images/GMT_gnomonic.png" src="_images/GMT_gnomonic.png" style="width: 500px;" /></a>
-<p class="caption">Gnomonic azimuthal projection.</p>
-</div>
-</div>
-</div>
-<div class="section" id="cylindrical-projections">
-<h2>11.3. Cylindrical projections<a class="headerlink" href="#cylindrical-projections" title="Permalink to this headline">¶</a></h2>
-<p>Cylindrical projections are easily recognized for its shape: maps are
-rectangular and meridians and parallels are straight lines crossing at
-right angles. But that is where similarities between the cylindrical
-projections supported by GMT (Mercator, transverse Mercator, universal
-transverse Mercator, oblique Mercator, Cassini, cylindrical equidistant,
-cylindrical equal-area, Miller, and cylindrical stereographic
-projections) stops. Each have a different way of spacing the meridians
-and parallels to obtain certain desirable cartographic properties.</p>
-<div class="section" id="mercator-projection-jm-jm">
-<h3>11.3.1. Mercator projection (<strong>-Jm</strong> <strong>-JM</strong>) <a class="reference internal" href="gmt.html#je-full"><em>...</em></a><a class="headerlink" href="#mercator-projection-jm-jm" title="Permalink to this headline">¶</a></h3>
-<p>Probably the most famous of the various map projections, the Mercator
-projection takes its name from the Flemish cartographer Gheert Cremer,
-better known as Gerardus Mercator, who presented it in 1569. The
-projection is a cylindrical and conformal, with no distortion along the
-equator. A major navigational feature of the projection is that a line
-of constant azimuth is straight. Such a line is called a rhumb line or
-<em>loxodrome</em>. Thus, to sail from one point to another one only had to
-connect the points with a straight line, determine the azimuth of the
-line, and keep this constant course for the entire voyage <a class="footnote-reference" href="#id68" id="id24">[21]</a>. The
-Mercator projection has been used extensively for world maps in which
-the distortion towards the polar regions grows rather large, thus
-incorrectly giving the impression that, for example, Greenland is larger
-than South America. In reality, the latter is about eight times the size
-of Greenland. Also, the Former Soviet Union looks much bigger than
-Africa or South America. One may wonder whether this illusion has had
-any influence on U.S. foreign policy.</p>
-<p>In the regular Mercator projection, the cylinder touches the globe along
-the equator. Other orientations like vertical and oblique give rise to
-the Transverse and Oblique Mercator projections, respectively. We will
-discuss these generalizations following the regular Mercator projection.</p>
-<p>The regular Mercator projection requires a minimum of parameters. To use
-it in GMT programs you supply this information (the first two items
-are optional and have defaults):</p>
-<ul class="simple">
-<li>Central meridian [Middle of your map].</li>
-<li>Standard parallel for true scale [Equator]. When supplied, central
-meridian must be supplied as well.</li>
-<li>Scale along the equator in inch/degree or 1:xxxxx (<strong>-Jm</strong>), or map
-width (<strong>-JM</strong>).</li>
-</ul>
-<p>Our example presents a world map at a scale of 0.012 inch pr degree
-which will give a map 4.32 inch wide. It was created with the command:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt <span class="nb">set </span>MAP_FRAME_TYPE fancy
-gmt pscoast -R0/360/-70/70 -Jm1.2e-2i -Bxa60f15 -Bya30f15 -Dc -A5000 -Gred <span class="se">\</span>
- -P > GMT_mercator.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_mercator.png"><img alt="_images/GMT_mercator.png" src="_images/GMT_mercator.png" style="width: 500px;" /></a>
-<p class="caption">Simple Mercator map.</p>
-</div>
-<p>While this example is centered on the Dateline, one can easily choose
-another configuration with the <strong>-R</strong> option. A map centered on
-Greenwich would specify the region with <strong>-R</strong>-180/180/-70/70.</p>
-</div>
-<div class="section" id="transverse-mercator-projection-jt-jt">
-<h3>11.3.2. Transverse Mercator projection (<strong>-Jt</strong> <strong>-JT</strong>) <a class="reference internal" href="gmt.html#jt-full"><em>...</em></a><a class="headerlink" href="#transverse-mercator-projection-jt-jt" title="Permalink to this headline">¶</a></h3>
-<p>The transverse Mercator was invented by Lambert in 1772. In this
-projection the cylinder touches a meridian along which there is no
-distortion. The distortion increases away from the central meridian and
-goes to infinity at 90º from center. The central meridian, each meridian
-90º away from the center, and equator are straight lines; other parallels
-and meridians are complex curves. The projection is defined by
-specifying:</p>
-<ul class="simple">
-<li>The central meridian.</li>
-<li>Optionally, the latitude of origin (default is the equator).</li>
-<li>Scale along the equator in inch/degree or 1:xxxxx (<strong>-Jt</strong>), or map
-width (<strong>-JT</strong>).</li>
-</ul>
-<p>The optional latitude of origin defaults to Equator if not specified.
-Although defaulting to 1, you can change the map scale factor via the
-<a class="reference internal" href="gmt.conf.html#proj-scale-factor"><em>PROJ_SCALE_FACTOR</em></a> parameter. Our example shows a transverse
-Mercator map of south-east Europe and the Middle East with 35ºE as the
-central meridian:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -R20/30/50/45r -Jt35/0.18i -Bag -Dl -A250 -Glightbrown -Wthinnest <span class="se">\</span>
- -P -Sseashell > GMT_transverse_merc.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_transverse_merc.png"><img alt="_images/GMT_transverse_merc.png" src="_images/GMT_transverse_merc.png" style="width: 500px;" /></a>
-<p class="caption">Rectangular Transverse Mercator map.</p>
-</div>
-<p>The transverse Mercator can also be used to generate a global map - the
-equivalent of the 360º Mercator map. Using the command</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -R0/360/-80/80 -JT330/-45/3.5i -Ba30g -BWSne -Dc -A2000 <span class="se">\</span>
- -Slightblue -G0 -P > GMT_TM.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>we made the map illustrated in Figure <a class="reference internal" href="#gmt-tm"><em>Global transverse Mercator</em></a>. Note that
-when a world map is given (indicated by <strong>-R</strong><em>0/360/s/n</em>), the
-arguments are interpreted to mean oblique degrees, i.e., the 360º range
-is understood to mean the extent of the plot along the central meridian,
-while the “south” and “north” values represent how far from the central
-longitude we want the plot to extend. These values correspond to
-latitudes in the regular Mercator projection and must therefore be less
-than 90.</p>
-<div class="figure align-center" id="gmt-tm">
-<a class="reference internal image-reference" href="_images/GMT_TM.png"><img alt="_images/GMT_TM.png" src="_images/GMT_TM.png" style="width: 450px;" /></a>
-<p class="caption">A global transverse Mercator map.</p>
-</div>
-</div>
-<div class="section" id="universal-transverse-mercator-utm-projection-ju-ju">
-<h3>11.3.3. Universal Transverse Mercator (UTM) projection (<strong>-Ju</strong> <strong>-JU</strong>) <a class="reference internal" href="gmt.html#ju-full"><em>...</em></a><a class="headerlink" href="#universal-transverse-mercator-utm-projection-ju-ju" title="Permalink to this headline">¶</a></h3>
-<p>A particular subset of the transverse Mercator is the Universal
-Transverse Mercator (UTM) which was adopted by the US Army for
-large-scale military maps. Here, the globe is divided into 60 zones
-between 84ºS and 84ºN, most of which are 6 wide. Each of these UTM zones
-have their unique central meridian. Furthermore, each zone is divided
-into latitude bands but these are not needed to specify the projection
-for most cases. See Figure <a class="reference internal" href="#gmt-utm-zones"><em>Universal Transverse Mercator</em></a> for all zone designations.</p>
-<div class="figure align-center" id="gmt-utm-zones">
-<a class="reference internal image-reference" href="_images/GMT_utm_zones.png"><img alt="_images/GMT_utm_zones.png" src="_images/GMT_utm_zones.png" style="width: 700px;" /></a>
-<p class="caption">Universal Transverse Mercator zone layout.</p>
-</div>
-<p>GMT implements both the transverse Mercator and the UTM projection.
-When selecting UTM you must specify:</p>
-<ul class="simple">
-<li>UTM zone (A, B, 1–60, Y, Z). Use negative values for numerical zones
-in the southern hemisphere or append the latitude modifiers C–H, J–N,
-P–X) to specify an exact UTM grid zone.</li>
-<li>Scale along the equator in inch/degree or 1:xxxxx (<strong>-Ju</strong>), or map
-width (<strong>-JU</strong>).</li>
-</ul>
-<p>In order to minimize the distortion in any given zone, a scale factor of
-0.9996 has been factored into the formulae. (although a standard, you
-can change this with <a class="reference internal" href="gmt.conf.html#proj-scale-factor"><em>PROJ_SCALE_FACTOR</em></a>). This makes the UTM
-projection a <em>secant</em> projection and not a <em>tangent</em> projection like the
-transverse Mercator above. The scale only varies by 1 part in 1,000 from
-true scale at equator. The ellipsoidal projection expressions are
-accurate for map areas that extend less than 10 away from the central
-meridian. For larger regions we use the conformal latitude in the
-general spherical formulae instead.</p>
-</div>
-<div class="section" id="oblique-mercator-projection-jo-jo">
-<h3>11.3.4. Oblique Mercator projection (<strong>-Jo</strong> <strong>-JO</strong>) <a class="reference internal" href="gmt.html#jo-full"><em>...</em></a><a class="headerlink" href="#oblique-mercator-projection-jo-jo" title="Permalink to this headline">¶</a></h3>
-<p>Oblique configurations of the cylinder give rise to the oblique Mercator
-projection. It is particularly useful when mapping regions of large
-lateral extent in an oblique direction. Both parallels and meridians are
-complex curves. The projection was developed in the early 1900s by
-several workers. Several parameters must be provided to define the
-projection. GMT offers three different definitions:</p>
-<ol class="arabic simple">
-<li>Option <strong>-Joa</strong> or <strong>-JOa</strong>:<ul>
-<li>Longitude and latitude of projection center.</li>
-<li>Azimuth of the oblique equator.</li>
-<li>Scale in inch/degree or 1:xxxxx along oblique equator (<strong>-Joa</strong>),
-or map width (<strong>-JOa</strong>).</li>
-</ul>
-</li>
-<li>Option <strong>-Job</strong> or <strong>-JOb</strong>:<ul>
-<li>Longitude and latitude of projection center.</li>
-<li>Longitude and latitude of second point on oblique equator.</li>
-<li>Scale in inch/degree or 1:xxxxx along oblique equator (<strong>-Job</strong>),
-or map width (<strong>-JOb</strong>).</li>
-</ul>
-</li>
-<li>Option <strong>-Joc</strong> or <strong>-JOc</strong>:<ul>
-<li>Longitude and latitude of projection center.</li>
-<li>Longitude and latitude of projection pole.</li>
-<li>Scale in inch/degree or 1:xxxxx along oblique equator (<strong>-Joc</strong>),
-or map width (<strong>-JOc</strong>).</li>
-</ul>
-</li>
-</ol>
-<p>Our example was produced by the command</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -R270/20/305/25r -JOc280/25.5/22/69/4.8i -Bag -Di -A250 -Gburlywood <span class="se">\</span>
- -Wthinnest -P -Tf301.5/23/0.4i/2 -Sazure --FONT_TITLE<span class="o">=</span>8p <span class="se">\</span>
- --MAP_TITLE_OFFSET<span class="o">=</span>0.05i > GMT_obl_merc.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_obl_merc.png"><img alt="_images/GMT_obl_merc.png" src="_images/GMT_obl_merc.png" style="width: 500px;" /></a>
-<p class="caption">Oblique Mercator map using <strong>-Joc</strong>. We make it clear which direction is North by
-adding a star rose with the <strong>-T</strong> option.</p>
-</div>
-<p>It uses definition 3 for an oblique view of some Caribbean islands. Note
-that we define our region using the rectangular system described
-earlier. If we do not append an “r” to the <strong>-R</strong> string then the
-information provided with the <strong>-R</strong> option is assumed to be oblique
-degrees about the projection center rather than the usual geographic
-coordinates. This interpretation is chosen since in general the
-parallels and meridians are not very suitable as map boundaries.</p>
-</div>
-<div class="section" id="cassini-cylindrical-projection-jc-jc">
-<h3>11.3.5. Cassini cylindrical projection (<strong>-Jc</strong> <strong>-JC</strong>) <a class="reference internal" href="gmt.html#jc-full"><em>...</em></a><a class="headerlink" href="#cassini-cylindrical-projection-jc-jc" title="Permalink to this headline">¶</a></h3>
-<p>This cylindrical projection was developed in 1745 by César-François
-Cassini de Thury for the survey of France. It is occasionally called
-Cassini-Soldner since the latter provided the more accurate mathematical
-analysis that led to the development of the ellipsoidal formulae. The
-projection is neither conformal nor equal-area, and behaves as a
-compromise between the two end-members. The distortion is zero along the
-central meridian. It is best suited for mapping regions of north-south
-extent. The central meridian, each meridian 90º away, and equator are
-straight lines; all other meridians and parallels are complex curves.
-The requirements to define this projection are:</p>
-<ul class="simple">
-<li>Longitude and latitude of central point.</li>
-<li>Scale in inch/degree or as 1:xxxxx (<strong>-Jc</strong>), or map width (<strong>-JC</strong>).</li>
-</ul>
-<p>A detailed map of the island of Sardinia centered on the 8º45’E meridian
-using the Cassini projection can be obtained by running the command:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -R7:30/38:30/10:30/41:30r -JC8.75/40/2.5i -Bafg -Lf9.5/38.8/40/60 -Gspringgreen <span class="se">\</span>
- -Dh -Sazure -Wthinnest -Ia/thinner -P --FONT_LABEL<span class="o">=</span>12p > GMT_cassini.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_cassini.png"><img alt="_images/GMT_cassini.png" src="_images/GMT_cassini.png" style="width: 400px;" /></a>
-<p class="caption">Cassini map over Sardinia.</p>
-</div>
-<p>As with the previous projections, the user can choose between a
-rectangular boundary (used here) or a geographical (WESN) boundary.</p>
-</div>
-<div class="section" id="cylindrical-equidistant-projection-jq-jq">
-<h3>11.3.6. Cylindrical equidistant projection (<strong>-Jq</strong> <strong>-JQ</strong>) <a class="reference internal" href="gmt.html#jq-full"><em>...</em></a><a class="headerlink" href="#cylindrical-equidistant-projection-jq-jq" title="Permalink to this headline">¶</a></h3>
-<p>This simple cylindrical projection is really a linear scaling of
-longitudes and latitudes. The most common form is the Plate Carrée
-projection, where the scaling of longitudes and latitudes is the same.
-All meridians and parallels are straight lines. The projection can be
-defined by:</p>
-<ul class="simple">
-<li>The central meridian [Middle of your map].</li>
-<li>Standard parallel [Equator].</li>
-<li>Scale in inch/degree or as 1:xxxxx (<strong>-Jq</strong>), or map width (<strong>-JQ</strong>).</li>
-</ul>
-<p>The first two of these are optional and have defaults. When the standard
-parallel is defined, the central meridian must be supplied as well.</p>
-<p>A world map centered on the dateline using this projection can be
-obtained by running the command:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -Rg -JQ4.5i -B60f30g30 -Dc -A5000 -Gtan4 -Slightcyan -P > GMT_equi_cyl.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_equi_cyl.png"><img alt="_images/GMT_equi_cyl.png" src="_images/GMT_equi_cyl.png" style="width: 500px;" /></a>
-<p class="caption">World map using the Plate Carrée projection.</p>
-</div>
-<p>Different relative scalings of longitudes and latitudes can be obtained
-by selecting a standard parallel different from the equator. Some
-selections for standard parallels have practical properties as shown in
-Table <a class="reference internal" href="#tbl-jq"><em>JQ</em></a>.</p>
-<table border="1" class="docutils" id="tbl-jq">
-<colgroup>
-<col width="87%" />
-<col width="13%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"> </th>
-<th class="head"> </th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>Grafarend and Niermann, minimum linear distortion</td>
-<td>61.7º</td>
-</tr>
-<tr class="row-odd"><td>Ronald Miller Equirectangular</td>
-<td>50.5º</td>
-</tr>
-<tr class="row-even"><td>Ronald Miller, minimum continental distortion</td>
-<td>43.5º</td>
-</tr>
-<tr class="row-odd"><td>Grafarend and Niermann</td>
-<td>42º</td>
-</tr>
-<tr class="row-even"><td>Ronald Miller, minimum overall distortion</td>
-<td>37.5º</td>
-</tr>
-<tr class="row-odd"><td>Plate Carrée, Simple Cylindrical, Plain/Plane</td>
-<td>0º</td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="cylindrical-equal-area-projections-jy-jy">
-<h3>11.3.7. Cylindrical equal-area projections (<strong>-Jy</strong> <strong>-JY</strong>) <a class="reference internal" href="gmt.html#jy-full"><em>...</em></a><a class="headerlink" href="#cylindrical-equal-area-projections-jy-jy" title="Permalink to this headline">¶</a></h3>
-<p>This cylindrical projection is actually several projections, depending
-on what latitude is selected as the standard parallel. However, they are
-all equal area and hence non-conformal. All meridians and parallels are
-straight lines. The requirements to define this projection are:</p>
-<ul class="simple">
-<li>The central meridian.</li>
-<li>The standard parallel.</li>
-<li>Scale in inch/degree or as 1:xxxxx (<strong>-Jy</strong>), or map width (<strong>-JY</strong>)</li>
-</ul>
-<p>While you may choose any value for the standard parallel and obtain your
-own personal projection, there are seven choices of standard parallels
-that result in known (or named) projections. These are listed in Table <a class="reference internal" href="#tbl-jy"><em>JY</em></a>.</p>
-<table border="1" class="docutils" id="tbl-jy">
-<colgroup>
-<col width="48%" />
-<col width="53%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"> </th>
-<th class="head"> </th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>Balthasart</td>
-<td>50º</td>
-</tr>
-<tr class="row-odd"><td>Gall-Peters</td>
-<td>45º</td>
-</tr>
-<tr class="row-even"><td>Hobo-Dyer</td>
-<td>37º30’ (= 37.5º)</td>
-</tr>
-<tr class="row-odd"><td>Trystan Edwards</td>
-<td>37º24’ (= 37.4º)</td>
-</tr>
-<tr class="row-even"><td>Caster</td>
-<td>37º04’ (= 37.0666º)</td>
-</tr>
-<tr class="row-odd"><td>Behrman</td>
-<td>30º</td>
-</tr>
-<tr class="row-even"><td>Lambert</td>
-<td>0º</td>
-</tr>
-</tbody>
-</table>
-<p>For instance, a world map centered on the 35ºE meridian using the Behrman
-projection (Figure <a class="reference internal" href="#gmt-general-cyl"><em>Behrman cylindrical projection</em></a>)
-can be obtained by running the command:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -R-145/215/-90/90 -JY35/30/4.5i -B45g45 -Dc -A10000 -Sdodgerblue <span class="se">\</span>
- -Wthinnest -P > GMT_general_cyl.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center" id="gmt-general-cyl">
-<a class="reference internal image-reference" href="_images/GMT_general_cyl.png"><img alt="_images/GMT_general_cyl.png" src="_images/GMT_general_cyl.png" style="width: 600px;" /></a>
-<p class="caption">World map using the Behrman cylindrical equal-area projection.</p>
-</div>
-<p>As one can see there is considerable distortion at high latitudes since
-the poles map into lines.</p>
-</div>
-<div class="section" id="miller-cylindrical-projection-jj-jj">
-<h3>11.3.8. Miller Cylindrical projection (<strong>-Jj</strong> <strong>-JJ</strong>) <a class="reference internal" href="gmt.html#jj-full"><em>...</em></a><a class="headerlink" href="#miller-cylindrical-projection-jj-jj" title="Permalink to this headline">¶</a></h3>
-<p>This cylindrical projection, presented by Osborn Maitland Miller of the
-American Geographic Society in 1942, is neither equal nor conformal. All
-meridians and parallels are straight lines. The projection was designed
-to be a compromise between Mercator and other cylindrical projections.
-Specifically, Miller spaced the parallels by using Mercator’s formula
-with 0.8 times the actual latitude, thus avoiding the singular poles;
-the result was then divided by 0.8. There is only a spherical form for
-this projection. Specify the projection by:</p>
-<ul class="simple">
-<li>Optionally, the central meridian (default is the middle of your map).</li>
-<li>Scale in inch/degree or as 1:xxxxx (<strong>-Jj</strong>), or map width (<strong>-JJ</strong>).</li>
-</ul>
-<p>For instance, a world map centered on the 90ºE meridian at a map scale of
-1:400,000,000 (Figure <a class="reference internal" href="#gmt-miller"><em>Miller projection</em></a>) can be obtained as
-follows:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -R-90/270/-80/90 -Jj1:400000000 -Bx45g45 -By30g30 -Dc -A10000 <span class="se">\</span>
- -Gkhaki -Wthinnest -P -Sazure > GMT_miller.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center" id="gmt-miller">
-<a class="reference internal image-reference" href="_images/GMT_miller.png"><img alt="_images/GMT_miller.png" src="_images/GMT_miller.png" style="width: 500px;" /></a>
-<p class="caption">World map using the Miller cylindrical projection.</p>
-</div>
-</div>
-<div class="section" id="cylindrical-stereographic-projections-jcyl-stere-jcyl-stere">
-<h3>11.3.9. Cylindrical stereographic projections (<strong>-Jcyl_stere</strong> <strong>-JCyl_stere</strong>) <a class="reference internal" href="gmt.html#jcyl-stere-full"><em>...</em></a><a class="headerlink" href="#cylindrical-stereographic-projections-jcyl-stere-jcyl-stere" title="Permalink to this headline">¶</a></h3>
-<p>The cylindrical stereographic projections are certainly not as notable
-as other cylindrical projections, but are still used because of their
-relative simplicity and their ability to overcome some of the downsides
-of other cylindrical projections, like extreme distortions of the higher
-latitudes. The stereographic projections are perspective projections,
-projecting the sphere onto a cylinder in the direction of the antipodal
-point on the equator. The cylinder crosses the sphere at two standard
-parallels, equidistant from the equator. The projections are defined by:</p>
-<ul class="simple">
-<li>The central meridian (uses the middle of the map when omitted).</li>
-<li>The standard parallel (default is the Equator). When used, central
-meridian needs to be given as well.</li>
-<li>Scale in inch/degree or as 1:xxxxx (<strong>-Jcyl_stere</strong>), or map width
-(<strong>-JCyl_stere</strong>)</li>
-</ul>
-<p>Some of the selections of the standard parallel are named for the
-cartographer or publication that popularized the projection
-(Table <a class="reference internal" href="#tbl-jcylstere"><em>JCylstere</em></a>).</p>
-<table border="1" class="docutils" id="tbl-jcylstere">
-<colgroup>
-<col width="81%" />
-<col width="19%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"> </th>
-<th class="head"> </th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>Miller’s modified Gall</td>
-<td>66.159467º</td>
-</tr>
-<tr class="row-odd"><td>Kamenetskiy’s First</td>
-<td>55º</td>
-</tr>
-<tr class="row-even"><td>Gall’s stereographic</td>
-<td>45º</td>
-</tr>
-<tr class="row-odd"><td>Bolshoi Sovietskii Atlas Mira or Kamenetskiy’s Second</td>
-<td>30º</td>
-</tr>
-<tr class="row-even"><td>Braun’s cylindrical</td>
-<td>0º</td>
-</tr>
-</tbody>
-</table>
-<p>A map of the world, centered on the Greenwich meridian, using the Gall’s
-stereographic projection (standard parallel is 45º,
-Figure <a class="reference internal" href="#gmt-gall-stereo"><em>Gall’s stereographic projection</em></a>),
-is obtained as follows:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt <span class="nb">set </span>FORMAT_GEO_MAP dddA
-gmt pscoast -R-180/180/-60/80 -JCyl_stere/0/45/4.5i -Bxa60f30g30 -Bya30g30 -Dc -A5000 <span class="se">\</span>
- -Wblack -Gseashell4 -Santiquewhite1 -P > GMT_gall_stereo.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center" id="gmt-gall-stereo">
-<a class="reference internal image-reference" href="_images/GMT_gall_stereo.png"><img alt="_images/GMT_gall_stereo.png" src="_images/GMT_gall_stereo.png" style="width: 500px;" /></a>
-<p class="caption">World map using Gall’s stereographic projection.</p>
-</div>
-</div>
-</div>
-<div class="section" id="miscellaneous-projections">
-<h2>11.4. Miscellaneous projections<a class="headerlink" href="#miscellaneous-projections" title="Permalink to this headline">¶</a></h2>
-<p>GMT supports 8 common projections for global presentation of data or
-models. These are the Hammer, Mollweide, Winkel Tripel, Robinson, Eckert
-IV and VI, Sinusoidal, and Van der Grinten projections. Due to the small
-scale used for global maps these projections all use the spherical
-approximation rather than more elaborate elliptical formulae.</p>
-<p>In all cases, the specification of the central meridian can be skipped.
-The default is the middle of the longitude range of the plot, specified
-by the (<strong>-R</strong>) option.</p>
-<div class="section" id="hammer-projection-jh-jh">
-<h3>11.4.1. Hammer projection (<strong>-Jh</strong> <strong>-JH</strong>) <a class="reference internal" href="gmt.html#jh-full"><em>...</em></a><a class="headerlink" href="#hammer-projection-jh-jh" title="Permalink to this headline">¶</a></h3>
-<p>The equal-area Hammer projection, first presented by the German
-mathematician Ernst von Hammer in 1892, is also known as Hammer-Aitoff
-(the Aitoff projection looks similar, but is not equal-area). The border
-is an ellipse, equator and central meridian are straight lines, while
-other parallels and meridians are complex curves. The projection is
-defined by selecting:</p>
-<ul class="simple">
-<li>The central meridian [Middle of your map].</li>
-<li>Scale along equator in inch/degree or 1:xxxxx (<strong>-Jh</strong>), or map width (<strong>-JH</strong>).</li>
-</ul>
-<p>A view of the Pacific ocean using the Dateline as central meridian is accomplished thus</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -Rg -JH4.5i -Bg -Dc -A10000 -Gblack -Scornsilk -P > GMT_hammer.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_hammer.png"><img alt="_images/GMT_hammer.png" src="_images/GMT_hammer.png" style="width: 500px;" /></a>
-<p class="caption">World map using the Hammer projection.</p>
-</div>
-</div>
-<div class="section" id="mollweide-projection-jw-jw">
-<h3>11.4.2. Mollweide projection (<strong>-Jw</strong> <strong>-JW</strong>) <a class="reference internal" href="gmt.html#jw-full"><em>...</em></a><a class="headerlink" href="#mollweide-projection-jw-jw" title="Permalink to this headline">¶</a></h3>
-<p>This pseudo-cylindrical, equal-area projection was developed by the
-German mathematician and astronomer Karl Brandan Mollweide in 1805.
-Parallels are unequally spaced straight lines with the meridians being
-equally spaced elliptical arcs. The scale is only true along latitudes
-4044’ north and south. The projection is used mainly for global maps
-showing data distributions. It is occasionally referenced under the name
-homalographic projection. Like the Hammer projection, outlined above, we
-need to specify only two parameters to completely define the mapping of
-longitudes and latitudes into rectangular <em>x</em>/<em>y</em> coordinates:</p>
-<ul class="simple">
-<li>The central meridian [Middle of your map].</li>
-<li>Scale along equator in inch/degree or 1:xxxxx (<strong>-Jw</strong>), or map width (<strong>-JW</strong>).</li>
-</ul>
-<p>An example centered on Greenwich can be generated thus:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -Rd -JW4.5i -Bg -Dc -A10000 -Gtomato1 -Sskyblue -P > GMT_mollweide.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_mollweide.png"><img alt="_images/GMT_mollweide.png" src="_images/GMT_mollweide.png" style="width: 500px;" /></a>
-<p class="caption">World map using the Mollweide projection.</p>
-</div>
-</div>
-<div class="section" id="winkel-tripel-projection-jr-jr">
-<h3>11.4.3. Winkel Tripel projection (<strong>-Jr</strong> <strong>-JR</strong>) <a class="reference internal" href="gmt.html#jr-full"><em>...</em></a><a class="headerlink" href="#winkel-tripel-projection-jr-jr" title="Permalink to this headline">¶</a></h3>
-<p>In 1921, the German mathematician Oswald Winkel a projection that was to
-strike a compromise between the properties of three elements (area,
-angle and distance). The German word “tripel” refers to this junction of
-where each of these elements are least distorted when plotting global
-maps. The projection was popularized when Bartholomew and Son started to
-use it in its world-renowned “The Times Atlas of the World” in the mid
-20th century. In 1998, the National Geographic Society made the Winkel
-Tripel as its map projection of choice for global maps.</p>
-<p>Naturally, this projection is neither conformal, nor equal-area. Central
-meridian and equator are straight lines; other parallels and meridians
-are curved. The projection is obtained by averaging the coordinates of
-the Equidistant Cylindrical and Aitoff (not Hammer-Aitoff) projections.
-The poles map into straight lines 0.4 times the length of equator. To
-use it you must enter</p>
-<ul class="simple">
-<li>The central meridian [Middle of your map].</li>
-<li>Scale along equator in inch/degree or 1:xxxxx (<strong>-Jr</strong>), or map width (<strong>-JR</strong>).</li>
-</ul>
-<p>Centered on Greenwich, the example in Figure <a class="reference internal" href="#gmt-winkel"><em>Winkel Tripel projection</em></a> was created by this command:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -Rd -JR4.5i -Bg -Dc -A10000 -Gburlywood4 -Swheat1 -P > GMT_winkel.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center" id="gmt-winkel">
-<a class="reference internal image-reference" href="_images/GMT_winkel.png"><img alt="_images/GMT_winkel.png" src="_images/GMT_winkel.png" style="width: 500px;" /></a>
-<p class="caption">World map using the Winkel Tripel projection.</p>
-</div>
-</div>
-<div class="section" id="robinson-projection-jn-jn">
-<h3>11.4.4. Robinson projection (<strong>-Jn</strong> <strong>-JN</strong>) <a class="reference internal" href="gmt.html#jn-full"><em>...</em></a><a class="headerlink" href="#robinson-projection-jn-jn" title="Permalink to this headline">¶</a></h3>
-<p>The Robinson projection, presented by the American geographer and
-cartographer Arthur H. Robinson in 1963, is a modified cylindrical
-projection that is neither conformal nor equal-area. Central meridian
-and all parallels are straight lines; other meridians are curved. It
-uses lookup tables rather than analytic expressions to make the world
-map “look” right <a class="footnote-reference" href="#id69" id="id25">[22]</a>. The scale is true along latitudes 38. The
-projection was originally developed for use by Rand McNally and is
-currently used by the National Geographic Society. To use it you must
-enter</p>
-<ul class="simple">
-<li>The central meridian [Middle of your map].</li>
-<li>Scale along equator in inch/degree or 1:xxxxx (<strong>-Jn</strong>), or map width
-(<strong>-JN</strong>).</li>
-</ul>
-<p>Again centered on Greenwich, the example below was created by this command:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -Rd -JN4.5i -Bg -Dc -A10000 -Ggoldenrod -Ssnow2 -P > GMT_robinson.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_robinson.png"><img alt="_images/GMT_robinson.png" src="_images/GMT_robinson.png" style="width: 500px;" /></a>
-<p class="caption">World map using the Robinson projection.</p>
-</div>
-</div>
-<div class="section" id="eckert-iv-and-vi-projection-jk-jk">
-<h3>11.4.5. Eckert IV and VI projection (<strong>-Jk</strong> <strong>-JK</strong>) <a class="reference internal" href="gmt.html#jk-full"><em>...</em></a><a class="headerlink" href="#eckert-iv-and-vi-projection-jk-jk" title="Permalink to this headline">¶</a></h3>
-<p>The Eckert IV and VI projections, presented by the German cartographer
-Max Eckert-Greiffendorff in 1906, are pseudocylindrical equal-area
-projections. Central meridian and all parallels are straight lines;
-other meridians are equally spaced elliptical arcs (IV) or sinusoids
-(VI). The scale is true along latitudes 40º30’ (IV) and 49º16’ (VI). Their
-main use is in thematic world maps. To select Eckert IV you must use
-<strong>-JKf</strong> (<strong>f</strong> for “four”) while Eckert VI is selected with <strong>-JKs</strong>
-(<strong>s</strong> for “six”). If no modifier is given it defaults to Eckert VI. In
-addition, you must enter</p>
-<ul class="simple">
-<li>The central meridian [Middle of your map].</li>
-<li>Scale along equator in inch/degree or 1:xxxxx (<strong>-Jk</strong>), or map width
-(<strong>-JK</strong>).</li>
-</ul>
-<p>Centered on the Dateline, the Eckert IV example below was created by
-this command:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -Rg -JKf4.5i -Bg -Dc -A10000 -Wthinnest -Givory -Sbisque3 -P > GMT_eckert4.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_eckert4.png"><img alt="_images/GMT_eckert4.png" src="_images/GMT_eckert4.png" style="width: 500px;" /></a>
-<p class="caption">World map using the Eckert IV projection.</p>
-</div>
-<p>The same script, with <strong>s</strong> instead of <strong>f</strong>, yields the Eckert VI map:</p>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_eckert6.png"><img alt="_images/GMT_eckert6.png" src="_images/GMT_eckert6.png" style="width: 500px;" /></a>
-<p class="caption">World map using the Eckert VI projection.</p>
-</div>
-</div>
-<div class="section" id="sinusoidal-projection-ji-ji">
-<h3>11.4.6. Sinusoidal projection (<strong>-Ji</strong> <strong>-JI</strong>) <a class="reference internal" href="gmt.html#ji-full"><em>...</em></a><a class="headerlink" href="#sinusoidal-projection-ji-ji" title="Permalink to this headline">¶</a></h3>
-<p>The sinusoidal projection is one of the oldest known projections, is
-equal-area, and has been used since the mid-16th century. It has also
-been called the “Equal-area Mercator” projection. The central meridian
-is a straight line; all other meridians are sinusoidal curves. Parallels
-are all equally spaced straight lines, with scale being true along all
-parallels (and central meridian). To use it, you need to select:</p>
-<ul class="simple">
-<li>The central meridian [Middle of your map].</li>
-<li>Scale along equator in inch/degree or 1:xxxxx (<strong>-Ji</strong>), or map width
-(<strong>-JI</strong>).</li>
-</ul>
-<p>A simple world map using the sinusoidal projection is therefore obtained by</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -Rd -JI4.5i -Bxg30 -Byg15 -Dc -A10000 -Ggray -P > GMT_sinusoidal.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_sinusoidal.png"><img alt="_images/GMT_sinusoidal.png" src="_images/GMT_sinusoidal.png" style="width: 500px;" /></a>
-<p class="caption">World map using the Sinusoidal projection.</p>
-</div>
-<p>To reduce distortion of shape the interrupted sinusoidal projection was
-introduced in 1927. Here, three symmetrical segments are used to cover
-the entire world. Traditionally, the interruptions are at 160ºW, 20ºW, and
-60ºE. To make the interrupted map we must call
-<a class="reference internal" href="pscoast.html"><em>pscoast</em></a> for each segment and superpose
-the results. To produce an interrupted world map (with the traditional
-boundaries just mentioned) that is 5.04 inches wide we use the scale
-5.04/360 = 0.014 and offset the subsequent plots horizontally by their
-widths (140<img class="math" src="_images/math/795ea6abc60ad6201a8e025e49dff601315f867b.png" alt="\cdot"/>0.014 and 80<img class="math" src="_images/math/795ea6abc60ad6201a8e025e49dff601315f867b.png" alt="\cdot"/>0.014):</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -R200/340/-90/90 -Ji0.014i -Bxg30 -Byg15 -A10000 -Dc <span class="se">\</span>
- -Gblack -K -P > GMT_sinus_int.ps
-gmt pscoast -R-20/60/-90/90 -Ji0.014i -Bxg30 -Byg15 -Dc -A10000 <span class="se">\</span>
- -Gblack -X1.96i -O -K >> GMT_sinus_int.ps
-gmt pscoast -R60/200/-90/90 -Ji0.014i -Bxg30 -Byg15 -Dc -A10000 <span class="se">\</span>
- -Gblack -X1.12i -O >> GMT_sinus_int.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_sinus_int.png"><img alt="_images/GMT_sinus_int.png" src="_images/GMT_sinus_int.png" style="width: 500px;" /></a>
-<p class="caption">World map using the Interrupted Sinusoidal projection.</p>
-</div>
-<p>The usefulness of the interrupted sinusoidal projection is basically
-limited to display of global, discontinuous data distributions like
-hydrocarbon and mineral resources, etc.</p>
-</div>
-<div class="section" id="van-der-grinten-projection-jv-jv">
-<h3>11.4.7. Van der Grinten projection (<strong>-Jv</strong> <strong>-JV</strong>) <a class="reference internal" href="gmt.html#jv-full"><em>...</em></a><a class="headerlink" href="#van-der-grinten-projection-jv-jv" title="Permalink to this headline">¶</a></h3>
-<p>The Van der Grinten projection, presented by Alphons J. van der Grinten
-in 1904, is neither equal-area nor conformal. Central meridian and
-Equator are straight lines; other meridians are arcs of circles. The
-scale is true along the Equator only. Its main use is to show the entire
-world enclosed in a circle. To use it you must enter</p>
-<ul class="simple">
-<li>The central meridian [Middle of your map].</li>
-<li>Scale along equator in inch/degree or 1:xxxxx (<strong>-Jv</strong>), or map width (<strong>-JV</strong>).</li>
-</ul>
-<p>Centered on the Dateline, the example below was created by this command:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -Rg -JV4i -Bxg30 -Byg15 -Dc -Glightgray -A10000 <span class="se">\</span>
- -Wthinnest -P > GMT_grinten.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_grinten.png"><img alt="_images/GMT_grinten.png" src="_images/GMT_grinten.png" style="width: 400px;" /></a>
-<p class="caption">World map using the Van der Grinten projection.</p>
-</div>
-</div>
-</div>
-</div>
-<div class="section" id="creating-gmt-graphics">
-<h1>12. Creating GMT Graphics<a class="headerlink" href="#creating-gmt-graphics" title="Permalink to this headline">¶</a></h1>
-<p>See separate entry for GMT Examples under <a class="reference internal" href="Gallery.html#example-gallery"><em>Gallery</em></a>.</p>
-</div>
-<div class="section" id="creating-gmt-animations">
-<h1>13. Creating GMT Animations<a class="headerlink" href="#creating-gmt-animations" title="Permalink to this headline">¶</a></h1>
-<p>See separate entry for GMT Animations under <a class="reference internal" href="Gallery.html#example-gallery"><em>Gallery</em></a>.</p>
-</div>
-<div class="section" id="a-gmt-supplemental-packages">
-<h1>14. A. GMT Supplemental Packages<a class="headerlink" href="#a-gmt-supplemental-packages" title="Permalink to this headline">¶</a></h1>
-<p>These packages are for the most part written and supported by us, but
-there are some exceptions. They provide extensions of GMT that are
-needed for particular rather than general applications. The software is
-provided in a separate, supplemental archive (GMT_suppl.tar.gz (or .bz2)).
-Questions or bug reports for this software
-should be addressed to the person(s) listed in the <tt class="docutils literal"><span class="pre">README</span></tt> file associated with
-the particular program. It is not guaranteed that these programs are
-fully ANSI-C, Y2K, or POSIX compliant, or that they necessarily will
-install smoothly on all platforms, but most do. Note that the data sets
-some of these programs work on are not distributed with these packages;
-they must be obtained separately. The contents of the supplemental
-archive may change without notice; at this writing it contains these directories:</p>
-<div class="section" id="gshhg-gshhg-data-extractor">
-<h2>14.1. gshhg: GSHHG data extractor<a class="headerlink" href="#gshhg-gshhg-data-extractor" title="Permalink to this headline">¶</a></h2>
-<p>This package contains <a class="reference internal" href="supplements/gshhg/gshhg.html"><em>gshhg</em></a> which you
-can use to extract shoreline polygons from the Global Self-consistent
-Hierarchical High-resolution Shorelines (GSHHG) available separately
-from or the (GSHHG is the polygon data base from which the
-GMT coastlines derive). The package is maintained by Paul Wessel.</p>
-</div>
-<div class="section" id="img-gridded-altimetry-extractor">
-<h2>14.2. img: gridded altimetry extractor<a class="headerlink" href="#img-gridded-altimetry-extractor" title="Permalink to this headline">¶</a></h2>
-<p>This package consists of the program
-<a class="reference internal" href="supplements/img/img2grd.html"><em>img2grd</em></a> to extract subsets of the
-global gravity and predicted topography solutions derived from satellite
-altimetry <a class="footnote-reference" href="#id75" id="id32">[28]</a>. The package is maintained by Walter Smith and Paul Wessel.</p>
-</div>
-<div class="section" id="meca-seismology-and-geodesy-symbols">
-<h2>14.3. meca: seismology and geodesy symbols<a class="headerlink" href="#meca-seismology-and-geodesy-symbols" title="Permalink to this headline">¶</a></h2>
-<p>This package contains the programs
-<a class="reference internal" href="supplements/meca/pscoupe.html"><em>pscoupe</em></a>,
-<a class="reference internal" href="supplements/meca/psmeca.html"><em>psmeca</em></a>,
-<a class="reference internal" href="supplements/meca/pspolar.html"><em>pspolar</em></a>, and
-<a class="reference internal" href="supplements/meca/psvelo.html"><em>psvelo</em></a> which are used by seismologists
-and geodesists for plotting focal mechanisms (including cross-sections
-and polarities), error ellipses, velocity arrows, rotational wedges, and
-more. The package was developed by Kurt Feigl and Genevieve
-Patau but is now maintained by the GMT team.</p>
-</div>
-<div class="section" id="mgd77-mgd77-extractor-and-plotting-tools">
-<h2>14.4. mgd77: MGD77 extractor and plotting tools<a class="headerlink" href="#mgd77-mgd77-extractor-and-plotting-tools" title="Permalink to this headline">¶</a></h2>
-<p>This package currently holds the programs
-<a class="reference internal" href="supplements/mgd77/mgd77convert.html"><em>mgd77convert</em></a>,
-<a class="reference internal" href="supplements/mgd77/mgd77info.html"><em>mgd77info</em></a>,
-<a class="reference internal" href="supplements/mgd77/mgd77list.html"><em>mgd77list</em></a>,
-<a class="reference internal" href="supplements/mgd77/mgd77magref.html"><em>mgd77magref</em></a>,
-<a class="reference internal" href="supplements/mgd77/mgd77manage.html"><em>mgd77manage</em></a>,
-<a class="reference internal" href="supplements/mgd77/mgd77path.html"><em>mgd77path</em></a>,
-<a class="reference internal" href="supplements/mgd77/mgd77sniffer.html"><em>mgd77sniffer</em></a>, and
-<a class="reference internal" href="supplements/mgd77/mgd77track.html"><em>mgd77track</em></a> which can be used to
-extract information or data values from or plot marine geophysical data
-files in the ASCII MGD77 or netCDF MGD77+ formats <a class="footnote-reference" href="#id76" id="id33">[29]</a>). This package
-has replaced the old <strong>mgg</strong> package. The package is maintained by Paul Wessel.</p>
-</div>
-<div class="section" id="misc-miscellaneous-tools">
-<h2>14.5. misc: Miscellaneous tools<a class="headerlink" href="#misc-miscellaneous-tools" title="Permalink to this headline">¶</a></h2>
-<p>At the moment, this package contains the program
-<a class="reference internal" href="supplements/misc/dimfilter.html"><em>dimfilter</em></a>, which is an extension of
-<a class="reference internal" href="grdfilter.html"><em>grdfilter</em></a> in that it allows for spatial directional filtering.
-The package is maintained by Paul Wessel.</p>
-</div>
-<div class="section" id="potential-geopotential-tools">
-<h2>14.6. potential: Geopotential tools<a class="headerlink" href="#potential-geopotential-tools" title="Permalink to this headline">¶</a></h2>
-<p>At the moment, this package contains the programs
-<a class="reference internal" href="supplements/potential/gravfft.html"><em>gravfft</em></a>, which performs gravity,
-isostasy, and admittance calculation for grids,
-<a class="reference internal" href="supplements/potential/grdredpol.html"><em>grdredpol</em></a>, which compute the
-continuous reduction to the pole, AKA differential RTP for magnetic
-data, <a class="reference internal" href="supplements/potential/grdseamount.html"><em>grdseamount</em></a>, which computes
-synthetic bathymetry over various seamount shapes, and
-<a class="reference internal" href="supplements/potential/gmtgravmag3d.html"><em>gmtgravmag3d</em></a> and
-<a class="reference internal" href="supplements/potential/grdgravmag3d.html"><em>grdgravmag3d</em></a>,
-which computes the gravity or
-magnetic anomaly of a body by the method of Okabe <a class="footnote-reference" href="#id78" id="id34">[30]</a>. The package is
-maintained by Joaquim Luis and Paul Wessel.</p>
-</div>
-<div class="section" id="segyprogs-plotting-segy-seismic-data">
-<h2>14.7. segyprogs: plotting SEGY seismic data<a class="headerlink" href="#segyprogs-plotting-segy-seismic-data" title="Permalink to this headline">¶</a></h2>
-<p>This package contains programs to plot SEGY seismic data files using the
-GMT mapping transformations and postscript library.
-<a class="reference internal" href="supplements/segy/pssegy.html"><em>pssegy</em></a> generates a 2-D plot (x:location
-and y:time/depth) while <a class="reference internal" href="supplements/segy/pssegyz.html"><em>pssegyz</em></a>
-generates a 3-D plot (x and y: location coordinates, z: time/depth).
-Locations may be read from predefined or arbitrary portions of each
-trace header. Finally, <a class="reference internal" href="supplements/segy/segy2grd.html"><em>segy2grd</em></a> can
-convert SEGY data to a GMT grid file. The package is maintained by Tim Henstock <a class="footnote-reference" href="#id79" id="id35">[31]</a>.</p>
-</div>
-<div class="section" id="spotter-backtracking-and-hotspotting">
-<h2>14.8. spotter: backtracking and hotspotting<a class="headerlink" href="#spotter-backtracking-and-hotspotting" title="Permalink to this headline">¶</a></h2>
-<p>This package contains the plate tectonic programs
-<a class="reference internal" href="supplements/spotter/backtracker.html"><em>backtracker</em></a>, which you can use to
-move geologic markers forward or backward in time,
-<a class="reference internal" href="supplements/spotter/grdpmodeler.html"><em>grdpmodeler</em></a> which evaluates
-predictions of a plate motion model on a grid,
-<a class="reference internal" href="supplements/spotter/grdrotater.html"><em>grdrotater</em></a> which rotates entire
-grids using a finite rotation,
-<a class="reference internal" href="supplements/spotter/hotspotter.html"><em>hotspotter</em></a> which generates CVA
-grids based on seamount locations and a set of absolute plate motion
-stage poles (<a class="reference internal" href="supplements/spotter/grdspotter.html"><em>grdspotter</em></a> does the
-same using a bathymetry grid instead of seamount locations),
-<a class="reference internal" href="supplements/spotter/originator.html"><em>originator</em></a>, which associates
-seamounts with the most likely hotspot origins, and
-<a class="reference internal" href="supplements/spotter/rotconverter.html"><em>rotconverter</em></a> which does various
-operations involving finite rotations on a sphere. The package is
-maintained by Paul Wessel.</p>
-</div>
-<div class="section" id="x2sys-track-crossover-error-estimation">
-<h2>14.9. x2sys: track crossover error estimation<a class="headerlink" href="#x2sys-track-crossover-error-estimation" title="Permalink to this headline">¶</a></h2>
-<p>This package contains the tools
-<a class="reference internal" href="supplements/x2sys/x2sys_datalist.html"><em>x2sys_datalist</em></a>, which allows
-you to extract data from almost any binary or ASCII data file, and
-<a class="reference internal" href="supplements/x2sys/x2sys_cross.html"><em>x2sys_cross</em></a> which determines
-crossover locations and errors generated by one or several geospatial
-tracks. Newly added are the tools
-<a class="reference internal" href="supplements/x2sys/x2sys_init.html"><em>x2sys_init</em></a>,
-<a class="reference internal" href="supplements/x2sys/x2sys_binlist.html"><em>x2sys_binlist</em></a>,
-<a class="reference internal" href="supplements/x2sys/x2sys_get.html"><em>x2sys_get</em></a>,
-<a class="reference internal" href="supplements/x2sys/x2sys_list.html"><em>x2sys_list</em></a>,
-<a class="reference internal" href="supplements/x2sys/x2sys_put.html"><em>x2sys_put</em></a>,
-<a class="reference internal" href="supplements/x2sys/x2sys_report.html"><em>x2sys_report</em></a>,
-<a class="reference internal" href="supplements/x2sys/x2sys_solve.html"><em>x2sys_solve</em></a> and
-<a class="reference internal" href="supplements/x2sys/x2sys_merge.html"><em>x2sys_merge</em></a> which extends the
-track-management system employed by the mgg supplement to generic track
-data of any format. This package represents a new generation of tools
-and replaces the old <strong>x_system</strong> package. The package is maintained by
-Paul Wessel.</p>
-</div>
-</div>
-<div class="section" id="b-gmt-file-formats">
-<span id="app-file-formats"></span><h1>15. B. GMT File Formats<a class="headerlink" href="#b-gmt-file-formats" title="Permalink to this headline">¶</a></h1>
-<div class="section" id="table-data">
-<h2>15.1. Table data<a class="headerlink" href="#table-data" title="Permalink to this headline">¶</a></h2>
-<p>These files have <em>N</em> records which have <em>M</em> fields each. All programs
-that handle tables can read multicolumn files. GMT can read both
-ASCII, native binary, and netCDF table data.</p>
-<div class="section" id="ascii-tables">
-<h3>15.1.1. ASCII tables<a class="headerlink" href="#ascii-tables" title="Permalink to this headline">¶</a></h3>
-<div class="section" id="optional-file-header-records">
-<h4>1. Optional file header records<a class="headerlink" href="#optional-file-header-records" title="Permalink to this headline">¶</a></h4>
-<p>The first data record may be preceded by one or more header records. Any
-records that begins with ‘#’ is considered a header or comment line and
-are always processed correctly. If your data file has leading header
-records that do <em>not</em> start with ‘#’ then you must make sure to use the
-<strong>-h</strong> option and set the parameter <a class="reference internal" href="gmt.conf.html#io-n-header-recs"><em>IO_N_HEADER_RECS</em></a> in the <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file
-(GMT default is one header record if <strong>-h</strong> is given; you may also use
-<strong>-h</strong><em>nrecs</em> directly). Fields within a record must be separated by
-spaces, tabs, commas, or semi-colons. Each field can be an integer or floating-point
-number or a geographic coordinate string using the
-[+|-]dd[:mm[:ss]][W:|S|N|E|w|s|n|e]
-format. Thus, 12:30:44.5W, 17.5S, 1:00:05, and 200:45E are all valid
-input strings. GMT is expected to handle most CVS (Comma-Separated Values)
-files, including numbers given in double quotes. On output, fields will be separated by the character
-given by the parameter <a class="reference internal" href="gmt.conf.html#io-col-separator"><em>IO_COL_SEPARATOR</em></a>, which by default is a TAB.</p>
-</div>
-<div class="section" id="optional-segment-header-records">
-<h4>1. Optional segment header records<a class="headerlink" href="#optional-segment-header-records" title="Permalink to this headline">¶</a></h4>
-<p>When dealing with time- or (<em>x,y</em>)-series it is usually convenient to
-have each profile in separate files. However, this may sometimes prove
-impractical due to large numbers of profiles. An example is files of
-digitized lineations where the number of individual features may range
-into the thousands. One file per feature would in this case be
-unreasonable and furthermore clog up the directory. GMT provides a
-mechanism for keeping more than one profile in a file. Such files are
-called <em>multiple segment files</em> and are identical to the ones just
-outlined except that they have segment headers interspersed with data
-records that signal the start of a new segment. The segment headers may
-be of any format, but all must have the same character in the first
-column. The unique character is by default ‘>’, but you can
-override that by modifying the <a class="reference internal" href="gmt.conf.html#io-segment-marker"><em>IO_SEGMENT_MARKER</em></a> default setting.
-Programs can examine the segment headers to see if they contain <strong>-D</strong>
-for a distance value, <strong>-W</strong> and <strong>-G</strong> options for specifying pen and
-fill attributes for individual segments, <strong>-Z</strong> to change color via a
-CPT file, <strong>-L</strong> for label specifications, or <strong>-T</strong> for general-purpose
-text descriptions. These settings (and occasionally others) will
-override the corresponding command line options. GMT also provides for
-two special values for <a class="reference internal" href="gmt.conf.html#io-segment-marker"><em>IO_SEGMENT_MARKER</em></a> that can make
-interoperability with other software packages easier. Choose the marker
-<strong>B</strong> to have blank lines recognized as segment breaks, or use <strong>N</strong> to
-have data records whose fields equal NaN mean segment breaks (e.g., as
-used by Matlab or Octave). When these markers are used then no other
-segment header will be considered. Note that <a class="reference internal" href="gmt.conf.html#io-segment-marker"><em>IO_SEGMENT_MARKER</em></a> can
-be set differently for input and output. Finally, if a segment represents
-a closed polygon that is a hole inside another polygon you indicate this
-with <strong>-Ph</strong>. This setting will be read and processed if converting a
-file to the OGR format.</p>
-</div>
-</div>
-<div class="section" id="binary-tables">
-<h3>15.1.2. Binary tables<a class="headerlink" href="#binary-tables" title="Permalink to this headline">¶</a></h3>
-<p>GMT programs also support native binary tables to speed up
-input-output for i/o-intensive tasks like gridding and preprocessing.
-This is discussed in more detail in section <a class="reference internal" href="#binary-table-i-o-the-b-option">Binary table i/o: The -b option</a>.</p>
-</div>
-<div class="section" id="netcdf-tables">
-<h3>15.1.3. NetCDF tables<a class="headerlink" href="#netcdf-tables" title="Permalink to this headline">¶</a></h3>
-<p>More and more programs are now producing binary data in the netCDF
-format, and so GMT programs started to support tabular netCDF data
-(files containing one or more 1-dimensional arrays) starting with
-GMT version 4.3.0. Because of the meta data contained in those files,
-reading them is much less complex than reading native binary tables, and
-even than ASCII tables. GMT programs will read as many 1-dimensional
-columns as are needed by the program, starting with the first
-1-dimensional it can find in the file. To specifically specify which
-variables are to be read, append the suffix
-<strong>?</strong><em>var1</em><strong>/</strong><em>var2</em><strong>/</strong><em>...</em> to the netCDF file name or
-add the option <strong>-bic</strong><em>var1</em><strong>/</strong><em>var2</em><strong>/</strong><em>...</em>, where
-<em>var1</em>, <em>var2</em>, etc.are the names of the variables to be processed. The
-latter option is particularly practical when more than one file is read:
-the <strong>-bic</strong> option will apply to all files. Currently, GMT only
-reads, but does not write, netCDF tabular data.</p>
-</div>
-</div>
-<div class="section" id="grid-files">
-<h2>15.2. Grid files<a class="headerlink" href="#grid-files" title="Permalink to this headline">¶</a></h2>
-<p>GMT allows numerous grid formats to be read. In addition to the default
-netCDF format it can use binary floating points, short integers, bytes, and
-bits, as well as 8-bit Sun raster files (colormap ignored). Additional
-formats may be used by supplying read/write functions and linking these with
-the GMT libraries. The source file <tt class="docutils literal"><span class="pre">gmt_customio.c</span></tt> has the information
-that programmers will need to augment GMT to read custom grid files. See
-Section <a class="reference internal" href="#grid-file-format-specifications">Grid file format specifications</a> for more information.</p>
-<div class="section" id="netcdf-files">
-<h3>15.2.1. NetCDF files<a class="headerlink" href="#netcdf-files" title="Permalink to this headline">¶</a></h3>
-<p>By default, GMT stores 2-D grids as COARDS-compliant netCDF files.
-COARDS (which stands for Cooperative Ocean/Atmosphere Research Data
-Service) is a convention used by many agencies distributing gridded data
-for ocean and atmosphere research. Sticking to this convention allows
-GMT to read gridded data provided by other institutes and other
-programs. Conversely, other general domain programs will be able to read
-grids created by GMT. COARDS is a subset of a more extensive
-convention for netCDF data called CF-1.5 (Climate and Forecast, version
-1.5). Hence, GMT grids are also automatically CF-1.5-compliant.
-However, since CF-1.5 has more general application than COARDS, not all
-CF-1.5 compliant netCDF files can be read by GMT.</p>
-<p>The netCDF grid file in GMT has several attributes (See Table
-<a class="reference internal" href="#tbl-netcdf-format"><em>netcdf-format</em></a>) to describe the content. The routine
-that deals with netCDF grid files is sufficiently flexible so that grid files
-slightly deviating from the standards used by GMT can also be read.</p>
-<table border="1" class="docutils" id="tbl-netcdf-format">
-<colgroup>
-<col width="24%" />
-<col width="76%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"><strong>Atributte</strong></th>
-<th class="head"><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td> </td>
-<td><em>Global attributes</em></td>
-</tr>
-<tr class="row-odd"><td>Conventions</td>
-<td>COARDS, CF-1.5 (optional)</td>
-</tr>
-<tr class="row-even"><td>title</td>
-<td>Title (optional)</td>
-</tr>
-<tr class="row-odd"><td>source</td>
-<td>How file was created (optional)</td>
-</tr>
-<tr class="row-even"><td>node_offset</td>
-<td>0 for gridline node registration (default),
-1 for pixel registration</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td><em>x- and y-variable attributes</em></td>
-</tr>
-<tr class="row-even"><td>long_name</td>
-<td>Coordinate name (e.g., “Longitude” and “Latitude”)</td>
-</tr>
-<tr class="row-odd"><td>units</td>
-<td>Unit of the coordinate (e.g., “degrees_east” and “degrees_north”)</td>
-</tr>
-<tr class="row-even"><td>actual range
-(or valid range)</td>
-<td>Minimum and maximum <em>x</em> and <em>y</em> of region; if absent the
-first and last <em>x</em>- and <em>y</em>-values are queried</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td><em>z-variable attributes</em></td>
-</tr>
-<tr class="row-even"><td>long_name</td>
-<td>Name of the variable (default: “z”)</td>
-</tr>
-<tr class="row-odd"><td>units</td>
-<td>Unit of the variable</td>
-</tr>
-<tr class="row-even"><td>scale_factor</td>
-<td>Factor to multiply <em>z</em> with (default: 1)</td>
-</tr>
-<tr class="row-odd"><td>add_offset</td>
-<td>Offset to add to scaled <em>z</em> (default: 0)</td>
-</tr>
-<tr class="row-even"><td>actual_range</td>
-<td>Minimum and maximum <em>z</em> (in unpacked units, optional) and <em>z</em></td>
-</tr>
-<tr class="row-odd"><td>_FillValue
-(or missing_value)</td>
-<td>Value associated with missing or invalid data points; if absent an
-appropriate default value is assumed, depending on data type.</td>
-</tr>
-</tbody>
-</table>
-<p>By default, the first 2-dimensional variable in a netCDF file will be read as
-the <em>z</em> variable and the coordinate axes <em>x</em> and <em>y</em> will be determined from
-the dimensions of the <em>z</em> variable. GMT will recognize whether the <em>y</em>
-(latitude) variable increases or decreases. Both forms of data storage are
-handled appropriately.</p>
-<p>For more information on the use of COARDS-compliant netCDF files, and on how
-to load multi-dimensional grids, read Section <a class="reference internal" href="#modifiers-for-coards-compliant-netcdf-files">Modifiers for COARDS-compliant netCDF files</a>.</p>
-</div>
-<div class="section" id="chunking-and-compression-with-netcdf">
-<h3>15.2.2. Chunking and compression with netCDF<a class="headerlink" href="#chunking-and-compression-with-netcdf" title="Permalink to this headline">¶</a></h3>
-<p>GMT supports reading and writing of netCDF-4 files since release 5.0. For
-performance reasons with ever-increasing grid sizes, the default output format
-of GMT is netCDF-4 with chunking enabled for grids with more than 16384 cells.
-Chunking means that the data is not stored sequentially in rows along latitude
-but rather split up into tiles. Figure <a class="reference internal" href="#netcdf-chunking"><em>Grid split into 3 by 3 chunks</em></a> illustrates
-the layout in a chunked netCDF file. To access a subset of the data (e.g.,
-the four blue tiles in the lower left), netCDF only reads those tiles
-(“chunks”) instead of extracting data from long rows.</p>
-<div class="figure align-center" id="netcdf-chunking">
-<img alt="_images/GMT_chunking.png" src="_images/GMT_chunking.png" />
-<p class="caption">Grid split into 3 by 3 chunks</p>
-</div>
-<p>Gridded datasets in the earth sciences usually exhibit a strong spatial
-dependence (e.g. topography, potential fields, illustrated by blue and white
-cells in Figure <a class="reference internal" href="#netcdf-chunking"><em>Grid split into 3 by 3 chunks</em></a>) and deflation can greatly reduce the
-file size and hence the file access time (deflating/inflating is faster than
-hard disk I/O). It is therefore convenient to deflate grids with spatial
-dependence (levels 1–3 give the best speed/size-tradeoff).</p>
-<p>You may control the size of the chunks of data and compression with the
-configuration parameters <a class="reference internal" href="gmt.conf.html#io-nc4-chunk-size"><em>IO_NC4_CHUNK_SIZE</em></a>
-and <a class="reference internal" href="gmt.conf.html#io-nc4-deflation-level"><em>IO_NC 4_DEFLATION_LEVEL</em></a> as specified in
-<a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> and you can check the netCDF format with <a class="reference internal" href="grdinfo.html"><em>grdinfo</em></a>.</p>
-<p>Classic netCDF files were the de facto standard until netCDF 4.0 was released
-in 2008. Most programs supporting netCDF by now are using the netCDF-4
-library and are thus capable of reading netCDF files generated with GMT 5,
-this includes official GMT releases since revision 4.5.8. In rare occasions,
-when you have to load netCDF files with old software, you may be forced to
-export your grids in the old classic format. This can be achieved by setting
-<a class="reference internal" href="gmt.conf.html#io-nc4-chunk-size"><em>IO_NC4_CHUNK_SIZE</em></a> to <strong>c</strong>lassic.</p>
-<p>Further reading:</p>
-<ul class="simple">
-<li><a class="reference external" href="http://www.unidata.ucar.edu/software/netcdf/workshops/most-recent/performance/index.html">Unidata NetCDF Workshop: NetCDF Formats and Performance</a></li>
-<li><a class="reference external" href="http://www.unidata.ucar.edu/software/netcdf/workshops/most-recent/nc4chunking/WhatIsChunking.html">Unidata NetCDF Workshop: What is Chunking?</a></li>
-<li><a class="reference external" href="http://www.hdfgroup.org/pubs/papers/2008-06_netcdf4_perf_report.pdf">HDF NetCDF-4 Performance Report</a></li>
-</ul>
-</div>
-<div class="section" id="gridline-and-pixel-node-registration">
-<h3>15.2.3. Gridline and Pixel node registration<a class="headerlink" href="#gridline-and-pixel-node-registration" title="Permalink to this headline">¶</a></h3>
-<p>Scanline format means that the data are stored in rows (<em>y</em> = constant)
-going from the “top” (<img class="math" src="_images/math/de66977e7eb1a104b8a5f8ae0c626f7e6594f9b8.png" alt="y = y_{max}"/> (north)) to the “bottom”
-(<img class="math" src="_images/math/ef43507b4741e98bc4b61f4db403014529dd469c.png" alt="y = y_{min}"/> (south)). Data within each row are ordered from
-“left” (<img class="math" src="_images/math/6ff3988690ca5f07e1274bbc4e7536fda2a5f555.png" alt="x = x_{min}"/> (west)) to “right” (<img class="math" src="_images/math/5380f0fc713ea8f057cef95a40f671076f4ea764.png" alt="x = x_{max}"/>
-(east)). The <em>registration</em> signals how the nodes are laid out. The grid
-is always defined as the intersections of all
-<em>x</em> ( <img class="math" src="_images/math/0e5f5d1f79ce0963ea633cffc0378758eb49eee4.png" alt="x = x_{min}, x_{min} + x_{inc}, x_{min} + 2 \cdot x_{inc}, \ldots, x_{max}"/> )
-and <em>y</em> ( <img class="math" src="_images/math/8b9fdedc917a22959b26aa1933f3ba330975fa2a.png" alt="y = y_{min}, y_{min} + y_{inc}, y_{min} + 2 \cdot y_{inc}, \ldots, y_{max}"/> )
-lines. The two scenarios differ as to which area each data point
-represents. The default node registration in GMT is gridline node
-registration. Most programs can handle both types, and for some programs
-like <a class="reference internal" href="grdimage.html"><em>grdimage</em></a> a pixel registered file
-makes more sense. Utility programs like
-<a class="reference internal" href="grdsample.html"><em>grdsample</em></a> and
-<a class="reference internal" href="grdproject.html"><em>grdproject</em></a> will allow you to
-convert from one format to the other;
-<a class="reference internal" href="grdedit.html"><em>grdedit</em></a> can make changes to the grid
-header and convert a pixel- to a gridline-registered grid, or <em>vice
-versa</em>. The grid registration is determined by the common GMT <strong>-r</strong>
-option (see Section <a class="reference internal" href="#grid-registration-the-r-option">Grid registration: The -r option</a>).</p>
-</div>
-<div class="section" id="boundary-conditions-for-operations-on-grids">
-<h3>15.2.4. Boundary Conditions for operations on grids<a class="headerlink" href="#boundary-conditions-for-operations-on-grids" title="Permalink to this headline">¶</a></h3>
-<p>GMT has the option to specify boundary conditions in some programs
-that operate on grids (e.g.,
-<a class="reference internal" href="grdsample.html"><em>grdsample</em></a>, <a class="reference internal" href="grdgradient.html"><em>grdgradient</em></a>,
-<a class="reference internal" href="grdtrack.html"><em>grdtrack</em></a>, <a class="reference internal" href="nearneighbor.html"><em>nearneighbor</em></a>, and
-<a class="reference internal" href="grdview.html"><em>grdview</em></a>, to name a few. The desired
-condition can be set with the common GMT option <strong>-n</strong>; see Section
-<a class="reference internal" href="#grid-interpolation-parameters-the-n-option">Grid interpolation parameters: The -n option</a>. The boundary conditions come into play when
-interpolating or computing derivatives near the limits of the region
-covered by the grid. The <em>default</em> boundary conditions used are those
-which are “natural” for the boundary of a minimum curvature
-interpolating surface. If the user knows that the data are periodic in
-<em>x</em> (and/or <em>y</em>), or that the data cover a sphere with <em>x</em>,<em>y</em>
-representing <em>longitude</em>,<em>latitude</em>, then there are better choices for
-the boundary conditions. Periodic conditions on <em>x</em> (and/or <em>y</em>) are
-chosen by specifying <em>x</em> (and/or <em>y</em>) as the boundary condition flags;
-global spherical cases are specified using the <em>g</em> (geographical) flag.
-Behavior of these conditions is as follows:</p>
-<dl class="docutils">
-<dt>Periodic</dt>
-<dd>conditions on <em>x</em> indicate that the data are periodic in the
-distance (<img class="math" src="_images/math/e7dd26bab98d33d93cdd54aa2b75e8622cd88726.png" alt="x_{max} - x_{min}"/>) and thus repeat values after
-every <img class="math" src="_images/math/f89c41c37bb6f9cb2ed3731079e099d908b0cfa0.png" alt="N = (x_{max} - x_{min})/x_{inc}"/>. Note that this
-implies that in a grid-registered file the values in the first and
-last columns are equal, since these are located at
-<img class="math" src="_images/math/6ff3988690ca5f07e1274bbc4e7536fda2a5f555.png" alt="x = x_{min}"/> and <img class="math" src="_images/math/5380f0fc713ea8f057cef95a40f671076f4ea764.png" alt="x = x_{max}"/>, and there are
-<em>N + 1</em> columns in the file. This is not the case in a
-pixel-registered file, where there are only <em>N</em> and the first
-and last columns are located at <img class="math" src="_images/math/bcee6c37dfd1a7a67d3822d10237dc01ce594b3b.png" alt="x_{min} + x_{inc}/2"/> and
-<img class="math" src="_images/math/cce2bc22b994e1fe14f6bc3077fa77b64a0555f0.png" alt="x_{max} - x_{inc}/2"/>. If <em>y</em> is periodic all the same
-holds for <em>y</em>.</dd>
-<dt>Geographical</dt>
-<dd><p class="first">conditions indicate the following:</p>
-<ol class="arabic simple">
-<li>If <img class="math" src="_images/math/afd2a44a547679d529befa08e1e6c4699bf1dcee.png" alt="(x_{max} - x_{min}) \geq 360"/> and also 180 modulo
-<img class="math" src="_images/math/1abe0c9c17f3a82460dc45a38bd48c925c5b396b.png" alt="x_{inc} = 0"/> then a periodic condition is used on
-<em>x</em> with a period of 360; else a default condition is used
-on the <em>x</em> boundaries.</li>
-<li>If condition 1 is true and also <img class="math" src="_images/math/bf648023c5ad7bdbf4d2216ab0c0c735a53cd195.png" alt="y_{max} = 90"/> then a
-“north pole condition” is used at <img class="math" src="_images/math/bc72083139d50ca1c82eff5c34358cbf59681589.png" alt="y_{max}"/>, else a default
-condition is used there.</li>
-<li>If condition 1 is true and also <img class="math" src="_images/math/8cf361aac86ee78b34583ff56fc0ec842389daac.png" alt="y_{min} = -90"/> then a
-“south pole condition” is used at <img class="math" src="_images/math/8a11600e981f11d0873afeb7b6616e7d9bdd8aea.png" alt="y_{min}"/>, else a default
-condition is used there.</li>
-</ol>
-<p class="last">“Pole conditions” use a 180º phase-shift of the data, requiring 180
-modulo <img class="math" src="_images/math/1abe0c9c17f3a82460dc45a38bd48c925c5b396b.png" alt="x_{inc} = 0"/>.</p>
-</dd>
-<dt>Default</dt>
-<dd><p class="first">boundary conditions are</p>
-<div class="math">
-<p><img src="_images/math/35981e0b8a56ea987d1f7b8d208f011536161c25.png" alt="\nabla^2 f = \frac{\partial}{\partial n} \nabla^2 f = 0"/></p>
-</div><p>on the boundary, where <img class="math" src="_images/math/be491eb56d45c1acfd43c8ffd9faf848b245a47f.png" alt="f(x, y)"/> is represented by the values
-in the grid file, and <img class="math" src="_images/math/9b80b6afe46efc8f6defe96b68ff0c1a6992063e.png" alt="\partial/\partial n"/> is the derivative
-in the direction normal to a boundary, and</p>
-<div class="math">
-<p><img src="_images/math/ee7aa56d2b8706d40a5f2a2567ee71d67171d5b3.png" alt="\nabla^2 = \left(\frac{\partial^2}{\partial x^2} + \frac{\partial^2}{\partial y^2}\right)"/></p>
-</div><p class="last">is the two-dimensional Laplacian operator.</p>
-</dd>
-</dl>
-</div>
-<div class="section" id="native-binary-grid-files">
-<h3>15.2.5. Native binary grid files<a class="headerlink" href="#native-binary-grid-files" title="Permalink to this headline">¶</a></h3>
-<p>The old style native grid file format that was common in earlier version
-of GMT is still supported, although the use of netCDF files is
-strongly recommended. The file starts with a header of 892 bytes
-containing a number of attributes defining the content. The
-<a class="reference internal" href="grdedit.html"><em>grdedit</em></a> utility program will allow you
-to edit parts of the header of an existing grid file. The attributes
-listed in Table <a class="reference internal" href="#tbl-grdheader"><em>grdheader</em></a> are contained within the header record
-in the order given (except the <em>z</em>-array which is not part of the
-header structure, but makes up the rest of the file). As this header was
-designed long before 64-bit architectures became available, the jump
-from the first three integers to the subsequent doubles in the structure
-does not occur on a 16-byte alignment. While GMT handles the reading
-of these structures correctly, enterprising programmers must take care
-to read this header correctly (see our code for details).</p>
-<table border="1" class="docutils" id="tbl-grdheader">
-<colgroup>
-<col width="37%" />
-<col width="63%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"><strong>Parameter</strong></th>
-<th class="head"><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td><strong>int</strong> <em>nx</em></td>
-<td>Number of nodes in the <em>x</em>-dimension</td>
-</tr>
-<tr class="row-odd"><td><strong>int</strong> <em>ny</em></td>
-<td>Number of nodes in the <em>y</em>-dimension</td>
-</tr>
-<tr class="row-even"><td><strong>int</strong> <em>registration</em></td>
-<td>0 for grid line registration, 1 for pixel registration</td>
-</tr>
-<tr class="row-odd"><td><strong>double</strong> <em>x_min</em></td>
-<td>Minimum <em>x</em>-value of region</td>
-</tr>
-<tr class="row-even"><td><strong>double</strong> <em>x_max</em></td>
-<td>Maximum <em>x</em>-value of region</td>
-</tr>
-<tr class="row-odd"><td><strong>double</strong> <em>y_min</em></td>
-<td>Minimum <em>y</em>-value of region</td>
-</tr>
-<tr class="row-even"><td><strong>double</strong> <em>y_max</em></td>
-<td>Maximum <em>y</em>-value of region</td>
-</tr>
-<tr class="row-odd"><td><strong>double</strong> <em>z_min</em></td>
-<td>Minimum <em>z</em>-value in data set</td>
-</tr>
-<tr class="row-even"><td><strong>double</strong> <em>z_max</em></td>
-<td>Maximum <em>z</em>-value in data set</td>
-</tr>
-<tr class="row-odd"><td><strong>double</strong> <em>x_inc</em></td>
-<td>Node spacing in <em>x</em>-dimension</td>
-</tr>
-<tr class="row-even"><td><strong>double</strong> <em>y_inc</em></td>
-<td>Node spacing in <em>y</em>-dimension</td>
-</tr>
-<tr class="row-odd"><td><strong>double</strong> <em>z_scale_factor</em></td>
-<td>Factor to multiply <em>z</em>-values after read</td>
-</tr>
-<tr class="row-even"><td><strong>double</strong> <em>z_add_offset</em></td>
-<td>Offset to add to scaled <em>z</em>-values</td>
-</tr>
-<tr class="row-odd"><td><strong>char</strong> <em>x_units</em>[80]</td>
-<td>Units of the <em>x</em>-dimension</td>
-</tr>
-<tr class="row-even"><td><strong>char</strong> <em>y_units</em>[80]</td>
-<td>Units of the <em>y</em>-dimension</td>
-</tr>
-<tr class="row-odd"><td><strong>char</strong> <em>z_units</em>[80]</td>
-<td>Units of the <em>z</em>-dimension</td>
-</tr>
-<tr class="row-even"><td><strong>char</strong> <em>title</em>[80]</td>
-<td>Descriptive title of the data set</td>
-</tr>
-<tr class="row-odd"><td><strong>char</strong> <em>command</em>[320]</td>
-<td>Command line that produced the grid file</td>
-</tr>
-<tr class="row-even"><td><strong>char</strong> <em>remark</em>[160]</td>
-<td>Any additional comments</td>
-</tr>
-<tr class="row-odd"><td><strong>TYPE</strong> <em>z</em>[nx*ny]</td>
-<td>1-D array with <em>z</em>-values in scanline format</td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="section" id="sun-raster-files">
-<h2>15.3. Sun raster files<a class="headerlink" href="#sun-raster-files" title="Permalink to this headline">¶</a></h2>
-<p>The Sun raster file format consists of a header followed by a series of
-unsigned 1-byte integers that represents the bit-pattern. Bits are
-scanline oriented, and each row must contain an even number of bytes.
-The predefined 1-bit patterns in GMT have dimensions of 64 by 64, but
-other sizes will be accepted when using the <strong>-Gp|P</strong> option. The Sun
-header structure is outline in Table <a class="reference internal" href="#tbl-sunheader"><em>sunheader</em></a>.</p>
-<table border="1" class="docutils" id="tbl-sunheader">
-<colgroup>
-<col width="42%" />
-<col width="58%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"><strong>Parameter</strong></th>
-<th class="head"><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td><strong>int</strong> <em>ras_magic</em></td>
-<td>Magic number</td>
-</tr>
-<tr class="row-odd"><td><strong>int</strong> <em>ras_width</em></td>
-<td>Width (pixels) of image</td>
-</tr>
-<tr class="row-even"><td><strong>int</strong> <em>ras_height</em></td>
-<td>Height (pixels) of image</td>
-</tr>
-<tr class="row-odd"><td><strong>int</strong> <em>ras_depth</em></td>
-<td>Depth (1, 8, 24, 32 bits) of pixel</td>
-</tr>
-<tr class="row-even"><td><strong>int</strong> <em>ras_length</em></td>
-<td>Length (bytes) of image</td>
-</tr>
-<tr class="row-odd"><td><strong>int</strong> <em>ras_type</em></td>
-<td>Type of file; see RT_ below</td>
-</tr>
-<tr class="row-even"><td><strong>int</strong> <em>ras_maptype</em></td>
-<td>Type of colormap; see RMT_ below</td>
-</tr>
-<tr class="row-odd"><td><strong>int</strong> <em>ras_maplength</em></td>
-<td>Length (bytes) of following map</td>
-</tr>
-</tbody>
-</table>
-<p>After the header, the color map (if <em>ras_maptype</em> is not RMT_NONE)
-follows for <em>ras_maplength</em> bytes, followed by an image of
-<em>ras_length</em> bytes. Some related definitions are given in
-Table <a class="reference internal" href="#tbl-sundef"><em>sundef</em></a>.</p>
-<table border="1" class="docutils" id="tbl-sundef">
-<colgroup>
-<col width="33%" />
-<col width="67%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"><strong>Macro name</strong></th>
-<th class="head"><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>RAS_MAGIC</td>
-<td>0x59a66a95</td>
-</tr>
-<tr class="row-odd"><td>RT_STANDARD</td>
-<td>1 (Raw pixrect image in 68000 byte order)</td>
-</tr>
-<tr class="row-even"><td>RT_BYTE_ENCODED</td>
-<td>2 (Run-length compression of bytes)</td>
-</tr>
-<tr class="row-odd"><td>RT_FORMAT_RGB</td>
-<td>3 ([X]RGB instead of [X]BGR)</td>
-</tr>
-<tr class="row-even"><td>RMT_NONE</td>
-<td>0 (ras_maplength is expected to be 0)</td>
-</tr>
-<tr class="row-odd"><td>RMT_EQUAL_RGB</td>
-<td>1 (red[ras_maplength/3],green[],blue[])</td>
-</tr>
-</tbody>
-</table>
-<p>Numerous public-domain programs exist, such as <strong>xv</strong> and
-<strong>convert</strong> (in the GraphicsMagick or ImageMagick package), that will translate between
-various raster file formats such as tiff, gif, jpeg, and Sun raster.
-Raster patterns may be created with GMT plotting tools by generating
-PostScript plots that can be rasterized by ghostscript and
-translated into the right raster format.</p>
-</div>
-</div>
-<div class="section" id="c-including-gmt-graphics-into-your-documents">
-<span id="include-gmt-graphics"></span><h1>16. C. Including GMT Graphics into your Documents<a class="headerlink" href="#c-including-gmt-graphics-into-your-documents" title="Permalink to this headline">¶</a></h1>
-<p>Now that you made some nice graphics with GMT, it is time to add them
-to a document, an article, a report, your dissertation, a poster, a web
-page, or a presentation. Of course, you could try the old-fashioned
-scissors and glue stick. More likely, you want to incorporate your
-graphics electronically into the document. Depending on the application,
-the GMT PostScript file will need to be converted to Encapsulated
-PostScript (EPS), Portable Document Format (PDF), or some raster
-format (e.g., JPEG, PNG, or TIFF) in order to incorporate them into the
-document.</p>
-<ul class="simple">
-<li>When creating a document intended for printing (article,
-dissertation, or poster) it is best to preserve the scalable vector
-characteristics of the PostScript file. Many applications can
-directly incorporate PostScript in the form of EPS files. Modern
-programs will often allow the inclusion of PDF files. Either way, the
-sharpness of lines and fonts will be preserved and can be scaled up
-or down as required.</li>
-<li>When the aim is to display the graphics on a computer screen or
-present it using a projector, it is wise to convert the
-PostScript into a raster format. Although applications like
-PowerPoint can do this for you, you can best take the
-conversion into your own hands for the best results.</li>
-</ul>
-<p>A large number of questions to the GMT-Help mailing list are related to
-these rendering issues, showing that something as seemingly
-straightforward as incorporating a PostScript file into a document is
-a far from trivial exercise. This Appendix will show how to include
-GMT graphics into documents and how to achieve the best quality results.</p>
-<div class="section" id="making-gmt-encapsulated-postscript-files">
-<h2>16.1. Making GMT Encapsulated PostScript Files<a class="headerlink" href="#making-gmt-encapsulated-postscript-files" title="Permalink to this headline">¶</a></h2>
-<p>GMT produces freeform PostScript files. Note that a freeform
-PostScript file may contain special operators (such as
-<tt class="docutils literal"><span class="pre">Setpagedevice</span></tt>) that is specific to printers (e.g., selection of
-paper tray). Some previewers (among them, Sun’s pageview) may not
-understand these valid instructions and may fail to image the file.
-Also, embedding freeform PostScript with such instructions in it into
-a larger document can cause printing to fail. While you could choose
-another viewer (we recommend <strong>ghostview</strong>) to view single plots
-prepared by GMT, it is generally wiser to convert PostScript to EPS
-output when you are creating a plot intended for inclusion into a larger
-document. Some programs (and some publishers as well) do not allow the
-use of instructions like <tt class="docutils literal"><span class="pre">Setpagedevice</span></tt> as part of embedded graphics.</p>
-<p>An EPS file that is to be placed into another document needs to have
-correct bounding box parameters. These are found in the
-PostScript Document Comment %%BoundingBox. Applications that generate
-EPS files should set these parameters correctly. Because GMTmakes
-the PostScript files on the fly, often with several overlays, it is
-not possible to do so accurately. Therefore, if you need and EPS version
-with a “tight” BoundingBox you need to post-process your
-PostScript file. There are several ways in which this can be
-accomplished.</p>
-<ul>
-<li><p class="first">Programs such as Adobe Illustrator, Aldus Freehand, and
-Corel Draw will allow you to edit the BoundingBox graphically.</p>
-</li>
-<li><p class="first">A command-line alternative is to use freely-available program
-<strong>epstool</strong> from the makers of Aladdin ghostscript. Running</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>epstool -c -b myplot.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>should give a tight BoundingBox; <strong>epstool</strong> assumes the plot is
-page size and not a huge poster.</p>
-</li>
-<li><p class="first">Another option is to use <strong>ps2epsi</strong> which also comes with the
-ghostscript package. Running</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>ps2epsi myplot.ps myplot.eps
-</pre></div>
-</div>
-</div></blockquote>
-<p>should also do the trick. The downside is that this program adds an
-“image” of the plot in the preamble of the EPS file, thus increasing
-the file size significantly. This image is a rough rendering of your
-PostScript graphics that some programs will show on screen while
-you are editing your document. This image is basically a placeholder
-for the PostScript graphics that will actually be printed.</p>
-</li>
-<li><p class="first">However, the preferred option is to use the GMT utility
-<a class="reference internal" href="ps2raster.html"><em>ps2raster</em></a>. Its <strong>-A</strong> option will
-figure out the tightest BoundingBox, again using ghostscript in
-the background. For example, running</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>ps2raster -A -Te myplot.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>will convert the PostScript file <tt class="docutils literal"><span class="pre">myplot.ps</span></tt> into an encapsulated
-PostScript file <tt class="docutils literal"><span class="pre">myplot.eps</span></tt> which is exactly cropped to the tightest possible
-BoundingBox.</p>
-</li>
-</ul>
-<p>If you do not want to modify your illustration but just include it in a
-text document: many word processors (such as Microsoft Word or Apple Pages) will let you include a
-PostScript file that you may place but not edit. Newer versions of
-those programs also allow you to include PDF versions of your graphics.
-Except for Pages, you will not be able to view the figure
-on-screen, but it will print correctly.</p>
-</div>
-<div class="section" id="converting-gmt-postscript-to-pdf-or-raster-images">
-<h2>16.2. Converting GMT PostScript to PDF or raster images<a class="headerlink" href="#converting-gmt-postscript-to-pdf-or-raster-images" title="Permalink to this headline">¶</a></h2>
-<p>Since Adobe’s PDF (Portable Document Format) seems to have become the
-<em>de facto</em> standard for vector graphics, you are often well off
-converting GMT produced PostScript files to PDF. Being both vector
-formats (i.e., they basically describe all objects, text and graphics as
-lines and curves), such conversion sounds awfully straightforward and
-not worth a full section in this document. But experience has shown
-differently, since most converters cut corners by using the same tool
-(Aladdin’s ghostscript) with basic default options that are not
-devised to produce the best quality PDF files.</p>
-<p>For some applications it is practical or even essential that you convert
-your PostScript file into a raster format, such as GIF (Graphics
-Interchange Format), TIFF (Tagged Image File Format), PNG (Portable
-Network Graphics), or JPEG (Joint Photographic Experts Group). A web
-page is better served with a raster image that will immediately show on
-a web browser, than with a PostScript file that needs to be downloaded
-to view, despite the better printing quality of the PostScript image.
-A less obvious reason to convert your image to a raster format is to
-by-pass PowerPoint’s rendering engine in case you want to embed
-the image into a presentation.</p>
-<p>The are a number of programs that will convert PostScript files to PDF
-or raster formats, like Aladdin’s <strong>pstopdf</strong>, pbmplus’ <strong>pstoimg</strong>,
-or GraphicsMagick’s and ImageMagick’s <strong>convert</strong>, most of which run ghostscript
-behind the scenes. The same is true for viewers like <strong>ghostview</strong> and
-Apple’s Preview*. So a lot of the times when people report that
-their PostScript plot does not look right but prints fine, it is the
-way ghostscript is used with its most basic settings that is to blame.</p>
-<div class="section" id="when-converting-or-viewing-postscript-goes-awry">
-<h3>16.2.1. When converting or viewing PostScript goes awry<a class="headerlink" href="#when-converting-or-viewing-postscript-goes-awry" title="Permalink to this headline">¶</a></h3>
-<p>Here are some notorious pitfalls with ghostscript (and other
-rendering programs for that matter).</p>
-<dl class="docutils">
-<dt>Rendering.</dt>
-<dd>When you are converting to a raster format, make sure you use a high
-enough resolution so that the pixels do not show when it is enlarged
-onto a screen or using a projector. The right choice of resolution
-depends on the application, but do not feel limited to the default
-72 dpi (dots-per-inch) that is offered by most converters.</dd>
-<dt>Image compression.</dt>
-<dd>There are <em>lossy</em> and <em>non-lossy</em> compressions. A compression
-algorithm is called “lossy” when information is lost in the
-conversion: there is no way back to get the full original. The
-effect can be seen when there are sharp color transitions in your
-image: the edges will get blurry in order to allow a more efficient
-compression. JPEG uses a lossy compression, PNG is non-lossy, and
-TIFF generally does not use compression at all. We therefore
-recommend you convert to PNG if you need to rasterize your plot, and
-leave JPEG to photographs.</dd>
-<dt>Embedded image compression.</dt>
-<dd>When your GMT plot includes objects produced by
-<a class="reference internal" href="grdimage.html"><em>grdimage</em></a>, <a class="reference internal" href="psimage.html"><em>psimage</em></a> or
-<a class="reference internal" href="pslegend.html"><em>pslegend</em></a>, they are seen as
-“images”. The default options of ghostscript will use a
-<em>lossy</em> compression (similar to JPEG) on those images when
-converting them to PDF objects. This can be avoided, however, by
-inhibiting the compression altogether, or using the non-lossy
-<em>flate</em> compression, similar to the one used in the old
-<strong>compress</strong> program. This compression is fully reversible, so
-that your image does not suffer any loss.</dd>
-<dt>Auto-rotation.</dt>
-<dd>The ghostscript engine has the annoying habit to automatically
-rotate an image produced with portrait orientation (using the <strong>-P</strong>
-option) so that the height is always larger than the width. So if
-you have an image that was printed in portrait mode but happens to
-have a width larger than height (for example a global map), it would
-suddenly get rotated. Again, this function needs to be switched off.
-Apple’s Preview uses the ghostscript engine and suffers
-from the same annoying habit. Oddly enough, ghostscript does
-not force landscape plots to be “horizontal”.</dd>
-<dt>Anti-aliasing.</dt>
-<dd><p class="first">This is not something to worry about when converting to PDF, but
-certainly when producing raster images (discussed below).
-<em>Anti-aliasing</em> in this context means that the rendering tries to
-avoid <em>aliasing</em>, for example, sampling only the blacks in a
-black-and-white hachure. It does so by first oversampling the image
-and then using “gray-shades” when a target pixel is only partially
-white or black.</p>
-<p>Clearly, this can lead to some unwanted results. First, all edges
-and lines get blurry and second, the assumption of a white
-background causes the gray shades to stand out when transferring the
-image to background with a different color (like the popular
-sleep-inducing blue in PowerPoint presentations). A more
-surprising effect of anti-aliasing is that the seams between tiles
-that make up the land mask when using
-<a class="reference internal" href="pscoast.html"><em>pscoast</em></a> will become visible. The
-anti-aliasing somehow decides to blur the edges of all polygons,
-even when they are seamlessly connected to other polygons.</p>
-<p class="last">It is therefore wise to overrule the default anti-aliasing option
-and over-sample the image yourself by choosing a higher resolution.</p>
-</dd>
-<dt>Including fonts.</dt>
-<dd>When you are producing print-ready copy to publishers, they will
-often (and justifiably) ask that you include all fonts in your PDF
-document. Again, ghostscript (and all converters relying on
-that engine) will not do so by default.</dd>
-</dl>
-</div>
-<div class="section" id="using-ps2raster">
-<h3>16.2.2. Using <a class="reference internal" href="ps2raster.html"><em>ps2raster</em></a><a class="headerlink" href="#using-ps2raster" title="Permalink to this headline">¶</a></h3>
-<p>The remedy to all the problems mentioned in the previous section is
-readily available to you in the form of the GMT utility
-<a class="reference internal" href="ps2raster.html"><em>ps2raster</em></a>. It is designed to provide
-the best quality PDF and raster files using ghostscript as a
-rendering engine. The program <a class="reference internal" href="ps2raster.html"><em>ps2raster</em></a> avoids anti-aliasing and
-lossy compression techniques that are default to ghostscript and
-includes the fonts into the resulting PDF file to ensure portability. By
-default the fonts are rendered at 720 dots-per-inch in a PDF file and
-images are sampled to 300 dpi, but that can be changed with the <strong>-E</strong>
-option. Simply run</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt ps2raster -A -P -Tf *.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>to convert all PostScript files to PDF while cropping it to the
-smallest possible BoundingBox. Or use the <strong>-Tg</strong> option to convert your
-files to PNG.</p>
-<p>The <strong>-P</strong> option of <a class="reference internal" href="ps2raster.html"><em>ps2raster</em></a> may
-also come in handy. When you have <em>not</em> supplied the <strong>-P</strong> option in
-your first GMT plot command, your plot will be in Landscape mode. That
-means that the plot will be rotated 90º (anti-clockwise) to fit
-on a Portrait mode page when coming out of the printer. The <strong>-P</strong>
-option of <a class="reference internal" href="ps2raster.html"><em>ps2raster</em></a> will undo that
-rotation, so that you do not have to do so within your document. This
-will only affect Landscape plots; Portrait plots will not be rotated.</p>
-</div>
-</div>
-<div class="section" id="examples">
-<h2>16.3. Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="gmt-graphics-in-latex">
-<h3>16.3.1. GMT graphics in LaTeX<a class="headerlink" href="#gmt-graphics-in-latex" title="Permalink to this headline">¶</a></h3>
-<p>Nearly all illustrations in this GMT documentation were GMT-produced
-PostScript files. They were converted to PDF files using
-<a class="reference internal" href="ps2raster.html"><em>ps2raster</em></a> and then included into a
-LaTeX document that was processed with <strong>pdflatex</strong> to create the PDF
-document you are reading.</p>
-<p>To add the graphics into the LaTeX document we use the
-<tt class="docutils literal"><span class="pre">\includegraphics</span></tt> command supplied by the package. In the preamble of
-your LaTeX document you will need to include the line</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre><span class="se">\u</span>sepackage<span class="o">{</span>graphicx<span class="o">}</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>The inclusion of the graphics will probably be inside a floating figure
-environment; something like this</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre><span class="se">\b</span>egin<span class="o">{</span>figure<span class="o">}</span>
- <span class="se">\i</span>ncludegraphics<span class="o">{</span>myplot<span class="o">}</span>
- <span class="se">\c</span>aption<span class="o">{</span>This is my first plot in <span class="se">\L</span>aTeX.<span class="o">}</span>
- <span class="se">\l</span>abel<span class="o">{</span>fig:myplot<span class="o">}</span>
-<span class="se">\e</span>nd<span class="o">{</span>figure<span class="o">}</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>Note that the <tt class="docutils literal"><span class="pre">\includegraphics</span></tt> command does not require you to add
-the suffix <tt class="docutils literal"><span class="pre">.pdf</span></tt> to the file name. If you run <strong>pdflatex</strong>, it will
-look automatically for <tt class="docutils literal"><span class="pre">myplot.pdf</span></tt>. If you run <strong>latex</strong>, it will use <tt class="docutils literal"><span class="pre">myplot.eps</span></tt> instead.</p>
-<p>You can scale your plot using the options <tt class="docutils literal"><span class="pre">width=</span></tt>, <tt class="docutils literal"><span class="pre">height=</span></tt>, or
-<tt class="docutils literal"><span class="pre">scale=</span></tt>. In addition, if your original graphics was produced in
-Landscape mode (i.e., you did <em>not</em> use GMT’s <strong>-P</strong> option: not
-while plotting, nor in <a class="reference internal" href="ps2raster.html"><em>ps2raster</em></a>),
-you will need to rotate the plot as well. For example,</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre><span class="se">\i</span>ncludegraphics<span class="o">[</span><span class="nv">angle</span><span class="o">=</span>-90,width<span class="o">=</span>0.8<span class="se">\t</span>extwidth<span class="o">]{</span>myplot<span class="o">}</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>will rotate the image 90º clockwise and scale it such that its width
-(after rotation) will be 80% of the width of the text column.</p>
-</div>
-<div class="section" id="gmt-graphics-in-powerpoint">
-<h3>16.3.2. GMT graphics in <strong>PowerPoint</strong><a class="headerlink" href="#gmt-graphics-in-powerpoint" title="Permalink to this headline">¶</a></h3>
-<div class="figure align-center" id="rendering">
-<a class="reference internal image-reference" href="_images/rendering.png"><img alt="_images/rendering.png" src="_images/rendering.png" style="width: 360.0px; height: 270.0px;" /></a>
-<p class="caption">Examples of rendered images in a PowerPoint presentation</p>
-</div>
-<div class="figure align-center" id="powerpoint-dialogue">
-<a class="reference internal image-reference" href="_images/formatpicture.png"><img alt="_images/formatpicture.png" src="_images/formatpicture.png" style="width: 272.5px; height: 258.0px;" /></a>
-<p class="caption">PowerPoint’s Format Picture dialogue to set scale and rotation.</p>
-</div>
-<p>In Figure <a class="reference internal" href="#rendering"><em>Rendered images</em></a> we have attempted to include
-Figure <a class="reference internal" href="#fig-example-20"><em>Example 20</em></a> into a PowerPoint presentation.
-First the PostScript file was converted to PDF (using
-<a class="reference internal" href="ps2raster.html"><em>ps2raster</em></a>), then loaded into
-PowerPoint and the white background color was made transparent
-using the formatting toolbar (shown on the left side of
-Figure <a class="reference internal" href="#rendering"><em>Rendered images</em></a>). Clearly, when we let PowerPoint
-do the rendering, we do not get the best result:</p>
-<ul class="simple">
-<li>The anti-aliasing causes the tiles that make up the land to stand
-out. This is because the anti-aliasing algorithm blurs all edges,
-even when the tiles join seamlessly.</li>
-<li>The background color was assumed to be white, hence the text is
-“smoothed” using gray shades. Instead, shades of blue which would be
-appropriate for the background we are using.</li>
-</ul>
-<p>On the central column of Figure <a class="reference internal" href="#rendering"><em>Rendered images</em></a> we have
-included PNG
-versions of a portion of the same example. This shows the workings of
-anti-aliasing and different resolutions. All samples were obtained with
-<strong>convert</strong>. The one on the top uses all default settings, resulting
-in an anti-aliased image at 72 dpi resolution (very much like the PDF
-included directly into PowerPoint).</p>
-<p>Just switching anti-aliasing off (middle) is clearly not an option
-either. It is true that we got rid of the gray blurring and the seams
-between the tiles, but without anti-aliasing the image becomes very
-blocky. The solution is to render the image at a higher resolution
-(e.g., 300 dpi) without anti-aliasing and then shrink the image to the
-appropriate size (bottom of the central column in
-Figure <a class="reference internal" href="#rendering"><em>Rendered images</em></a>). The scaling, rotation as well as
-the selection
-of the transparent color can be accomplished through the “Formatting”
-tool bar and the “Format Picture” dialogue box of PowerPoint
-(Figure <a class="reference internal" href="#powerpoint-dialogue"><em>PowerPoint dialogue box</em></a>), which can be
-found by double clicking the
-included image (or selecting and right-clicking or control-clicking on a
-one-button mouse).</p>
-</div>
-</div>
-<div class="section" id="concluding-remarks">
-<h2>16.4. Concluding remarks<a class="headerlink" href="#concluding-remarks" title="Permalink to this headline">¶</a></h2>
-<p>These examples do not constitute endorsements of the products mentioned
-above; they only represent our limited experience with adding
-PostScript to various types of documents. For other solutions and
-further help, please post messages to.</p>
-</div>
-</div>
-<div class="section" id="e-predefined-bit-and-hachure-patterns-in-gmt">
-<h1>17. E. Predefined Bit and Hachure Patterns in GMT<a class="headerlink" href="#e-predefined-bit-and-hachure-patterns-in-gmt" title="Permalink to this headline">¶</a></h1>
-<p>GMT provides 90 different bit and hachure patterns that can be
-selected with the <strong>-Gp</strong> or <strong>-GP</strong> option in most plotting programs.
-The left side of each image was created using <strong>-Gp</strong>, the right side
-shows the inverted version using <strong>-GP</strong>. These patterns are reproduced
-below at 300 dpi using the default black and white shades.</p>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_App_E.png"><img alt="_images/GMT_App_E.png" src="_images/GMT_App_E.png" style="width: 500px;" /></a>
-</div>
-</div>
-<div class="section" id="f-chart-of-octal-codes-for-characters">
-<h1>18. F. Chart of Octal Codes for Characters<a class="headerlink" href="#f-chart-of-octal-codes-for-characters" title="Permalink to this headline">¶</a></h1>
-<p>The characters and their octal codes in the Standard and ISOLatin1
-encoded fonts are shown in
-Figure <a class="reference internal" href="#octal-codes-stand-iso"><em>Octal codes for Standard and ISO</em></a>. Light red areas signify
-codes reserved for control characters. In order to use all the extended
-characters (shown in the light green boxes) you need to set
-<a class="reference internal" href="gmt.conf.html#ps-char-encoding"><em>PS_CHAR_ENCODING</em></a> to Standard+ or ISOLatin1+ in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file <a class="footnote-reference" href="#id80" id="id36">[32]</a>.</p>
-<div class="figure align-center" id="octal-codes-stand-iso">
-<a class="reference internal image-reference" href="_images/GMT_App_F_stand+_iso+.png"><img alt="_images/GMT_App_F_stand+_iso+.png" src="_images/GMT_App_F_stand+_iso+.png" style="width: 500px;" /></a>
-<p class="caption">Octal codes and corresponding symbols for StandardEncoding (left) and ISOLatin1Encoding (right) fonts.</p>
-</div>
-<p>The chart for the Symbol character set (GMT font number 12) and Pifont
-ZapfDingbats character set (font number 34) are presented in
-Figure <a class="reference internal" href="#octal-codes-symbol-zap"><em>Octal codes for Symbol and ZapfDingbats</em></a> below. The octal code
-is obtained by appending the column value to the \??
-value, e.g., <img class="math" src="_images/math/0b38ec67684d250b4d0315f2c34f103be8e3e411.png" alt="\partial"/> is \266 in the Symbol
-font. The euro currency symbol is \240 in the Symbol
-font and will print if your printer supports it (older printer’s
-firmware will not know about the euro).</p>
-<div class="figure align-center" id="octal-codes-symbol-zap">
-<a class="reference internal image-reference" href="_images/GMT_App_F_symbol_dingbats.png"><img alt="_images/GMT_App_F_symbol_dingbats.png" src="_images/GMT_App_F_symbol_dingbats.png" style="width: 500px;" /></a>
-<p class="caption">Octal codes and corresponding symbols for Symbol (left) and ZapfDingbats (right) fonts.</p>
-</div>
-</div>
-<div class="section" id="g-postscript-fonts-used-by-gmt">
-<h1>19. G. PostScript Fonts Used by GMT<a class="headerlink" href="#g-postscript-fonts-used-by-gmt" title="Permalink to this headline">¶</a></h1>
-<p>GMT uses the standard 35 fonts that come with most
-PostScript laserwriters. If your printer does not support some of
-these fonts, it will automatically substitute the default font (which is
-usually Courier). The following is a list of the GMT fonts:</p>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_App_G.png"><img alt="_images/GMT_App_G.png" src="_images/GMT_App_G.png" style="width: 500px;" /></a>
-<p class="caption">The standard 35 PostScript fonts recognized by GMT.</p>
-</div>
-<p>For the special fonts Symbol (12) and ZapfDingbats (34), see the octal
-charts in Appendix [app:F]. When specifying fonts in GMT, you can
-either give the entire font name <em>or</em> just the font number listed in
-this table. To change the fonts used in plotting basemap frames, see the
-man page for <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>. For direct
-plotting of text-strings, see the man page for <a class="reference internal" href="pstext.html"><em>pstext</em></a>.</p>
-<div class="section" id="using-non-default-fonts-with-gmt">
-<h2>19.1. Using non-default fonts with GMT<a class="headerlink" href="#using-non-default-fonts-with-gmt" title="Permalink to this headline">¶</a></h2>
-<p>To add additional fonts that you may have purchased or that are
-available freely in the internet or at your institution, see the
-instructions in the <tt class="docutils literal"><span class="pre">CUSTOM_font_info.d</span></tt> under the <tt class="docutils literal"><span class="pre">share/pslib</span></tt> directory and continue reading. GMT does
-not read or process any font files and thus does not know anything about
-installed fonts and their metrics. In order to use extra fonts in
-GMT you need to specify the PostScript name of the relevant fonts in
-the file <tt class="docutils literal"><span class="pre">CUSTOM_font_info.d</span></tt>. You can either edit the existing file distributed with
-GMT to make the changes global or you can create a new file in the
-current working directory, e.g.,</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>LinBiolinumO 0.700 0
-LinLibertineOB 0.700 0
-</pre></div>
-</div>
-</div></blockquote>
-<p>The format is a space delimited list of the PostScript font name, the
-font height-point size-ratio, and a boolean variable that tells GMT to
-re-encode the font (if set to zero). The latter has to be set to zero as
-additional fonts will most likely not come in standard
-PostScript encoding. GMT determines how tall typical annotations
-might be from the font size ratio so that the vertical position of
-labels and titles can be adjusted to a more uniform typesetting. Now,
-you can set the GMT font parameters to your non-standard fonts:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt <span class="nb">set </span>FONT LinBiolinumO <span class="se">\</span>
- FONT_TITLE 28p,LinLibertineOB <span class="se">\</span>
- PS_CHAR_ENCODING ISO-8859-1 <span class="se">\</span>
- MAP_DEGREE_SYMBOL degree
-</pre></div>
-</div>
-</div></blockquote>
-<p>After setting the encoding and the degree symbol, the configuration part
-for GMT is finished and you can proceed to create GMT-maps as usual.
-An example script is discussed in Example [sec:non-default-fonts-example].</p>
-<div class="section" id="embedding-fonts-in-postscript-and-pdf">
-<h3>19.1.1. Embedding fonts in PostScript and PDF<a class="headerlink" href="#embedding-fonts-in-postscript-and-pdf" title="Permalink to this headline">¶</a></h3>
-<p>If you have Type 1 fonts in PFA (Printer Font ASCII) format you can
-embed them directly by copying them at the very top of your
-PostScript-file, before even the %!PS header comment. PFB (Printer
-Font Binary), TrueType or OpenType fonts cannot be embedded in
-PostScript directly and therefore have to be converted to PFA first.</p>
-<p>However, you most likely will have to tell Ghostscript where to
-find your custom fonts in order to convert your GMT-PostScript-plot
-to PDF or an image with <a class="reference internal" href="ps2raster.html"><em>ps2raster</em></a>.
-When you have used the correct PostScript-names of the fonts in <tt class="docutils literal"><span class="pre">CUSTOM_font_info.d</span></tt> you
-only need to point the <tt class="docutils literal"><span class="pre">GS_FONTPATH</span></tt> environment variable to the
-directory where the font files can be found and invoke
-<a class="reference internal" href="ps2raster.html"><em>ps2raster</em></a> in the usual way. Likewise
-you can specify Ghostscript’s <tt class="docutils literal"><span class="pre">-sFONTPATH</span></tt> option on the
-command line with <tt class="docutils literal"><span class="pre">C</span> <span class="pre">-sFONTPATH=/path/to/fontdir</span></tt>. Ghostscript,
-which is invoked by <a class="reference internal" href="ps2raster.html"><em>ps2raster</em></a>, does
-not depend on file names. It will automatically find the relevant font
-files by their PostScript-names and embed and subset them in
-PDF-files. This is quite convenient as the document can be displayed and
-printed even on other computers when the font is not available locally.
-There is no need to convert your fonts as Ghostscript can handle
-all Type 1, TrueType and OpenType fonts. Note also, that you do not need
-to edit Ghostscript’s Fontmap.</p>
-<p>If you do not want or cannot embed the fonts you can convert them to
-outlines (shapes with fills) with Ghostscript in the following
-way:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gs -q -dNOCACHE -dSAFER -dNOPAUSE -dBATCH -dNOPLATFONTS <span class="se">\</span>
- -sDEVICE<span class="o">=</span>pswrite -sFONTPATH<span class="o">=</span><span class="s2">"/path/to/fontdir"</span> <span class="se">\</span>
- -sOutputFile<span class="o">=</span>mapWithOutlinedFonts.ps map.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>Note, that this only works with the <em>pswrite</em> device. If you need
-outlined fonts in PDF, create the PDF from the converted
-PostScript-file. Also, <a class="reference internal" href="ps2raster.html"><em>ps2raster</em></a>
-cannot correctly crop Ghostscript converted PostScript-files
-anymore. Use Heiko Oberdiek’s instead or crop with
-<a class="reference internal" href="ps2raster.html"><em>ps2raster</em></a> <strong>-A</strong> <strong>-Te</strong> before (See
-Example [sec:non-default-fonts-example]).</p>
-</div>
-<div class="section" id="character-encoding">
-<h3>19.1.2. Character encoding<a class="headerlink" href="#character-encoding" title="Permalink to this headline">¶</a></h3>
-<p>Since PostScript itself does not support Unicode fonts,
-Ghostscript will re-encode the fonts on the fly. You have to make
-sure to set the correct <a class="reference internal" href="gmt.conf.html#ps-char-encoding"><em>PS_CHAR_ENCODING</em></a>
-with <a class="reference internal" href="gmtset.html"><em>gmtset</em></a> and save your
-script file with the same character encoding. Alternatively, you can
-substitute all non ASCII characters with their corresponding octal
-codes, e.g., \265 instead of μ. Note, that PostScript fonts support
-only a small range of glyphs and you may have to switch the
-<a class="reference internal" href="gmt.conf.html#ps-char-encoding"><em>PS_CHAR_ENCODING</em></a> within your script.</p>
-</div>
-</div>
-</div>
-<div class="section" id="h-color-space-the-final-frontier">
-<h1>20. H. Color Space: The Final Frontier<a class="headerlink" href="#h-color-space-the-final-frontier" title="Permalink to this headline">¶</a></h1>
-<p>In this Appendix, we are going to try to explain the relationship
-between the RGB, CMYK, and HSV color systems so as to (hopefully) make
-them more intuitive. GMT allows users to specify colors in CPT files
-in either of these three systems. Interpolation between colors is
-performed in either RGB or HSV, depending on the specification in the
-CPT file. Below, we will explain why this all matters.</p>
-<div class="section" id="rgb-color-system">
-<h2>20.1. RGB color system<a class="headerlink" href="#rgb-color-system" title="Permalink to this headline">¶</a></h2>
-<p>Remember your (parents’) first color television set? Likely it had three
-little bright colored squares on it: red, green, and blue. And that is
-exactly what each color on the tube is made of: varying levels of red,
-green and blue light. Switch all of them off, <em>r=g=b=0</em>, then you
-have black. All of them at maximum, <em>r=g=b=255</em>, creates white.
-Your computer screen works the same way.</p>
-<p>A mix of levels of red, green, and blue creates basically any color
-imaginable. In GMT each color can be represented by the triplet
-<em>r7g7b</em>. For example, 127/255/0 (half red, full
-green, and no blue) creates a color called chartreuse. The color sliders
-in the graphics program GIMP are an excellent way to experiment
-with colors, since they show you in advance how moving one of the color
-sliders will change the color. As Figure <a class="reference internal" href="#gimp"><em>Chartreuse in GIMP</em></a><em>a</em>
-shows: increase
-the red and you will get a more yellow color, while lowering the blue
-level will turn it into brown.</p>
-<div class="figure align-center" id="gimp">
-<a class="reference internal image-reference" href="_images/gimp-sliders+panel.png"><img alt="_images/gimp-sliders+panel.png" src="_images/gimp-sliders+panel.png" style="width: 581.25px; height: 172.5px;" /></a>
-<p class="caption">Chartreuse in GIMP. <em>(a)</em> Sliders indicate how the color is altered
-when changing the H, S, V, R, G, or B levels. <em>(b)</em> For a constant hue (here 90)
-value increases to the right and saturation increases up, so the pure
-color is on the top right.</p>
-</div>
-<p>Is chocolate your favorite color, but you do not know the RGB equivalent
-values? Then look them up in Figure <a class="reference internal" href="#rgbchart"><em>RGB chart</em></a> or type
-<tt class="docutils literal"><span class="pre">man</span> <span class="pre">gmtcolors</span></tt> for a full list. It’s 210/105/30. But GMT makes it easy
-on you: you can specify pen, fill, and palette colors by any of the more
-than 500 unique colors found in that file.</p>
-<p>Are you very web-savvy and work best with hexadecimal color codes as
-they are used in HTML? Even that is allowed in GMT. Just start with a
-hash mark (<tt class="docutils literal"><span class="pre">#</span></tt>) and follow with the 2 hexadecimal characters for red,
-green, and blue. For example, you can use <tt class="docutils literal"><span class="pre">#79ff00</span></tt> for chartreuse,
-<tt class="docutils literal"><span class="pre">#D2691E</span></tt> for chocolate.</p>
-<div class="figure align-center" id="rgbchart">
-<a class="reference internal image-reference" href="_images/GMT_RGBchart_a4.png"><img alt="_images/GMT_RGBchart_a4.png" src="_images/GMT_RGBchart_a4.png" style="width: 700px;" /></a>
-<p class="caption">The 555 unique color names that can be used in GMT. Lower, upper, or mixed cases, as well as
-the british spelling of grey are allowed. A4, Letter, and Tabloid sized versions of this RGB chart can be
-found in the GMT documentation directory.</p>
-</div>
-</div>
-<div class="section" id="hsv-color-system">
-<h2>20.2. HSV color system<a class="headerlink" href="#hsv-color-system" title="Permalink to this headline">¶</a></h2>
-<p>If you have played around with RGB color sliders, you will have noticed
-that it is not intuitive to make a chosen color lighter or darker, more
-saturated or more gray. It would involve changing three sliders. To make
-it easier to manipulate colors in terms of lightness and saturation,
-another coordinate system was invented: HSV (hue, saturation, value).
-Those terms can be made clear best by looking at the color sliders in
-Figure <a class="reference internal" href="#gimp"><em>Chartreuse in GIMP</em></a><em>a</em>. Hue (running from 0 to 360) gives you the full
-spectrum of saturated colors. Saturation (from 0 to 1, or 100%) tells
-you how ‘full’ your color is: reduce it to zero and you only have gray
-scales. Value (from 0 to 1, or 100%) will bring you from black to a
-fully saturated color. Note that “value” is not the same as “intensity”,
-or “lightness”, used in other color geometries. “Brilliance” may be the
-best alternative word to describe “value”. Apple calls it as
-“brightness”, and hence refers to HSB for this color space.</p>
-<p>Want more chartreuse or chocolate? You can specify them in GMT as
-90-1-1 and 25-0.86-0.82, respectively.</p>
-</div>
-<div class="section" id="the-color-cube">
-<h2>20.3. The color cube<a class="headerlink" href="#the-color-cube" title="Permalink to this headline">¶</a></h2>
-<p>We are going to try to give you a geometric picture of color mixing in
-RGB and HSV by means of a tour of the RGB cube depicted in
-Figure <a class="reference internal" href="#fig-example-11"><em>Example 11</em></a>. The geometric picture is most
-helpful, we think, since HSV are not orthogonal coordinates and not
-found from RGB by a simple algebraic transformation. So here goes: Look
-at the cube face with black, red, magenta, and blue corners. This is the
-<em>g</em> = 0 face. Orient the cube so that you are looking at this face
-with black in the lower left corner. Now imagine a right-handed
-cartesian (<em>rgb</em>) coordinate system with
-origin at the black point; you are looking at the <em>g = 0</em> plane
-with <em>r</em> increasing to your right, <em>g</em> increasing away from
-you, and <em>b</em> increasing up. Keep this sense of (<em>rgb</em>) as you look at the cube.</p>
-<p>Now tip the cube such that the black corner faces down and the white
-corner up. When looking from the top, you can see the hue, contoured in
-gray solid lines, running around in 360º counter-clockwise. It starts
-with shades of red (0), then goes through green (120) and blue (240),
-back to red.</p>
-<p>On the three faces that are now on the lower side (with the white print)
-one of (<em>rgb</em>) is equal to 0. These three
-faces meet at the black corner, where <em>r = g = b = 0</em>. On these
-three faces the colors are fully saturated: <em>s = 1</em>. The dashed
-white lines indicate different levels of <em>v</em>, ranging from 0 to 1
-with contours every 0.1.</p>
-<p>On the upper three faces (with the black print), one of
-(<em>rgb</em>) is equal to the maximum value. These
-three faces meet at the white corner, where <em>r = g = b = 255</em>. On
-these three faces value is at its maximum: <em>v = 1</em> (or 100%). The
-dashed black lines indicate varying levels of saturation: <em>s</em>
-ranges from 0 to 1 with contours every 0.1.</p>
-<p>Now turn the cube around on its vertical axis (running from the black to
-the white corner). Along the six edges that zigzag around the “equator”,
-both saturation and value are maximum, so <em>s = v = 1</em>. Twirling
-the cube around and tracing the zigzag, you will visit six of the eight
-corners of the cube, with changing hue (<em>h</em>): red (0), yellow
-(60), green (120), cyan (180), blue (240), and magenta (300). Three of
-these are the RGB colors; the other three are the CMY colors which are
-the complement of RGB and are used in many color hardcopy devices (see
-below). The only cube corners you did not visit on this path are the
-black and white corners. They lie on the vertical axis where hue is
-undefined and <em>r = g = b</em>. Any point on this axis is a shade of gray.</p>
-<p>Let us call the points where <em>s = v = 1</em> (points along the RYGCBM
-path described above) the “pure” colors. If we start at a pure color and
-we want to whiten it, we can keep <em>h</em> constant and <em>v = 1</em>
-while decreasing <em>s</em>; this will move us along one of the cube
-faces toward the white point. If we start at a pure color and we want to
-blacken it, we can keep <em>h</em> constant and <em>s = 1</em> while
-decreasing <em>v</em>; this will move us along one of the cube faces
-toward the black point. Any point in (<em>rgb</em>)
-space which can be thought of as a mixture of pure color + white, or
-pure color + black, is on a face of the cube.</p>
-<p>The points in the interior of the cube are a little harder to describe.
-The definition for <em>h</em> above works at all points in (non-gray)
-(<em>rgb</em>) space, but so far we have only
-looked at (<em>s</em>, <em>v</em>) on the cube faces, not inside it. At
-interior points, none of (<em>rgb</em>) is equal to
-either 0 or 255. Choose such a point, not on the gray axis. Now draw a
-line through your point so that the line intersects the gray axis and
-also intersects the RYGCBM path of edges somewhere. It is always
-possible to construct this line, and all points on this line have the
-same hue. This construction shows that any point in RGB space can be
-thought of as a mixture of a pure color plus a shade of gray. If we move
-along this line away from the gray axis toward the pure color, we are
-“purifying” the color by “removing gray”; this move increases the
-color’s saturation. When we get to the point where we cannot remove any
-more gray, at least one of (<em>rgb</em>) will have
-become zero and the color is now fully saturated; <em>s = 1</em>.
-Conversely, any point on the gray axis is completely undersaturated, so
-that <em>s = 0</em> there. Now we see that the black point is special,
-<em>s</em> is both 0 and 1 at the same time. In other words, at the black
-point saturation in undefined (and so is hue). The convention is to use
-<em>h = s = v = 0</em> at this point.</p>
-<p>It remains to define value. To do so, try this: Take your point in RGB
-space and construct a line through it so that this line goes through the
-black point; produce this line from black past your point until it hits
-a face on which <em>v = 1</em>. All points on this line have the same
-hue. Note that this line and the line we made in the previous paragraph
-are both contained in the plane whose hue is constant. These two lines
-meet at some arbitrary angle which varies depending on which point you
-chose. Thus HSV is not an orthogonal coordinate system. If the line you
-made in the previous paragraph happened to touch the gray axis at the
-black point, then these two lines are the same line, which is why the
-black point is special. Now, the line we made in this paragraph
-illustrates the following: If your chosen point is not already at the
-end of the line, where <em>v = 1</em>, then it is possible to move along
-the line in that direction so as to increase
-(<em>rgb</em>) while keeping the same hue. The
-effect this has on a color monitor is to make the color more
-“brilliant”, your hue will become “stronger”; if you are already on a
-plane where at least one of (<em>rgb</em>) = 255,
-then you cannot get a stronger version of the same hue. Thus, <em>v</em>
-measures brilliance or strength. Note that it is not quite true to say
-that <em>v</em> measures distance away from the black point, because
-<em>v</em> is not equal to <img class="math" src="_images/math/48b410286f2d12b6925c3a64fc876a850f1231a5.png" alt="\sqrt{r^2 + g^2 + b^2}/255"/>.</p>
-<p>Another representation of the HSV space is the color cone illustrated in
-Figure <a class="reference internal" href="#hsv-cone"><em>The HSV color space</em></a>.</p>
-<div class="figure align-center" id="hsv-cone">
-<a class="reference internal image-reference" href="_images/hsv-cone.png"><img alt="_images/hsv-cone.png" src="_images/hsv-cone.png" style="width: 375.0px; height: 254.0px;" /></a>
-<p class="caption">The HSV color space</p>
-</div>
-</div>
-<div class="section" id="color-interpolation">
-<h2>20.4. Color interpolation<a class="headerlink" href="#color-interpolation" title="Permalink to this headline">¶</a></h2>
-<p>From studying the RGB cube, we hope you will have understood that there
-are different routes to follow between two colors, depending whether you
-are in the RGB or HSV system. Suppose you would make an interpolation
-between blue and red. In the RGB system you would follow a path
-diagonally across a face of the cube, from 0/0/255 (blue) via 127/0/127
-(purple) to 255/0/0 (red). In the HSV system, you would trace two edges,
-from 240-1-1 (blue) via 300-1-1 (magenta) to 360-1-1 (red). That is even
-assuming software would be smart enough to go the shorter route. More
-likely, red will be recorded as 0-1-1, so hue will be interpolated the
-other way around, reducing hue from 240 to 0, via cyan, green, and yellow.</p>
-<p>Depending on the design of your color palette, you may want to have it
-either way. By default, GMT interpolates in RGB space, even when the
-original color palette is in the HSV system. However, when you add the
-line <tt class="docutils literal"><span class="pre">#COLOR_MODEL=+HSV</span></tt> (with the leading ‘+’ sign) in the header of
-the color palette file, GMT will not only read the color
-representation as HSV values, but also interpolate colors in the HSV
-system. That means that H, S, and V values are interpolated linearly
-between two colors, instead of their respective R, G, and B values.</p>
-<p>The top row in Figure <a class="reference internal" href="#color-interpolate"><em>Interpolating colors</em></a>
-illustrates two examples: a blue-white-red scale (the palette in
-Appendix [app:M]) interpolated in RGB and the palette interpolated in
-HSV. The bottom row of the Figure demonstrates how things can go
-terribly wrong when you do the interpolation in the other system.</p>
-<div class="figure align-center" id="color-interpolate">
-<a class="reference internal image-reference" href="_images/GMT_color_interpolate.png"><img alt="_images/GMT_color_interpolate.png" src="_images/GMT_color_interpolate.png" style="width: 500px;" /></a>
-<p class="caption">When interpolating colors, the color system matters. The polar palette on the left needs to
-be interpolated in RGB, otherwise hue will change between blue (240) and white (0). The rainbow
-palette should be interpolated in HSV, since only hue should change between magenta (300) and red (0).
-Diamonds indicate which colors are defined in the palettes; they are fixed, the rest is interpolated.</p>
-</div>
-</div>
-<div class="section" id="artificial-illumination">
-<h2>20.5. Artificial illumination<a class="headerlink" href="#artificial-illumination" title="Permalink to this headline">¶</a></h2>
-<p>GMT uses the HSV system to achieve artificial illumination of colored
-images (e.g., <strong>-I</strong> option in <a class="reference internal" href="grdimage.html"><em>grdimage</em></a>) by changing the saturation
-<em>s</em> and value <em>v</em> coordinates of the color. When the intensity is zero
-(flat illumination), the data are colored according to the CPT file. If
-the intensity is non-zero, the color is either lightened or darkened
-depending on the illumination. The color is first converted to HSV (if
-necessary) and then darkened by moving (<em>sv</em>) toward
-(<a class="reference internal" href="gmt.conf.html#color-hsv-min-s"><em>COLOR_HSV_MIN_S</em></a>, <a class="reference internal" href="gmt.conf.html#color-hsv-min-v"><em>COLOR_HSV_MIN_V</em></a>)
-if the intensity is negative, or lightened by sliding (<em>sv</em>) toward
-(<a class="reference internal" href="gmt.conf.html#color-hsv-max-s"><em>COLOR_HSV_MAX_S</em></a>, <a class="reference internal" href="gmt.conf.html#color-hsv-max-v"><em>COLOR_HSV_MAX_V</em></a>)
-if the illumination is positive. The extremes of the <em>s</em> and <em>v</em> are defined in the
-<a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file and are usually chosen so the corresponding points are nearly black
-(<em>s = 1</em>, <em>v = 0</em>) and white (<em>s = 0</em>, <em>v = 1</em>).
-The reason this works is that the HSV system allows movements in color
-space which correspond more closely to what we mean by “tint” and
-“shade”; an instruction like “add white” is easy in HSV and not so
-obvious in RGB.</p>
-</div>
-<div class="section" id="thinking-in-rgb-or-hsv">
-<h2>20.6. Thinking in RGB or HSV<a class="headerlink" href="#thinking-in-rgb-or-hsv" title="Permalink to this headline">¶</a></h2>
-<p>The RGB system is understandable because it is cartesian, and we all
-learned cartesian coordinates in school. But it doesn’t help us create a
-tint or shade of a color; we cannot say, “We want orange, and a lighter
-shade of orange, or a less vivid orange”. With HSV we can do this, by
-saying, “Orange must be between red and yellow, so its hue is about
-<em>h = 30</em>; a less vivid orange has a lesser <em>s</em>, a darker
-orange has a lesser <em>v</em>”. On the other hand, the HSV system is a
-peculiar geometric construction, more like a cone
-(Figure <a class="reference internal" href="#hsv-cone"><em>The HSV color space</em></a>). It is not an orthogonal coordinate system, and
-it is not found by a matrix transformation of RGB; these make it
-difficult in some cases too. Note that a move toward black or a move
-toward white will change both <em>s</em> and <em>v</em>, in the general
-case of an interior point in the cube. The HSV system also doesn’t
-behave well for very dark colors, where the gray point is near black and
-the two lines we constructed above are almost parallel. If you are
-trying to create nice colors for drawing chocolates, for example, you
-may be better off guessing in RGB coordinates.</p>
-</div>
-<div class="section" id="cmyk-color-system">
-<h2>20.7. CMYK color system<a class="headerlink" href="#cmyk-color-system" title="Permalink to this headline">¶</a></h2>
-<p>Finally, you can imagine that printers work in a different way: they mix
-different paints to make a color. The more paint, the darker the color,
-which is the reverse of adding more light. Also, mixing more colored
-paints does not give you true black, so that means that you really need
-four colors to do it right. Open up your color printer and you’ll
-probably find four cartridges: cyan, magenta, yellow (often these are
-combined into one), and black. They form the CMYK system of colors, each
-value running from 0 to 1 (or 100%). In GMT CMYK color coding can be
-achieved using <em>c/m/y/k</em> quadruplets.</p>
-<p>Obviously, there is no unique way to go from the 3-dimensional RGB
-system to the 4-dimensional CMYK system. So, again, there is a lot of
-hand waving applied in the transformation. Strikingly, CMYK actually
-covers a smaller color space than RGB. We will not try to explain you
-the details behind it, just know that there is a transformation needed
-to go from the colors on your screen to the colors on your printer. It
-might explain why what you see is not necessarily what you get. If you
-are really concerned about how your color plots will show up in your PhD
-thesis, for example, it might be worth trying to save and print all your
-color plots using the CMYK system. Letting GMT do the conversion to
-CMYK may avoid some nasty surprises when it comes down to printing. To
-specify the color space of your PostScript file, set
-<a class="reference internal" href="gmt.conf.html#ps-color-model"><em>PS_COLOR_MODEL</em></a> in the <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file to RGB, HSV, or CMYK.</p>
-</div>
-</div>
-<div class="section" id="i-filtering-of-data-in-gmt">
-<h1>21. I. Filtering of Data in GMT<a class="headerlink" href="#i-filtering-of-data-in-gmt" title="Permalink to this headline">¶</a></h1>
-<p>The GMT programs <a class="reference internal" href="filter1d.html"><em>filter1d</em></a> (for
-tables of data indexed to one independent variable) and
-<a class="reference internal" href="grdfilter.html"><em>grdfilter</em></a> (for data given as
-2-dimensional grids) allow filtering of data by a moving-window process.
-(To filter a grid by Fourier transform use
-<a class="reference internal" href="grdfft.html"><em>grdfft</em></a>.) Both programs use an argument
-<strong>-F</strong><<em>type</em>><<em>width</em>> to specify the
-type of process and the window’s width (in 1-D) or diameter (in 2-D).
-(In <a class="reference internal" href="filter1d.html"><em>filter1d</em></a> the width is a length of
-the time or space ordinate axis, while in
-<a class="reference internal" href="grdfilter.html"><em>grdfilter</em></a> it is the diameter of a
-circular area whose distance unit is related to the grid mesh via the
-<strong>-D</strong> option). If the process is a median, mode, or extreme value
-estimator then the window output cannot be written as a convolution and
-the filtering operation is not a linear operator. If the process is a
-weighted average, as in the boxcar, cosine, and gaussian filter types,
-then linear operator theory applies to the filtering process. These
-three filters can be described as convolutions with an impulse response
-function, and their transfer functions can be used to describe how they
-alter components in the input as a function of wavelength.</p>
-<p>Impulse responses are shown here for the boxcar, cosine, and gaussian
-filters. Only the relative amplitudes of the filter weights shown; the
-values in the center of the window have been fixed equal to 1 for ease
-of plotting. In this way the same graph can serve to illustrate both the
-1-D and 2-D impulse responses; in the 2-D case this plot is a
-diametrical cross-section through the filter weights
-(Figure <a class="reference internal" href="#impulse-responses"><em>Impulse responses</em></a>).</p>
-<div class="figure align-center" id="impulse-responses">
-<a class="reference internal image-reference" href="_images/GMT_App_J_1.png"><img alt="_images/GMT_App_J_1.png" src="_images/GMT_App_J_1.png" style="width: 500px;" /></a>
-<p class="caption">Impulse responses for GMT filters.</p>
-</div>
-<p>Although the impulse responses look the same in 1-D and 2-D, this is not
-true of the transfer functions; in 1-D the transfer function is the
-Fourier transform of the impulse response, while in 2-D it is the Hankel
-transform of the impulse response. These are shown in Figures
-<a class="reference internal" href="#gmt-1d-filters"><em>Transfer functions for 1D</em></a> and
-<a class="reference internal" href="#gmt-2d-filters"><em>2D</em></a>,
-respectively. Note that in 1-D the
-boxcar transfer function has its first zero crossing at <em>f = 1</em>,
-while in 2-D it is around <img class="math" src="_images/math/1da275241154bbf43844c575ae595078e429e04d.png" alt="f \sim 1.2"/>. The 1-D cosine transfer
-function has its first zero crossing at <em>f = 2</em>; so a cosine
-filter needs to be twice as wide as a boxcar filter in order to zero the
-same lowest frequency. As a general rule, the cosine and gaussian
-filters are “better” in the sense that they do not have the “side lobes”
-(large-amplitude oscillations in the transfer function) that the boxcar
-filter has. However, they are correspondingly “worse” in the sense that
-they require more work (doubling the width to achieve the same cut-off wavelength).</p>
-<div class="figure align-center" id="gmt-1d-filters">
-<a class="reference internal image-reference" href="_images/GMT_App_J_2.png"><img alt="_images/GMT_App_J_2.png" src="_images/GMT_App_J_2.png" style="width: 500px;" /></a>
-<p class="caption">Transfer functions for 1-D GMT filters.</p>
-</div>
-<p>One of the nice things about the gaussian filter is that its transfer
-functions are the same in 1-D and 2-D. Another nice property is that it
-has no negative side lobes. There are many definitions of the gaussian
-filter in the literature (see page 7 of Bracewell <a class="footnote-reference" href="#id81" id="id37">[33]</a>). We define
-<img class="math" src="_images/math/2298cf1485084afe72757a9c8483af49a138d81f.png" alt="\sigma"/> equal to 1/6 of the filter width, and the impulse
-response proportional to <img class="math" src="_images/math/7b3e5f3cd3642b0eb9132f765e143e4fd18f176a.png" alt="\exp[-0.5(t/\sigma)^2)"/>. With this
-definition, the transfer function is <img class="math" src="_images/math/068772bfc9e1712b9f59428fc167650df7791178.png" alt="\exp[-2(\pi\sigma f)^2]"/> and
-the wavelength at which the transfer function equals 0.5 is about 5.34
-<img class="math" src="_images/math/2298cf1485084afe72757a9c8483af49a138d81f.png" alt="\sigma"/>, or about 0.89 of the filter width.</p>
-<div class="figure align-center" id="gmt-2d-filters">
-<a class="reference internal image-reference" href="_images/GMT_App_J_3.png"><img alt="_images/GMT_App_J_3.png" src="_images/GMT_App_J_3.png" style="width: 500px;" /></a>
-<p class="caption">Transfer functions for 2-D (radial) GMT filters.</p>
-</div>
-</div>
-<div class="section" id="j-the-gmt-high-resolution-coastline-data">
-<h1>22. J. The GMT High-Resolution Coastline Data<a class="headerlink" href="#j-the-gmt-high-resolution-coastline-data" title="Permalink to this headline">¶</a></h1>
-<p>Starting with version 3.0, GMT use a completely new coastline database
-and the <a class="reference internal" href="pscoast.html"><em>pscoast</em></a> utility was been
-completely rewritten to handle the new file format. Many users have
-asked us why it has taken so long for GMT to use a high-resolution
-coastline database; after all, such data have been available in the
-public domain for years. To answer such questions we will take you along
-the road that starts with these public domain data sets and ends up with
-the database used by GMT.</p>
-<div class="section" id="selecting-the-right-data">
-<h2>22.1. Selecting the right data<a class="headerlink" href="#selecting-the-right-data" title="Permalink to this headline">¶</a></h2>
-<p>There are two well-known public-domain data sets that could be used for
-this purpose. Once is known as the World Data Bank II or CIA Data Bank
-(WDB) and contains coastlines, lakes, political boundaries, and rivers.
-The other, the World Vector Shoreline (WVS) only contains shorelines
-between saltwater and land (i.e., no lakes). It turns out that the WVS
-data is far superior to the WDB data as far as data quality goes, but as
-noted it lacks lakes, not to mention rivers and borders. We decided to
-use the WVS whenever possible and supplement it with WDB data. We got
-these data over the Internet; they are also available on CD-ROM from the
-National Geophysical Data Center in Boulder, Colorado <a class="footnote-reference" href="#id82" id="id38">[34]</a>.</p>
-</div>
-<div class="section" id="format-required-by-gmt">
-<h2>22.2. Format required by GMT<a class="headerlink" href="#format-required-by-gmt" title="Permalink to this headline">¶</a></h2>
-<p>In order to paint continents or oceans it is necessary that the
-coastline data be organized in polygons that may be filled. Simple line
-segments can be used to draw the coastline, but for painting polygons
-are required. Both the WVS and WDB data consists of unsorted line
-segments: there is no information included that tells you which segments
-belong to the same polygon (e.g., Australia should be one large
-polygon). In addition, polygons enclosing land must be differentiated
-from polygons enclosing lakes since they will need different paint.
-Finally, we want <a class="reference internal" href="pscoast.html"><em>pscoast</em></a> to be
-flexible enough that it can paint the land <em>or</em> the oceans <em>or</em> both. If
-just land (or oceans) is selected we do not want to paint those areas
-that are not land (or oceans) since previous plot programs may have
-drawn in those areas. Thus, we will need to combine polygons into new
-polygons that lend themselves to fill land (or oceans) only (Note that
-older versions of <a class="reference internal" href="pscoast.html"><em>pscoast</em></a> always
-painted lakes and wiped out whatever was plotted beneath).</p>
-</div>
-<div class="section" id="the-long-and-winding-road">
-<h2>22.3. The long and winding road<a class="headerlink" href="#the-long-and-winding-road" title="Permalink to this headline">¶</a></h2>
-<p>The WVS and WDB together represent more than 100 Mb of binary data and
-something like 20 million data points. Hence, it becomes obvious that
-any manipulation of these data must be automated. For instance, the
-reasonable requirement that no coastline should cross another coastline
-becomes a complicated processing step.</p>
-<ul>
-<li><p class="first">To begin, we first made sure that all data were “clean”, i.e., that
-there were no outliers and bad points. We had to write several
-programs to ensure data consistency and remove “spikes” and bad
-points from the raw data. Also, crossing segments were automatically
-“trimmed” provided only a few points had to be deleted. A few hundred
-more complicated cases had to be examined semi-manually.</p>
-</li>
-<li><p class="first">Programs were written to examine all the loose segments and determine
-which segments should be joined to produce polygons. Because not all
-segments joined exactly (there were non-zero gaps between some
-segments) we had to find all possible combinations and choose the
-simplest combinations. The WVS segments joined to produce more than
-200,000 polygons, the largest being the Africa-Eurasia polygon which
-has 1.4 million points. The WDB data resulted in a smaller data base
-(~25% of WVS).</p>
-</li>
-<li><p class="first">We now needed to combine the WVS and WDB data bases. The main problem
-here is that we have duplicates of polygons: most of the features in
-WVS are also in WDB. However, because the resolution of the data
-differ it is nontrivial to figure out which polygons in WDB to
-include and which ones to ignore. We used two techniques to address
-this problem. First, we looked for crossovers between all possible
-pairs of polygons. Because of the crossover processing in step 1
-above we know that there are no remaining crossovers within WVS and
-WDB; thus any crossovers would be between WVS and WDB polygons.
-Crossovers could mean two things: (1) A slightly misplaced WDB
-polygon crosses a more accurate WVS polygon, both representing the
-same geographic feature, or (2) a misplaced WDB polygon (e.g., a
-small coastal lake) crosses the accurate WVS shoreline. We
-distinguished between these cases by comparing the area and centroid
-of the two polygons. In almost all cases it was obvious when we had
-duplicates; a few cases had to be checked manually. Second, on many
-occasions the WDB duplicate polygon did not cross its WVS counterpart
-but was either entirely inside or outside the WVS polygon. In those
-cases we relied on the area-centroid tests.</p>
-</li>
-<li><p class="first">While the largest polygons were easy to identify by visual
-inspection, the majority remain unidentified. Since it is important
-to know whether a polygon is a continent or a small pond inside an
-island inside a lake we wrote programs that would determine the
-hierarchical level of each polygon. Here, level = 1 represents
-ocean/land boundaries, 2 is land/lakes borders, 3 is
-lakes/islands-in-lakes, and 4 is
-islands-in-lakes/ponds-in-islands-in-lakes. Level 4 was the highest
-level encountered in the data. To automatically determine the
-hierarchical levels we wrote programs that would compare all possible
-pairs of polygons and find how many polygons a given polygon was
-inside. Because of the size and number of the polygons such programs
-would typically run for 3 days on a Sparc-2 workstation.</p>
-</li>
-<li><p class="first">Once we know what type a polygon is we can enforce a common
-“orientation” for all polygons. We arranged them so that when you
-move along a polygon from beginning to end, your left hand is
-pointing toward “land”. At this step we also computed the area of all
-polygons since we would like the option to plot only features that
-are bigger than a minimum area to be specified by the user.</p>
-</li>
-<li><p class="first">Obviously, if you need to make a map of Denmark then you do not want
-to read the entire 1.4 million points making up the Africa-Eurasia
-polygon. Furthermore, most plotting devices will not let you paint
-and fill a polygon of that size due to memory restrictions. Hence, we
-need to partition the polygons so that smaller subsets can be
-accessed rapidly. Likewise, if you want to plot a world map on a
-letter-size paper there is no need to plot 10 million data points as
-most of them will plot several times on the same pixel and the
-operation would take a very long time to complete. We chose to make 5
-versions on the database, corresponding to different resolutions. The
-decimation was carried out using the Douglas-Peucker (DP)
-line-reduction algorithm <a class="footnote-reference" href="#id83" id="id39">[35]</a>. We chose the cutoffs so that each
-subset was approximately 20% the size of the next higher resolution.
-The five resolutions are called <strong>f</strong>ull, <strong>h</strong>igh,
-<strong>i</strong>ntermediate, <strong>l</strong>ow, and <strong>c</strong>rude; they are accessed in
-<a class="reference internal" href="pscoast.html"><em>pscoast</em></a>, <a class="reference internal" href="gmtselect.html"><em>gmtselect</em></a>, and
-<a class="reference internal" href="grdlandmask.html"><em>grdlandmask</em></a> with the <strong>-D</strong>
-option <a class="footnote-reference" href="#id84" id="id40">[36]</a>. For each of these 5 data sets (<strong>f</strong>, <strong>h</strong>, <strong>i</strong>,
-<strong>l</strong>, <strong>c</strong>) we specified an equidistant grid (1, 2, 5, 10, 20) and
-split all polygons into line-segments that each fit inside one of the
-many boxes defined by these grid lines. Thus, to paint the entire
-continent of Australia we instead paint many smaller polygons made up
-of these line segments and gridlines. Some book-keeping has to be
-done since we need to know which parent polygon these smaller pieces
-came from in order to prescribe the correct paint or ignore if the
-feature is smaller than the cutoff specified by the user. The
-resulting segment coordinates were then scaled to fit in short
-integer format to preserve precision and written in netCDF format for
-ultimate portability across hardware platforms <a class="footnote-reference" href="#id85" id="id41">[37]</a>.</p>
-</li>
-<li><p class="first">While we are now back to a file of line-segments we are in a much
-better position to create smaller polygons for painting. Two problems
-must be overcome to correctly paint an area:</p>
-<ul class="simple">
-<li>We must be able to join line segments and grid cell borders into
-meaningful polygons; how we do this will depend on whether we want
-to paint the land or the oceans.</li>
-<li>We want to nest the polygons so that no paint falls on areas that
-are “wet” (or “dry”); e.g., if a grid cell completely on land
-contains a lake with a small island, we do not want to paint the
-lake and then draw the island, but paint the annulus or “donut”
-that is represented by the land and lake, and then plot the
-island.</li>
-</ul>
-<p>GMT uses a polygon-assembly routine that carries out these tasks on the fly.</p>
-</li>
-</ul>
-</div>
-<div class="section" id="the-five-resolutions">
-<h2>22.4. The Five Resolutions<a class="headerlink" href="#the-five-resolutions" title="Permalink to this headline">¶</a></h2>
-<p>We will demonstrate the power of the new database by starting with a
-regional hemisphere map centered near Papua New Guinea and zoom in on a
-specified point. The map regions will be specified in projected km from
-the projection center, e.g., we may want the map to go from km to km in
-the longitudinal and the latitudinal direction.
-Also, as we zoom in on the projection center we want to draw the outline
-of the next map region on the plot. To do that we use the <strong>-D</strong> option
-in <a class="reference internal" href="psbasemap.html"><em>psbasemap</em></a>.</p>
-<div class="section" id="the-crude-resolution-dc">
-<h3>22.4.1. The crude resolution (<strong>-Dc</strong>)<a class="headerlink" href="#the-crude-resolution-dc" title="Permalink to this headline">¶</a></h3>
-<p>We begin with an azimuthal equidistant map of the hemisphere centered on
-130°21’E, 0°12’S, which is slightly west of New Guinea, near the Strait of
-Dampier. The edges of the map are all 9000 km true distance from the
-projection center. At this scale (and for global maps) the crude
-resolution data will usually be adequate to capture the main geographic
-features. To avoid cluttering the map with insignificant detail we only
-plot features (i.e., polygons) that exceed 500 km^2 in area.
-Smaller features would only occupy a few pixels on the plot and make the
-map look “dirty”. We also add national borders to the plot. The crude
-database is heavily decimated and simplified by the DP-routine: The
-total file size of the coastlines, rivers, and borders database is only
-283 kbytes. The plot is produced by the script:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt <span class="nb">set </span>MAP_GRID_CROSS_SIZE_PRIMARY <span class="m">0</span> MAP_ANNOT_OBLIQUE <span class="m">22</span> MAP_ANNOT_MIN_SPACING 0.3i
-gmt pscoast -Rk-9000/9000/-9000/9000 -JE130.35/-0.2/3.5i -P -Dc -A500 <span class="se">\</span>
- -Gburlywood -Sazure -Wthinnest -N1/thinnest,- -B20g20 -BWSne -K > GMT_App_K_1.ps
-gmt psbasemap -R -J -O -Dk2000+c130.35/-0.2+pthicker >> GMT_App_K_1.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_App_K_1.png"><img alt="_images/GMT_App_K_1.png" src="_images/GMT_App_K_1.png" style="width: 500px;" /></a>
-<p class="caption">Map using the crude resolution coastline data.</p>
-</div>
-<p>Here, we use the <a class="reference internal" href="gmt.conf.html#map-annot-oblique"><em>MAP_ANNOT_OBLIQUE</em></a> bit flags to achieve horizontal
-annotations and set <a class="reference internal" href="gmt.conf.html#map-annot-min-spacing"><em>MAP_ANNOT_MIN_SPACING</em></a> to suppress some
-longitudinal annotations near the S pole that otherwise would overprint.
-The square box indicates the outline of the next map.</p>
-</div>
-<div class="section" id="the-low-resolution-dl">
-<h3>22.4.2. The low resolution (<strong>-Dl</strong>)<a class="headerlink" href="#the-low-resolution-dl" title="Permalink to this headline">¶</a></h3>
-<p>We have now reduced the map area by zooming in on the map center. Now,
-the edges of the map are all 2000 km true distance from the projection
-center. At this scale we choose the low resolution data that faithfully
-reproduce the dominant geographic features in the region. We cut back on
-minor features less than 100 km^2 in area. We still add
-national borders to the plot. The low database is less decimated and
-simplified by the DP-routine: The total file size of the coastlines,
-rivers, and borders combined grows to 907 kbytes; it is the default
-resolution in GMT. The plot is generated by the script:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -Rk-2000/2000/-2000/2000 -JE130.35/-0.2/3.5i -P -Dl -A100 -Gburlywood <span class="se">\</span>
- -Sazure -Wthinnest -N1/thinnest,- -B10g5 -BWSne -K > GMT_App_K_2.ps
-gmt psbasemap -R -J -O -Dk500+c130.35/-0.2+pthicker >> GMT_App_K_2.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_App_K_2.png"><img alt="_images/GMT_App_K_2.png" src="_images/GMT_App_K_2.png" style="width: 500px;" /></a>
-<p class="caption">Map using the low resolution coastline data.</p>
-</div>
-</div>
-<div class="section" id="the-intermediate-resolution-di">
-<h3>22.4.3. The intermediate resolution (<strong>-Di</strong>)<a class="headerlink" href="#the-intermediate-resolution-di" title="Permalink to this headline">¶</a></h3>
-<p>We continue to zoom in on the map center. In this map, the edges of the
-map are all 500 km true distance from the projection center. We abandon
-the low resolution data set as it would look too jagged at this scale
-and instead employ the intermediate resolution data that faithfully
-reproduce the dominant geographic features in the region. This time, we
-ignore features less than 20 km^2 in area. Although the script
-still asks for national borders none exist within our region. The
-intermediate database is moderately decimated and simplified by the
-DP-routine: The combined file size of the coastlines, rivers, and
-borders now exceeds 3.35 Mbytes. The plot is generated by the script:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -Rk-500/500/-500/500 -JE130.35/-0.2/3.5i -P -Di -A20 -Gburlywood <span class="se">\</span>
- -Sazure -Wthinnest -N1/thinnest,- -B2g1 -BWSne -K > GMT_App_K_3.ps
-<span class="nb">echo </span><span class="m">133</span> <span class="m">2</span> <span class="p">|</span> gmt psxy -R -J -O -K -Sc1.4i -Gwhite >> GMT_App_K_3.ps
-gmt psbasemap -R -J -O -K --FONT_TITLE<span class="o">=</span>12p --MAP_TICK_LENGTH_PRIMARY<span class="o">=</span>0.05i <span class="se">\</span>
- -Tm133/2/1i::+45/10/5 --FONT_ANNOT_SECONDARY<span class="o">=</span>8p >> GMT_App_K_3.ps
-gmt psbasemap -R -J -O -Dk100+c130.35/-0.2+pthicker >> GMT_App_K_3.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_App_K_3.png"><img alt="_images/GMT_App_K_3.png" src="_images/GMT_App_K_3.png" style="width: 500px;" /></a>
-<p class="caption">Map using the intermediate resolution coastline data. We have added a compass
-rose just because we have the power to do so.</p>
-</div>
-</div>
-<div class="section" id="the-high-resolution-dh">
-<h3>22.4.4. The high resolution (<strong>-Dh</strong>)<a class="headerlink" href="#the-high-resolution-dh" title="Permalink to this headline">¶</a></h3>
-<p>The relentless zooming continues! Now, the edges of the map are all 100
-km true distance from the projection center. We step up to the high
-resolution data set as it is needed to accurately portray the detailed
-geographic features within the region. Because of the small scale we
-only ignore features less than 1 km^2 in area. The high
-resolution database has undergone minor decimation and simplification by
-the DP-routine: The combined file size of the coastlines, rivers, and
-borders now swells to 12.3 Mbytes. The map and the final outline box are
-generated by these commands:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -Rk-100/100/-100/100 -JE130.35/-0.2/3.5i -P -Dh -A1 -Gburlywood <span class="se">\</span>
- -Sazure -Wthinnest -N1/thinnest,- -B30mg10m -BWSne -K > GMT_App_K_4.ps
-gmt psbasemap -R -J -O -Dk20+c130.35/-0.2+pthicker >> GMT_App_K_4.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_App_K_4.png"><img alt="_images/GMT_App_K_4.png" src="_images/GMT_App_K_4.png" style="width: 500px;" /></a>
-<p class="caption">Map using the high resolution coastline data.</p>
-</div>
-</div>
-<div class="section" id="the-full-resolution-df">
-<h3>22.4.5. The full resolution (<strong>-Df</strong>)<a class="headerlink" href="#the-full-resolution-df" title="Permalink to this headline">¶</a></h3>
-<p>We now arrive at our final plot, which shows a detailed view of the
-western side of the small island of Waigeo. The map area is
-approximately 40 by 40 km. We call upon the full resolution data set to
-portray the richness of geographic detail within this region; no
-features are ignored. The full resolution has undergone no decimation
-and it shows: The combined file size of the coastlines, rivers, and
-borders totals a (once considered hefty) 55.9 Mbytes. Our final map is
-reproduced by the single command:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -Rk-20/20/-20/20 -JE130.35/-0.2/3.5i -P -Df -Gburlywood <span class="se">\</span>
- -Sazure -Wthinnest -N1/thinnest,- -B10mg2m -BWSne > GMT_App_K_5.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_App_K_5.png"><img alt="_images/GMT_App_K_5.png" src="_images/GMT_App_K_5.png" style="width: 500px;" /></a>
-<p class="caption">Map using the full resolution coastline data.</p>
-</div>
-<p>We hope you will study these examples to enable you to make efficient
-and wise use of this vast data set.</p>
-</div>
-</div>
-</div>
-<div class="section" id="k-gmt-on-non-unix-platforms">
-<h1>23. K. GMT on non-UNIX Platforms<a class="headerlink" href="#k-gmt-on-non-unix-platforms" title="Permalink to this headline">¶</a></h1>
-<div class="section" id="id42">
-<h2>23.1. Introduction<a class="headerlink" href="#id42" title="Permalink to this headline">¶</a></h2>
-<p>While GMT was ported to non-UNIX systems such as Windows, it is
-also true that one of the strengths of GMT lies its symbiotic
-relationship with UNIX. We therefore recommend that GMT be installed
-in a POSIX-compliant UNIX environment such as traditional
-UNIX-systems, Linux, or Mac OS X. If abandoning your
-non-UNIX operating system is not an option, consider one of these
-solutions:</p>
-<dl class="docutils">
-<dt>WINDOWS:</dt>
-<dd><p class="first">Choose among these three possibilities:</p>
-<ol class="last arabic simple">
-<li>Install GMT under MinGW/MSYS (A collection of GNU utilities).</li>
-<li>Install GMT under Cygwin (A GNU port to Windows).</li>
-<li>Install GMT in Windows using Microsoft C/C++ or other
-compilers. Unlike the first two, this option will not provide you
-with any UNIX tools so you will be limited to what you can do
-with DOS batch files.</li>
-</ol>
-</dd>
-</dl>
-</div>
-<div class="section" id="cygwin-and-gmt">
-<h2>23.2. Cygwin and GMT<a class="headerlink" href="#cygwin-and-gmt" title="Permalink to this headline">¶</a></h2>
-<p>Because GMT works best in conjugation with UNIX tools we suggest you
-install GMT using the Cygwin product from Cygnus (now assimilated by
-Redhat, Inc.). This free version works on any Windows version and it
-comes with both the Bourne Again shell <strong>bash</strong> and the <strong>tcsh</strong>.
-You also have access to most standard GNU development tools such as
-compilers and text processing tools (<strong>awk</strong>, <strong>grep</strong>, <strong>sed</strong>,
-etc.). Note that executables prepared for Windows will also run under Cygwin.</p>
-<p>Follow the instructions on the Cygwin page on how to install the
-package; note you must explicitly add all the development tool packages
-(e.g., <strong>gcc</strong> etc) as the basic installation does not include them by
-default. Once you are up and running under Cygwin, you may install
-GMT the same way you do under any other UNIX platform by either
-running the automated install via <strong>install_gmt</strong> or manually running
-configure first, then type make all. If you install via the web form,
-make sure you save the parameter file without DOS CR/LF endings. Use
-<strong>dos2unix</strong> to get rid of those if need be.</p>
-<p>Finally, from Cygwin’s User Guide: By default, no Cygwin program can
-allocate more than 384 MB of memory (program and data). You should not
-need to change this default in most circumstances. However, if you need
-to use more real or virtual memory in your machine you may add an entry
-in either the <strong>HKEY_LOCAL_MACHINE</strong> (to change the limit for all
-users) or <strong>HKEY_CURRENT_USER</strong> (for just the current user) section of
-the registry. Add the DWORD value <strong>heap_chunk_in_mb</strong> and set it to
-the desired memory limit in decimal Mb. It is preferred to do this in
-Cygwin using the <strong>regtool</strong> program included in the Cygwin package.
-(For more information about <strong>regtool</strong> or the other Cygwin utilities,
-see the Section called Cygwin Utilities in Chapter 3 of the Cygwin’s
-User Guide or use the help option of each utility.) You should always be
-careful when using <strong>regtool</strong> since damaging your system registry can
-result in an unusable system. This example sets the local machine memory
-limit to 1024 Mb:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>regtool -i <span class="nb">set</span> /HKLM/Software/Cygnus<span class="se">\ </span>Solutions/Cygwin/heap_chunk_in_mb 1024
-regtool -v list /HKLM/Software/Cygnus<span class="se">\ </span>Solutions/Cygwin
-</pre></div>
-</div>
-</div></blockquote>
-<p>For more installation details see the general README file.</p>
-</div>
-<div class="section" id="mingw-msys-and-gmt">
-<h2>23.3. MINGW|MSYS and GMT<a class="headerlink" href="#mingw-msys-and-gmt" title="Permalink to this headline">¶</a></h2>
-<p>Though one can install GMT natively using CMake, the simplest way of installing
-under MINGW|MSYS is to just install the Windows binaries and use them from
-the msys bash shell. As simple as that. Furthermore, GMT programs launch
-faster here than on Cygwin so this is the recommended way of running
-GMT on Windows.</p>
-</div>
-</div>
-<div class="section" id="l-of-colors-and-color-legends">
-<h1>24. L. Of Colors and Color Legends<a class="headerlink" href="#l-of-colors-and-color-legends" title="Permalink to this headline">¶</a></h1>
-<div class="section" id="built-in-color-palette-tables">
-<h2>24.1. Built-in color palette tables<a class="headerlink" href="#built-in-color-palette-tables" title="Permalink to this headline">¶</a></h2>
-<p>Figures <a class="reference internal" href="#cpt-files-a"><em>CPT files a</em></a> and
-<a class="reference internal" href="#cpt-files-b"><em>b</em></a> show the 36 built-in
-color palettes, stored in so-called CPT tables <a class="footnote-reference" href="#id86" id="id43">[38]</a>. The programs
-<a class="reference internal" href="makecpt.html"><em>makecpt</em></a> and
-<a class="reference internal" href="grd2cpt.html"><em>grd2cpt</em></a> are used to access these
-master CPT tables and translate/scale them to fit the user’s range of
-<em>z</em>-values. The top half of the color bars in the Figure shows the
-original color scale, which can be either discrete or continuous, though
-some (like <strong>globe</strong>) are a mix of the two. The bottom half the color
-bar are built by using <a class="reference internal" href="makecpt.html"><em>makecpt</em></a>
-<strong>-T</strong>-1/1/0.25, thus splitting the color scale into 8 discrete colors.</p>
-<div class="figure align-center" id="cpt-files-a">
-<a class="reference internal image-reference" href="_images/GMT_App_M_1a.png"><img alt="_images/GMT_App_M_1a.png" src="_images/GMT_App_M_1a.png" style="width: 500px;" /></a>
-<p class="caption">The first 18 of the standard 36 CPT files supported by GMT</p>
-</div>
-<div class="figure align-center" id="cpt-files-b">
-<a class="reference internal image-reference" href="_images/GMT_App_M_1b.png"><img alt="_images/GMT_App_M_1b.png" src="_images/GMT_App_M_1b.png" style="width: 500px;" /></a>
-<p class="caption">The second 18 of the standard 36 CPT files supported by GMT</p>
-</div>
-</div>
-<div class="section" id="labeled-and-non-equidistant-color-legends">
-<h2>24.2. Labeled and non-equidistant color legends<a class="headerlink" href="#labeled-and-non-equidistant-color-legends" title="Permalink to this headline">¶</a></h2>
-<p>[app:colorbars] The use of color legends has already been introduced in
-Chapter [ch:7] (examples 2, 16, and 17). Things become a bit more
-complicated when you want to label the legend with names for certain
-intervals (like geological time periods in the example below). To
-accomplish that, one should add a semi-colon and the label name at the
-end of a line in the CPT table and add the <strong>-L</strong> option to the
-<a class="reference internal" href="psscale.html"><em>psscale</em></a> command that draws the color
-legend. This option also makes all intervals in the legend of equal
-length, even it the numerical values are not equally spaced.</p>
-<p>Normally, the name labels are plotted at the lower end of the intervals.
-But by adding a <em>gap</em> amount (even when zero) to the <strong>-L</strong> option, they
-are centered. The example below also shows how to annotate ranges using
-<strong>-Li</strong> (in which case no name labels should appear in the CPT file),
-and how to switch the color bar around (by using a negative length).</p>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_App_M_2.png"><img alt="_images/GMT_App_M_2.png" src="_images/GMT_App_M_2.png" style="width: 600px;" /></a>
-</div>
-<p>For additional color tables, visit
-<a class="reference external" href="http://soliton.vm.bytemark.co.uk/pub/cpt-city/">cpt-city</a>.</p>
-</div>
-</div>
-<div class="section" id="m-custom-plot-symbols">
-<span id="app-custom-symbols"></span><h1>25. M. Custom Plot Symbols<a class="headerlink" href="#m-custom-plot-symbols" title="Permalink to this headline">¶</a></h1>
-<div class="section" id="background">
-<h2>25.1. Background<a class="headerlink" href="#background" title="Permalink to this headline">¶</a></h2>
-<p>The GMT tools <a class="reference internal" href="psxy.html"><em>psxy</em></a> and <a class="reference internal" href="psxyz.html"><em>psxyz</em></a> are capable of using custom
-symbols as alternatives to the built-in, standard geometrical shapes
-like circles, triangles, and many others. One the command line, custom
-symbols are selected via the <strong>-Sk</strong><em>symbolname</em>[<em>size</em>] symbol
-selection, where <em>symbolname</em> refers to a special symbol definition file
-called <tt class="docutils literal"><span class="pre">symbolname.def</span></tt> that must be available via the standard GMT user paths. Several
-custom symbols comes pre-configured with GMT(see
-Figure <a class="reference internal" href="#custom-symbols"><em>Custom symbols</em></a>)</p>
-<div class="figure align-center" id="custom-symbols">
-<a class="reference internal image-reference" href="_images/GMT_App_N_1.png"><img alt="_images/GMT_App_N_1.png" src="_images/GMT_App_N_1.png" style="width: 500px;" /></a>
-<p class="caption">Custom plot symbols supported by GMT. Note that we only show
-the symbol outline and not any fill. These are all single-parameter symbols.
-Be aware that some symbols may have a hardwired fill or no-fill component,
-while others duplicate what is already available as standard built-in symbols.</p>
-</div>
-<p>You may find it convenient to examine some of these and use them as a
-starting point for your own design; they can be found in GMT’s
-share/custom directory.</p>
-</div>
-<div class="section" id="the-macro-language">
-<h2>25.2. The macro language<a class="headerlink" href="#the-macro-language" title="Permalink to this headline">¶</a></h2>
-<p>To make your own custom plot symbol, you will need to design your own
-*.def files. This section defines the language used to build custom
-symbols. You can place these definition files in your current directory
-or your .gmt user directory. When designing the symbol, you are doing so
-in a relative coordinate system centered on (0,0). This point will be
-mapped to the actual location specified by your data coordinates.
-Furthermore, your symbol should be constructed within the domain
-<img class="math" src="_images/math/aded9f7d4047915a113044df7b6a067b6c939130.png" alt="{-\frac{1}{2},+\frac{1}{2},-\frac{1}{2},+\frac{1}{2}}"/>, resulting
-in a 1 by 1 relative canvas area. This 1 x 1 square will be scaled to your
-actual symbol size when plotted.</p>
-<div class="section" id="comment-lines">
-<h3>25.2.1. Comment lines<a class="headerlink" href="#comment-lines" title="Permalink to this headline">¶</a></h3>
-<p>Your definition file may have any number of comment lines, defined to
-begin with the character #. These are skipped by GMT but provides a
-mechanism for you to clarify what your symbol does.</p>
-</div>
-<div class="section" id="symbol-variables">
-<h3>25.2.2. Symbol variables<a class="headerlink" href="#symbol-variables" title="Permalink to this headline">¶</a></h3>
-<p>Simple symbols, such as circles and triangles, only take a single
-parameter: the symbol size, which is either given on the command line
-(via <strong>-Sk</strong>) or as part of the input data. However, more complicated
-symbols, such as the ellipse or vector symbols, may require more
-parameters. If your custom symbol requires more than the single size
-parameter you must include the line</p>
-<blockquote>
-<div><strong>N</strong>: <em>n_extra_parameters</em> [<em>types</em>]</div></blockquote>
-<p>before any other macro commands. It is an optional statement in that
-<em>n_extra_parameters</em> will default to 0 unless explicitly set. By
-default the extra parameters are considered to be quantities that should
-be passed directly to the symbol machinery. However, you can use the
-<em>types</em> argument to specify different types of parameters. The available
-types are</p>
-<blockquote>
-<div><p><strong>a</strong> Geographic angle, to be converted to map angle given the current
-map projection.</p>
-<p><strong>l</strong> Length, i.e., an additional length scale (in cm, inch, or point as
-per <a class="reference internal" href="gmt.conf.html#proj-length-unit"><em>PROJ_LENGTH_UNIT</em></a>) in addition to the given symbol size.</p>
-<p><strong>o</strong> Other, i.e., a numerical quantity to be passed to the custom symbol as is.</p>
-<p><strong>s</strong> String, i.e., a single column of text to be placed by the <strong>l</strong> command.
-Use octal \040 to include spaces while still remaining a single word.</p>
-</div></blockquote>
-<p>To use the extra parameters in your macro you address them as $1, $2, etc.</p>
-</div>
-<div class="section" id="macro-commands">
-<h3>25.2.3. Macro commands<a class="headerlink" href="#macro-commands" title="Permalink to this headline">¶</a></h3>
-<p>The custom symbol language contains commands to rotate the relative
-coordinate system, draw free-form polygons and lines, change the current
-fill and/or pen, place text, and include basic geometric symbols as part of the
-overall design (e.g., circles, triangles, etc.). The available commands
-are listed in Table <a class="reference internal" href="#tbl-custsymb"><em>custsymb</em></a>.</p>
-<table border="1" class="docutils" id="tbl-custsymb">
-<colgroup>
-<col width="14%" />
-<col width="11%" />
-<col width="36%" />
-<col width="40%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"><strong>Name</strong></th>
-<th class="head"><strong>Code</strong></th>
-<th class="head"><strong>Purpose</strong></th>
-<th class="head"><strong>Arguments</strong></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>rotate</td>
-<td><strong>R</strong></td>
-<td>Rotate the coordinate system</td>
-<td><img class="math" src="_images/math/ad59b6e24a4a00ac621801f8d7513d68be654ab5.png" alt="\alpha"/>[<strong>a</strong>]</td>
-</tr>
-<tr class="row-odd"><td>moveto</td>
-<td><strong>M</strong></td>
-<td>Set a new anchor point</td>
-<td><img class="math" src="_images/math/869a1cc0e74f4485021e0fa597dbabde276a7153.png" alt="x_0, y_0"/></td>
-</tr>
-<tr class="row-even"><td>drawto</td>
-<td><strong>D</strong></td>
-<td>Draw line from previous point</td>
-<td><img class="math" src="_images/math/4bee6c8143f58f4fe181c0845298f4bd28cc61e1.png" alt="x, y"/></td>
-</tr>
-<tr class="row-odd"><td>arc</td>
-<td><strong>A</strong></td>
-<td>Append circular arc to existing path</td>
-<td><img class="math" src="_images/math/7c95f79979e59a8c813e6d3f842ecb7a1ca33cb7.png" alt="x_c, y_c, r, \alpha_1, \alpha_2"/></td>
-</tr>
-<tr class="row-even"><td>stroke</td>
-<td><strong>S</strong></td>
-<td>Stroke existing path only</td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td>texture</td>
-<td><strong>T</strong></td>
-<td>Change current pen and fill</td>
-<td> </td>
-</tr>
-<tr class="row-even"><td>star</td>
-<td><strong>a</strong></td>
-<td>Plot a star</td>
-<td><img class="math" src="_images/math/4bee6c8143f58f4fe181c0845298f4bd28cc61e1.png" alt="x, y"/>,<em>size</em></td>
-</tr>
-<tr class="row-odd"><td>circle</td>
-<td><strong>c</strong></td>
-<td>Plot a circle</td>
-<td><img class="math" src="_images/math/4bee6c8143f58f4fe181c0845298f4bd28cc61e1.png" alt="x, y"/>,<em>size</em></td>
-</tr>
-<tr class="row-even"><td>diamond</td>
-<td><strong>d</strong></td>
-<td>Plot a diamond</td>
-<td><img class="math" src="_images/math/4bee6c8143f58f4fe181c0845298f4bd28cc61e1.png" alt="x, y"/>,<em>size</em></td>
-</tr>
-<tr class="row-odd"><td>ellipse</td>
-<td><strong>e</strong></td>
-<td>Plot a ellipse</td>
-<td><img class="math" src="_images/math/7cbe56ceca10d17d290aa6650dbb52cb30a56ad5.png" alt="x, y, \alpha"/>,<em>major</em>,<em>minor</em></td>
-</tr>
-<tr class="row-even"><td>octagon</td>
-<td><strong>g</strong></td>
-<td>Plot an octagon</td>
-<td><img class="math" src="_images/math/4bee6c8143f58f4fe181c0845298f4bd28cc61e1.png" alt="x, y"/>,<em>size</em></td>
-</tr>
-<tr class="row-odd"><td>hexagon</td>
-<td><strong>h</strong></td>
-<td>Plot a hexagon</td>
-<td><img class="math" src="_images/math/4bee6c8143f58f4fe181c0845298f4bd28cc61e1.png" alt="x, y"/>,<em>size</em></td>
-</tr>
-<tr class="row-even"><td>invtriangle</td>
-<td><strong>i</strong></td>
-<td>Plot an inverted triangle</td>
-<td><img class="math" src="_images/math/4bee6c8143f58f4fe181c0845298f4bd28cc61e1.png" alt="x, y"/>,<em>size</em></td>
-</tr>
-<tr class="row-odd"><td>letter</td>
-<td><strong>l</strong></td>
-<td>Plot a letter</td>
-<td><img class="math" src="_images/math/4bee6c8143f58f4fe181c0845298f4bd28cc61e1.png" alt="x, y"/>,<em>size</em>, <em>string</em></td>
-</tr>
-<tr class="row-even"><td>marc</td>
-<td><strong>m</strong></td>
-<td>Plot a math arc</td>
-<td><img class="math" src="_images/math/09e7ee7c2a541bc883180197b413c80c4551895d.png" alt="x, y, r, \alpha_1, \alpha_2"/></td>
-</tr>
-<tr class="row-odd"><td>pentagon</td>
-<td><strong>n</strong></td>
-<td>Plot a pentagon</td>
-<td><img class="math" src="_images/math/4bee6c8143f58f4fe181c0845298f4bd28cc61e1.png" alt="x, y"/>,<em>size</em></td>
-</tr>
-<tr class="row-even"><td>plus</td>
-<td><strong>+</strong></td>
-<td>Plot a plus sign</td>
-<td><img class="math" src="_images/math/4bee6c8143f58f4fe181c0845298f4bd28cc61e1.png" alt="x, y"/>,<em>size</em></td>
-</tr>
-<tr class="row-odd"><td>rect</td>
-<td><strong>r</strong></td>
-<td>Plot a rectangle</td>
-<td><img class="math" src="_images/math/4bee6c8143f58f4fe181c0845298f4bd28cc61e1.png" alt="x, y"/>, <em>width</em>, <em>height</em></td>
-</tr>
-<tr class="row-even"><td>square</td>
-<td><strong>s</strong></td>
-<td>Plot a square</td>
-<td><img class="math" src="_images/math/4bee6c8143f58f4fe181c0845298f4bd28cc61e1.png" alt="x, y"/>,<em>size</em></td>
-</tr>
-<tr class="row-odd"><td>triangle</td>
-<td><strong>t</strong></td>
-<td>Plot a triangle</td>
-<td><img class="math" src="_images/math/4bee6c8143f58f4fe181c0845298f4bd28cc61e1.png" alt="x, y"/>,<em>size</em></td>
-</tr>
-<tr class="row-even"><td>wedge</td>
-<td><strong>w</strong></td>
-<td>Plot a wedge</td>
-<td><img class="math" src="_images/math/09e7ee7c2a541bc883180197b413c80c4551895d.png" alt="x, y, r, \alpha_1, \alpha_2"/></td>
-</tr>
-<tr class="row-odd"><td>cross</td>
-<td><strong>x</strong></td>
-<td>Plot a cross</td>
-<td><img class="math" src="_images/math/4bee6c8143f58f4fe181c0845298f4bd28cc61e1.png" alt="x, y"/>,<em>size</em></td>
-</tr>
-<tr class="row-even"><td>x-dash</td>
-<td><strong>-</strong></td>
-<td>Plot a x-dash</td>
-<td><img class="math" src="_images/math/4bee6c8143f58f4fe181c0845298f4bd28cc61e1.png" alt="x, y"/>,<em>size</em></td>
-</tr>
-<tr class="row-odd"><td>y-dash</td>
-<td><strong>y</strong></td>
-<td>Plot a y-dash</td>
-<td><img class="math" src="_images/math/4bee6c8143f58f4fe181c0845298f4bd28cc61e1.png" alt="x, y"/>,<em>size</em></td>
-</tr>
-</tbody>
-</table>
-<p>Note for <strong>R</strong>: if an <strong>a</strong> is appended then <img class="math" src="_images/math/ad59b6e24a4a00ac621801f8d7513d68be654ab5.png" alt="\alpha"/> is considered
-to be a map azimuth; otherwise it is a Cartesian angle.
-For <strong>M</strong>, <strong>T</strong>, and all the lower-case symbol codes you may optionally
-append specific pens (with <strong>-W</strong><em>pen</em>) and fills (with
-<strong>-G</strong><em>pen</em>). These settings will override the pens and fills you may
-have specified on the command line. Passing <strong>-G</strong>- or <strong>-W</strong>- means no
-fill or outline, respectively.</p>
-</div>
-<div class="section" id="text-substitution">
-<h3>25.2.4. Text substitution<a class="headerlink" href="#text-substitution" title="Permalink to this headline">¶</a></h3>
-<p>Normally, the <strong>l</strong> macro code will place a hard-wired text string. However,
-you can also obtain the entire string from your input file via a single symbol
-variable that must be declared with type <strong>s</strong> (string). The string read
-from your input file must be a single word, so if you need spaces you must
-use the octal \040 code. Similarly, to place the dollar sign $ you must
-use octal \044 so as to not confuse the parser with a symbol variable.
-The string itself, if obtained from the symbol definition file,
-may contain special codes that will be expanded given the current record. You
-can embed %X or %Y to add the current longitude (or x) and latitude (or y) in
-your label string. You may also use $n to embed a numerical symbol variable as text.
-It will be formatted according to <a class="reference internal" href="gmt.conf.html#format-float-map"><em>FORMAT_FLOAT_MAP</em></a>,
-unless you append the modifiers <strong>+X</strong> (longitude via <a class="reference internal" href="gmt.conf.html#format-geo-map"><em>FORMAT_GEO_MAP</em></a>),
-<strong>+Y</strong> (latitude via <a class="reference internal" href="gmt.conf.html#format-geo-map"><em>FORMAT_GEO_MAP</em></a>), or <strong>+T</strong> (calendar time via
-<a class="reference internal" href="gmt.conf.html#format-date-map"><em>FORMAT_DATE_MAP</em></a> and <a class="reference internal" href="gmt.conf.html#format-clock-map"><em>FORMAT_CLOCK_MAP</em></a>.</p>
-</div>
-<div class="section" id="text-alignment-and-font-attributes">
-<h3>25.2.5. Text alignment and font attributes<a class="headerlink" href="#text-alignment-and-font-attributes" title="Permalink to this headline">¶</a></h3>
-<p>Like the <strong>Sl</strong> symbol in <a class="reference internal" href="psxy.html"><em>psxy</em></a>, you can change the current
-font by appending to <strong>l</strong> the modifier <strong>+f</strong><em>font</em> [FONT_ANNOT_PRIMARY] and change the text justification
-by appending the modifier <strong>+j</strong><em>justify</em> [CM]. Note: Here, the <em>font</em> specification
-will only be considered for the font type and not its size (which is set separately by your <em>size</em>
-argument) or color and outline (which are set separately by <strong>-G</strong> and <strong>-W</strong> arguments).
-Finally, there are two ways to specify the font size. If a fixed font size is given in points
-(e.g,, 12p) then the text will be set at that size regardless of the symbol size specified in <strong>-S</strong>.
-Without the trailing <strong>p</strong> we interpret the size as a relative size in the 0-1 range and the actual
-font size will then scale with the symbol size, just like other symbol items.</p>
-</div>
-<div class="section" id="conditional-statements">
-<h3>25.2.6. Conditional statements<a class="headerlink" href="#conditional-statements" title="Permalink to this headline">¶</a></h3>
-<p>There are two types of conditional statements in the macro language: A
-simple condition preceding a single command, or a more elaborate
-if-then-elseif-else construct. In any test you may use one (and only
-one) of many logical operators, as listed in Table <a class="reference internal" href="#tbl-custop"><em>custop</em></a>.</p>
-<table border="1" class="docutils" id="tbl-custop">
-<colgroup>
-<col width="22%" />
-<col width="78%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"><strong>Operator</strong></th>
-<th class="head"><strong>Purpose</strong></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td><</td>
-<td>Is <em>var</em> less than <em>constant</em>?</td>
-</tr>
-<tr class="row-odd"><td><=</td>
-<td>Is <em>var</em> less than or equal to <em>constant</em>?</td>
-</tr>
-<tr class="row-even"><td>==</td>
-<td>Is <em>var</em> equal to <em>constant</em>?</td>
-</tr>
-<tr class="row-odd"><td>!=</td>
-<td>Is <em>var</em> not equal to <em>constant</em>?</td>
-</tr>
-<tr class="row-even"><td>>=</td>
-<td>Is <em>var</em> greater than or equal to <em>constant</em>?</td>
-</tr>
-<tr class="row-odd"><td>></td>
-<td>Is <em>var</em> greater than <em>constant</em>?</td>
-</tr>
-<tr class="row-even"><td>%</td>
-<td>Does <em>var</em> have a remainder with <em>constant</em>?</td>
-</tr>
-<tr class="row-odd"><td>!%</td>
-<td>Is <em>var</em> an exact multiple of <em>constant</em>?</td>
-</tr>
-<tr class="row-even"><td><></td>
-<td>Is <em>var</em> within the exclusive range of <em>constant</em>?</td>
-</tr>
-<tr class="row-odd"><td>[]</td>
-<td>Is <em>var</em> within the inclusive range of <em>constant</em>?</td>
-</tr>
-<tr class="row-even"><td><]</td>
-<td>Is <em>var</em> within the in/ex-clusive range of <em>constant</em>?</td>
-</tr>
-<tr class="row-odd"><td>[></td>
-<td>Is <em>var</em> within the ex/in-clusive range of <em>constant</em>?</td>
-</tr>
-</tbody>
-</table>
-<div class="section" id="simple-conditional-test">
-<h4>1. Simple conditional test<a class="headerlink" href="#simple-conditional-test" title="Permalink to this headline">¶</a></h4>
-<p>The simple if-test uses a one-line format, defined as</p>
-<blockquote>
-<div><strong>if</strong> <em>var OP constant</em> <strong>then</strong> <em>command</em></div></blockquote>
-<p>where <em>var</em> must be one of the symbol parameters, specified as $1, $2,
-$3, etc. You must document what these additional parameters control. For
-example, to plot a small cyan circle at (0.2, 0.3) with diameter 0.4
-only if $2 exceeds 45 you would write</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre><span class="k">if</span> <span class="nv">$2</span> > <span class="m">45</span> <span class="k">then</span> 0.2 0.3 0.4 c -Gcyan
-</pre></div>
-</div>
-</div></blockquote>
-<p>Note that this form of the conditional test has no mechanism for an
-<strong>else</strong> branch, but this can be accomplished by repeating the test but
-reversing the logic for the second copy, e.g.,</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre><span class="k">if</span> <span class="nv">$1</span> > <span class="m">10</span> <span class="k">then</span> <span class="m">0</span> <span class="m">0</span> 0.5 c -Gred
-<span class="k">if</span> <span class="nv">$1</span> <<span class="o">=</span> <span class="m">10</span> <span class="k">then</span> <span class="m">0</span> <span class="m">0</span> 0.5 c -Gblue
-</pre></div>
-</div>
-</div></blockquote>
-<p>or you may instead consider the complete conditional construct below.</p>
-</div>
-<div class="section" id="complete-conditional-test">
-<h4>1. Complete conditional test<a class="headerlink" href="#complete-conditional-test" title="Permalink to this headline">¶</a></h4>
-<p>The complete conditional test uses a multi-line format, such as</p>
-<div class="line-block">
-<div class="line"><strong>if</strong> <em>var</em> <em>OP constant</em> <strong>then</strong> {</div>
-<div class="line-block">
-<div class="line"><one or more lines with commands></div>
-</div>
-<div class="line">} <strong>elseif</strong> <em>var OP constant</em> <strong>then</strong> {</div>
-<div class="line-block">
-<div class="line"><one or more lines with commands></div>
-</div>
-<div class="line">} <strong>else</strong> {</div>
-<div class="line-block">
-<div class="line"><one or more lines with commands></div>
-</div>
-<div class="line">}</div>
-</div>
-<p>The <strong>elseif</strong> (one or more) and <strong>else</strong> branches are optional. Note
-that the syntax is strictly enforced, meaning the opening brace must
-appear after <strong>then</strong> with nothing following it, and the closing brace
-must appear by itself with no other text, and that the <strong>elseif</strong> and
-<strong>else</strong> statements must have both closing and opening braces on the
-same line (and nothing else). You may nest tests as well (up to 10
-levels deep), e.g.,</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre><span class="k">if</span> <span class="nv">$1</span> > <span class="m">45</span> <span class="k">then</span> <span class="o">{</span>
- <span class="k">if</span> <span class="nv">$2</span> <span class="o">[</span>> 0:10 <span class="k">then</span> <span class="m">0</span> <span class="m">0</span> 0.5 c -Gred
-<span class="o">}</span> elseif <span class="nv">$1</span> < <span class="m">15</span> <span class="k">then</span> <span class="o">{</span>
- <span class="k">if</span> <span class="nv">$2</span> <span class="o">[</span>> 0:10 <span class="k">then</span> <span class="m">0</span> <span class="m">0</span> 0.5 c -Ggreen
-<span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
- <span class="k">if</span> <span class="nv">$2</span> <span class="o">[</span>> 10:20 <span class="k">then</span> <span class="o">{</span>
- <span class="m">0</span> <span class="m">0</span> M -W1p,blue
- 0.3 0.3 D
- S
- 0.3 0.3 0.3 c -Gcyan
- <span class="o">}</span>
-<span class="o">}</span>
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-</div>
-</div>
-</div>
-<div class="section" id="n-annotation-of-contours-and-quoted-lines">
-<h1>26. N. Annotation of Contours and “Quoted Lines”<a class="headerlink" href="#n-annotation-of-contours-and-quoted-lines" title="Permalink to this headline">¶</a></h1>
-<p>The GMT programs <a class="reference internal" href="grdcontour.html"><em>grdcontour</em></a> (for
-data given as 2-dimensional grids) and
-<a class="reference internal" href="pscontour.html"><em>pscontour</em></a> (for <em>x,y,z</em> tables) allow
-for contouring of data sets, while <a class="reference internal" href="psxy.html"><em>psxy</em></a>
-and <a class="reference internal" href="psxyz.html"><em>psxyz</em></a> can plot lines based on <em>x,y</em>-
-and <em>x,y,z</em>-tables, respectively. In both cases it may be necessary to
-attach labels to these lines. Clever or optimal placements of labels is
-a very difficult topic, and GMT provides several algorithms for this
-placement as well as complete freedom in specifying the attributes of
-the labels. Because of the richness of these choices we present this
-Appendix which summarizes the various options and gives several examples
-of their use.</p>
-<div class="section" id="label-placement">
-<h2>26.1. Label Placement<a class="headerlink" href="#label-placement" title="Permalink to this headline">¶</a></h2>
-<p>While the previous GMT versions 1–3 allowed for a single algorithm
-that determined where labels would be placed, GMT 4 allows for five
-different algorithms. Furthermore, a new “symbol” option (<strong>-Sq</strong> for
-“quoted line”) has been added to <a class="reference internal" href="psxy.html"><em>psxy</em></a> and
-<a class="reference internal" href="psxyz.html"><em>psxyz</em></a> and hence the new label placement
-mechanisms apply to those programs as well. The contouring programs
-expect the algorithm to be specified as arguments to <strong>-G</strong> while the
-line plotting programs expect the same arguments to follow <strong>-Sq</strong>. The
-information appended to these options is the same in both cases and is
-of the form [<strong>code</strong>]<em>info</em>. The five algorithms correspond to the
-five codes below (some codes will appear in both upper and lower case;
-they share the same algorithm but differ in some other ways). In what
-follows, the phrase “line segment” is taken to mean either a contour or
-a line to be labeled. The codes are:</p>
-<dl class="docutils">
-<dt>d:</dt>
-<dd>Full syntax is
-<strong>d</strong><em>dist</em>[<strong>c|i|p</strong>][/<em>frac</em>].
-Place labels according to the distance measured along the projected
-line on the map. Append the unit you want to measure distances in
-[Default is taken from <a class="reference internal" href="gmt.conf.html#proj-length-unit"><em>PROJ_LENGTH_UNIT</em></a>]. Starting at the
-beginning of a line, place labels every <em>dist</em> increment of distance
-along the line. To ensure that closed lines whose total length is
-less than <em>dist</em> get annotated, we may append <em>frac</em> which will
-place the first label at the distance <em>d = dist</em>
-<img class="math" src="_images/math/c69691d64985442217922c8d34e835a9dea60178.png" alt="\times"/> <em>frac</em> from the start of a closed line (and every
-<em>dist</em> thereafter). If not given, <em>frac</em> defaults to 0.25.</dd>
-<dt>D:</dt>
-<dd>Full syntax is
-<strong>D</strong><em>dist</em>[<strong>d|m|s|e|f|k|M|n</strong>][/<em>frac</em>].
-This option is similar to <strong>d</strong> except the original data must be
-referred to geographic coordinates (and a map projection must have
-been chosen) and actual Earth <a class="footnote-reference" href="#id87" id="id44">[39]</a> surface distances along the
-lines are considered. Append the unit you want to measure distances
-in; choose among arc <strong>d</strong>egree, <strong>m</strong>inute, and <strong>s</strong>econd,
-or m<strong>e</strong>ter [Default], <strong>f</strong>eet, <strong>k</strong>ilometer, statute
-<strong>M</strong>iles, or <strong>n</strong>autical miles. Other aspects are similar to
-code <strong>d</strong>.</dd>
-<dt>f:</dt>
-<dd>Full syntax is
-<strong>f</strong><em>fix.txt</em>[/<em>slop</em>[<strong>c|i|p</strong>]].
-Here, an ASCII file <em>fix.txt</em> is given which must contain records
-whose first two columns hold the coordinates of points along the
-lines at which locations the labels should be placed. Labels will
-only be placed if the coordinates match the line coordinates to
-within a distance of <em>slop</em> (append unit or we use
-<a class="reference internal" href="gmt.conf.html#proj-length-unit"><em>PROJ_LENGTH_UNIT</em></a>). The default <em>slop</em> is zero, meaning only
-exact coordinate matches will do.</dd>
-<dt>l:</dt>
-<dd>Full syntax is <strong>l</strong><em>line1</em>[,<em>line2</em>[, ...]]. One or more
-straight line segments are specified separated by commas, and labels
-will be placed at the intersections between these lines and our line
-segments. Each <em>line</em> specification implies a <em>start</em> and <em>stop</em>
-point, each corresponding to a coordinate pair. These pairs can be
-regular coordinate pairs (i.e., longitude/latitude separated by a
-slash), or they can be two-character codes that refer to
-predetermined points relative to the map region. These codes are
-taken from the <a class="reference internal" href="pstext.html"><em>pstext</em></a> justification keys
-[<strong>L|C|R</strong>][<strong>B|M|T</strong>]
-so that the first character determines the <em>x</em>-coordinate and
-the second determines the <em>y</em>-coordinate. In
-<a class="reference internal" href="grdcontour.html"><em>grdcontour</em></a>, you can also use
-the two codes <strong>Z+</strong> and <strong>Z-</strong> as shorthands for the location of
-the grid’s global maximum and minimum, respectively. For example,
-the <em>line</em> <strong>LT</strong>/<strong>RB</strong> is a diagonal from the upper left to the
-lower right map corner, while <strong>Z-</strong>/135W/15S is a line from the
-grid minimum to the point (135ºW, 15ºS).</dd>
-<dt>L:</dt>
-<dd>Same as <strong>l</strong> except we will treat the lines given as great circle
-start/stop coordinates and fill in the points between before looking
-for intersections.</dd>
-<dt>n:</dt>
-<dd>Full syntax is
-<strong>n</strong><em>number</em>[/<em>minlength</em>[<strong>c|i|p</strong>]].
-Place <em>number</em> of labels along each line regardless of total line
-length. The line is divided into <em>number</em> segments and the labels
-are placed at the centers of these segments. Optionally, you may
-give a <em>minlength</em> distance to ensure that no labels are placed
-closer than this distance to its neighbors.</dd>
-<dt>N:</dt>
-<dd>Full syntax is
-<strong>N</strong><em>number</em>[/<em>minlength</em>[<strong>c|i|p</strong>]].
-Similar to code <strong>n</strong> but here labels are placed at the ends of each
-segment (for <em>number</em> >= 2). A special case arises for
-<em>number = 1</em> when a single label will be placed according to
-the sign of <em>number</em>: -1 places one label justified at the
-start of the line, while +1 places one label justified at
-the end of the line.</dd>
-<dt>x:</dt>
-<dd>Full syntax is <strong>x</strong><em>cross.d</em>. Here, an ASCII file <em>cross.d</em> is a
-multi-segment file whose lines will intersect our segment lines;
-labels will be placed at these intersections.</dd>
-<dt>X:</dt>
-<dd>Same as <strong>x</strong> except we treat the lines given as great circle
-start/stop coordinates and fill in the points between before looking
-for intersections.</dd>
-</dl>
-<p>Only one algorithm can be specified at any given time.</p>
-</div>
-<div class="section" id="label-attributes">
-<h2>26.2. Label Attributes<a class="headerlink" href="#label-attributes" title="Permalink to this headline">¶</a></h2>
-<p>Determining where to place labels is half the battle. The other half is
-to specify exactly what are the attributes of the labels. It turns out
-that there are quite a few possible attributes that we may want to
-control, hence understanding how to specify these attributes becomes
-important. In the contouring programs, one or more attributes may be
-appended to the <strong>-A</strong> option using the format +<em>code</em>[<em>args</em>] for
-each attribute, whereas for the line plotting programs these attributes
-are appended to the <strong>-Sq</strong> option following a colon (:) that separates
-the label codes from the placement algorithm. Several of the attributes
-do not apply to contours so we start off with listing those that apply
-universally. These codes are:</p>
-<dl class="docutils">
-<dt>+a:</dt>
-<dd>Controls the angle of the label relative to the angle of the line.
-Append <strong>n</strong> for normal to the line, give a fixed <em>angle</em> measured
-counter-clockwise relative to the horizontal. or append <strong>p</strong> for
-parallel to the line [Default]. If using
-<a class="reference internal" href="grdcontour.html"><em>grdcontour</em></a> the latter option
-you may further append <strong>u</strong> or <strong>d</strong> to get annotations whose upper
-edge always face the next higher or lower contour line.</dd>
-<dt>+c:</dt>
-<dd>Surrounding each label is an imaginary label “textbox” which defines
-a region in which no segment lines should be visible. The initial
-box provides an exact fit to the enclosed text but clearance may be
-extended in both the horizontal and vertical directions (relative to
-the label baseline) by the given amounts. If these should be
-different amounts please separate them by a slash; otherwise the
-single value applies to both directions. Append the distance units
-of your choice (<strong>c|i|m|p</strong>), or
-give % to indicate that the clearance should be this fixed
-percentage of the label font size in use. The default is 15%.</dd>
-<dt>+d:</dt>
-<dd>Debug mode. This is useful when testing contour placement as it will
-draw the normally invisible helper lines and points in the label
-placement algorithms above.</dd>
-<dt>+d:</dt>
-<dd>Delayed mode, to delay the plotting of the text as text clipping is set instead.</dd>
-<dt>+f:</dt>
-<dd>Specifies the desired label font, including size or color. See
-<a class="reference internal" href="pstext.html"><em>pstext</em></a> for font names or numbers.
-The default font is given by <a class="reference internal" href="gmt.conf.html#font-annot-primary"><em>FONT_ANNOT_PRIMARY</em></a>.</dd>
-<dt>+g:</dt>
-<dd>Selects opaque rather than the default transparent text boxes. You
-may optionally append the color you want to fill the label boxes;
-the default is the same as <a class="reference internal" href="gmt.conf.html#ps-page-color"><em>PS_PAGE_COLOR</em></a>.</dd>
-<dt>+j:</dt>
-<dd>Selects the justification of the label relative to the placement
-points determined above. Normally this is center/mid justified
-(<strong>CM</strong> in <a class="reference internal" href="pstext.html"><em>pstext</em></a> justification
-parlance) and this is indeed the default setting. Override by using
-this option and append another justification key code from
-[<strong>L|C|R</strong>][<strong>B|M|T</strong>].
-Note for curved text (<strong>+v</strong>) only vertical justification will be
-affected.</dd>
-<dt>+o:</dt>
-<dd>Request a rounded, rectangular label box shape; the default is
-rectangular. This is only manifested if the box is filled or
-outlined, neither of which is implied by this option alone (see
-<strong>+g</strong> and <strong>+p</strong>). As this option only applies to straight text, it
-is ignored if <strong>+v</strong> is given.</dd>
-<dt>+p:</dt>
-<dd>Selects the drawing of the label box outline; append your preferred
-<em>pen</em> unless you want the default GMT pen [0.25p,black].</dd>
-<dt>+r:</dt>
-<dd>Do not place labels at points along the line whose local radius of
-curvature falls below the given threshold value. Append the radius
-unit of your choice (<strong>c|i|p</strong>) [Default is 0].</dd>
-<dt>+u:</dt>
-<dd>Append the chosen <em>unit</em> to the label. Normally a space will
-separate the label and the unit. If you want to close this gap,
-append a <em>unit</em> that begins with a hyphen (-). If you are contouring
-with <a class="reference internal" href="grdcontour.html"><em>grdcontour</em></a> and you specify
-this option without appending a unit, the unit will be taken from
-the <em>z</em>-unit attribute of the grid header.</dd>
-<dt>+v:</dt>
-<dd>Place curved labels that follow the wiggles of the line segments.
-This is especially useful if the labels are long relative to the
-length-scale of the wiggles. The default places labels on an
-invisible straight line at the angle determined.</dd>
-<dt>+w:</dt>
-<dd>The angle of the line at the point of straight label placement is
-calculated by a least-squares fit to the <em>width</em> closest points. If
-not specified, <em>width</em> defaults to 10.</dd>
-<dt>+=:</dt>
-<dd>Similar in most regards to <strong>+u</strong> but applies instead to a label
-<em>prefix</em> which you must append.</dd>
-</dl>
-<p>For contours, the label will be the value of the contour (possibly
-modified by <strong>+u</strong> or <strong>+=</strong>). However, for quoted lines other options apply:</p>
-<dl class="docutils">
-<dt>+l:</dt>
-<dd>Append a fixed <em>label</em> that will be placed at all label locations.
-If the label contains spaces you must place it inside matching
-quotes.</dd>
-<dt>+L:</dt>
-<dd><p class="first">Append a code <em>flag</em> that will determine the label. Available codes
-are:</p>
-<dl class="last docutils">
-<dt>+Lh:</dt>
-<dd>Take the label from the current multi-segment header (hence it
-is assumed that the input line segments are given in the
-multi-segment file format; if not we pick the single label from
-the file’s header record). We first scan the header for an
-embedded <strong>-L</strong><em>label</em> option; if none is found we instead use
-the first word following the segment marker [>].</dd>
-<dt>+Ld:</dt>
-<dd>Take the Cartesian plot distances along the line as the label;
-append <strong>c|i|p</strong> as the unit [Default is
-<a class="reference internal" href="gmt.conf.html#proj-length-unit"><em>PROJ_LENGTH_UNIT</em></a>]. The label will be formatted according
-to the <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> string, <em>unless</em> label placement
-was determined from map distances along the segment lines, in
-which case we determine the appropriate format from the distance
-value itself.</dd>
-<dt>+LD:</dt>
-<dd>Calculate actual Earth surface distances and use the distance at
-the label placement point as the label; append
-<strong>d|e|f|k|m|M|n|s</strong>
-to specify the unit [If not given we default to <strong>d</strong>egrees,
-<em>unless</em> label placement was determined from map distances along
-the segment lines, in which case we use the same unit specified
-for that algorithm]. Requires a map projection to be used.</dd>
-<dt>+Lf:</dt>
-<dd>Use all text after the 2nd column in the fixed label location
-file <em>fix.txt</em> as labels. This choice obviously requires the
-fixed label location algorithm (code <strong>f</strong>) to be in effect.</dd>
-<dt>+Ln:</dt>
-<dd>Use the running number of the current multi-segment as label.</dd>
-<dt>+LN:</dt>
-<dd>Use a slash-separated combination of the current file number and
-the current multi-segment number as label.</dd>
-<dt>+Lx:</dt>
-<dd>As <strong>h</strong> but use the multi-segment headers in the <em>cross.d</em> file
-instead. This choice obviously requires the crossing segments
-location algorithm (code <strong>x|X</strong>) to be in effect.</dd>
-</dl>
-</dd>
-</dl>
-</div>
-<div class="section" id="examples-of-contour-label-placement">
-<h2>26.3. Examples of Contour Label Placement<a class="headerlink" href="#examples-of-contour-label-placement" title="Permalink to this headline">¶</a></h2>
-<p>We will demonstrate the use of these options with a few simple examples.
-First, we will contour a subset of the global geoid data used in
-GMT Example 01; the region selected encompasses the world’s strongest
-“geoid dipole”: the Indian Low and the New Guinea High.</p>
-<div class="section" id="equidistant-labels">
-<h3>26.3.1. Equidistant labels<a class="headerlink" href="#equidistant-labels" title="Permalink to this headline">¶</a></h3>
-<p>Our first example uses the default placement algorithm. Because of the
-size of the map we request contour labels every 1.5 inches along the
-lines:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -R50/160/-15/15 -JM5.3i -Gburlywood -Sazure -A500 -K -P > GMT_App_O_1.ps
-gmt grdcontour geoid.nc -J -O -B20f10 -BWSne -C10 -A20+f8p -Gd1.5i -S10 -T:LH >> GMT_App_O_1.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>As seen in Figure <a class="reference internal" href="#contour-label-1"><em>Contour label 1</em></a>, the contours are
-placed rather arbitrary. The string of contours for -40 to
-60 align well but that is a fortuitous consequence of reaching
-the 1.5 inch distance from the start at the bottom of the map.</p>
-<div class="figure align-center" id="contour-label-1">
-<a class="reference internal image-reference" href="_images/GMT_App_O_1.png"><img alt="_images/GMT_App_O_1.png" src="_images/GMT_App_O_1.png" style="width: 500px;" /></a>
-<p class="caption">Equidistant contour label placement with <strong>-Gd</strong>, the only algorithm
-available in previous GMT versions.</p>
-</div>
-</div>
-<div class="section" id="fixed-number-of-labels">
-<h3>26.3.2. Fixed number of labels<a class="headerlink" href="#fixed-number-of-labels" title="Permalink to this headline">¶</a></h3>
-<p>We now exercise the option for specifying exactly how many labels each
-contour line should have:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -R50/160/-15/15 -JM5.3i -Gburlywood -Sazure -A500 -K -P > GMT_App_O_2.ps
-gmt grdcontour geoid.nc -J -O -B20f10 -BWSne -C10 -A20+f8p -Gn1/1i -S10 -T:LH >> GMT_App_O_2.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>By selecting only one label per contour and requiring that labels only
-be placed on contour lines whose length exceed 1 inch, we achieve the
-effect shown in Figure <a class="reference internal" href="#contour-label-2"><em>Contour label 2</em></a>.</p>
-<div class="figure align-center" id="contour-label-2">
-<a class="reference internal image-reference" href="_images/GMT_App_O_2.png"><img alt="_images/GMT_App_O_2.png" src="_images/GMT_App_O_2.png" style="width: 500px;" /></a>
-<p class="caption">Placing one label per contour that exceed 1 inch in length, centered on the segment with <strong>-Gn</strong>.</p>
-</div>
-</div>
-<div class="section" id="prescribed-label-placements">
-<h3>26.3.3. Prescribed label placements<a class="headerlink" href="#prescribed-label-placements" title="Permalink to this headline">¶</a></h3>
-<p>Here, we specify four points where we would like contour labels to be
-placed. Our points are not exactly on the contour lines so we give a
-nonzero “slop” to be used in the distance calculations: The point on the
-contour closest to our fixed points and within the given maximum
-distance will host the label.</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>cat <span class="s"><< EOF > fix.txt</span>
-<span class="s">80 -8.5</span>
-<span class="s">55 -7.5</span>
-<span class="s">102 0</span>
-<span class="s">130 10.5</span>
-<span class="s">EOF</span>
-gmt pscoast -R50/160/-15/15 -JM5.3i -Gburlywood -Sazure -A500 -K -P > GMT_App_O_3.ps
-gmt grdcontour geoid.nc -J -O -B20f10 -BWSne -C10 -A20+d+f8p -Gffix.txt/0.1i -S10 -T:LH >> GMT_App_O_3.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>The angle of the label is evaluated from the contour line geometry, and
-the final result is shown in Figure <a class="reference internal" href="#contour-label-3"><em>Contour label 3</em></a>.
-To aid in understanding the algorithm we chose to specify “debug” mode
-(<strong>+d</strong>) which placed a small circle at each of the fixed points.</p>
-<div class="figure align-center" id="contour-label-3">
-<a class="reference internal image-reference" href="_images/GMT_App_O_3.png"><img alt="_images/GMT_App_O_3.png" src="_images/GMT_App_O_3.png" style="width: 500px;" /></a>
-<p class="caption">Four labels are positioned on the points along the contours that are
-closest to the locations given in the file fix.txt in the <strong>-Gf</strong> option.</p>
-</div>
-</div>
-<div class="section" id="label-placement-at-simple-line-intersections">
-<h3>26.3.4. Label placement at simple line intersections<a class="headerlink" href="#label-placement-at-simple-line-intersections" title="Permalink to this headline">¶</a></h3>
-<p>Often, it will suffice to place contours at the imaginary intersections
-between the contour lines and a well-placed straight line segment. The
-<strong>-Gl</strong> or <strong>-GL</strong> algorithms work well in those cases:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -R50/160/-15/15 -JM5.3i -Gburlywood -Sazure -A500 -K -P > GMT_App_O_4.ps
-gmt grdcontour geoid.nc -J -O -B20f10 -BWSne -C10 -A20+d+f8p -GLZ-/Z+ -S10 -T:LH >> GMT_App_O_4.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>The obvious choice in this example is to specify a great circle between
-the high and the low, thus placing all labels between these extrema.</p>
-<div class="figure align-center" id="contour-label-4">
-<a class="reference internal image-reference" href="_images/GMT_App_O_4.png"><img alt="_images/GMT_App_O_4.png" src="_images/GMT_App_O_4.png" style="width: 500px;" /></a>
-<p class="caption">Labels are placed at the intersections between contours and the great circle specified in the <strong>-GL</strong> option.</p>
-</div>
-<p>The thin debug line in Figure <a class="reference internal" href="#contour-label-4"><em>Contour label 4</em></a> shows
-the great circle and the intersections where labels are plotted. Note
-that any number of such lines could be specified; here we are content
-with just one.</p>
-</div>
-<div class="section" id="label-placement-at-general-line-intersections">
-<h3>26.3.5. Label placement at general line intersections<a class="headerlink" href="#label-placement-at-general-line-intersections" title="Permalink to this headline">¶</a></h3>
-<p>If (1) the number of intersecting straight line segments needed to pick
-the desired label positions becomes too large to be given conveniently
-on the command line, or (2) we have another data set or lines whose
-intersections we wish to use, the general crossing algorithm makes more
-sense:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -R50/160/-15/15 -JM5.3i -Gburlywood -Sazure -A500 -K -P > GMT_App_O_5.ps
-gmt grdcontour geoid.nc -J -O -B20f10 -BWSne -C10 -A20+d+f8p -GXcross.txt -S10 -T:LH >> GMT_App_O_5.ps
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center" id="contour-label-5">
-<a class="reference internal image-reference" href="_images/GMT_App_O_5.png"><img alt="_images/GMT_App_O_5.png" src="_images/GMT_App_O_5.png" style="width: 500px;" /></a>
-<p class="caption">Labels are placed at the intersections between contours and the
-multi-segment lines specified in the <strong>-GX</strong> option.</p>
-</div>
-<p>In this case, we have created three strands of lines whose intersections
-with the contours define the label placements, presented in
-Figure <a class="reference internal" href="#contour-label-5"><em>Contour label 5</em></a>.</p>
-</div>
-</div>
-<div class="section" id="examples-of-label-attributes">
-<h2>26.4. Examples of Label Attributes<a class="headerlink" href="#examples-of-label-attributes" title="Permalink to this headline">¶</a></h2>
-<p>We will now demonstrate some of the ways to play with the label
-attributes. To do so we will use <a class="reference internal" href="psxy.html"><em>psxy</em></a> on
-a great-circle line connecting the geoid extrema, along which we have
-sampled the ETOPO5 relief data set. The file thus contains <em>lon, lat,
-dist, geoid, relief</em>, with distances in km.</p>
-<div class="section" id="label-placement-by-along-track-distances-1">
-<h3>26.4.1. Label placement by along-track distances, 1<a class="headerlink" href="#label-placement-by-along-track-distances-1" title="Permalink to this headline">¶</a></h3>
-<p>This example will change the orientation of labels from along-track to
-across-track, and surrounds the labels with an opaque, outlined text box
-so that the label is more readable. We choose the place the labels every
-1000 km along the line and use that distance as the label. The labels
-are placed normal to the line:</p>
-<blockquote>
-<div><dl class="docutils">
-<dt>::</dt>
-<dd>gmt pscoast -R50/160/-15/15 -JM5.3i -Gburlywood -Sazure -A500 -K -P > GMT_App_O_6.ps
-gmt grdcontour geoid.nc -J -O -K -B20f10 -BWSne -C10 -A20+d+f8p -Gl50/10S/160/10S -S10 -T:’-+’ >> GMT_App_O_6.ps
-gmt psxy -R -J -O -SqD1000k:+g+LD+an+p -Wthick transect.txt >> GMT_App_O_6.ps</dd>
-</dl>
-</div></blockquote>
-<div class="figure align-center" id="contour-label-6">
-<a class="reference internal image-reference" href="_images/GMT_App_O_6.png"><img alt="_images/GMT_App_O_6.png" src="_images/GMT_App_O_6.png" style="width: 500px;" /></a>
-<p class="caption">Labels attributes are controlled with the arguments to the <strong>-Sq</strong> option.</p>
-</div>
-<p>The composite illustration in Figure <a class="reference internal" href="#contour-label-6"><em>Contour label 6</em></a>
-shows the new effects. Note that the line connecting the extrema does
-not end exactly at the ‘-‘ and ‘+’ symbols. This is because the
-placements of those symbols are based on the mean coordinates of the
-contour and not the locations of the (local or global) extrema.</p>
-</div>
-<div class="section" id="label-placement-by-along-track-distances-2">
-<h3>26.4.2. Label placement by along-track distances, 2<a class="headerlink" href="#label-placement-by-along-track-distances-2" title="Permalink to this headline">¶</a></h3>
-<p>A small variation on this theme is to place the labels parallel to the
-line, use spherical degrees for placement, append the degree symbol as a
-unit for the labels, choose a rounded rectangular text box, and
-inverse-video the label:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt pscoast -R50/160/-15/15 -JM5.3i -Gburlywood -Sazure -A500 -K -P > GMT_App_O_7.ps
-gmt grdcontour geoid.nc -J -O -K -B20f10 -BWSne -C10 -A20+d+u<span class="s2">" m"</span>+f8p -Gl50/10S/160/10S -S10 <span class="se">\</span>
--T:-+ >> GMT_App_O_7.ps
-gmt psxy -R -J -O -SqD15d:+gblack+fwhite+Ld+o+u<span class="se">\\</span><span class="m">260</span> -Wthick transect.txt >> GMT_App_O_7.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>The output is presented as Figure <a class="reference internal" href="#contour-label-7"><em>Contour label 7</em></a>.</p>
-<div class="figure align-center" id="contour-label-7">
-<a class="reference internal image-reference" href="_images/GMT_App_O_7.png"><img alt="_images/GMT_App_O_7.png" src="_images/GMT_App_O_7.png" style="width: 500px;" /></a>
-<p class="caption">Another label attribute example.</p>
-</div>
-</div>
-<div class="section" id="using-a-different-data-set-for-labels">
-<h3>26.4.3. Using a different data set for labels<a class="headerlink" href="#using-a-different-data-set-for-labels" title="Permalink to this headline">¶</a></h3>
-<p>In the next example we will use the bathymetry values along the transect
-as our label, with placement determined by the distance along track. We
-choose to place labels every 1500 km. To do this we need to pull out
-those records whose distances are multiples of 1500 km and create a
-“fixed points” file that can be used to place labels and specify the
-labels. This is done with <strong>awk</strong>.</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre>gmt gmtconvert -i0,1,4 -Em150 transect.txt <span class="p">|</span> <span class="nv">$AWK</span> <span class="s1">'{print $1,$2,int($3)}'</span> > fix2.txt
-gmt pscoast -R50/160/-15/15 -JM5.3i -Gburlywood -Sazure -A500 -K -P > GMT_App_O_8.ps
-gmt grdcontour geoid.nc -J -O -K -B20f10 -BWSne -C10 -A20+d+u<span class="s2">" m"</span>+f8p -Gl50/10S/160/10S -S10 <span class="se">\</span>
--T:-+ >> GMT_App_O_8.ps
-gmt psxy -R -J -O -Sqffix2.txt:+g+an+p+Lf+u<span class="s2">" m"</span>+f8p -Wthick transect.txt >> GMT_App_O_8.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>The output is presented as Figure <a class="reference internal" href="#contour-label-8"><em>Contour label 8</em></a>.</p>
-<div class="figure align-center" id="contour-label-8">
-<a class="reference internal image-reference" href="_images/GMT_App_O_8.png"><img alt="_images/GMT_App_O_8.png" src="_images/GMT_App_O_8.png" style="width: 500px;" /></a>
-<p class="caption">Labels based on another data set (here bathymetry) while the placement is based on distances.</p>
-</div>
-</div>
-</div>
-<div class="section" id="putting-it-all-together">
-<h2>26.5. Putting it all together<a class="headerlink" href="#putting-it-all-together" title="Permalink to this headline">¶</a></h2>
-<p>Finally, we will make a more complex composite illustration that uses
-several of the label placement and label attribute settings discussed in
-the previous sections. We make a map showing the tsunami travel times
-(in hours) from a hypothetical catastrophic landslide in the Canary
-Islands <a class="footnote-reference" href="#id88" id="id45">[40]</a>. We lay down a color map based on the travel times and the
-shape of the seafloor, and travel time contours with curved labels as
-well as a few quoted lines. The final script is</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre><span class="nv">R</span><span class="o">=</span>-R-85/5/10/55
-gmt grdgradient topo5.nc -Nt1 -A45 -Gtopo5_int.nc
-gmt gmtset FORMAT_GEO_MAP ddd:mm:ssF FONT_ANNOT_PRIMARY +9p FONT_TITLE 22p
-gmt project -E-74/41 -C-17/28 -G10 -Q > great_NY_Canaries.txt
-gmt project -E-74/41 -C2.33/48.87 -G100 -Q > great_NY_Paris.txt
-<span class="nv">km</span><span class="o">=</span><span class="sb">`</span><span class="nb">echo</span> -17 <span class="m">28</span> <span class="p">|</span> gmt mapproject -G-74/41/k -fg --FORMAT_FLOAT_OUT<span class="o">=</span>%.0f -o2<span class="sb">`</span>
-cat <span class="s"><< EOF > ttt.cpt</span>
-<span class="s">0 lightred 3 lightred</span>
-<span class="s">3 lightyellow 6 lightyellow</span>
-<span class="s">6 lightgreen 100 lightgreen</span>
-<span class="s">EOF</span>
-gmt grdimage ttt_atl.nc -Itopo5_int.nc -Cttt.cpt <span class="nv">$R</span> -JM5.3i -P -K -nc+t1 > GMT_App_O_9.ps
-gmt grdcontour ttt_atl.nc -R -J -O -K -C0.5 -A1+u<span class="s2">" hour"</span>+v+f8p,Bookman-Demi <span class="se">\</span>
--GL80W/31N/17W/26N,17W/28N/17W/50N -S2 >> GMT_App_O_9.ps
-gmt psxy -R -J -Wfatter,white great_NY_Canaries.txt -O -K >> GMT_App_O_9.ps
-gmt pscoast -R -J -B20f5 -BWSne+t<span class="s2">"Tsunami travel times from the Canaries"</span> -N1/thick -O -K <span class="se">\</span>
--Glightgray -Wfaint -A500 >> GMT_App_O_9.ps
-gmt gmtconvert great_NY_*.txt -E <span class="p">|</span> gmt psxy -R -J -O -K -Sa0.15i -Gred -Wthin >> GMT_App_O_9.ps
-gmt psxy -R -J -Wthick great_NY_Canaries.txt -O -K <span class="se">\</span>
--Sqn1:+f8p,Times-Italic+l<span class="s2">"Distance Canaries to New York = </span><span class="nv">$km</span><span class="s2"> km"</span>+ap+v >> GMT_App_O_9.ps
-gmt psxy -R -J great_NY_Paris.txt -O -K -Sc0.08c -Gblack >> GMT_App_O_9.ps
-gmt psxy -R -J -Wthinner great_NY_Paris.txt -SqD1000k:+an+o+gblue+LDk+f7p,Helvetica-Bold,white <span class="se">\</span>
--O -K >> GMT_App_O_9.ps
-cat <span class="s"><< EOF | gmt pstext -R -J -O -K -Gwhite -Wthin -Dj0.1i/0.1i -F+f8p,Bookman-Demi+j \</span>
-<span class="s">>> GMT_App_O_9.ps</span>
-<span class="s">74W 41N RT New York</span>
-<span class="s">2.33E 48.87N CT Paris</span>
-<span class="s">17W 28N CT Canaries</span>
-<span class="s">EOF</span>
-gmt psxy -R -J -O -T >> GMT_App_O_9.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>with the complete illustration presented as Figure
-<a class="reference internal" href="#contour-label-9"><em>Contour label 9</em></a>.</p>
-<div class="figure align-center" id="contour-label-9">
-<a class="reference internal image-reference" href="_images/GMT_App_O_9.png"><img alt="_images/GMT_App_O_9.png" src="_images/GMT_App_O_9.png" style="width: 500px;" /></a>
-<p class="caption">Tsunami travel times from the Canary Islands to places in the Atlantic,
-in particular New York. Should a catastrophic landslide occur it is possible
-that New York will experience a large tsunami about 8 hours after the event.</p>
-</div>
-</div>
-</div>
-<div class="section" id="o-special-operations">
-<h1>27. O. Special Operations<a class="headerlink" href="#o-special-operations" title="Permalink to this headline">¶</a></h1>
-<div class="section" id="running-gmt-in-isolation-mode">
-<span id="isolation-mode"></span><h2>27.1. Running GMT in <em>isolation mode</em><a class="headerlink" href="#running-gmt-in-isolation-mode" title="Permalink to this headline">¶</a></h2>
-<p>In Chapter <a class="reference internal" href="#general-features">General features</a> it is described how GMT creates
-several (temporary) files to communicate between the different commands
-that make up the script that finally creates a plot. Among those files
-are:</p>
-<blockquote>
-<div><dl class="docutils">
-<dt><strong>gmt.conf</strong> This file covers about 100 different settings that influence the</dt>
-<dd>layout of your plot, from font sizes to tick lengths and date
-formats (See Section <a class="reference internal" href="#gmt-defaults">GMT defaults</a>). Those settings can be altered
-by editing the file, or by running the
-<a class="reference internal" href="gmtset.html"><em>gmtset</em></a> command. A problem may arise
-when those settings are changed half-way through the script: the
-next time you run the script it will start with the modified
-settings and hence might alter your scripts results. It is therefore
-often necessary to revert to the original <tt class="docutils literal"><span class="pre">gmt.conf</span></tt> file. <em>Isolation mode</em>
-avoids that issue.</dd>
-<dt><strong>gmt.history</strong> This file is created to communicate the command line history from</dt>
-<dd>one command to the next (Section <a class="reference internal" href="#command-line-history">Command line history</a>) so that
-shorthands like <strong>-R</strong> or <strong>-J</strong> can be used once it has been set in
-a previous GMT command. The existence of this file makes if
-impossible to run two GMT scripts simultaneously in the same
-directory, since those <tt class="docutils literal"><span class="pre">gmt.history</span></tt> files may clash (contain different histories)
-and adversely affect the results of both scripts.</dd>
-</dl>
-</div></blockquote>
-<p>A cure to all these woes is the <em>isolation mode</em> introduced in
-GMT version 4.2.2. This mode allows you to run a GMT script without
-leaving any traces other than the resulting PostScript or data files,
-and not altering the <tt class="docutils literal"><span class="pre">gmt.conf</span></tt> or <tt class="docutils literal"><span class="pre">gmt.history</span></tt> files. Those files will be placed in a temporary
-directory instead. And if properly set up, this temporary directory will
-only be used by a single script, even if another GMT script is running
-simultaneously. This also provides the opportunity to create any other
-temporary files that the script might create in the same directory.</p>
-<p>The example below shows how <em>isolation mode</em> works.</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre><span class="nv">ps</span><span class="o">=</span>GMT_App_P_1.ps
-
-<span class="c"># Create a temporary directory. $GMT_TMPDIR will be set to its pathname.</span>
-<span class="c"># XXXXXX is replaced by a unique random combination of characters.</span>
-<span class="nb">export </span><span class="nv">GMT_TMPDIR</span><span class="o">=</span><span class="sb">`</span>mktemp -d /tmp/gmt.XXXXXX<span class="sb">`</span>
-
-<span class="c"># These settings will be local to this script only since it writes to</span>
-<span class="c"># $GMT_TMPDIR/gmt.conf</span>
-gmt gmtset COLOR_MODEL rgb FONT_ANNOT_PRIMARY 14p
-
-<span class="c"># Make grid file and color map in temporary directory</span>
-gmt grdmath -Rd -I1 <span class="nv">Y</span> <span class="o">=</span> <span class="nv">$GMT_TMPDIR</span>/lat.nc
-gmt makecpt -Crainbow -T-90/90/180 -Z > <span class="nv">$GMT_TMPDIR</span>/lat.cpt
-
-<span class="c"># The gmt grdimage command creates the history file $GMT_TMPDIR/gmt.history</span>
-gmt grdimage <span class="nv">$GMT_TMPDIR</span>/lat.nc -JK6.5i -C<span class="nv">$GMT_TMPDIR</span>/lat.cpt -P -K -nl > <span class="nv">$ps</span>
-gmt pscoast -R -J -O -Dc -A5000 -Gwhite -Bx60g30 -By30g30 >> <span class="nv">$ps</span>
-
-<span class="c"># Clean up all temporary files and the temporary directory</span>
-rm -rf <span class="nv">$GMT_TMPDIR</span>
-</pre></div>
-</div>
-</div></blockquote>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="_images/GMT_App_P_2.png"><img alt="_images/GMT_App_P_2.png" src="_images/GMT_App_P_2.png" style="width: 500px;" /></a>
-<p class="caption">Example created in isolation mode</p>
-</div>
-<p>The files <tt class="docutils literal"><span class="pre">gmt.conf</span></tt> and <tt class="docutils literal"><span class="pre">gmt.history</span></tt> are automatically created in the temporary directory
-<tt class="docutils literal"><span class="pre">$GMT_TMPDIR</span></tt>. The script is also adjusted such that the temporary grid file <tt class="docutils literal"><span class="pre">lat.nc</span></tt> and colormap
-<tt class="docutils literal"><span class="pre">lat.cpt</span></tt> are created in that directory as well. To make things even more easy,
-GMT now provides a set of handy shell functions in <a class="reference internal" href="gmt_shell_functions.sh.html"><em>gmt_shell_functions.sh</em></a>:
-simply include that file in the script and the creation and the removal
-of the temporary directory is reduced to a single command.</p>
-</div>
-</div>
-<div class="section" id="p-the-gmt-vector-data-format-for-ogr-compatibility">
-<h1>28. P. The GMT Vector Data Format for OGR Compatibility<a class="headerlink" href="#p-the-gmt-vector-data-format-for-ogr-compatibility" title="Permalink to this headline">¶</a></h1>
-<div class="section" id="id46">
-<h2>28.1. Background<a class="headerlink" href="#id46" title="Permalink to this headline">¶</a></h2>
-<p>The National Institute for Water and Atmospheric Research (NIWA) in New
-Zealand has funded the implementation of a GMT driver (read and write)
-for the OGR package. OGR is an Open Source toolkit for accessing or
-reformatting vector (spatial) data stored in a variety of formats and is
-part of the. The intention was to enable the easy rendering (using
-GMT) of spatial data held in non-GMT formats, and the export of
-vector data (e.g., contours) created by GMT for use with other GIS and
-mapping packages. While <strong>ogr2ogr</strong> has had the capability to write
-this new format since 2009, GMT 4 did not have the capability to use
-the extra information.</p>
-<p>GMT 5 now allows for more advanced vector data, including donut
-polygons (polygons with holes) and aspatial attribute data. At the same
-time, the spatial data implementation will not disrupt older GMT 4
-programs since all the new information are written via comments.</p>
-<p>The identification of spatial feature types in GMT files generally
-follows the technical description, (which is largely consistent with the
-OGC SFS specification). This specification provides for non-topological
-point, line and polygon (area) features, as well as multipoint,
-multiline and multipolygon features, and was written by
-<a class="reference external" href="http://www.niwa.co.nz/key-contacts/brent-wood/">Brent Wood</a>
-based on input from Paul Wessel and others on the GMT list.</p>
-</div>
-<div class="section" id="the-ogr-gmt-format">
-<h2>28.2. The OGR/GMT format<a class="headerlink" href="#the-ogr-gmt-format" title="Permalink to this headline">¶</a></h2>
-<p>Several key properties of the OGR/GMT format is summarized below:</p>
-<ul class="simple">
-<li>All new data fields are stored as comment lines, i.e., in lines
-starting with a “#”. OGR/GMT files are therefore compatible with
-GMT 4 binaries, which will simply ignore this new information.</li>
-<li>To be consistent with current practice in GMT, data fields are
-represented as whitespace-separated strings within the comments, each
-identified by the “@” character as a prefix, followed by a single
-character identifying the content of the field. To avoid confusion
-between words and strings, the word (field) separator within strings
-will be the “|” (pipe or vertical bar) character.</li>
-<li>Standard UNIX “\” escaping is used, such as \n for newline in a string.</li>
-<li>All new data are stored before the spatial data (coordinates) in the
-file, so when any GMT 5 program is processing the coordinate data
-for a feature, it will already have parsed any non-spatial
-information for each feature, which may impact on how the spatial
-data is treated (e.g., utilizing the aspatial attribute data for a
-feature to control symbology).</li>
-<li>The first comment line must specify the version of the OGR/GMT data
-format, to allow for future changes or enhancements to be supported
-by future GMT programs. This document describes v1.0.</li>
-<li>For consistency with other GIS formats (such as shapefiles) the
-OGR/GMT format explicitly contains a field specifying whether the
-features are points, linestrings or polygons, or the “multi” versions
-of these. (Other shapefile feature types will not be supported at
-this stage). At present, GMT programs are informed of this via
-command line parameters. This will now be explicit in the data file,
-but does not preclude command line switches setting symbologies for
-plotting polygons as lines (perimeters) or with fills, as is
-currently the practice.</li>
-<li>Note that what is currently called a “multiline” (multi-segment) file
-in GMT parlance is generally a set of “lines” in shapefile/OGR
-usage. A multiline in this context is a single feature comprising
-multiple lines. For example, all the transects from a particular
-survey may be stored as lines, each with it’s own attribute set, such
-as transect number, date/time, etc. They may also be stored as a
-single multiline feature with one attribute set, such as trip ID.
-This difference is explicitly stored in the data in OGR/shapefiles,
-but currently specified only on the command line in GMT. This
-applies also to points and polygons. The GMT equivalent to
-{multipoint, multiline, multipolygon} datatypes is multiple
-GMT files, each comprising a single {multipoint, multiline,
-multipolygon} feature.</li>
-<li>The new GMT vector data files includes a header comment specifying
-the type of spatial features it contains, as well as the description
-of the aspatial attribute data to be associated with each feature.
-Unlike the shapefile format, which stores the spatial and aspatial
-attribute data in separate files, the GMT format will store all
-data in a single file.</li>
-<li>All the features in a GMT file must be of the same type.</li>
-</ul>
-</div>
-<div class="section" id="ogr-gmt-metadata">
-<h2>28.3. OGR/GMT Metadata<a class="headerlink" href="#ogr-gmt-metadata" title="Permalink to this headline">¶</a></h2>
-<p>Several pieces of metadata information must be present in the header of
-the OGR/GMT file, followed by both spatial and aspatial data. In this
-section we look at the metadata.</p>
-<div class="section" id="format-version">
-<h3>28.3.1. Format version<a class="headerlink" href="#format-version" title="Permalink to this headline">¶</a></h3>
-<p>The comment header line will include a version identifier providing for
-possible different versions in future. It is indicated by the <strong>@V</strong>
-sequence.</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="12%" />
-<col width="16%" />
-<col width="72%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"><strong>Code</strong></th>
-<th class="head"><strong>Argument</strong></th>
-<th class="head"><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>V</td>
-<td>GMT1.0</td>
-<td>Data in this file is stored using v1.0 of the OGR/GMT data format</td>
-</tr>
-</tbody>
-</table>
-<p>An OGR/GMT file must therefore begin with the line</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre><span class="c"># @VGMT1.0</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>Parsing of the OGR/GMT format is only activated if the version
-code-sequence has been found.</p>
-</div>
-<div class="section" id="geometry-types">
-<h3>28.3.2. Geometry types<a class="headerlink" href="#geometry-types" title="Permalink to this headline">¶</a></h3>
-<p>The words and characters used to specify the geometry type (preceded by
-the <strong>@G</strong> code sequence on the header comment line), are listed in
-Table <a class="reference internal" href="#tbl-geometries"><em>geometries</em></a>.</p>
-<table border="1" class="docutils" id="tbl-geometries">
-<colgroup>
-<col width="9%" />
-<col width="15%" />
-<col width="76%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"><strong>Code</strong></th>
-<th class="head"><strong>Geometry</strong></th>
-<th class="head"><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>G</td>
-<td>POINT</td>
-<td>File with point features</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>(Each point will have it’s own attribute/header line preceding the point coordinates)</td>
-</tr>
-<tr class="row-even"><td>G</td>
-<td>MULTIPOINT</td>
-<td>File with a single multipoint feature</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>(All the point features are a single multipoint, with the same attribute/header</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>information)</td>
-</tr>
-<tr class="row-odd"><td>G</td>
-<td>LINESTRING</td>
-<td>File with features comprising multiple single lines</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>(Effectively the current GMT multiline file, each line feature will have it’s own</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>attribute and header data)</td>
-</tr>
-<tr class="row-even"><td>G</td>
-<td>MULTILINESTRING</td>
-<td>File with features comprising a multiline</td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td> </td>
-<td>(All the line features in the file are a single multiline feature, only one attribute</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>and header which applies to all the lines)</td>
-</tr>
-<tr class="row-odd"><td>G</td>
-<td>POLYGON</td>
-<td>File with one or more polygons</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>(Similar to a line file, except the features are closed polygons)</td>
-</tr>
-<tr class="row-odd"><td>G</td>
-<td>MULTIPOLYGON</td>
-<td>File with a single multipolygon</td>
-</tr>
-<tr class="row-even"><td> </td>
-<td> </td>
-<td>(Similar to a GMT multiline file, except the feature is a closed multipolygon)</td>
-</tr>
-</tbody>
-</table>
-<p>An example GMT polygon file header using this specification (in format 1.0) is</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre><span class="c"># @VGMT1.0 @GPOLYGON</span>
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="domain-and-map-projections">
-<h3>28.3.3. Domain and map projections<a class="headerlink" href="#domain-and-map-projections" title="Permalink to this headline">¶</a></h3>
-<p>The new format will also support region and projection information. The
-region will be stored in GMT <strong>-R</strong> format (i.e., <strong>-R</strong><em>W/E/S/N</em>,
-where the <em>W/E/S/N</em> values represent the extent of features); the <strong>@R</strong>
-code sequence marks the domain information. A sample region header is:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre><span class="c"># @R150/190/-45/-54</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>Projection information will be represented as four optional strings,
-prefixed by <strong>@J</strong> (J being the GMT character for projection
-information. The <strong>@J</strong> code will be followed by a character identifying
-the format, as shown in Table <a class="reference internal" href="#tbl-projectspec"><em>projectspec</em></a>.</p>
-<table border="1" class="docutils" id="tbl-projectspec">
-<colgroup>
-<col width="11%" />
-<col width="89%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"><strong>Code</strong></th>
-<th class="head"><strong>Projection Specification</strong></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>@Je</td>
-<td>EPSG code for the projection</td>
-</tr>
-<tr class="row-odd"><td>@Jg</td>
-<td>A string representing the projection parameters as used by GMT</td>
-</tr>
-<tr class="row-even"><td>@Jp</td>
-<td>A string comprising the Proj.4 parameters representing the projection parameters</td>
-</tr>
-<tr class="row-odd"><td>@Jw</td>
-<td>A string comprising the OGR WKT (well known text) representation of the projection parameters</td>
-</tr>
-</tbody>
-</table>
-<p>Sample projection strings are:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre><span class="c"># @Je4326 @JgX @Jp"+proj=longlat +ellps=WGS84+datum=WGS84 +no_defs"</span>
-<span class="c"># @Jw"GEOGCS[\"WGS84\",DATUM[\"WGS_1984\",SPHEROID\"WGS84\",6378137,\</span>
-298.257223563,AUTHORITY<span class="o">[</span><span class="se">\"</span>EPSG<span class="se">\"</span>,<span class="se">\"</span>7030<span class="se">\"</span><span class="o">]]</span>,TOWGS84<span class="o">[</span>0,0,0,0,0,0,0<span class="o">]</span>,
-AUTHORITY<span class="o">[</span><span class="se">\"</span>EPSG<span class="se">\"</span>,<span class="se">\"</span>6326<span class="se">\"</span><span class="o">]]</span>,PRIMEM<span class="o">[</span><span class="se">\"</span>Greenwich<span class="se">\"</span>,0,<span class="se">\</span>
-AUTHORITY<span class="o">[</span><span class="se">\"</span>EPSG<span class="se">\"</span>,<span class="se">\"</span>8901<span class="se">\"</span><span class="o">]]</span>,UNIT<span class="o">[</span><span class="se">\"</span>degree<span class="se">\"</span>,0.01745329251994328,<span class="se">\</span>
-AUTHORITY<span class="o">[</span><span class="se">\"</span>EPSG<span class="se">\"</span>,<span class="se">\"</span>9122<span class="se">\"</span><span class="o">]]</span>,AUTHORITY<span class="o">[</span><span class="se">\"</span>EPSG<span class="se">\"</span>,<span class="se">\"</span>4326<span class="se">\"</span><span class="o">]]</span><span class="s2">"</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>Note that an OGR-generated file will not have a <strong>@Jg</strong> string, as OGR
-does not have any knowledge of the GMT projection specification
-format. GMT supports at least one of the other formats to provide
-interoperability with other Open Source related GIS software packages.
-One relatively simple approach, (with some limitations), would be a
-lookup table matching EPSG codes to GMT strings.</p>
-</div>
-<div class="section" id="declaration-of-aspatial-fields">
-<h3>28.3.4. Declaration of aspatial fields<a class="headerlink" href="#declaration-of-aspatial-fields" title="Permalink to this headline">¶</a></h3>
-<p>The string describing the aspatial field names associated with the
-features is flagged by the <strong>@N</strong> prefix.</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="11%" />
-<col width="27%" />
-<col width="61%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"><strong>Code</strong></th>
-<th class="head"><strong>Argument</strong></th>
-<th class="head"><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>N</td>
-<td>word|word|word</td>
-<td>A “|” -separated string of names of the attribute field names</td>
-</tr>
-</tbody>
-</table>
-<p>Any name containing a space must be quoted. The <strong>@N</strong> selection must be
-combined with a matching string specifying the data type for each of the
-named fields, using the <strong>@T</strong> prefix.</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="12%" />
-<col width="28%" />
-<col width="60%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"><strong>Code</strong></th>
-<th class="head"><strong>Argument</strong></th>
-<th class="head"><strong>Description</strong></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>T</td>
-<td>word|word|word</td>
-<td>A “|” -separated string of the attribute field data types</td>
-</tr>
-</tbody>
-</table>
-<p>Available datatypes should largely follow the shapefile (DB3)
-specification, including <strong>string</strong>, <strong>integer</strong>, <strong>double</strong>,
-<strong>datetime</strong>, and <strong>logical</strong> (boolean). In OGR/GMT vector files, they
-will be stored as appropriately formatted text strings.</p>
-<p>An example header record containing all these is</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre><span class="c"># @VGMT1.0 @GPOLYGON @Nname|depth|id @Tstring|double|integer</span>
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-</div>
-<div class="section" id="ogr-gmt-data">
-<h2>28.4. OGR/GMT Data<a class="headerlink" href="#ogr-gmt-data" title="Permalink to this headline">¶</a></h2>
-<p>All generic fields must be at the start of the file before any
-feature-specific content (feature attribute data follow the metadata, as
-do the feature coordinates, separated by a comment line comprising “#
-FEATURE_DATA”. Provided each string is formatted as specified, and
-occurs on a line prefixed with “#” (i.e., is a comment), the format is
-free form, in that as many comment lines as desired may be used, with
-one or more parameter strings in any order in any line. E.g., one
-parameter per line, or all parameters on one line.</p>
-<div class="section" id="embedding-aspatial-data">
-<h3>28.4.1. Embedding aspatial data<a class="headerlink" href="#embedding-aspatial-data" title="Permalink to this headline">¶</a></h3>
-<p>Following this header line is the data itself, both aspatial and
-spatial. For line and polygon (including multiline and multipolygon)
-data, features are separated using a predefined character, by default
-“>”. For point (and multipoint) data, no such separator is required. The
-comment line containing the aspatial data for each feature will
-immediately precede the coordinate line(s). Thus in the case of lines
-and polygons, it will immediately follow the “>” line. The data line
-will be a comment flag (“#”) followed by <strong>@D</strong>, followed by a string of
-“|”-separated words comprising the data fields defined in the
-header record.</p>
-<p>To allow for names and values containing spaces, such string items among
-the <strong>@N</strong> or <strong>@D</strong> specifiers must be enclosed in double quotes.
-(Where double quotes or pipe characters are included in the string, they
-must be escaped using “\”). Where any data values are
-null, they will be represented as no characters between the field
-separator, (e.g., #@D|||). A Sample header
-and corresponding data line for points are</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre><span class="c"># @VGMT1.0 @GPOINT @Nname|depth|id @Tstring|double|integer</span>
-<span class="c"># @D"Point 1"|-34.5|1</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>while for a polygon it may look like</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre><span class="c"># @VGMT1.0 @GPOLYGON @Nname|depth|id @Tstring|double|integer</span>
->
-<span class="c"># @D"Area 1"|-34.5|1</span>
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="polygon-topologies">
-<h3>28.4.2. Polygon topologies<a class="headerlink" href="#polygon-topologies" title="Permalink to this headline">¶</a></h3>
-<p>New to GMT is the concept of polygon holes. Most other formats do
-support this structure, so that a polygon is specified as a sequence of
-point defining the perimeter, optionally followed by similar coordinate
-sequences defining any holes (the “donut” polygon concept).</p>
-<p>To implement this in a way which is compatible with previous
-GMT versions, each polygon feature must be able to be identified as
-the outer perimeter, or an inner ring (hole). This is done using a
-<strong>@P</strong> or <strong>@H</strong> on the data comment preceding the polygon coordinates.
-The <strong>@P</strong> specifies a new feature boundary (perimeter), any following
-<strong>@H</strong> polygons are holes, and must be within the preceding <strong>@P</strong>
-polygon (as described in the shapefile specification). Any <strong>@H</strong>
-polygons will NOT have any <strong>@D</strong> values, as the aspatial attribute data
-pertain to the entire feature, the <strong>@H</strong> polygons are not new polygons,
-but are merely a continuation of the definition of the same feature.</p>
-</div>
-</div>
-<div class="section" id="id47">
-<h2>28.5. Examples<a class="headerlink" href="#id47" title="Permalink to this headline">¶</a></h2>
-<p>Sample point, line and polygon files are (the new data structures are in
-lines starting with “#” in strings prefixed with “@”). Here is a typical
-point file:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre><span class="c"># @VGMT1.0 @GPOINT @Nname|depth|id</span>
-<span class="c"># @Tstring|double|integer</span>
-<span class="c"># @R178.43/178.5/-57.98/-34.5</span>
-<span class="c"># @Je4326</span>
-<span class="c"># @Jp"+proj=longlat +ellps=WGS84 +datum=WGS84+no_defs"</span>
-<span class="c"># FEATURE_DATA</span>
-<span class="c"># @D"point 1"|-34.5|1</span>
-178.5 -45.7
-<span class="c"># @D"Point 2"|-57.98|2</span>
-178.43 -46.8
-...
-</pre></div>
-</div>
-</div></blockquote>
-<p>Next is an example of a line file:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre><span class="c"># @VGMT1.0 @GLINESTRING @Nname|depth|id</span>
-<span class="c"># @Tstring|double|integer</span>
-<span class="c"># @R178.1/178.6/-48.7/-45.6</span>
-<span class="c"># @Jp"+proj=longlat +ellps=WGS84 +datum=WGS84+no_defs"</span>
-<span class="c"># FEATURE_DATA</span>
-> -W0.25p
-<span class="c"># @D"Line 1"|-50|1</span>
-178.5 -45.7
-178.6 -48.2
-178.4 -48.7
-178.1 -45.6
-> -W0.25p
-<span class="c"># @D"Line 2"|-57.98|$</span>
-178.43 -46.8
-...
-</pre></div>
-</div>
-</div></blockquote>
-<p>Finally we show an example of a polygon file:</p>
-<blockquote>
-<div><div class="highlight-bash"><div class="highlight"><pre><span class="c"># @VGMT1.0 @GPOLYGON @N"Polygon name"|substrate|id @Tstring|string|integer</span>
-<span class="c"># @R178.1/178.6/-48.7/-45.6</span>
-<span class="c"># @Jj at Jp"+proj=longlat +ellps=WGS84 +datum=WGS84+no_defs"</span>
-<span class="c"># FEATURE_DATA</span>
-> -Gblue -W0.25p
-<span class="c"># @P</span>
-<span class="c"># @D"Area 1"|finesand|1</span>
-178.1 -45.6
-178.1 -48.2
-178.5 -48.2
-178.5 -45.6
-178.1 -45.6
->
-<span class="c"># @H</span>
-<span class="c"># First hole in the preceding perimeter, so is technically still</span>
-<span class="c"># part of the same geometry, despite the preceding > character.</span>
-<span class="c"># No attribute data is provided, as this is inherited.</span>
-178.2 -45.4
-178.2 -46.5
-178.4 -46.5
-178.4 -45.4
-178.2 -45.4
->
-<span class="c"># @P</span>
-...
-</pre></div>
-</div>
-</div></blockquote>
-<table class="docutils footnote" frame="void" id="id48" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id1">[1]</a></td><td>Version 1.0 was then informally released at the Lamont-Doherty Earth Observatory.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id49" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id3">[2]</a></td><td>See GNU Lesser General Public License (<a class="reference external" href="http://www.gnu.org/copyleft/gpl.html">http://www.gnu.org/copyleft/gpl.html</a>)
-for terms on redistribution and modifications.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id50" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id4">[3]</a></td><td>The tools can also be installed on other platforms (see Appendix [app:L]).</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id51" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id5">[4]</a></td><td>One public-domain RIP is ghostscript, available from <a class="reference external" href="http://www.gnu.org/">http://www.gnu.org/</a>.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id52" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id6">[5]</a></td><td>Programs now also allow for fast, binary multicolumn file i/o.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id53" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id7">[6]</a></td><td>While the netCDF format is the default, many other formats are also possible.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id54" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id8">[7]</a></td><td>Vicenty, T. (1975), Direct and inverse solutions of geodesics on the
-ellipsoid with application of nested equations, <em>Surv. Rev.,
-XXII(176)</em>, 88–93.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id55" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id9">[8]</a></td><td>PostScript definition. In the typesetting industry a slightly
-different definition of point (1/72.27 inch) is used, presumably to
-cause needless trouble.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id56" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id10">[9]</a></td><td>Choose between SI and US default units by modifying in the
-GMT share directory.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id57" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id11">[10]</a></td><td>To remain backwards compatible with GMT 4 we will also look for
-but only if cannot be found.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id58" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id12">[11]</a></td><td>The Gregorian Calendar is a revision of the Julian Calendar which was
-instituted in a papal bull by Pope Gregory XIII in 1582. The reason
-for the calendar change was to correct for drift in the dates of
-significant religious observations (primarily Easter) and to prevent
-further drift in the dates. The important effects of the change were
-(a) Drop 10 days from October 1582 to realign the Vernal Equinox with
-21 March, (b) change leap year selection so that not all years ending
-in “00” are leap years, and (c) change the beginning of the year to 1
-January from 25 March. Adoption of the new calendar was essentially
-immediate within Catholic countries. In the Protestant countries,
-where papal authority was neither recognized not appreciated,
-adoption came more slowly. England finally adopted the new calendar
-in 1752, with eleven days removed from September. The additional day
-came because the old and new calendars disagreed on whether 1700 was
-a leap year, so the Julian calendar had to be adjusted by one more
-day.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id59" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id13">[12]</a></td><td>While UTM coordinates clearly refer to points on the Earth, in this
-context they are considered “other”. Thus, when we refer to
-“geographical” coordinates herein we imply longitude, latitude.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id60" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id14">[13]</a></td><td>Please consult the man page for <em>printf</em> or any book on C.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id61" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id15">[14]</a></td><td>For historical reasons, the GMT default is Landscape; see
-<a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> to change this.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id62" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id16">[15]</a></td><td>Ensures that boundary annotations do not fall off the page.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id63" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id18">[16]</a></td><td>To keep PostScript files small, such comments are by default turned
-off; see <a class="reference internal" href="gmt.conf.html#ps-comments"><em>PS_COMMENTS</em></a> to enable them.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id64" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id19">[17]</a></td><td>For an overview of color systems such as HSV, see Appendix [app:I].</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id65" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id20">[18]</a></td><td><dl class="first last docutils">
-<dt>Convert other graphics formats to Sun ras format using GraphicsMagick’s</dt>
-<dd>or ImageMagick’s <strong>convert</strong> program.</dd>
-</dl>
-</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id66" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id21">[19]</a></td><td>Requires building GMT with GDAL.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id67" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id23">[20]</a></td><td>Snyder, J. P., 1987, Map Projections A Working Manual, U.S.
-Geological Survey Prof. Paper 1395.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id68" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id24">[21]</a></td><td>This is, however, not the shortest distance. It is given by the great
-circle connecting the two points.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id69" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id25">[22]</a></td><td>Robinson provided a table of <em>y</em>-coordinates for latitudes
-every 5. To project values for intermediate latitudes one must
-interpolate the table. Different interpolants may result in slightly
-different maps. GMT uses the
-interpolant selected by the parameter <a class="reference internal" href="gmt.conf.html#gmt-interpolant"><em>GMT_INTERPOLANT</em></a> in the
-file.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id70" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label">[23]</td><td><em>(<a class="fn-backref" href="#id26">1</a>, <a class="fn-backref" href="#id27">2</a>)</em> These data are available on CD-ROM from NGDC (<a class="reference external" href="http://www.ngdc.noaa.gov/">http://www.ngdc.noaa.gov/</a>).</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id71" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id28">[24]</a></td><td>See <a class="reference external" href="http://topex.ucsd.edu/marine_grav/mar_grav.html">http://topex.ucsd.edu/marine_grav/mar_grav.html</a>.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id72" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id29">[25]</a></td><td>Pedants who wish to argue about the “other” arc going the long way
-should consider using it.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id73" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id30">[26]</a></td><td>While Quicktime is free you must upgrade to QuickTime Pro (USD 30) to
-use the authoring functions.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id74" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id31">[27]</a></td><td>QuickTime Pro can do this, as can most video-editing programs.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id75" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id32">[28]</a></td><td>For data bases, see <a class="reference external" href="http://topex.ucsd.edu/marine_grav/mar_grav.html">http://topex.ucsd.edu/marine_grav/mar_grav.html</a>.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id76" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id33">[29]</a></td><td>The ASCII MGD77 data are available on CD-ROM from NGDC (<a class="reference external" href="http://www.ngdc.noaa.gov/">http://www.ngdc.noaa.gov/</a>).</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id78" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id34">[30]</a></td><td>Okabe, M., 1979, Analytical expressions for gravity anomalies due to
-polyhedral bodies and translation into magnetic anomalies,
-<em>Geophysics, 44</em>, 730–741.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id79" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id35">[31]</a></td><td><a class="reference external" href="http://www.southampton.ac.uk/oes/research/staff/then.page">Timothy J. Henstock</a>,
-University of Southampton</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id80" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id36">[32]</a></td><td>If you chose SI units during the installation then the default
-encoding is ISOLatin1+, otherwise it is Standard+.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id81" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id37">[33]</a></td><td>R. Bracewell, <em>The Fourier Transform and its Applications</em>,
-McGraw-Hill, London, 444 p., 1965.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id82" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id38">[34]</a></td><td><a class="reference external" href="http://www.ngdc.noaa.gov/">National Geophysical Data Center, Boulder, Colorado</a></td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id83" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id39">[35]</a></td><td>Douglas, D.H., and T. K. Peucker, 1973, Algorithms for the reduction
-of the number of points required to represent a digitized line or its
-caricature, <em>Canadian Cartographer</em>, 10, 112–122.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id84" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id40">[36]</a></td><td>The full and high resolution files are in separate archives because
-of their size. Not all users may need these files as the intermediate
-data set is better than the data provided with version 2.2.4.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id85" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id41">[37]</a></td><td>If you need complete polygons in a simpler format, see the article on
-GSHHG (Wessel, P., and W. H. F. Smith, 1996, A Global,
-self-consistent, hierarchical, high-resolution shoreline database,
-<em>J. Geophys. Res. 101</em>, 8741–8743).</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id86" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id43">[38]</a></td><td>The 23rd palette is called <em>random</em> and produces a random set of
-colors suitable for categorical plots.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id87" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id44">[39]</a></td><td>or whatever planet we are dealing with.</td></tr>
-</tbody>
-</table>
-<table class="docutils footnote" frame="void" id="id88" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id45">[40]</a></td><td>Travel times were calculated using Geoware’s travel time calculator,
-<strong>ttt</strong>; see <a class="reference external" href="http://www.geoware-online.com/">http://www.geoware-online.com/</a>.</td></tr>
-</tbody>
-</table>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">1. Acknowledgments</a></li>
-<li><a class="reference internal" href="#a-reminder">2. A Reminder</a></li>
-<li><a class="reference internal" href="#copyright-and-caveat-emptor">3. Copyright and Caveat Emptor!</a></li>
-<li><a class="reference internal" href="#preface">4. Preface</a></li>
-<li><a class="reference internal" href="#new-features-in-gmt-5">5. New Features in GMT 5</a><ul>
-<li><a class="reference internal" href="#new-programs">5.1. New programs</a></li>
-<li><a class="reference internal" href="#new-common-options">5.2. New common options</a></li>
-<li><a class="reference internal" href="#updated-common-options">5.3. Updated common options</a></li>
-<li><a class="reference internal" href="#new-default-parameters">5.4. New default parameters</a></li>
-<li><a class="reference internal" href="#general-improvements">5.5. General improvements</a></li>
-<li><a class="reference internal" href="#program-specific-improvements">5.6. Program-specific improvements</a></li>
-<li><a class="reference internal" href="#command-line-completion">5.7. Command-line completion</a></li>
-<li><a class="reference internal" href="#incompatibilities-between-gmt-5-and-gmt-4">5.8. Incompatibilities between GMT 5 and GMT 4</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#switching-between-different-gmt-versions">6. Switching between different GMT versions</a><ul>
-<li><a class="reference internal" href="#setup-of-gmtswitch">6.1. Setup of gmtswitch</a></li>
-<li><a class="reference internal" href="#version-selection-with-helper-function">6.2. Version selection with helper function</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#introduction">7. Introduction</a><ul>
-<li><a class="reference internal" href="#references">7.1. References</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#gmt-overview-and-quick-reference">8. GMT Overview and Quick Reference</a><ul>
-<li><a class="reference internal" href="#gmt-summary">8.1. GMT summary</a></li>
-<li><a class="reference internal" href="#gmt-quick-reference">8.2. GMT quick reference</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#general-features">9. General Features</a><ul>
-<li><a class="reference internal" href="#gmt-units">9.1. GMT units</a><ul>
-<li><a class="reference internal" href="#distance-units">9.1.1. Distance units</a></li>
-<li><a class="reference internal" href="#distance-calculations">9.1.2. Distance calculations</a></li>
-<li><a class="reference internal" href="#length-units">9.1.3. Length units</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#gmt-defaults">9.2. GMT defaults</a><ul>
-<li><a class="reference internal" href="#overview-and-the-gmt-conf-file">9.2.1. Overview and the gmt.conf file</a></li>
-<li><a class="reference internal" href="#changing-gmt-defaults">9.2.2. Changing GMT defaults</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#command-line-arguments">9.3. Command line arguments</a></li>
-<li><a class="reference internal" href="#standardized-command-line-options">9.4. Standardized command line options</a><ul>
-<li><a class="reference internal" href="#data-domain-or-map-region-the-r-option">9.4.1. Data domain or map region: The <strong>-R</strong> option</a></li>
-<li><a class="reference internal" href="#coordinate-transformations-and-map-projections-the-j-option">9.4.2. Coordinate transformations and map projections: The <strong>-J</strong> option</a></li>
-<li><a class="reference internal" href="#map-frame-and-axes-annotations-the-b-option">9.4.3. Map frame and axes annotations: The <strong>-B</strong> option</a></li>
-<li><a class="reference internal" href="#portrait-plot-orientation-the-p-option">9.4.4. Portrait plot orientation: The <strong>-P</strong> option</a></li>
-<li><a class="reference internal" href="#plot-overlays-the-k-o-options">9.4.5. Plot overlays: The <strong>-K</strong> <strong>-O</strong> options</a></li>
-<li><a class="reference internal" href="#timestamps-on-plots-the-u-option">9.4.6. Timestamps on plots: The <strong>-U</strong> option</a></li>
-<li><a class="reference internal" href="#verbose-feedback-the-v-option">9.4.7. Verbose feedback: The <strong>-V</strong> option</a></li>
-<li><a class="reference internal" href="#plot-positioning-and-layout-the-x-y-options">9.4.8. Plot positioning and layout: The <strong>-X</strong> <strong>-Y</strong> options</a></li>
-<li><a class="reference internal" href="#ogr-gmt-gis-i-o-the-a-option">9.4.9. OGR/GMT GIS i/o: The <strong>-a</strong> option</a></li>
-<li><a class="reference internal" href="#binary-table-i-o-the-b-option">9.4.10. Binary table i/o: The <strong>-b</strong> option</a></li>
-<li><a class="reference internal" href="#number-of-copies-the-c-option">9.4.11. Number of Copies: The <strong>-c</strong> option</a></li>
-<li><a class="reference internal" href="#data-type-selection-the-f-option">9.4.12. Data type selection: The <strong>-f</strong> option</a></li>
-<li><a class="reference internal" href="#data-gap-detection-the-g-option">9.4.13. Data gap detection: The <strong>-g</strong> option</a></li>
-<li><a class="reference internal" href="#header-data-records-the-h-option">9.4.14. Header data records: The <strong>-h</strong> option</a></li>
-<li><a class="reference internal" href="#input-columns-selection-the-i-option">9.4.15. Input columns selection: The <strong>-i</strong> option</a></li>
-<li><a class="reference internal" href="#grid-interpolation-parameters-the-n-option">9.4.16. Grid interpolation parameters: The <strong>-n</strong> option</a></li>
-<li><a class="reference internal" href="#output-columns-selection-the-o-option">9.4.17. Output columns selection: The <strong>-o</strong> option</a></li>
-<li><a class="reference internal" href="#perspective-view-the-p-option">9.4.18. Perspective view: The <strong>-p</strong> option</a></li>
-<li><a class="reference internal" href="#grid-registration-the-r-option">9.4.19. Grid registration: The <strong>-r</strong> option</a></li>
-<li><a class="reference internal" href="#nan-record-treatment-the-s-option">9.4.20. NaN-record treatment: The <strong>-s</strong> option</a></li>
-<li><a class="reference internal" href="#layer-pdf-transparency-the-t-option">9.4.21. Layer PDF transparency: The <strong>-t</strong> option</a></li>
-<li><a class="reference internal" href="#latitude-longitude-or-longitude-latitude-the-option">9.4.22. Latitude/Longitude or Longitude/Latitude?: The <strong>-:</strong> option</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#command-line-history">9.5. Command line history</a></li>
-<li><a class="reference internal" href="#usage-messages-syntax-and-general-error-messages">9.6. Usage messages, syntax- and general error messages</a></li>
-<li><a class="reference internal" href="#standard-input-or-file-header-records">9.7. Standard input or file, header records</a></li>
-<li><a class="reference internal" href="#verbose-operation">9.8. Verbose operation</a></li>
-<li><a class="reference internal" href="#program-output">9.9. Program output</a></li>
-<li><a class="reference internal" href="#input-data-formats">9.10. Input data formats</a></li>
-<li><a class="reference internal" href="#output-data-formats">9.11. Output data formats</a></li>
-<li><a class="reference internal" href="#postscript-features">9.12. PostScript features</a></li>
-<li><a class="reference internal" href="#specifying-pen-attributes">9.13. Specifying pen attributes</a></li>
-<li><a class="reference internal" href="#specifying-area-fill-attributes">9.14. Specifying area fill attributes</a></li>
-<li><a class="reference internal" href="#specifying-fonts">9.15. Specifying Fonts</a></li>
-<li><a class="reference internal" href="#stroke-fill-and-font-transparency">9.16. Stroke, Fill and Font Transparency</a></li>
-<li><a class="reference internal" href="#color-palette-tables">9.17. Color palette tables</a><ul>
-<li><a class="reference internal" href="#categorical-cpt-files">9.17.1. Categorical CPT files</a></li>
-<li><a class="reference internal" href="#regular-cpt-files">9.17.2. Regular CPT files</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#the-drawing-of-vectors">9.18. The Drawing of Vectors</a></li>
-<li><a class="reference internal" href="#character-escape-sequences">9.19. Character escape sequences</a></li>
-<li><a class="reference internal" href="#grid-file-format-specifications">9.20. Grid file format specifications</a></li>
-<li><a class="reference internal" href="#modifiers-for-changing-the-grid-coordinates">9.21. Modifiers for changing the grid coordinates</a></li>
-<li><a class="reference internal" href="#modifiers-for-coards-compliant-netcdf-files">9.22. Modifiers for COARDS-compliant netCDF files</a></li>
-<li><a class="reference internal" href="#modifiers-to-read-and-write-grids-and-images-via-gdal">9.23. Modifiers to read and write grids and images via GDAL</a><ul>
-<li><a class="reference internal" href="#reading-multi-band-images">9.23.1. Reading multi-band images</a></li>
-<li><a class="reference internal" href="#reading-more-complex-multi-band-images-or-grids">9.23.2. Reading more complex multi-band IMAGES or GRIDS</a></li>
-<li><a class="reference internal" href="#writing-grids-and-images">9.23.3. Writing grids and images</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#the-nan-data-value">9.24. The NaN data value</a></li>
-<li><a class="reference internal" href="#directory-parameters">9.25. Directory parameters</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#gmt-coordinate-transformations">10. GMT Coordinate Transformations</a><ul>
-<li><a class="reference internal" href="#cartesian-transformations">10.1. Cartesian transformations</a><ul>
-<li><a class="reference internal" href="#cartesian-linear-transformation-jx-jx">10.1.1. Cartesian linear transformation (<strong>-Jx</strong> <strong>-JX</strong>)</a></li>
-<li><a class="reference internal" href="#cartesian-logarithmic-projection">10.1.2. Cartesian logarithmic projection</a></li>
-<li><a class="reference internal" href="#cartesian-power-projection">10.1.3. Cartesian power projection <tt class="docutils literal"><span class="pre">...</span></tt></a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#linear-projection-with-polar-coordinates-jp-jp">10.2. Linear projection with polar coordinates (<strong>-Jp</strong> <strong>-JP</strong>) <tt class="docutils literal"><span class="pre">...</span></tt></a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#gmt-map-projections">11. GMT Map Projections</a><ul>
-<li><a class="reference internal" href="#conic-projections">11.1. Conic projections</a><ul>
-<li><a class="reference internal" href="#albers-conic-equal-area-projection-jb-jb">11.1.1. Albers conic equal-area projection (<strong>-Jb</strong> <strong>-JB</strong>) <tt class="docutils literal"><span class="pre">...</span></tt></a></li>
-<li><a class="reference internal" href="#equidistant-conic-projection-jd-jd">11.1.2. Equidistant conic projection (<strong>-Jd</strong> <strong>-JD</strong>) <tt class="docutils literal"><span class="pre">...</span></tt></a></li>
-<li><a class="reference internal" href="#lambert-conic-conformal-projection-jl-jl">11.1.3. Lambert conic conformal projection (<strong>-Jl</strong> <strong>-JL</strong>) <tt class="docutils literal"><span class="pre">...</span></tt></a></li>
-<li><a class="reference internal" href="#american-polyconic-projection-jpoly-jpoly">11.1.4. (American) polyconic projection (<strong>-Jpoly</strong> <strong>-JPoly</strong>) <tt class="docutils literal"><span class="pre">...</span></tt></a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#azimuthal-projections">11.2. Azimuthal projections</a><ul>
-<li><a class="reference internal" href="#lambert-azimuthal-equal-area-ja-ja">11.2.1. Lambert Azimuthal Equal-Area (<strong>-Ja</strong> <strong>-JA</strong>)</a></li>
-<li><a class="reference internal" href="#stereographic-equal-angle-projection-js-js">11.2.2. Stereographic Equal-Angle projection (<strong>-Js</strong> <strong>-JS</strong>) <tt class="docutils literal"><span class="pre">...</span></tt></a></li>
-<li><a class="reference internal" href="#perspective-projection-jg-jg">11.2.3. Perspective projection (<strong>-Jg</strong> <strong>-JG</strong>) <tt class="docutils literal"><span class="pre">...</span></tt></a></li>
-<li><a class="reference internal" href="#orthographic-projection-jg-jg">11.2.4. Orthographic projection (<strong>-Jg</strong> <strong>-JG</strong>) <tt class="docutils literal"><span class="pre">...</span></tt></a></li>
-<li><a class="reference internal" href="#azimuthal-equidistant-projection-je-je">11.2.5. Azimuthal Equidistant projection (<strong>-Je</strong> <strong>-JE</strong>) <tt class="docutils literal"><span class="pre">...</span></tt></a></li>
-<li><a class="reference internal" href="#gnomonic-projection-jf-jf">11.2.6. Gnomonic projection (<strong>-Jf</strong> <strong>-JF</strong>) <tt class="docutils literal"><span class="pre">...</span></tt></a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#cylindrical-projections">11.3. Cylindrical projections</a><ul>
-<li><a class="reference internal" href="#mercator-projection-jm-jm">11.3.1. Mercator projection (<strong>-Jm</strong> <strong>-JM</strong>) <tt class="docutils literal"><span class="pre">...</span></tt></a></li>
-<li><a class="reference internal" href="#transverse-mercator-projection-jt-jt">11.3.2. Transverse Mercator projection (<strong>-Jt</strong> <strong>-JT</strong>) <tt class="docutils literal"><span class="pre">...</span></tt></a></li>
-<li><a class="reference internal" href="#universal-transverse-mercator-utm-projection-ju-ju">11.3.3. Universal Transverse Mercator (UTM) projection (<strong>-Ju</strong> <strong>-JU</strong>) <tt class="docutils literal"><span class="pre">...</span></tt></a></li>
-<li><a class="reference internal" href="#oblique-mercator-projection-jo-jo">11.3.4. Oblique Mercator projection (<strong>-Jo</strong> <strong>-JO</strong>) <tt class="docutils literal"><span class="pre">...</span></tt></a></li>
-<li><a class="reference internal" href="#cassini-cylindrical-projection-jc-jc">11.3.5. Cassini cylindrical projection (<strong>-Jc</strong> <strong>-JC</strong>) <tt class="docutils literal"><span class="pre">...</span></tt></a></li>
-<li><a class="reference internal" href="#cylindrical-equidistant-projection-jq-jq">11.3.6. Cylindrical equidistant projection (<strong>-Jq</strong> <strong>-JQ</strong>) <tt class="docutils literal"><span class="pre">...</span></tt></a></li>
-<li><a class="reference internal" href="#cylindrical-equal-area-projections-jy-jy">11.3.7. Cylindrical equal-area projections (<strong>-Jy</strong> <strong>-JY</strong>) <tt class="docutils literal"><span class="pre">...</span></tt></a></li>
-<li><a class="reference internal" href="#miller-cylindrical-projection-jj-jj">11.3.8. Miller Cylindrical projection (<strong>-Jj</strong> <strong>-JJ</strong>) <tt class="docutils literal"><span class="pre">...</span></tt></a></li>
-<li><a class="reference internal" href="#cylindrical-stereographic-projections-jcyl-stere-jcyl-stere">11.3.9. Cylindrical stereographic projections (<strong>-Jcyl_stere</strong> <strong>-JCyl_stere</strong>) <tt class="docutils literal"><span class="pre">...</span></tt></a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#miscellaneous-projections">11.4. Miscellaneous projections</a><ul>
-<li><a class="reference internal" href="#hammer-projection-jh-jh">11.4.1. Hammer projection (<strong>-Jh</strong> <strong>-JH</strong>) <tt class="docutils literal"><span class="pre">...</span></tt></a></li>
-<li><a class="reference internal" href="#mollweide-projection-jw-jw">11.4.2. Mollweide projection (<strong>-Jw</strong> <strong>-JW</strong>) <tt class="docutils literal"><span class="pre">...</span></tt></a></li>
-<li><a class="reference internal" href="#winkel-tripel-projection-jr-jr">11.4.3. Winkel Tripel projection (<strong>-Jr</strong> <strong>-JR</strong>) <tt class="docutils literal"><span class="pre">...</span></tt></a></li>
-<li><a class="reference internal" href="#robinson-projection-jn-jn">11.4.4. Robinson projection (<strong>-Jn</strong> <strong>-JN</strong>) <tt class="docutils literal"><span class="pre">...</span></tt></a></li>
-<li><a class="reference internal" href="#eckert-iv-and-vi-projection-jk-jk">11.4.5. Eckert IV and VI projection (<strong>-Jk</strong> <strong>-JK</strong>) <tt class="docutils literal"><span class="pre">...</span></tt></a></li>
-<li><a class="reference internal" href="#sinusoidal-projection-ji-ji">11.4.6. Sinusoidal projection (<strong>-Ji</strong> <strong>-JI</strong>) <tt class="docutils literal"><span class="pre">...</span></tt></a></li>
-<li><a class="reference internal" href="#van-der-grinten-projection-jv-jv">11.4.7. Van der Grinten projection (<strong>-Jv</strong> <strong>-JV</strong>) <tt class="docutils literal"><span class="pre">...</span></tt></a></li>
-</ul>
-</li>
-</ul>
-</li>
-<li><a class="reference internal" href="#creating-gmt-graphics">12. Creating GMT Graphics</a><ul class="simple">
-</ul>
-</li>
-<li><a class="reference internal" href="#creating-gmt-animations">13. Creating GMT Animations</a><ul class="simple">
-</ul>
-</li>
-<li><a class="reference internal" href="#a-gmt-supplemental-packages">14. A. GMT Supplemental Packages</a><ul>
-<li><a class="reference internal" href="#gshhg-gshhg-data-extractor">14.1. gshhg: GSHHG data extractor</a></li>
-<li><a class="reference internal" href="#img-gridded-altimetry-extractor">14.2. img: gridded altimetry extractor</a></li>
-<li><a class="reference internal" href="#meca-seismology-and-geodesy-symbols">14.3. meca: seismology and geodesy symbols</a></li>
-<li><a class="reference internal" href="#mgd77-mgd77-extractor-and-plotting-tools">14.4. mgd77: MGD77 extractor and plotting tools</a></li>
-<li><a class="reference internal" href="#misc-miscellaneous-tools">14.5. misc: Miscellaneous tools</a></li>
-<li><a class="reference internal" href="#potential-geopotential-tools">14.6. potential: Geopotential tools</a></li>
-<li><a class="reference internal" href="#segyprogs-plotting-segy-seismic-data">14.7. segyprogs: plotting SEGY seismic data</a></li>
-<li><a class="reference internal" href="#spotter-backtracking-and-hotspotting">14.8. spotter: backtracking and hotspotting</a></li>
-<li><a class="reference internal" href="#x2sys-track-crossover-error-estimation">14.9. x2sys: track crossover error estimation</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#b-gmt-file-formats">15. B. GMT File Formats</a><ul>
-<li><a class="reference internal" href="#table-data">15.1. Table data</a><ul>
-<li><a class="reference internal" href="#ascii-tables">15.1.1. ASCII tables</a></li>
-<li><a class="reference internal" href="#binary-tables">15.1.2. Binary tables</a></li>
-<li><a class="reference internal" href="#netcdf-tables">15.1.3. NetCDF tables</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#grid-files">15.2. Grid files</a><ul>
-<li><a class="reference internal" href="#netcdf-files">15.2.1. NetCDF files</a></li>
-<li><a class="reference internal" href="#chunking-and-compression-with-netcdf">15.2.2. Chunking and compression with netCDF</a></li>
-<li><a class="reference internal" href="#gridline-and-pixel-node-registration">15.2.3. Gridline and Pixel node registration</a></li>
-<li><a class="reference internal" href="#boundary-conditions-for-operations-on-grids">15.2.4. Boundary Conditions for operations on grids</a></li>
-<li><a class="reference internal" href="#native-binary-grid-files">15.2.5. Native binary grid files</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#sun-raster-files">15.3. Sun raster files</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#c-including-gmt-graphics-into-your-documents">16. C. Including GMT Graphics into your Documents</a><ul>
-<li><a class="reference internal" href="#making-gmt-encapsulated-postscript-files">16.1. Making GMT Encapsulated PostScript Files</a></li>
-<li><a class="reference internal" href="#converting-gmt-postscript-to-pdf-or-raster-images">16.2. Converting GMT PostScript to PDF or raster images</a><ul>
-<li><a class="reference internal" href="#when-converting-or-viewing-postscript-goes-awry">16.2.1. When converting or viewing PostScript goes awry</a></li>
-<li><a class="reference internal" href="#using-ps2raster">16.2.2. Using <tt class="docutils literal"><span class="pre">ps2raster</span></tt></a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#examples">16.3. Examples</a><ul>
-<li><a class="reference internal" href="#gmt-graphics-in-latex">16.3.1. GMT graphics in LaTeX</a></li>
-<li><a class="reference internal" href="#gmt-graphics-in-powerpoint">16.3.2. GMT graphics in <strong>PowerPoint</strong></a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#concluding-remarks">16.4. Concluding remarks</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#e-predefined-bit-and-hachure-patterns-in-gmt">17. E. Predefined Bit and Hachure Patterns in GMT</a></li>
-<li><a class="reference internal" href="#f-chart-of-octal-codes-for-characters">18. F. Chart of Octal Codes for Characters</a></li>
-<li><a class="reference internal" href="#g-postscript-fonts-used-by-gmt">19. G. PostScript Fonts Used by GMT</a><ul>
-<li><a class="reference internal" href="#using-non-default-fonts-with-gmt">19.1. Using non-default fonts with GMT</a><ul>
-<li><a class="reference internal" href="#embedding-fonts-in-postscript-and-pdf">19.1.1. Embedding fonts in PostScript and PDF</a></li>
-<li><a class="reference internal" href="#character-encoding">19.1.2. Character encoding</a></li>
-</ul>
-</li>
-</ul>
-</li>
-<li><a class="reference internal" href="#h-color-space-the-final-frontier">20. H. Color Space: The Final Frontier</a><ul>
-<li><a class="reference internal" href="#rgb-color-system">20.1. RGB color system</a></li>
-<li><a class="reference internal" href="#hsv-color-system">20.2. HSV color system</a></li>
-<li><a class="reference internal" href="#the-color-cube">20.3. The color cube</a></li>
-<li><a class="reference internal" href="#color-interpolation">20.4. Color interpolation</a></li>
-<li><a class="reference internal" href="#artificial-illumination">20.5. Artificial illumination</a></li>
-<li><a class="reference internal" href="#thinking-in-rgb-or-hsv">20.6. Thinking in RGB or HSV</a></li>
-<li><a class="reference internal" href="#cmyk-color-system">20.7. CMYK color system</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#i-filtering-of-data-in-gmt">21. I. Filtering of Data in GMT</a></li>
-<li><a class="reference internal" href="#j-the-gmt-high-resolution-coastline-data">22. J. The GMT High-Resolution Coastline Data</a><ul>
-<li><a class="reference internal" href="#selecting-the-right-data">22.1. Selecting the right data</a></li>
-<li><a class="reference internal" href="#format-required-by-gmt">22.2. Format required by GMT</a></li>
-<li><a class="reference internal" href="#the-long-and-winding-road">22.3. The long and winding road</a></li>
-<li><a class="reference internal" href="#the-five-resolutions">22.4. The Five Resolutions</a><ul>
-<li><a class="reference internal" href="#the-crude-resolution-dc">22.4.1. The crude resolution (<strong>-Dc</strong>)</a></li>
-<li><a class="reference internal" href="#the-low-resolution-dl">22.4.2. The low resolution (<strong>-Dl</strong>)</a></li>
-<li><a class="reference internal" href="#the-intermediate-resolution-di">22.4.3. The intermediate resolution (<strong>-Di</strong>)</a></li>
-<li><a class="reference internal" href="#the-high-resolution-dh">22.4.4. The high resolution (<strong>-Dh</strong>)</a></li>
-<li><a class="reference internal" href="#the-full-resolution-df">22.4.5. The full resolution (<strong>-Df</strong>)</a></li>
-</ul>
-</li>
-</ul>
-</li>
-<li><a class="reference internal" href="#k-gmt-on-non-unix-platforms">23. K. GMT on non-UNIX Platforms</a><ul>
-<li><a class="reference internal" href="#id42">23.1. Introduction</a></li>
-<li><a class="reference internal" href="#cygwin-and-gmt">23.2. Cygwin and GMT</a></li>
-<li><a class="reference internal" href="#mingw-msys-and-gmt">23.3. MINGW|MSYS and GMT</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#l-of-colors-and-color-legends">24. L. Of Colors and Color Legends</a><ul>
-<li><a class="reference internal" href="#built-in-color-palette-tables">24.1. Built-in color palette tables</a></li>
-<li><a class="reference internal" href="#labeled-and-non-equidistant-color-legends">24.2. Labeled and non-equidistant color legends</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#m-custom-plot-symbols">25. M. Custom Plot Symbols</a><ul>
-<li><a class="reference internal" href="#background">25.1. Background</a></li>
-<li><a class="reference internal" href="#the-macro-language">25.2. The macro language</a><ul>
-<li><a class="reference internal" href="#comment-lines">25.2.1. Comment lines</a></li>
-<li><a class="reference internal" href="#symbol-variables">25.2.2. Symbol variables</a></li>
-<li><a class="reference internal" href="#macro-commands">25.2.3. Macro commands</a></li>
-<li><a class="reference internal" href="#text-substitution">25.2.4. Text substitution</a></li>
-<li><a class="reference internal" href="#text-alignment-and-font-attributes">25.2.5. Text alignment and font attributes</a></li>
-<li><a class="reference internal" href="#conditional-statements">25.2.6. Conditional statements</a></li>
-</ul>
-</li>
-</ul>
-</li>
-<li><a class="reference internal" href="#n-annotation-of-contours-and-quoted-lines">26. N. Annotation of Contours and “Quoted Lines”</a><ul>
-<li><a class="reference internal" href="#label-placement">26.1. Label Placement</a></li>
-<li><a class="reference internal" href="#label-attributes">26.2. Label Attributes</a></li>
-<li><a class="reference internal" href="#examples-of-contour-label-placement">26.3. Examples of Contour Label Placement</a><ul>
-<li><a class="reference internal" href="#equidistant-labels">26.3.1. Equidistant labels</a></li>
-<li><a class="reference internal" href="#fixed-number-of-labels">26.3.2. Fixed number of labels</a></li>
-<li><a class="reference internal" href="#prescribed-label-placements">26.3.3. Prescribed label placements</a></li>
-<li><a class="reference internal" href="#label-placement-at-simple-line-intersections">26.3.4. Label placement at simple line intersections</a></li>
-<li><a class="reference internal" href="#label-placement-at-general-line-intersections">26.3.5. Label placement at general line intersections</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#examples-of-label-attributes">26.4. Examples of Label Attributes</a><ul>
-<li><a class="reference internal" href="#label-placement-by-along-track-distances-1">26.4.1. Label placement by along-track distances, 1</a></li>
-<li><a class="reference internal" href="#label-placement-by-along-track-distances-2">26.4.2. Label placement by along-track distances, 2</a></li>
-<li><a class="reference internal" href="#using-a-different-data-set-for-labels">26.4.3. Using a different data set for labels</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#putting-it-all-together">26.5. Putting it all together</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#o-special-operations">27. O. Special Operations</a><ul>
-<li><a class="reference internal" href="#running-gmt-in-isolation-mode">27.1. Running GMT in <em>isolation mode</em></a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#p-the-gmt-vector-data-format-for-ogr-compatibility">28. P. The GMT Vector Data Format for OGR Compatibility</a><ul>
-<li><a class="reference internal" href="#id46">28.1. Background</a></li>
-<li><a class="reference internal" href="#the-ogr-gmt-format">28.2. The OGR/GMT format</a></li>
-<li><a class="reference internal" href="#ogr-gmt-metadata">28.3. OGR/GMT Metadata</a><ul>
-<li><a class="reference internal" href="#format-version">28.3.1. Format version</a></li>
-<li><a class="reference internal" href="#geometry-types">28.3.2. Geometry types</a></li>
-<li><a class="reference internal" href="#domain-and-map-projections">28.3.3. Domain and map projections</a></li>
-<li><a class="reference internal" href="#declaration-of-aspatial-fields">28.3.4. Declaration of aspatial fields</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#ogr-gmt-data">28.4. OGR/GMT Data</a><ul>
-<li><a class="reference internal" href="#embedding-aspatial-data">28.4.1. Embedding aspatial data</a></li>
-<li><a class="reference internal" href="#polygon-topologies">28.4.2. Polygon topologies</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#id47">28.5. Examples</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="cookbook.html"
- title="previous chapter">CookBook</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="api.html"
- title="next chapter">GMT_API</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/GMT_Docs.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="api.html" title="GMT_API"
- >next</a> </li>
- <li class="right" >
- <a href="cookbook.html" title="CookBook"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="cookbook.html" >CookBook</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/GR.html b/doc_release/html/GR.html
deleted file mode 100644
index 212eafd..0000000
--- a/doc_release/html/GR.html
+++ /dev/null
@@ -1,171 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>GR — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="next" title="greenspline" href="greenspline.html" />
- <link rel="prev" title="gmtwhich" href="gmtwhich.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="greenspline.html" title="greenspline"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="gmtwhich.html" title="gmtwhich"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gr">
-<h1>GR<a class="headerlink" href="#gr" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="greenspline.html">greenspline</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grd2cpt.html">grd2cpt</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grd2rgb.html">grd2rgb</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grd2xyz.html">grd2xyz</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdblend.html">grdblend</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdclip.html">grdclip</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdcontour.html">grdcontour</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdcut.html">grdcut</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdedit.html">grdedit</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdfft.html">grdfft</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdfilter.html">grdfilter</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdgradient.html">grdgradient</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdhisteq.html">grdhisteq</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdimage.html">grdimage</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdinfo.html">grdinfo</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdlandmask.html">grdlandmask</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdmask.html">grdmask</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdmath.html">grdmath</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdpaste.html">grdpaste</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdproject.html">grdproject</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdraster.html">grdraster</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdreformat.html">grdreformat</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdsample.html">grdsample</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdtrack.html">grdtrack</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdtrend.html">grdtrend</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdvector.html">grdvector</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdview.html">grdview</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdvolume.html">grdvolume</a></li>
-</ul>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="gmtwhich.html"
- title="previous chapter">gmtwhich</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="greenspline.html"
- title="next chapter">greenspline</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/GR.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="greenspline.html" title="greenspline"
- >next</a> </li>
- <li class="right" >
- <a href="gmtwhich.html" title="gmtwhich"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/Gallery.html b/doc_release/html/Gallery.html
deleted file mode 100644
index 9f289c7..0000000
--- a/doc_release/html/Gallery.html
+++ /dev/null
@@ -1,354 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>The GMT historical collection — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="next" title="(1) Contour maps" href="gallery/ex01.html" />
- <link rel="prev" title="x2sys_solve" href="supplements/x2sys/x2sys_solve.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="gallery/ex01.html" title="(1) Contour maps"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="supplements/x2sys/x2sys_solve.html" title="x2sys_solve"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="the-gmt-historical-collection">
-<span id="example-gallery"></span><h1>The GMT historical collection<a class="headerlink" href="#the-gmt-historical-collection" title="Permalink to this headline">¶</a></h1>
-<div class="section" id="the-40-examples">
-<h2>The 40 Examples<a class="headerlink" href="#the-40-examples" title="Permalink to this headline">¶</a></h2>
-<p>In this section we will be giving numerous examples of typical usage of
-GMT programs. In general, we will start with a raw data set,
-manipulate the numbers in various ways, then display the results in
-diagram or map view. The resulting plots will have in common that they
-are all made up of simpler plots that have been overlaid to create a
-complex illustration.</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="31%" />
-<col width="34%" />
-<col width="36%" />
-</colgroup>
-<tbody valign="top">
-<tr class="row-odd"><td><p class="first"><a class="reference internal" href="gallery/ex01.html#example-01"><em>(1) Contour maps</em></a></p>
-<blockquote class="last">
-<div><a class="reference internal" href="_images/example_01.png"><img alt="ex01" src="_images/example_01.png" style="width: 150px;" /></a></div></blockquote>
-</td>
-<td><p class="first"><a class="reference internal" href="gallery/ex02.html#example-02"><em>(2) Image presentations</em></a></p>
-<p class="last"><a class="reference internal" href="_images/example_02.png"><img alt="ex02" src="_images/example_02.png" style="width: 150px;" /></a></p>
-</td>
-<td><p class="first"><a class="reference internal" href="gallery/ex03.html#example-03"><em>(3) Spectral estimation and xy-plots</em></a></p>
-<p class="last"><a class="reference internal" href="_images/example_03.png"><img alt="ex03" src="_images/example_03.png" style="width: 150px;" /></a></p>
-</td>
-</tr>
-<tr class="row-even"><td><p class="first"><a class="reference internal" href="gallery/ex04.html#example-04"><em>(4) A 3-D perspective mesh plot</em></a></p>
-<blockquote class="last">
-<div><a class="reference internal" href="_images/example_04.png"><img alt="ex04" src="_images/example_04.png" style="width: 150px;" /></a></div></blockquote>
-</td>
-<td><p class="first"><a class="reference internal" href="gallery/ex05.html#example-05"><em>(5) A 3-D illuminated surface (in bw)</em></a></p>
-<p class="last"><a class="reference internal" href="_images/example_05.png"><img alt="ex05" src="_images/example_05.png" style="width: 150px;" /></a></p>
-</td>
-<td><p class="first"><a class="reference internal" href="gallery/ex06.html#example-06"><em>(6) Plotting of histograms</em></a></p>
-<p class="last"><a class="reference internal" href="_images/example_06.png"><img alt="ex06" src="_images/example_06.png" style="width: 150px;" /></a></p>
-</td>
-</tr>
-<tr class="row-odd"><td><p class="first"><a class="reference internal" href="gallery/ex07.html#example-07"><em>(7) A simple location map</em></a></p>
-<blockquote class="last">
-<div><a class="reference internal" href="_images/example_07.png"><img alt="ex07" src="_images/example_07.png" style="width: 150px;" /></a></div></blockquote>
-</td>
-<td><p class="first"><a class="reference internal" href="gallery/ex08.html#example-08"><em>(8) A 3-D histogram</em></a></p>
-<p class="last"><a class="reference internal" href="_images/example_08.png"><img alt="ex08" src="_images/example_08.png" style="width: 150px;" /></a></p>
-</td>
-<td><p class="first"><a class="reference internal" href="gallery/ex09.html#example-09"><em>(9) Time-series along tracks</em></a></p>
-<p class="last"><a class="reference internal" href="_images/example_09.png"><img alt="ex09" src="_images/example_09.png" style="width: 150px;" /></a></p>
-</td>
-</tr>
-<tr class="row-even"><td><p class="first"><a class="reference internal" href="gallery/ex10.html#example-10"><em>(10) A geographical bar graph plot</em></a></p>
-<blockquote class="last">
-<div><a class="reference internal" href="_images/example_10.png"><img alt="ex10" src="_images/example_10.png" style="width: 150px;" /></a></div></blockquote>
-</td>
-<td><p class="first"><a class="reference internal" href="gallery/ex11.html#example-11"><em>(11) A 3-D RGB color cube</em></a></p>
-<p class="last"><a class="reference internal" href="_images/example_11.png"><img alt="ex11" src="_images/example_11.png" style="width: 150px;" /></a></p>
-</td>
-<td><p class="first"><a class="reference internal" href="gallery/ex12.html#example-12"><em>(12) Optimal triangulation of data</em></a></p>
-<p class="last"><a class="reference internal" href="_images/example_12.png"><img alt="ex12" src="_images/example_12.png" style="width: 150px;" /></a></p>
-</td>
-</tr>
-<tr class="row-odd"><td><p class="first"><a class="reference internal" href="gallery/ex13.html#example-13"><em>(13) Plotting of vector fields</em></a></p>
-<blockquote class="last">
-<div><a class="reference internal" href="_images/example_13.png"><img alt="ex13" src="_images/example_13.png" style="width: 150px;" /></a></div></blockquote>
-</td>
-<td><p class="first"><a class="reference internal" href="gallery/ex14.html#example-14"><em>(14) Gridding of data and trend surfaces</em></a></p>
-<p class="last"><a class="reference internal" href="_images/example_14.png"><img alt="ex14" src="_images/example_14.png" style="width: 150px;" /></a></p>
-</td>
-<td><p class="first"><a class="reference internal" href="gallery/ex15.html#example-15"><em>(15) Gridding, contouring, and masking of unconstrained areas</em></a></p>
-<p class="last"><a class="reference internal" href="_images/example_15.png"><img alt="ex15" src="_images/example_15.png" style="width: 150px;" /></a></p>
-</td>
-</tr>
-<tr class="row-even"><td><p class="first"><a class="reference internal" href="gallery/ex16.html#example-16"><em>(16) Gridding of data, continued</em></a></p>
-<blockquote class="last">
-<div><a class="reference internal" href="_images/example_16.png"><img alt="ex16" src="_images/example_16.png" style="width: 150px;" /></a></div></blockquote>
-</td>
-<td><p class="first"><a class="reference internal" href="gallery/ex17.html#example-17"><em>(17) Images clipped by coastlines</em></a></p>
-<p class="last"><a class="reference internal" href="_images/example_17.png"><img alt="ex17" src="_images/example_17.png" style="width: 150px;" /></a></p>
-</td>
-<td><p class="first"><a class="reference internal" href="gallery/ex18.html#example-18"><em>(18) Volumes and Spatial Selections</em></a></p>
-<p class="last"><a class="reference internal" href="_images/example_18.png"><img alt="ex18" src="_images/example_18.png" style="width: 150px;" /></a></p>
-</td>
-</tr>
-<tr class="row-odd"><td><p class="first"><a class="reference internal" href="gallery/ex19.html#example-19"><em>(19) Color patterns on maps</em></a></p>
-<blockquote class="last">
-<div><a class="reference internal" href="_images/example_19.png"><img alt="ex19" src="_images/example_19.png" style="width: 150px;" /></a></div></blockquote>
-</td>
-<td><p class="first"><a class="reference internal" href="gallery/ex20.html#example-20"><em>(20) Custom plot symbols</em></a></p>
-<p class="last"><a class="reference internal" href="_images/example_20.png"><img alt="ex20" src="_images/example_20.png" style="width: 150px;" /></a></p>
-</td>
-<td><p class="first"><a class="reference internal" href="gallery/ex21.html#example-21"><em>(21) Time-series of RedHat stock price</em></a></p>
-<p class="last"><a class="reference internal" href="_images/example_21.png"><img alt="ex21" src="_images/example_21.png" style="width: 150px;" /></a></p>
-</td>
-</tr>
-<tr class="row-even"><td><p class="first"><a class="reference internal" href="gallery/ex22.html#example-22"><em>(22) World-wide seismicity the last 7 days</em></a></p>
-<blockquote class="last">
-<div><a class="reference internal" href="_images/example_22.png"><img alt="ex22" src="_images/example_22.png" style="width: 150px;" /></a></div></blockquote>
-</td>
-<td><p class="first"><a class="reference internal" href="gallery/ex23.html#example-23"><em>(23) All great-circle paths lead to Rome</em></a></p>
-<p class="last"><a class="reference internal" href="_images/example_23.png"><img alt="ex23" src="_images/example_23.png" style="width: 150px;" /></a></p>
-</td>
-<td><p class="first"><a class="reference internal" href="gallery/ex24.html#example-24"><em>(24) Data selection based on geospatial criteria</em></a></p>
-<p class="last"><a class="reference internal" href="_images/example_24.png"><img alt="ex24" src="_images/example_24.png" style="width: 150px;" /></a></p>
-</td>
-</tr>
-<tr class="row-odd"><td><p class="first"><a class="reference internal" href="gallery/ex25.html#example-25"><em>(25) Global distribution of antipodes</em></a></p>
-<blockquote class="last">
-<div><a class="reference internal" href="_images/example_25.png"><img alt="ex25" src="_images/example_25.png" style="width: 150px;" /></a></div></blockquote>
-</td>
-<td><p class="first"><a class="reference internal" href="gallery/ex26.html#example-26"><em>(26) General vertical perspective projection</em></a></p>
-<p class="last"><a class="reference internal" href="_images/example_26.png"><img alt="ex26" src="_images/example_26.png" style="width: 150px;" /></a></p>
-</td>
-<td><p class="first"><a class="reference internal" href="gallery/ex27.html#example-27"><em>(27) Plotting Sandwell/Smith Mercator img grids</em></a></p>
-<p class="last"><a class="reference internal" href="_images/example_27.png"><img alt="ex27" src="_images/example_27.png" style="width: 150px;" /></a></p>
-</td>
-</tr>
-<tr class="row-even"><td><p class="first"><a class="reference internal" href="gallery/ex28.html#example-28"><em>(28) Mixing UTM and geographic data sets</em></a></p>
-<blockquote class="last">
-<div><a class="reference internal" href="_images/example_28.png"><img alt="ex28" src="_images/example_28.png" style="width: 150px;" /></a></div></blockquote>
-</td>
-<td><p class="first"><a class="reference internal" href="gallery/ex29.html#example-29"><em>(29) Gridding spherical surface data using splines</em></a></p>
-<p class="last"><a class="reference internal" href="_images/example_29.png"><img alt="ex29" src="_images/example_29.png" style="width: 150px;" /></a></p>
-</td>
-<td><p class="first"><a class="reference internal" href="gallery/ex30.html#example-30"><em>(30) Trigonometric functions plotted in graph mode</em></a></p>
-<p class="last"><a class="reference internal" href="_images/example_30.png"><img alt="ex30" src="_images/example_30.png" style="width: 150px;" /></a></p>
-</td>
-</tr>
-<tr class="row-odd"><td><p class="first"><a class="reference internal" href="gallery/ex31.html#example-31"><em>(31) Using non-default fonts in PostScript</em></a></p>
-<blockquote class="last">
-<div><a class="reference internal" href="_images/example_31.png"><img alt="ex31" src="_images/example_31.png" style="width: 150px;" /></a></div></blockquote>
-</td>
-<td><p class="first"><a class="reference internal" href="gallery/ex32.html#example-32"><em>(32) Draping an image over topography</em></a></p>
-<p class="last"><a class="reference internal" href="_images/example_32.png"><img alt="ex32" src="_images/example_32.png" style="width: 150px;" /></a></p>
-</td>
-<td><p class="first"><a class="reference internal" href="gallery/ex33.html#example-33"><em>(33) Stacking automatically generated cross-profiles</em></a></p>
-<p class="last"><a class="reference internal" href="_images/example_33.png"><img alt="ex33" src="_images/example_33.png" style="width: 150px;" /></a></p>
-</td>
-</tr>
-<tr class="row-even"><td><p class="first"><a class="reference internal" href="gallery/ex34.html#example-34"><em>(34) Using country polygons for plotting and shading</em></a></p>
-<blockquote class="last">
-<div><a class="reference internal" href="_images/example_34.png"><img alt="ex34" src="_images/example_34.png" style="width: 150px;" /></a></div></blockquote>
-</td>
-<td><p class="first"><a class="reference internal" href="gallery/ex35.html#example-35"><em>(35) Spherical triangulation and distance calculations</em></a></p>
-<p class="last"><a class="reference internal" href="_images/example_35.png"><img alt="ex35" src="_images/example_35.png" style="width: 150px;" /></a></p>
-</td>
-<td><p class="first"><a class="reference internal" href="gallery/ex36.html#example-36"><em>(36) Spherical gridding using Renka’s algorithms</em></a></p>
-<p class="last"><a class="reference internal" href="_images/example_36.png"><img alt="ex36" src="_images/example_36.png" style="width: 150px;" /></a></p>
-</td>
-</tr>
-<tr class="row-odd"><td><p class="first"><a class="reference internal" href="gallery/ex37.html#example-37"><em>(37) Spectral coherence between gravity and bathymetry grids</em></a></p>
-<blockquote class="last">
-<div><a class="reference internal" href="_images/example_37.png"><img alt="ex37" src="_images/example_37.png" style="width: 150px;" /></a></div></blockquote>
-</td>
-<td><p class="first"><a class="reference internal" href="gallery/ex38.html#example-38"><em>(38) Histogram equalization of bathymetry grids</em></a></p>
-<p class="last"><a class="reference internal" href="_images/example_38.png"><img alt="ex38" src="_images/example_38.png" style="width: 150px;" /></a></p>
-</td>
-<td><p class="first"><a class="reference internal" href="gallery/ex39.html#example-39"><em>(39) Evaluation of spherical harmonics coefficients</em></a></p>
-<p class="last"><a class="reference internal" href="_images/example_39.png"><img alt="ex39" src="_images/example_39.png" style="width: 150px;" /></a></p>
-</td>
-</tr>
-<tr class="row-even"><td><p class="first"><a class="reference internal" href="gallery/ex40.html#example-40"><em>(40) Line simplification</em></a></p>
-<blockquote class="last">
-<div><a class="reference internal" href="_images/example_40.png"><img alt="ex40" src="_images/example_40.png" style="width: 150px;" /></a></div></blockquote>
-</td>
-<td> </td>
-<td> </td>
-</tr>
-</tbody>
-</table>
-<div class="toctree-wrapper compound">
-</div>
-</div>
-<div class="section" id="animations">
-<h2>Animations<a class="headerlink" href="#animations" title="Permalink to this headline">¶</a></h2>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="gallery/anim_introduction.html">Introduction</a></li>
-</ul>
-</div>
-<table border="1" class="docutils">
-<colgroup>
-<col width="53%" />
-<col width="47%" />
-</colgroup>
-<tbody valign="top">
-<tr class="row-odd"><td><p class="first"><a class="reference internal" href="gallery/anim01.html#anim-01"><em>(1) Animation of the sine function</em></a></p>
-<blockquote class="last">
-<div><a class="reference internal" href="_images/anim_01.png"><img alt="anim01" src="_images/anim_01.png" style="width: 150px;" /></a></div></blockquote>
-</td>
-<td><p class="first"><a class="reference internal" href="gallery/anim02.html#anim-02"><em>(2) Examining DEMs using variable illumination</em></a></p>
-<p class="last"><a class="reference internal" href="_images/anim_02.png"><img alt="anim02" src="_images/anim_02.png" style="width: 150px;" /></a></p>
-</td>
-</tr>
-<tr class="row-even"><td><p class="first"><a class="reference internal" href="gallery/anim03.html#anim-03"><em>(3) Orbiting a static map</em></a></p>
-<blockquote class="last">
-<div><a class="reference internal" href="_images/anim_03.png"><img alt="anim03" src="_images/anim_03.png" style="width: 150px;" /></a></div></blockquote>
-</td>
-<td><p class="first"><a class="reference internal" href="gallery/anim04.html#anim-04"><em>(4) Flying over topography</em></a></p>
-<p class="last"><a class="reference internal" href="_images/anim_04.png"><img alt="anim04" src="_images/anim_04.png" style="width: 150px;" /></a></p>
-</td>
-</tr>
-</tbody>
-</table>
-<div class="toctree-wrapper compound">
-</div>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">The GMT historical collection</a><ul>
-<li><a class="reference internal" href="#the-40-examples">The 40 Examples</a></li>
-<li><a class="reference internal" href="#animations">Animations</a><ul>
-</ul>
-</li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="supplements/x2sys/x2sys_solve.html"
- title="previous chapter">x2sys_solve</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="gallery/ex01.html"
- title="next chapter">(1) Contour maps</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/Gallery.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="gallery/ex01.html" title="(1) Contour maps"
- >next</a> </li>
- <li class="right" >
- <a href="supplements/x2sys/x2sys_solve.html" title="x2sys_solve"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/I.html b/doc_release/html/I.html
deleted file mode 100644
index 7704211..0000000
--- a/doc_release/html/I.html
+++ /dev/null
@@ -1,144 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>I — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="next" title="isogmt" href="isogmt.html" />
- <link rel="prev" title="grdvolume" href="grdvolume.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="isogmt.html" title="isogmt"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grdvolume.html" title="grdvolume"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="i">
-<h1>I<a class="headerlink" href="#i" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="isogmt.html">isogmt</a></li>
-</ul>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="grdvolume.html"
- title="previous chapter">grdvolume</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="isogmt.html"
- title="next chapter">isogmt</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/I.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="isogmt.html" title="isogmt"
- >next</a> </li>
- <li class="right" >
- <a href="grdvolume.html" title="grdvolume"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/K.html b/doc_release/html/K.html
deleted file mode 100644
index a6c0d46..0000000
--- a/doc_release/html/K.html
+++ /dev/null
@@ -1,144 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>K — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="next" title="kml2gmt" href="kml2gmt.html" />
- <link rel="prev" title="isogmt" href="isogmt.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="kml2gmt.html" title="kml2gmt"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="isogmt.html" title="isogmt"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="k">
-<h1>K<a class="headerlink" href="#k" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="kml2gmt.html">kml2gmt</a></li>
-</ul>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="isogmt.html"
- title="previous chapter">isogmt</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="kml2gmt.html"
- title="next chapter">kml2gmt</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/K.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="kml2gmt.html" title="kml2gmt"
- >next</a> </li>
- <li class="right" >
- <a href="isogmt.html" title="isogmt"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/M.html b/doc_release/html/M.html
deleted file mode 100644
index 079f085..0000000
--- a/doc_release/html/M.html
+++ /dev/null
@@ -1,145 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>M — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="next" title="makecpt" href="makecpt.html" />
- <link rel="prev" title="kml2gmt" href="kml2gmt.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="makecpt.html" title="makecpt"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="kml2gmt.html" title="kml2gmt"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="m">
-<h1>M<a class="headerlink" href="#m" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="makecpt.html">makecpt</a></li>
-<li class="toctree-l1"><a class="reference internal" href="mapproject.html">mapproject</a></li>
-</ul>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="kml2gmt.html"
- title="previous chapter">kml2gmt</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="makecpt.html"
- title="next chapter">makecpt</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/M.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="makecpt.html" title="makecpt"
- >next</a> </li>
- <li class="right" >
- <a href="kml2gmt.html" title="kml2gmt"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/N.html b/doc_release/html/N.html
deleted file mode 100644
index 7dde0dd..0000000
--- a/doc_release/html/N.html
+++ /dev/null
@@ -1,144 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>N — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="next" title="nearneighbor" href="nearneighbor.html" />
- <link rel="prev" title="mapproject" href="mapproject.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="nearneighbor.html" title="nearneighbor"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="mapproject.html" title="mapproject"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="n">
-<h1>N<a class="headerlink" href="#n" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="nearneighbor.html">nearneighbor</a></li>
-</ul>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="mapproject.html"
- title="previous chapter">mapproject</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="nearneighbor.html"
- title="next chapter">nearneighbor</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/N.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="nearneighbor.html" title="nearneighbor"
- >next</a> </li>
- <li class="right" >
- <a href="mapproject.html" title="mapproject"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/P.html b/doc_release/html/P.html
deleted file mode 100644
index a4883a6..0000000
--- a/doc_release/html/P.html
+++ /dev/null
@@ -1,144 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>P — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="next" title="project" href="project.html" />
- <link rel="prev" title="nearneighbor" href="nearneighbor.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="project.html" title="project"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="nearneighbor.html" title="nearneighbor"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="p">
-<h1>P<a class="headerlink" href="#p" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="project.html">project</a></li>
-</ul>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="nearneighbor.html"
- title="previous chapter">nearneighbor</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="project.html"
- title="next chapter">project</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/P.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="project.html" title="project"
- >next</a> </li>
- <li class="right" >
- <a href="nearneighbor.html" title="nearneighbor"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/PS.html b/doc_release/html/PS.html
deleted file mode 100644
index 7827f53..0000000
--- a/doc_release/html/PS.html
+++ /dev/null
@@ -1,159 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>PS — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="next" title="ps2raster" href="ps2raster.html" />
- <link rel="prev" title="project" href="project.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ps2raster.html" title="ps2raster"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="project.html" title="project"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="ps">
-<h1>PS<a class="headerlink" href="#ps" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="ps2raster.html">ps2raster</a></li>
-<li class="toctree-l1"><a class="reference internal" href="psbasemap.html">psbasemap</a></li>
-<li class="toctree-l1"><a class="reference internal" href="psclip.html">psclip</a></li>
-<li class="toctree-l1"><a class="reference internal" href="pscoast.html">pscoast</a></li>
-<li class="toctree-l1"><a class="reference internal" href="pscontour.html">pscontour</a></li>
-<li class="toctree-l1"><a class="reference internal" href="pshistogram.html">pshistogram</a></li>
-<li class="toctree-l1"><a class="reference internal" href="psimage.html">psimage</a></li>
-<li class="toctree-l1"><a class="reference internal" href="pslegend.html">pslegend</a></li>
-<li class="toctree-l1"><a class="reference internal" href="pslib.html">pslib</a></li>
-<li class="toctree-l1"><a class="reference internal" href="psmask.html">psmask</a></li>
-<li class="toctree-l1"><a class="reference internal" href="psrose.html">psrose</a></li>
-<li class="toctree-l1"><a class="reference internal" href="psscale.html">psscale</a></li>
-<li class="toctree-l1"><a class="reference internal" href="pstext.html">pstext</a></li>
-<li class="toctree-l1"><a class="reference internal" href="pswiggle.html">pswiggle</a></li>
-<li class="toctree-l1"><a class="reference internal" href="psxy.html">psxy</a></li>
-<li class="toctree-l1"><a class="reference internal" href="psxyz.html">psxyz</a></li>
-</ul>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="project.html"
- title="previous chapter">project</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ps2raster.html"
- title="next chapter">ps2raster</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/PS.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ps2raster.html" title="ps2raster"
- >next</a> </li>
- <li class="right" >
- <a href="project.html" title="project"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/S.html b/doc_release/html/S.html
deleted file mode 100644
index 21e6bc6..0000000
--- a/doc_release/html/S.html
+++ /dev/null
@@ -1,151 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>S — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="next" title="sample1d" href="sample1d.html" />
- <link rel="prev" title="psxyz" href="psxyz.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="sample1d.html" title="sample1d"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="psxyz.html" title="psxyz"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="s">
-<h1>S<a class="headerlink" href="#s" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="sample1d.html">sample1d</a></li>
-<li class="toctree-l1"><a class="reference internal" href="spectrum1d.html">spectrum1d</a></li>
-<li class="toctree-l1"><a class="reference internal" href="sph2grd.html">sph2grd</a></li>
-<li class="toctree-l1"><a class="reference internal" href="sphdistance.html">sphdistance</a></li>
-<li class="toctree-l1"><a class="reference internal" href="sphinterpolate.html">sphinterpolate</a></li>
-<li class="toctree-l1"><a class="reference internal" href="sphtriangulate.html">sphtriangulate</a></li>
-<li class="toctree-l1"><a class="reference internal" href="splitxyz.html">splitxyz</a></li>
-<li class="toctree-l1"><a class="reference internal" href="surface.html">surface</a></li>
-</ul>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="psxyz.html"
- title="previous chapter">psxyz</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="sample1d.html"
- title="next chapter">sample1d</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/S.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="sample1d.html" title="sample1d"
- >next</a> </li>
- <li class="right" >
- <a href="psxyz.html" title="psxyz"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/SUP_GSHHS.html b/doc_release/html/SUP_GSHHS.html
deleted file mode 100644
index 2e87049..0000000
--- a/doc_release/html/SUP_GSHHS.html
+++ /dev/null
@@ -1,144 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>GSHHG — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="next" title="gshhg" href="supplements/gshhg/gshhg.html" />
- <link rel="prev" title="xyz2grd" href="xyz2grd.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="supplements/gshhg/gshhg.html" title="gshhg"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="xyz2grd.html" title="xyz2grd"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gshhg">
-<h1>GSHHG<a class="headerlink" href="#gshhg" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="supplements/gshhg/gshhg.html">gshhg</a></li>
-</ul>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="xyz2grd.html"
- title="previous chapter">xyz2grd</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="supplements/gshhg/gshhg.html"
- title="next chapter">gshhg</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/SUP_GSHHS.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="supplements/gshhg/gshhg.html" title="gshhg"
- >next</a> </li>
- <li class="right" >
- <a href="xyz2grd.html" title="xyz2grd"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/SUP_IMGSRC.html b/doc_release/html/SUP_IMGSRC.html
deleted file mode 100644
index f318b77..0000000
--- a/doc_release/html/SUP_IMGSRC.html
+++ /dev/null
@@ -1,145 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>IMGSRC — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="next" title="img2grd" href="supplements/img/img2grd.html" />
- <link rel="prev" title="gshhg" href="supplements/gshhg/gshhg.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="supplements/img/img2grd.html" title="img2grd"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="supplements/gshhg/gshhg.html" title="gshhg"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="imgsrc">
-<h1>IMGSRC<a class="headerlink" href="#imgsrc" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="supplements/img/img2grd.html">img2grd</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/img/img2google.html">img2google</a></li>
-</ul>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="supplements/gshhg/gshhg.html"
- title="previous chapter">gshhg</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="supplements/img/img2grd.html"
- title="next chapter">img2grd</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/SUP_IMGSRC.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="supplements/img/img2grd.html" title="img2grd"
- >next</a> </li>
- <li class="right" >
- <a href="supplements/gshhg/gshhg.html" title="gshhg"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/SUP_MECA.html b/doc_release/html/SUP_MECA.html
deleted file mode 100644
index 500c3a7..0000000
--- a/doc_release/html/SUP_MECA.html
+++ /dev/null
@@ -1,147 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>MECA — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="next" title="pscoupe" href="supplements/meca/pscoupe.html" />
- <link rel="prev" title="img2google" href="supplements/img/img2google.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="supplements/meca/pscoupe.html" title="pscoupe"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="supplements/img/img2google.html" title="img2google"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="meca">
-<h1>MECA<a class="headerlink" href="#meca" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="supplements/meca/pscoupe.html">pscoupe</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/meca/psmeca.html">psmeca</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/meca/pspolar.html">pspolar</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/meca/psvelo.html">psvelo</a></li>
-</ul>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="supplements/img/img2google.html"
- title="previous chapter">img2google</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="supplements/meca/pscoupe.html"
- title="next chapter">pscoupe</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/SUP_MECA.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="supplements/meca/pscoupe.html" title="pscoupe"
- >next</a> </li>
- <li class="right" >
- <a href="supplements/img/img2google.html" title="img2google"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/SUP_MGD77.html b/doc_release/html/SUP_MGD77.html
deleted file mode 100644
index 065d6d9..0000000
--- a/doc_release/html/SUP_MGD77.html
+++ /dev/null
@@ -1,151 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>MGD77 — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="next" title="mgd77convert" href="supplements/mgd77/mgd77convert.html" />
- <link rel="prev" title="psvelo" href="supplements/meca/psvelo.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="supplements/mgd77/mgd77convert.html" title="mgd77convert"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="supplements/meca/psvelo.html" title="psvelo"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="mgd77">
-<h1>MGD77<a class="headerlink" href="#mgd77" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="supplements/mgd77/mgd77convert.html">mgd77convert</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/mgd77/mgd77info.html">mgd77info</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/mgd77/mgd77list.html">mgd77list</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/mgd77/mgd77magref.html">mgd77magref</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/mgd77/mgd77manage.html">mgd77manage</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/mgd77/mgd77path.html">mgd77path</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/mgd77/mgd77sniffer.html">mgd77sniffer</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/mgd77/mgd77track.html">mgd77track</a></li>
-</ul>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="supplements/meca/psvelo.html"
- title="previous chapter">psvelo</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="supplements/mgd77/mgd77convert.html"
- title="next chapter">mgd77convert</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/SUP_MGD77.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="supplements/mgd77/mgd77convert.html" title="mgd77convert"
- >next</a> </li>
- <li class="right" >
- <a href="supplements/meca/psvelo.html" title="psvelo"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/SUP_MISC.html b/doc_release/html/SUP_MISC.html
deleted file mode 100644
index 8a29c26..0000000
--- a/doc_release/html/SUP_MISC.html
+++ /dev/null
@@ -1,144 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>MISC — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="next" title="dimfilter" href="supplements/misc/dimfilter.html" />
- <link rel="prev" title="mgd77track" href="supplements/mgd77/mgd77track.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="supplements/misc/dimfilter.html" title="dimfilter"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="supplements/mgd77/mgd77track.html" title="mgd77track"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="misc">
-<h1>MISC<a class="headerlink" href="#misc" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="supplements/misc/dimfilter.html">dimfilter</a></li>
-</ul>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="supplements/mgd77/mgd77track.html"
- title="previous chapter">mgd77track</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="supplements/misc/dimfilter.html"
- title="next chapter">dimfilter</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/SUP_MISC.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="supplements/misc/dimfilter.html" title="dimfilter"
- >next</a> </li>
- <li class="right" >
- <a href="supplements/mgd77/mgd77track.html" title="mgd77track"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/SUP_POTENTIAL.html b/doc_release/html/SUP_POTENTIAL.html
deleted file mode 100644
index e3d4740..0000000
--- a/doc_release/html/SUP_POTENTIAL.html
+++ /dev/null
@@ -1,148 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>POTENTIAL — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="next" title="gmtgravmag3d" href="supplements/potential/gmtgravmag3d.html" />
- <link rel="prev" title="dimfilter" href="supplements/misc/dimfilter.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="supplements/potential/gmtgravmag3d.html" title="gmtgravmag3d"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="supplements/misc/dimfilter.html" title="dimfilter"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="potential">
-<h1>POTENTIAL<a class="headerlink" href="#potential" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="supplements/potential/gmtgravmag3d.html">gmtgravmag3d</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/potential/gravfft.html">gravfft</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/potential/grdgravmag3d.html">grdgravmag3d</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/potential/grdredpol.html">grdredpol</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/potential/grdseamount.html">grdseamount</a></li>
-</ul>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="supplements/misc/dimfilter.html"
- title="previous chapter">dimfilter</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="supplements/potential/gmtgravmag3d.html"
- title="next chapter">gmtgravmag3d</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/SUP_POTENTIAL.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="supplements/potential/gmtgravmag3d.html" title="gmtgravmag3d"
- >next</a> </li>
- <li class="right" >
- <a href="supplements/misc/dimfilter.html" title="dimfilter"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/SUP_SEGY.html b/doc_release/html/SUP_SEGY.html
deleted file mode 100644
index 741547b..0000000
--- a/doc_release/html/SUP_SEGY.html
+++ /dev/null
@@ -1,146 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>SEGY — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="next" title="pssegy" href="supplements/segy/pssegy.html" />
- <link rel="prev" title="grdseamount" href="supplements/potential/grdseamount.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="supplements/segy/pssegy.html" title="pssegy"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="supplements/potential/grdseamount.html" title="grdseamount"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="segy">
-<h1>SEGY<a class="headerlink" href="#segy" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="supplements/segy/pssegy.html">pssegy</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/segy/pssegyz.html">pssegyz</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/segy/segy2grd.html">segy2grd</a></li>
-</ul>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="supplements/potential/grdseamount.html"
- title="previous chapter">grdseamount</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="supplements/segy/pssegy.html"
- title="next chapter">pssegy</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/SUP_SEGY.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="supplements/segy/pssegy.html" title="pssegy"
- >next</a> </li>
- <li class="right" >
- <a href="supplements/potential/grdseamount.html" title="grdseamount"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/SUP_SPOTTER.html b/doc_release/html/SUP_SPOTTER.html
deleted file mode 100644
index 8b4f222..0000000
--- a/doc_release/html/SUP_SPOTTER.html
+++ /dev/null
@@ -1,150 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>SPOTTER — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="next" title="backtracker" href="supplements/spotter/backtracker.html" />
- <link rel="prev" title="segy2grd" href="supplements/segy/segy2grd.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="supplements/spotter/backtracker.html" title="backtracker"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="supplements/segy/segy2grd.html" title="segy2grd"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="spotter">
-<h1>SPOTTER<a class="headerlink" href="#spotter" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="supplements/spotter/backtracker.html">backtracker</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/spotter/grdpmodeler.html">grdpmodeler</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/spotter/grdrotater.html">grdrotater</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/spotter/grdspotter.html">grdspotter</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/spotter/hotspotter.html">hotspotter</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/spotter/originator.html">originator</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/spotter/rotconverter.html">rotconverter</a></li>
-</ul>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="supplements/segy/segy2grd.html"
- title="previous chapter">segy2grd</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="supplements/spotter/backtracker.html"
- title="next chapter">backtracker</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/SUP_SPOTTER.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="supplements/spotter/backtracker.html" title="backtracker"
- >next</a> </li>
- <li class="right" >
- <a href="supplements/segy/segy2grd.html" title="segy2grd"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/SUP_X2SYS.html b/doc_release/html/SUP_X2SYS.html
deleted file mode 100644
index 9759bae..0000000
--- a/doc_release/html/SUP_X2SYS.html
+++ /dev/null
@@ -1,153 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>X2SYS — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="next" title="x2sys_binlist" href="supplements/x2sys/x2sys_binlist.html" />
- <link rel="prev" title="rotconverter" href="supplements/spotter/rotconverter.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="supplements/x2sys/x2sys_binlist.html" title="x2sys_binlist"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="supplements/spotter/rotconverter.html" title="rotconverter"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="x2sys">
-<h1>X2SYS<a class="headerlink" href="#x2sys" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="supplements/x2sys/x2sys_binlist.html">x2sys_binlist</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/x2sys/x2sys_cross.html">x2sys_cross</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/x2sys/x2sys_datalist.html">x2sys_datalist</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/x2sys/x2sys_get.html">x2sys_get</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/x2sys/x2sys_init.html">x2sys_init</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/x2sys/x2sys_list.html">x2sys_list</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/x2sys/x2sys_merge.html">x2sys_merge</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/x2sys/x2sys_put.html">x2sys_put</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/x2sys/x2sys_report.html">x2sys_report</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/x2sys/x2sys_solve.html">x2sys_solve</a></li>
-</ul>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="supplements/spotter/rotconverter.html"
- title="previous chapter">rotconverter</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="supplements/x2sys/x2sys_binlist.html"
- title="next chapter">x2sys_binlist</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/SUP_X2SYS.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="supplements/x2sys/x2sys_binlist.html" title="x2sys_binlist"
- >next</a> </li>
- <li class="right" >
- <a href="supplements/spotter/rotconverter.html" title="rotconverter"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/T.html b/doc_release/html/T.html
deleted file mode 100644
index 0e72624..0000000
--- a/doc_release/html/T.html
+++ /dev/null
@@ -1,146 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>T — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="next" title="trend1d" href="trend1d.html" />
- <link rel="prev" title="surface" href="surface.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="trend1d.html" title="trend1d"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="surface.html" title="surface"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="t">
-<h1>T<a class="headerlink" href="#t" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="trend1d.html">trend1d</a></li>
-<li class="toctree-l1"><a class="reference internal" href="trend2d.html">trend2d</a></li>
-<li class="toctree-l1"><a class="reference internal" href="triangulate.html">triangulate</a></li>
-</ul>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="surface.html"
- title="previous chapter">surface</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="trend1d.html"
- title="next chapter">trend1d</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/T.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="trend1d.html" title="trend1d"
- >next</a> </li>
- <li class="right" >
- <a href="surface.html" title="surface"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/Users_contrib_script.html b/doc_release/html/Users_contrib_script.html
deleted file mode 100644
index deb0535..0000000
--- a/doc_release/html/Users_contrib_script.html
+++ /dev/null
@@ -1,162 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>Users Script Contributions — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="next" title="A Vertical slice" href="gallery/users_contrib_script/vertical_slice.html" />
- <link rel="prev" title="(4) Flying over topography" href="gallery/anim04.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="gallery/users_contrib_script/vertical_slice.html" title="A Vertical slice"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="gallery/anim04.html" title="(4) Flying over topography"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="users-script-contributions">
-<span id="users-gallery"></span><h1>Users Script Contributions<a class="headerlink" href="#users-script-contributions" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-</div>
-<table border="1" class="docutils">
-<colgroup>
-<col width="13%" />
-<col width="87%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"> </th>
-<th class="head"> </th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td><a class="reference internal" href="_images/vertical_slice.png"><img alt="0001" src="_images/vertical_slice.png" style="width: 150px;" /></a></td>
-<td><dl class="first last docutils">
-<dt><a class="reference internal" href="gallery/users_contrib_script/vertical_slice.html#vertical-slice"><em>A Vertical slice</em></a></dt>
-<dd>A script to plot a vertical slice of a
-function p=f(x, y, z)</dd>
-</dl>
-</td>
-</tr>
-</tbody>
-</table>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="gallery/anim04.html"
- title="previous chapter">(4) Flying over topography</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="gallery/users_contrib_script/vertical_slice.html"
- title="next chapter">A Vertical slice</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/Users_contrib_script.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="gallery/users_contrib_script/vertical_slice.html" title="A Vertical slice"
- >next</a> </li>
- <li class="right" >
- <a href="gallery/anim04.html" title="(4) Flying over topography"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/Users_contrib_symbols.html b/doc_release/html/Users_contrib_symbols.html
deleted file mode 100644
index fc7315d..0000000
--- a/doc_release/html/Users_contrib_symbols.html
+++ /dev/null
@@ -1,154 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>Users Symbol Contributions — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="next" title="A pirate" href="gallery/users_contrib_symbols/pirata.html" />
- <link rel="prev" title="A Vertical slice" href="gallery/users_contrib_script/vertical_slice.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="gallery/users_contrib_symbols/pirata.html" title="A pirate"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="gallery/users_contrib_script/vertical_slice.html" title="A Vertical slice"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="users-symbol-contributions">
-<span id="symbols-gallery"></span><h1>Users Symbol Contributions<a class="headerlink" href="#users-symbol-contributions" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-</div>
-<table border="1" class="docutils">
-<colgroup>
-<col width="52%" />
-<col width="48%" />
-</colgroup>
-<tbody valign="top">
-<tr class="row-odd"><td><p class="first"><a class="reference internal" href="gallery/users_contrib_symbols/pirata.html#pirata"><em>A pirate</em></a></p>
-<p class="last"><a class="reference internal" href="_images/pirata.png"><img alt="0001" src="_images/pirata.png" style="width: 150px;" /></a></p>
-</td>
-<td> </td>
-</tr>
-</tbody>
-</table>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="gallery/users_contrib_script/vertical_slice.html"
- title="previous chapter">A Vertical slice</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="gallery/users_contrib_symbols/pirata.html"
- title="next chapter">A pirate</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/Users_contrib_symbols.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="gallery/users_contrib_symbols/pirata.html" title="A pirate"
- >next</a> </li>
- <li class="right" >
- <a href="gallery/users_contrib_script/vertical_slice.html" title="A Vertical slice"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/X.html b/doc_release/html/X.html
deleted file mode 100644
index 93b1707..0000000
--- a/doc_release/html/X.html
+++ /dev/null
@@ -1,144 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>X — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="next" title="xyz2grd" href="xyz2grd.html" />
- <link rel="prev" title="triangulate" href="triangulate.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="xyz2grd.html" title="xyz2grd"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="triangulate.html" title="triangulate"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="x">
-<h1>X<a class="headerlink" href="#x" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="xyz2grd.html">xyz2grd</a></li>
-</ul>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="triangulate.html"
- title="previous chapter">triangulate</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="xyz2grd.html"
- title="next chapter">xyz2grd</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/X.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="xyz2grd.html" title="xyz2grd"
- >next</a> </li>
- <li class="right" >
- <a href="triangulate.html" title="triangulate"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/_images/GMT4_mode.png b/doc_release/html/_images/GMT4_mode.png
deleted file mode 100644
index eed4b9d..0000000
Binary files a/doc_release/html/_images/GMT4_mode.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT5_Summit_2011.jpg b/doc_release/html/_images/GMT5_Summit_2011.jpg
deleted file mode 100644
index 0a69af4..0000000
Binary files a/doc_release/html/_images/GMT5_Summit_2011.jpg and /dev/null differ
diff --git a/doc_release/html/_images/GMT5_mode.png b/doc_release/html/_images/GMT5_mode.png
deleted file mode 100644
index 4f22254..0000000
Binary files a/doc_release/html/_images/GMT5_mode.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_-B_custom.png b/doc_release/html/_images/GMT_-B_custom.png
deleted file mode 100644
index 9340a71..0000000
Binary files a/doc_release/html/_images/GMT_-B_custom.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_-B_geo_1.png b/doc_release/html/_images/GMT_-B_geo_1.png
deleted file mode 100644
index fedf716..0000000
Binary files a/doc_release/html/_images/GMT_-B_geo_1.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_-B_geo_2.png b/doc_release/html/_images/GMT_-B_geo_2.png
deleted file mode 100644
index 97b8a1f..0000000
Binary files a/doc_release/html/_images/GMT_-B_geo_2.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_-B_linear.png b/doc_release/html/_images/GMT_-B_linear.png
deleted file mode 100644
index e2a90ee..0000000
Binary files a/doc_release/html/_images/GMT_-B_linear.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_-B_log.png b/doc_release/html/_images/GMT_-B_log.png
deleted file mode 100644
index de927cc..0000000
Binary files a/doc_release/html/_images/GMT_-B_log.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_-B_pow.png b/doc_release/html/_images/GMT_-B_pow.png
deleted file mode 100644
index 2b5bc56..0000000
Binary files a/doc_release/html/_images/GMT_-B_pow.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_-B_time1.png b/doc_release/html/_images/GMT_-B_time1.png
deleted file mode 100644
index 31ed827..0000000
Binary files a/doc_release/html/_images/GMT_-B_time1.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_-B_time2.png b/doc_release/html/_images/GMT_-B_time2.png
deleted file mode 100644
index e25aee6..0000000
Binary files a/doc_release/html/_images/GMT_-B_time2.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_-B_time3.png b/doc_release/html/_images/GMT_-B_time3.png
deleted file mode 100644
index 1be6e3b..0000000
Binary files a/doc_release/html/_images/GMT_-B_time3.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_-B_time4.png b/doc_release/html/_images/GMT_-B_time4.png
deleted file mode 100644
index 2e0c907..0000000
Binary files a/doc_release/html/_images/GMT_-B_time4.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_-B_time5.png b/doc_release/html/_images/GMT_-B_time5.png
deleted file mode 100644
index e9942d7..0000000
Binary files a/doc_release/html/_images/GMT_-B_time5.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_-B_time6.png b/doc_release/html/_images/GMT_-B_time6.png
deleted file mode 100644
index 8b9f834..0000000
Binary files a/doc_release/html/_images/GMT_-B_time6.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_-B_time7.png b/doc_release/html/_images/GMT_-B_time7.png
deleted file mode 100644
index 755692d..0000000
Binary files a/doc_release/html/_images/GMT_-B_time7.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_-J.png b/doc_release/html/_images/GMT_-J.png
deleted file mode 100644
index 296c02e..0000000
Binary files a/doc_release/html/_images/GMT_-J.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_-OK.png b/doc_release/html/_images/GMT_-OK.png
deleted file mode 100644
index 3cf8171..0000000
Binary files a/doc_release/html/_images/GMT_-OK.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_-P.png b/doc_release/html/_images/GMT_-P.png
deleted file mode 100644
index 690b112..0000000
Binary files a/doc_release/html/_images/GMT_-P.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_-R.png b/doc_release/html/_images/GMT_-R.png
deleted file mode 100644
index d00f40a..0000000
Binary files a/doc_release/html/_images/GMT_-R.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_-U.png b/doc_release/html/_images/GMT_-U.png
deleted file mode 100644
index b2ab330..0000000
Binary files a/doc_release/html/_images/GMT_-U.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_-XY.png b/doc_release/html/_images/GMT_-XY.png
deleted file mode 100644
index d6ceb2b..0000000
Binary files a/doc_release/html/_images/GMT_-XY.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_App_E.png b/doc_release/html/_images/GMT_App_E.png
deleted file mode 100644
index 7353e48..0000000
Binary files a/doc_release/html/_images/GMT_App_E.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_App_F_stand+_iso+.png b/doc_release/html/_images/GMT_App_F_stand+_iso+.png
deleted file mode 100644
index 7ea8ce3..0000000
Binary files a/doc_release/html/_images/GMT_App_F_stand+_iso+.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_App_F_symbol_dingbats.png b/doc_release/html/_images/GMT_App_F_symbol_dingbats.png
deleted file mode 100644
index d387617..0000000
Binary files a/doc_release/html/_images/GMT_App_F_symbol_dingbats.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_App_G.png b/doc_release/html/_images/GMT_App_G.png
deleted file mode 100644
index 3945ef3..0000000
Binary files a/doc_release/html/_images/GMT_App_G.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_App_J_1.png b/doc_release/html/_images/GMT_App_J_1.png
deleted file mode 100644
index 7b76194..0000000
Binary files a/doc_release/html/_images/GMT_App_J_1.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_App_J_2.png b/doc_release/html/_images/GMT_App_J_2.png
deleted file mode 100644
index a4ac1da..0000000
Binary files a/doc_release/html/_images/GMT_App_J_2.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_App_J_3.png b/doc_release/html/_images/GMT_App_J_3.png
deleted file mode 100644
index 555a456..0000000
Binary files a/doc_release/html/_images/GMT_App_J_3.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_App_K_1.png b/doc_release/html/_images/GMT_App_K_1.png
deleted file mode 100644
index 66058a9..0000000
Binary files a/doc_release/html/_images/GMT_App_K_1.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_App_K_2.png b/doc_release/html/_images/GMT_App_K_2.png
deleted file mode 100644
index 8bf96c3..0000000
Binary files a/doc_release/html/_images/GMT_App_K_2.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_App_K_3.png b/doc_release/html/_images/GMT_App_K_3.png
deleted file mode 100644
index 62e69d4..0000000
Binary files a/doc_release/html/_images/GMT_App_K_3.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_App_K_4.png b/doc_release/html/_images/GMT_App_K_4.png
deleted file mode 100644
index b7c8ae8..0000000
Binary files a/doc_release/html/_images/GMT_App_K_4.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_App_K_5.png b/doc_release/html/_images/GMT_App_K_5.png
deleted file mode 100644
index b81869a..0000000
Binary files a/doc_release/html/_images/GMT_App_K_5.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_App_M_1a.png b/doc_release/html/_images/GMT_App_M_1a.png
deleted file mode 100644
index 9c98cde..0000000
Binary files a/doc_release/html/_images/GMT_App_M_1a.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_App_M_1b.png b/doc_release/html/_images/GMT_App_M_1b.png
deleted file mode 100644
index 49093eb..0000000
Binary files a/doc_release/html/_images/GMT_App_M_1b.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_App_M_2.png b/doc_release/html/_images/GMT_App_M_2.png
deleted file mode 100644
index 7604f81..0000000
Binary files a/doc_release/html/_images/GMT_App_M_2.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_App_N_1.png b/doc_release/html/_images/GMT_App_N_1.png
deleted file mode 100644
index 1cf5464..0000000
Binary files a/doc_release/html/_images/GMT_App_N_1.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_App_O_1.png b/doc_release/html/_images/GMT_App_O_1.png
deleted file mode 100644
index f8ccf7b..0000000
Binary files a/doc_release/html/_images/GMT_App_O_1.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_App_O_2.png b/doc_release/html/_images/GMT_App_O_2.png
deleted file mode 100644
index 8fdb8c4..0000000
Binary files a/doc_release/html/_images/GMT_App_O_2.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_App_O_3.png b/doc_release/html/_images/GMT_App_O_3.png
deleted file mode 100644
index 3ddbf05..0000000
Binary files a/doc_release/html/_images/GMT_App_O_3.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_App_O_4.png b/doc_release/html/_images/GMT_App_O_4.png
deleted file mode 100644
index aa2b61f..0000000
Binary files a/doc_release/html/_images/GMT_App_O_4.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_App_O_5.png b/doc_release/html/_images/GMT_App_O_5.png
deleted file mode 100644
index cb4b666..0000000
Binary files a/doc_release/html/_images/GMT_App_O_5.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_App_O_6.png b/doc_release/html/_images/GMT_App_O_6.png
deleted file mode 100644
index 60ae18e..0000000
Binary files a/doc_release/html/_images/GMT_App_O_6.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_App_O_7.png b/doc_release/html/_images/GMT_App_O_7.png
deleted file mode 100644
index 8cfedc1..0000000
Binary files a/doc_release/html/_images/GMT_App_O_7.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_App_O_8.png b/doc_release/html/_images/GMT_App_O_8.png
deleted file mode 100644
index 5083aeb..0000000
Binary files a/doc_release/html/_images/GMT_App_O_8.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_App_O_9.png b/doc_release/html/_images/GMT_App_O_9.png
deleted file mode 100644
index d597c94..0000000
Binary files a/doc_release/html/_images/GMT_App_O_9.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_App_P_2.png b/doc_release/html/_images/GMT_App_P_2.png
deleted file mode 100644
index a0a26f1..0000000
Binary files a/doc_release/html/_images/GMT_App_P_2.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_Defaults_1a.png b/doc_release/html/_images/GMT_Defaults_1a.png
deleted file mode 100644
index 45832d3..0000000
Binary files a/doc_release/html/_images/GMT_Defaults_1a.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_Defaults_1b.png b/doc_release/html/_images/GMT_Defaults_1b.png
deleted file mode 100644
index 62a5cd8..0000000
Binary files a/doc_release/html/_images/GMT_Defaults_1b.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_Defaults_1c.png b/doc_release/html/_images/GMT_Defaults_1c.png
deleted file mode 100644
index c78fa53..0000000
Binary files a/doc_release/html/_images/GMT_Defaults_1c.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_RGBchart_a4.png b/doc_release/html/_images/GMT_RGBchart_a4.png
deleted file mode 100644
index 652dc7a..0000000
Binary files a/doc_release/html/_images/GMT_RGBchart_a4.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_TM.png b/doc_release/html/_images/GMT_TM.png
deleted file mode 100644
index 42360f7..0000000
Binary files a/doc_release/html/_images/GMT_TM.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_albers.png b/doc_release/html/_images/GMT_albers.png
deleted file mode 100644
index 1a4c9de..0000000
Binary files a/doc_release/html/_images/GMT_albers.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_arrows.png b/doc_release/html/_images/GMT_arrows.png
deleted file mode 100644
index f20b59d..0000000
Binary files a/doc_release/html/_images/GMT_arrows.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_az_equidistant.png b/doc_release/html/_images/GMT_az_equidistant.png
deleted file mode 100644
index 591e795..0000000
Binary files a/doc_release/html/_images/GMT_az_equidistant.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_cassini.png b/doc_release/html/_images/GMT_cassini.png
deleted file mode 100644
index 1b368b1..0000000
Binary files a/doc_release/html/_images/GMT_cassini.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_chunking.png b/doc_release/html/_images/GMT_chunking.png
deleted file mode 100644
index 554638c..0000000
Binary files a/doc_release/html/_images/GMT_chunking.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_color_interpolate.png b/doc_release/html/_images/GMT_color_interpolate.png
deleted file mode 100644
index 1b4a814..0000000
Binary files a/doc_release/html/_images/GMT_color_interpolate.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_eckert4.png b/doc_release/html/_images/GMT_eckert4.png
deleted file mode 100644
index bfddd8e..0000000
Binary files a/doc_release/html/_images/GMT_eckert4.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_eckert6.png b/doc_release/html/_images/GMT_eckert6.png
deleted file mode 100644
index d82ca85..0000000
Binary files a/doc_release/html/_images/GMT_eckert6.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_equi_cyl.png b/doc_release/html/_images/GMT_equi_cyl.png
deleted file mode 100644
index 9c24b3c..0000000
Binary files a/doc_release/html/_images/GMT_equi_cyl.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_equidistant_conic.png b/doc_release/html/_images/GMT_equidistant_conic.png
deleted file mode 100644
index 635dd8a..0000000
Binary files a/doc_release/html/_images/GMT_equidistant_conic.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_gall_stereo.png b/doc_release/html/_images/GMT_gall_stereo.png
deleted file mode 100644
index c13e688..0000000
Binary files a/doc_release/html/_images/GMT_gall_stereo.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_general_cyl.png b/doc_release/html/_images/GMT_general_cyl.png
deleted file mode 100644
index 2b4d546..0000000
Binary files a/doc_release/html/_images/GMT_general_cyl.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_gnomonic.png b/doc_release/html/_images/GMT_gnomonic.png
deleted file mode 100644
index 812060b..0000000
Binary files a/doc_release/html/_images/GMT_gnomonic.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_grinten.png b/doc_release/html/_images/GMT_grinten.png
deleted file mode 100644
index d66fab3..0000000
Binary files a/doc_release/html/_images/GMT_grinten.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_hammer.png b/doc_release/html/_images/GMT_hammer.png
deleted file mode 100644
index d929038..0000000
Binary files a/doc_release/html/_images/GMT_hammer.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_lambert_az_hemi.png b/doc_release/html/_images/GMT_lambert_az_hemi.png
deleted file mode 100644
index fda61d2..0000000
Binary files a/doc_release/html/_images/GMT_lambert_az_hemi.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_lambert_az_rect.png b/doc_release/html/_images/GMT_lambert_az_rect.png
deleted file mode 100644
index e2d29c1..0000000
Binary files a/doc_release/html/_images/GMT_lambert_az_rect.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_lambert_conic.png b/doc_release/html/_images/GMT_lambert_conic.png
deleted file mode 100644
index c267b0f..0000000
Binary files a/doc_release/html/_images/GMT_lambert_conic.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_linear.png b/doc_release/html/_images/GMT_linear.png
deleted file mode 100644
index 9fb7048..0000000
Binary files a/doc_release/html/_images/GMT_linear.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_linear_cal.png b/doc_release/html/_images/GMT_linear_cal.png
deleted file mode 100644
index 2304192..0000000
Binary files a/doc_release/html/_images/GMT_linear_cal.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_linear_d.png b/doc_release/html/_images/GMT_linear_d.png
deleted file mode 100644
index 4104500..0000000
Binary files a/doc_release/html/_images/GMT_linear_d.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_linecap.png b/doc_release/html/_images/GMT_linecap.png
deleted file mode 100644
index 0a50311..0000000
Binary files a/doc_release/html/_images/GMT_linecap.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_log.png b/doc_release/html/_images/GMT_log.png
deleted file mode 100644
index a15fbd3..0000000
Binary files a/doc_release/html/_images/GMT_log.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_mercator.png b/doc_release/html/_images/GMT_mercator.png
deleted file mode 100644
index 9eb2a15..0000000
Binary files a/doc_release/html/_images/GMT_mercator.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_miller.png b/doc_release/html/_images/GMT_miller.png
deleted file mode 100644
index c8177e0..0000000
Binary files a/doc_release/html/_images/GMT_miller.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_mollweide.png b/doc_release/html/_images/GMT_mollweide.png
deleted file mode 100644
index 145467f..0000000
Binary files a/doc_release/html/_images/GMT_mollweide.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_obl_merc.png b/doc_release/html/_images/GMT_obl_merc.png
deleted file mode 100644
index 2decef7..0000000
Binary files a/doc_release/html/_images/GMT_obl_merc.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_orthographic.png b/doc_release/html/_images/GMT_orthographic.png
deleted file mode 100644
index 91ce7e9..0000000
Binary files a/doc_release/html/_images/GMT_orthographic.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_perspective.png b/doc_release/html/_images/GMT_perspective.png
deleted file mode 100644
index 69a4aa8..0000000
Binary files a/doc_release/html/_images/GMT_perspective.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_polar.png b/doc_release/html/_images/GMT_polar.png
deleted file mode 100644
index 7d8bf68..0000000
Binary files a/doc_release/html/_images/GMT_polar.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_polyconic.png b/doc_release/html/_images/GMT_polyconic.png
deleted file mode 100644
index 4fece36..0000000
Binary files a/doc_release/html/_images/GMT_polyconic.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_pow.png b/doc_release/html/_images/GMT_pow.png
deleted file mode 100644
index 57a8f73..0000000
Binary files a/doc_release/html/_images/GMT_pow.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_registration.png b/doc_release/html/_images/GMT_registration.png
deleted file mode 100644
index 31b1518..0000000
Binary files a/doc_release/html/_images/GMT_registration.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_robinson.png b/doc_release/html/_images/GMT_robinson.png
deleted file mode 100644
index e199f07..0000000
Binary files a/doc_release/html/_images/GMT_robinson.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_sinus_int.png b/doc_release/html/_images/GMT_sinus_int.png
deleted file mode 100644
index dd757e3..0000000
Binary files a/doc_release/html/_images/GMT_sinus_int.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_sinusoidal.png b/doc_release/html/_images/GMT_sinusoidal.png
deleted file mode 100644
index 0a83a97..0000000
Binary files a/doc_release/html/_images/GMT_sinusoidal.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_stereographic_general.png b/doc_release/html/_images/GMT_stereographic_general.png
deleted file mode 100644
index f810398..0000000
Binary files a/doc_release/html/_images/GMT_stereographic_general.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_stereographic_polar.png b/doc_release/html/_images/GMT_stereographic_polar.png
deleted file mode 100644
index 4b62ca5..0000000
Binary files a/doc_release/html/_images/GMT_stereographic_polar.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_stereographic_rect.png b/doc_release/html/_images/GMT_stereographic_rect.png
deleted file mode 100644
index 0cb0cec..0000000
Binary files a/doc_release/html/_images/GMT_stereographic_rect.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_stereonets.png b/doc_release/html/_images/GMT_stereonets.png
deleted file mode 100644
index 26b38ef..0000000
Binary files a/doc_release/html/_images/GMT_stereonets.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_transverse_merc.png b/doc_release/html/_images/GMT_transverse_merc.png
deleted file mode 100644
index 7c49031..0000000
Binary files a/doc_release/html/_images/GMT_transverse_merc.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_utm_zones.png b/doc_release/html/_images/GMT_utm_zones.png
deleted file mode 100644
index e16efc6..0000000
Binary files a/doc_release/html/_images/GMT_utm_zones.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_volcano.png b/doc_release/html/_images/GMT_volcano.png
deleted file mode 100644
index 74dd8e6..0000000
Binary files a/doc_release/html/_images/GMT_volcano.png and /dev/null differ
diff --git a/doc_release/html/_images/GMT_winkel.png b/doc_release/html/_images/GMT_winkel.png
deleted file mode 100644
index 4b21f7a..0000000
Binary files a/doc_release/html/_images/GMT_winkel.png and /dev/null differ
diff --git a/doc_release/html/_images/anim_01.png b/doc_release/html/_images/anim_01.png
deleted file mode 100644
index 79ed02b..0000000
Binary files a/doc_release/html/_images/anim_01.png and /dev/null differ
diff --git a/doc_release/html/_images/anim_02.png b/doc_release/html/_images/anim_02.png
deleted file mode 100644
index 9de7e4b..0000000
Binary files a/doc_release/html/_images/anim_02.png and /dev/null differ
diff --git a/doc_release/html/_images/anim_03.png b/doc_release/html/_images/anim_03.png
deleted file mode 100644
index 1637a02..0000000
Binary files a/doc_release/html/_images/anim_03.png and /dev/null differ
diff --git a/doc_release/html/_images/anim_04.png b/doc_release/html/_images/anim_04.png
deleted file mode 100644
index 25124ba..0000000
Binary files a/doc_release/html/_images/anim_04.png and /dev/null differ
diff --git a/doc_release/html/_images/example_01.png b/doc_release/html/_images/example_01.png
deleted file mode 100644
index c2130a6..0000000
Binary files a/doc_release/html/_images/example_01.png and /dev/null differ
diff --git a/doc_release/html/_images/example_02.png b/doc_release/html/_images/example_02.png
deleted file mode 100644
index 8ac230f..0000000
Binary files a/doc_release/html/_images/example_02.png and /dev/null differ
diff --git a/doc_release/html/_images/example_03.png b/doc_release/html/_images/example_03.png
deleted file mode 100644
index de1f765..0000000
Binary files a/doc_release/html/_images/example_03.png and /dev/null differ
diff --git a/doc_release/html/_images/example_04.png b/doc_release/html/_images/example_04.png
deleted file mode 100644
index b3a5145..0000000
Binary files a/doc_release/html/_images/example_04.png and /dev/null differ
diff --git a/doc_release/html/_images/example_05.png b/doc_release/html/_images/example_05.png
deleted file mode 100644
index 11f6166..0000000
Binary files a/doc_release/html/_images/example_05.png and /dev/null differ
diff --git a/doc_release/html/_images/example_06.png b/doc_release/html/_images/example_06.png
deleted file mode 100644
index 1e53143..0000000
Binary files a/doc_release/html/_images/example_06.png and /dev/null differ
diff --git a/doc_release/html/_images/example_07.png b/doc_release/html/_images/example_07.png
deleted file mode 100644
index 46b2e08..0000000
Binary files a/doc_release/html/_images/example_07.png and /dev/null differ
diff --git a/doc_release/html/_images/example_08.png b/doc_release/html/_images/example_08.png
deleted file mode 100644
index 8806631..0000000
Binary files a/doc_release/html/_images/example_08.png and /dev/null differ
diff --git a/doc_release/html/_images/example_09.png b/doc_release/html/_images/example_09.png
deleted file mode 100644
index bfe00e3..0000000
Binary files a/doc_release/html/_images/example_09.png and /dev/null differ
diff --git a/doc_release/html/_images/example_10.png b/doc_release/html/_images/example_10.png
deleted file mode 100644
index 200678e..0000000
Binary files a/doc_release/html/_images/example_10.png and /dev/null differ
diff --git a/doc_release/html/_images/example_11.png b/doc_release/html/_images/example_11.png
deleted file mode 100644
index e1ac482..0000000
Binary files a/doc_release/html/_images/example_11.png and /dev/null differ
diff --git a/doc_release/html/_images/example_12.png b/doc_release/html/_images/example_12.png
deleted file mode 100644
index 7d428bb..0000000
Binary files a/doc_release/html/_images/example_12.png and /dev/null differ
diff --git a/doc_release/html/_images/example_13.png b/doc_release/html/_images/example_13.png
deleted file mode 100644
index 994dfea..0000000
Binary files a/doc_release/html/_images/example_13.png and /dev/null differ
diff --git a/doc_release/html/_images/example_14.png b/doc_release/html/_images/example_14.png
deleted file mode 100644
index 966f198..0000000
Binary files a/doc_release/html/_images/example_14.png and /dev/null differ
diff --git a/doc_release/html/_images/example_15.png b/doc_release/html/_images/example_15.png
deleted file mode 100644
index 2c9178a..0000000
Binary files a/doc_release/html/_images/example_15.png and /dev/null differ
diff --git a/doc_release/html/_images/example_16.png b/doc_release/html/_images/example_16.png
deleted file mode 100644
index 17005dc..0000000
Binary files a/doc_release/html/_images/example_16.png and /dev/null differ
diff --git a/doc_release/html/_images/example_17.png b/doc_release/html/_images/example_17.png
deleted file mode 100644
index 062712c..0000000
Binary files a/doc_release/html/_images/example_17.png and /dev/null differ
diff --git a/doc_release/html/_images/example_18.png b/doc_release/html/_images/example_18.png
deleted file mode 100644
index 99cfe0a..0000000
Binary files a/doc_release/html/_images/example_18.png and /dev/null differ
diff --git a/doc_release/html/_images/example_19.png b/doc_release/html/_images/example_19.png
deleted file mode 100644
index 1a1e26f..0000000
Binary files a/doc_release/html/_images/example_19.png and /dev/null differ
diff --git a/doc_release/html/_images/example_20.png b/doc_release/html/_images/example_20.png
deleted file mode 100644
index 857d2b8..0000000
Binary files a/doc_release/html/_images/example_20.png and /dev/null differ
diff --git a/doc_release/html/_images/example_21.png b/doc_release/html/_images/example_21.png
deleted file mode 100644
index 9ef4d31..0000000
Binary files a/doc_release/html/_images/example_21.png and /dev/null differ
diff --git a/doc_release/html/_images/example_22.png b/doc_release/html/_images/example_22.png
deleted file mode 100644
index 6465d84..0000000
Binary files a/doc_release/html/_images/example_22.png and /dev/null differ
diff --git a/doc_release/html/_images/example_23.png b/doc_release/html/_images/example_23.png
deleted file mode 100644
index 66ad937..0000000
Binary files a/doc_release/html/_images/example_23.png and /dev/null differ
diff --git a/doc_release/html/_images/example_24.png b/doc_release/html/_images/example_24.png
deleted file mode 100644
index 30c9d28..0000000
Binary files a/doc_release/html/_images/example_24.png and /dev/null differ
diff --git a/doc_release/html/_images/example_25.png b/doc_release/html/_images/example_25.png
deleted file mode 100644
index 085ca1b..0000000
Binary files a/doc_release/html/_images/example_25.png and /dev/null differ
diff --git a/doc_release/html/_images/example_26.png b/doc_release/html/_images/example_26.png
deleted file mode 100644
index 7d1e82c..0000000
Binary files a/doc_release/html/_images/example_26.png and /dev/null differ
diff --git a/doc_release/html/_images/example_27.png b/doc_release/html/_images/example_27.png
deleted file mode 100644
index a724fe4..0000000
Binary files a/doc_release/html/_images/example_27.png and /dev/null differ
diff --git a/doc_release/html/_images/example_28.png b/doc_release/html/_images/example_28.png
deleted file mode 100644
index a3a7ddf..0000000
Binary files a/doc_release/html/_images/example_28.png and /dev/null differ
diff --git a/doc_release/html/_images/example_29.png b/doc_release/html/_images/example_29.png
deleted file mode 100644
index b0030fe..0000000
Binary files a/doc_release/html/_images/example_29.png and /dev/null differ
diff --git a/doc_release/html/_images/example_30.png b/doc_release/html/_images/example_30.png
deleted file mode 100644
index 0f99b21..0000000
Binary files a/doc_release/html/_images/example_30.png and /dev/null differ
diff --git a/doc_release/html/_images/example_31.png b/doc_release/html/_images/example_31.png
deleted file mode 100644
index f88e930..0000000
Binary files a/doc_release/html/_images/example_31.png and /dev/null differ
diff --git a/doc_release/html/_images/example_32.png b/doc_release/html/_images/example_32.png
deleted file mode 100644
index 5d0ec55..0000000
Binary files a/doc_release/html/_images/example_32.png and /dev/null differ
diff --git a/doc_release/html/_images/example_33.png b/doc_release/html/_images/example_33.png
deleted file mode 100644
index f7d0592..0000000
Binary files a/doc_release/html/_images/example_33.png and /dev/null differ
diff --git a/doc_release/html/_images/example_34.png b/doc_release/html/_images/example_34.png
deleted file mode 100644
index 24f89c9..0000000
Binary files a/doc_release/html/_images/example_34.png and /dev/null differ
diff --git a/doc_release/html/_images/example_35.png b/doc_release/html/_images/example_35.png
deleted file mode 100644
index 7c3c463..0000000
Binary files a/doc_release/html/_images/example_35.png and /dev/null differ
diff --git a/doc_release/html/_images/example_36.png b/doc_release/html/_images/example_36.png
deleted file mode 100644
index 5912d3a..0000000
Binary files a/doc_release/html/_images/example_36.png and /dev/null differ
diff --git a/doc_release/html/_images/example_37.png b/doc_release/html/_images/example_37.png
deleted file mode 100644
index eaf03cc..0000000
Binary files a/doc_release/html/_images/example_37.png and /dev/null differ
diff --git a/doc_release/html/_images/example_38.png b/doc_release/html/_images/example_38.png
deleted file mode 100644
index f65a04b..0000000
Binary files a/doc_release/html/_images/example_38.png and /dev/null differ
diff --git a/doc_release/html/_images/example_39.png b/doc_release/html/_images/example_39.png
deleted file mode 100644
index 5628ea7..0000000
Binary files a/doc_release/html/_images/example_39.png and /dev/null differ
diff --git a/doc_release/html/_images/example_40.png b/doc_release/html/_images/example_40.png
deleted file mode 100644
index 83b84fb..0000000
Binary files a/doc_release/html/_images/example_40.png and /dev/null differ
diff --git a/doc_release/html/_images/formatpicture.png b/doc_release/html/_images/formatpicture.png
deleted file mode 100644
index 95c486b..0000000
Binary files a/doc_release/html/_images/formatpicture.png and /dev/null differ
diff --git a/doc_release/html/_images/gimp-sliders+panel.png b/doc_release/html/_images/gimp-sliders+panel.png
deleted file mode 100644
index b6a5d03..0000000
Binary files a/doc_release/html/_images/gimp-sliders+panel.png and /dev/null differ
diff --git a/doc_release/html/_images/hsv-cone.png b/doc_release/html/_images/hsv-cone.png
deleted file mode 100644
index d32dde6..0000000
Binary files a/doc_release/html/_images/hsv-cone.png and /dev/null differ
diff --git a/doc_release/html/_images/math/014c6fe6e6a7f82a9e18633f9b981d8ffe99306a.png b/doc_release/html/_images/math/014c6fe6e6a7f82a9e18633f9b981d8ffe99306a.png
deleted file mode 100644
index fae3ffe..0000000
Binary files a/doc_release/html/_images/math/014c6fe6e6a7f82a9e18633f9b981d8ffe99306a.png and /dev/null differ
diff --git a/doc_release/html/_images/math/0278631977e0f39ca6a0d67360de82349f5c774a.png b/doc_release/html/_images/math/0278631977e0f39ca6a0d67360de82349f5c774a.png
deleted file mode 100644
index 169ff96..0000000
Binary files a/doc_release/html/_images/math/0278631977e0f39ca6a0d67360de82349f5c774a.png and /dev/null differ
diff --git a/doc_release/html/_images/math/068772bfc9e1712b9f59428fc167650df7791178.png b/doc_release/html/_images/math/068772bfc9e1712b9f59428fc167650df7791178.png
deleted file mode 100644
index 010e3bb..0000000
Binary files a/doc_release/html/_images/math/068772bfc9e1712b9f59428fc167650df7791178.png and /dev/null differ
diff --git a/doc_release/html/_images/math/09e7ee7c2a541bc883180197b413c80c4551895d.png b/doc_release/html/_images/math/09e7ee7c2a541bc883180197b413c80c4551895d.png
deleted file mode 100644
index 068b2fa..0000000
Binary files a/doc_release/html/_images/math/09e7ee7c2a541bc883180197b413c80c4551895d.png and /dev/null differ
diff --git a/doc_release/html/_images/math/0b38ec67684d250b4d0315f2c34f103be8e3e411.png b/doc_release/html/_images/math/0b38ec67684d250b4d0315f2c34f103be8e3e411.png
deleted file mode 100644
index dc1a236..0000000
Binary files a/doc_release/html/_images/math/0b38ec67684d250b4d0315f2c34f103be8e3e411.png and /dev/null differ
diff --git a/doc_release/html/_images/math/0bb1e43191efcfe04a430d80616fa31c38a9ca40.png b/doc_release/html/_images/math/0bb1e43191efcfe04a430d80616fa31c38a9ca40.png
deleted file mode 100644
index c7ffb09..0000000
Binary files a/doc_release/html/_images/math/0bb1e43191efcfe04a430d80616fa31c38a9ca40.png and /dev/null differ
diff --git a/doc_release/html/_images/math/0e5f5d1f79ce0963ea633cffc0378758eb49eee4.png b/doc_release/html/_images/math/0e5f5d1f79ce0963ea633cffc0378758eb49eee4.png
deleted file mode 100644
index 1eb1f9b..0000000
Binary files a/doc_release/html/_images/math/0e5f5d1f79ce0963ea633cffc0378758eb49eee4.png and /dev/null differ
diff --git a/doc_release/html/_images/math/1019740221002dc58daf09a2184f50a7e91b4a38.png b/doc_release/html/_images/math/1019740221002dc58daf09a2184f50a7e91b4a38.png
deleted file mode 100644
index 378fdd6..0000000
Binary files a/doc_release/html/_images/math/1019740221002dc58daf09a2184f50a7e91b4a38.png and /dev/null differ
diff --git a/doc_release/html/_images/math/10c14503c4ca38a5fd23f22f93567acbc9f34fab.png b/doc_release/html/_images/math/10c14503c4ca38a5fd23f22f93567acbc9f34fab.png
deleted file mode 100644
index 5df5604..0000000
Binary files a/doc_release/html/_images/math/10c14503c4ca38a5fd23f22f93567acbc9f34fab.png and /dev/null differ
diff --git a/doc_release/html/_images/math/10e009bdb83f96c5f47c58b34d5d4b12ef268d5b.png b/doc_release/html/_images/math/10e009bdb83f96c5f47c58b34d5d4b12ef268d5b.png
deleted file mode 100644
index 1bc0fd6..0000000
Binary files a/doc_release/html/_images/math/10e009bdb83f96c5f47c58b34d5d4b12ef268d5b.png and /dev/null differ
diff --git a/doc_release/html/_images/math/17b38e3a5d0e4a294258e8c390605a620a9d2bb4.png b/doc_release/html/_images/math/17b38e3a5d0e4a294258e8c390605a620a9d2bb4.png
deleted file mode 100644
index 32d1754..0000000
Binary files a/doc_release/html/_images/math/17b38e3a5d0e4a294258e8c390605a620a9d2bb4.png and /dev/null differ
diff --git a/doc_release/html/_images/math/195374909526226d6dd908206784056573e69009.png b/doc_release/html/_images/math/195374909526226d6dd908206784056573e69009.png
deleted file mode 100644
index 1961784..0000000
Binary files a/doc_release/html/_images/math/195374909526226d6dd908206784056573e69009.png and /dev/null differ
diff --git a/doc_release/html/_images/math/1abe0c9c17f3a82460dc45a38bd48c925c5b396b.png b/doc_release/html/_images/math/1abe0c9c17f3a82460dc45a38bd48c925c5b396b.png
deleted file mode 100644
index e97e6ae..0000000
Binary files a/doc_release/html/_images/math/1abe0c9c17f3a82460dc45a38bd48c925c5b396b.png and /dev/null differ
diff --git a/doc_release/html/_images/math/1b4f055cfa78bceb89a4c9c9c18402158f0ef0c4.png b/doc_release/html/_images/math/1b4f055cfa78bceb89a4c9c9c18402158f0ef0c4.png
deleted file mode 100644
index caeaa0a..0000000
Binary files a/doc_release/html/_images/math/1b4f055cfa78bceb89a4c9c9c18402158f0ef0c4.png and /dev/null differ
diff --git a/doc_release/html/_images/math/1da275241154bbf43844c575ae595078e429e04d.png b/doc_release/html/_images/math/1da275241154bbf43844c575ae595078e429e04d.png
deleted file mode 100644
index 5dae3f2..0000000
Binary files a/doc_release/html/_images/math/1da275241154bbf43844c575ae595078e429e04d.png and /dev/null differ
diff --git a/doc_release/html/_images/math/1e5fe94895278bbdc7c2fcef3151fac1b8fa761b.png b/doc_release/html/_images/math/1e5fe94895278bbdc7c2fcef3151fac1b8fa761b.png
deleted file mode 100644
index fbe0743..0000000
Binary files a/doc_release/html/_images/math/1e5fe94895278bbdc7c2fcef3151fac1b8fa761b.png and /dev/null differ
diff --git a/doc_release/html/_images/math/2298cf1485084afe72757a9c8483af49a138d81f.png b/doc_release/html/_images/math/2298cf1485084afe72757a9c8483af49a138d81f.png
deleted file mode 100644
index d9b8167..0000000
Binary files a/doc_release/html/_images/math/2298cf1485084afe72757a9c8483af49a138d81f.png and /dev/null differ
diff --git a/doc_release/html/_images/math/2593411df0122575686389de04320006190b7322.png b/doc_release/html/_images/math/2593411df0122575686389de04320006190b7322.png
deleted file mode 100644
index 4066551..0000000
Binary files a/doc_release/html/_images/math/2593411df0122575686389de04320006190b7322.png and /dev/null differ
diff --git a/doc_release/html/_images/math/26c030c66862238374569a6e9f30af876c0c99c8.png b/doc_release/html/_images/math/26c030c66862238374569a6e9f30af876c0c99c8.png
deleted file mode 100644
index 30f3ef4..0000000
Binary files a/doc_release/html/_images/math/26c030c66862238374569a6e9f30af876c0c99c8.png and /dev/null differ
diff --git a/doc_release/html/_images/math/288021fe133ecee94a15fbfad51a537adc9bc799.png b/doc_release/html/_images/math/288021fe133ecee94a15fbfad51a537adc9bc799.png
deleted file mode 100644
index c7f8660..0000000
Binary files a/doc_release/html/_images/math/288021fe133ecee94a15fbfad51a537adc9bc799.png and /dev/null differ
diff --git a/doc_release/html/_images/math/296ab33356160c5a5d59477d3e898f58888f0bdb.png b/doc_release/html/_images/math/296ab33356160c5a5d59477d3e898f58888f0bdb.png
deleted file mode 100644
index aaac0f8..0000000
Binary files a/doc_release/html/_images/math/296ab33356160c5a5d59477d3e898f58888f0bdb.png and /dev/null differ
diff --git a/doc_release/html/_images/math/2a378fd7cd8686bb483dcc6f4790095409d59cdb.png b/doc_release/html/_images/math/2a378fd7cd8686bb483dcc6f4790095409d59cdb.png
deleted file mode 100644
index 4d307f9..0000000
Binary files a/doc_release/html/_images/math/2a378fd7cd8686bb483dcc6f4790095409d59cdb.png and /dev/null differ
diff --git a/doc_release/html/_images/math/2fd8d00206c7d35b6265096bb73a7a057d8ca82d.png b/doc_release/html/_images/math/2fd8d00206c7d35b6265096bb73a7a057d8ca82d.png
deleted file mode 100644
index 64193bc..0000000
Binary files a/doc_release/html/_images/math/2fd8d00206c7d35b6265096bb73a7a057d8ca82d.png and /dev/null differ
diff --git a/doc_release/html/_images/math/30d032d772f65301dabe9c7b6fd5136bebd0efcd.png b/doc_release/html/_images/math/30d032d772f65301dabe9c7b6fd5136bebd0efcd.png
deleted file mode 100644
index f8cf2d2..0000000
Binary files a/doc_release/html/_images/math/30d032d772f65301dabe9c7b6fd5136bebd0efcd.png and /dev/null differ
diff --git a/doc_release/html/_images/math/31ef81fb7b36be5589d39867b7d7e9bbfa764e6a.png b/doc_release/html/_images/math/31ef81fb7b36be5589d39867b7d7e9bbfa764e6a.png
deleted file mode 100644
index 8123d0c..0000000
Binary files a/doc_release/html/_images/math/31ef81fb7b36be5589d39867b7d7e9bbfa764e6a.png and /dev/null differ
diff --git a/doc_release/html/_images/math/35981e0b8a56ea987d1f7b8d208f011536161c25.png b/doc_release/html/_images/math/35981e0b8a56ea987d1f7b8d208f011536161c25.png
deleted file mode 100644
index c0e86fb..0000000
Binary files a/doc_release/html/_images/math/35981e0b8a56ea987d1f7b8d208f011536161c25.png and /dev/null differ
diff --git a/doc_release/html/_images/math/387801783066cdce72bb6d7a962d3179a9112f9e.png b/doc_release/html/_images/math/387801783066cdce72bb6d7a962d3179a9112f9e.png
deleted file mode 100644
index 1e1e009..0000000
Binary files a/doc_release/html/_images/math/387801783066cdce72bb6d7a962d3179a9112f9e.png and /dev/null differ
diff --git a/doc_release/html/_images/math/395ab6aba7689ba6e6b4289b0bbbcf2e3fed8887.png b/doc_release/html/_images/math/395ab6aba7689ba6e6b4289b0bbbcf2e3fed8887.png
deleted file mode 100644
index 198cad5..0000000
Binary files a/doc_release/html/_images/math/395ab6aba7689ba6e6b4289b0bbbcf2e3fed8887.png and /dev/null differ
diff --git a/doc_release/html/_images/math/3ae01849dc5cdf884a6ca6c31cc84029073c9bbb.png b/doc_release/html/_images/math/3ae01849dc5cdf884a6ca6c31cc84029073c9bbb.png
deleted file mode 100644
index b18f935..0000000
Binary files a/doc_release/html/_images/math/3ae01849dc5cdf884a6ca6c31cc84029073c9bbb.png and /dev/null differ
diff --git a/doc_release/html/_images/math/46252e38f851c458622d9a7168b5c70ce0d24ff7.png b/doc_release/html/_images/math/46252e38f851c458622d9a7168b5c70ce0d24ff7.png
deleted file mode 100644
index 1fb17bb..0000000
Binary files a/doc_release/html/_images/math/46252e38f851c458622d9a7168b5c70ce0d24ff7.png and /dev/null differ
diff --git a/doc_release/html/_images/math/48b410286f2d12b6925c3a64fc876a850f1231a5.png b/doc_release/html/_images/math/48b410286f2d12b6925c3a64fc876a850f1231a5.png
deleted file mode 100644
index 763c508..0000000
Binary files a/doc_release/html/_images/math/48b410286f2d12b6925c3a64fc876a850f1231a5.png and /dev/null differ
diff --git a/doc_release/html/_images/math/4a6bc0b33fc0ffe9fb5b688659922045cc2e2322.png b/doc_release/html/_images/math/4a6bc0b33fc0ffe9fb5b688659922045cc2e2322.png
deleted file mode 100644
index 0799a44..0000000
Binary files a/doc_release/html/_images/math/4a6bc0b33fc0ffe9fb5b688659922045cc2e2322.png and /dev/null differ
diff --git a/doc_release/html/_images/math/4a95a463cafda90b27a80aa8adeadb5434c1a154.png b/doc_release/html/_images/math/4a95a463cafda90b27a80aa8adeadb5434c1a154.png
deleted file mode 100644
index ffd6dd1..0000000
Binary files a/doc_release/html/_images/math/4a95a463cafda90b27a80aa8adeadb5434c1a154.png and /dev/null differ
diff --git a/doc_release/html/_images/math/4bee6c8143f58f4fe181c0845298f4bd28cc61e1.png b/doc_release/html/_images/math/4bee6c8143f58f4fe181c0845298f4bd28cc61e1.png
deleted file mode 100644
index ff50abe..0000000
Binary files a/doc_release/html/_images/math/4bee6c8143f58f4fe181c0845298f4bd28cc61e1.png and /dev/null differ
diff --git a/doc_release/html/_images/math/4cc59ba75365fde3a7a3a0972826e2602ffb9f74.png b/doc_release/html/_images/math/4cc59ba75365fde3a7a3a0972826e2602ffb9f74.png
deleted file mode 100644
index e9da5bd..0000000
Binary files a/doc_release/html/_images/math/4cc59ba75365fde3a7a3a0972826e2602ffb9f74.png and /dev/null differ
diff --git a/doc_release/html/_images/math/4d337ec017642f10dd1cbc47640678a90f5bf479.png b/doc_release/html/_images/math/4d337ec017642f10dd1cbc47640678a90f5bf479.png
deleted file mode 100644
index c773636..0000000
Binary files a/doc_release/html/_images/math/4d337ec017642f10dd1cbc47640678a90f5bf479.png and /dev/null differ
diff --git a/doc_release/html/_images/math/50350164c952c03e2a680975542ac943b17ebc6f.png b/doc_release/html/_images/math/50350164c952c03e2a680975542ac943b17ebc6f.png
deleted file mode 100644
index 89b3840..0000000
Binary files a/doc_release/html/_images/math/50350164c952c03e2a680975542ac943b17ebc6f.png and /dev/null differ
diff --git a/doc_release/html/_images/math/5380f0fc713ea8f057cef95a40f671076f4ea764.png b/doc_release/html/_images/math/5380f0fc713ea8f057cef95a40f671076f4ea764.png
deleted file mode 100644
index fef3677..0000000
Binary files a/doc_release/html/_images/math/5380f0fc713ea8f057cef95a40f671076f4ea764.png and /dev/null differ
diff --git a/doc_release/html/_images/math/5b146592a85ad23658360f6f0241129f95e3f9e6.png b/doc_release/html/_images/math/5b146592a85ad23658360f6f0241129f95e3f9e6.png
deleted file mode 100644
index b3ac66e..0000000
Binary files a/doc_release/html/_images/math/5b146592a85ad23658360f6f0241129f95e3f9e6.png and /dev/null differ
diff --git a/doc_release/html/_images/math/5cb03b9ea0160aacf2a8c57c8f87e00609b6baf6.png b/doc_release/html/_images/math/5cb03b9ea0160aacf2a8c57c8f87e00609b6baf6.png
deleted file mode 100644
index e3004db..0000000
Binary files a/doc_release/html/_images/math/5cb03b9ea0160aacf2a8c57c8f87e00609b6baf6.png and /dev/null differ
diff --git a/doc_release/html/_images/math/693faad2f042b0565c90df7cfced16cb9413c166.png b/doc_release/html/_images/math/693faad2f042b0565c90df7cfced16cb9413c166.png
deleted file mode 100644
index 6bcd6da..0000000
Binary files a/doc_release/html/_images/math/693faad2f042b0565c90df7cfced16cb9413c166.png and /dev/null differ
diff --git a/doc_release/html/_images/math/6b75387ee6cca3f5d8be8ee597ddf999e89fddb6.png b/doc_release/html/_images/math/6b75387ee6cca3f5d8be8ee597ddf999e89fddb6.png
deleted file mode 100644
index 7009b1b..0000000
Binary files a/doc_release/html/_images/math/6b75387ee6cca3f5d8be8ee597ddf999e89fddb6.png and /dev/null differ
diff --git a/doc_release/html/_images/math/6fa7e33b3d861018ef49fe4b11d353763a0c7183.png b/doc_release/html/_images/math/6fa7e33b3d861018ef49fe4b11d353763a0c7183.png
deleted file mode 100644
index 82192ee..0000000
Binary files a/doc_release/html/_images/math/6fa7e33b3d861018ef49fe4b11d353763a0c7183.png and /dev/null differ
diff --git a/doc_release/html/_images/math/6ff3988690ca5f07e1274bbc4e7536fda2a5f555.png b/doc_release/html/_images/math/6ff3988690ca5f07e1274bbc4e7536fda2a5f555.png
deleted file mode 100644
index 1c96e68..0000000
Binary files a/doc_release/html/_images/math/6ff3988690ca5f07e1274bbc4e7536fda2a5f555.png and /dev/null differ
diff --git a/doc_release/html/_images/math/70667f5a1cc0894b0fbd9abaf10ad9b13a2f65c1.png b/doc_release/html/_images/math/70667f5a1cc0894b0fbd9abaf10ad9b13a2f65c1.png
deleted file mode 100644
index 6693e43..0000000
Binary files a/doc_release/html/_images/math/70667f5a1cc0894b0fbd9abaf10ad9b13a2f65c1.png and /dev/null differ
diff --git a/doc_release/html/_images/math/71fea5f956b7e847a34650b42ab079913ea710a1.png b/doc_release/html/_images/math/71fea5f956b7e847a34650b42ab079913ea710a1.png
deleted file mode 100644
index f080b93..0000000
Binary files a/doc_release/html/_images/math/71fea5f956b7e847a34650b42ab079913ea710a1.png and /dev/null differ
diff --git a/doc_release/html/_images/math/739563300258a3a4f54ff4e9b397dcf9c3f524f5.png b/doc_release/html/_images/math/739563300258a3a4f54ff4e9b397dcf9c3f524f5.png
deleted file mode 100644
index bbb54e7..0000000
Binary files a/doc_release/html/_images/math/739563300258a3a4f54ff4e9b397dcf9c3f524f5.png and /dev/null differ
diff --git a/doc_release/html/_images/math/795ea6abc60ad6201a8e025e49dff601315f867b.png b/doc_release/html/_images/math/795ea6abc60ad6201a8e025e49dff601315f867b.png
deleted file mode 100644
index b015129..0000000
Binary files a/doc_release/html/_images/math/795ea6abc60ad6201a8e025e49dff601315f867b.png and /dev/null differ
diff --git a/doc_release/html/_images/math/7accc7b32c5ebf62f18c1c3b11d5fefe61e31f13.png b/doc_release/html/_images/math/7accc7b32c5ebf62f18c1c3b11d5fefe61e31f13.png
deleted file mode 100644
index bb68546..0000000
Binary files a/doc_release/html/_images/math/7accc7b32c5ebf62f18c1c3b11d5fefe61e31f13.png and /dev/null differ
diff --git a/doc_release/html/_images/math/7b3e5f3cd3642b0eb9132f765e143e4fd18f176a.png b/doc_release/html/_images/math/7b3e5f3cd3642b0eb9132f765e143e4fd18f176a.png
deleted file mode 100644
index 3ed5df5..0000000
Binary files a/doc_release/html/_images/math/7b3e5f3cd3642b0eb9132f765e143e4fd18f176a.png and /dev/null differ
diff --git a/doc_release/html/_images/math/7c95f79979e59a8c813e6d3f842ecb7a1ca33cb7.png b/doc_release/html/_images/math/7c95f79979e59a8c813e6d3f842ecb7a1ca33cb7.png
deleted file mode 100644
index 72dfbcb..0000000
Binary files a/doc_release/html/_images/math/7c95f79979e59a8c813e6d3f842ecb7a1ca33cb7.png and /dev/null differ
diff --git a/doc_release/html/_images/math/7cbe56ceca10d17d290aa6650dbb52cb30a56ad5.png b/doc_release/html/_images/math/7cbe56ceca10d17d290aa6650dbb52cb30a56ad5.png
deleted file mode 100644
index 381bf59..0000000
Binary files a/doc_release/html/_images/math/7cbe56ceca10d17d290aa6650dbb52cb30a56ad5.png and /dev/null differ
diff --git a/doc_release/html/_images/math/7dc674e394ba36a90b8ddf5fcc87dbe1c092c1a8.png b/doc_release/html/_images/math/7dc674e394ba36a90b8ddf5fcc87dbe1c092c1a8.png
deleted file mode 100644
index 2771c74..0000000
Binary files a/doc_release/html/_images/math/7dc674e394ba36a90b8ddf5fcc87dbe1c092c1a8.png and /dev/null differ
diff --git a/doc_release/html/_images/math/7e20a15268e648a91d5932a5212bcdb2b5b17922.png b/doc_release/html/_images/math/7e20a15268e648a91d5932a5212bcdb2b5b17922.png
deleted file mode 100644
index 1b22193..0000000
Binary files a/doc_release/html/_images/math/7e20a15268e648a91d5932a5212bcdb2b5b17922.png and /dev/null differ
diff --git a/doc_release/html/_images/math/7e5891b0094f6bce182a4d436a76c2ff0371673f.png b/doc_release/html/_images/math/7e5891b0094f6bce182a4d436a76c2ff0371673f.png
deleted file mode 100644
index ad2d46e..0000000
Binary files a/doc_release/html/_images/math/7e5891b0094f6bce182a4d436a76c2ff0371673f.png and /dev/null differ
diff --git a/doc_release/html/_images/math/83ee01e8e074450e92e4056d0f1fdda5442d34ba.png b/doc_release/html/_images/math/83ee01e8e074450e92e4056d0f1fdda5442d34ba.png
deleted file mode 100644
index c7f9b0d..0000000
Binary files a/doc_release/html/_images/math/83ee01e8e074450e92e4056d0f1fdda5442d34ba.png and /dev/null differ
diff --git a/doc_release/html/_images/math/869a1cc0e74f4485021e0fa597dbabde276a7153.png b/doc_release/html/_images/math/869a1cc0e74f4485021e0fa597dbabde276a7153.png
deleted file mode 100644
index 79bb239..0000000
Binary files a/doc_release/html/_images/math/869a1cc0e74f4485021e0fa597dbabde276a7153.png and /dev/null differ
diff --git a/doc_release/html/_images/math/8a11600e981f11d0873afeb7b6616e7d9bdd8aea.png b/doc_release/html/_images/math/8a11600e981f11d0873afeb7b6616e7d9bdd8aea.png
deleted file mode 100644
index 92103ac..0000000
Binary files a/doc_release/html/_images/math/8a11600e981f11d0873afeb7b6616e7d9bdd8aea.png and /dev/null differ
diff --git a/doc_release/html/_images/math/8b9fdedc917a22959b26aa1933f3ba330975fa2a.png b/doc_release/html/_images/math/8b9fdedc917a22959b26aa1933f3ba330975fa2a.png
deleted file mode 100644
index c7893a3..0000000
Binary files a/doc_release/html/_images/math/8b9fdedc917a22959b26aa1933f3ba330975fa2a.png and /dev/null differ
diff --git a/doc_release/html/_images/math/8c669a3486252783fe9a20e3b080f7ae97749928.png b/doc_release/html/_images/math/8c669a3486252783fe9a20e3b080f7ae97749928.png
deleted file mode 100644
index e566ab0..0000000
Binary files a/doc_release/html/_images/math/8c669a3486252783fe9a20e3b080f7ae97749928.png and /dev/null differ
diff --git a/doc_release/html/_images/math/8cf361aac86ee78b34583ff56fc0ec842389daac.png b/doc_release/html/_images/math/8cf361aac86ee78b34583ff56fc0ec842389daac.png
deleted file mode 100644
index bc625a7..0000000
Binary files a/doc_release/html/_images/math/8cf361aac86ee78b34583ff56fc0ec842389daac.png and /dev/null differ
diff --git a/doc_release/html/_images/math/92c25fa25f006cdfe8ef28f3d3141e558aaac740.png b/doc_release/html/_images/math/92c25fa25f006cdfe8ef28f3d3141e558aaac740.png
deleted file mode 100644
index ae10ce9..0000000
Binary files a/doc_release/html/_images/math/92c25fa25f006cdfe8ef28f3d3141e558aaac740.png and /dev/null differ
diff --git a/doc_release/html/_images/math/9b80b6afe46efc8f6defe96b68ff0c1a6992063e.png b/doc_release/html/_images/math/9b80b6afe46efc8f6defe96b68ff0c1a6992063e.png
deleted file mode 100644
index 5fe241f..0000000
Binary files a/doc_release/html/_images/math/9b80b6afe46efc8f6defe96b68ff0c1a6992063e.png and /dev/null differ
diff --git a/doc_release/html/_images/math/a893e2f5944325dd6dc9c50ea8e51619a1d6c4bb.png b/doc_release/html/_images/math/a893e2f5944325dd6dc9c50ea8e51619a1d6c4bb.png
deleted file mode 100644
index 73c91ad..0000000
Binary files a/doc_release/html/_images/math/a893e2f5944325dd6dc9c50ea8e51619a1d6c4bb.png and /dev/null differ
diff --git a/doc_release/html/_images/math/a9cfbeb8ebee1f365919e147a79e242dcb67ee5d.png b/doc_release/html/_images/math/a9cfbeb8ebee1f365919e147a79e242dcb67ee5d.png
deleted file mode 100644
index 76e5ff0..0000000
Binary files a/doc_release/html/_images/math/a9cfbeb8ebee1f365919e147a79e242dcb67ee5d.png and /dev/null differ
diff --git a/doc_release/html/_images/math/ad59b6e24a4a00ac621801f8d7513d68be654ab5.png b/doc_release/html/_images/math/ad59b6e24a4a00ac621801f8d7513d68be654ab5.png
deleted file mode 100644
index ff0a49a..0000000
Binary files a/doc_release/html/_images/math/ad59b6e24a4a00ac621801f8d7513d68be654ab5.png and /dev/null differ
diff --git a/doc_release/html/_images/math/aded9f7d4047915a113044df7b6a067b6c939130.png b/doc_release/html/_images/math/aded9f7d4047915a113044df7b6a067b6c939130.png
deleted file mode 100644
index 3447c61..0000000
Binary files a/doc_release/html/_images/math/aded9f7d4047915a113044df7b6a067b6c939130.png and /dev/null differ
diff --git a/doc_release/html/_images/math/afd2a44a547679d529befa08e1e6c4699bf1dcee.png b/doc_release/html/_images/math/afd2a44a547679d529befa08e1e6c4699bf1dcee.png
deleted file mode 100644
index c3a4024..0000000
Binary files a/doc_release/html/_images/math/afd2a44a547679d529befa08e1e6c4699bf1dcee.png and /dev/null differ
diff --git a/doc_release/html/_images/math/b257c3b1343de1fd2a489ff0cb82636e790a339f.png b/doc_release/html/_images/math/b257c3b1343de1fd2a489ff0cb82636e790a339f.png
deleted file mode 100644
index cbf233b..0000000
Binary files a/doc_release/html/_images/math/b257c3b1343de1fd2a489ff0cb82636e790a339f.png and /dev/null differ
diff --git a/doc_release/html/_images/math/b31b1ea8e4fe3f618dedfb0e2d8c69a3df7a391d.png b/doc_release/html/_images/math/b31b1ea8e4fe3f618dedfb0e2d8c69a3df7a391d.png
deleted file mode 100644
index eab13cb..0000000
Binary files a/doc_release/html/_images/math/b31b1ea8e4fe3f618dedfb0e2d8c69a3df7a391d.png and /dev/null differ
diff --git a/doc_release/html/_images/math/b35a9439ad8c8657b1b1d792ad5c2d77a52c0aef.png b/doc_release/html/_images/math/b35a9439ad8c8657b1b1d792ad5c2d77a52c0aef.png
deleted file mode 100644
index 53cd93a..0000000
Binary files a/doc_release/html/_images/math/b35a9439ad8c8657b1b1d792ad5c2d77a52c0aef.png and /dev/null differ
diff --git a/doc_release/html/_images/math/b5cde2c9425ca10f85e8313d3c932871df9bde64.png b/doc_release/html/_images/math/b5cde2c9425ca10f85e8313d3c932871df9bde64.png
deleted file mode 100644
index b9aad4e..0000000
Binary files a/doc_release/html/_images/math/b5cde2c9425ca10f85e8313d3c932871df9bde64.png and /dev/null differ
diff --git a/doc_release/html/_images/math/b9d9437b637001fdf6d0899ddf6c3258d8e04296.png b/doc_release/html/_images/math/b9d9437b637001fdf6d0899ddf6c3258d8e04296.png
deleted file mode 100644
index ffd6dd1..0000000
Binary files a/doc_release/html/_images/math/b9d9437b637001fdf6d0899ddf6c3258d8e04296.png and /dev/null differ
diff --git a/doc_release/html/_images/math/ba965e654c5ec9abe8bf921fd41e7e3b43dde4b0.png b/doc_release/html/_images/math/ba965e654c5ec9abe8bf921fd41e7e3b43dde4b0.png
deleted file mode 100644
index 75e6aae..0000000
Binary files a/doc_release/html/_images/math/ba965e654c5ec9abe8bf921fd41e7e3b43dde4b0.png and /dev/null differ
diff --git a/doc_release/html/_images/math/bc72083139d50ca1c82eff5c34358cbf59681589.png b/doc_release/html/_images/math/bc72083139d50ca1c82eff5c34358cbf59681589.png
deleted file mode 100644
index be6d75f..0000000
Binary files a/doc_release/html/_images/math/bc72083139d50ca1c82eff5c34358cbf59681589.png and /dev/null differ
diff --git a/doc_release/html/_images/math/bcee6c37dfd1a7a67d3822d10237dc01ce594b3b.png b/doc_release/html/_images/math/bcee6c37dfd1a7a67d3822d10237dc01ce594b3b.png
deleted file mode 100644
index db04593..0000000
Binary files a/doc_release/html/_images/math/bcee6c37dfd1a7a67d3822d10237dc01ce594b3b.png and /dev/null differ
diff --git a/doc_release/html/_images/math/be491eb56d45c1acfd43c8ffd9faf848b245a47f.png b/doc_release/html/_images/math/be491eb56d45c1acfd43c8ffd9faf848b245a47f.png
deleted file mode 100644
index 1d60c0a..0000000
Binary files a/doc_release/html/_images/math/be491eb56d45c1acfd43c8ffd9faf848b245a47f.png and /dev/null differ
diff --git a/doc_release/html/_images/math/bf648023c5ad7bdbf4d2216ab0c0c735a53cd195.png b/doc_release/html/_images/math/bf648023c5ad7bdbf4d2216ab0c0c735a53cd195.png
deleted file mode 100644
index 7fdaf2d..0000000
Binary files a/doc_release/html/_images/math/bf648023c5ad7bdbf4d2216ab0c0c735a53cd195.png and /dev/null differ
diff --git a/doc_release/html/_images/math/c25c28183d05c687a78814901f4c72cd533bad55.png b/doc_release/html/_images/math/c25c28183d05c687a78814901f4c72cd533bad55.png
deleted file mode 100644
index 5797c8b..0000000
Binary files a/doc_release/html/_images/math/c25c28183d05c687a78814901f4c72cd533bad55.png and /dev/null differ
diff --git a/doc_release/html/_images/math/c2f20eff2112fdc5d8e16ed16276fbf7a9e4b2aa.png b/doc_release/html/_images/math/c2f20eff2112fdc5d8e16ed16276fbf7a9e4b2aa.png
deleted file mode 100644
index 0dd56e0..0000000
Binary files a/doc_release/html/_images/math/c2f20eff2112fdc5d8e16ed16276fbf7a9e4b2aa.png and /dev/null differ
diff --git a/doc_release/html/_images/math/c3c08496f07567285212e468b173bea9ca153fab.png b/doc_release/html/_images/math/c3c08496f07567285212e468b173bea9ca153fab.png
deleted file mode 100644
index 89f96e1..0000000
Binary files a/doc_release/html/_images/math/c3c08496f07567285212e468b173bea9ca153fab.png and /dev/null differ
diff --git a/doc_release/html/_images/math/c53a18c6d4f4b9e4ffcdcb4334fddc185bed5606.png b/doc_release/html/_images/math/c53a18c6d4f4b9e4ffcdcb4334fddc185bed5606.png
deleted file mode 100644
index fefeeb1..0000000
Binary files a/doc_release/html/_images/math/c53a18c6d4f4b9e4ffcdcb4334fddc185bed5606.png and /dev/null differ
diff --git a/doc_release/html/_images/math/c5dd45762fff5ecd449ce021d8c9d79e7ce0228f.png b/doc_release/html/_images/math/c5dd45762fff5ecd449ce021d8c9d79e7ce0228f.png
deleted file mode 100644
index 107712e..0000000
Binary files a/doc_release/html/_images/math/c5dd45762fff5ecd449ce021d8c9d79e7ce0228f.png and /dev/null differ
diff --git a/doc_release/html/_images/math/c69691d64985442217922c8d34e835a9dea60178.png b/doc_release/html/_images/math/c69691d64985442217922c8d34e835a9dea60178.png
deleted file mode 100644
index 2a9d564..0000000
Binary files a/doc_release/html/_images/math/c69691d64985442217922c8d34e835a9dea60178.png and /dev/null differ
diff --git a/doc_release/html/_images/math/c7ca48f867cc97d68b163a2af6d919e9c0946ecb.png b/doc_release/html/_images/math/c7ca48f867cc97d68b163a2af6d919e9c0946ecb.png
deleted file mode 100644
index 95fbbaf..0000000
Binary files a/doc_release/html/_images/math/c7ca48f867cc97d68b163a2af6d919e9c0946ecb.png and /dev/null differ
diff --git a/doc_release/html/_images/math/cce2bc22b994e1fe14f6bc3077fa77b64a0555f0.png b/doc_release/html/_images/math/cce2bc22b994e1fe14f6bc3077fa77b64a0555f0.png
deleted file mode 100644
index 0c85a78..0000000
Binary files a/doc_release/html/_images/math/cce2bc22b994e1fe14f6bc3077fa77b64a0555f0.png and /dev/null differ
diff --git a/doc_release/html/_images/math/d49f1c024407380df81f487799de241fa4e9d29f.png b/doc_release/html/_images/math/d49f1c024407380df81f487799de241fa4e9d29f.png
deleted file mode 100644
index fbaa4e4..0000000
Binary files a/doc_release/html/_images/math/d49f1c024407380df81f487799de241fa4e9d29f.png and /dev/null differ
diff --git a/doc_release/html/_images/math/d60c41febe30c67efaee8216fe35af082d6cab6e.png b/doc_release/html/_images/math/d60c41febe30c67efaee8216fe35af082d6cab6e.png
deleted file mode 100644
index 55d0f64..0000000
Binary files a/doc_release/html/_images/math/d60c41febe30c67efaee8216fe35af082d6cab6e.png and /dev/null differ
diff --git a/doc_release/html/_images/math/de66977e7eb1a104b8a5f8ae0c626f7e6594f9b8.png b/doc_release/html/_images/math/de66977e7eb1a104b8a5f8ae0c626f7e6594f9b8.png
deleted file mode 100644
index b804e72..0000000
Binary files a/doc_release/html/_images/math/de66977e7eb1a104b8a5f8ae0c626f7e6594f9b8.png and /dev/null differ
diff --git a/doc_release/html/_images/math/e42055dc76c465a7738328232a9ed4a0e4d5d7bc.png b/doc_release/html/_images/math/e42055dc76c465a7738328232a9ed4a0e4d5d7bc.png
deleted file mode 100644
index a0070d3..0000000
Binary files a/doc_release/html/_images/math/e42055dc76c465a7738328232a9ed4a0e4d5d7bc.png and /dev/null differ
diff --git a/doc_release/html/_images/math/e4af8dccac00219b863b8d3e54ec16c00b56bab2.png b/doc_release/html/_images/math/e4af8dccac00219b863b8d3e54ec16c00b56bab2.png
deleted file mode 100644
index 12e0429..0000000
Binary files a/doc_release/html/_images/math/e4af8dccac00219b863b8d3e54ec16c00b56bab2.png and /dev/null differ
diff --git a/doc_release/html/_images/math/e6c0bd5b79c290b47b422e07545c3757ca182270.png b/doc_release/html/_images/math/e6c0bd5b79c290b47b422e07545c3757ca182270.png
deleted file mode 100644
index 639884a..0000000
Binary files a/doc_release/html/_images/math/e6c0bd5b79c290b47b422e07545c3757ca182270.png and /dev/null differ
diff --git a/doc_release/html/_images/math/e7dd26bab98d33d93cdd54aa2b75e8622cd88726.png b/doc_release/html/_images/math/e7dd26bab98d33d93cdd54aa2b75e8622cd88726.png
deleted file mode 100644
index fde7b90..0000000
Binary files a/doc_release/html/_images/math/e7dd26bab98d33d93cdd54aa2b75e8622cd88726.png and /dev/null differ
diff --git a/doc_release/html/_images/math/ee7aa56d2b8706d40a5f2a2567ee71d67171d5b3.png b/doc_release/html/_images/math/ee7aa56d2b8706d40a5f2a2567ee71d67171d5b3.png
deleted file mode 100644
index fed2e63..0000000
Binary files a/doc_release/html/_images/math/ee7aa56d2b8706d40a5f2a2567ee71d67171d5b3.png and /dev/null differ
diff --git a/doc_release/html/_images/math/ef43507b4741e98bc4b61f4db403014529dd469c.png b/doc_release/html/_images/math/ef43507b4741e98bc4b61f4db403014529dd469c.png
deleted file mode 100644
index 49382f5..0000000
Binary files a/doc_release/html/_images/math/ef43507b4741e98bc4b61f4db403014529dd469c.png and /dev/null differ
diff --git a/doc_release/html/_images/math/f30c7e391f4cef1d7b14050b5916c857c0979cb5.png b/doc_release/html/_images/math/f30c7e391f4cef1d7b14050b5916c857c0979cb5.png
deleted file mode 100644
index 54c75d7..0000000
Binary files a/doc_release/html/_images/math/f30c7e391f4cef1d7b14050b5916c857c0979cb5.png and /dev/null differ
diff --git a/doc_release/html/_images/math/f71cb1117d2cc55d5b606da6f24200896cbad58b.png b/doc_release/html/_images/math/f71cb1117d2cc55d5b606da6f24200896cbad58b.png
deleted file mode 100644
index 537f249..0000000
Binary files a/doc_release/html/_images/math/f71cb1117d2cc55d5b606da6f24200896cbad58b.png and /dev/null differ
diff --git a/doc_release/html/_images/math/f7e73389b494d356293b5ad9e3601a3a61609e96.png b/doc_release/html/_images/math/f7e73389b494d356293b5ad9e3601a3a61609e96.png
deleted file mode 100644
index 95b2f3f..0000000
Binary files a/doc_release/html/_images/math/f7e73389b494d356293b5ad9e3601a3a61609e96.png and /dev/null differ
diff --git a/doc_release/html/_images/math/f8117cd5193e9c43e4cac4a86cc0298690ef3f79.png b/doc_release/html/_images/math/f8117cd5193e9c43e4cac4a86cc0298690ef3f79.png
deleted file mode 100644
index f43e112..0000000
Binary files a/doc_release/html/_images/math/f8117cd5193e9c43e4cac4a86cc0298690ef3f79.png and /dev/null differ
diff --git a/doc_release/html/_images/math/f89c41c37bb6f9cb2ed3731079e099d908b0cfa0.png b/doc_release/html/_images/math/f89c41c37bb6f9cb2ed3731079e099d908b0cfa0.png
deleted file mode 100644
index e580144..0000000
Binary files a/doc_release/html/_images/math/f89c41c37bb6f9cb2ed3731079e099d908b0cfa0.png and /dev/null differ
diff --git a/doc_release/html/_images/pirata.png b/doc_release/html/_images/pirata.png
deleted file mode 100644
index ccac077..0000000
Binary files a/doc_release/html/_images/pirata.png and /dev/null differ
diff --git a/doc_release/html/_images/rendering.png b/doc_release/html/_images/rendering.png
deleted file mode 100644
index 08650c1..0000000
Binary files a/doc_release/html/_images/rendering.png and /dev/null differ
diff --git a/doc_release/html/_images/vertical_slice.png b/doc_release/html/_images/vertical_slice.png
deleted file mode 100644
index 53b2283..0000000
Binary files a/doc_release/html/_images/vertical_slice.png and /dev/null differ
diff --git a/doc_release/html/_sources/B.txt b/doc_release/html/_sources/B.txt
deleted file mode 100644
index d217dc9..0000000
--- a/doc_release/html/_sources/B.txt
+++ /dev/null
@@ -1,10 +0,0 @@
-#
-B
-#
-
-.. toctree::
- :maxdepth: 1
-
- blockmean
- blockmedian
- blockmode
diff --git a/doc_release/html/_sources/F.txt b/doc_release/html/_sources/F.txt
deleted file mode 100644
index 4de30ea..0000000
--- a/doc_release/html/_sources/F.txt
+++ /dev/null
@@ -1,9 +0,0 @@
-#
-F
-#
-
-.. toctree::
- :maxdepth: 1
-
- filter1d
- fitcircle
diff --git a/doc_release/html/_sources/GM.txt b/doc_release/html/_sources/GM.txt
deleted file mode 100644
index 6f78752..0000000
--- a/doc_release/html/_sources/GM.txt
+++ /dev/null
@@ -1,27 +0,0 @@
-##
-GM
-##
-
-.. toctree::
- :maxdepth: 1
-
- gmt.conf
- gmt
- gmt2kml
- gmt5syntax
- gmtcolors
- gmtconnect
- gmtconvert
- gmtdefaults
- gmtget
- gmtinfo
- gmtlogo
- gmtmath
- gmtselect
- gmtset
- gmt_shell_functions.sh
- gmtsimplify
- gmtspatial
- gmtswitch
- gmtvector
- gmtwhich
diff --git a/doc_release/html/_sources/GMT_API.txt b/doc_release/html/_sources/GMT_API.txt
deleted file mode 100644
index b7d820c..0000000
--- a/doc_release/html/_sources/GMT_API.txt
+++ /dev/null
@@ -1,2772 +0,0 @@
-:tocdepth: 4
-
-.. set default highlighting language for this document:
-
-.. highlight:: c
-
-**The Generic Mapping Tools**
-
-**C/C++ Application Programming Interface**
-
-**Pål (Paul) Wessel**
-
-**SOEST, University of Hawai'i at Manoa**
-
-**Walter H. F. Smith**
-
-**Laboratory for Satellite Altimetry, NOAA/NESDIS/STAR**
-
-**Remko Scharroo**
-
-**EUMETSAT, Darmstadt, Germany**
-
-**Joaquim F. Luis**
-
-**Universidade do Algarve, Faro, Portugal**
-
-**Florian Wobbe**
-
-**Alfred Wegener Institute, Germany**
-
-Introduction
-============
-
-.. index:: ! API
-
-Preamble
---------
-
-.. figure:: /_images/GMT4_mode.png
- :height: 535 px
- :width: 1013 px
- :align: center
- :scale: 50 %
-
- GMT 4 programs contain all the high-level functionality.
-
-
-Prior to version 5, the bulk of GMT functionality was coded directly
-in the standard GMT C program modules (e.g., ``surface.c``, ``psxy.c``, ``grdimage.c``, etc.). The
-GMT library only offered access to low-level functions from which
-those high-level GMT programs were built. The standard GMT programs
-have been very successful, with tens of thousands of users world-wide.
-However, the design of the main programs prevented developers from
-leveraging GMT functionality from within other programming
-environments since access to GMT tools could only be achieved via
-system calls [1]_. Consequently, all data i/o had to be done via
-temporary files. The design also prevented the GMT developers
-themselves from taking advantage of these modules directly. For
-instance, the tool :doc:`pslegend` needed to
-make extensive use of system calls to :doc:`psxy` and
-:doc:`pstext` in order to plot the lines,
-symbols and text that make up a map legend, making it a very awkward
-program to maintain.
-
-.. figure:: /_images/GMT5_mode.png
- :height: 569 px
- :width: 1013 px
- :align: center
- :scale: 50 %
-
- GMT 5 programs contain all the high-level functionality.
-
-
-Starting with GMT version 5, all standard GMT programs have been
-split into a short driver program (the "new" GMT programs) and a
-function "module". The drivers simply call the corresponding
-GMT modules; it is these modules that do all the work. These new
-functions have been placed in a new GMT high-level API library and can
-be called from a variety of environments (C/C++, Fortran, Julia, Python,
-Matlab, Visual Basic, R, etc.) [2]_. For example, the main
-program ``blockmean.c`` has been reconfigured as a high-level function
-``GMT_blockmean()``, which does the actual spatial averaging and can
-pass the result back to the calling program (or write it to file). The
-previous behavior of ``blockmean.c`` is replicated by a short driver program that simply
-collects user arguments and then calls ``GMT_blockmean()``. Indeed, the
-driver programs for all the standard GMT programs are identical so
-that the makefile generates them on-the-fly when it compiles and links
-them with the GMT library into executables. Thus, ``blockmean.c`` and others do in
-fact no longer exist.
-
-The i/o abstraction layer
--------------------------
-
-In order for this interface to be as flexible as possible we have
-generalized the notion of input and output. Data that already reside in
-an application's memory may serve as input to a GMT function. Other
-sources of input may be file pointers and file descriptors (as well as
-the already-supported mechanism for passing file names). For standard
-data table i/o, the GMT API takes care of the task of assembling any
-combination of files, pointers, and memory locations into *a single
-virtual data set* from which the GMT function may read (a) all
-records at once into memory, or (b) read one record at a time. Likewise,
-GMT functions may write their output to a virtual destination, which
-might be a memory location in the user's application, a file pointer or
-descriptor, or an output file. The GMT functions are unaware of these
-details and simply read from a "source" and write to a "destination".
-
-Our audience
-------------
-
-Here, we document the new functions in the GMT API library for
-application developers who wish to call these functions from their own
-custom programs. At this point, only the new high-level GMT API is
-fully documented and intended for public use. The structure and
-documentation of the under-lying lower-level GMT library is not
-finalized. Developers using these functions may risk disruption to their
-programs due to changes we may make in the library in support of the
-GMT API. However, developers who wish to make supplemental packages to
-be distributed as part of GMT will (other than talk to us) probably
-want to access the entire low-level GMT library as well. It is
-unlikely that the low-level library will ever be fully documented.
-
-Definitions
------------
-
-For the purpose of this documentation a few definitions are needed:
-
-#. "Standard GMT program" refers to one of the traditional stand-alone
- command-line executables known to all GMT users, e.g.,
- :doc:`blockmean`, :doc:`psxy`,
- :doc:`grdimage`, etc. Prior to version 5,
- these were the only GMT executables available.
-
-#. "\ GMT module" refers to the function in the GMT API library that
- is responsible for all the action taken by the corresponding
- GMT program. All such modules are given the same name as the
- corresponding program but carry the prefix ``GMT_``, e.g.,
- ``GMT_blockmean``.
-
-#. "\ GMT application" refers to a new application written by any
- developer and may call one or more GMT functions to create a new
- GMT-compatible executable.
-
-#. In the API description that follows we will use the type ``int`` to
- mean a 4-byte integer. All integers used in the API are 4-byte
- integers with the exception of one function where a longer integer is
- used. Since different operating systems have their own way of
- defining 8-byte integers we use C99's ``int64_t`` for this purpose;
- it is guaranteed to yield the correct type that the GMT function
- expect.
-
-In version 5, the standard GMT programs are themselves specific but
-overly simple examples of GMT applications that only call the single
-GMT function they are associated with. However, some programs such as
-:doc:`pslegend`, :doc:`gmtconvert`,
-:doc:`grdblend`,
-:doc:`grdfilter` and others call several modules.
-
-Recognized resources
---------------------
-
-The GMT API knows how to read and write five types of data common to
-GMT operations: CPT palette tables, data tables (ASCII or binary),
-text tables, GMT grids and images (reading only). In addition, we
-present two data types to facilitate the passing of simple user arrays
-(one or more equal-length data columns of any data type, e.g., double,
-char) and 2-D or 3-D user matrices (of any data type and column/row
-organization [3]_). We refer to these data types as GMT *resources*.
-There are many attributes for each of these resources and therefore we
-use a top-level structure for each type to keep them all in one
-container. These containers are given or returned by the GMT API
-functions using opaque pointers (``void *``). Below we discuss these
-containers in some detail; we will later present how they are used when
-importing or exporting them to or from files, memory locations, or
-streams. The first five are the standard GMT objects, while the latter
-two are the special user data containers to facilitate passing user
-data into and out of GMT modules. These resources are defined in the include
-file ``gmt_resources.h``; please consult this file to ensure correctness
-in case the documentation is not up-to-date.
-
-Data tables
-~~~~~~~~~~~
-
-Much data processed in GMT come in the form of ASCII, netCDF, or
-native binary data tables. These may have any number of header records
-(ASCII files only) and perhaps segment headers. GMT programs will read
-one or more such tables when importing data. However, to avoid memory
-duplication or data limitations some programs may prefer to read records one
-at the time. The GMT API has functions that let you read
-record-by-record by presenting a virtual data set that combines all the
-data tables specified as input. This simplifies record processing
-considerably. A ``struct GMT_DATASET`` may contain any number of tables,
-each with any number of segments, each segment with any number of
-records, and each record with any number of columns. Thus, the arguments
-to GMT API functions that handle such data sets expect this type of
-variable. All segments are expected to have the same number of columns.
-
-.. _struct-dataset:
-
-.. code-block:: c
-
- struct GMT_DATASET { /* Single container for an array of GMT tables (files) */
- /* Variables we document for the API: */
- uint64_t n_tables; /* The total number of tables (files) contained */
- uint64_t n_columns; /* The number of data columns */
- uint64_t n_segments; /* The total number of segments across all tables */
- uint64_t n_records; /* The total number of data records across all tables */
- double *min; /* Minimum coordinate for each column */
- double *max; /* Maximum coordinate for each column */
- struct GMT_DATATABLE **table; /* Pointer to array of tables */
- /* ---- Variables "hidden" from the API ---- */
- uint64_t id; /* The internal number of the data set */
- size_t n_alloc; /* The current allocation length of tables */
- uint64_t dim[4]; /* Only used by GMT_Duplicate_Data to override dimensions */
- unsigned int geometry; /* The geometry of this dataset */
- unsigned int alloc_level; /* The level it was allocated at */
- enum GMT_enum_dest io_mode; /* -1 means write OGR format (requires proper -a),
- 0 means write everything to one destination [Default],
- 1 means use table->file[GMT_OUT] to write separate table,
- 2 means use segment->file[GMT_OUT] to write separate segments.
- 3 is same as 2 but with no filenames we create filenames from
- tbl and seg numbers */
- enum GMT_enum_alloc alloc_mode; /* Allocation mode [GMT_ALLOCATED_BY_GMT] */
- char *file[2]; /* Name of file or source [0 = in, 1 = out] */
- };
-
-Text tables
-~~~~~~~~~~~
-
-Some data needed by GMT are simply free-form ASCII text tables. In many respects these
-are handled similarly to data tables. E.g., they may have any number of
-header records and even segment headers, and GMT programs can read one
-or more tables or get text records one at the time. A
-``struct GMT_TEXTSET`` may contain any number of tables, each with any
-number of segments, and each segment with any number of records. Thus,
-the arguments to GMT API functions that handle such data sets expect
-this type of variable. The user's program may then parse and process
-such text records as required. This resources is particularly useful
-when your data consist of a mix or data coordinates and ordinary text
-since regular data tables will be parsed for floating-point columns
-only.
-
-.. _struct-textset:
-
-.. code-block:: c
-
- struct GMT_TEXTSET { /* Single container for an array of GMT text tables (files) */
- /* Variables we document for the API: */
- uint64_t n_tables; /* The total number of tables (files) contained */
- uint64_t n_segments; /* The total number of segments across all tables */
- uint64_t n_records; /* The total number of data records across all tables */
- struct GMT_TEXTTABLE **table; /* Pointer to array of tables */
- /* ---- Variables "hidden" from the API ---- */
- uint64_t id; /* The internal number of the data set */
- size_t n_alloc; /* The current allocation length of tables */
- unsigned int geometry; /* The geometry of this dataset */
- unsigned int alloc_level; /* The level it was allocated at */
- enum GMT_enum_dest io_mode; /* -1 means write OGR format (requires proper -a),
- 0 means write everything to one destination [Default],
- 1 means use table->file[GMT_OUT] to write separate table,
- 2 means use segment->file[GMT_OUT] to write separate segments.
- 3 is same as 2 but with no filenames we create filenames */
- from tbl and seg numbers */
- enum GMT_enum_alloc alloc_mode; /* Allocation mode [GMT_ALLOCATED_BY_GMT] */
- char *file[2]; /* Name of file or source [0 = in, 1 = out] */
- };
-
-GMT grids
-~~~~~~~~~
-
-GMT grids are used to represent equidistant and organized 2-D
-surfaces. These can be plotted as contour maps, color images, or as
-perspective surfaces. Because the native GMT grid is simply a 1-D
-float array with all the metadata kept in a separate header, we pass
-this information via a ``struct GMT_GRID``, which is a container that
-holds both items. Thus, the arguments to GMT API functions that handle
-GMT grids expect this type of variable.
-
-.. _struct-grid:
-
-.. code-block:: c
-
- struct GMT_GRID { /* To hold a GMT float grid and its header in one container */
- struct GMT_GRID_HEADER *header; /* Pointer to full GMT header for the grid */
- float *data; /* Pointer to the float grid */
- /* ---- Variables "hidden" from the API ---- */
- unsigned int id; /* The internal number of the grid */
- unsigned int alloc_level; /* The level it was allocated at */
- enum GMT_enum_alloc alloc_mode; /* Allocation mode [GMT_ALLOCATED_BY_GMT] */
- void *extra; /* Row-by-row machinery information [NULL] */
- };
-
-GMT images
-~~~~~~~~~~
-
-GMT images are used to represent bit-mapped images typically obtained
-via the GDAL bridge. These can be reprojected internally, such as when
-used in grdimage. Since images and grids share the concept of a header,
-we use the same header structure for grids as for images; however, some
-additional metadata attributes are also needed. Finally, the image
-itself may be of any data type and have more than one band (channel).
-Both image and header information are passed via a ``struct GMT_IMAGE``,
-which is a container that holds both items. Thus, the arguments to
-GMT API functions that handle GMT images expect this type of
-variable. Unlike the other objects, writting images has only partial
-support via ``GMT_grdimage`` [4]_.
-
-.. _struct-image:
-
-.. code-block:: c
-
- struct GMT_IMAGE {
- enum GMT_enum_type type; /* Data type, e.g. GMT_FLOAT */
- int *ColorMap; /* Array with color lookup values */
- struct GMT_GRID_HEADER *header; /* Pointer to full GMT header for the image */
- unsigned char *data; /* Pointer to actual image */
- /* ---- Variables "hidden" from the API ---- */
- uint64_t id; /* The internal number of the data set */
- unsigned int alloc_level; /* Level of initial allocation */
- enum GMT_enum_alloc alloc_mode; /* Allocation info [0] */
- const char *ColorInterp;
- };
-
-CPT palette tables
-~~~~~~~~~~~~~~~~~~
-
-The color palette table files, or just CPT tables, contain colors and
-patterns used for plotting data such as surfaces (i.e., GMT grids) or
-symbols, lines and polygons (i.e., GMT tables). GMT programs will
-generally read in a CPT palette table, make it the current palette, do
-the plotting, and destroy the table when done. The information is
-referred to via a pointer to ``struct GMT_PALETTE``. Thus, the arguments
-to GMT API functions that handle palettes expect this type of
-variable. It is not expected that users will wish to manipulate a CPT
-table directly, but rather use this mechanism to hold them in memory and
-pass as arguments to GMT modules.
-
-.. _struct-palette:
-
-.. code-block:: c
-
- struct GMT_PALETTE { /* Holds all pen, color, and fill-related parameters */
- /* Variables we document for the API: */
- unsigned int n_headers; /* Number of CPT file header records (0 if no header) */
- unsigned int n_colors; /* Number of colors in CPT lookup table */
- unsigned int cpt_flags; /* Flags controling use of BFN colors */
- struct GMT_LUT *range; /* CPT lookup table read by GMT_read_cpt */
- struct GMT_BFN_COLOR patch[3]; /* Structures with back/fore/nan colors */
- char **header; /* Array with all CPT file header records, if any) */
- /* ---- Variables "hidden" from the API ---- */
- uint64_t id; /* The internal number of the data set */
- enum GMT_enum_alloc alloc_mode; /* Allocation mode [GMT_ALLOCATED_BY_GMT] */
- unsigned int alloc_level; /* The level it was allocated at */
- unsigned int model; /* RGB, HSV, CMYK */
- unsigned int is_gray; /* true if only grayshades are needed */
- unsigned int is_bw; /* true if only black and white are needed */
- unsigned int is_continuous; /* true if continuous color tables have been given */
- unsigned int has_pattern; /* true if cpt file contains any patterns */
- unsigned int skip; /* true if current z-slice is to be skipped */
- unsigned int categorical; /* true if CPT applies to categorical data */
- unsigned int z_adjust[2]; /* 1 if +u<unit> was parsed and scale set, 3 if z has been adjusted, 0 otherwise */
- unsigned int z_mode[2]; /* 1 if +U<unit> was parsed, 0 otherwise */
- unsigned int z_unit[2]; /* Unit enum specified via +u<unit> */
- double z_unit_to_meter[2]; /* Scale, given z_unit, to convert z from <unit> to meters */
- };
-
-User data columns (GMT vectors)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Programs that wish to call GMT modules may hold data in their own
-particular data structures. For instance, the user's program may have
-three column arrays of type float and wishes to use these as the input
-source to the ``GMT_surface`` module, which normally expects double
-precision triplets via a ``struct GMT_DATASET`` read from a file or
-given by memory reference. Simply create a new ``struct GMT_VECTOR``
-(see section :ref:`Create empty resources <sec-create>`) and assign the union array pointers (see
-:ref:`univector <struct-univector>`) to your data columns and provide the required
-information on length, data types, and optionally range (see
-:ref:`GMT_VECTOR <struct-vector>`). By letting the GMT module know you are passing a
-data set *via* a ``struct GMT_VECTOR`` it will know how to read the data correctly.
-
-.. _struct-univector:
-
-.. code-block:: c
-
- union GMT_UNIVECTOR {
- uint8_t *uc1; /* Pointer for unsigned 1-byte array */
- int8_t *sc1; /* Pointer for signed 1-byte array */
- uint16_t *ui2; /* Pointer for unsigned 2-byte array */
- int16_t *si2; /* Pointer for signed 2-byte array */
- uint32_t *ui4; /* Pointer for unsigned 4-byte array */
- int32_t *si4; /* Pointer for signed 4-byte array */
- uint64_t *ui8; /* Pointer for unsigned 8-byte array */
- int64_t *si8; /* Pointer for signed 8-byte array */
- float *f4; /* Pointer for float array */
- double *f8; /* Pointer for double array */
- };
-
-
-Table 1.1: Definition of the ``GMT_UNIVECTOR`` union that holds a pointer to any array type.
-
-
-.. _struct-vector:
-
-.. code-block:: c
-
- struct GMT_VECTOR {
- uint64_t n_columns; /* Number of vectors */
- uint64_t n_rows; /* Number of rows in each vector */
- enum GMT_enum_reg registration; /* 0 for gridline and 1 for pixel registration */
- enum GMT_enum_type *type; /* Array with data type for each vector */
- union GMT_UNIVECTOR *data; /* Array with unions for each column */
- double range[2]; /* The min and max limits on t-range (or 0,0) */
- char command[GMT_GRID_COMMAND_LEN320]; /* name of generating command */
- char remark[GMT_GRID_REMARK_LEN160]; /* comments re this data set */
- /* ---- Variables "hidden" from the API ---- */
- uint64_t id; /* An identification number */
- unsigned int alloc_level; /* Level of initial allocation */
- enum GMT_enum_alloc alloc_mode; /* Determines if we may free the vectors or not */
- };
-
-
-User data matrices (GMT matrices)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Likewise, programs may have an integer 2-D matrix in memory and wish to
-use that as the input grid to the ``GMT_grdfilter`` module, which
-normally expects a ``struct GMT_GRID`` with floating point data via a
-file or provided by memory reference. As for user vectors, we create a
-``struct GMT_MATRIX`` (see :ref:`Create empty resources <sec-create>`), assign the appropriate
-union pointer to your data matrix and provide information on dimensions
-and data type. Let the GMT module know you
-are passing a grid via a ``struct GMT_MATRIX`` and it will know how to
-read the matrix properly.
-
-.. _struct-matrix:
-
-.. code-block:: c
-
- struct GMT_MATRIX {
- uint64_t n_rows; /* Number of rows in the matrix */
- uint64_t n_columns; /* Number of columns in the matrix */
- uint64_t n_layers; /* Number of layers in a 3-D matrix */
- enum GMT_enum_fmt shape; /* 0 = C (rows) and 1 = Fortran (cols) */
- enum GMT_enum_reg registration; /* 0 for gridline and 1 for pixel registration */
- size_t dim; /* Allocated length of longest C or Fortran dim */
- size_t size; /* Byte length of data */
- enum GMT_enum_type type; /* Data type, e.g. GMT_FLOAT */
- double range[6]; /* Contains xmin/xmax/ymin/ymax[/zmin/zmax] */
- union GMT_UNIVECTOR data; /* Union with pointer to actual matrix of the chosen type */
- char command[GMT_GRID_COMMAND_LEN320]; /* name of generating command */
- char remark[GMT_GRID_REMARK_LEN160]; /* comments re this data set */
- /* ---- Variables "hidden" from the API ---- */
- uint64_t id; /* The internal number of the data set */
- unsigned int alloc_level; /* The level it was allocated at */
- enum GMT_enum_alloc alloc_mode; /* Allocation mode [GMT_ALLOCATED_BY_GMT] */
- };
-
-The ``enum`` types referenced in :ref:`GMT_VECTOR <struct-vector>` and
-Table :ref:`GMT_MATRIX <struct-matrix>` and summarized in Table :ref:`types <tbl-types>`.
-
-.. _tbl-types:
-
-+--------------+------------------------------------------+
-| constant | description |
-+==============+==========================================+
-| GMT_CHAR | int8_t, 1-byte signed integer type |
-+--------------+------------------------------------------+
-| GMT_UCHAR | int8_t, 1-byte unsigned integer type |
-+--------------+------------------------------------------+
-| GMT_SHORT | int16_t, 2-byte signed integer type |
-+--------------+------------------------------------------+
-| GMT_USHORT | uint16_t, 2-byte unsigned integer type |
-+--------------+------------------------------------------+
-| GMT_INT | int32_t, 4-byte signed integer type |
-+--------------+------------------------------------------+
-| GMT_UINT | uint32_t, 4-byte unsigned integer type |
-+--------------+------------------------------------------+
-| GMT_LONG | int64_t, 8-byte signed integer type |
-+--------------+------------------------------------------+
-| GMT_ULONG | uint64_t, 8-byte unsigned integer type |
-+--------------+------------------------------------------+
-| GMT_FLOAT | 4-byte data float type |
-+--------------+------------------------------------------+
-| GMT_DOUBLE | 8-byte data float type |
-+--------------+------------------------------------------+
-+--------------+------------------------------------------+
-
-.. _chapter-overview:
-
-Overview of the GMT C Application Program Interface
-===================================================
-
-Users who wish to create their own GMT application based on the API
-must make sure their program goes through the steps below; details for
-each step will be revealed in the following chapter. We have kept the
-API simple: In addition to the GMT modules, there are only 52 public
-functions to become familiar with, but most applications will only use a
-small subset of this selection. Functions either return an integer error
-code (when things go wrong; otherwise it is set to ``GMT_OK (0)``), or they
-return a void pointer to a GMT resources (or NULL if things go wrong).
-In either case the API will report what the error is. The layout here
-assumes you wish to use data in memory as input sources; if the data are
-simply command-line files then things simplify considerably.
-
-#. Initialize a new GMT session with GMT_Create_Session_, which
- allocates a hidden GMT API control structure and returns an opaque
- pointer to it. This pointer is the first argument to all subsequent
- GMT API function calls within the session.
-
-#. For each intended call to a GMT module, several steps are involved:
-
- a. Register input sources and output destination with GMT_Register_IO_.
-
- b. Each resource registration generates a unique ID number. For
- memory resources, we embed these numbers in unique filenames of
- the form "@GMTAPI at -######" with GMT_Encode_ID_. When GMT i/o library
- functions encounter such filenames they extract the ID and make a
- connection to the corresponding resource. Multiple table data or text
- sources are combined into a single virtual source for GMT modules to
- operate on. In contrast, CPT, Grid, and Image resources are
- operated on individually.
-
- c. Enable data import once all registrations are complete
- (:ref:`Resources init <sec-res_init>`).
-
- d. Read data into memory. You may choose to read everything at once
- or read record-by-record.
-
- e. Prepare required arguments and call the GMT module you wish to use.
-
- f. For non-mapping modules, process any results returned to memory via
- pointers rather than written to files.
-
- g. Destroy the resources allocated by GMT modules to hold results,
- or let the garbage collector do this automatically at the end of
- the session.
-
-#. Repeat steps a–f as many times as your application requires.
-
-#. We terminate the GMT session by calling GMT_Destroy_Session_.
-
-The steps a–d collapse into a single step if data are simply read from files.
-
-Advanced programs may be calling more than one GMT session and thus
-run several sessions, perhaps concurrently as different threads on
-multi-core machines. We will now discuss these steps in more detail.
-Throughout, we will introduce upper-case GMT C enum constants *in
-lieu* of simple integer constants. These are considered part of the API
-and are available for developers via the ``gmt_resources.h`` include file.
-
-The C/C++ API is deliberately kept small to make it easy to use.
-Next table gives a list of all the functions and their purpose.
-
-.. _tbl-API:
-
-+-------------------------+---------------------------------------------------+
-| constant | description |
-+=========================+===================================================+
-| GMT_Append_Option_ | Append new option structure to linked list |
-+-------------------------+---------------------------------------------------+
-| GMT_Begin_IO_ | Enable record-by-record i/o |
-+-------------------------+---------------------------------------------------+
-| GMT_Call_Module_ | Call any of the GMT modules |
-+-------------------------+---------------------------------------------------+
-| GMT_Create_Args_ | Convert linked list of options to text array |
-+-------------------------+---------------------------------------------------+
-| GMT_Create_Cmd_ | Convert linked list of options to command line |
-+-------------------------+---------------------------------------------------+
-| GMT_Create_Data_ | Create an empty data resource |
-+-------------------------+---------------------------------------------------+
-| GMT_Create_Options_ | Convert command line options to linked list |
-+-------------------------+---------------------------------------------------+
-| GMT_Create_Session_ | Initialize a new GMT session |
-+-------------------------+---------------------------------------------------+
-| GMT_Delete_Option_ | Delete an option structure from the linked list |
-+-------------------------+---------------------------------------------------+
-| GMT_Destroy_Args_ | Delete text array of arguments |
-+-------------------------+---------------------------------------------------+
-| GMT_Destroy_Cmd_ | Delete text command of arguments |
-+-------------------------+---------------------------------------------------+
-| GMT_Destroy_Data_ | Delete a data resource |
-+-------------------------+---------------------------------------------------+
-| GMT_Destroy_Options_ | Delete the linked list of option structures |
-+-------------------------+---------------------------------------------------+
-| GMT_Destroy_Session_ | Terminate a GMT session |
-+-------------------------+---------------------------------------------------+
-| GMT_Duplicate_Data_ | Make an identical copy of a data resources |
-+-------------------------+---------------------------------------------------+
-| GMT_Encode_ID_ | Encode a resources ID as a special filename |
-+-------------------------+---------------------------------------------------+
-| GMT_End_IO_ | Disable further record-by-record i/o |
-+-------------------------+---------------------------------------------------+
-| GMT_FFT_ | Take the Fast Fourier Transform of data object |
-+-------------------------+---------------------------------------------------+
-| GMT_FFT_1D_ | Take the Fast Fourier Transform of 1-D float data |
-+-------------------------+---------------------------------------------------+
-| GMT_FFT_2D_ | Take the Fast Fourier Transform of 2-D float data |
-+-------------------------+---------------------------------------------------+
-| GMT_FFT_Create_ | Initialize the FFT machinery |
-+-------------------------+---------------------------------------------------+
-| GMT_FFT_Destroy_ | Terminate the FFT machinery |
-+-------------------------+---------------------------------------------------+
-| GMT_FFT_Option_ | Explain the FFT options and modifiers |
-+-------------------------+---------------------------------------------------+
-| GMT_FFT_Parse_ | Parse argument with FFT options and modifiers |
-+-------------------------+---------------------------------------------------+
-| GMT_FFT_Wavenumber_ | Return wavenumber given data index |
-+-------------------------+---------------------------------------------------+
-| GMT_Find_Option_ | Find an option in the linked list |
-+-------------------------+---------------------------------------------------+
-| GMT_Get_Common_ | Determine if a GMT common option was set |
-+-------------------------+---------------------------------------------------+
-| GMT_Get_Coord_ | Create a coordinate array |
-+-------------------------+---------------------------------------------------+
-| GMT_Get_Data_ | Import a registered data resources |
-+-------------------------+---------------------------------------------------+
-| GMT_Get_Default_ | Obtain as string one of the GMT default settings |
-+-------------------------+---------------------------------------------------+
-| GMT_Get_ID_ | Obtain the ID of a given resource |
-+-------------------------+---------------------------------------------------+
-| GMT_Get_Index_ | Convert row, col into a grid or image index |
-+-------------------------+---------------------------------------------------+
-| GMT_Get_Record_ | Import a single data record |
-+-------------------------+---------------------------------------------------+
-| GMT_Get_Row_ | Import a single grid row |
-+-------------------------+---------------------------------------------------+
-| GMT_Get_Value_ | Convert string into coordinates or dimensions |
-+-------------------------+---------------------------------------------------+
-| GMT_Init_IO_ | Initialize i/o given registered resources |
-+-------------------------+---------------------------------------------------+
-| GMT_Make_Option_ | Create an option structure |
-+-------------------------+---------------------------------------------------+
-| GMT_Message_ | Issue a message, optionally with time stamp |
-+-------------------------+---------------------------------------------------+
-| GMT_Option_ | Explain one or more GMT common options |
-+-------------------------+---------------------------------------------------+
-| GMT_Parse_Common_ | Parse the GMT common options |
-+-------------------------+---------------------------------------------------+
-| GMT_Put_Data_ | Export to a registered data resource given by ID |
-+-------------------------+---------------------------------------------------+
-| GMT_Put_Record_ | Export a data record |
-+-------------------------+---------------------------------------------------+
-| GMT_Put_Row_ | Export a grid row |
-+-------------------------+---------------------------------------------------+
-| GMT_Read_Data_ | Import a data resource or file |
-+-------------------------+---------------------------------------------------+
-| GMT_Register_IO_ | Register a resources for i/o |
-+-------------------------+---------------------------------------------------+
-| GMT_Report_ | Issue a message contingent upon verbosity level |
-+-------------------------+---------------------------------------------------+
-| GMT_Retrieve_Data_ | Obtained link to data in memory via ID |
-+-------------------------+---------------------------------------------------+
-| GMT_Set_Comment_ | Assign a comment to a data resource |
-+-------------------------+---------------------------------------------------+
-| GMT_Status_IO_ | Check status of record-by-record i/o |
-+-------------------------+---------------------------------------------------+
-| GMT_Update_Option_ | Modify an option structure |
-+-------------------------+---------------------------------------------------+
-| GMT_Write_Data_ | Export a data resource |
-+-------------------------+---------------------------------------------------+
-
-
-The GMT C Application Program Interface
-=======================================
-
-Initialize a new GMT session
-----------------------------
-
-Most applications will need to initialize only a single GMT session.
-This is true of all the standard GMT programs since they only call one
-GMT module and then exit. Most user-developed GMT applications are
-likely to only initialize one session even though they may call many
-GMT modules. However, the GMT API supports any number of
-simultaneous sessions should the programmer wish to take advantage of
-it. This might be useful when you have access to several CPUs and want
-to spread the computing load [5]_. In the following discussion we will
-simplify our treatment to the use of a single session only.
-
-To initiate the new session we use
-
-.. _GMT_Create_Session:
-
- ::
-
- void *GMT_Create_Session (char *tag, unsigned int pad, unsigned int mode,
- int (*print_func) (FILE *, const char *));
-
-and you will typically call it thus:
-
- ::
-
- void *API = NULL;
- API = GMT_Create_Session ("Session name", 2, 0, NULL);
-
-where :ref:`API <struct-API>` is an opaque pointer to the hidden GMT API control
-structure. You will need to pass this pointer to *all* subsequent
-GMT API functions; this is how essential internal information is
-passed from module to module. The key task of this initialization is to
-set up the GMT machinery and its internal variables used for map
-projections, plotting, i/o, etc. The initialization also allocates space
-for internal structures used to register resources. The ``pad`` argument
-sets how many rows and columns should be used as padding for grids and
-images so that boundary conditions can be applied. GMT uses 2 so we
-recommend that value. The ``mode`` argument is only used for external APIs
-that need to replace GMT's calls to a hard exit upon failure with a soft return. Likewise,
-the ``print_func`` argument is a pointer to a function that is used to print
-messages via GMT_Message_ or GMT_Report_ from APIs that cannot use the
-standard printf (this is the case for the Matlab API, for instance).
-All other uses should simply pass 0 and NULL for these two arguments.
-Should something go wrong then ``API`` will be returned as ``NULL``.
-
-.. _struct-API:
-
-.. code-block:: c
-
- struct GMTAPI_CTRL {
- /* Master controller which holds all GMT API related information at run-time for a single session.
- * Users can run several GMT sessions concurrently; each session requires its own structure.
- * Use GMTAPI_Create_Session to initialize a new session and GMTAPI_Destroy_Session to end it. */
- uint64_t current_rec[2]; /* Current record number >= 0 in the combined virtual dataset (in and out) */
- unsigned int n_objects; /* Number of currently active input and output data objects */
- unsigned int unique_ID; /* Used to create unique IDs for duration of session */
- unsigned int session_ID; /* ID of this session */
- unsigned int unique_var_ID; /* Used to create unique object IDs (grid,dataset, etc) for duration of session */
- unsigned int current_item[2]; /* Array number of current dataset being processed (in and out)*/
- unsigned int pad; /* Session default for number of rows/cols padding for grids [2] */
- unsigned int mode; /* 1 if called via external API (Matlab, Python) [0] */
- unsigned int leave_grid_scaled; /* 1 if we dont want to unpack a grid after we packed it for writing [0] */
- bool registered[2]; /* true if at least one source/destination has been registered (in and out) */
- bool io_enabled[2]; /* true if access has been allowed (in and out) */
- size_t n_objects_alloc; /* Allocation counter for data objects */
- int error; /* Error code from latest API call [GMT_OK] */
- int last_error; /* Error code from previous API call [GMT_OK] */
- int shelf; /* Place to pass hidden values within API */
- unsigned int io_mode[2]; /* 1 if access as set, 0 if record-by-record */
- struct GMT_CTRL *GMT; /* Key structure with low-level GMT internal parameters */
- struct GMTAPI_DATA_OBJECT **object; /* List of registered data objects */
- char *session_tag; /* Name tag for this session (or NULL) */
- bool internal; /* true if session was initiated by gmt.c */
- bool deep_debug; /* temporary for debugging */
- int (*print_func) (FILE *, const char *); /* Pointer to fprintf function (may be reset by external APIs like MEX) */
- unsigned int do_not_exit; /* 0 by default, meaning it is OK to call exit (otherwise call return instead) */
- struct Gmt_libinfo *lib; /* List of shared libs to consider */
- unsigned int n_shared_libs; /* How many in lib */
- };
-
-.. code-block:: c
-
- struct GMTAPI_DATA_OBJECT {
- /* Information for each input or output data entity, including information
- * needed while reading/writing from a table (file or array) */
- uint64_t n_rows; /* Number or rows in this array [GMT_DATASET and GMT_TEXTSET to/from MATRIX/VETOR only] */
- uint64_t n_columns; /* Number of columns to process in this dataset [GMT_DATASET only] */
- uint64_t n_expected_fields; /* Number of expected columns for this dataset [GMT_DATASET only] */
- size_t n_alloc; /* Number of items allocated so far if writing to memory */
- unsigned int ID; /* Unique identifier which is >= 0 */
- unsigned int alloc_level; /* Nested module level when object was allocated */
- unsigned int status; /* 0 when first registered, 1 after reading/writing has started, 2 when finished */
- bool selected; /* true if requested by current module, false otherwise */
- bool close_file; /* true if we opened source as a file and thus need to close it when done */
- bool region; /* true if wesn was passed, false otherwise */
- bool no_longer_owner; /* true if the data pointed to by the object was passed on to another object */
- bool messenger; /* true for output objects passed from the outside to receive data from GMT. */
- If true we destroy data pointer before writing */
- enum GMT_enum_alloc alloc_mode; /* GMT_ALLOCATED_{BY_GMT|EXTERNALLY} */
- enum GMT_io_enum direction; /* GMT_IN or GMT_OUT */
- enum GMT_enum_family family; /* One of GMT_IS_{DATASET|TEXTSET|CPT|IMAGE|GRID|MATRIX|VECTOR|COORD} */
- enum GMT_enum_family actual_family; /* May be GMT_IS_MATRIX|VECTOR when one of the others are created via those */
- unsigned method; /* One of GMT_IS_{FILE,STREAM,FDESC,DUPLICATE,REFERENCE} or sum with enum */
- GMT_enum_via (GMT_VIA_{NONE,VECTOR,MATRIX,OUTPUT}); using unsigned type
- because sum exceeds enum GMT_enum_method */
- enum GMT_enum_geometry geometry; /* One of GMT_IS_{POINT|LINE|POLY|PLP|SURFACE|NONE} */
- double wesn[GMTAPI_N_GRID_ARGS]; /* Grid domain limits */
- void *resource; /* Points to registered filename, memory location, etc., where data can be */
- obtained from with GMT_Get_Data. */
- void *data; /* Points to GMT object that was read from a resource */
- FILE *fp; /* Pointer to source/destination stream [For rec-by-rec procession, NULL if mem location] */
- char *filename; /* Filename, stream, of file handle (otherwise NULL) */
- void *(*import) (struct GMT_CTRL *, FILE *, uint64_t *, int *); /* Pointer to input function (for DATASET/TEXTSET only) */
- #ifdef DEBUG
- struct GMT_GRID *G;
- struct GMT_DATASET *D;
- struct GMT_TEXTSET *T;
- struct GMT_PALETTE *C;
- struct GMT_MATRIX *M;
- struct GMT_VECTOR *V;
- #endif
- #ifdef HAVE_GDAL
- struct GMT_IMAGE *I;
- #endif
- };
-
-Register input or output resources
-----------------------------------
-
-When using the standard GMT programs, you specify input files on the
-command line or via special program options (e.g.,
-**-I**\ *intensity.nc*). The output of the programs are either written
-to standard output (which you redirect to files or pipe to other
-programs) or to files specified by specific program options (e.g.,
-**-G**\ *output.nc*). Alternatively, the GMT API allows you to specify
-input (and output) to be associated with open file handles or program
-variables. We will examine this more closely below. Registering a
-resource is a required step before attempting to import or export data
-that *do not* come from files or standard input/output.
-
-Resource registration
-~~~~~~~~~~~~~~~~~~~~~
-
-Registration involves a direct or indirect call to
-
-.. _GMT_Register_IO:
-
- ::
-
- int GMT_Register_IO (void *API, unsigned int family, unsigned int method,
- unsigned int geometry, unsigned int direction,
- double wesn[], void *ptr);
-
-where :ref:`family <tbl-family>` specifies what kind of resource is to be registered,
-:ref:`method <tbl-methods>` specifies
-how we to access this resource (see Table :ref:`methods <tbl-methods>` for recognized
-methods), :ref:`geometry <tbl-geometry>` specifies the geometry of the data, ``ptr`` is the address of the
-pointer to the named resource. If ``direction`` is ``GMT_OUT`` and the
-``method`` is not related to a file (filename, stream, or handle), then
-``ptr`` must be NULL. After the GMT module has written the data you
-can use GMT_Retrieve_Data_ to assign a pointer to the memory location
-(variable) where the output was allocated. For grid (and image)
-resources you may request to obtain a subset via the :ref:`wesn <tbl-wesn>` array; otherwise, pass NULL
-(or an array with at least 4 items all set to 0) to obtain the
-entire grid (or image). The ``direction`` indicates input or output and
-is either ``GMT_IN`` or ``GMT_OUT``. Finally, the function returns a
-unique resource ID, or ``GMT_NOTSET`` if there was an error.
-
-Object ID encoding
-~~~~~~~~~~~~~~~~~~
-
-To use registered resources as program input or output arguments you
-must pass them via a text string that acts as a special file name
-(Chapter :ref:`Overview <chapter-overview>`). The proper filename formatting is guaranteed by
-using the function
-
-.. _GMT_Encode_ID:
-
- ::
-
- int GMT_Encode_ID (void *API, char *filename, int ID);
-
-which accepts the unique ``ID`` and writes the corresponding
-``filename``. The variable ``filename`` must have enough space to hold
-16 bytes. The function returns 1 if there is an error; otherwise
-it returns 0.
-
-
-.. _tbl-family:
-
-+------------------+--------------------------------+
-| family | source points to |
-+==================+================================+
-| GMT_IS_DATASET | A [multi-segment] table file |
-+------------------+--------------------------------+
-| GMT_IS_TEXTSET | A [multi-segment] text file |
-+------------------+--------------------------------+
-| GMT_IS_GRID | A GMT grid file |
-+------------------+--------------------------------+
-| GMT_IS_CPT | A CPT file |
-+------------------+--------------------------------+
-| GMT_IS_IMAGE | A GMT image |
-+------------------+--------------------------------+
-
-
-.. _tbl-methods:
-
-+-------------------------------+-------+--------------------------------------------------------------+
-| method | value | how to read/write data |
-+===============================+=======+==============================================================+
-| GMT_IS_FILE | 0 | Pointer to name of a file |
-+-------------------------------+-------+--------------------------------------------------------------+
-| GMT_IS_STREAM | 1 | Pointer to open stream (or process) |
-+-------------------------------+-------+--------------------------------------------------------------+
-| GMT_IS_FDESC | 2 | Pointer to integer file descriptor |
-+-------------------------------+-------+--------------------------------------------------------------+
-| GMT_IS_DUPLICATE | 3 | Pointer to memory we may *duplicate* data from |
-+-------------------------------+-------+--------------------------------------------------------------+
-| GMT_IS_REFERENCE | 4 | Pointer to memory we may *reference* data from |
-+-------------------------------+-------+--------------------------------------------------------------+
-| GMT_IS_DUPLICATE_VIA_VECTOR | 103 | Pointer to memory we may *duplicate* data from via vectors |
-+-------------------------------+-------+--------------------------------------------------------------+
-| GMT_IS_REFERENCE_VIA_VECTOR | 104 | Pointer to memory we may *reference* data from via vectors |
-+-------------------------------+-------+--------------------------------------------------------------+
-| GMT_IS_DUPLICATE_VIA_MATRIX | 203 | Pointer to memory we may *duplicate* data from via a matrix |
-+-------------------------------+-------+--------------------------------------------------------------+
-| GMT_IS_REFERENCE_VIA_MATRIX | 204 | Pointer to memory we may *reference* data from via a matrix |
-+-------------------------------+-------+--------------------------------------------------------------+
-
-
-
-.. _tbl-via:
-
-+------------------+--------------------------------------------------------------+
-| approach | how method is modified |
-+==================+==============================================================+
-| GMT_VIA_VECTOR | User's data columns are accessed via a GMT_VECTOR structure |
-+------------------+--------------------------------------------------------------+
-| GMT_VIA_MATRIX | User's matrix is accessed via a GMT_MATRIX structure |
-+------------------+--------------------------------------------------------------+
-
-
-
-.. _tbl-geometry:
-
-+------------------+-------------------------------------------+
-| geometry | description |
-+==================+===========================================+
-| GMT_IS_TEXT | Not a geographic item |
-+------------------+-------------------------------------------+
-| GMT_IS_POINT | Multi-dimensional point data |
-+------------------+-------------------------------------------+
-| GMT_IS_LINE | Geographic or Cartesian line segments |
-+------------------+-------------------------------------------+
-| GMT_IS_POLYGON | Geographic or Cartesian closed polygons |
-+------------------+-------------------------------------------+
-| GMT_IS_SURFACE | 2-D gridded surface |
-+------------------+-------------------------------------------+
-
-
-.. _tbl-wesn:
-
-+---------+-------------------------------------------------+
-| index | description |
-+=========+=================================================+
-| GMT_XLO | x_min (west) boundary of grid subset |
-+---------+-------------------------------------------------+
-| GMT_XHI | x_max (east) boundary of grid subset |
-+---------+-------------------------------------------------+
-| GMT_YLO | y_min (south) boundary of grid subset |
-+---------+-------------------------------------------------+
-| GMT_YHI | y_max (north) boundary of grid subset |
-+---------+-------------------------------------------------+
-| GMT_ZLO | z_min (bottom) boundary of 3-D matrix subset |
-+---------+-------------------------------------------------+
-| GMT_ZHI | z_max (top) boundary of 3-D matrix subset |
-+---------+-------------------------------------------------+
-
-.. _sec-res_init:
-
-Resource initialization
-~~~~~~~~~~~~~~~~~~~~~~~
-
-All GMT programs dealing with input or output files given on the
-command line, and perhaps defaulting to the standard input or output
-streams if no files are given, must call the i/o initializer function
-GMT_Init_IO_ once for each direction required (i.e., input and output
-separately). For input it determines how many input sources have already
-been registered. If none has been registered then it scans the program
-arguments for any filenames given on the command line and register these
-input resources. Finally, if we still have found no input sources we
-assign the standard input stream as the single input source. For output
-it is similar: If no single destination has been registered we specify
-the standard output stream as the output destination. Only one main
-output destination is allowed to be active when a module writes data
-(some modules also write additional output via program-specific
-options). The prototype for this function is
-
-.. _GMT_Init_IO:
-
- ::
-
- int GMT_Init_IO (void *API, unsigned int family, unsigned int geometry,
- unsigned int direction, unsigned int mode,
- unsigned int n_args, void *args);
-
-where :ref:`family <tbl-family>` specifies what kind of resource is to be registered,
-:ref:`geometry <tbl-geometry>` specifies the geometry of the data, ``direction`` is either
-``GMT_IN`` or ``GMT_OUT``, and ``mode`` is a bit flag that determines
-what we do if no resources have been registered. The choices are
-
- **GMT_ADD_FILES_IF_NONE** (1) means "add command line (option)
- files if none have been registered already"
-
- **GMT_ADD_FILES_ALWAYS** (2) means "always add any command line files"
-
- **GMT_ADD_STDIO_IF_NONE** (4) means "add std\* if no other
- input/output have been specified"
-
- **GMT_ADD_STDIO_ALWAYS** (8) means "always add std\* even if
- resources have been registered".
-
- **GMT_ADD_EXISTING** (16) means "only use already registered resources".
-
-The standard behavior is ``GMT_REG_DEFAULT`` (5). Next, ``n_args`` is 0
-if ``args`` is the head of a linked list of options (further discussed
-in :ref:`Prepare modules opts <sec-func>`); otherwise ``args`` is an array of ``n_args``
-strings (i.e., the int argc, char \*argv[] model)
-
-Many programs will register an export location where results of a
-GMT function (say, a filtered grid) should be returned, but may then
-wish to use that variable as an *input* resource in a subsequent module
-call. This is accomplished by re-registering the resource as an *input*
-source, thereby changing the *direction* of the data set. The function
-returns 1 if there is an error; otherwise it returns 0.
-
-Dimension parameters for user 1-D column vectors
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-We refer to Table :ref:`vector <struct-vector>`. The ``type`` array must hold the data
-type of each data column in the user's program. All types other than
-GMT_DOUBLE will be converted internally in GMT to ``double``, thus
-possibly increasing memory requirements. If the type is ``GMT_DOUBLE`` then
-GMT will be able to use the column directly by reference. The
-``n_columns`` and ``n_rows`` parameters indicate the number of vectors
-and their common length. For output these may not yet be known so you should
-pass 0 for these values.
-
-Dimension parameters for user 2-D table arrays
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-We refer to Table :ref:`matrix <struct-matrix>`. The ``type`` parameter specifies the
-data type used for the array in the user's program. All types other than
-GMT_FLOAT will be converted internally in GMT to ``float``, thus
-possibly increasing memory requirements. If the type is ``GMT_FLOAT`` then
-GMT may be able to use the matrix directly by reference. The
-``n_rows`` and ``n_columns`` parameters indicate the dimensions of the
-matrix. If these are not yet known you may pass 0 for these values and
-set ``alloc_mode`` to ``GMT_ALLOCATED_BY_GMT``; this will make sure GMT will
-allocate the necessary memory at the location you specify. Fortran users
-will instead have to specify a size large enough to hold the anticipated
-output data. The ``registration`` and ``range`` gives the grid
-registration and domain. Finally, use ``dim`` to indicate if the memory
-matrix has a dimension that exceeds that of the leading row (or column)
-dimension. Note: For ``GMT_IS_TEXTSET`` the user matrix is expected to be
-a 2-D character array with a fixed row length of ``dim`` but we only
-consider the first ``n_columns`` characters. For data grids you will
-also need to specify the ``registration`` (see the GMT Cookbook and
-Reference, :ref:`App-file-formats` for description of the two forms of registration)
-and data domain ``range``.
-
-.. _sec-create:
-
-Create empty resources
-----------------------
-
-If your application needs to build and populate GMT resources in ways
-that do not depend on external resources (files, memory locations,
-etc.), then you can obtain a "blank slate" by calling
-
-.. _GMT_Create_Data:
-
- ::
-
- void *GMT_Create_Data (void *API, unsigned int family, unsigned int geometry,
- unsigned int mode, uint64_t par[], double *wesn,
- double *inc, unsigned int registration, int pad, void *data)
-
-which returns a pointer to the allocated resource. Pass :ref:`family <tbl-family>` as
-one of ``GMT_IS_GRID``, ``GMT_IS_IMAGE``, ``GMT_IS_DATASET``,
-``GMT_IS_TEXTSET``, or ``GMT_IS_CPT``, or via the modifiers ``GMT_IS_VECTOR``
-or ``GMT_IS_MATRIX`` when handling user data. Also pass a compatible
-:ref:`geometry <tbl-geometry>`. Depending on the family and your particular way of
-representing dimensions you may pass the additional parameters in one of
-two ways:
-
-#. Actual integer dimensions of items needed.
-
-#. Physical distances and increments of each dimension.
-
-For the first case pass ``wesn``, ``inc`` as NULL (or arrays with elements all set to 0),
-and pass the ``par`` array as indicated below:
-
- **GMT_IS_GRID**
- An empty :ref:`GMT_GRID <struct-grid>` structure with a header is allocated; the data
- array is NULL. The ``par`` argument is not used. Here ``wesn`` and ``inc`` can
- be NULL but than **-R** and **-I** must have been set because they are inquired to
- get the necessary info. If they were not set, than ``wesn`` and ``inc`` must in
- fact be transmitted.
-
- **GMT_IS_IMAGE**
- Same as **GMT_IS_GRID** above but return an empty :ref:`GMT_IMAGE <struct-image>`
-
- **GMT_IS_DATASET**
- An empty :ref:`GMT_DATASET <struct-dataset>` structure consisting of ``par[0]`` tables,
- each with ``par[1]`` segments, each with ``par[2]`` rows, all
- with ``par[3]`` columns, is allocated.
- The ``wesn``, ``inc``, and ``registration`` argument are ignored. The ``data`` argument should be NULL.
-
- **GMT_IS_TEXTSET**
- An empty :ref:`GMT_TEXTSET <struct-textset>` structure consisting of ``par[0]`` tables,
- each with ``par[1]`` segments, all with ``par[2]`` text records (rows), is allocated.
- The ``wesn``, ``inc``, and ``registration`` argument are ignored. The ``data`` argument should be NULL.
-
- **GMT_IS_CPT**
- An empty :ref:`GMT_PALETTE <struct-palette>` structure with ``par[0]`` palette entries is allocated.
- The ``wesn``, ``inc``, and ``registration`` argument are ignored. The ``data`` argument should be NULL.
-
- **GMT_IS_VECTOR**
- An empty :ref:`GMT_VECTOR <struct-vector>` structure with ``par[0]`` column entries is allocated.
- The ``wesn``, ``inc``, and ``registration`` argument are ignored. The ``data`` argument should be NULL.
-
- **GMT_IS_MATRIX**
- An empty :ref:`GMT_MATRIX <struct-matrix>` structure is allocated. ``par[2]`` indicates
- the number of layers for a 3-D matrix, or pass 0, 1, or NULL for a 2-D matrix. Here,
- par[0] is the number of columns while par[1] has the number of rows. The ``data`` argument should be NULL.
-
-For the second approach, you
-instead pass ``wesn``, ``inc``, and ``registration`` and leave ``par`` as NULL
-(or with all elements equal 0).
-For grids and images you may pass ``pad`` to set the padding, or -1 to
-accept the GMT default. The ``mode`` determines what is actually
-allocated when you have chosen grids or images. As for GMT_Read_Data_
-you can pass ``GMT_GRID_ALL`` to initialize the header and allocate
-space for the array; here ``data`` must be NULL. Alternatively, you can pass
-``GMT_GRID_HEADER_ONLY`` to just initialize the grid or image header,
-and call a second time, passing ``GMT_GRID_DATA_ONLY``, to allocate
-space for the array. In that second call you pass the pointer returned
-by the first call as ``data`` and specify the family; all other
-arguments should be NULL or 0. Normally, resources created by this
-function are considered to be input (i.e., have a direction that is ``GMT_IN``).
-The exception to this is for vectors and matrices which will have a direction
-set to ``GMT_OUT`` when the dimensions specified are not complete (i.e., the
-row dimension of vectors is 0 and both dimensions are zero for matrices).
-The function returns a pointer to the
-data container. In case of an error we return a NULL pointer and pass an
-error code via ``API->error``.
-
-Duplicate resources
--------------------
-
-Often you have read or created a data resource and then need an
-identical copy, presumably to make modifications to. Or, you want a copy
-with the same dimensions and allocated memory, except data values should
-not be duplicated. Alternatively, perhaps you just want to duplicate the
-header and skip the allocation and duplication of the data. These tasks
-are addressed by
-
-.. _GMT_Duplicate_Data:
-
- ::
-
- void *GMT_Duplicate_Data (void *API, unsigned int family,
- unsigned int mode, void *data);
-
-which returns a pointer to the allocated resource. Specify which
-:ref:`family <tbl-family>` and select ``mode`` from ``GMT_DUPLICATE_DATA``,
-``GMT_DUPLICATE_ALLOC``, and ``GMT_DUPLICATE_NONE``, as discussed above
-(also see ``mode`` discussion above). For datasets and textsets you can
-add modifiers ``GMT_ALLOC_VERTICAL`` or ``GMT_ALLOC_HORIZONTAL`` if you
-wish to put all data in a single long table or to paste all tables
-side-by-side, respectively (thus getting one wide table instead).
-Additional note for datasets: Normally we allocate the output given the
-corresponding input dimensions. You can override these by specifying your
-alternative dimensions in the input dataset variable dim[].
-The ``data`` is a pointer to the resource you wish to duplicate. In case
-of an error we return a NULL pointer and pass an error code via
-``API->error``.
-
-Get resource ID
----------------
-
-Resources created by these two methods can be used as in various ways.
-Sometimes you want to pass them as input to other modules, in which
-case you need to registration ID of that resource. This task
-are performed by
-
-.. _GMT_Get_ID:
-
- ::
-
- void *GMT_Get_ID (void *API, unsigned int family,
- unsigned int direction, void *data);
-
-which returns the ID number of the allocated resource. Specify which
-:ref:`family <tbl-family>` and select ``direction`` from ``GMT_IN`` or ``GMT_OUT``.
-The ``data`` is a pointer to the resource you whose ID you need. In case
-of an error we return ``GMT_NOTSET`` and pass an error code via
-``API->error``.
-
-Import Data
------------
-
-If your main program needs to read any of the five recognized data types
-(CPT files, data tables, text tables, GMT grids, or images) you will
-use the GMT_Get_Data_ or GMT_Read_Data_ functions, which both
-return entire data sets. In the case of data and text tables you may
-also select record-by-record reading using the GMT_Get_Record_
-function. As a general rule, your program development simplifies if you
-can read entire resources into memory with GMT_Get_Data_ or
-GMT_Read_Data_. However, if this leads to unacceptable memory usage
-or if the program logic is particularly simple, you may obtain one data
-record at the time via GMT_Get_Record_.
-
-All input functions takes a parameter called ``mode``. The ``mode``
-parameter generally has different meanings for the different data types
-and will be discussed below. However, one bit setting is common to all
-types: By default, you are only allowed to read a data source once; the
-source is then flagged as having been read and subsequent attempts to
-read from the same source will result in a warning and no reading takes
-place. In the unlikely event you need to re-read a source you can
-override this default behavior by adding ``GMT_IO_RESET`` to your ``mode``
-parameter. Note that this override does not apply to sources that are
-streams or file handles, as it may not be possible to re-read their
-contents.
-
-Enable Data Import
-~~~~~~~~~~~~~~~~~~
-
-Once all input resources have been registered, we signal the API that we
-are done with the registration phase and are ready to start the actual
-data import. This step is only required when reading one record at the
-time. We initialize record-by-record reading by calling
-GMT_Begin_IO_ This function enables dataset and textset
-record-by-record reading and prepares the registered sources for the
-upcoming import. The prototype is
-
-.. _GMT_Begin_IO:
-
- ::
-
- int GMT_Begin_IO (void *API, unsigned int family, unsigned int direction,
- unsigned int mode, unsigned int header);
-
-where :ref:`family <tbl-family>` specifies the resource type to be read or written
-(only ``GMT_IS_DATASET`` and ``GMT_IS_TEXTSET`` are
-available for record-by-record handling). The ``direction`` is either
-``GMT_IN`` or ``GMT_OUT``, so for import we obviously use ``GMT_IN``. The
-function determines the first input source and sets up procedures for
-skipping to the next input source in a virtual data set. The
-GMT_Get_Record_ function will not be able to read any data before
-GMT_Begin_IO_ has been called. As you might guess, there is a
-companion GMT_End_IO_ function that completes, then disables
-record-by-record data access. You can use these several times to switch
-modes between registering data resources, doing the importing/exporting,
-and disabling further data access, perhaps to do more registration. We
-will discuss GMT_End_IO_ once we are done with the data import. The
-``mode`` option is used to allow output to write table header
-information (``GMT_HEADER_ON``) or not (``GMT_HEADER_OFF``). This is
-usually on unless you are writing messages and other non-data. The final
-``header`` argument determines if the common header-block should be
-written during initialization; choose between ``GMT_HEADER_ON`` and
-``GMT_HEADER_OFF``. The function returns 1 if there is an
-error; otherwise it returns 0.
-
-Import a data set
-~~~~~~~~~~~~~~~~~
-
-If your program needs to import any of the five recognized data types
-(CPT table, data table, text table, GMT grid, or image) you will use
-either the GMT_Read_Data_ or GMT_Get_Data_ functions. The former
-is typically used when reading from files, streams (e.g., ``stdin``), or
-an open file handle, while the latter is only used with a registered
-resource via its unique ID. Because of the similarities of these five
-import functions we use an generic form that covers all of them.
-
-Import from a file, stream, or handle
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-To read an entire resource from a file, stream, or file handle, use
-
-.. _GMT_Read_Data:
-
- ::
-
- void *GMT_Read_Data (void *API, unsigned int family, unsigned int method,
- unsigned int geometry, unsigned int mode, double wesn[],
- char *input, void *ptr);
-
-* :ref:`API <GMT_Create_Session>`
-* :ref:`family <tbl-family>`
-* :ref:`method <tbl-methods>`
-* :ref:`geometry <tbl-geometry>`
-* mode -- *see below*
-* :ref:`wesn <tbl-wesn>`
-* input -- a pointer to char holding the file name to read.
-* ptr -- NULL or the pointer returned by this function after a first call (when reading grids in two steps)
-* Return: Pointer to data container, or NULL if there were errors (passed back via API->error)
-
-
-where ``ptr`` is NULL except when reading grids in two steps (i.e.,
-first get a grid structure with a header, then read the data). Most of
-these arguments have been discussed earlier. This function can be called
-in three different situations:
-
-#. If you have a single source (filename, stream pointer, etc.) you can
- call GMT_Read_Data_ directly; there is no need to first register
- the source with GMT_Register_IO_ or gather the sources with
- GMT_Init_IO_. However, if you did register a single source you can
- still pass it via an encoded filename (see GMT_Encode_ID_) or you
- can instead use GMT_Get_Data_ using the integer ID directly (see
- next section).
-
-#. If you want to specify ``stdin`` as source then use ``input`` as NULL.
-
-#. If you already registered all desired sources with GMT_Init_IO_
- then you indicate this by passing ``geometry`` = 0.
-
-Space will be allocated to hold the results, if needed, and a pointer to
-the object is returned. If there are errors we simply return NULL and
-report the error. The ``mode`` parameter has different meanings for
-different data types.
-
-**CPT table**
- ``mode`` contains bit-flags that control how the CPT file's back-,
- fore-, and NaN-colors should be initialized. Select 0 to use the CPT
- file's back-, fore-, and NaN-colors, 2 to replace these with the
- GMT default values, or 4 to replace them with the color table's
- entries for highest and lowest value.
-
-**Data table**
- ``mode`` is currently not used.
-
-**Text table**
- ``mode`` is currently not used.
-
-**GMT grid**
- Here, ``mode`` determines how we read the grid: To read the entire
- grid and its header, pass ``GMT_GRID_ALL``. However, if you need to
- extract a sub-region you must first read the header by passing
- ``GMT_GRID_HEADER_ONLY``, then examine the header structure range
- attributes and to specify a subset via the array ``wesn``, and
- finally call GMT_Read_Data_ a second time, now with ``mode`` =
- ``GMT_GRID_DATA_ONLY`` and passing your ``wesn`` array and the grid
- structure returned from the first call as ``ptr``. In the event your
- data array should be allocated to hold both the real and imaginary
- parts of a complex data set you must add either
- ``GMT_GRID_IS_COMPLEX_REAL`` or ``GMT_GRID_IS_COMPLEX_IMAG`` to
- ``mode`` so as to allow for the extra memory needed and to stride
- the input values correctly. If your grid is huge and you must read
- it row-by-row, set ``mode`` to ``GMT_GRID_HEADER_ONLY`` \|
- ``GMT_GRID_ROW_BY_ROW``. You can then access the grid row-by-row
- using GMT_Get_Row_ By default the rows will be automatically
- processed in order. To completely specify which row to be read, use
- ``GMT_GRID_ROW_BY_ROW_MANUAL`` instead.
-
-Import from a memory location
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-If you are importing via variables or prefer to first register the
-source, then you should use GMT_Get_Data_ instead. This function
-requires fewer arguments since you simply pass the unique ID number of
-the resource. The function is described as follows:
-
-.. _GMT_Get_Data:
-
- ::
-
- void *GMT_Get_Data (void *API, int ID, unsigned int mode, void *ptr);
-
-The ``ID`` is the unique object ID you received when registering the
-resource, ``mode`` controls some aspects of the import (see
-GMT_Read_Data_ above), while ``ptr`` is NULL except when reading
-grids in two steps (i.e., first get a grid structure with a header, then
-read the data). Other arguments have been discussed earlier. Space will
-be allocated to hold the results, if needed, and a pointer to the object
-is returned. If there are errors we simply return NULL and report the error.
-
-Retrieve an allocated result
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Finally, if you need to access the result that a GMT module wrote to a
-memory location, then you must register an output destination with
-GMT_Register_IO_ first (passing ``ptr`` == NULL). The GMT module will
-then allocate space to hold the output and let the API know where this
-memory resides. You can then use GMT_Retrieve_Data_ to get a pointer
-to the container where the data set was stored. This function requires
-fewer arguments since you simply pass the unique ID number of the
-resource. The function is described as follows:
-
-.. _GMT_Retrieve_Data:
-
- ::
-
- void *GMT_Retrieve_Data (void *API, int ID);
-
-The ``ID`` is the unique object ID you received when registering the
-NULL resource earlier, Since this container has already been created, a
-pointer to the object is returned. If there are errors we simply return
-NULL and report the error.
-
-Importing a data record
-~~~~~~~~~~~~~~~~~~~~~~~
-
-If your program will read data table records one-by-one you must first
-enable this input mechanism with GMT_Begin_IO_ and then read the
-records in a loop using
-
-.. _GMT_Get_Record:
-
- ::
-
- void *GMT_Get_Record (void *API, unsigned int mode, int *nfields);
-
-where the returned value is either a pointer to a double array with the
-current row values or to a character string with the current row,
-depending on ``mode``. In either case these pointers point to memory
-internal to GMT and should be considered read-only. When we reach
-end-of-file, encounter conversion problems, read header comments, or
-identify segment headers we return a NULL pointer. The ``nfields``
-pointer will return the number of fields returned; pass NULL if your
-program should ignore this information.
-
-Normally (``mode`` == ``GMT_READ_DOUBLE``), we return a pointer to
-the double array. To read text records, supply instead ``mode`` ==
-``GMT_READ_TEXT`` and we instead return a pointer to the text
-record. However, if you have input records that mixes organized
-floating-point columns with text items you could pass ``mode`` ==
-``GMT_READ_MIXED``. Then, GMT will attempt to extract the
-floating-point values; you can still access the record string, as
-discussed below. Finally, if your application needs to be notified when
-GMT closes one file and opens the next, add ``GMT_FILE_BREAK`` to
-``mode`` and check for the status code ``GMT_IO_NEXT_FILE`` (by default,
-we treat the concatenation of many input files as a single virtual
-file). Using GMT_Get_Record_ requires you to first initialize the
-source(s) with GMT_Init_IO_. For certain records, GMT_Get_Record_
-will return NULL and sets status codes that your program will need to
-examine to take appropriate response. Table [tbl:iostatus] list the
-various status codes you can check for, using ``GMT_Status_IO`` (see
-next section).
-
-Examining record status
-~~~~~~~~~~~~~~~~~~~~~~~
-
-Programs that read record-by-record must be aware of what the current
-record represents. Given the presence of headers, data gaps, NaN-record,
-etc., the developer will want to check the status after reading the next
-record. The internal i/o status mode can be interrogated with the function
-
-.. _GMT_Status_IO:
-
- ::
-
- int GMT_Status_IO (void *API, unsigned int mode);
-
-which returns 0 (false) or 1 (true) if the current status is reflected
-by the specified ``mode``. There are 11 different modes available to
-programmers; for a list see Table :ref:`IO-status <tbl-iostatus>` For an example of how
-these may be used, see the test program ``testgmtio.c``. Developers who plan to import
-data on a record-by-record basis may also consult the source code of,
-say, ``blockmean.c`` or ``pstext.c``, to see examples of working code.
-
-.. _tbl-iostatus:
-
-+-----------------------------+----------------------------------------------------------+
-| mode | description and return value |
-+=============================+==========================================================+
-| GMT_IO_DATA_RECORD | 1 if we read a data record |
-+-----------------------------+----------------------------------------------------------+
-| GMT_IO_TABLE_HEADER | 1 if we read a table header |
-+-----------------------------+----------------------------------------------------------+
-| GMT_IO_SEGMENT_HEADER | 1 if we read a segment header |
-+-----------------------------+----------------------------------------------------------+
-| GMT_IO_ANY_HEADER | 1 if we read either header record |
-+-----------------------------+----------------------------------------------------------+
-| GMT_IO_MISMATCH | 1 if we read incorrect number of columns |
-+-----------------------------+----------------------------------------------------------+
-| GMT_IO_EOF | 1 if we reached the end of the file (EOF) |
-+-----------------------------+----------------------------------------------------------+
-| GMT_IO_NAN | 1 if we only read NaNs |
-+-----------------------------+----------------------------------------------------------+
-| GMT_IO_GAP | 1 if this record implies a data gap |
-+-----------------------------+----------------------------------------------------------+
-| GMT_IO_NEW_SEGMENT | 1 if we enter a new segment |
-+-----------------------------+----------------------------------------------------------+
-| GMT_IO_LINE_BREAK | 1 if we encountered a segment header, EOF, NaNs or gap |
-+-----------------------------+----------------------------------------------------------+
-| GMT_IO_NEXT_FILE | 1 if we finished one file but not the last |
-+-----------------------------+----------------------------------------------------------+
-
-
-Importing a grid row
-~~~~~~~~~~~~~~~~~~~~
-
-If your program must read a grid file row-by-row you must first enable
-row-by-row reading with :ref:`GMT_Read_Data <GMT_Read_Data>` and then use the
-``GMT_Get_Row`` function in a loop; the prototype is
-
-.. _GMT_Get_Row:
-
- ::
-
- int GMT_Get_Row (void *API, int row_no, struct GMT_GRID *G, float *row);
-
-where ``row`` is a pointer to a single-precision array to receive the
-current row, ``G`` is the grid in question, and ``row_no`` is the number
-of the current row to be read. Note this value is only considered if the
-row-by-row mode was initialized with ``GMT_GRID_ROW_BY_ROW_MANUAL``.
-The user must allocate enough space to hold the entire row in memory.
-
-Disable Data Import
-~~~~~~~~~~~~~~~~~~~
-
-Once the record-by-record input processing has completed we disable
-further input to prevent accidental reading from occurring (due to poor
-program structure, bugs, etc.). We do so by calling ``GMT_End_IO``. This
-function disables further record-by-record data import; its prototype is
-
-.. _GMT_End_IO:
-
- ::
-
- int GMT_End_IO (void *API, unsigned int direction, unsigned int mode);
-
-and we specify ``direction`` = ``GMT_IN``. At the moment, ``mode`` is not
-used. This call will also reallocate any arrays obtained into their
-proper lengths. The function returns 1 if there is an error
-(which is passed back with ``API->error``), otherwise it returns 0.
-
-.. _sec-manipulate:
-
-Manipulate data
----------------
-
-Once you have created and allocated empty resources, or read in
-resources from the outside, you will wish to manipulate their contents.
-This section discusses how to set up loops and access the important
-variables for the various data families. For grids and images it may
-be required to know what the coordinates are at each node point. This
-can be obtained via arrays of coordinates for each dimension, obtained by
-
-.. _GMT_Get_Coord:
-
- ::
-
- double *GMT_Get_Coord (void *API, unsigned int family, unsigned int dim, void *data);
-
-where :ref:`family <tbl-family>` must be ``GMT_IS_GRID`` or ``GMT_IS_DATASET``, ``dim`` is either
-``GMT_IS_X`` or ``GMT_IS_Y``, and ``data`` is the grid or image pointer. This
-function will be used below in our example on grid manipulation.
-
-Another aspect of dealing with grids and images is to convert a row and column
-2-D reference to our 1-D array index. Because of grid and image boundary padding
-the relationship is not straightforward, hence we supply
-
-.. _GMT_Get_Index:
-
- ::
-
- int64_t GMT_Get_Index (struct GMT_GRID_HEADER *header, int row, int col);
-
-where the ``header`` is the header of either a grid or image, and ``row`` and
-``col`` is the 2-D position in the grid or image. We return the 1-D array
-position; again this function is used below in our example.
-
-
-Manipulate grids
-~~~~~~~~~~~~~~~~
-
-Most applications wishing to manipulate grids will want to loop over all
-the nodes, typically in a manner organized by rows and columns. In doing
-so, the coordinates at each node may also be required for a calculation.
-Below is a snippet of code that shows how to do visit all nodes in a
-grid and assign each node the product x \* y:
-
- ::
-
- int row, col, node;
- double *x_coord = NULL, *y_coord = NULL;
- < ... create a grid G or read one ... >
- x_coord = GMT_Get_Coord (API, GMT_IS_GRID, GMT_X, G);
- y_coord = GMT_Get_Coord (API, GMT_IS_GRID, GMT_Y, G);
- for (row = 0; row < G->header->ny) {
- for (col = 0; col < G->header->nx; col++) {
- node = GMT_Get_Index (G->header, row, col);
- G->data[node] = x_coord[col] * y_coord[row];
- }
- }
-
-Note the use of :ref:`GMT_Get_Index <GMT_Get_Index>` to get the grid node number associated
-with the ``row`` and ``col`` we are visiting. Because GMT grids have
-padding (for boundary conditions) the relationship between rows,
-columns, and node indices is more complicated and hence we hide that
-complexity in :ref:`GMT_Get_Index <GMT_Get_Index>`. Note that for trivial procedures such
-setting all grid nodes to a constant (e.g., -9999.0) where the row and
-column does not enter you can instead do a single loop:
-
- ::
-
- int node;
- < ... create a grid G or read one ... >
- for (node = 0; node < G->header->size) G->data[node] = -9999.0;
-
-Note we must use ``G->header->size`` (size of allocated array) and not
-``G->header->nm`` (number of nodes in grid) since the latter is smaller
-due to the padding and a single loop like the above treats the pad as
-part of the "inside" grid.
-
-Manipulate data tables
-~~~~~~~~~~~~~~~~~~~~~~
-
-Another common application is to process the records in a data table.
-Because GMT consider the ``GMT_DATASET`` resources to contain one or more
-tables, each of which may contain one or more segments, all of which may
-contain one or more columns, you will need to have multiple loops to
-visit all entries. The following code snippet will visit all data
-records and add 1 to all columns beyond the first two (x and y):
-
- ::
-
- uint64_t tbl, seg, row, col;
- struct GMT_DATATABLE *T = NULL;
- struct GMT_DATASEGMENT *S = NULL;
-
- < ... create a dataset D or read one ... >
- for (tbl = 0; tbl < D->n_tables; tbl++) { /* For each table */
- T = D->table[tbl]; /* Convenient shorthand for current table */
- for (seg = 0; seg < T->n_segments; seg++) { /* For all segments */
- S = T->segment[seg]; /* Convenient shorthand for current segment */
- for (row = 0; row < S->n_rows; row++) {
- for (col = 2; col < T->n_columns; col++) {
- S->coord[col][row] += 1.0;
- }
- }
- }
- }
-
-Manipulate text tables
-~~~~~~~~~~~~~~~~~~~~~~
-
-When data file contain text mixed in with numbers you must open the file
-as a ``GMT_TEXTSET`` and do your own parsing of the data records. The
-following code snippet will visit all text records and print them out:
-
- ::
-
- uint64_t tbl, seg, row, col;
- struct GMT_TEXTTABLE *T = NULL;
- struct GMT_TEXTSEGMENT *S = NULL;
-
- < ... create a textset D or read one ... >
- for (tbl = 0; tbl < D->n_tables; tbl++) { /* For each table */
- T = D->table[tbl]; /* Convenient shorthand for current table */
- for (seg = 0; seg < T->n_segments; seg++) { /* For all segments */
- S = T->segment[seg]; /* Convenient shorthand for current segment */
- for (row = 0; row < S->n_rows; row++) {
- printf ("T=%d S=%d R=%d : %s\n", tbl, seg, row, S->record[row]);
- }
- }
- }
-
-Message and Verbose Reporting
------------------------------
-
-The API provides two functions for your program to present information
-to the user during the run of the program. One is used for messages that
-are always written while the other is used for reports that must exceed
-the verbosity settings specified via **-V**.
-
-.. _GMT_Report:
-
- ::
-
- int GMT_Report (void *API, unsigned int level, char *message, ...);
-
-This function takes a verbosity level and a multi-part message (e.g., a
-format statement and zero or more variables). The verbosity ``level`` is
-an integer in the 0–5 range; these are listed in Table [tbl:verbosity].
-You assign an appropriate verbosity level to your message, and depending
-on the chosen run-time verbosity level set via **-V** your message may
-or may not be reported. Only messages whose stated verbosity level is
-lower or equal to the **-V**\ *level* will be printed.
-
-
-.. _tbl-verbosity:
-
-+-------------------------+--------------------------------------------------+
-| constant | description |
-+=========================+==================================================+
-| GMT_MSG_QUIET | No messages whatsoever |
-+-------------------------+--------------------------------------------------+
-| GMT_MSG_NORMAL | Default output, e.g., warnings and errors only |
-+-------------------------+--------------------------------------------------+
-| GMT_MSG_COMPAT | Compatibility warnings |
-+-------------------------+--------------------------------------------------+
-| GMT_MSG_VERBOSE | Verbose level |
-+-------------------------+--------------------------------------------------+
-| GMT_MSG_LONG_VERBOSE | Longer verbose |
-+-------------------------+--------------------------------------------------+
-| GMT_MSG_DEBUG | Debug messages for developers mostly |
-+-------------------------+--------------------------------------------------+
-
-
-.. _GMT_Message:
-
- ::
-
- int GMT_Message (void *API, unsigned int mode, char *format, ...);
-
-This function always prints its message to the standard output. Use the
-``mode`` value to control if a time stamp should preface the message.
-and if selected how the time information should be formatted. See
-Table :ref:`timemodes <tbl-timemodes>` for the various modes.
-
-
-.. _tbl-timemodes:
-
-+--------------------+-----------------------------------------+
-| constant | description |
-+====================+=========================================+
-| GMT_TIME_NONE | Display no time information |
-+--------------------+-----------------------------------------+
-| GMT_TIME_CLOCK | Display current local time |
-+--------------------+-----------------------------------------+
-| GMT_TIME_ELAPSED | Display elapsed time since last reset |
-+--------------------+-----------------------------------------+
-| GMT_TIME_RESET | Reset the elapsed time to 0 |
-+--------------------+-----------------------------------------+
-
-.. _sec-parsopt:
-
-Presenting and accessing GMT options
-------------------------------------
-
-As you develop a program you may need to rely on some of
-the GMT common options. For instance, you may wish to have your
-program present the ``-R`` option to the user, let GMT handle the
-parsing, and examine the values. You may also wish to encode your own
-custom options that may require you to parse user text into the
-corresponding floating point dimensions, constants, coordinates, time, etc.
-The API provides several functions to simplify these tedious parsing
-tasks. This section is intended to show how the programmer will obtain
-information from the user that is necessary to do the task at hand
-(e.g., special options to provide values and settings for the program).
-In the following section we will concern ourselves with preparing
-arguments for calling any of the GMT modules.
-
-Display usage syntax for GMT common options
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-You can have your program menu display the standard usage message for a
-GMT common option by calling the function
-
-.. _GMT_Option:
-
- ::
-
- int GMT_Option (void *API, char *options);
-
-where ``options`` is a comma-separated list of GMT common options
-(e.g., "R,J,O,X"). You can repeat this function with different sets of
-options in order to intersperse your own custom options with in an
-overall alphabetical order; see any GMT module for examples of typical
-layouts.
-
-Parsing the GMT common options
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The parsing of all GMT common option is done by
-
-.. _GMT_Parse_Common:
-
- ::
-
- int GMT_Parse_Common (void *API, char *args, struct GMT_OPTION *list);
-
-where ``args`` is a string of the common GMT options your program may
-use. An error will be reported if any of the common GMT options fail
-to parse, and if so we return TRUE; if not errors we return FALSE. All
-other options, including file names, will be silently ignored. The
-parsing will update the internal GMT information structure that
-affects program operations.
-
-Inquiring about the GMT common options
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The API provide only a limited window into the full GMT machinery
-accessible to the modules. You can determine if a particular common
-option has been parsed and in some cases determine the values that was set with
-
-.. _GMT_Get_Common:
-
- ::
-
- int GMT_Get_Common (void *API, unsigned int option, double *par);
-
-where ``option`` is a single option character (e.g., 'R') and ``par`` is
-a double array with at least a length of 6. If the particular option has
-been parsed then the function returns the number of parameters passed
-back via ``par``; otherwise we return -1. For instance, to determine if
-the ``-R`` was set and what the resulting region was set to you may call
-
- ::
-
- if (GMT_Get_Common (API, 'R', wesn)) != -1) {
- /* wesn now contains the boundary information */
- }
-
-The ``wesn`` array could now be passed to the various read and create
-functions for GMT resources.
-
-Parsing text values
-~~~~~~~~~~~~~~~~~~~
-
-Your program may need to request values from the user, such as
-distances, plot dimensions, coordinates, and other data. The conversion
-from such text to actual distances, taking units into account, is
-tedious to program. You can simplify this by using
-
-.. _GMT_Get_Value:
-
- ::
-
- int GMT_Get_Value (void *API, char *arg, double par[]);
-
-where ``arg`` is the text item with one or more values that are
-separated by commas, spaces, tabs, semi-colons, or slashes, and ``par`` is an array long
-enough to hold all the items you are parsing. The function returns the
-number of items parsed, or -1 if there is an error. For instance, assume
-the character string ``origin`` was given by the user as two geographic
-coordinates separated by a slash (e.g., ``"35:45W/19:30:55.3S"``). We
-obtain the two coordinates as decimal degrees by calling
-
- ::
-
- n = GMT_Get_Value (API, origin, pair);
-
-Your program can now check that ``n`` equals 2 and then use the values
-in ``pairs``. Note: Dimensions given with units of inches, cm, or points
-are converted to the GMT default length unit (:ref:`PROJ_LENGTH_UNIT <PROJ_LENGTH_UNIT>`)
-[cm], while distances given in km, nautical miles, miles, feet, or
-survey feet are returned in meters. Arc lengths in minutes and seconds
-are returned in decimal degrees, and date/time values are returned in
-seconds since the epoch (1970).
-
-Inquiring about a GMT default parameter
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-If your program needs to determine one or more of the current
-GMT default settings you can do so via
-
-.. _GMT_Get_Default:
-
- ::
-
- int GMT_Get_Default (void *API, char *keyword, char *value);
-
-where ``keyword`` is one such keyword (e.g., :ref:`PROJ_LENGTH_UNIT <PROJ_LENGTH_UNIT>`) and
-``value`` must be a character array long enough to hold the answer.
-Depending on what parameter you selected you could further convert it to
-a numerical value with ``GMT_Get_Value`` or just use it in a text comparison.
-
-.. _sec-func:
-
-Prepare module options
-----------------------
-
-One of the advantages of programming with the API is that you
-have access to the high-level GMT modules. For example, if your
-program must compute the distance from a point to all other points on
-the node you can simply set up options and call ``GMT_grdmath`` to do it
-for you and accept the result back as an input grid. All the module
-interfaces are identical are looks like
-
-.. _GMT_Call_Module:
-
- ::
-
- int GMT_Call_Module (void *API, const char *module, int mode, void *args);
-
-Here, ``module`` can be any of the GMT modules, such as
-``psxy`` or ``grdvolume``. All GMT modules may be called with one of
-three sets of ``args`` depending on ``mode``. The three modes differ in
-how the options are passed to the module:
-
- *mode* == ``GMT_MODULE_EXIST``
- Return GMT_NOERROR (0) if module exists, GMT_NOT_A_VALID_MODULE otherwise.
-
- *mode* == ``GMT_MODULE_PURPOSE``
- Just prints the purpose of the module; args should be NULL.
-
- *mode* == ``GMT_MODULE_OPT``
- Expects ``args`` to be a pointer to a doubly-linked list of objects with individual
- options for the current program. We will see
- how API functions can help prepare such lists.
-
- *mode* == ``GMT_MODULE_CMD``
- Expects ``args`` to be a single text string with all required options.
-
- *mode > 0*
- Expects ``args`` to be an array of text options and ``mode`` to be a count of how many
- options are passed (i.e., the ``argc, argv[]`` model used by the GMT programs themselves).
-
-
-If ``module`` equals NULL and ``mode == GMT_MODULE_PURPOSE`` then we list summaries for all the modules
-If no module by the given name is found we return -1.
-
-Set program options via text array arguments
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-When ``mode > 0`` we expect an array ``args`` of character
-strings that each holds a single command line options (e.g.,
-"-R120:30/134:45/8S/3N") and interpret ``mode`` to be the count of how
-many options are passed. This, of course, is almost exactly how the
-stand-alone GMT programs are called (and reflects how they themselves
-are activated internally). We call this the "argc-argv" mode. Depending
-on how your program obtains the necessary options you may find that this
-interface offers all you need.
-
-Set program options via text command
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-If ``mode ==`` 0 then ``args`` will be examined to see if it contains
-several options within a single command string. If so we will break
-these into separate options. This is useful if you wish to pass a single
-string such as "-R120:30/134:45/8S/3N -JM6i mydata.txt -Sc0.2c". We call
-this the "command" mode.
-
-Set program options via linked structures
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The third, linked-list interface allows developers using higher-level
-programming languages to pass all command options via a pointer to a
-NULL-terminated, doubly-linked list of option structures, each
-containing information about a single option. Here, instead of text
-arguments we pass the pointer to the linked list of options mentioned
-above, and ``mode`` must be passed as -1 (or any negative value). Using
-this interface can be more involved since you need to generate the
-linked list of program options; however, utility functions exist to
-simplify its use. This interface is intended for programs whose internal
-workings are better suited to generate such arguments -- we call this the
-"options" mode. The order in the list is not important as GMT will
-sort it internally according to need. The option structure is defined below.
-
-.. _options:
-
- ::
-
- struct GMT_OPTION {
- char option; /* Single character of the option (e.g., 'G' for -G) */
- char *arg; /* String pointer with arguments (NULL if not used) */
- struct GMT_OPTION *next; /* Pointer to next option (NULL for last option) */
- struct GMT_OPTION *prev; /* Pointer to previous option (NULL for first option) */
- };
-
-Convert between text and linked structures
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-To assist programmers there are also two convenience functions that
-allow you to convert between the two argument formats. They are
-
-.. _GMT_Create_Options:
-
- ::
-
- struct GMT_OPTION *GMT_Create_Options (void *API, int argc, void *args);
-
-This function accepts your array of text arguments (cast via a void
-pointer), allocates the necessary space, performs the conversion, and
-returns a pointer to the head of the linked list of program options.
-However, in case of an error we return a NULL pointer and set
-``API->error`` to indicate the nature of the problem. Otherwise, the
-pointer may now be passed to the relevant ``GMT_module``. Note that if
-your list of text arguments were obtained from a C ``main()`` function
-then ``argv[0]`` will contain the name of the calling program. To avoid
-passing this as a file name option, call GMT_Create_Options_ with
-``argc-1`` and ``argv+1``. If you wish to pass a single text string with
-multiple options (in lieu of an array of text strings), then pass
-``argc`` = 0. When no longer needed you can remove the entire list by calling
-
-.. _GMT_Destroy_Options:
-
- ::
-
- int GMT_Destroy_Options (void *API, struct GMT_OPTION **list);
-
-The function returns 1 if there is an error (which is passed back
-with ``API->error``), otherwise it returns 0.
-
-The inverse function prototype is
-
-.. _GMT_Create_Args:
-
- ::
-
- char **GMT_Create_Args (void *API, int *argc, struct GMT_OPTION *list);
-
-which allocates space for the text strings and performs the conversion;
-it passes back the count of the arguments via ``argc`` and returns a
-pointer to the text array. In the case of an error we return a NULL
-pointer and set ``API->error`` to reflect the error type. Note that
-``argv[0]`` will not contain the name of the program as is the case the
-arguments presented by a C ``main()`` function. When you no longer have
-any use for the text array, call
-
-.. _GMT_Destroy_Args:
-
- ::
-
- int GMT_Destroy_Args (void *API, int argc, char **argv[]);
-
-to deallocate the space used. This function returns 1 if there is
-an error (which is passed back with ``API->error``), otherwise it returns 0.
-
-Finally, to convert the linked list of option structures to a single
-text string command, use
-
-.. _GMT_Create_Cmd:
-
- ::
-
- char *GMT_Create_Cmd (void *API, struct GMT_OPTION *list);
-
-Developers who plan to import and export GMT shell scripts might find
-it convenient to use these functions. In case of an error we return a
-NULL pointer and set ``API->error``, otherwise a pointer to an allocated
-string is returned. When you no longer have
-any use for the text string, call
-
-.. _GMT_Destroy_Cmd:
-
- ::
-
- int GMT_Destroy_Cmd (void *API, char **argv);
-
-to deallocate the space used. This function returns 1 if there is
-an error (which is passed back with ``API->error``), otherwise it
-returns 0.
-
-Manage the linked list of options
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Several additional utility functions are available for programmers who
-wish to manipulate program option structures within their own programs.
-These allow you to create new option structures, append them to the
-linked list, replace existing options with new values, find a particular
-option, and remove options from the list. Note: The order in which the
-options appear in the linked list is of no consequence to GMT.
-Internally, GMT will sort and process the options in the manner
-required. Externally, you are free to maintain your own order.
-
-Make a new option structure
-^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-``GMT_Make_Option`` will allocate a new option structure, assign it
-values given the ``option`` and ``arg`` parameter (pass NULL if there is
-no argument for this option), and returns a pointer to the allocated
-structure. The prototype is
-
-.. _GMT_Make_Option:
-
- ::
-
- struct GMT_OPTION *GMT_Make_Option (void *API, char option, char *arg);
-
-Should memory allocation fail the function will print an error message
-set an error code via ``API->error``, and return NULL.
-
-Append an option to the linked list
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-
-``GMT_Append_Option`` will append the specified ``option`` to the end of
-the doubly-linked ``list``. The prototype is
-
-.. _GMT_Append_Option:
-
- ::
-
- struct GMT_OPTION *GMT_Append_Option (void *API, struct GMT_OPTION *option,
- struct GMT_OPTION *list);
-
-We return the list back, and if ``list`` is given as NULL we return
-``option`` as the start of the new list. Any errors results in a NULL
-pointer with ``API->error`` holding the error type.
-
-Find an option in the linked list
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-``GMT_Find_Option`` will return a pointer ``ptr`` to the first option in
-the linked list starting at ``list`` whose option character equals
-``option``. If not found we return NULL. While this is not necessarily
-an error we still set ``API->error`` accordingly. The prototype is
-
-.. _GMT_Find_Option:
-
- ::
-
- struct GMT_OPTION *GMT_Find_Option (void *API, char option,
- struct GMT_OPTION *list);
-
-If you need to look for multiple occurrences of a certain option you
-will need to call GMT_Find_Option_ again, passing the option
-following the previously found option as the ``list`` entry, i.e.,
-
- ::
-
- list = *ptr->next;
-
-Update an existing option in the list
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-GMT_Update_Option_ will replace the argument of ``current`` with the
-new argument ``arg`` and otherwise leave the option at its place in the
-list. The prototype is
-
-.. _GMT_Update_Option:
-
- ::
-
- int GMT_Update_Option (void *API, struct GMT_OPTION *current, char *arg);
-
-An error will be reported if (a) ``current`` is NULL or (b) ``arg`` is
-NULL. The function returns 1 if there is an error, otherwise it returns 0.
-
-Delete an existing option in the linked list
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-You may use ``GMT_Delete_Option`` to remove ``option`` from the linked
-``list``. The prototype is
-
-.. _GMT_Delete_Option:
-
- ::
-
- int GMT_Delete_Option (void *API, struct GMT_OPTION *current);
-
-We return TRUE if the option is not found in the list and set
-``API->error`` accordingly. Note: Only the first occurrence of the
-specified option will be deleted. If you need to delete all such options
-you will need to call this function in a loop until it returns a
-non-zero status.
-
-Specify a file via an linked option
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-To specify an input file name via an option, simply use < as the
-option (this is what GMT_Create_Options_ does when it finds filenames
-on the command line). Likewise, > can be used to explicitly
-indicate an output file. In order to append to an existing file, use
->>. For example the following command would read from file.A and
-append to file.B:
-
- ::
-
- gmtconvert -<file.A ->>file.B
-
-These options also work on the command line but usually one would have
-to escape the special characters < and > as they are
-used for file redirection.
-
-Calling a GMT module
---------------------
-
-Given your linked list of program options (or text array) and possibly
-some registered resources, you can now call the required GMT module
-using one of the two flavors discussed in :ref:`section <sec-func>` All
-modules return an error or status code that your program should consider
-before processing the results.
-
-Adjusting headers and comments
-------------------------------
-
-All header records in incoming datasets are stored in memory. You may
-wish to replace these records with new information, or append new
-information to the existing headers. This is achieved with
-
-.. _GMT_Set_Comment:
-
- ::
-
- int GMT_Set_Comment (void *API, unsigned int family, unsigned int mode
- void *arg, void *data)
-
-Again, :ref:`family <tbl-family>` selects which kind of resource is passed via ``data``.
-The ``mode`` determines what kind of comment is being considered, how it
-should be included, and in what form the comment passed via ``arg`` is.
-Table :ref:`comments <tbl-comments>` lists the available options, which may be combined
-by adding (bitwise "or"). The ``GMT_Set_Comment`` does not actually
-output anything but sets the relevant comment and header records in the
-relevant structure. When a file is written out the information will be
-output as well (Note: Users can always decide if they wish to turn
-header output on or off via the common GMT option ``-h``. For
-record-by-record writing you must enable the header block output when
-you call GMT_Begin_IO_
-
-.. _tbl-comments:
-
-+---------------------------+------------------------------------------------------+
-| constant | description |
-+===========================+======================================================+
-| GMT_COMMENT_IS_TEXT | Comment is a text string |
-+---------------------------+------------------------------------------------------+
-| GMT_COMMENT_IS_OPTION | Comment is a linked list of GMT_OPTION structures |
-+---------------------------+------------------------------------------------------+
-| GMT_COMMENT_IS_COMMAND | Comment is the command |
-+---------------------------+------------------------------------------------------+
-| GMT_COMMENT_IS_REMARK | Comment is the remark |
-+---------------------------+------------------------------------------------------+
-| GMT_COMMENT_IS_TITLE | Comment is the title |
-+---------------------------+------------------------------------------------------+
-| GMT_COMMENT_IS_NAME_X | Comment is the x variable name (grids only) |
-+---------------------------+------------------------------------------------------+
-| GMT_COMMENT_IS_NAME_Y | Comment is the y variable name (grids only) |
-+---------------------------+------------------------------------------------------+
-| GMT_COMMENT_IS_NAME_Z | Comment is the z variable name (grids only) |
-+---------------------------+------------------------------------------------------+
-| GMT_COMMENT_IS_COLNAMES | Comment is the column names header |
-+---------------------------+------------------------------------------------------+
-| GMT_COMMENT_IS_RESET | Comment replaces existing information |
-+---------------------------+------------------------------------------------------+
-
-
-The named modes (*command*, *remark*, *title*, *name_x,y,z* and
-*colnames* are used to distinguish regular text comments from specific
-fields in the header structures of the data resources, such as
-``GMT_GRID``. For the various table resources (e.g., ``GMT_DATASET``)
-these modifiers result in a specially formatted comments beginning with
-"Command: " or "Remark: ", reflecting how this type of information is
-encoded in the headers.
-
-Exporting Data
---------------
-
-If your program needs to write any of the four recognized data types
-(CPT files, data tables, text tables, or GMT grids) you can use the
-GMT_Put_Data_. In the case of data and text tables, you may also
-consider the GMT_Put_Record_ function. As a general rule, your
-program organization may simplify if you can write and export the entire
-resource with GMT_Put_Data_. However, if the program logic is simple
-or already involves using GMT_Get_Record_, it may be better to export
-one data record at the time via GMT_Put_Record_.
-
-Both of these output functions takes a parameter called ``mode``. The
-``mode`` parameter generally takes on different meanings for the
-different data types and will be discussed below. However, one bit
-setting is common to all types: By default, you are only allowed to
-write a data resource once; the resource is then flagged to have been
-written and subsequent attempts to write to the same resource will
-quietly be ignored. In the unlikely event you need to re-write a
-resource you can override this default behavior by adding ``GMT_IO_RESET``
-to your ``mode`` parameter.
-
-Enable Data Export
-~~~~~~~~~~~~~~~~~~
-
-Similar to the data import procedures, once all output destinations have
-been registered, we signal the API that we are done with the
-registration phase and are ready to start the actual data export. As for
-input, this step is only needed when dealing with record-by-record
-writing. Again, we enable record-by-record writing by calling
-GMT_Begin_IO_, this time with ``direction`` = ``GMT_OUT``. This function
-enables data export and prepares the registered destinations for the
-upcoming writing.
-
-Exporting a data set
-~~~~~~~~~~~~~~~~~~~~
-
-To have your program accept results from GMT modules and write them
-separately requires you to use the GMT_Write_Data_ or
-GMT_Put_Data_ functions. They are very similar to the
-GMT_Read_Data_ and GMT_Get_Data_ functions encountered earlier.
-
-Exporting a data set to a file, stream, or handle
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-The prototype for writing to a file (via name, stream, or file handle) is
-
-.. _GMT_Write_Data:
-
- ::
-
- int GMT_Write_Data (void *API, unsigned int family, unsigned int method,
- unsigned int geometry, unsigned int mode,
- double wesn[], void *output, void *data);
-
-* :ref:`API <GMT_Create_Session>`
-* :ref:`family <tbl-family>`
-* :ref:`method <tbl-methods>`
-* :ref:`geometry <tbl-geometry>`
-* mode -- specific to each data type (\ *see below*)
-* :ref:`wesn <tbl-wesn>`
-* output --
-* data -- A pointer to any of the four structures :ref:`GMT_VECTOR <struct-vector>`,
- :ref:`GMT_MATRIX <struct-matrix>`, :ref:`GMT_GRID <struct-grid>`, :ref:`GMT_PALETTE <struct-palette>`
-* Return: 0 on success, otherwise return -1 and set API->error to reflect to cause.
-
-where ``data`` is a pointer to any of the four structures discussed previously.
-
-**CPT table**
- ``mode`` controls if the CPT table's back-, fore-, and NaN-colors
- should be written (1) or not (0).
-
-**Data table**
- If ``method`` is ``GMT_IS_FILE``, then the value of ``mode`` affects
- how the data set is written:
-
- **GMT_WRITE_SET**
- The entire data set will be written to the single file [0].
-
- **GMT_WRITE_TABLE**
- Each table in the data set is written to individual files [1].
- You can either specify an output file name that *must* contain
- one C-style format specifier for a int variable (e.g.,
- "New_Table_%06d.txt"), which will be replaced with the table
- number (a running number from 0) *or* you must assign to each
- table *i* a unique output file name via the
- ``D->table[i]->file[GMT_OUT]`` variables prior to calling the
- function.
-
- **GMT_WRITE_SEGMENT**
- Each segment in the data set is written to an individual file
- [2]. Same setup as for ``GMT_WRITE_TABLE`` except we use
- sequential segment numbers to build the file names.
-
- **GMT_WRITE_TABLE_SEGMENT**
- Each segment in the data set is written to an individual file
- [3]. You can either specify an output file name that *must*
- contain two C-style format specifiers for two int variables
- (e.g., "New_Table_%06d_Segment_%03d.txt"), which will be
- replaced with the table and segment numbers, *or* you must
- assign to each segment *j* in each table *i* a unique output
- file name via the ``D->table[i]->segment[j]->file[GMT_OUT]``
- variables prior to calling the function.
-
- **GMT_WRITE_OGR**
- Writes the dataset in OGR/GMT format in conjunction with the
- ``-a`` setting [4].
-
-**Text table**
- The ``mode`` is used the same way as for data tables.
-
-**GMT grid**
- Here, ``mode`` may be ``GMT_GRID_HEADER_ONLY`` to only update a
- file's header structure, but normally it is simply ``GMT_GRID_ALL``
- so the entire grid and its header will be exported (a subset is
- not allowed during export). However, in the event your data array
- holds both the real and imaginary parts of a complex data set you
- must add either ``GMT_GRID_IS_COMPLEX_REAL`` or
- ``GMT_GRID_IS_COMPLEX_IMAG`` to ``mode`` so as to export the
- corresponding grid values correctly. Finally, for native binary
- grids you may skip writing the grid header by adding
- ``GMT_GRID_NO_HEADER``; this setting is ignored for other grid
- formats. If your output grid is huge and you are building it
- row-by-row, set ``mode`` to ``GMT_GRID_HEADER_ONLY`` \|
- ``GMT_GRID_ROW_BY_ROW``. You can then write the grid row-by-row
- using GMT_Put_Row_. By default the rows will be automatically
- processed in order. To completely specify which row to be written,
- use ``GMT_GRID_ROW_BY_ROW_MANUAL`` instead.
-
-Note: If ``method`` is GMT_IS_FILE, :ref:`family <tbl-family>` is ``GMT_IS_GRID``,
-and the filename implies a change from NaN to another value then the grid is
-modified accordingly. If you continue to use that grid after writing please be
-aware that the changes you specified were applied to the grid.
-
-Exporting a data set to memory
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-If writing to a memory destination you will want to first register that
-destination and then use the returned ID with ``GMT_Put_Data`` instead:
-
-.. _GMT_Put_Data:
-
- ::
-
- int GMT_Put_Data (void *API, int ID, unsigned int mode, void *data);
-
-where ``ID`` is the unique ID of the registered destination, ``mode`` is
-specific to each data type (and controls aspects of the output
-structuring), and ``data`` is a pointer to any of the four structures
-discussed previously. For more detail, see GMT_Write_Data_ above. If
-successful the function returns 0; otherwise we return 1
-and set ``API->error`` to reflect to cause.
-
-Exporting a data record
-~~~~~~~~~~~~~~~~~~~~~~~
-
-If your program must write data table records one-by-one you must first
-enable record-by-record writing with GMT_Begin_IO_ and then use the
-``GMT_Put_Record`` function in a loop; the prototype is
-
-.. _GMT_Put_Record:
-
- ::
-
- int GMT_Put_Record (void *API, unsigned int mode, void *rec);
-
-where ``rec`` is a pointer to either (a) a double-precision array with
-the current row. Then, ``rec`` is expected to hold at least as many
-items as the current setting of ``n_col[GMT_OUT]``, which represents the
-number of columns in the output destination. Alternatively (b), ``rec``
-points to a text string. The ``mode`` parameter must be set to reflect
-what is passed. Using GMT_Put_Record_ requires you to first
-initialize the destination with GMT_Init_IO_. Note that for families
-GMT_IS_DATASET and ``GMT_IS_TEXTSET`` the methods ``GMT_IS_DUPLICATE`` and
-GMT_IS_REFERENCE are not supported since you can simply populate the
-GMT_DATASET structure directly. As mentioned, ``mode`` affects what is
-actually written:
-
-**GMT_WRITE_DOUBLE**
- Normal operation that builds the current output record from the values in ``rec``.
-
-**GMT_WRITE_TEXT**
- For ASCII output mode we write the text string ``rec``. If ``rec``
- is NULL then we use the current (last imported) text record. If
- binary output mode we quietly skip writing this record.
-
-**GMT_WRITE_TABLE_HEADER**
- For ASCII output mode we write the text string ``rec``. If ``rec``
- is NULL then we write the last read header record (and ensures it
- starts with #). If binary output mode we quietly skip writing this record.
-
-**GMT_WRITE_SEGMENT_HEADER**
- For ASCII output mode we use the text string ``rec`` as the
- segment header. If ``rec`` is NULL then we use the current (last
- read) segment header record. If binary output mode instead we write
- a record composed of NaNs.
-
-The function returns 1 if there was an error associated with the
-writing (which is passed back with ``API->error``), otherwise it returns
-0.
-
-Exporting a grid row
-~~~~~~~~~~~~~~~~~~~~
-
-If your program must write a grid file row-by-row you must first enable
-row-by-row writing with GMT_Read_Data_ and then use the
-``GMT_Put_Row`` function in a loop; the prototype is
-
-.. _GMT_Put_Row:
-
- ::
-
- int GMT_Put_Row (void *API, int row_no, struct GMT_GRID *G, float *row);
-
-where ``row`` is a pointer to a single-precision array with the current
-row, ``G`` is the grid in question, and ``row_no`` is the number of the
-current row to be written. Note this value is only considered if the
-row-by-row mode was initialized with ``GMT_GRID_ROW_BY_ROW_MANUAL``.
-
-Disable Data Export
-~~~~~~~~~~~~~~~~~~~
-
-Once the record-by-record output has completed we disable further output
-to prevent accidental writing from occurring (due to poor program
-structure, bugs, etc.). We do so by calling ``GMT_End_IO``. This
-function disables further record-by-record data export; here, we
-obviously pass ``direction`` as ``GMT_OUT``.
-
-Destroy allocated resources
----------------------------
-
-If your session imported any data sets into memory then you may
-explicitly free this memory once it is no longer needed and before
-terminating the session. This is done with the ``GMT_Destroy_Data``
-function, whose prototype is
-
-.. _GMT_Destroy_Data:
-
- ::
-
- int GMT_Destroy_Data (void *API, void *data);
-
-where ``data`` is the address of the pointer to a data container. Note that
-when each module completes it will automatically free memory created by
-the API; similarly, when the session is destroyed we also automatically
-free up memory. Thus, ``GMT_Destroy_Data`` is therefore generally only
-needed when you wish to directly free up memory to avoid running out of
-it. The function returns 1 if there is an error when trying to
-free the memory (the error code is passed back with ``API->error``),
-otherwise it returns 0.
-
-Terminate a GMT session
------------------------
-
-Before your program exits it should properly terminate the
-GMT session, which involves a call to
-
-.. _GMT_Destroy_Session:
-
- ::
-
- int GMT_Destroy_Session (void *API);
-
-which simply takes the pointer to the GMT API control structure as its
-only arguments. It terminates the GMT machinery and deallocates all
-memory used by the GMT API book-keeping. It also unregisters any
-remaining resources previously registered with the session. The
-GMT API will only close files that it was responsible for opening in
-the first place. Finally, the API structure itself is freed so your main
-program does not need to do so. The function returns 1 if there
-is an error when trying to free the memory (the error code is passed
-back with ``API->error``), otherwise it returns 0.
-
-The GMT FFT Interface
-=====================
-
-While the i/o options presented so far lets you easily read in a data
-table or grid and manipulated them, if you need to do so in the
-wavenumber domain then this chapter is for you. Here we outline how to
-take the Fourier transform of such data, perform calculations in the
-wavenumber domain, and take the inverse transform before writing the
-results. To assist programmers we also distribute fully functioning
-demonstration programs that takes you through the steps we are about to
-discuss; these demo programs may be used as your starting point for
-further development.
-
-Presenting and Parsing the FFT options
---------------------------------------
-
-Several GMT programs using FFTs present the same unified option and
-modifier sets to the user. The API makes these available as well. If
-your program needs to present the option usage you can call
-
-.. _GMT_FFT_Option:
-
- ::
-
- unsigned int GMT_FFT_Option (void *API, char option, unsigned int dim,
- char *string);
-
-Here, ``option`` is the unique character used for this particular
-program option (most GMT programs have standardized on using 'N' but
-you are free to choose whatever you want except existing GMT common
-options). The ``dim`` sets the dimension of the transform, currently you
-must choose 1 or 2, while the ``string`` is a one-line message that
-states what the option does; you should tailor this to your program. If
-NULL then a generic message is placed instead.
-
-To parse the user's selection you call
-
-.. _GMT_FFT_Parse:
-
- ::
-
- void *GMT_FFT_Parse (void *API, char option, unsigned int dim, char *args);
-
-which accepts the user's string option via ``args``; the other arguments
-are the same as those above. The function returns an opaque pointer to a
-structure with the chosen parameters.
-
-Initializing the FFT machinery
-------------------------------
-
-Before your can take any transforms you must initialize the FFT
-machinery. This process involves a series of preparatory steps that are
-conveniently performed for you by
-
-.. _GMT_FFT_Create:
-
- ::
-
- void *GMT_FFT_Create (void *API, void *X, unsigned int dim,
- unsigned int mode, void *F);
-
-Here, ``X`` is either your dataset or grid pointer, ``dim`` is the
-dimension of the transform (1 or 2 only), ``mode`` passes various flags to the setup, such as whether
-the data is real, imaginary, or complex, and ``F`` is the opaque pointer
-returned by GMT_FFT_Parse_. Depending on the options you chose to
-pass to GMT_FFT_Parse_, the data may have a constant or a trend
-removed, reflected and extended by various symmetries, padded and
-tapered to desired transform dimensions, and possibly there are
-temporary files written out before the transform takes place. See the :doc:`grdfft`
-man page for a full explanation of the options presented by GMT_FFT_Option_.
-
-Taking the FFT
---------------
-
-Now that everything has been set up you can perform the transform with
-
-.. _GMT_FFT:
-
- ::
-
- void *GMT_FFT (void *API, void *X, int direction, unsigned int mode, void *K);
-
-which takes as ``direction`` either ``GMT_FFT_FWD`` or ``GMT_FFT_INV``. The
-mode is used to specify if we pass a real (GMT_FFT_REAL) or complex
-(GMT_FFT_COMPLEX) data set, and ``K`` is the opaque pointer returned
-by GMT_FFT_Create_. The transform is performed in place and returned
-via ``X``. When done with your manipulations (below) you can call it
-again with the inverse flag to recover the corresponding space-domain
-version of your data. The FFT is fully normalized so that calling
-forward followed by inverse yields the original data set. The information
-passed via ``K`` determines if a 1-D or 2-D transform takes place; the
-key work is done via ``GMT_FFT_1D`` or ``GMT_FFT_2D`` below.
-
-Taking the 1-D FFT
-------------------
-
-A lower-level 1-D FFT is also available via
-
-.. _GMT_FFT_1D:
-
- ::
-
- int GMT_FFT_1D (void *API, float *data, uint64_t n, int direction, unsigned int mode);
-
-which takes as ``direction`` either ``GMT_FFT_FWD`` or ``GMT_FFT_INV``. The
-mode is used to specify if we pass a real (GMT_FFT_REAL) or complex
-(GMT_FFT_COMPLEX) data set, and ``data`` is the 1-D data array of length
-``n`` that we wish
-to transform. The transform is performed in place and returned
-via ``data``. When done with your manipulations (below) you can call it
-again with the inverse flag to recover the corresponding space-domain
-version of your data. The 1-D FFT is fully normalized so that calling
-forward followed by inverse yields the original data set. Note that unlike
-``GMT_FFT``, this function does not do any data extension, mirroring, detrending,
-etc. but operates directly on the data array given.
-
-Taking the 2-D FFT
-------------------
-
-A lower-level 2-D FFT is also available via
-
-.. _GMT_FFT_2D:
-
- ::
-
- int GMT_FFT_2D (void *API, float *data, unsigned int nx, unsigned int ny,
- int direction, unsigned int mode);
-
-which takes as ``direction`` either ``GMT_FFT_FWD`` or ``GMT_FFT_INV``. The
-mode is used to specify if we pass a real (GMT_FFT_REAL) or complex
-(GMT_FFT_COMPLEX) data set, and ``data`` is the 2-D data array in
-row-major format, with row length ``nx`` and column length ``ny``.
-The transform is performed in place and returned
-via ``data``. When done with your manipulations (below) you can call it
-again with the inverse flag to recover the corresponding space-domain
-version of your data. The 2-D FFT is fully normalized so that calling
-forward followed by inverse yields the original data set. Note that unlike
-``GMT_FFT``, this function does not do any data extension, mirroring, detrending,
-etc. but operates directly on the data array given.
-
-Wavenumber calculations
------------------------
-
-As your data have been transformed to the wavenumber domain you may wish
-to operate on the various values as a function of wavenumber. We will
-show how this is done for datasets and grids separately. First, we
-present the function that returns an individual wavenumber:
-
-.. _GMT_FFT_Wavenumber:
-
- ::
-
- double GMT_FFT_Wavenumber (void *API, uint64_t k, unsigned int mode, void *K);
-
-where ``k`` is the index into the array or grid, ``mode`` specifies
-which wavenumber we want (it is not used for 1-D transform but for the
-2-D transform we can select either the x-wavenumber (0), the
-y-wavenumber (1), or the radial wavenumber (2)), and finally the opaque
-vector used earlier.
-
-1-D FFT manipulation
-~~~~~~~~~~~~~~~~~~~~
-
-To be added after gmtfft has been added as new module.
-
-2-D FFT manipulation
-~~~~~~~~~~~~~~~~~~~~
-
-The number of complex pairs in the grid is given by the header's ``nm``
-variable, while ``size`` will be twice that value as it holds the number
-of components. To visit all the complex values and obtain the
-corresponding wavenumber we simply need to loop over ``size`` and call
-``GMT_FFT_Wavenumber``. This code snippet multiples the complex grid by
-the radial wavenumber:
-
- ::
-
- uint64_t k;
- for (k = 0; k < Grid->header->size; k++) {
- wave = GMT_FFT_Wavenumber (API, k, 2, K);
- Grid->data[k] *= wave;
- }
-
-Alternatively, you may choose to be more specific about which components
-are real and imaginary (especially if they are to be treated
-differently), and set up the loop this way:
-
- ::
-
- uint64_t re, im;
- for (re = 0, im = 1; re < Grid->header->size; re += 2, im += 2) {
- wave = GMT_FFT_Wavenumber (API, re, 2, K);
- Grid->data[re] *= wave;
- Grid->data[im] *= 2.0 * wave;
- }
-
-Destroying the FFT machinery
-----------------------------
-
-When done you terminate the FFT machinery with
-
-.. _GMT_FFT_Destroy:
-
- ::
-
- double GMT_FFT_Destroy (void *API, void *K);
-
-which simply frees up the memory allocated by the FFT machinery.
-
-FORTRAN interfaces
-==================
-
-FORTRAN 90 developers who wish to use the GMT API may use the same
-API functions as discussed in Chapter 2. As we do not have much (i.e., any) experience
-with modern Fortran we are not sure to what extent you are able to access
-the members of the various structures, such as the ``GMT_GRID`` structure. Thus,
-this part will depend on feedback and for the time being is to be considered
-preliminary and subject to change. We encourage you to take contact should you
-wish to use the API with your Fortran 90 programs.
-
-FORTRAN 77 Grid i/o
--------------------
-
-Because of a lack of structure pointers we can only provide a low level of
-support for Fortran 77. This API is limited to help you inquire, read and write
-GMT grids directly from Fortran 77.
-To inquire about the range of information in a grid, use
-
-.. _GMT_F77_readgrdinfo:
-
- ::
-
- int GMT_F77_readgrdinfo (unsigned int dim[], double limits[], double inc[],
- char *title, char *remark, char *file)
-
-where ``dim`` returns the grid width, height, and registration, ``limits`` returns the min and max values for x, y, and z
-as three consecutive pairs, ``inc`` returns the x and y increment, the ``title`` and ``remark``
-returns the values of these strings. The ``file``
-argument is the name of the file we wish to inquire about. The function returns 0 unless there is an error.
-Note that you must declare your variables so that ``limits`` has at least 6 elements and ``inc`` and ``dime`` have at least 2 each.
-
-To actually read the grid, we use
-
-.. _GMT_F77_readgrd:
-
- ::
-
- int GMT_F77_readgrd (float *array, unsigned int dim[], double wesn[],
- double inc[], char *title, char *remark, char *file)
-
-where ``array`` is the 1-D grid data array, ``dim`` returns the grid width, height, and registration,
-``limits`` returns the min and max values for x, y, and z, ``inc`` returns the x and y increments,
-the ``title`` and ``remark`` returns the values of these strings. The ``file``
-argument is the name of the file we wish to read from. The function returns 0 unless there is an error.
-Note on input, ``dim[2]`` can be set to 1 which means we will allocate the array for you; otherwise
-we assume space has already been secured. Also, if ``dim[3]`` is set to 1 we will in-place transpose
-the array from C-style row-major array order to Fortran column-major array order.
-
-Finally, to write a grid to file you can use
-
-.. _GMT_F77_writegrd:
-
- ::
-
- int GMT_F77_writegrd_(float *array, unsigned int dim[], double wesn[],
- double inc[], char *title, char *remark, char *file)
-
-where ``array`` is the 1-D grid data array, ``dim`` specifies the grid width, height, and registration,
-``limits`` may be used to specify a subset (normally, just pass zeros), ``inc`` specifies the x and y increments,
-the ``title`` and ``remark`` supplies the values of these strings. The ``file``
-argument is the name of the file we wish to write to. The function returns 0 unless there is an error.
-If ``dim[3]`` is set to 1 we will in-place transpose
-the array from Fortran column-major array order to C-style row-major array order before writing. Note
-this means array will have been transposed when the function returns.
-
-
-.. [1]
- or via a very confusing and ever-changing myriad of low-level library
- functions for bold programmers.
-
-.. [2]
- Currently, C/C++, FORTRAN, Matlab and Julia are being tested.
-
-.. [3]
- At the moment, GMT does not have native support for 3-D grids.
-
-.. [4]
- This may change in later releases.
-
-.. [5]
- However, there is no thread-support yet.
diff --git a/doc_release/html/_sources/GMT_Docs.txt b/doc_release/html/_sources/GMT_Docs.txt
deleted file mode 100644
index c38d91f..0000000
--- a/doc_release/html/_sources/GMT_Docs.txt
+++ /dev/null
@@ -1,9990 +0,0 @@
-.. TODO: set tocdepth=2 when this issue resolved https://bitbucket.org/birkenfeld/sphinx/issue/1251
-
-:tocdepth: 3
-
-.. set default highlighting language for this document:
-
-.. highlight:: bash
-
-**The Generic Mapping Tools**
-
-**Technical Reference and Cookbook**
-
-**Pål (Paul) Wessel**
-
-**SOEST, University of Hawai'i at Manoa**
-
-**Walter H. F. Smith**
-
-**Laboratory for Satellite Altimetry, NOAA/NESDIS/STAR**
-
-**Remko Scharroo**
-
-**EUMETSAT, Darmstadt, Germany**
-
-**Joaquim F. Luis**
-
-**Universidade do Algarve, Faro, Portugal**
-
-**Florian Wobbe**
-
-**Alfred Wegener Institute, Germany**
-
-.. figure:: /_images/GMT5_Summit_2011.jpg
- :height: 599 px
- :width: 1013 px
- :align: center
- :scale: 50 %
-
- The four horsemen of the GMT apocalypse: Remko Scharroo, Paul Wessel, Walter H.F. Smith,
- and Joaquim Luis at the GMT Developer Summit in Honolulu, Hawaii during February 14--18, 2011.
-
-Acknowledgments
-===============
-
-The Generic Mapping Tools (GMT) could not have been designed without
-the generous support of several people. The Founders (Wessel and Smith)
-gratefully acknowledge A. B.
-Watts and the late W. F. Haxby for supporting their efforts on the
-original version 1.0 while they were their graduate students at
-Lamont-Doherty Earth Observatory. Doug Shearer and Roger Davis patiently
-answered many questions over e-mail. The subroutine ``gauss`` was
-written and supplied by Bill Menke. Further development of versions
-2.0--2.1 at SOEST would not have been possible without the support from
-the HIGP/SOEST Post-Doctoral Fellowship program to Paul Wessel. Walter
-H. F. Smith gratefully acknowledges the generous support of the C. H.
-and I. M. Green Foundation for Earth Sciences at the Institute of
-Geophysics and Planetary Physics, Scripps Institution of Oceanography,
-University of California at San Diego. GMT series 3.x, 4.x, and 5.x
-owe their existence to grants EAR-93-02272, OCE-95-29431, OCE-00-82552,
-OCE-04-52126, and OCE-1029874 from the National Science Foundation,
-which we gratefully acknowledge.
-
-We would also like to acknowledge feedback, suggestions and bug reports
-from Michael Barck, Manfred Brands, Allen Cogbill, Stephan Eickschen,
-Ben Horner-Johnson, John Kuhn, Angel Li, Andrew Macrae, Alex Madon, Ken
-McLean, Greg Neumann, Ameet Raval, Georg Schwarz, Richard Signell, Peter
-Schmidt, Dirk Stoecker, Eduardo Suárez, Mikhail Tchernychev, Malte
-Thoma, David Townsend, Garry Vaughan, William Weibel, and many others,
-including their advice on how to make GMT portable to a wide range of
-platforms. John Lillibridge and Stephan Eickschen provided the original
-examples 11 and 32, respectively; Hanno von Lom helped resolve early
-problems with DLL libraries for Win32; Lloyd Parkes enabled indexed
-color images in PostScript; Kurt Schwehr maintains the packages; Wayne
-Wilson implemented the full general perspective projection; and William
-Yip helped translate GMT to POSIX ANSI C and incorporate netCDF 3. The
-SOEST RCF staff (Ross Ishida, Pat Townsend, and Sharon Stahl) provided
-valuable help on Linux and web server support.
-
-Honolulu, HI, College Park, MD, Faro, Portugal, Darmstadt and
-Bremerhaven, Germany, March 2014
-
-
-A Reminder
-==========
-
-If you feel it is appropriate, you may consider paying us back by citing
-our EOS articles on GMT and technical papers on algorithms when you
-publish papers containing results or illustrations obtained using GMT.
-The EOS articles on GMT are
-
-- Wessel, P., W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe,
- Generic Mapping Tools: Improved Version Released, *EOS Trans. AGU*, 94(45),
- p. 409-410, 2013. `doi:10.1002/2013EO450001 <http://dx.doi.org/10.1002/2013EO450001>`_.
-
-- Wessel, P., and W. H. F. Smith, New, improved version of Generic
- Mapping Tools released, *EOS Trans. AGU*, 79(47),
- p. 579, 1998. `doi:10.1029/98EO00426 <http://dx.doi.org/10.1029/98EO00426>`_.
-
-- Wessel, P., and W. H. F. Smith, New version of the Generic Mapping
- Tools released, *EOS Trans. AGU*, 76(33), 329, 1995. `doi:10.1029/95EO00198 <http://dx.doi.org/10.1029/95EO00198>`_.
-
-- Wessel, P., and W. H. F. Smith, Free software helps map and display
- data, *EOS Trans. AGU*, 72(41), 445--446, 1991. `doi:10.1029/90EO00319 <http://dx.doi.org/10.1029/90EO00319>`_.
-
-
-Some GMT programs are based on algorithms we have developed and
-published separately, such as
-
-- Kim, S.-S., and P. Wessel, Directional median filtering for
- regional-residual separation of bathymetry, *Geochem. Geophys.
- Geosyst.*, 9, Q03005, 2008. `doi:10.1029/2007GC001850 <http://dx.doi.org/10.1029/2007GC001850>`_.
- [:doc:`dimfilter <supplements/misc/dimfilter>`, **misc** supplement]
-
-- Luis, J. F. and J. M. Miranda, Reevaluation of magnetic chrons in the
- North Atlantic between 35ºN and 47ºN: Implications for the formation of the
- Azores Triple Junction and associated plateau,
- *J. Geophys. Res.*, 113, B10105, 2008. `doi:10.1029/2007JB005573 <http://dx.doi.org/10.1029/2007JB005573>`_.
- [:doc:`grdredpol <supplements/potential/grdredpol>`, **potential** supplement]
-
-- Smith, W. H. F., and P. Wessel, Gridding with continuous curvature
- splines in tension, *Geophysics*, 55(3), 293--305, 1990. `doi:10.1190/1.1442837 <http://dx.doi.org/10.1190/1.1442837>`_.
- [:doc:`surface`]
-
-- Wessel, P., Tools for analyzing intersecting tracks: The x2sys
- package, *Computers & Geosciences*, 36, 348--354, 2010. `doi:10.1016/j.cageo.2009.05.009 <http://dx.doi.org/10.1016/j.cageo.2009.05.009>`_.
- [:doc:`x2sys <supplements/x2sys/x2sys_init>` supplement]
-
-- Wessel, P., A General-purpose Green's function-based interpolator,
- *Computers & Geosciences*, 35, 1247--1254, 2009. `doi:10.1016/j.cageo.2008.08.012 <http://dx.doi.org/10.1016/j.cageo.2008.08.012>`_.
- [:doc:`greenspline`]
-
-- Wessel, P. and J. M. Becker, Interpolation using a generalized
- Green's function for a spherical surface spline in tension, *Geophys.
- J. Int.*, 174, 21--28, 2008. `doi:10.1111/j.1365-246X.2008.03829.x <http://dx.doi.org/10.1111/j.1365-246X.2008.03829.x>`_.
- [:doc:`greenspline`]
-
-Finally, GMT includes some code supplied by others, in particular the
-Triangle code used for Delaunay triangulation. Its author, `Jonathan
-Shewchuk <http://www.cs.berkeley.edu/~jrs/>`_, says
-
- "If you use Triangle, and especially if you use it to accomplish
- real work, I would like very much to hear from you. A short letter
- or email describing how you use Triangle will
- mean a lot to me. The more people I know are using this program, the
- more easily I can justify spending time on improvements and on the
- three-dimensional successor to Triangle, which in turn will benefit
- you."
-
-A few GMT users take the time to write us letters, telling us of the
-difference GMT is making in their work. We appreciate receiving these
-letters. On days when we wonder why we ever released GMT we pull these
-letters out and read them. Seriously, as financial support for
-GMT depends on how well we can "sell" the idea to funding agencies and
-our superiors, letter-writing is one area where GMT users can affect
-such decisions by supporting the GMT project.
-
-Copyright and Caveat Emptor!
-============================
-
-Copyright ©1991--2015 by P. Wessel, W. H. F. Smith, R. Scharroo, J.
-Luis and F. Wobbe
-
-The Generic Mapping Tools (GMT) is free software; you can
-redistribute it and/or modify it under the terms of the GNU Lesser
-General Public License as published by the Free Software Foundation.
-
-The GMT package is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file
-``LICENSE.TXT`` in the GMT directory or the for more details.
-
-Permission is granted to make and distribute verbatim copies of this
-manual provided that the copyright notice and these paragraphs are
-preserved on all copies. The GMT package may be included in a bundled
-distribution of software for which a reasonable fee may be charged.
-
-GMT does not come with any warranties, nor
-is it guaranteed to work on your computer. The user assumes full
-responsibility for the use of this system. In particular, the University
-of Hawaii School of Ocean and Earth Science and Technology, the National
-Oceanic and Atmospheric Administration, EUMETSAT, the
-Universidade do Algarve, Alfred Wegener Institute, the National Science
-Foundation, Paul Wessel, Walter H. F. Smith, Remko Scharroo, Joaquim F.
-Luis, Florian Wobbe or any other individuals involved in the design and
-maintenance of GMT are NOT responsible for any damage that may follow
-from correct or incorrect use of these programs.
-
-Preface
-=======
-
-While GMT has served the map-making and data processing needs of
-scientists since 1988 [1]_, the current global use was heralded by the
-first official release in *EOS Trans. AGU* in the fall of 1991. Since
-then, GMT has grown to become a standard tool for many users,
-particularly in the Earth and Ocean Sciences but the global collective
-of GMT users is incredibly diverse. Development has at times been
-rapid, and numerous releases have seen the light of day since the early
-versions. For a detailed history of the changes from release to release,
-see file ``ChangeLog`` in the main GMT directory. For a nightly snapshot of ongoing
-activity, see the online page. For a historical perspective of the
-origins and development of GMT see the video podcast "20 Years with
-GMT -- The Generic Mapping Tools" produced following a seminar given by
-Paul Wessel on the 20th anniversary of GMT; a link is available on the
-GMT website.
-
-The success of GMT is to a large degree due to the input of the user
-community. In fact, most of the capabilities and options in
-GMT programs originated as user requests. We would like to hear from
-you should you have any suggestions for future enhancements and
-modification. Please send your comments to the GMT help list or create
-an issue in the bug tracker
-(see `<http://gmt.soest.hawaii.edu/projects/gmt/issues/>`_).
-
-New Features in GMT 5
-=====================
-
-GMT 5 represents a new branch of GMT development that mostly preserves the
-capabilities of the previous versions while adding over 200 new features
-to an already extensive bag of tricks. Our PostScript library
-:doc:`PSL <pslib>` has seen a complete rewrite as well
-and produce shorter and more compact PostScript. However, the big news
-is aimed for developers who wish to leverage GMT in their own applications.
-We have completely revamped the code base so that high-level
-GMT functionality is now accessible via GMT "modules". These are
-high-level functions named after their corresponding programs (e.g.,
-``GMT_grdimage``) that contains all of the functionality of that program
-within the function. While currently callable from C/C++ only (with some
-support for F77), we are making progress on the Matlab interface as well
-and there are plans to start on the Python version. Developers should
-consult the :doc:`GMT API <GMT_API>` documentation for more details.
-
-We recommend that users of GMT 4 consider learning the new rules and defaults
-since eventually (in some years) GMT 4 will be obsolete.
-To ease the transition to GMT 5 you may run it in compatibility mode,
-thus allowing the use of many obsolete default names and command
-switches (you will receive a warning instead). This is discussed below.
-
-Below are six key areas of improvements in GMT 5.
-
-New programs
-------------
-
-First, a few new programs have been added and some have been
-promoted (and possibly renamed) from earlier supplements:
-
-:doc:`gmt`
- This is the **only** program executable that is distributed with GMT 5. To avoid
- problems with namespace conflicts (e.g., there are other, non-GMT programs
- with generic names like triangulate, surface, etc.) all GMT 5 modules are
- launched from the gmt executable via "gmt module" calls (e.g, gmt pscoast).
- For backwards compatibility (see below) we also offer symbolic links with
- the old executable names that simply point to the gmt program, which then
- can start the correct module. Any module whose name starts with "gmt" can
- be abbreviated, e.g., "gmt gmtconvert" may be called as "gmt convert".
-
-:doc:`gmt2kml`
- A :doc:`psxy` -like tool to produce KML overlays for Google Earth. Previously
- found in the misc supplement.
-
-:doc:`gmtconnect`
- Connect individual lines whose end points match within given tolerance.
- Previously known as gmtstitch in the misc supplement (this name is recognized
- when GMT is running in compatibility mode).
-
-:doc:`gmtget`
- Return the values of the specified GMT defaults. Previously only
- implemented as a shell script and thus not available on all platforms.
-
-:doc:`gmtinfo`
- Report information about data tables. Previously known by the name minmax
- (this name is still recognized when GMT is running in compatibility mode).
-
-:doc:`gmtsimplify`
- A line-reduction tool for coastlines and similar lines. Previously found
- in the misc supplement under the name gmtdp (this name is recognized when
- GMT is running in compatibility mode).
-
-:doc:`gmtspatial`
- Perform various geospatial operations on lines and polygons.
-
-:doc:`gmtvector`
- Perform basic vector manipulation in 2-D and 3-D.
-
-:doc:`gmtwhich`
- Return the full path to specified data files.
-
-:doc:`grdraster`
- Extracts subsets from large global grids. Previously
- found in the dbase supplement.
-
-:doc:`kml2gmt`
- Extract GMT data tables from Google Earth KML files. Previously
- found in the misc supplement.
-
-:doc:`sph2grd`
- Compute grid from list of spherical harmonic coefficients [We will add its
- natural complement grd2sph at a later date].
-
-:doc:`sphdistance`
- Make grid of distances to nearest points on a sphere. Previously
- found in the sph supplement.
-
-:doc:`sphinterpolate`
- Spherical gridding in tension of data on a sphere. Previously
- found in the sph supplement.
-
-:doc:`sphtriangulate`
- Delaunay or Voronoi construction of spherical lon,lat data. Previously
- found in the sph supplement.
-
-We have also added a new supplement called potential that contains these five modules:
-
-:doc:`gmtgravmag3d <supplements/potential/gmtgravmag3d>`:
- Compute the gravity/magnetic anomaly of a body by the method of Okabe.
-
-:doc:`gravfft <supplements/potential/gravfft>`:
- Compute gravitational attraction of 3-D surfaces and a little more by the method of Parker.
-
-:doc:`grdgravmag3d <supplements/potential/grdgravmag3d>`:
- Computes the gravity effect of one (or two) grids by the method of Okabe.
-
-:doc:`grdredpol <supplements/potential/grdredpol>`:
- Compute the Continuous Reduction To the Pole, also known as differential RTP.
-
-:doc:`grdseamount <supplements/potential/grdseamount>`:
- Compute synthetic seamount (Gaussian or cone, circular or elliptical) bathymetry.
-
-Finally, the spotter supplement has added one new module:
-
-:doc:`grdpmodeler <supplements/spotter/grdpmodeler>`:
- Evaluate a plate model on a geographic grid.
-
-New common options
-------------------
-
-First we discuss changes that have been
-implemented by a series of new lower-case GMT common options:
-
-* Programs that read data tables can now process the aspatial metadata
- in OGR/GMT files with the new **-a** option. These can be produced by
- **ogr2ogr** (a GDAL tool) when selecting the -f "GMT" output
- format. See Appendix `P. The GMT Vector Data Format for OGR Compatibility`_
- for an explanation of the OGR/GMT file format.
- Because all GIS information is encoded via GMT comment lines these
- files can also be used in GMT 4 (the GIS metadata is simply
- skipped).
-
-* Programs that read or write data tables can specify a custom binary format
- using the enhanced **-b** option.
-
-* Programs that read data tables can control which columns to read and
- in what order (and optionally supply scaling relations) with the new **-i** option
-
-* Programs that read grids can use new common option **-n** to control
- grid interpolation settings and boundary conditions.
-
-* Programs that write data tables can control which columns to write
- and in what order (and optionally supply scaling relations) with the new **-o** option.
-
-* All plot programs can take a new **-p** option for perspective view
- from infinity. In GMT 4, only some programs could do this (e.g.,
- :doc:`pscoast`) and it took a
- program-specific option, typically **-E** and sometimes an option
- **-Z** would be needed as well. This information is now all passed
- via **-p** and applies across all GMT plotting programs.
-
-* Programs that read data tables can control how records with NaNs are
- handled with the new **-s** option.
-
-* All plot programs can take a new **-t** option to modify the PDF
- transparency level for that layer. However, as PostScript has no provision for
- transparency you can only see the effect if you convert it to PDF.
-
-Updated common options
-----------------------
-
-Some of the established GMT common options have seen significant
-improvements; these include:
-
-* The completely revised **-B** option can now handle irregular and custom annotations
- (see Section `Custom axes`_). It also has a new automatic mode which
- will select optimal intervals given data range and plot size. The 3-D base maps can now have
- horizontal gridlines on xz and yz back walls.
-
-* The **-R** option may now accept a leading unit which implies the
- given coordinates are projected map coordinates and should be
- replaced with the corresponding geographic coordinates given the
- specified map projection. For linear projections such units imply a
- simple unit conversion for the given coordinates (e.g., km to meter).
-
-* Introduced **-fp**\ [*unit*] which allows data input to be in
- projected values, e.g., UTM coordinates while **-Ju** is given.
-
-While just giving - (the hyphen) as argument presents just the synopsis of the command
-line arguments, we now also support giving + which in addition will list
-the explanations for all options that are not among the GMT common set.
-
-New default parameters
-----------------------
-
-Most of the GMT default parameters have changed names in order to
-group parameters into logical groups and to use more consistent naming.
-However, under compatibility mode (see below) the old names are still recognized.
-New capabilities have been implemented by introducing new GMT default settings:
-
-* :ref:`DIR_DCW <DIR Parameters>` specifies where to look for the optional
- Digital Charts of the World database (for country coloring or selections).
-
-* :ref:`DIR_GSHHG <DIR Parameters>` specifies where to look for the required
- Global Self-consistent Hierarchical High-resolution Geography database.
-
-* :ref:`GMT_COMPATIBILITY <GMT_COMPATIBILITY>` can be set to 4 to allow
- backwards compatibility with GMT 4 command-line syntax or 5 to impose
- strict GMT5 syntax checking.
-
-* :ref:`IO_NC4_CHUNK_SIZE <IO_NC4_CHUNK_SIZE>` is used to set the default
- chunk size for the **lat** and **lon** dimension of the **z** variable of
- netCDF version 4 files.
-
-* :ref:`IO_NC4_DEFLATION_LEVEL <IO_NC4_DEFLATION_LEVEL>` is used to set
- the compression level for netCDF4 files upon output.
-
-* :ref:`IO_SEGMENT_MARKER <IO_SEGMENT_MARKER>` can be used to change the
- character that GMT uses to identify new segment header records [>].
-
-* :ref:`MAP_ANNOT_ORTHO <MAP_ANNOT_ORTHO>` controls whether axes annotations
- for Cartesian plots are horizontal or orthogonal to the individual axes.
-
-* :ref:`GMT_FFT <GMT_FFT>` controls which algorithms to use for Fourier
- transforms.
-
-* :ref:`GMT_TRIANGULATE <GMT_TRIANGULATE>` controls which algorithm to use
- for Delaunay triangulation.
-
-* Great circle distance approximations can now be fine-tuned via new GMT default parameters
- :ref:`PROJ_MEAN_RADIUS <PROJ_MEAN_RADIUS>` and :ref:`PROJ_AUX_LATITUDE <PROJ_AUX_LATITUDE>`.
- Geodesics are now even more accurate by using the Vincenty [1975] algorithm instead of
- Rudoe's method.
-
-* :ref:`GMT_EXTRAPOLATE_VAL <GMT_EXTRAPOLATE_VAL>` controls what splines should do if
- requested to extrapolate beyond the given data domain.
-
-* :ref:`PS_TRANSPARENCY <PS_TRANSPARENCY>` allows users to modify how transparency will be
- processed when converted to PDF [Normal].
-
-A few parameters have been introduced in GMT 5 in the past and have been removed again.
-Among these are:
-
-* *DIR_USER*: was supposed to set the directory in which the user configuration files, or data are stored, but
- this creates problems, because it needs to be known already before it is potentially set in *DIR_USER*/gmt.conf.
- The environment variable **$GMT_USERDIR** is used for this instead.
-
-* *DIR_TMP*: was supposed to indicate the directory in which to store temporary files. But needs to be known without
- gmt.conf file as well. So the environment variable **$GMT_TMPDIR** is used instead.
-
-General improvements
---------------------
-
-Other wide-ranging changes have been implemented in different
-ways, such as
-
-* All programs now use consistent, standardized choices for plot
- dimension units (**c**\ m, **i**\ nch, or **p**\ oint; we no longer
- consider **m**\ eter a plot length unit), and actual distances
- (choose spherical arc lengths in **d**\ egree, **m**\ inute, and
- **s**\ econd [was **c**], or distances in m\ **e**\ ter [Default],
- **f**\ oot [new], **k**\ m, **M**\ ile [was sometimes **i** or
- **m**], **n**\ autical mile, and s\ **u**\ rvey foot [new]).
-
-* Programs that read data tables can now process multi-segment tables
- automatically. This means programs that did not have this capability
- (e.g., :doc:`filter1d`) can now all operate on the
- segments separately; consequently, there is no longer a **-m**
- option.
-
-* While we support the scaling of z-values in grids via the filename convention
- name[=\ *ID*\ [/*scale*/*offset*\ [/*nan*]]] mechanism, there are times
- when we wish to scale the x,y domain as well. Users can now
- append **+u**\ *unit* to their gridfile names, where *unit* is one of non-arc units listed
- in Table :ref:`distunits <tbl-distunits>`. This will convert your Cartesian
- x and y coordinates *from* the given unit *to* meters. We also support the inverse
- option **+U**\ *unit*, which can be used to convert your grid
- coordinates *from* meters *to* the specified unit.
-
-* CPT files also support the **+u**\ \|\ **U**\ *unit* mechanism. Here, the scaling
- applies to the z values. By appending these modifiers to your CPT filenames you
- can avoid having two CPT files (one for meter and one for km) since only one is needed.
-
-* Programs that read grids can now directly handle Arc/Info float binary
- files (GRIDFLOAT) and ESRI .hdr formats.
-
-* Programs that read grids now set boundary conditions to aid further
- processing. If a subset then the boundary conditions are taken from
- the surrounding grid values.
-
-* All text can now optionally be filled with patterns and/or drawn with
- outline pens. In the past, only :doc:`pstext` could plot outline fonts via
- **-S**\ *pen*. Now, any text can be an outline text by manipulating
- the corresponding FONT defaults (e.g., :ref:`FONT_TITLE <FONT_TITLE>`).
-
-* All color or fill specifications may append @\ *transparency* to
- change the PDF transparency level for that item. See **-t** for
- limitations on how to visualize this transparency.
-
-* GMT now ships with 36 standard color palette tables (CPT), up from 24.
-
-Program-specific improvements
------------------------------
-
-Finally, here is a list of numerous enhancements to individual programs:
-
-* :doc:`blockmean` added **-Ep** for error propagation and
- **-Sn** to report the number of data points per block.
-
-* :doc:`blockmedian` added **-Er**\ [-]
- to return as last column the record number that gave the median
- value. For ties, we return the record number of the higher data value
- unless **-Er**- is given (return lower). Added **-Es** to read and
- output source id for median value.
-
-* :doc:`blockmode` added **-Er**\ [-] but
- for modal value. Added **-Es** to read and output source id for modal
- value.
-
-* :doc:`gmtconvert` now has optional PCRE (regular expression) support,
- as well as a new option to select a subset of segments specified by
- segment running numbers (**-Q**) and improved options to extract a
- subset of records (**-E**) and support for a list of search strings
- via **-S+f**\ *patternfile*.
-
-* :doc:`gmtinfo` has new option **-A** to
- select what group to report on (all input, per file, or per segment).
- Also, use **-If** to report an extended region optimized for fastest results in FFTs.
- and **-Is** to report an extended region optimized for fastest results in :doc:`surface`.
- Finally, new option **-D**\ [*inc*] to align regions found via **-I** with the center
- of the data.
-
-* :doc:`gmtmath` with **-N**\ *ncol* and input
- files will add extra blank columns, if needed. A new option **-E**
- sets the minimum eigenvalue used by operators LSQFIT and SVDFIT.
- Option **-L** applies operators on a per-segment basis instead of
- accumulating operations across the entire file. Many new
- operators have been added (BITAND, BITLEFT, BITNOT, BITOR, BITRIGHT,
- BITTEST, BITXOR, DIFF, IFELSE, ISFINITE, SVDFIT, TAPER). Finally,
- we have implemented user macros for long or commonly used expressions,
- as well as ability to store and recall using named variables.
-
-* :doc:`gmtselect` Takes **-E** to indicate if points exactly on a polygon
- boundary are inside or outside, and **-Z** can now be extended to apply
- to other columns than the third.
-
-* :doc:`grd2cpt` takes **-F** to specify output color model and **-G** to
- truncate incoming CPT to be limited to a given range.
-
-* :doc:`grd2xyz` takes **-C** to write row, col instead of x,y. Append **f**
- to start at 1, else start at 0. Alternatively, use **-Ci** to write just
- the two columns *index* and *z*, where *index*
- is the 1-D indexing that GMT uses when referring to grid nodes.
-
-* :doc:`grdblend` can now take list of grids on
- the command line and blend, and now has more blend choices (see **-C**). Grids no
- longer have to have same registration or spacing.
-
-* :doc:`grdclip` has new option **-Si** to set all data >= low and <= high
- to the *between* value, and **-Sr** to set all data == old to the *new* value.
-
-* :doc:`grdcontour` can specify a single contour with **-C+**\ *contour* and
- **-A+**\ *contour*.
-
-* :doc:`grdcut` can use **-S** to specify an origin and radius and cut the
- corresponding rectangular area, and **-N** to extend the region if the new
- **-R** domain exceeds existing boundaries.
-
-* :doc:`grdfft` can now accept two grids and let **-E** compute the cross-spectra.
- The **-N** option allows for many new and special settings, including ability
- to control data mirroring, detrending, tapering, and output of intermediate
- results.
-
-* :doc:`grdfilter` can now do spherical
- filtering (with wrap around longitudes and over poles) for non-global
- grids. We have also begun implementing Open MP threads to speed up
- calculations on multi-core machines. We have added rectangular
- filtering and automatic resampling to input resolution for high-pass
- filters. There is also **-Ff**\ *weightgrd* which reads the gridfile
- *weightgrd* for a custom Cartesian grid convolution. The *weightgrd*
- must have odd dimensions. Similarly added **-Fo**\ *opgrd* for
- operators (via coefficients in the grdfile *opgrd*) whose weight sum
- is zero (hence we do not sum and divide the convolution by the weight
- sum).
-
-* :doc:`grdgradient` now has **-Em** that gives results close to ESRI's
- "hillshade"'" (but faster).
-
-* :doc:`grdinfo` now has modifier
- **-Ts**\ *dz* which returns a symmetrical range about zero. Also,
- if **-Ib** is given then the grid's bounding box polygon is written.
-
-* :doc:`grdimage` with GDAL support can write a raster image directly to
- a raster file (**-A**) and may plot raster images as well (**-Dr**).
- It also automatically assigns a color table if none is given and can use
- any of the 36 GMT color tables and scale them to fit the grid range.
-
-* :doc:`grdmask` has new option
- **-Ni**\ \|\ I\ \|\ p\ \|\ P to set inside of
- polygons to the polygon IDs. These may come from OGR aspatial values,
- segment head **-L**\ ID, or a running number, starting at a specified
- origin [0]. Now correctly handles polygons with perimeters and holes.
- Added z as possible radius value in **-S** which means read radii
- from 3rd input column.
-
-* :doc:`grdmath` added many new operators such as BITAND, BITLEFT, BITNOT, BITOR, BITRIGHT,
- BITTEST, BITXOR, DEG2KM, IFELSE, ISFINITE, KM2DEG, and TAPER. Finally,
- we have implemented user macros for long or commonly used expressions,
- as well as ability to store and recall using named variables.
-
-* :doc:`grdtrack` has many new options. The **-A** option controls how the
- input track is resampled when **-C** is selected, the new **-C**, **-D**
- options automatically create an equidistant set of cross-sectional
- profiles given input line segments; one or more grids can then be
- sampled at these locations. The **-E** option allows users to quickly specify
- tracks for sampling without needed input tracks. Also added **-S** which stack
- cross-profiles generated with **-C**. The **-N** will not skip
- points that are outside the grid domain but return NaN as sampled
- value. Finally, **-T** will return the nearest non-NaN node if the initial
- location only finds a NaN value.
-
-* :doc:`grdvector` can now take **-Si**\ *scale* to give the reciprocal scale,
- i.e., cm/ unit or km/unit. Also, the vector heads in GMT have completely been overhauled
- and includes geo-vector heads that follow great or small circles.
-
-* :doc:`grdview` will automatically assigns a color table if none is given and can use
- any of the 36 GMT color tables and scale them to fit the grid range.
-
-* :doc:`grdvolume` can let **-S** accept more distance units than just km. It also
- has a modified **-T**\ [**c**\ \|\ **h**] for ORS estimates based on max
- curvature or height. **-Cr** to compute the *outside* volume between two contours
- (for instances, the volume of water from a bathymetry grid).
-
-* :doc:`greenspline` has an improved **-C** option to control how many eigenvalues are used
- in the fitting, and **-Sl** adds a linear (or bilinear) spline.
-
-* :doc:`makecpt` has a new **-F** option to
- specify output color representation, e.g., to output the CPT table in
- h-s-v format despite originally being given in r/g/b, and **-G** to
- truncate incoming CPT to be limited to a given range. It also adds **Di**
- to match the bottom/top values in the input cpt file.
-
-* :doc:`mapproject` has a new **-N**
- option to do geodetic/geocentric conversions; it combines with **-I**
- for inverse conversions. Also, we have extended **-A** to accept
- **-A**\ **o**\ \| \ **O** to compute line orientations (-90/90).
- In **-G**, prepend - to the unit for (fast) flat Earth or + for (slow) geodesic calculations.
-
-* :doc:`project` has added **-G**...[+] so
- if + is appended we get a segment header with information about the
- pole for the circle. Optionally, append /*colat* in **-G** for a small circle path.
-
-* :doc:`ps2raster` has added a **-TF** option to create multi-page PDF files. There is
- also modification to **-A** to add user-specified margins, and it automatically detects
- if transparent elements have been included (and a detour via PDF might be needed).
-
-* :doc:`psbasemap` has added a **-D** option to place a map-insert box.
-
-* :doc:`psclip` has added an extended **-C** option to close different types of clip paths.
-
-* :doc:`pscoast` has added a new option **-F** which lets users specify one or more countries
- to paint, fill, extract, or use as plot domain (requires DCW to be installed).
-
-* :doc:`pscontour` is now similar to :doc:`grdcontour` in the options it
- takes, e.g., **-C** in particular. In GMT 4, the program could only
- read a CPT file and not take a specific contour interval.
-
-* :doc:`pshistogram` now takes **-D** to place histogram count labels on top of each bar
- and **-N** to draw the equivalent normal distributions.
-
-* :doc:`pslegend` no longer uses system calls to do the plotting. The modified **-D**
- allows for minor offsets, while **-F** offers more control over the frame and fill.
-
-* :doc:`psrose` has added **-Wv**\ *pen* to
- specify pen for vector (specified in **-C**). Added **-Zu** to set all radii to
- unity (i.e., for analysis of angles only).
-
-* :doc:`psscale` has a new option **-T** that paints a rectangle behind the color bar.
- The **+n** modifier to **-E** draws a rectangle with NaN color and adds a label.
- The **-G** option will truncate incoming CPT to be limited to the specified z-range.
- Modification **-Np** indicates a preference to use polygons to draw the color bar.
-
-* :doc:`pstext` can take simplified input
- via new option **-F** to set fixed font (including size), angle, and
- justification. If these parameters are fixed for all the text strings
- then the input can simply be *x y text*. It also has enhanced **-DJ** option
- to shorten diagonal offsets by :math:`\sqrt{2}` to maintain the same
- radial distance from point to annotation. Change all text to upper or
- lower case with **-Q**.
-
-* :doc:`psxy` and :doc:`psxyz` both support the revised custom symbol macro
- language which has been expanded considerably to allow for complicated,
- multi-parameter symbols; see Appendix `M. Custom Plot Symbols`_
- for details. Finally, we allow the base for bars and columns optionally to be
- read from data file by not specifying the base value.
-
-* :doc:`sample1d` offers **-A** to control resampling of spatial curves (with **-I**).
-
-* :doc:`spectrum1d` has added **-L** to control removal of trend, mean value or mid value.
-
-* :doc:`surface` has added **-r** to create pixel-registered grids and knows about
- periodicity in longitude (given **-fg**). There is also **-D** to supply a "sort" break line.
-
-* :doc:`triangulate` now offers **-S**
- to write triangle polygons and can handle 2-column input if **-Z** is given.
- Can also write triangle edges as line with **-M**.
-
-* :doc:`xyz2grd` now also offers **-Af** (first value encountered),
- **-Am** (mean, the default), **-Ar** (rms), and **-As** (last value encountered).
-
-Several supplements have new features as well:
-
-* :doc:`img2grd <supplements/img/img2grd>`
- used to be a shell script but is now a C program and can be used on all platforms.
-
-* :doc:`mgd77convert <supplements/mgd77/mgd77convert>`
- added **-C** option to assemble \*.mgd77 files from \*.h77/\*.a77 pairs.
-
-* The spotter programs can now read GPlates rotation files directly as well
- as write this format. Also,
- :doc:`rotconverter <supplements/spotter/rotconverter>` can extract plate
- circuit rotations on-the-fly from the GPlates rotation file.
-
-Note: GMT 5 only produces PostScript and no longer has a setting for
-Encapsulated PostScript (EPS). We made this decision since (a) our EPS determination
-was always very approximate (no consideration of font metrics, etc.) and quite often wrong,
-and (b) :doc:`ps2raster` handles it exactly. Hence, users who need EPS plots should
-simply process their PostScript files via :doc:`ps2raster`.
-
-.. _command-line-completion:
-
-Command-line completion
------------------------
-
-GMT provides basic command-line completion (tab completion) for bash.
-The easiest way to use the feature is to install the
-`bash-completion <http://bash-completion.alioth.debian.org/>`_ package
-which is available in many operating system distributions.
-
-Depending on the distribution, you may still need to source it from
-``~/.bashrc``, e.g.:
-
-.. code-block:: bash
-
- # Use bash-completion, if available
- if [ -r /usr/share/bash-completion/bash_completion ]; then
- . /usr/share/bash-completion/bash_completion
- fi
-
-When you install GMT from a distribution package, the completion rules
-are installed in ``/etc/bash_completion.d/gmt`` and loaded automatically.
-Custom GMT builds provide ``<prefix>/share/tools/gmt_completion.bash``
-which needs to be manually sourced from either ``~/.bash_completion`` or
-``~/.bashrc``.
-
-Mac users should note that bash-completion >=2.0 requires bash >=4.1.
-However, OS X won't ship anything that's licensed under GPL version 3.
-The last version of bash available under the GPLv2 is 3.2 from 2006.
-It is recommended that *bash-completion* is installed together with
-*bash* via `MacPorts <http://www.macports.org/>`_,
-`Fink <http://finkproject.org/>`_, or `Homebrew <http://brew.sh/>`_.
-You then need to change the shell used by your terminal application.
-The `bash-completion HOWTO from MacPorts
-<http://trac.macports.org/wiki/howto/bash-completion>`_
-explains how to change the preferences of Terminal.app and iTerm.app.
-Another way is to change the default shell by editing of the user
-database:
-
-.. code-block:: bash
-
- Add /opt/local/bin/bash to /etc/shells
- chsh -s /opt/local/bin/bash
-
-Modify the path to bash, ``/opt/local/bin/bash``, in the example above
-accordingly.
-
-Incompatibilities between GMT 5 and GMT 4
------------------------------------------
-
-As features are added and bugs are discovered, it is occasionally
-necessary to break the established syntax of a GMT program option, such as when
-the intent of the option is non-unique due to a modifier key being the
-same as a distance unit indicator. Other times we see a greatly improved
-commonality across similar options by making minor adjustments. However,
-we are aware that such changes may cause grief and trouble with
-established scripts and the habits of many GMT users. To alleviate this
-situation we have introduced a configuration that allows GMT to tolerate and process
-obsolete program syntax (to the extent possible). To activate you must
-make sure :ref:`GMT_COMPATIBILITY <GMT_COMPATIBILITY>` is set to 4 in your gmt.conf file.
-When not running in compatibility mode any obsolete syntax will be considered as
-errors. We recommend that users with prior GMT 4 experience run
-GMT 5 in compatibility mode, heed the warnings about obsolete syntax, and
-correct their scripts or habits accordingly. When this transition has been
-successfully navigated it is better to turn compatibility mode off and leave
-the past behind. Occasionally, users will supply an ancient
-GMT 3 syntax which may have worked in GMT 4 but is not honored in GMT 5.
-
-Here are a list of known incompatibilities that are correctly processed
-with a warning under compatibility mode:
-
-* GMT **default names**: We have
- organized the default parameters logically by group and renamed several to
- be easier to remember and to group. Old and new names can be found in
- Table :ref:`obsolete <tbl-obsoletedefs>`.
- In addition, a few defaults are no longer recognized,
- such as N_COPIES, PS_COPIES, DOTS_PR_INCH, GMT_CPTDIR, PS_DPI, and PS_EPS,
- TRANSPARENCY. This also means the old common option **-c** for specifying
- PostScript copies is no longer available.
-
-* **Units**: The unit abbreviation for arc seconds is finally **s**
- instead of **c**, with the same change for upper case in some clock
- format statements.
-
-* **Contour labels**: The modifiers **+k**\ *fontcolor* and
- **+s**\ *fontsize* are obsolete, now being part of **+f**\ *font*.
-
-* **Ellipsoids**: Assigning :ref:`PROJ_ELLIPSOID <PROJ_ELLIPSOID>` a file name is
- deprecated, use comma-separated parameters :math:`a, f^{-1}` instead.
-
-* **Custom symbol macros:** Circle macro symbol **C** is deprecated; use **c** instead.
-
-* **Map scale**: Used by :doc:`psbasemap`
- and others. Here, the unit **m** is deprecated; use **M** for statute miles.
-
-* **3-D perspective**: Some programs used a combination of **-E**,
- **-Z** to set up a 3-D perspective view, but these options were not
- universal. The new 3-D perspective in
- GMT 5 means you instead use the
- common option **-p** to configure the 3-D projection.
-
-* **Pixel vs. gridline registration:** Some programs used to have a
- local **-F** to turn on pixel registration; now this is a common
- option **-r**.
-
-* **Table file headers**: For consistency with other common i/o options
- we now use **-h** instead of **-H**.
-
-* **Segment headers**: These are now automatically detected and hence
- there is no longer a **-m** (or the older **-M** option).
-
-* **Front symbol**: The syntax for the front symbol has changed from
- **-Sf**\ *spacing/size*\ [**+d**][**+t**][:\ *offset*] to
- **-Sf**\ *spacing*\ [/*size*][**+r+l**][**+f+t+s+c+b**][\ **+o**\ *offset*].
-
-* **Vector symbol**: With the introduction of geo-vectors there are
- three kinds of vectors that can be drawn: Cartesian (straight)
- vectors with **-Sv** or **-SV**, geo-vectors (great circles) with
- **-S=**, and circular vectors with **-Sm**. These are all composed of
- a line (controlled by pen settings) and 0--2 arrow heads (control by
- fill and outline settings). Many modifiers common to all arrows have
- been introduced using the **+key**\ [*arg*] format. The *size* of a
- vector refers to the length of its head; all other quantities are
- given via modifiers (which have sensible default values). In
- particular, giving size as *vectorwidth/headlength/headwidth* is
- deprecated. See the :doc:`psxy` man page for
- a clear description of all modifiers.
-
-* :doc:`blockmean`: The **-S** and **-Sz**
- options are deprecated; use **-Ss** instead.
-
-* :doc:`filter1d`: The **-N**\ *ncol/tcol*
- option is deprecated; use **-N**\ *tcol* instead as we automatically
- determine the number of columns in the file.
-
-* :doc:`gmt2kml`: The **-L** option no longer expects column numbers,
- just the column names. This allows the extra columns to contain text
- strings but means users have to supply the data columns in the order
- specified by **-L**.
-
-* :doc:`gmtconvert`: **-F** is
- deprecated; use common option **-o** instead.
-
-* :doc:`gmtdefaults`: **-L** is
- deprecated; this is now the default behavior.
-
-* :doc:`gmtmath`: **-F** is deprecated; use
- common option **-o** instead.
-
-* :doc:`gmtselect`: **-Cf** is deprecated;
- use common specification format **-C-** instead. Also,
- **-N**...\ **o** is deprecated; use **-E** instead.
-
-* :doc:`grd2xyz`: **-E** is deprecated as
- the ESRI ASCII exchange format is now detected automatically.
-
-* :doc:`grdcontour`: **-m** is deprecated
- as segment headers are handled automatically.
-
-* :doc:`grdfft`: **-M** is deprecated; use
- common option **-fg** instead.
-
-* :doc:`grdgradient`: **-L** is
- deprecated; use common option **-n** instead. Also, **-M** is
- deprecated; use common option **-fg** instead.
-
-* :doc:`grdlandmask`: **-N**...\ **o**
- is deprecated; use **-E** instead.
-
-* :doc:`grdimage`: **-S** is deprecated;
- use **-n**\ *mode*\ [**+a**][\ **+t**\ *threshold*] instead.
-
-* :doc:`grdmath`: LDIST and PDIST now return
- distances in spherical degrees; while in
- GMT 4 it returned km; use
- DEG2KM for conversion, if needed.
-
-* :doc:`grdproject`: **-S** is
- deprecated; use **-n**\ *mode*\ [**+a**\ ][\ **+t**\ *threshold*]
- instead. Also, **-N** is deprecated; use **-D** instead.
-
-* :doc:`grdsample`: **-Q** is deprecated;
- use **-n**\ *mode*\ [**+a**][\ **+t**\ *threshold*] instead. Also,
- **-L** is deprecated; use common option **-n** instead, and
- **-N**\ *nx>/<ny* is deprecated; use **-I**\ *nx+>/<ny+* instead.
-
-* :doc:`grdtrack`: **-Q** is deprecated;
- use **-n**\ *mode*\ [**+a**][\ **+t**\ *threshold*] instead. Also,
- **-L** is deprecated; use common option **-n** instead, and **-S** is
- deprecated; use common option **-sa** instead.
-
-* :doc:`grdvector`: **-E** is deprecated;
- use the vector modifier **+jc** as well as the general vector
- specifications discussed earlier.
-
-* :doc:`grdview`: **-L** is deprecated; use common option **-n** instead.
-
-* :doc:`nearneighbor`: **-L** is
- deprecated; use common option **-n** instead.
-
-* :doc:`project`: **-D** is deprecated; use **-**\ **-**\ :ref:`FORMAT_GEO_OUT <FORMAT_GEO_OUT>` instead.
-
-* :doc:`psbasemap`: **-G** is deprecated;
- specify canvas color via **-B** modifier **+g**\ *color*.
-
-* :doc:`pscoast`: **-m** is deprecated and
- have reverted to **-M** for selecting data output instead of plotting.
-
-* :doc:`pscontour`: **-T**\ *indexfile* is deprecated; use **-Q**\ *indexfile*.
-
-* :doc:`pshistogram`: **-T**\ *col* is
- deprecated; use common option **-i** instead.
-
-* :doc:`pslegend`: Paragraph text header flag > is deprecated; use P instead.
-
-* :doc:`psmask`: **-D**...\ **+n**\ *min* is deprecated; use **-Q** instead.
-
-* :doc:`psrose`: Old vector specifications in
- Option **-M** are deprecated; see new explanations.
-
-* :doc:`pstext`: **-m** is deprecated; use
- **-M** to indicate paragraph mode. Also, **-S** is deprecated as
- fonts attributes are now specified via the font itself.
-
-* :doc:`pswiggle`: **-D** is deprecated;
- use common option **-g** to indicate data gaps. Also, **-N** is
- deprecated as all fills are set via the **-G** option.
-
-* :doc:`psxy`: Old vector specifications in
- Option **-S** are deprecated; see new explanations.
-
-* :doc:`psxyz`: Old vector specifications in
- Option **-S** are deprecated; see new explanations.
-
-* :doc:`splitxyz`: **-G** is deprecated;
- use common option **-g** to indicate data gaps. Also, **-M** is
- deprecated; use common option **-fg** instead.
-
-* :doc:`triangulate`: **-m** is
- deprecated; use **-M** to output triangle vertices.
-
-* :doc:`xyz2grd`: **-E** is deprecated as
- the ESRI ASCII exchange format is one of our recognized formats.
- Also, **-A** (no arguments) is deprecated; use **-Az** instead.
-
-* :doc:`grdraster`: Now in the main GMT core. The
- **H**\ *skip* field in ``grdraster.info`` is no longer expected as we automatically
- determine if a raster has a GMT header. Also, to output
- *x,y,z* triplets instead of writing a grid now requires **-T**.
-
-* :doc:`img2grd <supplements/img/img2grd>`: **-m**\ *inc* is
- deprecated; use **-I**\ *inc* instead.
-
-* :doc:`psvelo <supplements/meca/psvelo>`: Old vector
- specifications are deprecated; see new explanations.
-
-* :doc:`mgd77convert <supplements/mgd77/mgd77convert>`:
- **-4** is deprecated; use **-D** instead.
-
-* :doc:`mgd77list <supplements/mgd77/mgd77list>`: The unit
- **m** is deprecated; use **M** for statute miles.
-
-* :doc:`mgd77manage <supplements/mgd77/mgd77manage>`: The
- unit **m** is deprecated; use **M** for statute miles. The **-Q** is
- deprecated; use **-n**\ *mode*\ [**+a**][\ **+t**\ *threshold*] instead
-
-* :doc:`mgd77path <supplements/mgd77/mgd77path>`: **-P** is
- deprecated (clashes with
- GMT common options); use **-A** instead.
-
-* :doc:`backtracker <supplements/spotter/backtracker>`:
- **-C** is deprecated as stage vs. finite rotations are detected
- automatically.
-
-* :doc:`grdrotater <supplements/spotter/grdrotater>`:
- **-C** is deprecated as stage vs. finite rotations are detected
- automatically. Also, **-T**\ *lon/lat/angle* is now set via
- **-e**\ *lon/lat/angle*.
-
-* :doc:`grdspotter <supplements/spotter/grdspotter>`:
- **-C** is deprecated as stage vs. finite rotations are detected
- automatically.
-
-* :doc:`hotspotter <supplements/spotter/hotspotter>`: **-C**
- is deprecated as stage vs. finite rotations are detected
- automatically.
-
-* :doc:`originator <supplements/spotter/originator>`:
- **-C** is deprecated as stage vs. finite rotations are detected
- automatically.
-
-* :doc:`rotconverter <supplements/spotter/rotconverter>`:
- **-Ff** selection is deprecated, use **-Ft** instead.
-
-* :doc:`x2sys_datalist <supplements/x2sys/x2sys_datalist>`:
- The unit **m** is deprecated; use **M** for statute miles.
-
-.. _tbl-obsoletedefs:
-
-+---------------------------------+-----------------------------------------+
-| **Old Name** | **New Name** |
-+=================================+=========================================+
-| **ANNOT_FONT_PRIMARY** | **FONT_ANNOT_PRIMARY** |
-+---------------------------------+-----------------------------------------+
-| **ANNOT_FONT_SECONDARY** | **FONT_ANNOT_SECONDARY** |
-+---------------------------------+-----------------------------------------+
-| **ANNOT_FONT_SIZE_PRIMARY** | **FONT_ANNOT_PRIMARY** |
-+---------------------------------+-----------------------------------------+
-| **ANNOT_FONT_SIZE_SECONDARY** | **FONT_ANNOT_SECONDARY** |
-+---------------------------------+-----------------------------------------+
-| **ANNOT_MIN_ANGLE** | **MAP_ANNOT_MIN_SPACING** |
-+---------------------------------+-----------------------------------------+
-| **ANNOT_OFFSET_PRIMARY** | **MAP_ANNOT_OFFSET_PRIMARY** |
-+---------------------------------+-----------------------------------------+
-| **ANNOT_OFFSET_SECONDARY** | **MAP_ANNOT_OFFSET_SECONDARY** |
-+---------------------------------+-----------------------------------------+
-| **BASEMAP_AXES** | **MAP_FRAME_AXES** |
-+---------------------------------+-----------------------------------------+
-| **BASEMAP_FRAME_RGB** | **MAP_DEFAULT_PEN** |
-+---------------------------------+-----------------------------------------+
-| **BASEMAP_TYPE** | **MAP_FRAME_TYPE** |
-+---------------------------------+-----------------------------------------+
-| **CHAR_ENCODING** | **PS_CHAR_ENCODING** |
-+---------------------------------+-----------------------------------------+
-| **D_FORMAT** | **FORMAT_FLOAT_OUT** |
-+---------------------------------+-----------------------------------------+
-| **DEGREE_SYMBOL** | **MAP_DEGREE_SYMBOL** |
-+---------------------------------+-----------------------------------------+
-| **ELLIPSOID** | **PROJ_ELLIPSOID** |
-+---------------------------------+-----------------------------------------+
-| **FIELD_DELIMITER** | **IO_COL_SEPARATOR** |
-+---------------------------------+-----------------------------------------+
-| **FRAME_PEN** | **MAP_FRAME_PEN** |
-+---------------------------------+-----------------------------------------+
-| **FRAME_WIDTH** | **MAP_FRAME_WIDTH** |
-+---------------------------------+-----------------------------------------+
-| **GLOBAL_X_SCALE** | **PS_SCALE_X** |
-+---------------------------------+-----------------------------------------+
-| **GLOBAL_Y_SCALE** | **PS_SCALE_Y** |
-+---------------------------------+-----------------------------------------+
-| **GRID_CROSS_SIZE_PRIMARY** | **MAP_GRID_CROSS_SIZE_PRIMARY** |
-+---------------------------------+-----------------------------------------+
-| **GRID_CROSS_SIZE_SECONDARY** | **MAP_GRID_CROSS_SIZE_SECONDARY** |
-+---------------------------------+-----------------------------------------+
-| **GRID_PEN_PRIMARY** | **MAP_GRID_PEN_PRIMARY** |
-+---------------------------------+-----------------------------------------+
-| **GRID_PEN_SECONDARY** | **MAP_GRID_PEN_SECONDARY** |
-+---------------------------------+-----------------------------------------+
-| **GRIDFILE_FORMAT** | **IO_GRIDFILE_FORMAT** |
-+---------------------------------+-----------------------------------------+
-| **GRIDFILE_SHORTHAND** | **IO_GRIDFILE_SHORTHAND** |
-+---------------------------------+-----------------------------------------+
-| **HEADER_FONT_SIZE** | **FONT_TITLE** |
-+---------------------------------+-----------------------------------------+
-| **HEADER_FONT** | **FONT_TITLE** |
-+---------------------------------+-----------------------------------------+
-| **HEADER_OFFSET** | **MAP_TITLE_OFFSET** |
-+---------------------------------+-----------------------------------------+
-| **HISTORY** | **GMT_HISTORY** |
-+---------------------------------+-----------------------------------------+
-| **HSV_MAX_SATURATION** | **COLOR_HSV_MAX_S** |
-+---------------------------------+-----------------------------------------+
-| **HSV_MAX_VALUE** | **COLOR_HSV_MAX_V** |
-+---------------------------------+-----------------------------------------+
-| **HSV_MIN_SATURATION** | **COLOR_HSV_MIN_S** |
-+---------------------------------+-----------------------------------------+
-| **HSV_MIN_VALUE** | **COLOR_HSV_MIN_V** |
-+---------------------------------+-----------------------------------------+
-| **INPUT_CLOCK_FORMAT** | **FORMAT_CLOCK_IN** |
-+---------------------------------+-----------------------------------------+
-| **INPUT_DATE_FORMAT** | **FORMAT_DATE_IN** |
-+---------------------------------+-----------------------------------------+
-| **INTERPOLANT** | **GMT_INTERPOLANT** |
-+---------------------------------+-----------------------------------------+
-| **LABEL_FONT** | **FONT_LABEL** |
-+---------------------------------+-----------------------------------------+
-| **LABEL_OFFSET** | **MAP_LABEL_OFFSET** |
-+---------------------------------+-----------------------------------------+
-| **LINE_STEP** | **MAP_LINE_STEP** |
-+---------------------------------+-----------------------------------------+
-| **MAP_SCALE_FACTOR** | **PROJ_SCALE_FACTOR** |
-+---------------------------------+-----------------------------------------+
-| **MEASURE_UNIT** | **PROJ_LENGTH_UNIT** |
-+---------------------------------+-----------------------------------------+
-| **NAN_RECORDS** | **IO_NAN_RECORDS** |
-+---------------------------------+-----------------------------------------+
-| **OBLIQUE_ANNOTATION** | **MAP_ANNOT_OBLIQUE** |
-+---------------------------------+-----------------------------------------+
-| **OUTPUT_CLOCK_FORMAT** | **FORMAT_CLOCK_OUT** |
-+---------------------------------+-----------------------------------------+
-| **OUTPUT_DATE_FORMAT** | **FORMAT_DATE_OUT** |
-+---------------------------------+-----------------------------------------+
-| **OUTPUT_DEGREE_FORMAT** | **FORMAT_GEO_OUT** |
-+---------------------------------+-----------------------------------------+
-| **PAGE_COLOR** | **PS_PAGE_COLOR** |
-+---------------------------------+-----------------------------------------+
-| **PAGE_ORIENTATION** | **PS_PAGE_ORIENTATION** |
-+---------------------------------+-----------------------------------------+
-| **PAPER_MEDIA** | **PS_MEDIA** |
-+---------------------------------+-----------------------------------------+
-| **PLOT_CLOCK_FORMAT** | **FORMAT_CLOCK_MAP** |
-+---------------------------------+-----------------------------------------+
-| **PLOT_DATE_FORMAT** | **FORMAT_DATE_MAP** |
-+---------------------------------+-----------------------------------------+
-| **PLOT_DEGREE_FORMAT** | **FORMAT_GEO_MAP** |
-+---------------------------------+-----------------------------------------+
-| **POLAR_CAP** | **MAP_POLAR_CAP** |
-+---------------------------------+-----------------------------------------+
-| **PS_COLOR** | **COLOR_HSV_MAX_V** |
-+---------------------------------+-----------------------------------------+
-| **TICK_LENGTH** | **MAP_TICK_LENGTH_PRIMARY\|SECONDARY** |
-+---------------------------------+-----------------------------------------+
-| **TICK_PEN** | **MAP_TICK_PEN_PRIMARY\|SECONDARY** |
-+---------------------------------+-----------------------------------------+
-| **TIME_FORMAT_PRIMARY** | **FORMAT_TIME_PRIMARY_MAP** |
-+---------------------------------+-----------------------------------------+
-| **TIME_FORMAT_SECONDARY** | **FORMAT_TIME_SECONDARY_MAP** |
-+---------------------------------+-----------------------------------------+
-| **UNIX_TIME_FORMAT** | **FORMAT_TIME_STAMP** |
-+---------------------------------+-----------------------------------------+
-| **UNIX_TIME_POS** | **MAP_LOGO_POS** |
-+---------------------------------+-----------------------------------------+
-| **UNIX_TIME** | **MAP_LOGO** |
-+---------------------------------+-----------------------------------------+
-| **VECTOR_SHAPE** | **MAP_VECTOR_SHAPE** |
-+---------------------------------+-----------------------------------------+
-| **VERBOSE** | **GMT_VERBOSE** |
-+---------------------------------+-----------------------------------------+
-| **WANT_LEAP_SECONDS** | **TIME_LEAP_SECONDS** |
-+---------------------------------+-----------------------------------------+
-| **X_ORIGIN** | **MAP_ORIGIN_X** |
-+---------------------------------+-----------------------------------------+
-| **XY_TOGGLE** | **IO_LONLAT_TOGGLE** |
-+---------------------------------+-----------------------------------------+
-| **Y_AXIS_TYPE** | **MAP_ANNOT_ORTHO** |
-+---------------------------------+-----------------------------------------+
-| **Y_ORIGIN** | **MAP_ORIGIN_Y** |
-+---------------------------------+-----------------------------------------+
-| **Y2K_OFFSET_YEAR** | **TIME_Y2K_OFFSET_YEAR** |
-+---------------------------------+-----------------------------------------+
-
-Note: While **TIME_LEAP_SECONDS** is a recognized keyword it is
-currently not implemented and has no effect. We reserve the right
-to enable this feature in the future.
-
-
-Switching between different GMT versions
-========================================
-
-We encourage all GMT users to start using version 5 immediately; it
-has been tested extensively by the GMT team and has benefitted from
-bug reports for the 4.5.x versions. Users who still worry about the new
-version breaking things may install GMT 4.5.x and 5 side by side.
-
-Because GMT 5 is backwards compatible with the 4.5.x series
-(provided you configured it that way) yet maintains its parameters and
-history in separate files (e.g. ``.gmtdefaults4``, versus ``gmt.conf``)
-it is possible to install and use both versions on the same workstation.
-Switching between different GMT versions can be accomplished in several
-ways, two of which will be addressed here:
-
-#. By using the :doc:`gmtswitch` utility to select the current working version.
- **Pro:** easy, interactive way to switch versions on the command line; works with
- previous GMT syntax. **Con:** editing of shell startup files required; needs write
- access in ``$HOME``-directory; manual intervention necessary if symlink
- ``$HOME/this_gmt`` is broken.
-
-#. By using the recommended ``gmt <module>``-syntax in conjunction with a shell
- helper function that points to the desired GMT executable. **Pro:** no need to
- create symlinks and edit shell startup files; scripts are more portable.
- **Con:** different syntax required.
-
-Setup of gmtswitch
-------------------
-
-Run :doc:`gmtswitch` after you have finished installing all
-GMT versions of interest. The first time you run :doc:`gmtswitch` it
-will try to find all the available versions installed on your file
-system. The versions found will be listed in the file ``.gmtversions`` in your home
-directory; each line is the full path to a GMT root directory (e.g.,
-/usr/local/GMT4.5.9). You may manually add or remove entries there at
-any time. You are then instructed to make two changes to your
-environment (the details are shell-dependent but explained by :doc:`gmtswitch`):
-
-#. :doc:`gmtswitch` creates and maintains a symbolic link ``this_gmt`` in your home
- directory that will point to a directory with one of the installed
- GMT versions.
-
-#. Make sure ``$HOME/this_gmt/bin`` is in your executable PATH.
-
-Make those edits, logout, and login again. The next time you
-run :doc:`gmtswitch` you will be able to switch between versions. Typing
-:doc:`gmtswitch` with no argument will list the available versions in a
-numerical menu and prompt you to choose one, whereas :doc:`gmtswitch`
-*version* will immediately switch to that version (*version* must be a
-piece of unique text making up the full path to a version, e.g., 4.5.9).
-If you use **bash**, **tcsh**, or **csh** you may have to type ``hash -r`` or
-``rehash`` to initiate the path changes.
-
-On Windows, the process is somewhat similar. The GMT bin directory has one batch file
-``gmtswitch.bat`` that works by changing the Windows PATH variable so that the BIN
-directory of the preferred version always comes first. To do that the batch works in two
-alternative modes.
-
-#. Permanent mode
-
-#. Temporary mode
-
-The permanent mode makes use of the free executable program `EditPath
-<http://www.softpedia.com/get/Tweak/Registry-Tweak/EditPath.shtml>`_
-to change the user path in the registry. It's called permanent because the changes
-remains until ... next change.
-Off course the editpath.exe binary must be in your system's path as well.
-WARNING: The path change will not be visible on the shell cmd where it was executed.
-For the change to be active you will need to open a new cmd window.
-
-The second mode is temporary because the path to the selected GMT binary dir is
-prepended to previous path via a shell command line. This modification disappears
-when the shell cmd window where it was executes is deleted.
-
-For further details the user should read the entire help section at the header of the
-``gmtswitch.bat``.
-
-The ``gmtswitch.bat`` solution, however, has the drawback that the batch file must be located
-elsewhere and in a directory that is on the user's PATH, otherwise it wont be located after
-first use unless the other GMT bin directory has a similar batch file. A better solution is to install the
-`Windows console enhancement <http://sourceforge.net/projects/console>`_
-that includes multiple tabs and configure the different tabs to start the different GMT versions.
-All it takes is in the Tab setting to call a batch that modifies the PATH locally. That PATH
-modifying batch will have a single line with something like:
-
- ::
-
- set path=C:\programs\gmt5\bin;%PATH%
-
-
-Version selection with helper function
---------------------------------------
-
-A shell function can be used as a wrapper around the gmt executable. This even
-works when a gmt application is in the search PATH as it would shadow the real
-command. This method can easily be applied on the command line or in scripts
-when the recommended ``gmt <module>``-syntax is used. Shell scripts using
-old-style GMT commands would have to be converted first. The syntax conversion
-can be accomplished with the :doc:`gmt5syntax` utility. A suitable bash wrapper
-function for GMT 5 would look like this:
-
-.. code-block:: bash
-
- function gmt() { /path/to/gmt5/bin/gmt "$@"; }
- export -f gmt
-
-Exporting the function is necessary to make it available to subshells and
-scripts. This wrapper function can be either set in your working shell or
-inside a GMT shell script. The latter is useful to switch to a certain GMT
-version on a per-script basis.
-
-For GMT releases prior to GMT 5 which only provide the module commands,
-we need a slightly modified version of the wrapper script:
-
-.. code-block:: bash
-
- function gmt() { module=$1; shift; /path/to/gmt4/bin/${module} "$@"; }
- export -f gmt
-
-On the command line this might be too much typing to switch between
-versions. So we might as well put everything together in a script file
-``gmtfun``:
-
-.. code-block:: bash
-
- case $1 in
- 4)
- function gmt() {
- module=$1; shift; /path/to/gmt4/bin/${module} "$@"
- }
- ;;
- 5)
- function gmt() {
- /path/to/gmt5/bin/gmt "$@"
- }
- ;;
- *)
- return
- ;;
- esac
- export -f gmt
-
-Source the file with either ``. gmtfun 4`` or ``. gmtfun 5`` to switch
-between versions.
-
-
-Introduction
-============
-
-Most scientists are familiar with the sequence: *raw data* →
-*processing* → *final illustration*.
-In order to finalize papers for submission to scientific journals,
-prepare proposals, and create overheads and slides for various
-presentations, many scientists spend large amounts of time and money to
-create camera-ready figures. This process can be tedious and is often
-done manually, since available commercial or in-house software usually
-can do only part of the job. To expedite this process we introduce the
-Generic Mapping Tools (GMT for short), which is a free [2]_, software
-package that can be used to manipulate columns of tabular data,
-time-series, and gridded data sets, and display these data in a variety
-of forms ranging from simple *x*--*y* plots to maps and color,
-perspective, and shaded-relief illustrations. GMT uses the
-PostScript page description language [*Adobe Systems Inc.*, 1990].
-With PostScript, multiple plot files can easily be superimposed to
-create arbitrarily complex images in gray tones or 24-bit true color.
-Line drawings, bitmapped images, and text can be easily combined in one
-illustration. PostScript plot files are device-independent: The same
-file can be printed at 300 dots per inch (dpi) on an ordinary
-laserwriter or at 2470 dpi on a phototypesetter when ultimate quality is
-needed. GMT software is written as a set of UNIX tools [3]_ and is
-totally self-contained and fully documented. The system is offered free
-of charge and is distributed over the computer network (Internet)
-[*Wessel and Smith, 1991; 1995; 1998*].
-
-The original version 1.0 of GMT was released in the summer of 1988
-when the authors were graduate students at Lamont-Doherty Earth
-Observatory of Columbia University. During our tenure as graduate
-students, L-DEO changed its computing environment to a distributed
-network of UNIX workstations, and we wrote GMT to run in this
-environment. It became a success at L-DEO, and soon spread to numerous
-other institutions in the US, Canada, Europe, and Japan. The current
-version benefits from the many suggestions contributed by users of the
-earlier versions, and now includes more than 50 tools, more than 30
-projections, and many other new, more flexible features. GMT provides
-scientists with a variety of tools for data manipulation and display,
-including routines to sample, filter, compute spectral estimates, and
-determine trends in time series, grid or triangulate arbitrarily spaced
-data, perform mathematical operations (including filtering) on 2-D data
-sets both in the space and frequency domain, sample surfaces along
-arbitrary tracks or onto a new grid, calculate volumes, and find trend
-surfaces. The plotting programs will let the user make linear,
-log\ :math:`_{10}`, and :math:`x^a - y^b` diagrams, polar
-and rectangular histograms, maps with filled continents and coastlines
-choosing from many common map projections, contour plots, mesh plots,
-monochrome or color images, and artificially illuminated shaded-relief
-and 3-D perspective illustrations.
-
-GMT is written in the highly portable ANSI C programming language
-[*Kernighan and Ritchie*, 1988], is fully POSIX compliant [*Lewine*,
-1991], has no Year 2000 problems, and may be used with any hardware
-running some flavor of UNIX, possibly with minor modifications. In
-writing GMT, we have followed the modular design philosophy of UNIX:
-The *raw data* → *processing* → *final illustration* flow is broken
-down to a series of elementary steps; each
-step is accomplished by a separate GMT or UNIX tool. This modular
-approach brings several benefits: (1) only a few programs are needed,
-(2) each program is small and easy to update and maintain, (3) each step
-is independent of the previous step and the data type and can therefore
-be used in a variety of applications, and (4) the programs can be
-chained together in shell scripts or with pipes, thereby creating a
-process tailored to do a user-specific task. The decoupling of the data
-retrieval step from the subsequent massage and plotting is particularly
-important, since each institution will typically have its own data base
-formats. To use GMT with custom data bases, one has only to write a
-data extraction tool which will put out data in a form readable by
-GMT (discussed below). After writing the extractor, all other
-GMT modules will work as they are.
-
-GMT makes full use of the PostScript page description language, and
-can produce color illustrations if a color PostScript device is
-available. One does not necessarily have to have access to a
-top-of-the-line color printer to take advantage of the color
-capabilities offered by GMT: Several companies offer imaging services
-where the customer provides a PostScript plot file and gets color
-slides or hardcopies in return. Furthermore, general-purpose
-PostScript raster image processors (RIPs) are now becoming available,
-letting the user create raster images from PostScript and plot these
-bitmaps on raster devices like computer screens, dot-matrix printers,
-large format raster plotters, and film writers [4]_. Because the
-publication costs of color illustrations are high, GMT offers 90
-common bit and hachure patterns, including many geologic map symbol
-types, as well as complete graytone shading operations. Additional bit
-and hachure patterns may also be designed by the user. With these tools,
-it is possible to generate publication-ready monochrome originals on a
-common laserwriter.
-
-GMT is thoroughly documented and comes with a technical reference and
-cookbook which explains the purpose of the package and its many
-features, and provides numerous examples to help new users quickly
-become familiar with the operation and philosophy of the system. The
-cookbook contains the shell scripts that were used for each example;
-PostScript\ files of each illustration are also provided. All programs
-have individual manual pages which can be installed as part of the
-on-line documentation under the UNIX **man** utility or as web
-pages. In addition, the programs offer friendly help messages which make
-them essentially self-teaching -- if a user enters invalid or ambiguous
-command arguments, the program will print a warning to the screen with a
-synopsis of the valid arguments. All the documentation is available for
-web browsing and may be installed at the user's site.
-
-The processing and display routines within GMT are completely general
-and will handle any (*x,y*) or (*x,y,z*) data as input. For many
-purposes the (*x,y*) coordinates will be (longitude, latitude) but in
-most cases they could equally well be any other variables (e.g.,
-wavelength, power spectral density). Since the GMT\ plot tools will
-map these (*x,y*) coordinates to positions on a plot or map using a
-variety of transformations (linear, log-log, and several map
-projections), they can be used with any data that are given by two or
-three coordinates. In order to simplify and standardize input and
-output, GMT uses two file formats only. Arbitrary sequences of (*x,y*)
-or (*x,y,z*) data are read from multi-column ASCII tables, i.e., each
-file consists of several records, in which each coordinate is confined
-to a separate column [5]_. This format is straightforward and allows the
-user to perform almost any simple (or complicated) reformatting or
-processing task using standard UNIX utilities such as **cut**,
-**paste**, **grep**, **sed** and **awk**. Two-dimensional data
-that have been sampled on an equidistant grid are read and written by
-GMT in a binary grid file using the functions provided with the netCDF
-library (a free, public-domain software library available separately
-from UCAR, the University Corporation of Atmospheric Research [*Treinish
-and Gough*, 1987]). This XDR (External Data Representation) based format
-is architecture independent, which allows the user to transfer the
-binary data files from one computer system to another [6]_.
-GMT contains programs that will read ASCII (*x,y,z*) files and produce
-grid files. One such program, :doc:`surface`,
-includes new modifications to the gridding algorithm developed by *Smith
-and Wessel* [1990] using continuous splines in tension.
-
-Most of the programs will produce some form of output, which falls into
-four categories. Several of the programs may produce more than one of
-these types of output:
-
-* 1-D ASCII Tables — For example, a (*x,y*) series may be
- filtered and the filtered values output. ASCII output is written to
- the standard output stream.
-
-* 2-D binary (netCDF or user-defined) grid files -- Programs that grid
- ASCII (*x,y,z*) data or operate on existing grid files produce
- this type of output.
-
-* PostScript -- The plotting programs all use the PostScript\ page
- description language to define plots. These commands are stored as
- ASCII text and can be edited should you want to customize the plot
- beyond the options available in the programs themselves.
-
-* Reports -- Several GMT programs read input files and report
- statistics and other information. Nearly all programs have an
- optional "verbose" operation, which reports on the progress of
- computation. All programs feature usage messages, which prompt the
- user if incorrect commands have been given. Such text is written to
- the standard error stream and can therefore be separated from ASCII
- table output.
-
-GMT is available over the Internet at no charge. To obtain a copy,
-goto GMT home page http://gmt.soest.hawaii.edu/ and follow instructions.
-We also maintain two electronic
-mailing lists you may subscribe to in order to stay informed about bug
-fixes and upgrades.
-
-For those without net-access that need to obtain GMT: Geoware makes
-and distributes CD-R and DVD-R media with the GMT package, compatible
-supplements, and several Gb of useful Earth and ocean science data sets.
-For more information send e-mail to geoware at geoware-online.com.
-
-GMT has served a multitude of scientists very well, and their
-responses have prompted us to develop these programs even further. It is
-our hope that the new version will satisfy these users and attract new
-users as well. We present this system to the community in order to
-promote sharing of research software among investigators in the US and abroad.
-
-References
-----------
-
-* Adobe Systems Inc., *PostScript Language Reference Manual*, 2nd
- edition, 764, Addison-Wesley, Reading, Massachusetts, 1990.
-
-* Kernighan, B. W., and D. M. Ritchie, *The C programming language*,
- 2nd edition, 272, Prentice-Hall, Englewood Cliffs, New Jersey, 1988.
-
-* Lewine, D., POSIX programmer's guide, 1st edition, 607, O'Reilly &
- Associates, Sebastopol, California, 1991.
-
-* Treinish, L. A., and M. L. Gough, A software package for the
- data-independent management of multidimensional data, *EOS Trans.
- AGU*, 68(28), 633--635, 1987. `doi:10.1029/EO068i028p00633 <http://dx.doi.org/10.1029/EO068i028p00633>`_.
-
-GMT Overview and Quick Reference
-================================
-
-GMT summary
------------
-
-The following is a summary of all the programs supplied with GMT and
-a very short description of their purpose. For more details, see the
-individual UNIX manual pages or the online web documentation. For a
-listing sorted by program purpose, see Section `GMT quick reference`_.
-
-+-----------------------+---------------------------------------------------------------------+
-| | |
-+=======================+=====================================================================+
-| :doc:`blockmean` | L\ :math:`_2` (*x*,\ *y*,\ *z*) table data filter/decimator |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`blockmedian` | L\ :math:`_1` (*x*,\ *y*,\ *z*) table data filter/decimator |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`blockmode` | Mode estimate (*x*,\ *y*,\ *z*) table data filter/decimator |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`filter1d` | Filter 1-D table data sets (time series) |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`fitcircle` | Finds the best-fitting great or small circle for a set of points |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`gmt2kml` | Like :doc:`psxy` but plots KML for use in Google Earth |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`gmtconnect` | Connect segments into more complete lines or polygons |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`gmtconvert` | Convert data tables from one format to another |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`gmtdefaults` | List the current default settings |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`gmtget` | Retrieve selected parameters in current ``gmt.conf`` file |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`gmtinfo` | Get information about table data files |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`gmtmath` | Mathematical operations on table data |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`gmtselect` | Select subsets of table data based on multiple spatial criteria |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`gmtset` | Change selected parameters in current ``gmt.conf`` file |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`gmtsimplify` | Line reduction using the Douglas-Peucker algorithm |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`gmtspatial` | Geospatial operations on lines and polygons |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`gmtvector` | Basic operations on vectors in 2-D and 3-D |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`gmtwhich` | Find full path to specified data files |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grd2cpt` | Make color palette table from a grid files |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grd2rgb` | Convert Sun raster or grid file to red, green, blue component grids |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grd2xyz` | Conversion from 2-D grid file to table data |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdblend` | Blend several partially over-lapping grid files onto one grid |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdclip` | Limit the *z*-range in gridded data sets |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdcontour` | Contouring of 2-D gridded data sets |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdcut` | Cut a sub-region from a grid file |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdedit` | Modify header information in a 2-D grid file |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdfft` | Perform operations on grid files in the frequency domain |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdfilter` | Filter 2-D gridded data sets in the space domain |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdgradient` | Compute directional gradient from grid files |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdhisteq` | Histogram equalization for grid files |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdimage` | Produce images from 2-D gridded data sets |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdinfo` | Get information about grid files |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdlandmask` | Create masking grid files from shoreline data base |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdmask` | Reset grid nodes in/outside a clip path to constants |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdmath` | Mathematical operations on grid files |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdpaste` | Paste together grid files along a common edge |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdproject` | Project gridded data sets onto a new coordinate system |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdreformat` | Converts grid files into other grid formats |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdsample` | Resample a 2-D gridded data set onto a new grid |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdtrack` | Sampling of 2-D gridded data set(s) along 1-D track |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdtrend` | Fits polynomial trends to grid files |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdvector` | Plotting of 2-D gridded vector fields |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdview` | 3-D perspective imaging of 2-D gridded data sets |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdvolume` | Calculate volumes under a surface within specified contour |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`greenspline` | Interpolation with Green's functions for splines in 1--3 D |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`kml2gmt` | Extracts coordinates from Google Earth KML files |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`makecpt` | Make color palette tables |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`mapproject` | Transformation of coordinate systems for table data |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`nearneighbor` | Nearest-neighbor gridding scheme |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`project` | Project table data onto lines or great circles |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`ps2raster` | Crop and convert PostScript files to raster images, EPS, and PDF |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`psbasemap` | Create a basemap plot |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`psclip` | Use polygon files to define clipping paths |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`pscoast` | Plot (and fill) coastlines, borders, and rivers on maps |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`pscontour` | Contour or image raw table data by triangulation |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`pshistogram` | Plot a histogram |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`psimage` | Plot Sun raster files on a map |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`pslegend` | Plot a legend on a map |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`psmask` | Create overlay to mask out regions on maps |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`psrose` | Plot sector or rose diagrams |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`psscale` | Plot gray scale or color scale on maps |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`pstext` | Plot text strings on maps |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`pswiggle` | Draw table data time-series along track on maps |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`psxy` | Plot symbols, polygons, and lines on maps |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`psxyz` | Plot symbols, polygons, and lines in 3-D |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`sample1d` | Resampling of 1-D table data sets |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`spectrum1d` | Compute various spectral estimates from time-series |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`sph2grd` | Compute grid from spherical harmonic coefficients |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`sphdistance` | Make grid of distances to nearest points on a sphere |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`sphinterpolate` | Spherical gridding in tension of data on a sphere |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`sphtriangulate` | Delaunay or Voronoi construction of spherical lon,lat data |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`splitxyz` | Split *xyz* files into several segments |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`surface` | A continuous curvature gridding algorithm |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`trend1d` | Fits polynomial or Fourier trends to :math:`y = f(x)` series |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`trend2d` | Fits polynomial trends to :math:`z = f(x,y)` series |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`triangulate` | Perform optimal Delauney triangulation and gridding |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`xyz2grd` | Convert an equidistant table *xyz* file to a 2-D grid file |
-+-----------------------+---------------------------------------------------------------------+
-
-GMT quick reference
--------------------
-
-Instead of an alphabetical listing, this section
-contains a summary sorted by program purpose. Also included is a quick
-summary of the standard command line options and a breakdown of the
-**-J** option for each of the over 30 projections available in GMT.
-
-+-----------------------+---------------------------------------------------------------------+
-| | *Filtering of 1-D and 2-D Data* |
-+=======================+=====================================================================+
-| :doc:`blockmean` | L\ :math:`_2` (*x*,\ *y*,\ *z*) table data filter/decimator |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`blockmedian` | L\ :math:`_1` (*x*,\ *y*,\ *z*) table data filter/decimator |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`blockmode` | Mode estimate (*x*,\ *y*,\ *z*) table data filter/decimator |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`filter1d` | Filter 1-D table data sets (time series) |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdfilter` | Filter 2-D gridded data sets in the space domain |
-+-----------------------+---------------------------------------------------------------------+
-| | *Plotting of 1-D and 2-D Data* |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdcontour` | Contouring of 2-D gridded data sets |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdimage` | Produce images from 2-D gridded data sets |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdvector` | Plotting of 2-D gridded vector fields |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdview` | 3-D perspective imaging of 2-D gridded data sets |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`psbasemap` | Create a basemap plot |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`psclip` | Use polygon files to define clipping paths |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`pscoast` | Plot (and fill) coastlines, borders, and rivers on maps |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`pscontour` | Contour or image raw table data by triangulation |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`pshistogram` | Plot a histogram |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`psimage` | Plot Sun raster files on a map |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`pslegend` | Plot a legend on a map |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`psmask` | Create overlay to mask out regions on maps |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`psrose` | Plot sector or rose diagrams |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`psscale` | Plot gray scale or color scale on maps |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`pstext` | Plot text strings on maps |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`pswiggle` | Draw table data time-series along track on maps |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`psxy` | Plot symbols, polygons, and lines on maps |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`psxyz` | Plot symbols, polygons, and lines in 3-D |
-+-----------------------+---------------------------------------------------------------------+
-| | *Gridding of Data Tables* |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`greenspline` | Interpolation with Green's functions for splines in 1--3 D |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`nearneighbor` | Nearest-neighbor gridding scheme |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`sphinterpolate` | Spherical gridding in tension of data on a sphere |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`surface` | A continuous curvature gridding algorithm |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`triangulate` | Perform optimal Delauney triangulation and gridding |
-+-----------------------+---------------------------------------------------------------------+
-| | *Sampling of 1-D and 2-D Data* |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`gmtsimplify` | Line reduction using the Douglas-Peucker algorithm |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdsample` | Resample a 2-D gridded data set onto a new grid |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdtrack` | Sampling of 2-D gridded data set(s) along 1-D track |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`sample1d` | Resampling of 1-D table data sets |
-+-----------------------+---------------------------------------------------------------------+
-| | *Projection and Map-transformation* |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdproject` | Project gridded data sets onto a new coordinate system |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`mapproject` | Transformation of coordinate systems for table data |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`project` | Project table data onto lines or great circles |
-+-----------------------+---------------------------------------------------------------------+
-| | *Retrieve Information* |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`gmtdefaults` | List the current default settings |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`gmtget` | Retrieve selected parameters in current file |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`gmtinfo` | Get information about table data files |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`gmtset` | Change selected parameters in current file |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdinfo` | Get information about grid files |
-+-----------------------+---------------------------------------------------------------------+
-| | *Mathematical Operations on Tables or Grids* |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`gmtmath` | Mathematical operations on table data |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`makecpt` | Make color palette tables |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`spectrum1d` | Compute various spectral estimates from time-series |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`sph2grd` | Compute grid from spherical harmonic coefficients |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`sphdistance` | Make grid of distances to nearest points on a sphere |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`sphtriangulate` | Delaunay or Voronoi construction of spherical lon,lat data |
-+-----------------------+---------------------------------------------------------------------+
-| | *Convert or Extract Subsets of Data* |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`gmtconnect` | Connect segments into more complete lines or polygons |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`gmtconvert` | Convert data tables from one format to another |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`gmtselect` | Select subsets of table data based on multiple spatial criteria |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`gmtspatial` | Geospatial operations on lines and polygons |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`gmtvector` | Basic operations on vectors in 2-D and 3-D |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grd2rgb` | Convert Sun raster or grid file to red, green, blue component grids |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grd2xyz` | Conversion from 2-D grid file to table data |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdblend` | Blend several partially over-lapping grid files onto one grid |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdcut` | Cut a sub-region from a grid file |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdpaste` | Paste together grid files along a common edge |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdreformat` | Converts grid files into other grid formats |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`splitxyz` | Split *xyz* files into several segments |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`xyz2grd` | Convert an equidistant table *xyz* file to a 2-D grid file |
-+-----------------------+---------------------------------------------------------------------+
-| | *Determine Trends in 1-D and 2-D Data* |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`fitcircle` | Finds the best-fitting great or small circle for a set of points |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdtrack` | Sampling of 2-D gridded data set(s) along 1-D track |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`trend1d` | Fits polynomial or Fourier trends to :math:`y = f(x)` series |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`trend2d` | Fits polynomial trends to :math:`z = f(x,y)` series |
-+-----------------------+---------------------------------------------------------------------+
-| | *Other Operations on 2-D Grids* |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grd2cpt` | Make color palette table from a grid files |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdclip` | Limit the *z*-range in gridded data sets |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdedit` | Modify header information in a 2-D grid file |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdfft` | Perform operations on grid files in the frequency domain |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdgradient` | Compute directional gradient from grid files |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdhisteq` | Histogram equalization for grid files |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdlandmask` | Create masking grid files from shoreline data base |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdmask` | Reset grid nodes in/outside a clip path to constants |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdmath` | Mathematical operations on grid files |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`grdvolume` | Calculate volumes under a surface within specified contour |
-+-----------------------+---------------------------------------------------------------------+
-| | *Miscellaneous Tools* |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`gmt2kml` | Like :doc:`psxy` but plots KML for use in Google Earth |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`kml2gmt` | Extracts coordinates from Google Earth KML files |
-+-----------------------+---------------------------------------------------------------------+
-| :doc:`ps2raster` | Crop and convert PostScript files to raster images, EPS, and PDF |
-+-----------------------+---------------------------------------------------------------------+
-
-
-GMT offers 31 map projections. These are specified using the **-J**
-common option. There are two conventions you may use: (a) GMT-style
-syntax and (b) **Proj4**\ -style syntax. The projection codes for the
-GMT-style are tabulated below.
-
-.. Substitution definitions:
-.. |lon0| replace:: lon\ :sub:`0`
-.. |lat0| replace:: lat\ :sub:`0`
-.. |lon1| replace:: lon\ :sub:`1`
-.. |lat1| replace:: lat\ :sub:`1`
-.. |lat2| replace:: lat\ :sub:`2`
-.. |lonp| replace:: lon\ :sub:`p`
-.. |latp| replace:: lat\ :sub:`p`
-
-+----------------------------------------------------------+--------------------------------------------------------+
-| **WITH GMT PROJECTION CODES** |
-+==========================================================+========================================================+
-| **-J** (upper case for *width*, lower case for *scale*) Map projection |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JA**\ |lon0|/|lat0|\ [/\ *horizon*]/\ *width* | Lambert azimuthal equal area |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JB**\ |lon0|/|lat0|/|lat1|/|lat2|\ *width* | Albers conic equal area |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JC**\ |lon0|/|lat0|\ *width* | Cassini cylindrical |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JCyl_stere/**\ [|lon0|\ [/|lat0|/]]\ *width* | Cylindrical stereographic |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JD**\ |lon0|/|lat0|/|lat1|/|lat2|\ *width* | Equidistant conic |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JE**\ |lon0|/|lat0|\ [/\ *horizon*]/\ *width* | Azimuthal equidistant |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JF**\ |lon0|/|lat0|\ [/\ *horizon*]/\ *width* | Azimuthal gnomonic |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JG**\ |lon0|/|lat0|\ [/\ *horizon*]/\ *width* | Azimuthal orthographic |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JG**\ |lon0|/|lat0|\ | |
-| *alt*/*azim*/*tilt*/*twist*/*W*/*H/width* | General perspective |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JH**\ |lon0|\ *width* | Hammer equal area |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JI**\ |lon0|\ *width* | Sinusoidal equal area |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JJ**\ |lon0|\ *width* | Miller cylindrical |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JKf**\ |lon0|\ *width* | Eckert IV equal area |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JKs**\ |lon0|\ *width* | Eckert VI equal area |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JL**\ |lon0|/|lat0|/|lat1|/|lat2|\ *width* | Lambert conic conformal |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JM**\ [|lon0|\ [/|lat0|/]]\ *width* | Mercator cylindrical |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JN**\ [|lon0|/]\ *width* | Robinson |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JOa**\ |lon0|/|lat0|\ *azim*/*width* | Oblique Mercator, 1: origin and azimuth |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JOb**\ |lon0|/|lat0|/|lon1|/|lat1|\ *width* | Oblique Mercator, 2: two points |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JOc**\ |lon0|/|lat0|/|lonp|/|latp|\ *width* | Oblique Mercator, 3: origin and pole |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JP**\ [**a**]\ *width*\ [/*origin*] | Polar [azimuthal] (:math:`\theta, r`) (or cylindrical) |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JPoly**\ [|lon0|\ [/|lat0|/]]\ *width* | (American) polyconic |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JQ**\ [|lon0|\ [/|lat0|/]]\ *width* | Equidistant cylindrical |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JR**\ [|lon0|/]\ *width* | Winkel Tripel |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JS**\ |lon0|/|lat0|\ [/\ *horizon*]/\ *width* | General stereographic |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JT**\ [|lon0|\ [/|lat0|/]]\ *width* | Transverse Mercator |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JU**\ *zone*/*width* | Universal Transverse Mercator (UTM) |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JV**\ [|lon0|/]\ *width* | Van der Grinten |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JW**\ [|lon0|/]\ *width* | Mollweide |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JX**\ *width*\ [**l**\ \|\ **p**\ *exp*\ \|\ | |
-| **T**\ \|\ **t**][/\ *height*\ [**l**\ \|\ **p**\ | |
-| *exp*\ \|\ **T**\ \|\ **t**]][**d**] | Linear, log\ :math:`_{10}`, :math:`x^a-y^b`, and time |
-+----------------------------------------------------------+--------------------------------------------------------+
-| **-JY**\ |lon0|/|lat0|\ *width* | Cylindrical equal area |
-+----------------------------------------------------------+--------------------------------------------------------+
-
-The projection codes for the **Proj4**-style are tabulated below;
-these all accept a map *scale*.
-
-+------------------------------------------------------------+-------------------------------------------------------+
-| **WITH Proj4 PROJECTION CODES** |
-+============================================================+=======================================================+
-| **-J** (lower case for *scale* only) Map projection |
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jaea/**\ |lon0|/|lat0|/|lat1|/|lat2|\ *scale* | Albers conic equal area |
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jaeqd/**\ |lon0|/|lat0|\ [/\ *horizon*]/\ *scale* | Azimuthal equidistant |
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jcass/**\ |lon0|/|lat0|\ *scale* | Cassini cylindrical |
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jcea/**\ |lon0|/|lat0|\ *scale* | Cylindrical equal area |
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jcyl_stere/**\ [|lon0|\ [/|lat0|/]]\ *scale* | Cylindrical stereographic |
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jeqc/**\ [|lon0|\ [/|lat0|/]]\ *scale* | Equidistant cylindrical |
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jeqdc/**\ |lon0|/|lat0|/|lat1|/|lat2|\ *scale* | Equidistant conic |
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jgnom/**\ |lon0|/|lat0|\ [/\ *horizon*]/\ *scale* | Azimuthal gnomonic |
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jhammer/**\ |lon0|\ *scale* | Hammer equal area |
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jeck4/**\ |lon0|\ *scale* | Eckert IV equal area |
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jeck6/**\ |lon0|\ *scale* | Eckert VI equal area |
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jlaea/**\ |lon0|/|lat0|\ [/\ *horizon*]/\ *scale* | Lambert azimuthal equal area |
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jlcc/**\ |lon0|/|lat0|/|lat1|/|lat2|\ *scale* | Lambert conic conformal |
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jmerc/**\ [|lon0|\ [/|lat0|/]]\ *scale* | Mercator cylindrical |
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jmill/**\ |lon0|\ *scale* | Miller cylindrical |
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jmoll/**\ [|lon0|/]\ *scale* | Mollweide |
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jnsper/**\ |lon0|/|lat0|\ | |
-| *alt/azim/tilt/twist/W/H/scale* | General perspective |
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jomerc/**\ |lon0|/|lat0|\ *azim*/*scale* | Oblique Mercator, 1: origin and azimuth |
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jomerc/**\ |lon0|/|lat0|/|lon1|/|lat1|\ *scale* | Oblique Mercator, 2: two points |
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jomercp/**\ :|lon0|/|lat0|/|lonp|/|latp|\ *scale* | Oblique Mercator, 3: origin and pole |
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jortho/**\ |lon0|/|lat0|\ [/\ *horizon*]/\ *scale* | Azimuthal orthographic |
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jpolar/**\ [**a**]\ *scale*\ [/*origin*] | Polar [azimuthal] (:math:`\theta, r`) (or cylindrical)|
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jpoly/**\ [|lon0|\ [/|lat0|/]]\ *scale* | (American) polyconic |
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jrobin/**\ [|lon0|/]\ *scale* | Robinson |
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jsinu/**\ |lat0|\ *scale* | Sinusoidal equal area |
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jstere/**\ |lon0|/|lat0|\ [/\ *horizon*]/\ *scale* | General stereographic |
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jtmerc/**\ [|lon0|\ [/|lat0|/]]\ *scale* | Transverse Mercator |
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jutm/**\ *zone*/*scale* | Universal Transverse Mercator (UTM) |
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jvandg/**\ [|lon0|/]\ *scale* | Van der Grinten |
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jwintri/**\ [|lon0|/]\ *scale* | Winkel Tripel |
-+------------------------------------------------------------+-------------------------------------------------------+
-| **-Jxy**\ *xscale*\ [**l**\ \|\ **p**\ *exp*\ \|\ | |
-| **T**\ \|\ **t**][/\ *yscale*\ [**l**\ \|\ **p**\ | |
-| *exp*\ \|\ **T**\ \|\ **t**]][**d**] | Linear, log\ :math:`_{10}`, :math:`x^a-y^b`, and time |
-+------------------------------------------------------------+-------------------------------------------------------+
-
-Finally, the rest of the GMT common options are given below:
-
-+------------------------------------------------------------+--------------------------------------------------------+
-| **STANDARDIZED COMMAND LINE OPTIONS** |
-+============================================================+========================================================+
-| **-B**\ *information* | Specify map frame and axes parameters |
-+------------------------------------------------------------+--------------------------------------------------------+
-| **-K** | Append more PS later |
-+------------------------------------------------------------+--------------------------------------------------------+
-| **-O** | This is an overlay plot |
-+------------------------------------------------------------+--------------------------------------------------------+
-| **-P** | Select Portrait orientation |
-+------------------------------------------------------------+--------------------------------------------------------+
-| **-R**\ *west/east/south/north*\ [*/zmin/zmax*][**r**] | Specify Region of interest |
-+------------------------------------------------------------+--------------------------------------------------------+
-| **-U**\ [[*just*]/\ *dx*/*dy*/][*label*] | Plot time-stamp on plot |
-+------------------------------------------------------------+--------------------------------------------------------+
-| **-V** | Run in verbose mode |
-+------------------------------------------------------------+--------------------------------------------------------+
-| **-X**\ [**a**\ \| \ **c**\ \| \ **r**]\ *off*\ [**u**] | Shift plot origin in *x*-direction |
-+------------------------------------------------------------+--------------------------------------------------------+
-| **-Y**\ [**a**\ \| \ **c**\ \| \ **r**]\ *off*\ [**u**] | Shift plot origin in *y*-direction |
-+------------------------------------------------------------+--------------------------------------------------------+
-| **-a**\ *name=col,...* | Associates aspatial data with columns |
-+------------------------------------------------------------+--------------------------------------------------------+
-| **-b**\ [**i**\ \| \ **o**][*ncol*\ ][**t**] | Select binary input or output |
-+------------------------------------------------------------+--------------------------------------------------------+
-| **-c**\ *copies* | Set number of plot copies [1] |
-+------------------------------------------------------------+--------------------------------------------------------+
-| **-f**\ [**i**\ \| \ **o**]\ *colinfo* | Set formatting of ASCII input or output |
-+------------------------------------------------------------+--------------------------------------------------------+
-| **-g**\ [**+**]\ **x**\ \| \ **X**\ \| \ **y**\ \| \ | |
-| **Y**\ \| \ **d**\ \| \ **D**\ *gap*\ [**u**] | Segment data by detecting gaps |
-+------------------------------------------------------------+--------------------------------------------------------+
-| **-h**\ [**i**\ \| \ **o**][*n\_headers*] | ASCII [input\ \| \ output] tables have header record[s]|
-+------------------------------------------------------------+--------------------------------------------------------+
-| **-i**\ *columns* | Selection of input columns |
-+------------------------------------------------------------+--------------------------------------------------------+
-| **-o**\ *columns* | Selection of output columns |
-+------------------------------------------------------------+--------------------------------------------------------+
-| **-n**\ [*type*][**+a**][\ **+b**\ *BC*] | |
-| [\ **+c**\ ][\ **+t**\ *threshold*] | Set grid interpolation mode |
-+------------------------------------------------------------+--------------------------------------------------------+
-| **-p**\ *azim/elev*\ [/*zlevel*][\ **+w**\ *lon0/lat0*\ | |
-| [/*z0*]][\ **+v**\ *x0/y0*] | Control 3-D perspective view |
-+------------------------------------------------------------+--------------------------------------------------------+
-| **-r** | Sets grid registration |
-+------------------------------------------------------------+--------------------------------------------------------+
-| **-s**\ [**z**\ \| \ *cols*] | Control treatment of NaN records |
-+------------------------------------------------------------+--------------------------------------------------------+
-| **-t**\ *transparency* | Set layer PDF transparency |
-+------------------------------------------------------------+--------------------------------------------------------+
-| **-:**\ [**i**\ \| \ **o**] | Expect *y*/*x* input rather than *x*/*y* |
-+------------------------------------------------------------+--------------------------------------------------------+
-
-General Features
-================
-
-This section explains features common to all the programs in GMT and
-summarizes the philosophy behind the system. Some of the features
-described here may make more sense once you reach the cook-book section
-where we present actual examples of their use.
-
-GMT units
----------
-
-While GMT has default units for both actual Earth distances and plot
-lengths (dimensions) of maps, it is recommended that you specifically
-indicate the units of your arguments by appending the unit character, as
-discussed below. This will aid you in debugging, let others understand your
-scripts, and remove any uncertainty as to what unit you thought you wanted.
-
-Distance units
-~~~~~~~~~~~~~~
-
-.. _tbl-distunits:
-
-+---------+-------------------+---------+------------------+
-+=========+===================+=========+==================+
-| **d** | Degree of arc | **M** | Statute mile |
-+---------+-------------------+---------+------------------+
-| **e** | Meter [Default] | **n** | Nautical mile |
-+---------+-------------------+---------+------------------+
-| **f** | Foot | **s** | Second of arc |
-+---------+-------------------+---------+------------------+
-| **k** | Kilometer | **u** | US Survey foot |
-+---------+-------------------+---------+------------------+
-| **m** | Minute of arc | | |
-+---------+-------------------+---------+------------------+
-
-For Cartesian data and scaling the data units do not normally matter
-(they could be kg or Lumens for all we know) and are never entered.
-Geographic data are different as distances can be specified in a variety
-of ways. GMT programs that accept actual Earth length scales like
-search radii or distances can therefore handle a variety of units. These
-choices are listed in Table :ref:`distunits <tbl-distunits>`; simply append the desired
-unit to the distance value you supply. A value without a unit suffix
-will be consider to be in meters. For example, a distance of 30 nautical
-miles should be given as 30\ **n**.
-
-Distance calculations
-~~~~~~~~~~~~~~~~~~~~~
-
-The calculation of distances on Earth (or other planetary bodies)
-depends on the ellipsoidal parameters of the body (via
-:ref:`PROJ_ELLIPSOID <PROJ_ELLIPSOID>`) and the method of computation. GMT offers three
-alternatives that trade off accuracy and computation time.
-
-Flat Earth distances
-^^^^^^^^^^^^^^^^^^^^
-
-Quick, but approximate "Flat Earth" calculations make a first-order
-correction for the spherical nature of a planetary body by computing the
-distance between two points A and B as
-
-.. math::
-
- d_f = R \sqrt{(\theta_A - \theta_B)^2 + \cos \left [ \frac{\theta_A +
- \theta_B}{2} \right ] \Delta \lambda^2}, \label{eq:flatearth}
-
-where *R* is the representative (or spherical) radius of the
-planet, :math:`\theta` is latitude, and the difference in longitudes,
-:math:`\Delta \lambda = \lambda_A - \lambda_B`, is adjusted for any
-jumps that might occur across Greenwich or the Dateline. As written, the
-geographic coordinates are given in radians. This approach is suitable
-when the points you use to compute :math:`d_f` do not greatly differ in
-latitude and computation speed is paramount. You can specify this mode
-of computation by using the **-** prefix to the specified distance (or
-to the unit itself in cases where no distance is required and only a
-unit is expected). For instance, a search radius of 50 statute miles
-using this mode of computation might be specified via **-S-**\ 50\ **M**.
-
-Great circle distances
-^^^^^^^^^^^^^^^^^^^^^^
-
-This is the default distance calculation, which will also approximate
-the planetary body by a sphere of mean radius *R*. However, we
-compute an exact distance between two points A and B on such a sphere
-via the Haversine equation
-
-.. math::
-
- d_g = 2R \sin^{-1} {\sqrt{\sin^2\frac{\theta_A - \theta_B}{2} + \cos
- \theta_A \cos \theta_B \sin^2 \frac{\lambda_A - \lambda_B}{2}} },
- \label{eq:greatcircle}
-
-This approach is suitable for most situations unless exact calculations
-for an ellipsoid is required (typically for a limited surface area). For
-instance, a search radius of 5000 feet using this mode of computation
-would be specified as **-S**\ 5000\ **f**.
-
-Note: There are two additional
-GMT defaults that control how
-great circle (and Flat Earth) distances are computed. One concerns the
-selection of the "mean radius". This is selected by
-:ref:`PROJ_MEAN_RADIUS <PROJ_MEAN_RADIUS>`, which selects one of several possible
-representative radii. The second is :ref:`PROJ_AUX_LATITUDE <PROJ_AUX_LATITUDE>`, which
-converts geodetic latitudes into one of several possible auxiliary
-latitudes that are better suited for the spherical approximation. While
-both settings have default values to best approximate geodesic distances
-(*authalic* mean radius and latitudes), expert users can choose from a
-range of options as detailed in the :doc:`gmt.conf` man page.
-
-Geodesic distances
-^^^^^^^^^^^^^^^^^^
-
-For the most accurate calculations we use a full ellipsoidal
-formulation. Currently, we are using Vincenty's [1975] formula [7]_. You
-select this mode of computation by using the **+** prefix to the
-specified distance (or to the unit itself in cases where no distance is
-required). For instance, a search radius of 20 km using this mode of
-computation would be set by **-S+**\ 20\ **k**.
-
-Length units
-~~~~~~~~~~~~
-
-GMT programs can accept dimensional quantities and plot lengths in
-**c**\ m, **i**\ nch, or **p**\ oint (1/72 of an inch) [8]_. There are
-two ways to ensure that GMT understands which unit you intend to use:
-
-#. Append the desired unit to the dimension you supply. This way is
- explicit and clearly communicates what you intend, e.g.,
- **-X**\ 4\ **c** means the length being passed to the **-X** switch
- is 4 cm.
-
-#. Set the parameter :ref:`PROJ_LENGTH_UNIT <PROJ_LENGTH_UNIT>` to the desired unit. Then,
- all dimensions without explicit unit will be interpreted accordingly.
-
-The latter method is less secure as other users may have a different
-unit set and your script may not work as intended. We therefore
-recommend you always supply the desired unit explicitly.
-
-GMT defaults
-------------
-
-Overview and the gmt.conf file
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-There are about 100 parameters which can be adjusted individually to
-modify the appearance of plots or affect the manipulation of data. When
-a program is run, it initializes all parameters to the
-GMT\ defaults [9]_, then tries to open the file ``gmt.conf`` in the current
-directory [10]_. If not found, it will look for that file in a
-sub-directory ``/.gmt`` of your home directory, and finally in your home directory
-itself. If successful, the program will read the contents and set the
-default values to those provided in the file. By editing this file you
-can affect features such as pen thicknesses used for maps, fonts and
-font sizes used for annotations and labels, color of the pens,
-dots-per-inch resolution of the hardcopy device, what type of spline
-interpolant to use, and many other choices. A complete list of all the
-parameters and their default values can be found in the
-:doc:`gmt.conf` manual pages. Figures
-:ref:`GMT Parameters a <gmt_defaults_a>`,
-:ref:`b <gmt_defaults_b>`, and
-:ref:`c <gmt_defaults_c>` show the parameters that affect
-plots. You may create your own ``gmt.conf`` files by running
-:doc:`gmtdefaults` and then modify those
-parameters you want to change. If you want to use the parameter settings
-in another file you can do so by specifying ``+<defaultfile>`` on the
-command line. This makes it easy to maintain several distinct parameter
-settings, corresponding perhaps to the unique styles required by
-different journals or simply reflecting font changes necessary to make
-readable overheads and slides. Note that any arguments given on the
-command line (see below) will take precedent over the default values.
-E.g., if your ``gmt.conf`` file has *x* offset = 1\ **i** as default, the
-**-X**\ 1.5\ **i** option will override the default and set the offset to 1.5 inches.
-
-.. _gmt_defaults_a:
-
-.. figure:: /_images/GMT_Defaults_1a.*
- :width: 500 px
- :align: center
-
- Some GMT parameters that affect plot appearance.
-
-.. _gmt_defaults_b:
-
-.. figure:: /_images/GMT_Defaults_1b.*
- :width: 500 px
- :align: center
-
- More GMT parameters that affect plot appearance.
-
-.. _gmt_defaults_c:
-
-.. figure:: /_images/GMT_Defaults_1c.*
- :width: 500 px
- :align: center
-
- Even more GMT parameters that affect plot appearance.
-
-There are at least two good reasons why the GMT default options are
-placed in a separate parameter file:
-
-#. It would not be practical to allow for command-line syntax covering
- so many options, many of which are rarely or never changed (such as
- the ellipsoid used for map projections).
-
-#. It is convenient to keep separate ``gmt.conf`` files for specific projects, so
- that one may achieve a special effect simply by running
- GMT commands in the directory whose ``gmt.conf`` file has the desired settings.
- For example, when making final illustrations for a journal article
- one must often standardize on font sizes and font types, etc. Keeping
- all those settings in a separate ``gmt.conf`` file simplifies this process and
- will allow you to generate those illustrations with the same settings
- later on. Likewise, GMT scripts that make figures for PowerPoint
- presentations often use a different color scheme and font size than
- output intended for laser printers. Organizing these various
- scenarios into separate ``gmt.conf`` files will minimize headaches associated with
- micro-editing of illustrations.
-
-Changing GMT defaults
-~~~~~~~~~~~~~~~~~~~~~
-
-As mentioned, GMT programs will attempt to open a file named ``gmt.conf``. At
-times it may be desirable to override that default. There are several
-ways in which this can be accomplished.
-
-* One method is to start each script by saving a copy of the current ``gmt.conf``,
- then copying the desired ``gmt.conf`` file to the current directory, and finally
- reverting the changes at the end of the script. Possible side effects
- include premature ending of the script due to user error or bugs
- which means the final resetting does not take place (unless you write
- your script very carefully.)
-
-* To permanently change some of the GMT parameters on the fly
- inside a script the :doc:`gmtset` utility
- can be used. E.g., to change the primary annotation font to 12 point
- Times-Bold in red we run
-
- ::
-
- gmt gmtset FONT_ANNOT_PRIMARY 12p,Times-Bold,red
-
- These changes will remain in effect until they are overridden.
-
-* If all you want to achieve is to change a few parameters during the
- execution of a single command but otherwise leave the environment
- intact, consider passing the parameter changes on the command line
- via the **-**\ **-**\ *PAR=value* mechanism. For instance, to temporarily
- set the output format for floating points to have lots of decimals,
- say, for map projection coordinate output, append
- **-**\ **-**\ :ref:`FORMAT_FLOAT_OUT <FORMAT_FLOAT_OUT>`\ =%.16lg to the command in question.
-
-* Finally, GMT provides to possibility to override the settings only
- during the running of a single script, reverting to the original
- settings after the script is run, as if the script was run in
- "isolation". The isolation mode is discussed in
- Section `Running GMT in isolation mode`_.
-
-In addition to those parameters that directly affect the plot there are
-numerous parameters than modify units, scales, etc. For a complete
-listing, see the :doc:`gmt.conf` man pages.
-We suggest that you go through all the available parameters at least
-once so that you know what is available to change via one of the
-described mechanisms.
-
-Command line arguments
-----------------------
-
-Each program requires certain arguments specific to its operation. These
-are explained in the manual pages and in the usage messages. Most
-programs are "case-sensitive"; almost all options must start with an
-upper-case letter. We have tried to choose letters of the alphabet which
-stand for the argument so that they will be easy to remember. Each
-argument specification begins with a hyphen (except input file names;
-see below), followed by a letter, and sometimes a number or character
-string immediately after the letter. *Do not* space between the hyphen,
-letter, and number or string. *Do* space between options. Example:
-
- ::
-
- gmt pscoast -R0/20/0/20 -Ggray -JM6i -Wthin -B5 -V -P > map.ps
-
-Standardized command line options
----------------------------------
-
-Most of the programs take many of the same arguments like those related
-to setting the data region, the map projection, etc. The 24 switches in
-Table :ref:`switches <tbl-switches>` have the same meaning in all the programs (although
-some programs may not use all of them). These options will be described
-here as well as in the manual pages, as is vital that you understand how
-to use these options. We will present these options in order of
-importance (some are use a lot more than others).
-
-.. _tbl-switches:
-
-+----------+--------------------------------------------------------------------+
-+==========+====================================================================+
-| **-B** | Define tickmarks, annotations, and labels for basemaps and axes |
-+----------+--------------------------------------------------------------------+
-| **-J** | Select a map projection or coordinate transformation |
-+----------+--------------------------------------------------------------------+
-| **-K** | Allow more plot code to be appended to this plot later |
-+----------+--------------------------------------------------------------------+
-| **-O** | Allow this plot code to be appended to an existing plot |
-+----------+--------------------------------------------------------------------+
-| **-P** | Select Portrait plot orientation [Default is landscape] |
-+----------+--------------------------------------------------------------------+
-| **-R** | Define the extent of the map/plot region |
-+----------+--------------------------------------------------------------------+
-| **-U** | Plot a time-stamp, by default in the lower left corner of page |
-+----------+--------------------------------------------------------------------+
-| **-V** | Select verbose operation; reporting on progress |
-+----------+--------------------------------------------------------------------+
-| **-X** | Set the *x*-coordinate for the plot origin on the page |
-+----------+--------------------------------------------------------------------+
-| **-Y** | Set the *y*-coordinate for the plot origin on the page |
-+----------+--------------------------------------------------------------------+
-| **-a** | Associate aspatial data from OGR/GMT files with data columns |
-+----------+--------------------------------------------------------------------+
-| **-b** | Select binary input and/or output |
-+----------+--------------------------------------------------------------------+
-| **-c** | Specify the number of plot copies |
-+----------+--------------------------------------------------------------------+
-| **-f** | Specify the data format on a per column basis |
-+----------+--------------------------------------------------------------------+
-| **-g** | Identify data gaps based on supplied criteria |
-+----------+--------------------------------------------------------------------+
-| **-h** | Specify that input/output tables have header record(s) |
-+----------+--------------------------------------------------------------------+
-| **-i** | Specify which input columns to read |
-+----------+--------------------------------------------------------------------+
-| **-n** | Specify grid interpolation settings |
-+----------+--------------------------------------------------------------------+
-| **-o** | Specify which output columns to write |
-+----------+--------------------------------------------------------------------+
-| **-p** | Control perspective views for plots |
-+----------+--------------------------------------------------------------------+
-| **-r** | Set the grid registration to pixel [Default is gridline] |
-+----------+--------------------------------------------------------------------+
-| **-s** | Control output of records containing one or more NaNs |
-+----------+--------------------------------------------------------------------+
-| **-t** | Change layer PDF transparency |
-+----------+--------------------------------------------------------------------+
-| **-:** | Assume input geographic data are (*lat,lon*) and not (*lon,lat*) |
-+----------+--------------------------------------------------------------------+
-
-Data domain or map region: The **-R** option
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The **-R** option defines the map region or data domain of interest. It
-may be specified in one of three ways, two of which are shown in Figure
-:ref:`Map region <gmt_region>`:
-
-#. **-R**\ *xmin*/*xmax*/*ymin*/*ymax*. This is the standard way to
- specify Cartesian data domains and geographical regions when using
- map projections where meridians and parallels are rectilinear.
-
-#. **-R**\ *xlleft*/*ylleft*/*xuright*/*yuright*\ **r**. This form is
- used with map projections that are oblique, making meridians and
- parallels poor choices for map boundaries. Here, we instead specify
- the lower left corner and upper right corner geographic coordinates,
- followed by the suffix **r**. This form guarantees a rectangular map
- even though lines of equal longitude and latitude are not straight lines.
-
-#. **-R**\ *gridfile*. This will copy the domain settings found for the
- grid in specified file. Note that depending on the nature of the
- calling program, this mechanism will also set grid spacing and
- possibly the grid registration (see
- Section `Grid registration: The -r option`_).
-
-.. _gmt_region:
-
-.. figure:: /_images/GMT_-R.*
- :width: 500 px
- :align: center
-
- The plot region can be specified in two different ways. (a) Extreme values
- for each dimension, or (b) coordinates of lower left and upper right corners.
-
-For rectilinear projections the first two forms give identical results.
-Depending on the selected map projection (or the kind of expected input
-data), the boundary coordinates may take on several different formats:
-
-Geographic coordinates:
- These are longitudes and latitudes and may be given in decimal
- degrees (e.g., -123.45417) or in the
- []*ddd*\ [:*mm*\ [:*ss*\ [*.xxx*]]][\ **W**\ \|\ **E**\ \|\ **S**\ \|\ **N**]
- format (e.g., 123:27:15W). Note that **-Rg** and **-Rd** are
- shorthands for "global domain" **-R**\ *0*/*360*/*-90*/*90* and
- **-R**\ *-180*/*180*/*-90*/*90*, respectively.
-
- When used in conjunction with the Cartesian Linear Transformation
- (**-Jx** or **-JX**) —which can be used to map floating point data,
- geographical coordinates, as well as time coordinates— it is prudent
- to indicate that you are using geographical coordinates in one of
- the following ways:
-
- - Use **-Rg** or **-Rd** to indicate the global domain.
-
- - Use **-Rg**\ *xmin*/*xmax*/*ymin*/*ymax* to indicate a limited
- geographic domain.
-
- - Add **W**, **E**, **S**, or **N** to the coordinate limits or add
- the generic **D** or **G**. Example:
- **-R**\ *0*/*360G*/*-90*/*90N*.
-
- Alternatively, you may indicate geographical coordinates by
- supplying **-fg**; see Section `Data type selection: The -f option`_.
-
-Projected coordinates:
- These are Cartesian projected coordinates compatible with the chosen
- projection and are given with a leading length *unit*, (e.g.,
- **k**-200/200/-300/300 for a 400 by 600 km rectangular area centered
- on the projection center (0, 0). These coordinates are internally
- converted to the corresponding geographic (longitude, latitude)
- coordinates for the lower left and upper right corners. This form is
- convenient when you want to specify a region directly in the
- projected units (e.g., UTM meters). For allowable units, see
- Table :ref:`distunits <tbl-distunits>`.
-
-Calendar time coordinates:
- These are absolute time coordinates referring to a Gregorian or ISO
- calendar. The general format is [*date*]\ **T**\ [*clock*],
- where *date* must be in the *yyyy*\ [*-mm*\ [*-dd*]] (year, month,
- day-of-month) or *yyyy*\ [*-jjj*] (year and day-of-year) for
- Gregorian calendars and *yyyy*\ [*-*\ **W**\ *ww*\ [*-d*]] (year,
- week, and day-of-week) for the ISO calendar. If no *date* is given
- we assume the current day. The **T** flag is required if a *clock* is given.
-
- The optional *clock* string is a 24-hour clock in
- *hh*\ [*:mm*\ [*:ss*\ [*.xxx*]]] format. If no *clock* is given it
- implies 00:00:00, i.e., the start of the specified day. Note that
- not all of the specified entities need be present in the data. All
- calendar date-clock strings are internally represented as double
- precision seconds since proleptic Gregorian date Monday January 1
- 00:00:00 0001. Proleptic means we assume that the modern calendar
- can be extrapolated forward and backward; a year zero is used, and
- Gregory's reforms [11]_ are extrapolated backward. Note that this is
- not historical.
-
-Relative time coordinates:
- These are coordinates which count seconds, hours, days or years
- relative to a given epoch. A combination of the parameters
- :ref:`TIME_EPOCH <TIME_EPOCH>` and :ref:`TIME_UNIT <TIME_UNIT>` define the epoch and time unit.
- The parameter :ref:`TIME_SYSTEM <TIME_SYSTEM>` provides a few shorthands for common
- combinations of epoch and unit, like **j2000** for days since noon
- of 1 Jan 2000. The default relative time coordinate is that of UNIX
- computers: seconds since 1 Jan 1970. Denote relative time
- coordinates by appending the optional lower case **t** after the
- value. When it is otherwise apparent that the coordinate is relative
- time (for example by using the **-f** switch), the **t** can be omitted.
-
-Other coordinates:
- These are simply any coordinates that are not related to geographic
- or calendar time or relative time and are expected to be simple
- floating point values such as
- []\ *xxx.xxx*\ [E: \| \ e\ \| \ D\ \| \ d[]xx], i.e.,
- regular or exponential notations, with the enhancement to understand
- FORTRAN double precision output which may use D instead of E for
- exponents. These values are simply converted as they are to internal
- representation. [12]_
-
-Coordinate transformations and map projections: The **-J** option
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-This option selects the coordinate transformation or map projection. The
-general format is
-
-- **-J**\ :math:`\delta`\ [*parameters*/]\ *scale*. Here, :math:`\delta`
- is a *lower-case* letter of the alphabet that selects a particular
- map projection, the *parameters* is zero or more slash-delimited
- projection parameter, and *scale* is map scale given in distance
- units per degree or as 1:xxxxx.
-
-- **-J**\ :math:`\Delta`\ [*parameters*/]\ *width*. Here, :math:`\Delta`
- is an *upper-case* letter of the alphabet that selects a particular
- map projection, the *parameters* is zero or more slash-delimited
- projection parameter, and *width* is map width (map height is
- automatically computed from the implied map scale and region).
-
-Since GMT version 4.3.0, there is an alternative way to specify the
-projections: use the same abbreviation as in the mapping package
-**Proj4**. The options thus either look like:
-
-- **-J**\ *abbrev*/[*parameters*/]\ *scale*. Here, **abbrev** is a
- *lower-case* abbreviation that selects a particular map projection,
- the *parameters* is zero or more slash-delimited projection
- parameter, and *scale* is map scale given in distance units per
- degree or as 1:xxxxx.
-
-- **-J**\ *Abbrev*/[*parameters*/]\ *width*. Here, **Abbrev** is an
- *capitalized* abbreviation that selects a particular map projection,
- the *parameters* is zero or more slash-delimited projection
- parameter, and *width* is map width (map height is automatically
- computed from the implied map scale and region).
-
-The projections available in GMT are presented in Figure
-:ref:`gmt_projections`. For details on all GMT projections and the required
-parameters, see the :doc:`psbasemap` man page. We will also show examples of
-every projection in the next Chapters, and a quick summary of projection
-syntax was given in Chapter `GMT overview and quick reference`.
-
-.. _gmt_projections:
-
-.. figure:: /_images/GMT_-J.*
- :width: 500 px
- :align: center
-
- The 30+ map projections and coordinate transformations available in GMT
-
-
-Map frame and axes annotations: The **-B** option
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-This is potentially the most complicated option in GMT,
-but most examples of its usage are actually quite simple. We distinguish
-between to sets of information: Frame settings and Axes parameters. These
-are set separately by their own **-B** invocations; hence multiple **-B**
-specifications may be specified. The frame settings covers things such
-as which axes should be plotted, canvas fill, plot title, and what type
-of gridlines be drawn, whereas the Axes settings deal with annotation,
-tick, and gridline intervals, axes labels, and annotation units.
-
-The Frame settings are specified by
-
-- **-B**\ [*axes*][**+b**][**+g**\ *fill*][**+o**\ *lon/lat*][**+t**\ *title*]
-
-Here, the optional *axes* dictates which of the axes should be drawn
-and possibly annotated. By default, all 4 map boundaries (or plot axes)
-are plotted (denoted **W**, **E**, **S**, **N**). To change this selection,
-append the codes for those you want (e.g., **WSn**). In this example,
-the lower case **n** denotes to draw the axis and (major and minor) tick
-marks on the "northern" (top) edge of the plot. The upper case **WS** will
-annotate the "western" and "southern" axes with numerals and plot the
-any axis labels in addition to draw axis/tick-marks. For 3-D plots you can
-also specify **Z** or **z**. By default a single vertical axes will then be
-plotted at the most suitable map corner. You can override this by appending
-any combination of corner ids **1234**, where **1** represents the lower left
-corner and the order goes counter-clockwise. Append **+b** to draw the outline
-of the 3-D box defined by **-R**; this modifier is also needed to display
-gridlines in the x--z, y--z planes. You may paint the
-map canvas by appending the **+g**\ *fill* modifier [Default is no fill].
-If gridlines are specified via the Axes parameters (discussed below) then
-by default these are referenced to the North pole. If, however, you wish
-to produce oblique gridlines about another pole you can append **+o**\ *lon/lat*
-to change this behavior (the modifier is ignored if no gridlines are requested).
-Finally, you may optionally add **+t**\ *title* to place a title that
-will appear centered above the plot frame.
-
-The Axes settings are specified by
-
-- **-B**\ [**p**\|\ **s**][**x**\|\ **x**\|\ **z**]\ *intervals*\ [\ **+l**\ *label*][**+p**\ *prefix*][**+u**\ *unit*]
-
-but you may also split this into two separate invocations for clarity, i.e.,
-
-- **-B**\ [**p**\|\ **s**][**x**\|\ **y**\|\ **z**][**+l**\ *label*][**+p**\ *prefix*][**+u**\ *unit*]
-- **-B**\ [**p**\|\ **s**][**x**\|\ **y**\|\ **z**]\ *intervals*
-
-The first optional flag following **-B** selects **p** (rimary) [Default] or
-**s** (econdary) axes information (which is mostly used for time axes
-annotations; see examples below). The next optional flags specifies which
-axes you are providing information for. This can be an individual axis
-(e.g., just **x**) or a combination (e.g., **xz**). If none are given then
-we default to **xy**. Thus, if you wish to give different annotation intervals
-or labels for the various axes then you must repeat the **B** option for
-each axis. To add a label to an axis, just append **+l**\ *label*. If the
-axis annotation should have a leading text prefix (e.g., dollar sign for those
-plots of your net worth) you can append **+p**\ *prefix*. For geographic maps
-the addition of degree symbols, etc. is automatic (and controlled by the GMT
-default setting :ref:`FORMAT_GEO_MAP <FORMAT_GEO_MAP>`). However, for other plots you can add
-specific units by adding **+u**\ *unit*. If any of these text strings contain
-spaces or special UNIX characters you will need to enclose them in quotes.
-The *intervals* specification is a concatenated string made up of substrings of the form
-
-[**t**]\ *stride*\ [*phase*][**u**].
-
-The **t** flag sets the axis
-item of interest; the available items are listed in Table :ref:`inttype <tbl-inttype>`.
-Normally, equidistant annotations occur at multiples of *stride*; you
-can phase-shift this by appending *phase*, which can be a positive or
-negative number.
-
-.. _tbl-inttype:
-
-+------------+-------------------------------------+
-| **Flag** | **Description** |
-+============+=====================================+
-| **a** | Annotation and major tick spacing |
-+------------+-------------------------------------+
-| **f** | Minor tick spacing |
-+------------+-------------------------------------+
-| **g** | Grid line spacing |
-+------------+-------------------------------------+
-
-Note that the appearance of certain time annotations (month-, week-, and
-day-names) may be affected by the :ref:`TIME_LANGUAGE <TIME_LANGUAGE>`,
-:ref:`FORMAT_TIME_PRIMARY_MAP <FORMAT_TIME_PRIMARY_MAP>`, and
-:ref:`FORMAT_TIME_SECONDARY_MAP <FORMAT_TIME_SECONDARY_MAP>` settings.
-
-For automated plots the region may not always be the same and thus it
-can be difficult to determine the appropriate *stride* in advance. Here
-GMT provides the opportunity to autoselect the spacing between the
-major and minor ticks and the grid lines, by not specifying the *stride*
-value. For example, **-Bafg** will select all three spacings
-automatically for both axes. In case of longitude--latitude plots, this
-will keep the spacing the same on both axes. You can also use
-**-Bafg/afg** to autoselect them separately.
-
-In the case of automatic spacing, when the *stride* argument is omitted
-after **g**, the grid line spacing is chosen the same as the minor tick
-spacing; unless **g** is used in consort with **a**, then the grid lines
-are spaced the same as the annotations.
-
-The unit flag **u** can take on one of 18 codes; these are listed in
-Table :ref:`units <tbl-units>`. Almost all of these units are time-axis specific.
-However, the **m** and **s** units will be interpreted as arc minutes
-and arc seconds, respectively, when a map projection is in effect.
-
-.. _tbl-units:
-
-+------------+------------------+--------------------------------------------------------------------------+
-| **Flag** | **Unit** | **Description** |
-+============+==================+==========================================================================+
-| **Y** | year | Plot using all 4 digits |
-+------------+------------------+--------------------------------------------------------------------------+
-| **y** | year | Plot using last 2 digits |
-+------------+------------------+--------------------------------------------------------------------------+
-| **O** | month | Format annotation using **FORMAT_DATE_MAP** |
-+------------+------------------+--------------------------------------------------------------------------+
-| **o** | month | Plot as 2-digit integer (1--12) |
-+------------+------------------+--------------------------------------------------------------------------+
-| **U** | ISO week | Format annotation using **FORMAT_DATE_MAP** |
-+------------+------------------+--------------------------------------------------------------------------+
-| **u** | ISO week | Plot as 2-digit integer (1--53) |
-+------------+------------------+--------------------------------------------------------------------------+
-| **r** | Gregorian week | 7-day stride from start of week (see **TIME_WEEK_START**) |
-+------------+------------------+--------------------------------------------------------------------------+
-| **K** | ISO weekday | Plot name of weekday in selected language |
-+------------+------------------+--------------------------------------------------------------------------+
-| **k** | weekday | Plot number of day in the week (1--7) (see **TIME_WEEK_START**) |
-+------------+------------------+--------------------------------------------------------------------------+
-| **D** | date | Format annotation using **FORMAT_DATE_MAP** |
-+------------+------------------+--------------------------------------------------------------------------+
-| **d** | day | Plot day of month (1--31) or day of year (1--366) |
-+------------+------------------+--------------------------------------------------------------------------+
-| | | (see **FORMAT_DATE_MAP** |
-+------------+------------------+--------------------------------------------------------------------------+
-| **R** | day | Same as **d**; annotations aligned with week (see **TIME_WEEK_START**) |
-+------------+------------------+--------------------------------------------------------------------------+
-| **H** | hour | Format annotation using **FORMAT_CLOCK_MAP** |
-+------------+------------------+--------------------------------------------------------------------------+
-| **h** | hour | Plot as 2-digit integer (0--24) |
-+------------+------------------+--------------------------------------------------------------------------+
-| **M** | minute | Format annotation using **FORMAT_CLOCK_MAP** |
-+------------+------------------+--------------------------------------------------------------------------+
-| **m** | minute | Plot as 2-digit integer (0--60) |
-+------------+------------------+--------------------------------------------------------------------------+
-| **S** | seconds | Format annotation using **FORMAT_CLOCK_MAP** |
-+------------+------------------+--------------------------------------------------------------------------+
-| **s** | seconds | Plot as 2-digit integer (0--60) |
-+------------+------------------+--------------------------------------------------------------------------+
-
-As mentioned, there may be two levels of annotations. Here, "primary" refers to the
-annotation that is closest to the axis (this is the primary annotation),
-while "secondary" refers to the secondary annotation that is plotted
-further from the axis. The examples below will clarify what is meant.
-Note that the terms "primary" and "secondary" do not reflect any
-hierarchical order of units: The "primary" annotation interval is
-usually smaller (e.g., days) while the "secondary" annotation interval
-typically is larger (e.g., months).
-
-Geographic basemaps
-^^^^^^^^^^^^^^^^^^^
-
-Geographic basemaps may differ from regular plot axis in that some
-projections support a "fancy" form of axis and is selected by the
-:ref:`MAP_FRAME_TYPE <MAP_FRAME_TYPE>` setting. The annotations will be formatted
-according to the :ref:`FORMAT_GEO_MAP <FORMAT_GEO_MAP>` template and
-:ref:`MAP_DEGREE_SYMBOL <MAP_DEGREE_SYMBOL>` setting. A simple example of part of a basemap
-is shown in Figure :ref:`Geographic map border <basemap_border>`.
-
-.. _basemap_border:
-
-.. figure:: /_images/GMT_-B_geo_1.*
- :width: 500 px
- :align: center
-
- Geographic map border using separate selections for annotation,
- frame, and grid intervals. Formatting of the annotation is controlled by
- the parameter :ref:`FORMAT_GEO_MAP <FORMAT_GEO_MAP>` in your :doc:`gmt.conf`.
-
-The machinery for primary and secondary annotations introduced for
-time-series axes can also be utilized for geographic basemaps. This may
-be used to separate degree annotations from minutes- and
-seconds-annotations. For a more complicated basemap example using
-several sets of intervals, including different intervals and pen
-attributes for grid lines and grid crosses, see Figure :ref:`Complex basemap
-<complex_basemap>`.
-
-.. _complex_basemap:
-
-.. figure:: /_images/GMT_-B_geo_2.*
- :width: 500 px
- :align: center
-
- Geographic map border with both primary (P) and secondary (S) components.
-
-Cartesian linear axes
-^^^^^^^^^^^^^^^^^^^^^
-
-For non-geographic axes, the :ref:`MAP_FRAME_TYPE <MAP_FRAME_TYPE>` setting is implicitly
-set to plain. Other than that, cartesian linear axes are very similar to
-geographic axes. The annotation format may be controlled with the
-:ref:`FORMAT_FLOAT_OUT <FORMAT_FLOAT_OUT>` parameter. By default, it is set to "%g", which
-is a C language format statement for floating point numbers [13]_, and
-with this setting the various axis routines will automatically determine
-how many decimal points should be used by inspecting the *stride*
-settings. If :ref:`FORMAT_FLOAT_OUT <FORMAT_FLOAT_OUT>` is set to another format it will be
-used directly (.e.g, "%.2f" for a fixed, two decimals format). Note that
-for these axes you may use the *unit* setting to add a unit string to
-each annotation (see Figure :ref:`Axis label <axis_label_basemap>`).
-
-.. _axis_label_basemap:
-
-.. figure:: /_images/GMT_-B_linear.*
- :width: 500 px
- :align: center
-
- Linear Cartesian projection axis. Long tickmarks accompany
- annotations, shorter ticks indicate frame interval. The axis label is
- optional. For this example we used ``-R0/12/0/0.95 -JX3i/0.3i -Ba4f2g1+lFrequency+u" %" -BS``
-
-Cartesian log\ :sub:`10` axes
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Due to the logarithmic nature of annotation spacings, the *stride*
-parameter takes on specific meanings. The following concerns are
-specific to log axes (see Figure :ref:`Logarithmic projection axis
-<Log_projection>`):
-
-* *stride* must be 1, 2, 3, or a negative integer -n.
- Annotations/ticks will then occur at 1, 1-2-5, or 1,2,3,4,...,9,
- respectively, for each magnitude range. For *-n* the
- annotations will take place every *n*\ 'th magnitude.
-
-* Append **l** to *stride*. Then, log\ :sub:`10` of the annotation
- is plotted at every integer log\ :sub:`10` value (e.g.,
- *x = 100* will be annotated as "2") [Default annotates *x* as is].
-
-* Append **p** to *stride*. Then, annotations appear as 10 raised to
- log\ :sub:`10` of the value (e.g., 10\ :sup:`-5`).
-
-.. _Log_projection:
-
-.. figure:: /_images/GMT_-B_log.*
- :width: 500 px
- :align: center
-
- Logarithmic projection axis using separate values for annotation,
- frame, and grid intervals. (top) Here, we have chosen to annotate the actual
- values. Interval = 1 means every whole power of 10, 2 means 1, 2, 5 times
- powers of 10, and 3 means every 0.1 times powers of 10. We used
- -R1/1000/0/1 -JX3il/0.25i -Ba1f2g3. (middle) Here, we have chosen to
- annotate :math:`\log_{10}` of the actual values, with -Ba1f2g3l.
- (bottom) We annotate every power of 10 using :math:`\log_{10}` of the actual
- values as exponents, with -Ba1f2g3p.
-
-Cartesian exponential axes
-^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Normally, *stride* will be used to create equidistant (in the user's
-unit) annotations or ticks, but because of the exponential nature of the
-axis, such annotations may converge on each other at one end of the
-axis. To avoid this problem, you can append **p** to *stride*, and the
-annotation interval is expected to be in transformed units, yet the
-annotation itself will be plotted as un-transformed units (see Figure
-:ref:`Power projection axis <Pow_projection>`). E.g., if
-*stride* = 1 and power = 0.5 (i.e., sqrt), then equidistant annotations
-labeled 1, 4, 9, ... will appear.
-
-.. _Pow_projection:
-
-.. figure:: /_images/GMT_-B_pow.*
- :width: 500 px
- :align: center
-
- Exponential or power projection axis. (top) Using an exponent of 0.5
- yields a :math:`sqrt(x)` axis. Here, intervals refer to actual data values,
- in -R0/100/0/0.9 -JX3ip0.5/0.25i -Ba20f10g5.
- (bottom) Here, intervals refer to projected values, although the annotation
- uses the corresponding unprojected values, as in -Ba3f2g1p.
-
-Cartesian time axes
-^^^^^^^^^^^^^^^^^^^
-
-What sets time axis apart from the other kinds of plot axes is the
-numerous ways in which we may want to tick and annotate the axis. Not
-only do we have both primary and secondary annotation items but we also
-have interval annotations versus tickmark annotations, numerous time
-units, and several ways in which to modify the plot. We will demonstrate
-this flexibility with a series of examples. While all our examples will
-only show a single *x*\ -axis (south, selected via **-BS**), time-axis
-annotations are supported for all axes.
-
-Our first example shows a time period of almost two months in Spring
-2000. We want to annotate the month intervals as well as the date at the start of each week:
-
- ::
-
- gmt set FORMAT_DATE_MAP=-o FONT_ANNOT_PRIMARY +9p
- gmt psbasemap -R2000-4-1T/2000-5-25T/0/1 -JX5i/0.2i -Bpa7Rf1d -Bsa1O -BS -P > GMT_-B_time1.ps
-
-These commands result in Figure :ref:`Cartesian time axis <cartesian_axis1>`.
-Note the leading hyphen in the :ref:`FORMAT_DATE_MAP <FORMAT_DATE_MAP>`
-removes leading zeros from calendar items (e.g., 02 becomes 2).
-
-.. _cartesian_axis1:
-
-.. figure:: /_images/GMT_-B_time1.*
- :width: 500 px
- :align: center
-
- Cartesian time axis, example 1
-
-The next example shows two different ways to annotate an axis portraying 2 days in July 1969:
-
- ::
-
- gmt set FORMAT_DATE_MAP "o dd" FORMAT_CLOCK_MAP hh:mm FONT_ANNOT_PRIMARY +9p
- gmt psbasemap -R1969-7-21T/1969-7-23T/0/1 -JX5i/0.2i -Bpa6Hf1h -Bsa1K -BS -P -K > GMT_-B_time2.ps
- gmt psbasemap -R -J -Bpa6Hf1h -Bsa1D -BS -O -Y0.65i >> GMT_-B_time2.ps
-
-The lower example (Figure :ref:`cartesian_axis2`) chooses to annotate the weekdays (by
-specifying **a**\ 1\ **K**) while the upper example choses dates (by
-specifying **a**\ 1\ **D**). Note how the clock format only selects
-hours and minutes (no seconds) and the date format selects a month name,
-followed by one space and a two-digit day-of-month number.
-
-.. _cartesian_axis2:
-
-.. figure:: /_images/GMT_-B_time2.*
- :width: 500 px
- :align: center
-
- Cartesian time axis, example 2
-
-The third example (Figure :ref:`cartesian_axis3`) presents two years, annotating
-both the years and every 3rd month.
-
- ::
-
- gmt set FORMAT_DATE_MAP o FORMAT_TIME_PRIMARY_MAP Character FONT_ANNOT_PRIMARY +9p
- gmt psbasemap -R1997T/1999T/0/1 -JX5i/0.2i -Bpa3Of1o -Bsa1Y -BS -P > GMT_-B_time3.ps
-
-Note that while the year annotation is centered on the 1-year interval,
-the month annotations must be centered on the corresponding month and
-*not* the 3-month interval. The :ref:`FORMAT_DATE_MAP <FORMAT_DATE_MAP>` selects month name
-only and :ref:`FORMAT_TIME_PRIMARY_MAP <FORMAT_TIME_PRIMARY_MAP>` selects the 1-character, upper
-case abbreviation of month names using the current language (selected by
-:ref:`TIME_LANGUAGE <TIME_LANGUAGE>`).
-
-.. _cartesian_axis3:
-
-.. figure:: /_images/GMT_-B_time3.*
- :width: 500 px
- :align: center
-
- Cartesian time axis, example 3
-
-The fourth example (Figure :ref:`cartesian_axis4`) only shows a few hours of a day, using
-relative time by specifying **t** in the **-R** option while the
-:ref:`TIME_UNIT <TIME_UNIT>` is **d** (for days). We select both primary and secondary
-annotations, ask for a 12-hour clock, and let time go from right to left:
-
- ::
-
- gmt set FORMAT_CLOCK_MAP=-hham FONT_ANNOT_PRIMARY +9p
- gmt psbasemap -R0.2t/0.35t/0/1 -JX-5i/0.2i -Bpa15mf5m -Bsa1H -BS -P > GMT_-B_time4.ps
-
-.. _cartesian_axis4:
-
-.. figure:: /_images/GMT_-B_time4.*
- :width: 500 px
- :align: center
-
- Cartesian time axis, example 4
-
-The fifth example shows a few weeks of time (Figure :ref:`cartesian_axis5`). The lower axis
-shows ISO weeks with week numbers and abbreviated names of the weekdays.
-The upper uses Gregorian weeks (which start at the day chosen by
-:ref:`TIME_WEEK_START <TIME_WEEK_START>`); they do not have numbers.
-
- ::
-
- gmt set FORMAT_DATE_MAP u FORMAT_TIME_PRIMARY_MAP Character \
- FORMAT_TIME_SECONDARY_MAP full FONT_ANNOT_PRIMARY +9p
- gmt psbasemap -R1969-7-21T/1969-8-9T/0/1 -JX5i/0.2i -Bpa1K -Bsa1U -BS -P -K > GMT_-B_time5.ps
- gmt set FORMAT_DATE_MAP o TIME_WEEK_START Sunday FORMAT_TIME_SECONDARY_MAP Chararacter
- gmt psbasemap -R -J -Bpa3Kf1k -Bsa1r -BS -O -Y0.65i >> GMT_-B_time5.ps
-
-.. _cartesian_axis5:
-
-.. figure:: /_images/GMT_-B_time5.*
- :width: 500 px
- :align: center
-
- Cartesian time axis, example 5
-
-Our sixth example (Figure :ref:`cartesian_axis6`) shows the first five months of
-1996, and we have annotated each month with an abbreviated, upper case name and
-2-digit year. Only the primary axes information is specified.
-
- ::
-
- gmt set FORMAT_DATE_MAP "o yy" FORMAT_TIME_PRIMARY_MAP Abbreviated
- gmt psbasemap -R1996T/1996-6T/0/1 -JX5i/0.2i -Ba1Of1d -BS -P > GMT_-B_time6.ps
-
-.. _cartesian_axis6:
-
-.. figure:: /_images/GMT_-B_time6.*
- :width: 500 px
- :align: center
-
- Cartesian time axis, example 6
-
-Our seventh and final example (Figure :ref:`cartesian_axis7`) illustrates
-annotation of year-days. Unless we specify the formatting with a leading hyphen
-in :ref:`FORMAT_DATE_MAP <FORMAT_DATE_MAP>` we get 3-digit integer days. Note that
-in order to have the two years annotated we need to allow for the annotation of
-small fractional intervals; normally such truncated interval must be at
-least half of a full interval.
-
- ::
-
- gmt set FORMAT_DATE_MAP jjj TIME_INTERVAL_FRACTION 0.05 FONT_ANNOT_PRIMARY +9p
- gmt psbasemap -R2000-12-15T/2001-1-15T/0/1 -JX5i/0.2i -Bpa5Df1d -Bsa1Y -BS -P > GMT_-B_time7.ps
-
-.. _cartesian_axis7:
-
-.. figure:: /_images/GMT_-B_time7.*
- :width: 500 px
- :align: center
-
- Cartesian time axis, example 7
-
-Custom axes
-^^^^^^^^^^^
-
-Irregularly spaced annotations or annotations based on
-look-up tables can be implemented using the *custom* annotation
-mechanism. Here, we given the **c** (custom) type to the **-B** option
-followed by a filename that contains the annotations (and
-tick/grid-lines specifications) for one axis. The file can contain any
-number of comments (lines starting with #) and any number of records of
-the format
-
-| *coord* *type* [*label*]
-
-The *coord* is the location of the desired annotation, tick, or
-grid-line, whereas *type* is a string composed of letters from **a**
-(annotation), **i** interval annotation, **f** frame tick, and **g**
-gridline. You must use either **a** or **i** within one file; no mixing
-is allowed. The coordinates should be arranged in increasing order. If
-*label* is given it replaces the normal annotation based on the *coord*
-value. Our last example (Figure :ref:`Custom and irregular annotations
-<Custom_annotations>`) shows such a custom basemap with an interval
-annotations on the *x*-axis and irregular annotations on the *y*-axis.
-
- ::
-
- cat << EOF > xannots.txt
- 416.0 ig Devonian
- 443.7 ig Silurian
- 488.3 ig Ordovician
- 542 ig Cambrian
- EOF
- cat << EOF > yannots.txt
- 0 a
- 1 a
- 2 f
- 2.71828 ag e
- 3 f
- 3.1415926 ag @~p@~
- 4 f
- 5 f
- 6 f
- 6.2831852 ag 2@~p@~
- EOF
- gmt psbasemap -R416/542/0/6.2831852 -JX-5i/2.5i -Bpx25f5g25+u" Ma" -Bpycyannots.txt \
- -BWS+glightblue -P -K > GMT_-B_custom.ps
- gmt psbasemap -R416/542/0/6.2831852 -JX-5i/2.5i -Bsxcxannots.txt -BWS -O \
- --MAP_ANNOT_OFFSET_SECONDARY=10p --MAP_GRID_PEN_SECONDARY=2p >> GMT_-B_custom.ps
- rm -f [xy]annots.txt
-
-.. _Custom_annotations:
-
-.. figure:: /_images/GMT_-B_custom.*
- :width: 500 px
- :align: center
-
- Custom and irregular annotations, tick-marks, and gridlines.
-
-
-Portrait plot orientation: The **-P** option
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The **-P** option selects Portrait plotting mode [14]_. In general, a
-plot has an *x*-axis increasing from left to right and a *y*-axis
-increasing from bottom to top. If the paper is turned so that the long
-dimension of the paper is parallel to the *x*-axis then the plot is said
-to have *Landscape* orientation. If the long dimension of the paper
-parallels the *y*-axis the orientation is called *Portrait* (think of
-taking pictures with a camera and these words make sense). The default
-Landscape orientation is obtained by translating the origin in the
-*x*-direction (by the width of the chosen paper :ref:`PS_MEDIA <PS_MEDIA>`) and then
-rotating the coordinate system counterclockwise by 90. By default the
-:ref:`PS_MEDIA <PS_MEDIA>` is set to Letter (or A4 if SI is chosen); this value must
-be changed when using different media, such as 11" x 17" or large format
-plotters (Figure :ref:`Plot orientation <P_option>`).
-
-.. _P_option:
-
-.. figure:: /_images/GMT_-P.*
- :width: 500 px
- :align: center
-
- Users can specify Landscape [Default] or Portrait -P) orientation.
-
-
-Plot overlays: The **-K** **-O** options
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The **-K** and **-O** options control the generation of
-PostScript code for multiple overlay plots. All PostScript files
-must have a header (for initializations), a body (drawing the figure),
-and a trailer (printing it out) (see Figure :ref:`Multiple overlay plots
-<OK_options>`). Thus, when overlaying
-several GMT plots we must make sure that the first plot call omits the
-trailer, that all intermediate calls omit both header and trailer, and
-that the final overlay omits the header. The **-K** omits the trailer
-which implies that more PostScript code will be appended later
-[Default terminates the plot system]. The **-O** selects Overlay plot
-mode and omits the header information [Default initializes a new plot
-system]. Most unexpected results for multiple overlay plots can be
-traced to the incorrect use of these options. If you run only one plot
-program, ignore both the **-O** and **-K** options; they are only used
-when stacking plots.
-
-.. _OK_options:
-
-.. figure:: /_images/GMT_-OK.*
- :width: 500 px
- :align: center
-
- A final PostScript file consists of any number of individual pieces.
-
-
-Timestamps on plots: The **-U** option
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The **-U** option draws UNIX System time stamp. Optionally, append an
-arbitrary text string (surrounded by double quotes), or the code **c**,
-which will plot the current command string (Figure
-:ref:`Time stamp <U_option>`).
-
-.. _U_option:
-
-.. figure:: /_images/GMT_-U.*
- :width: 500 px
- :align: center
-
- The -U option makes it easy to date a plot.
-
-
-Verbose feedback: The **-V** option
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The **-V** option selects verbose mode, which will send
-progress reports to standard error. Even more verbose levels are **-Vl**
-(long verbose) and **-Vd** (debug). Normal verbosity level produces only
-error and warning messages. This is the default or can be selected by
-using **-Vn**. If compiled with backward-compatibility support, the
-default is **-Vc**, which includes warnings about deprecated usage.
-Finally, **-Vq** can be used to run without any warnings or errors. This
-option can also be set by specifying the default :ref:`GMT_VERBOSE <GMT_VERBOSE>`, as
-**quiet**, **normal**, **compat**, **verbose**, **long_verbose**, or
-**debug**, in order of increased verbosity.
-
-Plot positioning and layout: The **-X** **-Y** options
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The **-X** and **-Y** options shift origin of plot by (*xoff*,\ *yoff*)
-inches (Default is (:ref:`MAP_ORIGIN_X <MAP_ORIGIN_X>`, :ref:`MAP_ORIGIN_Y <MAP_ORIGIN_Y>`) for new
-plots [15]_ and (0,0) for overlays (**-O**)). By default, all
-translations are relative to the previous origin (see Figure
-:ref:`Plot positioning <XY_options>`). Supply
-offset as **c** to center the plot in that direction relative to the
-page margin. Absolute translations (i.e., relative to a fixed point
-(0,0) at the lower left corner of the paper) can be achieve by
-prepending "a" to the offsets. Subsequent overlays will be co-registered
-with the previous plot unless the origin is shifted using these options.
-The offsets are measured in the current coordinates system (which can be
-rotated using the initial **-P** option; subsequent **-P** options for
-overlays are ignored).
-
-.. _XY_options:
-
-.. figure:: /_images/GMT_-XY.*
- :width: 300 px
- :align: center
-
- Plot origin can be translated freely with -X -Y.
-
-OGR/GMT GIS i/o: The **-a** option
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-GMT relies on external tools to translate geospatial files such as
-shapefiles into a format we can read. The tool **ogr2ogr** in the GDAL
-package can do such translations and preserve the aspatial metadata via
-a new OGR/GMT format specification (See Appendix `P. The GMT Vector Data Format for OGR Compatibility`_).
-For this to be useful we need a mechanism to associate certain metadata values with
-required input and output columns expected by GMT programs. The **-a**
-option allows you to supply one or more comma-separated associations
-*col=name*, where *name* is the name of an aspatial attribute field in a
-OGR/GMT file and whose value we wish to as data input for column *col*.
-The given aspatial field thus replaces any other value already set. Note
-that *col = 0* is the first data columns. Note that if no aspatial
-attributes are needed then the **-a** option is not needed -- GMT will
-still process and read such data files.
-
-OGR/GMT input with **-a** option
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-If you need to populate GMT data columns with (constant) values
-specified by aspatial attributes, use **-a** and append any number of
-comma-separated *col=name* associations. E.g., *2=depth* will read the
-spatial *x,y* columns from the file and add a third (*z*) column based
-on the value of the aspatial field called *depth*. You can also
-associate aspatial fields with other settings such as labels, fill
-colors, pens, and values used to look-up colors. Do so by letting the
-*col* value be one of **D**, **G**, **L**, **T**, **W**, or **Z**. This
-works analogously to how standard multi-segment files can pass such
-options via its segment headers (See Appendix `B. GMT file formats`_).
-
-OGR/GMT output with **-a** option
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-You can also make GMT table-writing tools output the OGR/GMT format
-directly. Again, specify if certain GMT data columns with constant
-values should be stored as aspatial metadata using the
-*col=name*\ [:*type*], where you can optionally specify what data type
-it should be (double, integer, string, logical, byte, or datetime)
-[double is default]. As for input, you can also use the special *col*
-entries of **D**, **G**, **L**, **T**, **W**, or **Z** to have values
-stored as options in segment headers be used as the source for the name
-aspatial field. Finally, for output you must append
-+\ **g**\ *geometry*, where *geometry* can be any of
-[**M**]\ **POINT**\ \|\ **LINE**\ \|\ **POLY**; the
-**M** represent the multi-versions of these three geometries. Use
-upper-case +\ **G** to signal that you want to split any line or polygon
-features that straddle the Dateline.
-
-Binary table i/o: The **-b** option
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-All GMT programs that accept table data input may read ASCII, native
-binary, or netCDF data. Native binary files may have a header section
-and the **-h**\ *n* option (see Section `Header data records: The -h option`_) can be used to
-skip the first *n* bytes. The data record can be in any format, mixing
-different data types and even containing byte-swapped items. When using
-native binary data the user must be aware of the fact that GMT has no
-way of determining the actual number of columns in the file. You must
-therefore pass that information to GMT via the binary
-**-bi** option, where *n* is the actual number of data
-columns and **t** must be one of **c** (signed 1-byte character,
-int8_t), **u** (unsigned 1-byte character, uint8_t), **h** (signed
-2-byte int, int16_t), **H** (unsigned 2-byte int, uint16_t), **i**
-(signed 4-byte int, int32_t), **I** (unsigned 4-byte int, uint32_t),
-**l** (signed 8-byte int, int64_t), **L** (unsigned 8-byte int,
-uint64_t), **f** (4-byte single-precision float), and **d** (8-byte
-double-precision float). In addition, use **x** to skip *n* bytes
-anywhere in the record. For a mixed-type data record you can concatenate
-several [*n*]\ **t** combinations, separated by commas. You may append
-**w** to any of the items to force byte-swapping. Alternatively, append
-**+L**\ \|\ **B** to indicate that the entire data file should be
-read or written as little- or big-endian, respectively. Here, *n* is the
-number of each item in your binary file. Note that *n* may be larger
-than *m*, the number of columns that the GMT program requires to do
-its task. If *n* is not given then it defaults to *m* and all columns
-are assumed to be of the single specified type **t** [**d** (double), if
-not set]. If *n* < *m* an error is generated. Multiple segment
-files are allowed and the segment headers are assumed to be records
-where all the fields equal NaN.
-
-For binary output, use the **-bo** option; see **-bi** for further details.
-
-Because of its meta data, reading netCDF tables (i.e., netCDF files
-containing 1-dimensional arrays) is quite a bit less complex than
-reading native binary files. When feeding netCDF tables to programs like
-:doc:`psxy`, the program will automatically
-recognize the format and read whatever amount of columns are needed for
-that program. To steer which columns are to be read, the user can append
-the suffix **?**\ *var1*\ **/**\ *var2*\ **/**\ *...* to the netCDF file
-name, where *var1*, *var2*, etc. are the names of the variables to be
-processed. No **-bi** option is needed in this case.
-
-Currently, netCDF tables can only be input, not output. For more
-information, see Appendix [app:B].
-
-Number of Copies: The **-c** option
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The **-c** option specifies the number of plot copies [Default is 1].
-This value is embedded in the PostScript file and will make a printer
-issue the chosen number of copies without respooling.
-
-Data type selection: The **-f** option
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-When map projections are not required we must explicitly state what kind
-of data each input or output column contains. This is accomplished with
-the **-f** option. Following an optional **i** (for input only) or **o**
-(for output only), we append a text string with information about each
-column (or range of columns) separated by commas. Each string starts
-with the column number (0 is first column) followed by either **x**
-(longitude), **y** (latitude), **T** (absolute calendar time) or **t**
-(relative time). If several consecutive columns have the same format you
-may specify a range of columns rather than a single column, i.e., 0--4
-for the first 5 columns. For example, if our input file has geographic
-coordinates (latitude, longitude) with absolute calendar coordinates in
-the columns 3 and 4, we would specify
-**fi**\ 0\ **y**,1\ **x**,3--4\ **T**. All other columns are assumed to
-have the default, floating point format and need not be set
-individually. The shorthand **-f**\ [**i**\ \|\ **o**]\ **g**
-means **-f**\ [**i**\ \|\ **o**]0x,1y (i.e., geographic
-coordinates). A special use of **-f** is to select **-fp**\ [*unit*],
-which *requires* **-J** and lets you use *projected* map coordinates
-(e.g., UTM meters) as data input. Such coordinates are automatically
-inverted to longitude, latitude during the data import. Optionally,
-append a length *unit* (see Table :ref:`distunits <tbl-distunits>`) [meter]. For more
-information, see Sections `Input data formats`_ and `Output data formats`_.
-
-Data gap detection: The **-g** option
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-GMT has several mechanisms that can determine line
-segmentation. Typically, data segments are separated by multiple segment
-header records (see Appendix `B. GMT file formats`_). However, if key data columns contain a
-NaN we may also use that information to break lines into multiple
-segments. This behavior is modified by the parameter
-**IO_NAN_RECORDS** which by default is set to *skip*, meaning such
-records are considered bad and simply skipped. If you wish such records
-to indicate a segment boundary then set this parameter to *pass*.
-Finally, you may wish to indicate gaps based on the data values
-themselves. The **-g** option is used to detect gaps based on one or
-more criteria (use **-g+** if *all* the criteria must be met; otherwise
-only one of the specified criteria needs to be met to signify a data
-gap). Gaps can be based on excessive jumps in the *x*- or
-*y*-coordinates (**-gx** or **-gy**), or on the distance between points
-(**-gd**). Append the *gap* distance and optionally a unit for actual
-distances. For geographic data the optional unit may be arc
-**d**\ egree, **m**\ inute, and **s**\ econd, or m\ **e**\ ter
-[Default], **f**\ eet, **k**\ ilometer, **M**\ iles, or **n**\ autical
-miles. For programs that map data to map coordinates you can optionally
-specify these criteria to apply to the projected coordinates (by using
-upper-case **-gX**, **-gY** or **-gD**). In that case, choose from
-**c**\ entimeter, **i**\ nch or **p**\ oint [Default unit is controlled
-by **PROJ_LENGTH_UNIT**]. Note: For **-gx** or **-gy** with time data
-the unit is instead controlled by :ref:`TIME_UNIT <TIME_UNIT>`.
-
-Header data records: The **-h** option
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The **-h**\ [**i**\ \|\ **o**][*n_recs*] option
-lets GMT know that input file(s) have *n_recs* header records [0]. If
-there are more than one header record you must specify the number after
-the **-h** option, e.g., **-h**\ 4. Note that blank lines and records
-that start with the character # are automatically considered header
-records and skipped. Thus, *n_recs* refers to general text lines that
-do *not* start with # and thus must specifically be skipped in order for
-the programs to function properly. The default number of such header
-records if **-h** is used is one of the many parameters in the :doc:`gmt.conf` file
-(**IO_N_HEADER_RECS**, by default 0), but can be overridden by
-**-h**\ *n_header_recs*. Normally, programs that both read and write
-tables will output the header records that are found on input. Use
-**-hi** to suppress the writing of header records. You can use the
-**-h** options modifiers to to tell programs to output extra header
-records for titles, remarks or column names identifying each data column.
-
-When **-b** is used to indicate binary data the **-h** takes on a
-slightly different meaning. Now, the *n_recs* argument is taken to mean
-how many *bytes* should be skipped (on input) or padded with the space
-character (on output).
-
-Input columns selection: The **-i** option
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The **-i**\ *columns* option allows you to specify which
-input file data columns to use and in what order. By default, GMT will
-read all the data columns in the file, starting with the first column
-(0). Using **-i** modifies that process. For instance, to use the 4th,
-7th, and 3rd data column as the required *x,y,z* to
-:doc:`blockmean` you would specify
-**-i**\ 3,6,2 (since 0 is the first column). The chosen data columns
-will be used as is. Optionally, you can specify that input columns
-should be transformed according to a linear or logarithmic conversion.
-Do so by appending [**l**][\ **s**\ *scale*][\ **o**\ *offset*] to
-each column (or range of columns). All items are optional: The **l**
-implies we should first take :math:`\log_{10}` of the data [leave as
-is]. Next, we may scale the result by the given *scale* [1]. Finally, we
-add in the specified *offset* [0].
-
-Grid interpolation parameters: The **-n** option
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The **-n**\ *type* option controls parameters used for
-2-D grids resampling. You can select the type of spline used (**-nb**
-for B-spline smoothing, **-nc** for bicubic [Default], **-nl** for
-bilinear, or **-nn** for nearest-node value). For programs that support
-it, antialiasing is by default on; optionally, append **+a** to switch
-off antialiasing. By default, boundary conditions are set according to
-the grid type and extent. Change boundary conditions by appending
-**+b**\ *BC*, where *BC* is either **g** for geographic boundary
-conditions or one (or both) of **n** and **p** for natural or periodic
-boundary conditions, respectively. Append **x** or **y** to only apply
-the condition in one dimension. E.g., **-nb+nxpy** would imply natural
-boundary conditions in the *x* direction and periodic conditions in the
-*y* direction. Finally, append **+t**\ *threshold* to control how close
-to nodes with NaN the interpolation should go. A *threshold* of 1.0
-requires all (4 or 16) nodes involved in the interpolation to be
-non-NaN. 0.5 will interpolate about half way from a non-NaN value; 0.1
-will go about 90% of the way, etc.
-
-Output columns selection: The **-o** option
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The **-o**\ *columns* option allows you to specify which
-columns to write on output and in what order. By default, GMT will
-write all the data columns produced by the program. Using **-o**
-modifies that process. For instance, to write just the 4th and 2nd data
-column to the output you would use **-o**\ 3,1 (since 0 is the first column).
-
-Perspective view: The **-p** option
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-All plotting programs that normally produce a flat, two-dimensional
-illustration can be told to view this flat illustration from a
-particular vantage point, resulting in a perspective view. You can
-select perspective view with the **-p** option by setting the azimuth
-and elevation of the viewpoint [Default is 180/90]. When **-p** is used
-in consort with **-Jz** or **-JZ**, a third value can be appended which
-indicates at which *z*-level all 2-D material, like the plot frame, is
-plotted (in perspective) [Default is at the bottom of the z-axis]. For
-frames used for animation, you may want to append **+** to fix the
-center of your data domain (or specify a particular world coordinate
-point with **+w**\ *lon0/lat*\ [*z*\ ]) which will project to the center
-of your page size (or you may specify the coordinates of the *projected*
-view point with **+v**\ *x0/y0*. When **-p** is used without any further
-arguments, the values from the last use of **-p** in a previous
-GMT\ command will be used.
-
-.. _grid-registration:
-
-Grid registration: The **-r** option
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-All 2-D grids in GMT have their nodes
-organized in one of two ways, known as *gridline*- and *pixel*
-registration. The GMT default is gridline registration; programs that
-allow for the creation of grids can use the **-r** option to select
-pixel registration instead.
-
-Gridline registration
-^^^^^^^^^^^^^^^^^^^^^
-
-In this registration, the nodes are centered on the grid line
-intersections and the data points represent the average value in a cell
-of dimensions (:math:`x_{inc} \cdot y_{inc}`) centered on each node
-(left side of Figure :ref:`Grid registration <Grid_registration>`).
-In the case of grid line registration the number of nodes are related
-to region and grid spacing by
-
-.. math::
-
- \begin{array}{ccl}
- nx & = & (x_{max} - x_{min}) / x_{inc} + 1 \\
- ny & = & (y_{max} - y_{min}) / y_{inc} + 1
- \end{array}
-
-which for the example in left side of Figure :ref:`Gridline registration
-<Grid_registration>` yields nx = ny = 4.
-
-Pixel registration
-^^^^^^^^^^^^^^^^^^
-
-Here, the nodes are centered in the grid cells, i.e., the areas
-between grid lines, and the data points represent the average values
-within each cell (right side of Figure :ref:`Grid registration
-<Grid_registration>`). In the case of
-pixel registration the number of nodes are related to region and grid
-spacing by
-
-.. _Grid_registration:
-
-.. figure:: /_images/GMT_registration.*
- :width: 500 px
- :align: center
-
- Gridline- and pixel-registration of data nodes.
-
-
-.. math::
-
- \begin{array}{ccl}
- nx & = & (x_{max} - x_{min}) / x_{inc} \\
- ny & = & (y_{max} - y_{min}) / y_{inc}
- \end{array}
-
-Thus, given the same region (**-R**) and grid spacing, the
-pixel-registered grids have one less column and one less row than the
-gridline-registered grids; here we find nx = ny = 3.
-
-NaN-record treatment: The **-s** option
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-We can use this option to suppress output for records whose *z*-value
-equals NaN (by default we output all records). Alternatively, append
-**r** to reverse the suppression, i.e., only output the records whose
-*z*-value equals NaN. Use **-sa** to suppress output records where one
-or more fields (and not necessarily *z*) equal NaN. Finally, you can
-supply a comma-separated list of all columns or column ranges to
-consider for this NaN test.
-
-Layer PDF transparency: The **-t** option
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-While the PostScript language does not support transparency, PDF does,
-and via PostScript extensions one can manipulate the transparency
-levels of objects. The **-t** option allows you to change the
-transparency level for the current overlay by appending a percentage in
-the 0--100 range; the default is 0, or opaque. Transparency may also be
-controlled on a feature by feature basis when setting color or fill (see
-section `Specifying area fill attributes`_).
-
-Latitude/Longitude or Longitude/Latitude?: The **-:** option
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-For geographical data, the first column is expected to contain
-longitudes and the second to contain latitudes. To reverse this
-expectation you must apply the **-:** option. Optionally, append **i**
-or **o** to restrict the effect to input or output only. Note that
-command line arguments that may take geographic coordinates (e.g.,
-**-R**) *always* expect longitude before latitude. Also, geographical
-grids are expected to have the longitude as first (minor) dimension.
-
-Command line history
---------------------
-
-GMT programs "remember" the standardized command line options (See
-Section `Standardized command line options`_) given during their previous invocations and this
-provides a shorthand notation for complex options. For example, if a
-basemap was created with an oblique Mercator projection, specified as
-
- ::
-
- -Joc170W/25:30S/33W/56:20N/1:500000
-
-then a subsequent :doc:`psxy` command to plot
-symbols only needs to state **-J**\ o in order to activate the same
-projection. In contrast, note that **-J** by itself will pick the most
-recently used projection. Previous commands are maintained in the file ``gmt.history``,
-of which there will be one in each directory you run the programs from.
-This is handy if you create separate directories for separate projects
-since chances are that data manipulations and plotting for each project
-will share many of the same options. Note that an option spelled out on
-the command line will always override the previous entry in the ``gmt.history`` file and, if
-execution is successful, will replace this entry as the previous option
-argument in the ``gmt.history`` file. If you call several GMT modules piped together
-then GMT cannot guarantee that the ``gmt.history`` file is processed in the intended
-order from left to right. The only guarantee is that the file will not
-be clobbered since GMT uses advisory file locking. The uncertainty in
-processing order makes the use of shorthands in pipes unreliable. We
-therefore recommend that you only use shorthands in single process
-command lines, and spell out the full command option when using chains
-of commands connected with pipes.
-
-Usage messages, syntax- and general error messages
---------------------------------------------------
-
-Each program carries a usage message. If you enter the program name
-without any arguments, the program will write the complete usage message
-to standard error (your screen, unless you redirect it). This message
-explains in detail what all the valid arguments are. If you enter the
-program name followed by a *hyphen* (-) only you will get a shorter
-version which only shows the command line syntax and no detailed
-explanations. If you incorrectly specify an option or omit a required
-option, the program will produce syntax errors and explain what the
-correct syntax for these options should be. If an error occurs during
-the running of a program, the program will in some cases recognize this
-and give you an error message. Usually this will also terminate the run.
-The error messages generally begin with the name of the program in which
-the error occurred; if you have several programs piped together this
-tells you where the trouble is.
-
-Standard input or file, header records
---------------------------------------
-
-Most of the programs which expect table data input can read either
-standard input or input in one or several files. These programs will try
-to read *stdin* unless you type the filename(s) on the command line
-without the above hyphens. (If the program sees a hyphen, it reads the
-next character as an instruction; if an argument begins without a
-hyphen, it tries to open this argument as a filename). This feature
-allows you to connect programs with pipes if you like. If your input is
-ASCII and has one or more header records that do not begin with #, you
-must use the **-h** option (see Section `Header data records: The -h
-option`_). ASCII files may in many cases also contain segment-headers
-separating data segments. These are called "multi-segment files". For
-binary table data the **-h** option may specify how many bytes should be
-skipped before the data section is reached. Binary files may also
-contain segment-headers separating data segments. These segment-headers
-are simply data records whose fields are all set to NaN; see Appendix
-[app:B] for complete documentation.
-
-If filenames are given for reading, GMT programs will first look for
-them in the current directory. If the file is not found, the programs
-will look in two other directories pointed to by the
-:ref:`directory parameters <DIR Parameters>` **DIR_DATA**
-or by the environmental parameters **$GMT_USERDIR** and
-**$GMT_DATADIR** (if set). They may be set by the user to point to
-directories that contain data sets of general use, thus eliminating the
-need to specify a full path to these files. Usually, the **DIR_DATA**
-directory will hold data sets of a general nature (tables, grids),
-whereas the **$GMT_USERDIR** directory (its default value is $HOME/.gmt)
-may hold miscellaneous data sets more
-specific to the user; this directory also stores GMT defaults and other
-configuration files. See :ref:`directory parameters <DIR Parameters>`
-for details. Program output is always written to the current directory
-unless a full path has been specified.
-
-Verbose operation
------------------
-
-Most of the programs take an optional **-V** argument which will run the
-program in the "verbose" mode (see Section `Verbose feedback: The -V
-option`_). Verbose will write to standard error information about the
-progress of the operation you are running. Verbose reports things such
-as counts of points read, names of data files processed, convergence of
-iterative solutions, and the like. Since these messages are written to
-*stderr*, the verbose talk remains separate from your data output. You
-may optionally choose among five models of *verbosity*; each mode adds
-more messages with an increasing level of details. The modes are
-
- **q** Complete silence, not even fatal error messages.
-
- **n** Warnings and progress messages [Default].
-
- **c** Warnings about deprecated usage (if compiled for compatibility).
-
- **l** Detailed progress messages.
-
- **d** Debugging messages.
-
-The verbosity is cumulative, i.e., mode **l** means all messages of mode
-**n** as well. will be reported.
-
-Program output
---------------
-
-Most programs write their results, including PostScript\ plots, to
-standard output. The exceptions are those which may create binary netCDF
-grid files such as :doc:`surface` (due to the
-design of netCDF a filename must be provided; however, alternative
-binary output formats allowing piping are available; see Section
-`Grid file format specifications`_).
-Most operating systems let you can redirect
-standard output to a file or pipe it into another process. Error
-messages, usage messages, and verbose comments are written to standard
-error in all cases. You can usually redirect standard error as well, if
-you want to create a log file of what you are doing. The syntax for
-redirection differ among the main shells (Bash and C-shell) and is a bit
-limited in DOS.
-
-Input data formats
-------------------
-
-Most of the time, GMT will know what kind of *x* and *y*
-coordinates it is reading because you have selected a particular
-coordinate transformation or map projection. However, there may be times
-when you must explicitly specify what you are providing as input using
-the **-f** switch. When binary input data are expected (**-bi**) you
-must specify exactly the format of the records. However, for ASCII input
-there are numerous ways to encode data coordinates (which may be
-separated by white-space or commas). Valid input data are generally of
-the same form as the arguments to the **-R** option (see
-Section `Data domain or map region: The -R option`_), with additional flexibility for calendar data.
-Geographical coordinates, for example, can be given in decimal degrees
-(e.g., -123.45417) or in the
-[]*ddd*\ [:*mm*\ [:*ss*\ [*.xxx*\ ]]][\ **W**\ \| \ **E**\ \| \ **S**\ \| \ **N**]
-format (e.g., 123:27:15W). With **-fp** you may even supply projected
-data like UTM coordinates.
-
-Because of the widespread use of incompatible and ambiguous formats, the
-processing of input date components is guided by the template
-:ref:`FORMAT_DATE_IN <FORMAT_DATE_IN>` in your :doc:`gmt.conf` file; it is by default set to *yyyy-mm-dd*.
-Y2K-challenged input data such as 29/05/89 can be processed by setting
-:ref:`FORMAT_DATE_IN <FORMAT_DATE_IN>` to dd/mm/yy. A complete description of possible
-formats is given in the :doc:`gmt.conf` man
-page. The *clock* string is more standardized but issues like 12- or
-24-hour clocks complicate matters as well as the presence or absence of
-delimiters between fields. Thus, the processing of input clock
-coordinates is guided by the template :ref:`FORMAT_CLOCK_IN <FORMAT_CLOCK_IN>` which
-defaults to *hh:mm:ss.xxx*.
-
-GMT programs that require a map projection argument will implicitly
-know what kind of data to expect, and the input processing is done
-accordingly. However, some programs that simply report on minimum and
-maximum values or just do a reformatting of the data will in general not
-know what to expect, and furthermore there is no way for the programs to
-know what kind of data other columns (beyond the leading *x* and
-*y* columns) contain. In such instances we must explicitly tell
-GMT that we are feeding it data in the specific geographic or calendar
-formats (floating point data are assumed by default). We specify the
-data type via the **-f** option (which sets both input and output
-formats; use **-fi** and **-fo** to set input and output separately).
-For instance, to specify that the the first two columns are longitude
-and latitude, and that the third column (e.g., *z*) is absolute
-calendar time, we add **-fi**\ 0x,1y,2T to the command line. For more
-details, see the man page for the program you need to use.
-
-Output data formats
--------------------
-
-The numerical output from GMT programs can be binary (when **-bo** is
-used) or ASCII [Default]. In the latter case the issue of formatting
-becomes important. GMT provides extensive machinery for allowing just
-about any imaginable format to be used on output. Analogous to the
-processing of input data, several templates guide the formatting
-process. These are :ref:`FORMAT_DATE_OUT <FORMAT_DATE_OUT>` and :ref:`FORMAT_CLOCK_OUT <FORMAT_CLOCK_OUT>` for
-calendar-time coordinates, :ref:`FORMAT_GEO_OUT <FORMAT_GEO_OUT>` for geographical
-coordinates, and :ref:`FORMAT_FLOAT_OUT <FORMAT_FLOAT_OUT>` for generic floating point data.
-In addition, the user have control over how columns are separated via
-the :ref:`IO_COL_SEPARATOR <IO_COL_SEPARATOR>` parameter. Thus, as an example, it is possible
-to create limited FORTRAN-style card records by setting
-:ref:`FORMAT_FLOAT_OUT <FORMAT_FLOAT_OUT>` to %7.3lf and :ref:`IO_COL_SEPARATOR <IO_COL_SEPARATOR>` to none
-[Default is tab].
-
-PostScript features
----------------------
-
-PostScript is a command language for driving graphics devices such as
-laser printers. It is ASCII text which you can read and edit as you wish
-(assuming you have some knowledge of the syntax). We prefer this to
-binary metafile plot systems since such files cannot easily be modified
-after they have been created. GMT programs also write many comments to
-the plot file which make it easier for users to orient themselves should
-they need to edit the file (e.g., % Start of x-axis) [16]_. All
-GMT programs create PostScript code by calling the :doc:`PSL <pslib>` plot
-library (The user may call these functions from his/her own C or FORTRAN
-plot programs. See the manual pages for :doc:`PSL <pslib>` syntax). Although
-GMT programs can create very individualized plot code, there will
-always be cases not covered by these programs. Some knowledge of
-PostScript will enable the user to add such features directly into the
-plot file. By default, GMT will produce freeform PostScript output
-with embedded printer directives. To produce Encapsulated
-PostScript (EPS) that can be imported into graphics programs such as
-**CorelDraw**, **Illustrator** or **InkScape** for further
-embellishment, simply run :doc:`ps2raster`
-**-Te**. See Appendix [app:C] for an extensive discussion of converting
-PostScript to other formats.
-
-.. _-Wpen_attrib:
-
-Specifying pen attributes
--------------------------
-
-A pen in GMT has three attributes: *width*, *color*, and
-*style*. Most programs will accept pen attributes in the form of an
-option argument, with commas separating the given attributes, e.g.,
-
-**-W**\ [*width*\ [**c\ \|\ i\ \|\ p**]],[*color*],[\ *style*\ [**c\ \|\ i\ \|\ p\ \|**]]
-
- *Width* is by default measured in points (1/72 of an inch). Append
- **c**, **i**, or **p** to specify pen width in cm, inch, or points,
- respectively. Minimum-thickness pens can be achieved by giving zero
- width, but the result is device-dependent. Finally, a few predefined
- pen names can be used: default, faint, and {thin, thick,
- fat}[er\ \|\ est], and obese. Table :ref:`pennames <tbl-pennames>` shows this
- list and the corresponding pen widths.
-
-.. _tbl-pennames:
-
- +------------+---------+------------+--------+
- +============+=========+============+========+
- | faint | 0 | thicker | 1.5p |
- +------------+---------+------------+--------+
- | default | 0.25p | thickest | 2p |
- +------------+---------+------------+--------+
- | thinnest | 0.25p | fat | 3p |
- +------------+---------+------------+--------+
- | thinner | 0.50p | fatter | 6p |
- +------------+---------+------------+--------+
- | thin | 0.75p | fattest | 12p |
- +------------+---------+------------+--------+
- | thick | 1.0p | obese | 18p |
- +------------+---------+------------+--------+
-
- The *color* can be specified in five different ways:
-
- #. Gray. Specify a *gray* shade in the range 0--255 (linearly going
- from black [0] to white [255]).
-
- #. RGB. Specify *r*/*g*/*b*, each ranging from 0--255. Here 0/0/0 is
- black, 255/255/255 is white, 255/0/0 is red, etc.
-
- #. HSV. Specify *hue*-*saturation*-*value*, with the former in the
- 0--360 degree range while the latter two take on the range 0--1 [17]_.
-
- #. CMYK. Specify *cyan*/*magenta*/*yellow*/*black*, each ranging
- from 0--100%.
-
- #. Name. Specify one of 663 valid color names. Use **man
- gmtcolors** to list all valid names. A very small yet versatile
- subset consists of the 29 choices *white*, *black*, and
- [light:\|\ dark]{*red, orange, yellow, green, cyan, blue,
- magenta, gray\ \|\ grey, brown*\ }. The color names are
- case-insensitive, so mixed upper and lower case can be used (like
- *DarkGreen*).
-
- The *style* attribute controls the appearance of the line. Giving "dotted" or "."
- yields a dotted line, whereas a dashed pen is requested with "dashed" or "-".
- Also combinations of dots and dashes, like ".-" for a dot-dashed
- line, are allowed. To override a default style and secure a solid line you can
- specify "solid" for style. The lengths of dots and dashes are scaled
- relative to the pen width (dots has a length that equals the pen
- width while dashes are 8 times as long; gaps between segments are 4
- times the pen width). For more detailed attributes including exact
- dimensions you may specify *string*:*offset*, where *string* is a
- series of numbers separated by underscores. These numbers represent
- a pattern by indicating the length of line segments and the gap
- between segments. The *offset* phase-shifts the pattern from the
- beginning the line. For example, if you want a yellow line of width
- 0.1 cm that alternates between long dashes (4 points), an 8 point
- gap, then a 5 point dash, then another 8 point gap, with pattern
- offset by 2 points from the origin, specify
- **-W**\ 0.1c,yellow,4_8_5_8:2p. Just as with pen width, the
- default style units are points, but can also be explicitly specified
- in cm, inch, or points (see *width* discussion above).
-
-Table :ref:`penex <tbl-penex>` contains additional examples of pen specifications
-suitable for, say, :doc:`psxy`.
-
-.. _tbl-penex:
-
-+-------------------------------+-----------------------------------------------------+
-+===============================+=====================================================+
-| **-W**\ 0.5p | 0.5 point wide line of default color and style |
-+-------------------------------+-----------------------------------------------------+
-| **-W**\ green | Green line with default width and style |
-+-------------------------------+-----------------------------------------------------+
-| **-W**\ thin,red,- | Dashed, thin red line |
-+-------------------------------+-----------------------------------------------------+
-| **-W**\ fat,. | Fat dotted line with default color |
-+-------------------------------+-----------------------------------------------------+
-| **-W**\ 0.1c,120-1-1 | Green (in h-s-v) pen, 1 mm thick |
-+-------------------------------+-----------------------------------------------------+
-| **-W**\ faint,100/0/0/0,..- | Very thin, cyan (in c/m/y/k), dot-dot-dashed line |
-+-------------------------------+-----------------------------------------------------+
-
-In addition to these pen settings there are several
-PostScript settings that can affect the appearance of lines. These are
-controlled via the GMT defaults settings :ref:`PS_LINE_CAP <PS_LINE_CAP>`,
-:ref:`PS_LINE_JOIN <PS_LINE_JOIN>`, and :ref:`PS_MITER_LIMIT <PS_MITER_LIMIT>`. They determine how a line
-segment ending is rendered, be it at the termination of a solid line or
-at the end of all dashed line segments making up a line, and how a
-straight lines of finite thickness should behave when joined at a common
-point. By default, line segments have rectangular ends, but this can
-change to give rounded ends. When :ref:`PS_LINE_CAP <PS_LINE_CAP>` is set to round the
-a segment length of zero will appear as a circle. This can be used to
-created circular dotted lines, and by manipulating the phase shift in
-the *style* attribute and plotting the same line twice one can even
-alternate the color of adjacent items.
-Figure :ref:`Line appearance <Line_appearance>` shows various lines made in this
-fashion. See the :doc:`gmt.conf` man page for more information.
-
-.. _Line_appearance:
-
-.. figure:: /_images/GMT_linecap.*
- :width: 500 px
- :align: center
-
- Line appearance can be varied by using :ref:`PS_LINE_CAP <PS_LINE_CAP>`
-
-Specifying area fill attributes
--------------------------------
-
-Many plotting programs will allow the user to draw filled polygons or
-symbols. The fill specification may take two forms:
-
-**-G**\ *fill*
-
-**-Gp**\ *dpi/pattern*\ [:**B**\ *color*\ [**F**\ *color*]]
-
-fill:
- In the first case we may specify a *gray* shade (0--255), RGB color
- (*r*/*g*/*b* all in the 0--255 range or in hexadecimal *#rrggbb*),
- HSV color (*hue*-*saturation*-*value* in the 0--360, 0--1, 0--1 range),
- CMYK color (*cyan*/*magenta*/*yellow*/*black*, each ranging from
- 0--100%), or a valid color *name*; in that respect it is similar to
- specifying the pen color settings (see pen color discussion under
- Section `Specifying pen attributes`_).
-
-pattern:
- The second form allows us to use a predefined bit-image pattern.
- *pattern* can either be a number in the range 1--90 or the name of a
- 1-, 8-, or 24-bit Sun raster file. The former will result in one of
- the 90 predefined 64 x 64 bit-patterns provided with GMT and
- reproduced in Appendix [app:E]. The latter allows the user to create
- customized, repeating images using standard Sun raster files [18]_.
- The *dpi* parameter sets the resolution of this image on the page;
- the area fill is thus made up of a series of these "tiles".
- Specifying *dpi* as 0 will result in highest resolution obtainable
- given the present dpi setting in ``gmt.history``. By specifying upper case **-GP**
- instead of **-Gp** the image will be bit-reversed, i.e., white and
- black areas will be interchanged (only applies to 1-bit images or
- predefined bit-image patterns). For these patterns and other 1-bit
- images one may specify alternative background and foreground colors
- (by appending :**B**\ *color*\ [**F**\ *color*]) that will replace
- the default white and black pixels, respectively. Setting one of the
- fore- or background colors to - yields a *transparent* image where
- only the back- *or* foreground pixels will be painted.
-
-Due to PostScript implementation limitations the raster images used
-with **-G** must be less than 146 x 146 pixels in size; for larger
-images see :doc:`psimage`. The format of Sun
-raster files is outlined in Appendix [app:B]. Note that under
-PostScript Level 1 the patterns are filled by using the polygon as a
-*clip path*. Complex clip paths may require more memory than the
-PostScript interpreter has been assigned. There is therefore the
-possibility that some PostScript interpreters (especially those
-supplied with older laserwriters) will run out of memory and abort.
-Should that occur we recommend that you use a regular gray-shade fill
-instead of the patterns. Installing more memory in your printer *may or
-may not* solve the problem!
-
-Table :ref:`fillex <tbl-fillex>` contains a few examples of fill specifications.
-
-.. _tbl-fillex:
-
-+---------------------------+-----------------------------------------------------+
-+===========================+=====================================================+
-| **-G**\ 128 | Solid gray |
-+---------------------------+-----------------------------------------------------+
-| **-G**\ 127/255/0 | Chartreuse, R/G/B-style |
-+---------------------------+-----------------------------------------------------+
-| **-G**\ #00ff00 | Green, hexadecimal RGB code |
-+---------------------------+-----------------------------------------------------+
-| **-G**\ 25-0.86-0.82 | Chocolate, h-s-v-style |
-+---------------------------+-----------------------------------------------------+
-| **-G**\ DarkOliveGreen1 | One of the named colors |
-+---------------------------+-----------------------------------------------------+
-| **-Gp**\ 300/7 | Simple diagonal hachure pattern in b/w at 300 dpi |
-+---------------------------+-----------------------------------------------------+
-| **-Gp**\ 300/7:Bred | Same, but with red lines on white |
-+---------------------------+-----------------------------------------------------+
-| **-Gp**\ 300/7:BredF- | Now the gaps between red lines are transparent |
-+---------------------------+-----------------------------------------------------+
-| **-Gp**\ 100/marble.ras | Using user image of marble as the fill at 100 dpi |
-+---------------------------+-----------------------------------------------------+
-
-Specifying Fonts
-----------------
-
-The fonts used by GMT are typically set indirectly via the
-GMT defaults parameters. However, some programs, like
-:doc:`pstext` may wish to have this
-information passed directly. A font is specified by a comma-delimited
-attribute list of *size*, *fonttype* and *fill*, each of which is
-optional. The *size* is the font size (usually in points) but **c**,
-**i** or **p** can be added to indicate a specific unit. The *fonttype*
-is the name (case sensitive!) of the font or its equivalent numerical ID
-(e.g., Helvetica-Bold or 1). *fill* specifies the gray shade, color or
-pattern of the text (see section `Specifying area fill attributes`_ above). Optionally, you may
-append **=**\ *pen* to the *fill* value in order to draw the text
-outline with the specified *pen*; if used you may optionally skip the
-filling of the text by setting *fill* to **-**. If any of the attributes
-is omitted their default or previous setting will be retained. See
-Appendix `G. PostScript fonts used by GMT`_ for a list of all fonts recognized by GMT.
-
-Stroke, Fill and Font Transparency
-----------------------------------
-
-The PostScript language has no built-in mechanism for transparency.
-However, PostScript\ extensions make it possible to request
-transparency, and tools that can render such extensions will produce
-transparency effects. We specify transparency in percent: 0 is opaque
-[Default] while 100 is fully transparent (i.e., nothing will show). As
-noted in section `Layer PDF transparency: The -t option`_, we can control transparency on a
-layer-by-layer basis using the **-t** option. However, we may also set
-transparency as an attribute of stroke or fill (including for fonts)
-settings. Here, transparency is requested by appending @\ *transparency*
-to colors or pattern fills. The transparency *mode* can be changed by
-using the GMT default parameter :ref:`PS_TRANSPARENCY <PS_TRANSPARENCY>`; the default is
-Normal but you can choose among Color, ColorBurn, ColorDodge, Darken,
-Difference, Exclusion, HardLight, Hue, Lighten, Luminosity, Multiply,
-Normal, Overlay, Saturation, SoftLight, and Screen. For more
-information, see for instance (search online for) the Adobe pdfmark
-Reference Manual. Most printers and many PostScript viewers can
-neither print nor show transparency. They will simply ignore your
-attempt to create transparency and will plot any material as opaque.
-Ghostscript and its derivatives such as GMT's
-:doc:`ps2raster` support transparency (if
-compiled with the correct build option). Note: If you use **Acrobat
-Distiller** to create a PDF file you must first change some settings to
-make transparency effective: change the parameter /AllowTransparency to
-true in your \*.joboptions file.
-
-Color palette tables
---------------------
-
-Several programs, such as those which read 2-D gridded data sets and
-create colored images or shaded reliefs, need to be told what colors to
-use and over what *z*-range each color applies. This is the purpose of
-the color palette table (CPT file). These files may also be used by
-:doc:`psxy` and
-:doc:`psxyz` to plot color-filled symbols. For
-most applications, you will simply create a CPT file using the tool
-:doc:`makecpt` which will take an existing
-color table and resample it to fit your chosen data range, or use
-:doc:`grd2cpt` to build a CPT file based on
-the data distribution in one or more given grid files. However, in some
-situations you will need to make a CPT file by hand or using text tools
-like **awk** or **perl**.
-
-Color palette tables (CPT) comes in two flavors: (1) Those designed to
-work with categorical data (e.g., data where interpolation of values is
-undefined) and (2) those designed for regular, continuously-varying
-data. In both cases the *fill* information follows the format given in
-Section `Specifying area fill attributes`_. The z-values in CPT files can
-be scaled by using the **+u**\ \|\ **U**\ *unit* mechanism. Append these
-modifiers to your CPT filenames when used in GMT commands. The **+u**\ *unit*
-modifier will scale z *from unit to* meters, while **+U**\ *unit* does
-the inverse (scale z *from meters to unit*).
-
-Categorical CPT files
-~~~~~~~~~~~~~~~~~~~~~
-
-Categorical data are information on which normal numerical operations
-are not defined. As an example, consider various land classifications
-(desert, forest, glacier, etc.) and it is clear that even if we assigned
-a numerical value to these categories (e.g., desert = 1, forest = 2,
-etc) it would be meaningless to compute average values (what would 1.5
-mean?). For such data a special format of the CPT files are provided.
-Here, each category is assigned a unique key, a color or pattern, and an
-optional label (usually the category name) marked by a leading
-semi-colon. Keys must be monotonically increasing but do not need to be
-consecutive. The format is
-
-+-----------------+--------+--------------+
-| key\ :sub:`1` | *Fill* | [;\ *label*] |
-+-----------------+--------+--------------+
-| ... | | |
-+-----------------+--------+--------------+
-| key\ :sub:`n` | *Fill* | [;\ *label*] |
-+-----------------+--------+--------------+
-
-The *Fill* information follows the format given in Section `Specifying area fill attributes`_.
-While not always applicable to categorical data, the background color
-(for *key*-values < :math:`key_1`), foreground color (for
-*key*-values > :math:`key_{n}`), and not-a-number (NaN)
-color (for *key*-values = NaN) are all defined in the :doc:`gmt.conf` file, but can be
-overridden by the statements
-
-+-----+---------------------+
-| B | Fill\ :sub:`back` |
-+-----+---------------------+
-| F | Fill\ :sub:`fore` |
-+-----+---------------------+
-| N | Fill\ :sub:`nan` |
-+-----+---------------------+
-
-Regular CPT files
-~~~~~~~~~~~~~~~~~
-
-Suitable for continuous data types and allowing for color
-interpolations, the format of the regular CPT files is:
-
-+---------------+-------------------+---------------+-------------------+----------+--------------+
-| z\ :sub:`0` | Color\ :sub:`min` | z\ :sub:`1` | Color\ :sub:`max` | [**A**] | [;\ *label*] |
-+---------------+-------------------+---------------+-------------------+----------+--------------+
-| ... |
-+---------------+-------------------+---------------+-------------------+----------+--------------+
-| z\ :sub:`n-2` | Color\ :sub:`min` | z\ :sub:`n-1` | Color\ :sub:`max` | [**A**] | [;\ *label*] |
-+---------------+-------------------+---------------+-------------------+----------+--------------+
-
-
-Thus, for each "*z*-slice", defined as the interval between two
-boundaries (e.g., :math:`z_0` to :math:`z_1`), the color can be
-constant (by letting Color\ :math:`_{max}` = Color\ :math:`_{min}` or -)
-or a continuous, linear function of *z*. If patterns are used then the
-second (max) pattern must be set to -. The optional flag **A** is used
-to indicate annotation of the color scale when plotted using
-:doc:`psscale`. The optional flag **A** may
-be **L**, **U**, or **B** to select annotation of the lower, upper, or
-both limits of the particular *z*-slice, respectively. However,
-the standard **-B** option can be used by
-:doc:`psscale` to affect annotation and
-ticking of color scales. Just as other GMT programs, the *stride* can
-be omitted to determine the annotation and tick interval automatically
-(e.g., **-Baf**). The optional semicolon followed by a text label will
-make :doc:`psscale`, when used with the
-**-L** option, place the supplied label instead of formatted *z*-values.
-
-As for categorical tables, the background color (for *z*-values
-< :math:`z_0`), foreground color (for *z*-values >
-:math:`z_{n-1}`), and not-a-number (NaN) color (for *z*-values =
-NaN) are all defined in the :doc:`gmt.conf` file, but can be overridden by the
-statements
-
-+-----+---------------------+
-| B | Fill\ :sub:`back` |
-+-----+---------------------+
-| F | Fill\ :sub:`fore` |
-+-----+---------------------+
-| N | Fill\ :sub:`nan` |
-+-----+---------------------+
-
-which can be inserted into the beginning or end of the CPT file. If you
-prefer the HSV system, set the :doc:`gmt.conf` parameter accordingly and replace red,
-green, blue with hue, saturation, value. Color palette tables that
-contain gray-shades only may replace the *r/g/b* triplets with a single
-gray-shade in the 0--255 range. For CMYK, give *c/m/y/k* values in the
-0--100 range.
-
-A few programs (i.e., those that plot polygons such as
-:doc:`grdview`, :doc:`psscale`,
-:doc:`psxy` and
-:doc:`psxyz`) can accept pattern fills instead
-of gray-shades. You must specify the pattern as in Section `Specifying area fill attributes`_
-(no leading **-G** of course), and only the first pattern (for low
-*z*) is used (we cannot interpolate between patterns). Finally,
-some programs let you skip features whose *z*-slice in the CPT
-file has gray-shades set to -. As an example, consider
-
-+-----+---------+-------------+-------+
-| 30 | p200/16 | 80 | \- |
-+-----+---------+-------------+-------+
-| 80 | \- | 100 | \- |
-+-----+---------+-------------+-------+
-| 100 | 200/0/0 | 200/255/255 | 0 |
-+-----+---------+-------------+-------+
-| 200 | yellow | 300 | green |
-+-----+---------+-------------+-------+
-
-where slice 30 < z < 80 is painted with pattern # 16 at 200 dpi,
-slice 80 < z < 100 is skipped, slice 100 < z < 200 is
-painted in a range of dark red to yellow, whereas the slice
-200 < z < 300 will linearly yield colors from yellow to green,
-depending on the actual value of *z*.
-
-Some programs like :doc:`grdimage` and
-:doc:`grdview` apply artificial illumination
-to achieve shaded relief maps. This is typically done by finding the
-directional gradient in the direction of the artificial light source and
-scaling the gradients to have approximately a normal distribution on the
-interval [-1,+1]. These intensities are used to add "white" or "black"
-to the color as defined by the *z*-values and the CPT file. An intensity
-of zero leaves the color unchanged. Higher values will brighten the
-color, lower values will darken it, all without changing the original
-hue of the color (see Appendix [app:I] for more details). The
-illumination is decoupled from the data grid file in that a separate
-grid file holding intensities in the [-1,+1] range must be provided.
-Such intensity files can be derived from the data grid using
-:doc:`grdgradient` and modified with
-:doc:`grdhisteq`, but could equally well be
-a separate data set. E.g., some side-scan sonar systems collect both
-bathymetry and backscatter intensities, and one may want to use the
-latter information to specify the illumination of the colors defined by
-the former. Similarly, one could portray magnetic anomalies superimposed
-on topography by using the former for colors and the latter for shading.
-
-The Drawing of Vectors
-----------------------
-
-GMT supports plotting vectors in various forms. A vector is one of
-many symbols that may be plotted by :doc:`psxy`
-and :doc:`psxyz`, is the main feature in
-:doc:`grdvector`, and is indirectly used by
-other programs. All vectors plotted by GMT consist of two separate
-parts: The vector line (controlled by the chosen pen attributes) and the
-optional vector head(s) (controlled by the chosen fill). We distinguish
-between three types of vectors:
-
-#. Cartesian vectors are plotted as straight lines. They can be
- specified by a start point and the direction and length (in map
- units) of the vector, or by its beginning and end point. They may
- also be specified giving the azimuth and length (in km) instead.
-
-#. Circular vectors are (as the name implies) drawn as circular arcs and
- can be used to indicate opening angles. It accepts an origin, a
- radius, and the beginning and end angles.
-
-#. Geo-vectors are drawn using great circle arcs. They are specified by
- a beginning point and the azimuth and length (in km) of the vector,
- or by its beginning and end point.
-
-.. figure:: /_images/GMT_arrows.*
- :width: 500 px
- :align: center
-
- Examples of Cartesian (left), circular (middle), and geo-vectors (right)
- for different attribute specifications. Note that both full and half
- arrow-heads can be specified, as well as no head at all.
-
-There are numerous attributes you can modify, including how the vector
-should be justified relative to the given point (beginning, center, or
-end), where heads (if any) should be placed, if the head should just be
-the left or right half, if the vector attributes should shrink for
-vectors whose length are less than a given cutoff length, and the size
-and shape of the head. These attributes are detailed further in the
-relevant manual pages.
-
-Character escape sequences
---------------------------
-
-For annotation labels or text strings plotted with
-:doc:`pstext`, GMT provides several escape
-sequences that allow the user to temporarily switch to the symbol font,
-turn on sub- or superscript, etc., within words. These conditions are
-toggled on/off by the escape sequence @\ **x**, where **x** can be one
-of several types. The escape sequences recognized in GMT are listed in
-Table :ref:`escape <tbl-escape>`. Only one level of sub- or superscript is supported.
-Note that under Windows the percent symbol indicates a batch variable,
-hence you must use two percent-signs for each one required in the escape
-sequence for font switching.
-
-.. _tbl-escape:
-
-+-------------------+----------------------------------------------------------------+
-+===================+================================================================+
-| @~ | Turns symbol font on or off |
-+-------------------+----------------------------------------------------------------+
-| @+ | Turns superscript on or off |
-+-------------------+----------------------------------------------------------------+
-| @- | Turns subscript on or off |
-+-------------------+----------------------------------------------------------------+
-| @# | Turns small caps on or off |
-+-------------------+----------------------------------------------------------------+
-| @\_ | Turns underline on or off |
-+-------------------+----------------------------------------------------------------+
-| @%\ *fontno*\ % | Switches to another font; @%% resets to previous font |
-+-------------------+----------------------------------------------------------------+
-| @:\ *size*: | Switches to another font size; @:: resets to previous size |
-+-------------------+----------------------------------------------------------------+
-| @;\ *color*; | Switches to another font color; @;; resets to previous color |
-+-------------------+----------------------------------------------------------------+
-| @! | Creates one composite character of the next two characters |
-+-------------------+----------------------------------------------------------------+
-| @@ | Prints the @ sign itself |
-+-------------------+----------------------------------------------------------------+
-
-Shorthand notation for a few special European characters has also been added:
-
-
-+----------+------------+----------+------------+
-| *Code* | *Effect* | *Code* | *Effect* |
-+==========+============+==========+============+
-| @E | Æ | @e | æ |
-+----------+------------+----------+------------+
-| @O | Ø | @o | ø |
-+----------+------------+----------+------------+
-| @A | Å | @a | å |
-+----------+------------+----------+------------+
-| @C | Ç | @c | ç |
-+----------+------------+----------+------------+
-| @N | Ñ | @n | ñ |
-+----------+------------+----------+------------+
-| @U | Ü | @u | ü |
-+----------+------------+----------+------------+
-| @s | ß | | |
-+----------+------------+----------+------------+
-
-PostScript fonts used in GMT may be re-encoded to include several
-accented characters used in many European languages. To access these,
-you must specify the full octal code \\xxx allowed for
-your choice of character encodings determined by the
-:ref:`PS_CHAR_ENCODING <PS_CHAR_ENCODING>` setting described in the
-:doc:`gmt.conf` man page. Only the special
-characters belonging to a particular encoding will be available. Many
-characters not directly available by using single octal codes may be
-constructed with the composite character mechanism @!.
-
-Some examples of escape sequences and embedded octal codes in
-GMT strings using the Standard+ encoding:
-
-| ``2@~p@~r at +2@+h at -0@- E\363tv\363s`` = 2\ :math:`\pi r^2h_0` Eötvös
-| ``10 at +-3 @Angstr at om`` = 10\ :math:`^{-3}` Ångstrøm
-| ``Se at nor Gar at con`` = Señor Garçon
-| ``M@!\305anoa stra at se`` = Manoa straße
-| ``A@\#cceleration@\# (ms at +-2@+)`` =
-
-The option in :doc:`pstext` to draw a
-rectangle surrounding the text will not work for strings with escape
-sequences. A chart of characters and their octal codes is given in
-Appendix [app:F].
-
-.. _grid-file-format:
-
-Grid file format specifications
--------------------------------
-
-GMT has the ability to read and write grids using
-more than one grid file format (see Table :ref:`grdformats <tbl-grdformats>` for supported
-format and their IDs). For reading, GMT will automatically determine
-the format of grid files, while for writing you will normally have to
-append *=ID* to the filename if you want GMT to use a different format
-than the default.
-
-By default, GMT will create new grid files using the **nf** format;
-however, this behavior can be overridden by setting the
-:ref:`IO_GRIDFILE_FORMAT <IO_GRIDFILE_FORMAT>` defaults parameter to any of the other
-recognized values (or by appending *=ID*).
-
-GMT can also read netCDF grid files produced by other software
-packages, provided the grid files satisfy the COARDS and Hadley Centre
-conventions for netCDF grids. Thus, products created under those
-conventions (provided the grid is 2-, 3-, 4-, or 5-dimensional) can be
-read directly by GMT and the netCDF grids written by GMT can be read
-by other programs that conform to those conventions. Three such programs are
-`ncview <http://meteora.ucsd.edu/~pierce/ncview_home_page.html>`_, `Panoply
-<http://www.giss.nasa.gov/tools/panoply/>`_, and `ncBrowse
-<http://www.epic.noaa.gov/java/ncBrowse/>`_ ; others can be found on the
-`netCDF website <http://www.unidata.ucar.edu/software/netcdf/software.html>`_.
-
-In addition, users with some C-programming experience may add their own
-read/write functions and link them with the GMT library to extend the
-number of predefined formats. Technical information on this topic can be
-found in the source file ``gmt_customio.c``. Users who are considering this approach
-should contact the GMT team.
-
-.. _tbl-grdformats:
-
-+----------+---------------------------------------------------------------+
-| **ID** | **Explanation** |
-+==========+===============================================================+
-| | *GMT 4 netCDF standard formats* |
-+----------+---------------------------------------------------------------+
-| nb | GMT netCDF format (8-bit integer, COARDS, CF-1.5) |
-+----------+---------------------------------------------------------------+
-| ns | GMT netCDF format (16-bit integer, COARDS, CF-1.5) |
-+----------+---------------------------------------------------------------+
-| ni | GMT netCDF format (32-bit integer, COARDS, CF-1.5) |
-+----------+---------------------------------------------------------------+
-| nf | GMT netCDF format (32-bit float, COARDS, CF-1.5) |
-+----------+---------------------------------------------------------------+
-| nd | GMT netCDF format (64-bit float, COARDS, CF-1.5) |
-+----------+---------------------------------------------------------------+
-| | *GMT 3 netCDF legacy formats* |
-+----------+---------------------------------------------------------------+
-| cb | GMT netCDF format (8-bit integer, depreciated) |
-+----------+---------------------------------------------------------------+
-| cs | GMT netCDF format (16-bit integer, depreciated) |
-+----------+---------------------------------------------------------------+
-| ci | GMT netCDF format (32-bit integer, depreciated) |
-+----------+---------------------------------------------------------------+
-| cf | GMT netCDF format (32-bit float, depreciated) |
-+----------+---------------------------------------------------------------+
-| cd | GMT netCDF format (64-bit float, depreciated) |
-+----------+---------------------------------------------------------------+
-| | *GMT native binary formats* |
-+----------+---------------------------------------------------------------+
-| bm | GMT native, C-binary format (bit-mask) |
-+----------+---------------------------------------------------------------+
-| bb | GMT native, C-binary format (8-bit integer) |
-+----------+---------------------------------------------------------------+
-| bs | GMT native, C-binary format (16-bit integer) |
-+----------+---------------------------------------------------------------+
-| bi | GMT native, C-binary format (32-bit integer) |
-+----------+---------------------------------------------------------------+
-| bf | GMT native, C-binary format (32-bit float) |
-+----------+---------------------------------------------------------------+
-| bd | GMT native, C-binary format (32-bit float) |
-+----------+---------------------------------------------------------------+
-| | *Miscellaneous grid formats* |
-+----------+---------------------------------------------------------------+
-| rb | SUN raster file format (8-bit standard) |
-+----------+---------------------------------------------------------------+
-| rf | GEODAS grid format GRD98 (NGDC) |
-+----------+---------------------------------------------------------------+
-| sf | Golden Software Surfer format 6 (32-bit float) |
-+----------+---------------------------------------------------------------+
-| sd | Golden Software Surfer format 7 (64-bit float) |
-+----------+---------------------------------------------------------------+
-| af | Atlantic Geoscience Center AGC (32-bit float) |
-+----------+---------------------------------------------------------------+
-| ei | ESRI Arc/Info ASCII Grid Interchange format (ASCII integer) |
-+----------+---------------------------------------------------------------+
-| ef | ESRI Arc/Info ASCII Grid Interchange format (ASCII float) |
-+----------+---------------------------------------------------------------+
-| gd | Import/export via GDAL [19]_ |
-+----------+---------------------------------------------------------------+
-
-Because some formats have limitations on the range of values they can
-store it is sometimes necessary to provide more than simply the name of
-the file and its ID on the command line. For instance, a native short
-integer file may use a unique value to signify an empty node or NaN, and
-the data may need translation and scaling prior to use. Therefore, all
-GMT programs that read or write grid files will decode the given
-filename as follows:
-
-name[=\ *ID*\ [/*scale*/*offset*\ [/*nan*]]]
-
-where everything in brackets is optional. If you are reading a grid then
-no options are needed: just continue to pass the name of the grid file.
-However, if you write another format you must append the =\ *ID* string,
-where *ID* is the format code listed above. In addition, should you want
-to (1) multiply the data by a scale factor, and (2) add a constant
-offset you must append the /*scale*/*offset* modifier. Finally, if you
-need to indicate that a certain data value should be interpreted as a
-NaN (not-a-number) you must append the /*nan* suffix to the scaling
-string (it cannot go by itself; note the nesting of the brackets!). The
-/*scale* and /*offset* modifiers may be left empty to select default
-values (scale = 1, offset = 0), or you may specify *a* for
-auto-adjusting the scale and/or offset of packed integer grids
-(=\ *ID*/*a* is a shorthand for =\ *ID*/*a*/*a*).
-
-Some of the grid formats allow writing to standard output and reading
-from standard input which means you can connect GMT programs that
-operate on grid files with pipes, thereby speeding up execution and
-eliminating the need for large, intermediate grid files. You specify
-standard input/output by leaving out the filename entirely. That means
-the "filename" will begin with "=\ *ID*". Note, that the netCDF format
-does not allow piping.
-
-Everything looks clearer after a few examples:
-
-* To write a native binary float grid file, specify the name as ``my_file.f4=bf`` .
-
-* To read a native short integer grid file, multiply the data by 10 and
- then add 32000, but first let values that equal 32767 be set to NaN,
- use the filename ``my_file.i2=bs/10/32000/32767``.
-
-* To read a Golden Software "surfer" format 6 grid file, just pass the
- file name, e.g., ``my_surferfile.grd``.
-
-* To read a 8-bit standard Sun raster file (with values in the 0--255
- range) and convert it to a 1 range, give the name as ``rasterfile=rb/7.84313725e-3/-1`` (i.e., 1/127.5).
-
-* To write a native binary short integer grid file to standard output
- after subtracting 32000 and dividing its values by 10, give filename
- as ``=bs/0.1/-3200``.
-
-* To write an 8-bit integer netCDF grid file with an auto-adjusted
- offset, give filename as ``=nb//a``.
-
-Programs that both read and/or write more than one grid file may specify
-different formats and/or scaling for the files involved. The only
-restriction with the embedded grid specification mechanism is that no
-grid files may actually use the "=" character as part of their name
-(presumably, a small sacrifice).
-
-One can also define special file suffixes to imply a specific file
-format; this approach represents a more intuitive and user-friendly way
-to specify the various file formats. The user may create a file called
-``gmt.io`` in the current directory or home directory, or in the directory
-``~/.gmt`` and define any number of custom formats. The following is an example of
-a ``gmt.io`` file:
-
-+---------------------------------------------------------------------------+
-| # suffix format_id scale offset NaNxxxComments # GMT i/o shorthand file |
-| # It can have any number of comment lines like this one anywhere |
-| # suffix format\_id scale offset NaNComments |
-+-------+-----+-----+---+-------+-------------------------------------------+
-| grd | nf | \- | \-| \- | Default format |
-+-------+-----+-----+---+-------+-------------------------------------------+
-| b | bf | \- | \-| \- | Native binary floats |
-+-------+-----+-----+---+-------+-------------------------------------------+
-| i2 | bs | \- | \-| 32767 | 2-byte integers with NaN value |
-+-------+-----+-----+---+-------+-------------------------------------------+
-| ras | rb | \- | \-| \- | Sun raster files |
-+-------+-----+-----+---+-------+-------------------------------------------+
-| byte | bb | \- | \-| 255 | Native binary 1-byte grids |
-+-------+-----+-----+---+-------+-------------------------------------------+
-| bit | bm | \- | \-| \- | Native binary 0 or 1 grids |
-+-------+-----+-----+---+-------+-------------------------------------------+
-| mask | bm | \- | \-| 0 | Native binary 1 or NaN masks |
-+-------+-----+-----+---+-------+-------------------------------------------+
-| faa | bs | 0.1 | \-| 32767 | Native binary gravity in 0.1 mGal |
-+-------+-----+-----+---+-------+-------------------------------------------+
-| ns | ns | a | a | \- | 16-bit integer netCDF grid with |
-| | | | | | auto-scale and auto-offset |
-+-------+-----+-----+---+-------+-------------------------------------------+
-
-These suffices can be anything that makes sense to the user. To activate
-this mechanism, set parameter :ref:`IO_GRIDFILE_SHORTHAND <IO_GRIDFILE_SHORTHAND>` to TRUE in
-your :doc:`gmt.conf` file. Then, using the filename ``stuff.i2`` is equivalent to saying ``stuff.i2=bs///32767``, and the
-filename ``wet.mask`` means wet.mask=bm/1/0/0. For a file intended for masking, i.e.,
-the nodes are either 1 or NaN, the bit or mask format file may be as
-small as 1/32 the size of the corresponding grid float format file.
-
-Modifiers for changing the grid coordinates
--------------------------------------------
-
-A few GMT tools require that the two horizontal dimensions be
-specified in meters. One example is
-:doc:`grdfft` which must compute the 2-D
-Fourier transform of a grid and evaluate wavenumbers in the proper units
-(1/meter). There are two situations where the user may need to change
-the coordinates of the grid passed to such programs:
-
-- You have a geographic grid (i.e., in longitude and latitude). Simply
- supply the **-fg** option and your grid coordinates will
- automatically be converted to meters via a "Flat Earth" approximation
- on the currently selected ellipsoid (Note: this is only possible in
- those few programs that require this capability. In general, **-fg**
- is used to specify table coordinates).
-
-- You have a Cartesian grid but the units are not meters (e.g., they
- may perhaps be in km or miles). In this case you may append the file
- modifier **+u**\ *unit*, where *unit* is one of non-arc units listed
- in Table :ref:`distunits <tbl-distunits>`. For example, reading in the grid (which has
- distance units of km) and converting them to meters is done by
- specifying the filename as *filename*\ **+u**\ k. On output, any derived grids will revert
- to their original units *unless* you specify another unit modifier to
- the output grid. This may be used, for instance, to save the original
- grid with distances in meters using some other unit.
-
-For convenience, we also support the inverse translation, i.e.,
-**+U**\ *unit*. This modifier can be used to convert your grid
-coordinates *from* meters *to* the specified unit. Example 28 shows a
-case where this is being used to change an UTM grid in meters to km.
-These modifiers are only allowed when map projections are not selected
-(or are Cartesian).
-
-Modifiers for COARDS-compliant netCDF files
--------------------------------------------
-
-When the netCDF grid file contains more than one 2-dimensional variable,
-GMT programs will load the first such variable in the file and ignore
-all others. Alternatively, the user can select the required variable by
-adding the suffix "?\ *varname*" to the grid file name. For example, to
-get information on the variable "slp" in file , use:
-
- ::
-
- gmt grdinfo "file.nc?slp"
-
-Since COARDS-compliant netCDF files are the default, the additional
-suffix "=nf" can be omitted.
-
-In case the named grid is 3-dimensional, GMT will load the first
-(bottom) layer. If another layer is required, either add "[*index*]"
-or "(*level*)", where *index* is the index of the third (depth) variable
-(starting at 0 for the first layer) and *level* is the numerical value
-of the third (depth) variable associated with the requested layer. To
-indicate the second layer of the 3-D variable "slp" use as file name: ``file.nc?slp[1]``.
-
-When you supply the numerical value for the third variable using
-"(*level*)", GMT will pick the layer closest to that value. No
-interpolation is performed.
-
-Note that the question mark, brackets and parentheses have special
-meanings on Unix-based platforms. Therefore, you will need to either
-*escape* these characters, by placing a backslash in front of them, or
-place the whole file name plus modifiers between single quotes or double
-quotes.
-
-A similar approach is followed for loading 4-dimensional grids. Consider
-a 4-dimensional grid with the following variables:
-
- ::
-
- lat(lat): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9
- lon(lon): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9
- depth(depth): 0, 10, 20, 30, 40, 50, 60, 70, 80, 90
- time(time): 0, 12, 24, 36, 48
- pressure(time,depth,lat,lon): (5000 values)
-
-To get information on the 10x10 grid of pressure at
-depth 10 and at time 24, one would use:
-
- ::
-
- gmt grdinfo "file.nc?pressure[2,1]"
-
-or (only in case the coordinates increase linearly):
-
- ::
-
- gmt grdinfo "file.nc?pressure(24,10)"
-
-Programs that generally deal with columns of one-dimensional data, like
-or can use multi-dimensional netCDF files in a very similar way. If a
-variable in a netCDF file is one-dimensional, there is nothing more
-needed than name the variables on the command line. For example:
-
- ::
-
- gmt psxy "file.nc?lon/lat" ...
- gmt gmtconvert "file.nc?time/lat/lon"
-
-If one or more of the selected variables are two-dimensional, and have
-the same leading dimension as the other selected variables they will be
-plotted in their entirety. For example, if a netCDF files contains 6
-time steps recording temperature at 4 points, and the variable ``temp`` is a 6 by
-4 array, then the command ``gmtconvert "file.nc?time/temp"`` can result in:
-
- ::
-
- 2012-06-25T00:00:00 20.1 20.2 20.1 20.3
- 2012-06-25T12:00:00 24.2 23.2 24.5 23.5
- 2012-06-26T00:00:00 16.1 16.2 16.1 16.3
- 2012-06-26T12:00:00 22.1 23.0 23.9 23.5
- 2012-06-27T00:00:00 17.5 16.9 17.2 16.8
- 2012-06-27T12:00:00 27.2 27.2 27.5 27.5
-
-If, for example, only the second temperature column is needed, use
-``gmt gmtconvert "file.nc?time/temp[1]"`` (indices start counting at 0).
-
-The COARDS conventions set restrictions on the names that can be used
-for the units of the variables and coordinates. For example, the units
-of longitude and latitude are "degrees_east" and "degrees_north",
-respectively. Here is an example of the header of a COARDS compliant
-netCDF file (to be obtained using **ncdump**):
-
- ::
-
- netcdf M2_fes2004 {
- dimensions:
- lon = 2881 ;
- lat = 1441 ;
- variables:
- float lon(lon) ;
- lon:long_name = "longitude" ;
- lon:units = "degrees_east" ;
- lon:actual_range = 0., 360. ;
- float lat(lat) ;
- lat:long_name = "latitude" ;
- lat:units = "degrees_north" ;
- lat:actual_range = -90., 90. ;
- short amp(lat, lon) ;
- amp:long_name = "amplitude" ;
- amp:unit = "m" ;
- amp:scale_factor = 0.0001 ;
- amp:add_offset = 3. ;
- amp:_FillValue = -32768s ;
- short pha(lat, lon) ;
- pha:long_name = "phase" ;
- pha:unit = "degrees" ;
- pha:scale_factor = 0.01 ;
- pha:_FillValue = -32768s ;
-
-This file contains two grids, which can be plotted separately using the
-names ``M2_fes2004.nc?amp`` and ``M2_fes2004.nc?pha``. The attributes ``long_name`` and ``unit`` for each variable
-are combined in GMT to a single unit string. For example, after
-reading the grid ``y_unit`` equals ``latitude [degrees_north]``. The
-same method can be used in reverse to set the proper variable names and
-units when writing a grid. However, when the coordinates are set
-properly as geographical or time axes, GMT will take care of this. The
-user is, however, still responsible for setting the variable name and
-unit of the z-coordinate. The default is simply "z".
-
-Modifiers to read and write grids and images via GDAL
------------------------------------------------------
-
-If the support has been configured during installation, then GMT can
-read and write a variety of grid and image formats via GDAL. This
-extends the capability of GMT to handle data sets from a variety of
-sources.
-
-Reading multi-band images
-~~~~~~~~~~~~~~~~~~~~~~~~~
-
-:doc:`grdimage` and :doc:`psimage` both lets the user select
-individual bands in a multi-band image file and treats the result as an
-image (that is the values, in the 0--255 range, are treated as colors,
-not data). To select individual bands you use the **+b**\ *band-number*
-mechanism that must be appended to the image filename. Here,
-*band-number* can be the number of one individual band (the counting
-starts at zero), or it could be a comma-separated list of bands. For example
-
- ::
-
- gmt psimage jpeg_image_with_three_bands.jpg+b0
-
-will plot only the first band (i.e., the red band) of the jpeg image as
-a gray-scale image, and
-
- ::
-
- gmt psimage jpeg_image_with_three_bands.jpg+b2,1,0
-
-will plot the same image in color but where the RGB band order has been reversed.
-
-Instead of treating them as images, all other GMT programs that
-process grids can read individual bands from an image but will consider
-the values to be regular data. For example, let ``multiband`` be the name of a
-multi-band file with a near infrared component in band 4 and red in band
-3. We will compute the NDVI (Normalized Difference Vegetation Index),
-which is defined as NDVI = (NIR - R) / (NIR + R), as
-
- ::
-
- gmt grdmath multiband=gd+b3 multiband=gd+b2 SUB multiband=gd+b3 \
- multiband=gd+b2 ADD DIV = ndvi.nc
-
-The resulting grid ``ndvi.nc`` can then be plotted as usual.
-
-Reading more complex multi-band IMAGES or GRIDS
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-It is also possible to access to sub-datasets in a multi-band grid. The
-next example shows how we can extract the SST from the MODIS file ``A20030012003365.L3m_YR_NSST_9``
-that is stored in the HDF "format". We need to run the GDAL program
-**gdalinfo** on the file because we first
-must extract the necessary metadata from the file:
-
- ::
-
- gdalinfo A20030012003365.L3m_YR_NSST_9
- Driver: HDF4/Hierarchical Data Format Release 4
- Files: A20030012003365.L3m_YR_NSST_9
- Size is 512, 512
- Coordinate System is `'
- Metadata:
- Product Name=A20030012003365.L3m_YR_NSST_9
- Sensor Name=MODISA
- Sensor=
- Title=MODISA Level-3 Standard Mapped Image
- ...
- Scaling=linear
- Scaling Equation=(Slope*l3m_data) + Intercept = Parameter value
- Slope=0.000717185
- Intercept=-2
- Scaled Data Minimum=-2
- Scaled Data Maximum=45
- Data Minimum=-1.999999
- Data Maximum=34.76
- Subdatasets:
- SUBDATASET_1_NAME=HDF4_SDS:UNKNOWN:"A20030012003365.L3m_YR_NSST_9":0
- SUBDATASET_1_DESC=[2160x4320] l3m_data (16-bit unsigned integer)
- SUBDATASET_2_NAME=HDF4_SDS:UNKNOWN:"A20030012003365.L3m_YR_NSST_9":1
- SUBDATASET_2_DESC=[2160x4320] l3m_qual (8-bit unsigned integer)
-
-Now, to access this file with GMT we need to use the =gd mechanism and
-append the name of the sub-dataset that we want to extract. Here, a
-simple example using :doc:`grdinfo` would be
-
- ::
-
- grdinfo A20030012003365.L3m_YR_NSST_9=gd?HDF4_SDS:UNKNOWN:"A20030012003365.L3m_YR_NSST_9:0"
-
- HDF4_SDS:UNKNOWN:A20030012003365.L3m_YR_NSST_9:0: Title: Grid imported via GDAL
- HDF4_SDS:UNKNOWN:A20030012003365.L3m_YR_NSST_9:0: Command:
- HDF4_SDS:UNKNOWN:A20030012003365.L3m_YR_NSST_9:0: Remark:
- HDF4_SDS:UNKNOWN:A20030012003365.L3m_YR_NSST_9:0: Gridline node registration used
- HDF4_SDS:UNKNOWN:A20030012003365.L3m_YR_NSST_9:0: Grid file format: gd = Import through GDAL (convert to float)
- HDF4_SDS:UNKNOWN:A20030012003365.L3m_YR_NSST_9:0: x_min: 0.5 x_max: 4319.5 x_inc: 1 name: x nx: 4320
- HDF4_SDS:UNKNOWN:A20030012003365.L3m_YR_NSST_9:0: y_min: 0.5 y_max: 2159.5 y_inc: 1 name: y ny: 2160
- HDF4_SDS:UNKNOWN:A20030012003365.L3m_YR_NSST_9:0: z_min: 0 z_max: 65535 name: z
- HDF4_SDS:UNKNOWN:A20030012003365.L3m_YR_NSST_9:0: scale_factor: 1 add_offset: 0
-
-Be warned, however, that things are not yet completed because while the
-data are scaled according to the equation printed above ("Scaling
-Equation=(Slope\*l3m_data) + Intercept = Parameter value"), this
-scaling is not applied by GDAL on reading so it cannot be done
-automatically by GMT. One solution is to do the reading and scaling
-via :doc:`grdmath` first, i.e.,
-
- ::
-
- gmt grdmath A20030012003365.L3m_YR_NSST_9=gd?HDF4_SDS:UNKNOWN:"A20030012003365.L3m_YR_NSST_9:0" \
- 0.000717185 MUL -2 ADD = sst.nc
-
-then plot the ``sst.nc`` directly.
-
-Writing grids and images
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-Saving images in the common raster formats is possible but, for the time
-being, only from :doc:`grdimage` and even
-that is restricted to raster type information. That is, vector data (for
-instance, coast lines) or text will not be saved. To save an image with
-:doc:`grdimage` use the
-**-A**\ *outimg=driver* mechanism, where *driver* is the driver code
-name used by GDAL (e.g. GTiff).
-
-For all other programs that create grids, it is also possible to save
-them using GDAL. To do it one need to use the =gd appended with the
-necessary information regarding the driver and the data type to use.
-Generically, =\ **gd**\ [/*scale*/*offset*\ [/*nan*][:<*driver*\ >[/\ *dataType*]]
-where *driver* is the same as explained above and *dataType* is a 2 or 3
-chars code from: u8\|u16\|i16\|u32\|i32\|float32, and where i\|u denotes
-signed\|unsigned. If not provided the default type is float32. Both
-driver names and data types are case insensitive. Note, that you have to
-specify *nan* for integer types unless you whish that all NaN data values
-are replaced by zero.
-
-The NaN data value
-------------------
-
-For a variety of data processing and plotting tasks there is a need to
-acknowledge that a data point is missing or unassigned. In the "old
-days" such information was passed by letting a value like -9999.99 take
-on the special meaning of "this is not really a value, it is missing".
-The problem with this scheme is that -9999.99 (or any other floating
-point value) may be a perfectly reasonable data value and in such a
-scenario would be skipped. The solution adopted in GMT is to use the
-IEEE concept Not-a-Number (NaN) for this purpose. Mathematically, a NaN
-is what you get if you do an undefined mathematical operation like
-0/0; in ASCII data files they appear as the textstring NaN. This
-value is internally stored with a particular bit pattern defined by IEEE
-so that special action can be taken when it is encountered by programs.
-In particular, a standard library function called ``isnan`` is used to
-test if a floating point is a NaN. GMT uses these tests extensively to
-determine if a value is suitable for plotting or processing (if a NaN is
-used in a calculation the result would become NaN as well). Data points
-whose values equal NaN are not normally plotted (or plotted with the
-special NaN color given in :doc:`gmt.conf`). Several tools such as
-:doc:`xyz2grd`, :doc:`gmtmath`, and
-:doc:`grdmath` can convert user data to NaN
-and vice versa, thus facilitating arbitrary masking and clipping of data
-sets. Note that a few computers do not have native IEEE hardware
-support. At this point, this applies to some of the older Cray
-super-computers. Users on such machines may have to adopt the old
-'-9999.99' scheme to achieve the desired results.
-
-Data records that contain NaN values for the *x* or *y* columns (or the
-*z* column for cases when 3-D Cartesian data are expected) are usually
-skipped during reading. However, the presence of these bad records can
-be interpreted in two different ways, and this behavior is controlled by
-the :ref:`IO_NAN_RECORDS <IO_NAN_RECORDS>` defaults parameter. The default setting (*gap*)
-considers such records to indicate a gap in an otherwise continuous
-series of points (e.g., a line), and programs can act upon this
-information, e.g., not to draw a line across the gap or to break the
-line into separate segments. The alternative setting (*bad*) makes no
-such interpretation and simply reports back how many bad records were
-skipped during reading; see Section `Data gap detection: The -g option`_ for details.
-
-.. _Directory parameters:
-
-Directory parameters
---------------------
-
-GMT versions prior to GMT 5 relied solely on several environment variables
-($GMT_SHAREDIR, $GMT_DATADIR, $GMT_USERDIR, and $GMT_TMPDIR), pointing
-to folders with data files and program settings. Beginning with version
-5, some of these locations are now (also or exclusively) configurable
-with the :doc:`gmtset` utility.
-When an environment variable has an equivalent parameter in the :doc:`gmt.conf` file,
-then the parameter setting will take precedence over the environment variable.
-
-Variable $GMT_SHAREDIR
- was sometimes required in previous GMT versions to locate the GMT
- share directory where all run-time support files such as coastlines,
- custom symbols, PostScript macros, color tables, and much more reside.
- If this parameter is not set (default), GMT will make a reasonable
- guess of the location of its share folder. Setting this variable is
- usually not required and recommended only under special circumstances.
-
-Variable $GMT_DATADIR and parameter DIR_DATA
- may point to one or more directories where large and/or widely used
- data files can be placed. All GMT programs look in these directories
- when a file is specified on the command line and it is not present in
- the current directory. This allows maintainers to consolidate large
- data files and to simplify scripting that use these files since the
- absolute path need not be specified. Separate multiple directories
- with colons (:) -- under Windows use semi-colons (;). Any directory
- name that ends in a trailing slash (/) will be searched recursively
- (not under Windows).
-
-Variable $GMT_USERDIR
- may point to a directory where the user places custom configuration
- files (e.g., an alternate ``coastline.conf`` file, preferred default
- settings in ``gmt.conf``, custom symbols and color palettes, math
- macros for :doc:`gmtmath` and :doc:`grdmath`, and shorthands for
- gridfile extensions via ``gmt_io``). When $GMT_USERDIR is not defined,
- then the default value $HOME/.gmt will be assumed. Users may also place their own
- data files in this directory as GMT programs will search for files
- given on the command line in both DIR_DATA and $GMT_USERDIR.
-
-Variable $GMT_TMPDIR
- may indicate the location, where GMT will write its state parameters
- via the two files ``gmt.history`` and ``gmt.conf``. If $GMT_TMPDIR is not
- set, these files are written to the current directory. See Section
- `Isolation mode`_ for more information.
-
-Parameter DIR_DCW
- specifies where to look for the optional Digital Charts of the World
- database (for country coloring or selections).
-
-Parameter DIR_GSHHG
- specifies where to look for the required
- Global Self-consistent Hierarchical High-resolution Geography database.
-
-
-Note that files whose full path is given will never be searched for in
-any of these directories.
-
-
-GMT Coordinate Transformations
-==============================
-
-GMT programs read real-world coordinates and convert them to positions
-on a plot. This is achieved by selecting one of several coordinate
-transformations or projections. We distinguish between three sets of
-such conversions:
-
-- Cartesian coordinate transformations
-
-- Polar coordinate transformations
-
-- Map coordinate transformations
-
-The next chapter will be dedicated to GMT map projections in its
-entirety. Meanwhile, the present chapter will summarize the properties
-of the Cartesian and Polar coordinate transformations available in
-GMT, list which parameters define them, and demonstrate how they are
-used to create simple plot axes. We will mostly be using
-:doc:`psbasemap` (and occasionally
-:doc:`psxy`) to demonstrate the various
-transformations. Our illustrations may differ from those you reproduce
-with the same commands because of different settings in our ``gmt.conf`` file.)
-Finally, note that while we will specify dimensions in inches (by
-appending **i**), you may want to use cm (**c**), or points (**p**) as
-unit instead (see the :doc:`gmt.conf` man page).
-
-Cartesian transformations
--------------------------
-
-GMT Cartesian coordinate transformations come in three flavors:
-
-- Linear coordinate transformation
-
-- Log\ :math:`_{10}` coordinate transformation
-
-- Power (exponential) coordinate transformation
-
-These transformations convert input coordinates *(x,y)* to
-locations *(x', y')* on a plot. There is no coupling between
-*x* and *y* (i.e., *x' = f(x)* and *y' = f(y)*);
-it is a **one-dimensional** projection. Hence, we may use separate
-transformations for the *x*- and *y*-axes (and
-*z*-axes for 3-D plots). Below, we will use the expression
-*u' = f(u)*, where *u* is either *x* or *y* (or
-*z* for 3-D plots). The coefficients in *f(u)* depend on the
-desired plot size (or scale), the chosen *(x,y)* domain, and the
-nature of *f* itself.
-
-Two subsets of linear will be discussed separately; these are a polar
-(cylindrical) projection and a linear projection applied to geographic
-coordinates (with a 360º periodicity in the *x*-coordinate). We
-will show examples of all of these projections using dummy data sets
-created with :doc:`gmtmath`, a "Reverse
-Polish Notation" (RPN) calculator that operates on or creates table data:
-
- ::
-
- gmt gmtmath -T0/100/1 T SQRT = sqrt.d
- gmt gmtmath -T0/100/10 T SQRT = sqrt.d10
-
-Cartesian linear transformation (**-Jx** **-JX**)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-There are in fact three different uses of the Cartesian linear
-transformation, each associated with specific command line options. The
-different manifestations result from specific properties of three kinds
-of data:
-
-#. Regular floating point coordinates
-
-#. Geographic coordinates
-
-#. Calendar time coordinates
-
- Examples of Cartesian (left), circular (middle), and geo-vectors (right) for different
- attribute specifications. Note that both full and half arrow-heads can be specified, as well as no head at all.
-
-Regular floating point coordinates
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Selection of the Cartesian linear transformation with regular floating
-point coordinates will result in a simple linear scaling
-*u' = au + b* of the input coordinates. The projection is defined
-by stating scale in inches/unit (**-Jx**) or axis length in inches (**-JX**).
-If the *y*-scale or *y*-axis length is different from that of the
-*x*-axis (which is most often the case), separate the two scales (or
-lengths) by a slash, e.g., **-Jx**\ 0.1i/0.5i or **-JX**\ 8i/5i. Thus,
-our :math:`y = \sqrt{x}` data sets will plot as shown in
-Figure :ref:`Linear transformation of Cartesian coordinates <GMT_linear>`.
-
-.. _GMT_linear:
-
-.. figure:: /_images/GMT_linear.*
- :width: 400 px
- :align: center
-
- Linear transformation of Cartesian coordinates.
-
-
-The complete commands given to produce this plot were
-
- ::
-
- gmt psxy -R0/100/0/10 -JX3i/1.5i -Bag -BWSne+gsnow -Wthick,blue,- -P -K sqrt.d > GMT_linear.ps
- gmt psxy -R -J -St0.1i -N -Gred -Wfaint -O sqrt.d10 >> GMT_linear.ps
-
-Normally, the user's *x*-values will increase to the right and the
-*y*-values will increase upwards. It should be noted that in many
-situations it is desirable to have the direction of positive coordinates
-be reversed. For example, when plotting depth on the *y*-axis it makes
-more sense to have the positive direction downwards. All that is
-required to reverse the sense of positive direction is to supply a
-negative scale (or axis length). Finally, sometimes it is convenient to
-specify the width (or height) of a map and let the other dimension be
-computed based on the implied scale and the range of the other axis. To
-do this, simply specify the length to be recomputed as 0.
-
-Geographic coordinates
-^^^^^^^^^^^^^^^^^^^^^^
-
-.. _GMT_linear_d:
-
-.. figure:: /_images/GMT_linear_d.*
- :width: 500 px
- :align: center
-
- Linear transformation of map coordinates.
-
-
-While the Cartesian linear projection is primarily designed for regular
-floating point *x*,\ *y* data, it is sometimes necessary to plot
-geographical data in a linear projection. This poses a problem since
-longitudes have a 360º periodicity. GMT therefore needs to be informed
-that it has been given geographical coordinates even though a linear
-transformation has been chosen. We do so by adding a **g** (for
-geographical) or **d** (for degrees) directly after **-R** or by
-appending a **g** or **d** to the end of the **-Jx** (or **-JX**)
-option. As an example, we want to plot a crude world map centered on
-125ºE. Our command will be
-
- ::
-
- gmt set MAP_GRID_CROSS_SIZE_PRIMARY 0.1i MAP_FRAME_TYPE FANCY FORMAT_GEO_MAP ddd:mm:ssF
- gmt pscoast -Rg-55/305/-90/90 -Jx0.014i -Bagf -BWSen -Dc -A1000 -Glightbrown -Wthinnest \
- -P -Slightblue > GMT_linear_d.ps
-
-with the result reproduced in
-Figure :ref:`Linear transformation of map coordinates <GMT_Linear_d>`.
-
-Calendar time coordinates
-^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. _GMT_linear_cal:
-
-.. figure:: /_images/GMT_linear_cal.*
- :width: 400 px
- :align: center
-
- Linear transformation of calendar coordinates.
-
-
-Several particular issues arise when we seek to make linear plots using
-calendar date/time as the input coordinates. As far as setting up the
-coordinate transformation we must indicate whether our input data have
-absolute time coordinates or relative time coordinates. For the former
-we append **T** after the axis scale (or width), while for the latter we
-append **t** at the end of the **-Jx** (or **-JX**) option. However,
-other command line arguments (like the **-R** option) may already
-specify whether the time coordinate is absolute or relative. An absolute
-time entry must be given as [*date*\ ]\ **T**\ [*clock*\ ] (with *date*
-given as *yyyy*\ [-*mm*\ [-*dd*]], *yyyy*\ [-*jjj*], or
-*yyyy*\ [-**W**\ *ww*\ [-*d*]], and *clock* using the
-*hh*\ [:*mm*\ [:*ss*\ [*.xxx*]]] 24-hour clock format) whereas the
-relative time is simply given as the units of time since the epoch
-followed by **t** (see :ref:`TIME_UNIT <TIME_UNIT>` and :ref:`TIME_EPOCH <TIME_EPOCH>` for
-information on specifying the time unit and the epoch). As a simple
-example, we will make a plot of a school week calendar
-(Figure :ref:`Linear transformation of calendar coordinates <GMT_linear_cal>`).
-
-When the coordinate ranges provided by the **-R** option and the
-projection type given by **-JX** (including the optional **d**, **g**,
-**t** or **T**) conflict, GMT will warn the users about it. In
-general, the options provided with **-JX** will prevail.
-
- ::
-
- gmt set FORMAT_DATE_MAP o TIME_WEEK_START Sunday FORMAT_CLOCK_MAP=-hham \
- FORMAT_TIME_PRIMARY_MAP full
- gmt psbasemap -R2001-9-24T/2001-9-29T/T07:0/T15:0 -JX4i/-2i -Bxa1Kf1kg1d \
- -Bya1Hg1h -BWsNe+glightyellow -P > GMT_linear_cal.ps
-
-Cartesian logarithmic projection
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. _GMT_log:
-
-.. figure:: /_images/GMT_log.*
- :width: 400 px
- :align: center
-
- Logarithmic transformation of x--coordinates.
-
-
-The :math:`\log_{10}` transformation is simply
-:math:`u' = a \log_{10}(u) + b` and is selected by appending an **l**
-(lower case L) immediately following the scale (or axis length) value.
-Hence, to produce a plot in which the *x*-axis is logarithmic (the
-*y*-axis remains linear, i.e., a semi-log plot), try (Figure :ref:`Logarithmic
-transformation <GMT_log>`)
-
- ::
-
- gmt psxy -R1/100/0/10 -Jx1.5il/0.15i -Bx2g3 -Bya2f1g2 -BWSne+gbisque \
- -Wthick,blue,- -P -K -h sqrt.d > GMT_log.ps
- gmt psxy -R -J -Ss0.1i -N -Gred -W -O -h sqrt.d10 >> GMT_log.ps
-
-Note that if *x*- and *y*-scaling are different and a
-:math:`\log_{10}-\log_{10}` plot is desired, the **l** must be
-appended twice: Once after the *x*-scale (before the /) and once after
-the *y*-scale.
-
-Cartesian power projection :ref:`... <-Jx_full>`
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. _GMT_pow:
-
-.. figure:: /_images/GMT_pow.*
- :width: 400 px
- :align: center
-
- Exponential or power transformation of x--coordinates.
-
-
-This projection uses :math:`u' = a u^b + c` and allows us to explore
-exponential relationships like :math:`x^p` versus :math:`y^q`.
-While *p* and *q* can be any values, we will select *p
-= 0.5* and *q = 1* which means we will plot *x* versus
-:math:`\sqrt{x}`. We indicate this scaling by appending a **p** (lower
-case P) followed by the desired exponent, in our case 0.5. Since
-*q = 1* we do not need to specify **p**\ 1 since it is identical
-to the linear transformation. Thus our command becomes (Figure :ref:`Power
-transformation <GMT_pow>`)
-
- ::
-
- gmt psxy -R0/100/0/10 -Jx0.3ip0.5/0.15i -Bxa1p -Bya2f1 -BWSne+givory \
- -Wthick -P -K sqrt.d > GMT_pow.ps
- gmt psxy -R -J -Sc0.075i -Ggreen -W -O sqrt.d10 >> GMT_pow.ps
-
-Linear projection with polar coordinates (**-Jp** **-JP**) :ref:`... <-Jp_full>`
---------------------------------------------------------------------------------
-
-.. _GMT_polar:
-
-.. figure:: /_images/GMT_polar.*
- :width: 400 px
- :align: center
-
- Polar (Cylindrical) transformation of (:math:`\theta, r`) coordinates.
-
-
-This transformation converts polar coordinates (angle :math:`\theta` and
-radius *r*) to positions on a plot. Now :math:`x' = f(\theta,r)`
-and :math:`y' = g(\theta,r)`, hence it is similar to a regular map
-projection because *x* and *y* are coupled and *x*
-(i.e., :math:`\theta`) has a 360º periodicity. With input and output
-points both in the plane it is a **two-dimensional** projection. The
-transformation comes in two flavors:
-
-#. Normally, :math:`\theta` is understood to be directions
- counter-clockwise from the horizontal axis, but we may choose to
- specify an angular offset [whose default value is zero]. We will call
- this offset :math:`\theta_0`. Then,
- :math:`x' = f(\theta, r) = ar \cos (\theta-\theta_0) + b` and
- :math:`y' = g(\theta, r) = ar \sin (\theta-\theta_0) + c`.
-
-#. Alternatively, :math:`\theta` can be interpreted to be azimuths
- clockwise from the vertical axis, yet we may again choose to specify
- the angular offset [whose default value is zero]. Then,
- :math:`x' = f(\theta, r) = ar \cos (90 - (\theta-\theta_0)) + b` and
- :math:`y' = g(\theta, r) = ar \sin (90 - (\theta-\theta_0)) + c`.
-
-Consequently, the polar transformation is defined by providing
-
-- scale in inches/unit (**-Jp**) or full width of plot in inches (**-JP**)
-
-- Optionally, insert **a** after **p\ \| \ P** to indicate CW
- azimuths rather than CCW directions
-
-- Optionally, append /\ *origin* in degrees to indicate an angular offset [0]
-
-- Optionally, append **r** to reverse the radial direction (here,
- *south* and *north* must be elevations in 0--90 range).
-
-- Optionally, append **z** to annotate depths rather than radius.
-
-As an example of this projection we will create a gridded data set in
-polar coordinates :math:`z(\theta, r) = r^2 \cdot \cos{4\theta}` using
-:doc:`grdmath`, a RPN calculator that
-operates on or creates grid files.
-
- ::
-
- gmt grdmath -R0/360/2/4 -I6/0.1 X 4 MUL PI MUL 180 DIV COS Y 2 POW MUL = tt.nc
- gmt grdcontour tt.nc -JP3i -B30 -BNs+ghoneydew -P -C2 -S4 --FORMAT_GEO_MAP=+ddd > GMT_polar.ps
-
-We used :doc:`grdcontour` to make a
-contour map of this data. Because the data file only contains values
-with :math:`2 \leq r \leq 4`, a donut shaped plot appears in
-Figure :ref:`Polar transformation <GMT_polar>`.
-
-GMT Map Projections
-===================
-
-GMT implements more than 30 different projections. They all project
-the input coordinates longitude and latitude to positions on a map. In
-general, *x' = f(x,y,z)* and *y' = g(x,y,z)*, where
-*z* is implicitly given as the radial vector length to the
-*(x,y)* point on the chosen ellipsoid. The functions *f* and
-*g* can be quite nasty and we will refrain from presenting details
-in this document. The interested read is referred to *Snyder*
-[1987] [20]_. We will mostly be using the
-:doc:`pscoast` command to demonstrate each of
-the projections. GMT map projections are grouped into four categories
-depending on the nature of the projection. The groups are
-
-#. Conic map projections
-
-#. Azimuthal map projections
-
-#. Cylindrical map projections
-
-#. Miscellaneous projections
-
-Because *x* and *y* are coupled we can only specify one
-plot-dimensional scale, typically a map *scale* (for lower-case map
-projection code) or a map *width* (for upper-case map projection code).
-However, in some cases it would be more practical to specify map
-*height* instead of *width*, while in other situations it would be nice
-to set either the *shortest* or *longest* map dimension. Users may
-select these alternatives by appending a character code to their map
-dimension. To specify map *height*, append **h** to the given dimension;
-to select the minimum map dimension, append **-**, whereas you may
-append **+** to select the maximum map dimension. Without the modifier
-the map width is selected by default.
-
-In GMT version 4.3.0 we noticed we ran out of the alphabet for
-1-letter (and sometimes 2-letter) projection codes. To allow more
-flexibility, and to make it easier to remember the codes, we implemented
-the option to use the abbreviations used by the **Proj4** mapping
-package. Since some of the GMT projections are not in **Proj4**, we
-invented some of our own as well. For a full list of both the old 1- and
-2-letter codes, as well as the **Proj4**-equivalents see the quick
-reference cards in Section `GMT quick reference`_. For example, **-JM**\ 15c and
-**-JMerc**\ /15c have the same meaning.
-
-Conic projections
------------------
-
-Albers conic equal-area projection (**-Jb** **-JB**) :ref:`... <-Jb_full>`
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-This projection, developed by Albers in 1805, is predominantly used to
-map regions of large east-west extent, in particular the United States.
-It is a conic, equal-area projection, in which parallels are unequally
-spaced arcs of concentric circles, more closely spaced at the north and
-south edges of the map. Meridians, on the other hand, are equally spaced
-radii about a common center, and cut the parallels at right angles.
-Distortion in scale and shape vanishes along the two standard parallels.
-Between them, the scale along parallels is too small; beyond them it is
-too large. The opposite is true for the scale along meridians. To define
-the projection in GMT you need to provide the following information:
-
-- Longitude and latitude of the projection center.
-
-- Two standard parallels.
-
-- Map scale in inch/degree or 1:xxxxx notation (**-Jb**), or map width (**-JB**).
-
-Note that you must include the "1:" if you choose to specify the scale
-that way. E.g., you can say 0.5 which means 0.5 inch/degree or 1:200000
-which means 1 inch on the map equals 200,000 inches along the standard
-parallels. The projection center defines the origin of the rectangular
-map coordinates. As an example we will make a map of the region near
-Taiwan. We choose the center of the projection to be at 125ºE/20ºN and
-25ºN and 45ºN as our two standard parallels. We desire a map that is 5
-inches wide. The complete command needed to generate the map below is
-therefore given by:
-
- ::
-
- gmt set MAP_GRID_CROSS_SIZE_PRIMARY 0
- gmt pscoast -R110/140/20/35 -JB125/20/25/45/5i -Bag -Dl -Ggreen -Wthinnest \
- -A250 -P > GMT_albers.ps
-
-.. figure:: /_images/GMT_albers.*
- :width: 500 px
- :align: center
-
- Albers equal-area conic map projection.
-
-
-Equidistant conic projection (**-Jd** **-JD**) :ref:`... <-Jd_full>`
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The equidistant conic projection was described by the Greek philosopher
-Claudius Ptolemy about A.D. 150. It is neither conformal or equal-area,
-but serves as a compromise between them. The scale is true along all
-meridians and the standard parallels. To select this projection in
-GMT you must provide the same information as for the other conic
-projection, i.e.,
-
-- Longitude and latitude of the projection center.
-
-- Two standard parallels.
-
-- Map scale in inch/degree or 1:xxxxx notation (**-Jd**), or map width (**-JD**).
-
-The equidistant conic projection is often used for atlases with maps of
-small countries. As an example, we generate a map of Cuba:
-
- ::
-
- gmt set FORMAT_GEO_MAP ddd:mm:ssF MAP_GRID_CROSS_SIZE_PRIMARY 0.05i
- gmt pscoast -R-88/-70/18/24 -JD-79/21/19/23/4.5i -Bag -Di -N1/thick,red \
- -Glightgreen -Wthinnest -P > GMT_equidistant_conic.ps
-
-.. figure:: /_images/GMT_equidistant_conic.*
- :width: 500 px
- :align: center
-
- Equidistant conic map projection.
-
-
-Lambert conic conformal projection (**-Jl** **-JL**) :ref:`... <-Jl_full>`
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-This conic projection was designed by the Alsatian mathematician Johann
-Heinrich Lambert (1772) and has been used extensively for mapping of
-regions with predominantly east-west orientation, just like the Albers
-projection. Unlike the Albers projection, Lambert's conformal projection
-is not equal-area. The parallels are arcs of circles with a common
-origin, and meridians are the equally spaced radii of these circles. As
-with Albers projection, it is only the two standard parallels that are
-distortion-free. To select this projection in GMT you must provide the
-same information as for the Albers projection, i.e.,
-
-- Longitude and latitude of the projection center.
-
-- Two standard parallels.
-
-- Map scale in inch/degree or 1:xxxxx notation (**-Jl**), or map width (**-JL**).
-
-The Lambert conformal projection has been used for basemaps for all the
-48 contiguous States with the two fixed standard parallels 33ºN and 45ºN.
-We will generate a map of the continental USA using these parameters.
-Note that with all the projections you have the option of selecting a
-rectangular border rather than one defined by meridians and parallels.
-Here, we choose the regular WESN region, a "fancy" basemap frame, and
-use degrees west for longitudes. The generating commands used were
-
- ::
-
- gmt set MAP_FRAME_TYPE FANCY FORMAT_GEO_MAP ddd:mm:ssF MAP_GRID_CROSS_SIZE_PRIMARY 0.05i
- gmt pscoast -R-130/-70/24/52 -Jl-100/35/33/45/1:50000000 -Bag -Dl -N1/thick,red \
- -N2/thinner -A500 -Gtan -Wthinnest,white -Sblue -P > GMT_lambert_conic.ps
-
-.. figure:: /_images/GMT_lambert_conic.*
- :width: 500 px
- :align: center
-
- Lambert conformal conic map projection.
-
-
-The choice for projection center does not affect the projection but it
-indicates which meridian (here 100ºW) will be vertical on the map. The
-standard parallels were originally selected by Adams to provide a
-maximum scale error between latitudes 30.5ºN and 47.5ºN of 0.5--1%. Some
-areas, like Florida, experience scale errors of up to 2.5%.
-
-(American) polyconic projection (**-Jpoly** **-JPoly**) :ref:`... <-Jpoly_full>`
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The polyconic projection, in Europe usually referred to as the American
-polyconic projection, was introduced shortly before 1820 by the
-Swiss-American cartographer Ferdinand Rodulph Hassler (1770--1843). As
-head of the Survey of the Coast, he was looking for a projection that
-would give the least distortion for mapping the coast of the United
-States. The projection acquired its name from the construction of each
-parallel, which is achieved by projecting the parallel onto the cone
-while it is rolled around the globe, along the central meridian, tangent
-to that parallel. As a consequence, the projection involves many cones
-rather than a single one used in regular conic projections.
-
-The polyconic projection is neither equal-area, nor conformal. It is
-true to scale without distortion along the central meridian. Each
-parallel is true to scale as well, but the meridians are not as they get
-further away from the central meridian. As a consequence, no parallel is
-standard because conformity is lost with the lengthening of the meridians.
-
-Below we reproduce the illustration by *Snyder* [1987], with a gridline
-every 10 and annotations only every 30º in longitude:
-
- ::
-
- gmt pscoast -R-180/-20/0/90 -JPoly/4i -Bx30g10 -By10g10 -Dc -A1000 -Glightgray \
- -Wthinnest -P > GMT_polyconic.ps
-
-.. figure:: /_images/GMT_polyconic.*
- :width: 500 px
- :align: center
-
- (American) polyconic projection.
-
-
-Azimuthal projections
----------------------
-
-Lambert Azimuthal Equal-Area (**-Ja** **-JA**)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-This projection was developed by Lambert in 1772 and is typically used
-for mapping large regions like continents and hemispheres. It is an
-azimuthal, equal-area projection, but is not perspective. Distortion is
-zero at the center of the projection, and increases radially away from
-this point. To define this projection in GMT you must provide the
-following information:
-
-- Longitude and latitude of the projection center.
-
-- Optionally, the horizon, i.e., the number of degrees from the center
- to the edge (<= 180, default is 90).
-
-- Scale as 1:xxxxx or as radius/latitude where radius is the projected
- distance on the map from projection center to an oblique latitude where 0
- would be the oblique Equator
- (**-Ja**), or map width (**-JA**).
-
-Two different types of maps can be made with this projection depending
-on how the region is specified. We will give examples of both types.
-
-Rectangular map
-^^^^^^^^^^^^^^^
-
-In this mode we define our region by specifying the longitude/latitude
-of the lower left and upper right corners instead of the usual *west,
-east, south, north* boundaries. The reason for specifying our area this
-way is that for this and many other projections, lines of equal
-longitude and latitude are not straight lines and are thus poor choices
-for map boundaries. Instead we require that the map boundaries be
-rectangular by defining the corners of a rectangular map boundary. Using
-0ºE/40ºS (lower left) and 60ºE/10ºS (upper right) as our corners we try
-
- ::
-
- gmt set FORMAT_GEO_MAP ddd:mm:ssF MAP_GRID_CROSS_SIZE_PRIMARY 0
- gmt pscoast -R0/-40/60/-10r -JA30/-30/4.5i -Bag -Dl -A500 -Gp300/10 \
- -Wthinnest -P > GMT_lambert_az_rect.ps
-
-.. figure:: /_images/GMT_lambert_az_rect.*
- :width: 500 px
- :align: center
-
- Rectangular map using the Lambert azimuthal equal-area projection.
-
-
-Note that an "r" is appended to the **-R** option to inform GMT that
-the region has been selected using the rectangle technique, otherwise it
-would try to decode the values as *west, east, south, north* and report
-an error since *'east'* < *'west'*.
-
-Hemisphere map
-^^^^^^^^^^^^^^
-
-Here, you must specify the world as your region (**-Rg** or
-**-Rd**). E.g., to obtain a hemisphere view that shows the Americas, try
-
- ::
-
- gmt pscoast -Rg -JA280/30/3.5i -Bg -Dc -A1000 -Gnavy -P > GMT_lambert_az_hemi.ps
-
-.. figure:: /_images/GMT_lambert_az_hemi.*
- :width: 400 px
- :align: center
-
- Hemisphere map using the Lambert azimuthal equal-area projection.
-
-
-To geologists, the Lambert azimuthal equal-area projection (with origin
-at 0/0) is known as the *equal-area* (Schmidt) stereonet and used for
-plotting fold axes, fault planes, and the like. An *equal-angle* (Wulff)
-stereonet can be obtained by using the stereographic projection
-(discussed later). The stereonets produced by these two projections appear below.
-
-.. _GMT_stereonets:
-
-.. figure:: /_images/GMT_stereonets.*
- :width: 500 px
- :align: center
-
- Equal-Area (Schmidt) and Equal-Angle (Wulff) stereo nets.
-
-
-Stereographic Equal-Angle projection (**-Js** **-JS**) :ref:`... <-Js_full>`
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-This is a conformal, azimuthal projection that dates back to the Greeks.
-Its main use is for mapping the polar regions. In the polar aspect all
-meridians are straight lines and parallels are arcs of circles. While
-this is the most common use it is possible to select any point as the
-center of projection. The requirements are
-
-- Longitude and latitude of the projection center.
-
-- Optionally, the horizon, i.e., the number of degrees from the center
- to the edge (< 180, default is 90).
-
-- Scale as 1:xxxxx (true scale at pole), slat/1:xxxxx (true scale at
- standard parallel slat), or radius/latitude where radius is distance
- on map in inches from projection center to a particular
- oblique latitude (**-Js**), or simply map width (**-JS**).
-
-A default map scale factor of 0.9996 will be applied by default
-(although you may change this with :ref:`PROJ_SCALE_FACTOR <PROJ_SCALE_FACTOR>`). However,
-the setting is ignored when a standard parallel has been specified since
-the scale is then implicitly given. We will look at two different types
-of maps.
-
-Polar Stereographic Map :ref:`... <-Js_full>`
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-In our first example we will let the projection center be at the north
-pole. This means we have a polar stereographic projection and the map
-boundaries will coincide with lines of constant longitude and latitude.
-An example is given by
-
- ::
-
- gmt pscoast -R-30/30/60/72 -Js0/90/4.5i/60 -B10g -Dl -A250 -Groyalblue \
- -Sseashell -P > GMT_stereographic_polar.ps
-
-.. figure:: /_images/GMT_stereographic_polar.*
- :width: 500 px
- :align: center
-
- Polar stereographic conformal projection.
-
-
-Rectangular stereographic map
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-As with Lambert's azimuthal equal-area projection we have the option to
-use rectangular boundaries rather than the wedge-shape typically
-associated with polar projections. This choice is defined by selecting
-two points as corners in the rectangle and appending an "r" to the
-**-R** option. This command produces a map as presented in
-Figure :ref:`Polar stereographic <GMT_stereographic_rect>`:
-
- ::
-
- gmt set MAP_ANNOT_OBLIQUE 30
- gmt pscoast -R-25/59/70/72r -JS10/90/11c -B20g -Dl -A250 -Gdarkbrown -Wthinnest \
- -Slightgray -P > GMT_stereographic_rect.ps
-
-.. _GMT_stereographic_rect:
-
-.. figure:: /_images/GMT_stereographic_rect.*
- :width: 500 px
- :align: center
-
- Polar stereographic conformal projection with rectangular borders.
-
-
-General stereographic map
-^^^^^^^^^^^^^^^^^^^^^^^^^
-
-In terms of usage this projection is identical to the Lambert azimuthal
-equal-area projection. Thus, one can make both rectangular and
-hemispheric maps. Our example shows Australia using a projection pole at
-130ºE/30ºS. The command used was
-
- ::
-
- gmt set MAP_ANNOT_OBLIQUE 0
- gmt pscoast -R100/-42/160/-8r -JS130/-30/4i -Bag -Dl -A500 -Ggreen -Slightblue \
- -Wthinnest -P > GMT_stereographic_general.ps
-
-.. figure:: /_images/GMT_stereographic_general.*
- :width: 500 px
- :align: center
-
- General stereographic conformal projection with rectangular borders.
-
-
-By choosing 0/0 as the pole, we obtain the conformal stereonet presented
-next to its equal-area cousin in the Section `Lambert Azimuthal Equal-Area (-Ja -JA)`_ on the Lambert
-azimuthal equal-area projection (Figure :ref:`Stereonets <GMT_stereonets>`).
-
-Perspective projection (**-Jg** **-JG**) :ref:`... <-Jg_full>`
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The perspective projection imitates in 2 dimensions the 3-dimensional
-view of the earth from space. The implementation in GMT is very
-flexible, and thus requires many input variables. Those are listed and
-explained below, with the values used in
-Figure :ref:`Perspective projection <GMT_perspective>` between brackets.
-
-- Longitude and latitude of the projection center (4ºE/52ºN).
-
-- Altitude of the viewer above sea level in kilometers (230 km). If
- this value is less than 10, it is assumed to be the distance of the
- viewer from the center of the earth in earth radii. If an "r" is
- appended, it is the distance from the center of the earth in
- kilometers.
-
-- Azimuth in degrees (90, due east). This is the direction in which you
- are looking, measured clockwise from north.
-
-- Tilt in degrees (60). This is the viewing angle relative to zenith.
- So a tilt of 0º is looking straight down, 60º is looking from 30º above
- the horizon.
-
-- Twist in degrees (180). This is the boresight rotation (clockwise) of
- the image. The twist of 180º in the example mimics the fact that the
- Space Shuttle flies upside down.
-
-- Width and height of the viewpoint in degrees (60). This number
- depends on whether you are looking with the naked eye (in which case
- you view is about 60º wide), or with binoculars, for example.
-
-- Scale as 1:xxxxx or as radius/latitude where radius is distance on
- map in inches from projection center to a particular
- oblique latitude (**-Jg**), or map width (**-JG**) (5 inches).
-
-The imagined view of northwest Europe from a Space Shuttle at 230 km
-looking due east is thus accomplished by the following
-:doc:`pscoast` command:
-
- ::
-
- gmt pscoast -Rg -JG4/52/230/90/60/180/60/60/5i -Bx2g2 -By1g1 -Ia -Di -Glightbrown \
- -Wthinnest -P -Slightblue --MAP_ANNOT_MIN_SPACING=0.25i > GMT_perspective.ps
-
-.. _GMT_perspective:
-
-.. figure:: /_images/GMT_perspective.*
- :width: 500 px
- :align: center
-
- View from the Space Shuttle in Perspective projection.
-
-
-Orthographic projection (**-Jg** **-JG**) :ref:`... <-Jg_full>`
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The orthographic azimuthal projection is a perspective projection from
-infinite distance. It is therefore often used to give the appearance of
-a globe viewed from outer space. As with Lambert's equal-area and the
-stereographic projection, only one hemisphere can be viewed at any time.
-The projection is neither equal-area nor conformal, and much distortion
-is introduced near the edge of the hemisphere. The directions from the
-center of projection are true. The projection was known to the Egyptians
-and Greeks more than 2,000 years ago. Because it is mainly used for
-pictorial views at a small scale, only the spherical form is necessary.
-
-To specify the orthographic projection the same options **-Jg** or
-**-JG** as the perspective projection are used, but with fewer variables to supply:
-
-- Longitude and latitude of the projection center.
-
-- Optionally, the horizon, i.e., the number of degrees from the center
- to the edge (<= 90, default is 90).
-
-- Scale as 1:xxxxx or as radius/latitude where radius is distance on
- map in inches from projection center to a particular
- oblique latitude (**-Jg**), or map width (**-JG**).
-
-Our example of a perspective view centered on 75ºW/40ºN can therefore be
-generated by the following :doc:`pscoast` command:
-
- ::
-
- gmt pscoast -Rg -JG-75/41/4.5i -Bg -Dc -A5000 -Gpink -Sthistle -P > GMT_orthographic.ps
-
-.. figure:: /_images/GMT_orthographic.*
- :width: 400 px
- :align: center
-
- Hemisphere map using the Orthographic projection.
-
-
-Azimuthal Equidistant projection (**-Je** **-JE**) :ref:`... <-Je_full>`
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The most noticeable feature of this azimuthal projection is the fact
-that distances measured from the center are true. Therefore, a circle
-about the projection center defines the locus of points that are equally
-far away from the plot origin. Furthermore, directions from the center
-are also true. The projection, in the polar aspect, is at least several
-centuries old. It is a useful projection for a global view of locations
-at various or identical distance from a given point (the map center).
-
-To specify the azimuthal equidistant projection you must supply:
-
-- Longitude and latitude of the projection center.
-
-- Optionally, the horizon, i.e., the number of degrees from the center
- to the edge (<= 180, default is 180).
-
-- Scale as 1:xxxxx or as radius/latitude where radius is distance on
- map in inches from projection center to a particular
- oblique latitude (**-Je**), or map width (**-JE**).
-
-Our example of a global view centered on 100ºW/40ºN can therefore be
-generated by the following :doc:`pscoast`
-command. Note that the antipodal point is 180º away from the center, but
-in this projection this point plots as the entire map perimeter:
-
- ::
-
- gmt pscoast -Rg -JE-100/40/4.5i -Bg -Dc -A10000 -Glightgray -Wthinnest -P \
- > GMT_az_equidistant.ps
-
-.. figure:: /_images/GMT_az_equidistant.*
- :width: 400 px
- :align: center
-
- World map using the equidistant azimuthal projection.
-
-
-Gnomonic projection (**-Jf** **-JF**) :ref:`... <-Je_full>`
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The Gnomonic azimuthal projection is a perspective projection from the
-center onto a plane tangent to the surface. Its origin goes back to the
-old Greeks who used it for star maps almost 2500 years ago. The
-projection is neither equal-area nor conformal, and much distortion is
-introduced near the edge of the hemisphere; in fact, less than a
-hemisphere may be shown around a given center. The directions from the
-center of projection are true. Great circles project onto straight
-lines. Because it is mainly used for pictorial views at a small scale,
-only the spherical form is necessary.
-
-To specify the Gnomonic projection you must supply:
-
-- Longitude and latitude of the projection center.
-
-- Optionally, the horizon, i.e., the number of degrees from the center
- to the edge (< 90, default is 60).
-
-- Scale as 1:xxxxx or as radius/latitude where radius is distance on
- map in inches from projection center to a particular
- oblique latitude (**-Jf**), or map width (**-JF**).
-
-Using a horizon of 60, our example of this projection centered on
-120ºW/35ºN can therefore be generated by the following :doc:`pscoast` command:
-
- ::
-
- gmt pscoast -Rg -JF-120/35/60/4.5i -B30g15 -Dc -A10000 -Gtan -Scyan -Wthinnest \
- -P > GMT_gnomonic.ps
-
-.. figure:: /_images/GMT_gnomonic.*
- :width: 500 px
- :align: center
-
- Gnomonic azimuthal projection.
-
-
-Cylindrical projections
------------------------
-
-Cylindrical projections are easily recognized for its shape: maps are
-rectangular and meridians and parallels are straight lines crossing at
-right angles. But that is where similarities between the cylindrical
-projections supported by GMT (Mercator, transverse Mercator, universal
-transverse Mercator, oblique Mercator, Cassini, cylindrical equidistant,
-cylindrical equal-area, Miller, and cylindrical stereographic
-projections) stops. Each have a different way of spacing the meridians
-and parallels to obtain certain desirable cartographic properties.
-
-Mercator projection (**-Jm** **-JM**) :ref:`... <-Je_full>`
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Probably the most famous of the various map projections, the Mercator
-projection takes its name from the Flemish cartographer Gheert Cremer,
-better known as Gerardus Mercator, who presented it in 1569. The
-projection is a cylindrical and conformal, with no distortion along the
-equator. A major navigational feature of the projection is that a line
-of constant azimuth is straight. Such a line is called a rhumb line or
-*loxodrome*. Thus, to sail from one point to another one only had to
-connect the points with a straight line, determine the azimuth of the
-line, and keep this constant course for the entire voyage [21]_. The
-Mercator projection has been used extensively for world maps in which
-the distortion towards the polar regions grows rather large, thus
-incorrectly giving the impression that, for example, Greenland is larger
-than South America. In reality, the latter is about eight times the size
-of Greenland. Also, the Former Soviet Union looks much bigger than
-Africa or South America. One may wonder whether this illusion has had
-any influence on U.S. foreign policy.
-
-In the regular Mercator projection, the cylinder touches the globe along
-the equator. Other orientations like vertical and oblique give rise to
-the Transverse and Oblique Mercator projections, respectively. We will
-discuss these generalizations following the regular Mercator projection.
-
-The regular Mercator projection requires a minimum of parameters. To use
-it in GMT programs you supply this information (the first two items
-are optional and have defaults):
-
-- Central meridian [Middle of your map].
-
-- Standard parallel for true scale [Equator]. When supplied, central
- meridian must be supplied as well.
-
-- Scale along the equator in inch/degree or 1:xxxxx (**-Jm**), or map
- width (**-JM**).
-
-Our example presents a world map at a scale of 0.012 inch pr degree
-which will give a map 4.32 inch wide. It was created with the command:
-
- ::
-
- gmt set MAP_FRAME_TYPE fancy
- gmt pscoast -R0/360/-70/70 -Jm1.2e-2i -Bxa60f15 -Bya30f15 -Dc -A5000 -Gred \
- -P > GMT_mercator.ps
-
-.. figure:: /_images/GMT_mercator.*
- :width: 500 px
- :align: center
-
- Simple Mercator map.
-
-
-While this example is centered on the Dateline, one can easily choose
-another configuration with the **-R** option. A map centered on
-Greenwich would specify the region with **-R**-180/180/-70/70.
-
-Transverse Mercator projection (**-Jt** **-JT**) :ref:`... <-Jt_full>`
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The transverse Mercator was invented by Lambert in 1772. In this
-projection the cylinder touches a meridian along which there is no
-distortion. The distortion increases away from the central meridian and
-goes to infinity at 90º from center. The central meridian, each meridian
-90º away from the center, and equator are straight lines; other parallels
-and meridians are complex curves. The projection is defined by
-specifying:
-
-- The central meridian.
-
-- Optionally, the latitude of origin (default is the equator).
-
-- Scale along the equator in inch/degree or 1:xxxxx (**-Jt**), or map
- width (**-JT**).
-
-The optional latitude of origin defaults to Equator if not specified.
-Although defaulting to 1, you can change the map scale factor via the
-:ref:`PROJ_SCALE_FACTOR <PROJ_SCALE_FACTOR>` parameter. Our example shows a transverse
-Mercator map of south-east Europe and the Middle East with 35ºE as the
-central meridian:
-
- ::
-
- gmt pscoast -R20/30/50/45r -Jt35/0.18i -Bag -Dl -A250 -Glightbrown -Wthinnest \
- -P -Sseashell > GMT_transverse_merc.ps
-
-.. figure:: /_images/GMT_transverse_merc.*
- :width: 500 px
- :align: center
-
- Rectangular Transverse Mercator map.
-
-
-The transverse Mercator can also be used to generate a global map - the
-equivalent of the 360º Mercator map. Using the command
-
- ::
-
- gmt pscoast -R0/360/-80/80 -JT330/-45/3.5i -Ba30g -BWSne -Dc -A2000 \
- -Slightblue -G0 -P > GMT_TM.ps
-
-we made the map illustrated in Figure :ref:`Global transverse Mercator
-<GMT_TM>`. Note that
-when a world map is given (indicated by **-R**\ *0/360/s/n*), the
-arguments are interpreted to mean oblique degrees, i.e., the 360º range
-is understood to mean the extent of the plot along the central meridian,
-while the "south" and "north" values represent how far from the central
-longitude we want the plot to extend. These values correspond to
-latitudes in the regular Mercator projection and must therefore be less
-than 90.
-
-.. _GMT_TM:
-
-.. figure:: /_images/GMT_TM.*
- :width: 450 px
- :align: center
-
- A global transverse Mercator map.
-
-
-Universal Transverse Mercator (UTM) projection (**-Ju** **-JU**) :ref:`... <-Ju_full>`
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-A particular subset of the transverse Mercator is the Universal
-Transverse Mercator (UTM) which was adopted by the US Army for
-large-scale military maps. Here, the globe is divided into 60 zones
-between 84ºS and 84ºN, most of which are 6 wide. Each of these UTM zones
-have their unique central meridian. Furthermore, each zone is divided
-into latitude bands but these are not needed to specify the projection
-for most cases. See Figure :ref:`Universal Transverse Mercator
-<GMT_utm_zones>` for all zone designations.
-
-.. _GMT_utm_zones:
-
-.. figure:: /_images/GMT_utm_zones.*
- :width: 700 px
- :align: center
-
- Universal Transverse Mercator zone layout.
-
-
-GMT implements both the transverse Mercator and the UTM projection.
-When selecting UTM you must specify:
-
-- UTM zone (A, B, 1--60, Y, Z). Use negative values for numerical zones
- in the southern hemisphere or append the latitude modifiers C--H, J--N,
- P--X) to specify an exact UTM grid zone.
-
-- Scale along the equator in inch/degree or 1:xxxxx (**-Ju**), or map
- width (**-JU**).
-
-In order to minimize the distortion in any given zone, a scale factor of
-0.9996 has been factored into the formulae. (although a standard, you
-can change this with :ref:`PROJ_SCALE_FACTOR <PROJ_SCALE_FACTOR>`). This makes the UTM
-projection a *secant* projection and not a *tangent* projection like the
-transverse Mercator above. The scale only varies by 1 part in 1,000 from
-true scale at equator. The ellipsoidal projection expressions are
-accurate for map areas that extend less than 10 away from the central
-meridian. For larger regions we use the conformal latitude in the
-general spherical formulae instead.
-
-Oblique Mercator projection (**-Jo** **-JO**) :ref:`... <-Jo_full>`
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Oblique configurations of the cylinder give rise to the oblique Mercator
-projection. It is particularly useful when mapping regions of large
-lateral extent in an oblique direction. Both parallels and meridians are
-complex curves. The projection was developed in the early 1900s by
-several workers. Several parameters must be provided to define the
-projection. GMT offers three different definitions:
-
-#. Option **-Joa** or **-JOa**:
-
- - Longitude and latitude of projection center.
-
- - Azimuth of the oblique equator.
-
- - Scale in inch/degree or 1:xxxxx along oblique equator (**-Joa**),
- or map width (**-JOa**).
-
-#. Option **-Job** or **-JOb**:
-
- - Longitude and latitude of projection center.
-
- - Longitude and latitude of second point on oblique equator.
-
- - Scale in inch/degree or 1:xxxxx along oblique equator (**-Job**),
- or map width (**-JOb**).
-
-#. Option **-Joc** or **-JOc**:
-
- - Longitude and latitude of projection center.
-
- - Longitude and latitude of projection pole.
-
- - Scale in inch/degree or 1:xxxxx along oblique equator (**-Joc**),
- or map width (**-JOc**).
-
-Our example was produced by the command
-
- ::
-
- gmt pscoast -R270/20/305/25r -JOc280/25.5/22/69/4.8i -Bag -Di -A250 -Gburlywood \
- -Wthinnest -P -Tf301.5/23/0.4i/2 -Sazure --FONT_TITLE=8p \
- --MAP_TITLE_OFFSET=0.05i > GMT_obl_merc.ps
-
-.. figure:: /_images/GMT_obl_merc.*
- :width: 500 px
- :align: center
-
- Oblique Mercator map using **-Joc**. We make it clear which direction is North by
- adding a star rose with the **-T** option.
-
-
-It uses definition 3 for an oblique view of some Caribbean islands. Note
-that we define our region using the rectangular system described
-earlier. If we do not append an "r" to the **-R** string then the
-information provided with the **-R** option is assumed to be oblique
-degrees about the projection center rather than the usual geographic
-coordinates. This interpretation is chosen since in general the
-parallels and meridians are not very suitable as map boundaries.
-
-Cassini cylindrical projection (**-Jc** **-JC**) :ref:`... <-Jc_full>`
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-This cylindrical projection was developed in 1745 by César-François
-Cassini de Thury for the survey of France. It is occasionally called
-Cassini-Soldner since the latter provided the more accurate mathematical
-analysis that led to the development of the ellipsoidal formulae. The
-projection is neither conformal nor equal-area, and behaves as a
-compromise between the two end-members. The distortion is zero along the
-central meridian. It is best suited for mapping regions of north-south
-extent. The central meridian, each meridian 90º away, and equator are
-straight lines; all other meridians and parallels are complex curves.
-The requirements to define this projection are:
-
-- Longitude and latitude of central point.
-
-- Scale in inch/degree or as 1:xxxxx (**-Jc**), or map width (**-JC**).
-
-A detailed map of the island of Sardinia centered on the 8º45'E meridian
-using the Cassini projection can be obtained by running the command:
-
- ::
-
- gmt pscoast -R7:30/38:30/10:30/41:30r -JC8.75/40/2.5i -Bafg -Lf9.5/38.8/40/60 -Gspringgreen \
- -Dh -Sazure -Wthinnest -Ia/thinner -P --FONT_LABEL=12p > GMT_cassini.ps
-
-.. figure:: /_images/GMT_cassini.*
- :width: 400 px
- :align: center
-
- Cassini map over Sardinia.
-
-
-As with the previous projections, the user can choose between a
-rectangular boundary (used here) or a geographical (WESN) boundary.
-
-Cylindrical equidistant projection (**-Jq** **-JQ**) :ref:`... <-Jq_full>`
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-This simple cylindrical projection is really a linear scaling of
-longitudes and latitudes. The most common form is the Plate Carrée
-projection, where the scaling of longitudes and latitudes is the same.
-All meridians and parallels are straight lines. The projection can be
-defined by:
-
-- The central meridian [Middle of your map].
-
-- Standard parallel [Equator].
-
-- Scale in inch/degree or as 1:xxxxx (**-Jq**), or map width (**-JQ**).
-
-The first two of these are optional and have defaults. When the standard
-parallel is defined, the central meridian must be supplied as well.
-
-A world map centered on the dateline using this projection can be
-obtained by running the command:
-
- ::
-
- gmt pscoast -Rg -JQ4.5i -B60f30g30 -Dc -A5000 -Gtan4 -Slightcyan -P > GMT_equi_cyl.ps
-
-.. figure:: /_images/GMT_equi_cyl.*
- :width: 500 px
- :align: center
-
- World map using the Plate Carrée projection.
-
-
-Different relative scalings of longitudes and latitudes can be obtained
-by selecting a standard parallel different from the equator. Some
-selections for standard parallels have practical properties as shown in
-Table :ref:`JQ <tbl-JQ>`.
-
-.. _tbl-JQ:
-
-+-----------------------------------------------------+--------+
-+=====================================================+========+
-| Grafarend and Niermann, minimum linear distortion | 61.7º |
-+-----------------------------------------------------+--------+
-| Ronald Miller Equirectangular | 50.5º |
-+-----------------------------------------------------+--------+
-| Ronald Miller, minimum continental distortion | 43.5º |
-+-----------------------------------------------------+--------+
-| Grafarend and Niermann | 42º |
-+-----------------------------------------------------+--------+
-| Ronald Miller, minimum overall distortion | 37.5º |
-+-----------------------------------------------------+--------+
-| Plate Carrée, Simple Cylindrical, Plain/Plane | 0º |
-+-----------------------------------------------------+--------+
-
-Cylindrical equal-area projections (**-Jy** **-JY**) :ref:`... <-Jy_full>`
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-This cylindrical projection is actually several projections, depending
-on what latitude is selected as the standard parallel. However, they are
-all equal area and hence non-conformal. All meridians and parallels are
-straight lines. The requirements to define this projection are:
-
-- The central meridian.
-
-- The standard parallel.
-
-- Scale in inch/degree or as 1:xxxxx (**-Jy**), or map width (**-JY**)
-
-While you may choose any value for the standard parallel and obtain your
-own personal projection, there are seven choices of standard parallels
-that result in known (or named) projections. These are listed in Table :ref:`JY <tbl-JY>`.
-
-.. _tbl-JY:
-
-+-------------------+---------------------+
-+===================+=====================+
-| Balthasart | 50º |
-+-------------------+---------------------+
-| Gall-Peters | 45º |
-+-------------------+---------------------+
-| Hobo-Dyer | 37º30' (= 37.5º) |
-+-------------------+---------------------+
-| Trystan Edwards | 37º24' (= 37.4º) |
-+-------------------+---------------------+
-| Caster | 37º04' (= 37.0666º) |
-+-------------------+---------------------+
-| Behrman | 30º |
-+-------------------+---------------------+
-| Lambert | 0º |
-+-------------------+---------------------+
-
-For instance, a world map centered on the 35ºE meridian using the Behrman
-projection (Figure :ref:`Behrman cylindrical projection <GMT_general_cyl>`)
-can be obtained by running the command:
-
- ::
-
- gmt pscoast -R-145/215/-90/90 -JY35/30/4.5i -B45g45 -Dc -A10000 -Sdodgerblue \
- -Wthinnest -P > GMT_general_cyl.ps
-
-.. _GMT_general_cyl:
-
-.. figure:: /_images/GMT_general_cyl.*
- :width: 600 px
- :align: center
-
- World map using the Behrman cylindrical equal-area projection.
-
-
-As one can see there is considerable distortion at high latitudes since
-the poles map into lines.
-
-Miller Cylindrical projection (**-Jj** **-JJ**) :ref:`... <-Jj_full>`
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-This cylindrical projection, presented by Osborn Maitland Miller of the
-American Geographic Society in 1942, is neither equal nor conformal. All
-meridians and parallels are straight lines. The projection was designed
-to be a compromise between Mercator and other cylindrical projections.
-Specifically, Miller spaced the parallels by using Mercator's formula
-with 0.8 times the actual latitude, thus avoiding the singular poles;
-the result was then divided by 0.8. There is only a spherical form for
-this projection. Specify the projection by:
-
-- Optionally, the central meridian (default is the middle of your map).
-
-- Scale in inch/degree or as 1:xxxxx (**-Jj**), or map width (**-JJ**).
-
-For instance, a world map centered on the 90ºE meridian at a map scale of
-1:400,000,000 (Figure :ref:`Miller projection <GMT_miller>`) can be obtained as
-follows:
-
- ::
-
- gmt pscoast -R-90/270/-80/90 -Jj1:400000000 -Bx45g45 -By30g30 -Dc -A10000 \
- -Gkhaki -Wthinnest -P -Sazure > GMT_miller.ps
-
-.. _GMT_miller:
-
-.. figure:: /_images/GMT_miller.*
- :width: 500 px
- :align: center
-
- World map using the Miller cylindrical projection.
-
-
-Cylindrical stereographic projections (**-Jcyl_stere** **-JCyl_stere**) :ref:`... <-Jcyl_stere_full>`
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The cylindrical stereographic projections are certainly not as notable
-as other cylindrical projections, but are still used because of their
-relative simplicity and their ability to overcome some of the downsides
-of other cylindrical projections, like extreme distortions of the higher
-latitudes. The stereographic projections are perspective projections,
-projecting the sphere onto a cylinder in the direction of the antipodal
-point on the equator. The cylinder crosses the sphere at two standard
-parallels, equidistant from the equator. The projections are defined by:
-
-- The central meridian (uses the middle of the map when omitted).
-
-- The standard parallel (default is the Equator). When used, central
- meridian needs to be given as well.
-
-- Scale in inch/degree or as 1:xxxxx (**-Jcyl_stere**), or map width
- (**-JCyl_stere**)
-
-Some of the selections of the standard parallel are named for the
-cartographer or publication that popularized the projection
-(Table :ref:`JCylstere <tbl-JCylstere>`).
-
-.. _tbl-JCylstere:
-
-+---------------------------------------------------------+-------------+
-+=========================================================+=============+
-| Miller's modified Gall | 66.159467º |
-+---------------------------------------------------------+-------------+
-| Kamenetskiy's First | 55º |
-+---------------------------------------------------------+-------------+
-| Gall's stereographic | 45º |
-+---------------------------------------------------------+-------------+
-| Bolshoi Sovietskii Atlas Mira or Kamenetskiy's Second | 30º |
-+---------------------------------------------------------+-------------+
-| Braun's cylindrical | 0º |
-+---------------------------------------------------------+-------------+
-
-A map of the world, centered on the Greenwich meridian, using the Gall's
-stereographic projection (standard parallel is 45º,
-Figure :ref:`Gall's stereographic projection <GMT_gall_stereo>`),
-is obtained as follows:
-
- ::
-
- gmt set FORMAT_GEO_MAP dddA
- gmt pscoast -R-180/180/-60/80 -JCyl_stere/0/45/4.5i -Bxa60f30g30 -Bya30g30 -Dc -A5000 \
- -Wblack -Gseashell4 -Santiquewhite1 -P > GMT_gall_stereo.ps
-
-.. _GMT_gall_stereo:
-
-.. figure:: /_images/GMT_gall_stereo.*
- :width: 500 px
- :align: center
-
- World map using Gall's stereographic projection.
-
-
-Miscellaneous projections
--------------------------
-
-GMT supports 8 common projections for global presentation of data or
-models. These are the Hammer, Mollweide, Winkel Tripel, Robinson, Eckert
-IV and VI, Sinusoidal, and Van der Grinten projections. Due to the small
-scale used for global maps these projections all use the spherical
-approximation rather than more elaborate elliptical formulae.
-
-In all cases, the specification of the central meridian can be skipped.
-The default is the middle of the longitude range of the plot, specified
-by the (**-R**) option.
-
-Hammer projection (**-Jh** **-JH**) :ref:`... <-Jh_full>`
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The equal-area Hammer projection, first presented by the German
-mathematician Ernst von Hammer in 1892, is also known as Hammer-Aitoff
-(the Aitoff projection looks similar, but is not equal-area). The border
-is an ellipse, equator and central meridian are straight lines, while
-other parallels and meridians are complex curves. The projection is
-defined by selecting:
-
-- The central meridian [Middle of your map].
-
-- Scale along equator in inch/degree or 1:xxxxx (**-Jh**), or map width (**-JH**).
-
-A view of the Pacific ocean using the Dateline as central meridian is accomplished thus
-
- ::
-
- gmt pscoast -Rg -JH4.5i -Bg -Dc -A10000 -Gblack -Scornsilk -P > GMT_hammer.ps
-
-.. figure:: /_images/GMT_hammer.*
- :width: 500 px
- :align: center
-
- World map using the Hammer projection.
-
-
-Mollweide projection (**-Jw** **-JW**) :ref:`... <-Jw_full>`
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-This pseudo-cylindrical, equal-area projection was developed by the
-German mathematician and astronomer Karl Brandan Mollweide in 1805.
-Parallels are unequally spaced straight lines with the meridians being
-equally spaced elliptical arcs. The scale is only true along latitudes
-4044' north and south. The projection is used mainly for global maps
-showing data distributions. It is occasionally referenced under the name
-homalographic projection. Like the Hammer projection, outlined above, we
-need to specify only two parameters to completely define the mapping of
-longitudes and latitudes into rectangular *x*/*y* coordinates:
-
-- The central meridian [Middle of your map].
-
-- Scale along equator in inch/degree or 1:xxxxx (**-Jw**), or map width (**-JW**).
-
-An example centered on Greenwich can be generated thus:
-
- ::
-
- gmt pscoast -Rd -JW4.5i -Bg -Dc -A10000 -Gtomato1 -Sskyblue -P > GMT_mollweide.ps
-
-.. figure:: /_images/GMT_mollweide.*
- :width: 500 px
- :align: center
-
- World map using the Mollweide projection.
-
-
-Winkel Tripel projection (**-Jr** **-JR**) :ref:`... <-Jr_full>`
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-In 1921, the German mathematician Oswald Winkel a projection that was to
-strike a compromise between the properties of three elements (area,
-angle and distance). The German word "tripel" refers to this junction of
-where each of these elements are least distorted when plotting global
-maps. The projection was popularized when Bartholomew and Son started to
-use it in its world-renowned "The Times Atlas of the World" in the mid
-20th century. In 1998, the National Geographic Society made the Winkel
-Tripel as its map projection of choice for global maps.
-
-Naturally, this projection is neither conformal, nor equal-area. Central
-meridian and equator are straight lines; other parallels and meridians
-are curved. The projection is obtained by averaging the coordinates of
-the Equidistant Cylindrical and Aitoff (not Hammer-Aitoff) projections.
-The poles map into straight lines 0.4 times the length of equator. To
-use it you must enter
-
-- The central meridian [Middle of your map].
-
-- Scale along equator in inch/degree or 1:xxxxx (**-Jr**), or map width (**-JR**).
-
-Centered on Greenwich, the example in Figure :ref:`Winkel Tripel projection
-<GMT_winkel>` was created by this command:
-
- ::
-
- gmt pscoast -Rd -JR4.5i -Bg -Dc -A10000 -Gburlywood4 -Swheat1 -P > GMT_winkel.ps
-
-.. _GMT_winkel:
-
-.. figure:: /_images/GMT_winkel.*
- :width: 500 px
- :align: center
-
- World map using the Winkel Tripel projection.
-
-
-Robinson projection (**-Jn** **-JN**) :ref:`... <-Jn_full>`
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The Robinson projection, presented by the American geographer and
-cartographer Arthur H. Robinson in 1963, is a modified cylindrical
-projection that is neither conformal nor equal-area. Central meridian
-and all parallels are straight lines; other meridians are curved. It
-uses lookup tables rather than analytic expressions to make the world
-map "look" right [22]_. The scale is true along latitudes 38. The
-projection was originally developed for use by Rand McNally and is
-currently used by the National Geographic Society. To use it you must
-enter
-
-- The central meridian [Middle of your map].
-
-- Scale along equator in inch/degree or 1:xxxxx (**-Jn**), or map width
- (**-JN**).
-
-Again centered on Greenwich, the example below was created by this command:
-
- ::
-
- gmt pscoast -Rd -JN4.5i -Bg -Dc -A10000 -Ggoldenrod -Ssnow2 -P > GMT_robinson.ps
-
-.. figure:: /_images/GMT_robinson.*
- :width: 500 px
- :align: center
-
- World map using the Robinson projection.
-
-
-Eckert IV and VI projection (**-Jk** **-JK**) :ref:`... <-Jk_full>`
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The Eckert IV and VI projections, presented by the German cartographer
-Max Eckert-Greiffendorff in 1906, are pseudocylindrical equal-area
-projections. Central meridian and all parallels are straight lines;
-other meridians are equally spaced elliptical arcs (IV) or sinusoids
-(VI). The scale is true along latitudes 40º30' (IV) and 49º16' (VI). Their
-main use is in thematic world maps. To select Eckert IV you must use
-**-JKf** (**f** for "four") while Eckert VI is selected with **-JKs**
-(**s** for "six"). If no modifier is given it defaults to Eckert VI. In
-addition, you must enter
-
-- The central meridian [Middle of your map].
-
-- Scale along equator in inch/degree or 1:xxxxx (**-Jk**), or map width
- (**-JK**).
-
-Centered on the Dateline, the Eckert IV example below was created by
-this command:
-
- ::
-
- gmt pscoast -Rg -JKf4.5i -Bg -Dc -A10000 -Wthinnest -Givory -Sbisque3 -P > GMT_eckert4.ps
-
-.. figure:: /_images/GMT_eckert4.*
- :width: 500 px
- :align: center
-
- World map using the Eckert IV projection.
-
-
-The same script, with **s** instead of **f**, yields the Eckert VI map:
-
-.. figure:: /_images/GMT_eckert6.*
- :width: 500 px
- :align: center
-
- World map using the Eckert VI projection.
-
-
-Sinusoidal projection (**-Ji** **-JI**) :ref:`... <-Ji_full>`
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The sinusoidal projection is one of the oldest known projections, is
-equal-area, and has been used since the mid-16th century. It has also
-been called the "Equal-area Mercator" projection. The central meridian
-is a straight line; all other meridians are sinusoidal curves. Parallels
-are all equally spaced straight lines, with scale being true along all
-parallels (and central meridian). To use it, you need to select:
-
-- The central meridian [Middle of your map].
-
-- Scale along equator in inch/degree or 1:xxxxx (**-Ji**), or map width
- (**-JI**).
-
-A simple world map using the sinusoidal projection is therefore obtained by
-
- ::
-
- gmt pscoast -Rd -JI4.5i -Bxg30 -Byg15 -Dc -A10000 -Ggray -P > GMT_sinusoidal.ps
-
-.. figure:: /_images/GMT_sinusoidal.*
- :width: 500 px
- :align: center
-
- World map using the Sinusoidal projection.
-
-
-To reduce distortion of shape the interrupted sinusoidal projection was
-introduced in 1927. Here, three symmetrical segments are used to cover
-the entire world. Traditionally, the interruptions are at 160ºW, 20ºW, and
-60ºE. To make the interrupted map we must call
-:doc:`pscoast` for each segment and superpose
-the results. To produce an interrupted world map (with the traditional
-boundaries just mentioned) that is 5.04 inches wide we use the scale
-5.04/360 = 0.014 and offset the subsequent plots horizontally by their
-widths (140\ :math:`\cdot`\ 0.014 and 80\ :math:`\cdot`\ 0.014):
-
- ::
-
- gmt pscoast -R200/340/-90/90 -Ji0.014i -Bxg30 -Byg15 -A10000 -Dc \
- -Gblack -K -P > GMT_sinus_int.ps
- gmt pscoast -R-20/60/-90/90 -Ji0.014i -Bxg30 -Byg15 -Dc -A10000 \
- -Gblack -X1.96i -O -K >> GMT_sinus_int.ps
- gmt pscoast -R60/200/-90/90 -Ji0.014i -Bxg30 -Byg15 -Dc -A10000 \
- -Gblack -X1.12i -O >> GMT_sinus_int.ps
-
-.. figure:: /_images/GMT_sinus_int.*
- :width: 500 px
- :align: center
-
- World map using the Interrupted Sinusoidal projection.
-
-
-The usefulness of the interrupted sinusoidal projection is basically
-limited to display of global, discontinuous data distributions like
-hydrocarbon and mineral resources, etc.
-
-Van der Grinten projection (**-Jv** **-JV**) :ref:`... <-Jv_full>`
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The Van der Grinten projection, presented by Alphons J. van der Grinten
-in 1904, is neither equal-area nor conformal. Central meridian and
-Equator are straight lines; other meridians are arcs of circles. The
-scale is true along the Equator only. Its main use is to show the entire
-world enclosed in a circle. To use it you must enter
-
-- The central meridian [Middle of your map].
-
-- Scale along equator in inch/degree or 1:xxxxx (**-Jv**), or map width (**-JV**).
-
-Centered on the Dateline, the example below was created by this command:
-
- ::
-
- gmt pscoast -Rg -JV4i -Bxg30 -Byg15 -Dc -Glightgray -A10000 \
- -Wthinnest -P > GMT_grinten.ps
-
-.. figure:: /_images/GMT_grinten.*
- :width: 400 px
- :align: center
-
- World map using the Van der Grinten projection.
-
-
-.. include:: examples_chapter.rst_
-
-
-A. GMT Supplemental Packages
-============================
-
-These packages are for the most part written and supported by us, but
-there are some exceptions. They provide extensions of GMT that are
-needed for particular rather than general applications. The software is
-provided in a separate, supplemental archive (GMT_suppl.tar.gz (or .bz2)).
-Questions or bug reports for this software
-should be addressed to the person(s) listed in the ``README`` file associated with
-the particular program. It is not guaranteed that these programs are
-fully ANSI-C, Y2K, or POSIX compliant, or that they necessarily will
-install smoothly on all platforms, but most do. Note that the data sets
-some of these programs work on are not distributed with these packages;
-they must be obtained separately. The contents of the supplemental
-archive may change without notice; at this writing it contains these directories:
-
-gshhg: GSHHG data extractor
----------------------------
-
-This package contains :doc:`gshhg <supplements/gshhg/gshhg>` which you
-can use to extract shoreline polygons from the Global Self-consistent
-Hierarchical High-resolution Shorelines (GSHHG) available separately
-from or the (GSHHG is the polygon data base from which the
-GMT coastlines derive). The package is maintained by Paul Wessel.
-
-img: gridded altimetry extractor
---------------------------------
-
-This package consists of the program
-:doc:`img2grd <supplements/img/img2grd>` to extract subsets of the
-global gravity and predicted topography solutions derived from satellite
-altimetry [28]_. The package is maintained by Walter Smith and Paul Wessel.
-
-meca: seismology and geodesy symbols
-------------------------------------
-
-This package contains the programs
-:doc:`pscoupe <supplements/meca/pscoupe>`,
-:doc:`psmeca <supplements/meca/psmeca>`,
-:doc:`pspolar <supplements/meca/pspolar>`, and
-:doc:`psvelo <supplements/meca/psvelo>` which are used by seismologists
-and geodesists for plotting focal mechanisms (including cross-sections
-and polarities), error ellipses, velocity arrows, rotational wedges, and
-more. The package was developed by Kurt Feigl and Genevieve
-Patau but is now maintained by the GMT team.
-
-mgd77: MGD77 extractor and plotting tools
------------------------------------------
-
-This package currently holds the programs
-:doc:`mgd77convert <supplements/mgd77/mgd77convert>`,
-:doc:`mgd77info <supplements/mgd77/mgd77info>`,
-:doc:`mgd77list <supplements/mgd77/mgd77list>`,
-:doc:`mgd77magref <supplements/mgd77/mgd77magref>`,
-:doc:`mgd77manage <supplements/mgd77/mgd77manage>`,
-:doc:`mgd77path <supplements/mgd77/mgd77path>`,
-:doc:`mgd77sniffer <supplements/mgd77/mgd77sniffer>`, and
-:doc:`mgd77track <supplements/mgd77/mgd77track>` which can be used to
-extract information or data values from or plot marine geophysical data
-files in the ASCII MGD77 or netCDF MGD77+ formats [29]_). This package
-has replaced the old **mgg** package. The package is maintained by Paul Wessel.
-
-misc: Miscellaneous tools
--------------------------
-
-At the moment, this package contains the program
-:doc:`dimfilter <supplements/misc/dimfilter>`, which is an extension of
-:doc:`grdfilter` in that it allows for spatial directional filtering.
-The package is maintained by Paul Wessel.
-
-potential: Geopotential tools
------------------------------
-
-At the moment, this package contains the programs
-:doc:`gravfft <supplements/potential/gravfft>`, which performs gravity,
-isostasy, and admittance calculation for grids,
-:doc:`grdredpol <supplements/potential/grdredpol>`, which compute the
-continuous reduction to the pole, AKA differential RTP for magnetic
-data, :doc:`grdseamount <supplements/potential/grdseamount>`, which computes
-synthetic bathymetry over various seamount shapes, and
-:doc:`gmtgravmag3d <supplements/potential/gmtgravmag3d>` and
-:doc:`grdgravmag3d <supplements/potential/grdgravmag3d>`,
-which computes the gravity or
-magnetic anomaly of a body by the method of Okabe [30]_. The package is
-maintained by Joaquim Luis and Paul Wessel.
-
-segyprogs: plotting SEGY seismic data
--------------------------------------
-
-This package contains programs to plot SEGY seismic data files using the
-GMT mapping transformations and postscript library.
-:doc:`pssegy <supplements/segy/pssegy>` generates a 2-D plot (x:location
-and y:time/depth) while :doc:`pssegyz <supplements/segy/pssegyz>`
-generates a 3-D plot (x and y: location coordinates, z: time/depth).
-Locations may be read from predefined or arbitrary portions of each
-trace header. Finally, :doc:`segy2grd <supplements/segy/segy2grd>` can
-convert SEGY data to a GMT grid file. The package is maintained by Tim Henstock [31]_.
-
-spotter: backtracking and hotspotting
--------------------------------------
-
-This package contains the plate tectonic programs
-:doc:`backtracker <supplements/spotter/backtracker>`, which you can use to
-move geologic markers forward or backward in time,
-:doc:`grdpmodeler <supplements/spotter/grdpmodeler>` which evaluates
-predictions of a plate motion model on a grid,
-:doc:`grdrotater <supplements/spotter/grdrotater>` which rotates entire
-grids using a finite rotation,
-:doc:`hotspotter <supplements/spotter/hotspotter>` which generates CVA
-grids based on seamount locations and a set of absolute plate motion
-stage poles (:doc:`grdspotter <supplements/spotter/grdspotter>` does the
-same using a bathymetry grid instead of seamount locations),
-:doc:`originator <supplements/spotter/originator>`, which associates
-seamounts with the most likely hotspot origins, and
-:doc:`rotconverter <supplements/spotter/rotconverter>` which does various
-operations involving finite rotations on a sphere. The package is
-maintained by Paul Wessel.
-
-x2sys: track crossover error estimation
----------------------------------------
-
-This package contains the tools
-:doc:`x2sys_datalist <supplements/x2sys/x2sys_datalist>`, which allows
-you to extract data from almost any binary or ASCII data file, and
-:doc:`x2sys_cross <supplements/x2sys/x2sys_cross>` which determines
-crossover locations and errors generated by one or several geospatial
-tracks. Newly added are the tools
-:doc:`x2sys_init <supplements/x2sys/x2sys_init>`,
-:doc:`x2sys_binlist <supplements/x2sys/x2sys_binlist>`,
-:doc:`x2sys_get <supplements/x2sys/x2sys_get>`,
-:doc:`x2sys_list <supplements/x2sys/x2sys_list>`,
-:doc:`x2sys_put <supplements/x2sys/x2sys_put>`,
-:doc:`x2sys_report <supplements/x2sys/x2sys_report>`,
-:doc:`x2sys_solve <supplements/x2sys/x2sys_solve>` and
-:doc:`x2sys_merge <supplements/x2sys/x2sys_merge>` which extends the
-track-management system employed by the mgg supplement to generic track
-data of any format. This package represents a new generation of tools
-and replaces the old **x_system** package. The package is maintained by
-Paul Wessel.
-
-.. _App-file-formats:
-
-B. GMT File Formats
-===================
-
-Table data
-----------
-
-These files have *N* records which have *M* fields each. All programs
-that handle tables can read multicolumn files. GMT can read both
-ASCII, native binary, and netCDF table data.
-
-ASCII tables
-~~~~~~~~~~~~
-
-Optional file header records
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-The first data record may be preceded by one or more header records. Any
-records that begins with '#' is considered a header or comment line and
-are always processed correctly. If your data file has leading header
-records that do *not* start with '#' then you must make sure to use the
-**-h** option and set the parameter :ref:`IO_N_HEADER_RECS <IO_N_HEADER_RECS>` in the :doc:`gmt.conf` file
-(GMT default is one header record if **-h** is given; you may also use
-**-h**\ *nrecs* directly). Fields within a record must be separated by
-spaces, tabs, commas, or semi-colons. Each field can be an integer or floating-point
-number or a geographic coordinate string using the
-[+\ \|\ -]dd[:mm[:ss]][W:\ \|\ S\ \|\ N\ \|\ E\ \|\ w\ \|\ s\ \|\ n\ \|\ e]
-format. Thus, 12:30:44.5W, 17.5S, 1:00:05, and 200:45E are all valid
-input strings. GMT is expected to handle most CVS (Comma-Separated Values)
-files, including numbers given in double quotes. On output, fields will be separated by the character
-given by the parameter :ref:`IO_COL_SEPARATOR <IO_COL_SEPARATOR>`, which by default is a TAB.
-
-Optional segment header records
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-When dealing with time- or (*x,y*)-series it is usually convenient to
-have each profile in separate files. However, this may sometimes prove
-impractical due to large numbers of profiles. An example is files of
-digitized lineations where the number of individual features may range
-into the thousands. One file per feature would in this case be
-unreasonable and furthermore clog up the directory. GMT provides a
-mechanism for keeping more than one profile in a file. Such files are
-called *multiple segment files* and are identical to the ones just
-outlined except that they have segment headers interspersed with data
-records that signal the start of a new segment. The segment headers may
-be of any format, but all must have the same character in the first
-column. The unique character is by default '\ >\ ', but you can
-override that by modifying the :ref:`IO_SEGMENT_MARKER <IO_SEGMENT_MARKER>` default setting.
-Programs can examine the segment headers to see if they contain **-D**
-for a distance value, **-W** and **-G** options for specifying pen and
-fill attributes for individual segments, **-Z** to change color via a
-CPT file, **-L** for label specifications, or **-T** for general-purpose
-text descriptions. These settings (and occasionally others) will
-override the corresponding command line options. GMT also provides for
-two special values for :ref:`IO_SEGMENT_MARKER <IO_SEGMENT_MARKER>` that can make
-interoperability with other software packages easier. Choose the marker
-**B** to have blank lines recognized as segment breaks, or use **N** to
-have data records whose fields equal NaN mean segment breaks (e.g., as
-used by Matlab or Octave). When these markers are used then no other
-segment header will be considered. Note that :ref:`IO_SEGMENT_MARKER <IO_SEGMENT_MARKER>` can
-be set differently for input and output. Finally, if a segment represents
-a closed polygon that is a hole inside another polygon you indicate this
-with **-Ph**. This setting will be read and processed if converting a
-file to the OGR format.
-
-Binary tables
-~~~~~~~~~~~~~
-
-GMT programs also support native binary tables to speed up
-input-output for i/o-intensive tasks like gridding and preprocessing.
-This is discussed in more detail in section `Binary table i/o: The -b option`_.
-
-NetCDF tables
-~~~~~~~~~~~~~
-
-More and more programs are now producing binary data in the netCDF
-format, and so GMT programs started to support tabular netCDF data
-(files containing one or more 1-dimensional arrays) starting with
-GMT version 4.3.0. Because of the meta data contained in those files,
-reading them is much less complex than reading native binary tables, and
-even than ASCII tables. GMT programs will read as many 1-dimensional
-columns as are needed by the program, starting with the first
-1-dimensional it can find in the file. To specifically specify which
-variables are to be read, append the suffix
-**?**\ *var1*\ **/**\ *var2*\ **/**\ *...* to the netCDF file name or
-add the option **-bic**\ *var1*\ **/**\ *var2*\ **/**\ *...*, where
-*var1*, *var2*, etc.are the names of the variables to be processed. The
-latter option is particularly practical when more than one file is read:
-the **-bic** option will apply to all files. Currently, GMT only
-reads, but does not write, netCDF tabular data.
-
-Grid files
-----------
-
-GMT allows numerous grid formats to be read. In addition to the default
-netCDF format it can use binary floating points, short integers, bytes, and
-bits, as well as 8-bit Sun raster files (colormap ignored). Additional
-formats may be used by supplying read/write functions and linking these with
-the GMT libraries. The source file ``gmt_customio.c`` has the information
-that programmers will need to augment GMT to read custom grid files. See
-Section `Grid file format specifications`_ for more information.
-
-NetCDF files
-~~~~~~~~~~~~
-
-By default, GMT stores 2-D grids as COARDS-compliant netCDF files.
-COARDS (which stands for Cooperative Ocean/Atmosphere Research Data
-Service) is a convention used by many agencies distributing gridded data
-for ocean and atmosphere research. Sticking to this convention allows
-GMT to read gridded data provided by other institutes and other
-programs. Conversely, other general domain programs will be able to read
-grids created by GMT. COARDS is a subset of a more extensive
-convention for netCDF data called CF-1.5 (Climate and Forecast, version
-1.5). Hence, GMT grids are also automatically CF-1.5-compliant.
-However, since CF-1.5 has more general application than COARDS, not all
-CF-1.5 compliant netCDF files can be read by GMT.
-
-The netCDF grid file in GMT has several attributes (See Table
-:ref:`netcdf-format <tbl-netcdf-format>`) to describe the content. The routine
-that deals with netCDF grid files is sufficiently flexible so that grid files
-slightly deviating from the standards used by GMT can also be read.
-
-.. _tbl-netcdf-format:
-
-+----------------------+--------------------------------------------------------------------+
-| **Atributte** | **Description** |
-+======================+====================================================================+
-| | *Global attributes* |
-+----------------------+--------------------------------------------------------------------+
-| Conventions | COARDS, CF-1.5 (optional) |
-+----------------------+--------------------------------------------------------------------+
-| title | Title (optional) |
-+----------------------+--------------------------------------------------------------------+
-| source | How file was created (optional) |
-+----------------------+--------------------------------------------------------------------+
-| node_offset | 0 for gridline node registration (default), |
-| | 1 for pixel registration |
-+----------------------+--------------------------------------------------------------------+
-| | *x- and y-variable attributes* |
-+----------------------+--------------------------------------------------------------------+
-| long_name | Coordinate name (e.g., "Longitude" and "Latitude") |
-+----------------------+--------------------------------------------------------------------+
-| units | Unit of the coordinate (e.g., "degrees_east" and "degrees_north") |
-+----------------------+--------------------------------------------------------------------+
-| actual range | Minimum and maximum *x* and *y* of region; if absent the |
-| (or valid range) | first and last *x*- and *y*-values are queried |
-+----------------------+--------------------------------------------------------------------+
-| | *z-variable attributes* |
-+----------------------+--------------------------------------------------------------------+
-| long_name | Name of the variable (default: "z") |
-+----------------------+--------------------------------------------------------------------+
-| units | Unit of the variable |
-+----------------------+--------------------------------------------------------------------+
-| scale_factor | Factor to multiply *z* with (default: 1) |
-+----------------------+--------------------------------------------------------------------+
-| add_offset | Offset to add to scaled *z* (default: 0) |
-+----------------------+--------------------------------------------------------------------+
-| actual_range | Minimum and maximum *z* (in unpacked units, optional) and *z* |
-+----------------------+--------------------------------------------------------------------+
-| \_FillValue | Value associated with missing or invalid data points; if absent an |
-| (or missing_value) | appropriate default value is assumed, depending on data type. |
-+----------------------+--------------------------------------------------------------------+
-
-By default, the first 2-dimensional variable in a netCDF file will be read as
-the *z* variable and the coordinate axes *x* and *y* will be determined from
-the dimensions of the *z* variable. GMT will recognize whether the *y*
-(latitude) variable increases or decreases. Both forms of data storage are
-handled appropriately.
-
-For more information on the use of COARDS-compliant netCDF files, and on how
-to load multi-dimensional grids, read Section `Modifiers for COARDS-compliant netCDF files`_.
-
-Chunking and compression with netCDF
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-GMT supports reading and writing of netCDF-4 files since release 5.0. For
-performance reasons with ever-increasing grid sizes, the default output format
-of GMT is netCDF-4 with chunking enabled for grids with more than 16384 cells.
-Chunking means that the data is not stored sequentially in rows along latitude
-but rather split up into tiles. Figure :ref:`netcdf_chunking` illustrates
-the layout in a chunked netCDF file. To access a subset of the data (e.g.,
-the four blue tiles in the lower left), netCDF only reads those tiles
-("chunks") instead of extracting data from long rows.
-
-.. _netcdf_chunking:
-
-.. figure:: /_images/GMT_chunking.*
- :align: center
-
- Grid split into 3 by 3 chunks
-
-Gridded datasets in the earth sciences usually exhibit a strong spatial
-dependence (e.g. topography, potential fields, illustrated by blue and white
-cells in Figure :ref:`netcdf_chunking`) and deflation can greatly reduce the
-file size and hence the file access time (deflating/inflating is faster than
-hard disk I/O). It is therefore convenient to deflate grids with spatial
-dependence (levels 1--3 give the best speed/size-tradeoff).
-
-You may control the size of the chunks of data and compression with the
-configuration parameters :ref:`IO_NC4_CHUNK_SIZE <IO_NC4_CHUNK_SIZE>`
-and :ref:`IO_NC 4_DEFLATION_LEVEL <IO_NC4_DEFLATION_LEVEL>` as specified in
-:doc:`gmt.conf` and you can check the netCDF format with :doc:`grdinfo`.
-
-Classic netCDF files were the de facto standard until netCDF 4.0 was released
-in 2008. Most programs supporting netCDF by now are using the netCDF-4
-library and are thus capable of reading netCDF files generated with GMT 5,
-this includes official GMT releases since revision 4.5.8. In rare occasions,
-when you have to load netCDF files with old software, you may be forced to
-export your grids in the old classic format. This can be achieved by setting
-:ref:`IO_NC4_CHUNK_SIZE <IO_NC4_CHUNK_SIZE>` to **c**\ lassic.
-
-Further reading:
-
-- `Unidata NetCDF Workshop: NetCDF Formats and Performance <http://www.unidata.ucar.edu/software/netcdf/workshops/most-recent/performance/index.html>`_
-- `Unidata NetCDF Workshop: What is Chunking? <http://www.unidata.ucar.edu/software/netcdf/workshops/most-recent/nc4chunking/WhatIsChunking.html>`_
-- `HDF NetCDF-4 Performance Report <http://www.hdfgroup.org/pubs/papers/2008-06_netcdf4_perf_report.pdf>`_
-
-Gridline and Pixel node registration
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Scanline format means that the data are stored in rows (*y* = constant)
-going from the "top" (:math:`y = y_{max}` (north)) to the "bottom"
-(:math:`y = y_{min}` (south)). Data within each row are ordered from
-"left" (:math:`x = x_{min}` (west)) to "right" (:math:`x = x_{max}`
-(east)). The *registration* signals how the nodes are laid out. The grid
-is always defined as the intersections of all
-*x* ( :math:`x = x_{min}, x_{min} + x_{inc}, x_{min} + 2 \cdot x_{inc}, \ldots, x_{max}` )
-and *y* ( :math:`y = y_{min}, y_{min} + y_{inc}, y_{min} + 2 \cdot y_{inc}, \ldots, y_{max}` )
-lines. The two scenarios differ as to which area each data point
-represents. The default node registration in GMT is gridline node
-registration. Most programs can handle both types, and for some programs
-like :doc:`grdimage` a pixel registered file
-makes more sense. Utility programs like
-:doc:`grdsample` and
-:doc:`grdproject` will allow you to
-convert from one format to the other;
-:doc:`grdedit` can make changes to the grid
-header and convert a pixel- to a gridline-registered grid, or *vice
-versa*. The grid registration is determined by the common GMT **-r**
-option (see Section `Grid registration: The -r option`_).
-
-Boundary Conditions for operations on grids
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-GMT has the option to specify boundary conditions in some programs
-that operate on grids (e.g.,
-:doc:`grdsample`, :doc:`grdgradient`,
-:doc:`grdtrack`, :doc:`nearneighbor`, and
-:doc:`grdview`, to name a few. The desired
-condition can be set with the common GMT option **-n**; see Section
-`Grid interpolation parameters: The -n option`_. The boundary conditions come into play when
-interpolating or computing derivatives near the limits of the region
-covered by the grid. The *default* boundary conditions used are those
-which are "natural" for the boundary of a minimum curvature
-interpolating surface. If the user knows that the data are periodic in
-*x* (and/or *y*), or that the data cover a sphere with *x*,\ *y*
-representing *longitude*,\ *latitude*, then there are better choices for
-the boundary conditions. Periodic conditions on *x* (and/or *y*) are
-chosen by specifying *x* (and/or *y*) as the boundary condition flags;
-global spherical cases are specified using the *g* (geographical) flag.
-Behavior of these conditions is as follows:
-
-Periodic
- conditions on *x* indicate that the data are periodic in the
- distance (:math:`x_{max} - x_{min}`) and thus repeat values after
- every :math:`N = (x_{max} - x_{min})/x_{inc}`. Note that this
- implies that in a grid-registered file the values in the first and
- last columns are equal, since these are located at
- :math:`x = x_{min}` and :math:`x = x_{max}`, and there are
- *N + 1* columns in the file. This is not the case in a
- pixel-registered file, where there are only *N* and the first
- and last columns are located at :math:`x_{min} + x_{inc}/2` and
- :math:`x_{max} - x_{inc}/2`. If *y* is periodic all the same
- holds for *y*.
-
-Geographical
- conditions indicate the following:
-
- #. If :math:`(x_{max} - x_{min}) \geq 360` and also 180 modulo
- :math:`x_{inc} = 0` then a periodic condition is used on
- *x* with a period of 360; else a default condition is used
- on the *x* boundaries.
-
- #. If condition 1 is true and also :math:`y_{max} = 90` then a
- "north pole condition" is used at :math:`y_{max}`, else a default
- condition is used there.
-
- #. If condition 1 is true and also :math:`y_{min} = -90` then a
- "south pole condition" is used at :math:`y_{min}`, else a default
- condition is used there.
-
- "Pole conditions" use a 180º phase-shift of the data, requiring 180
- modulo :math:`x_{inc} = 0`.
-
-Default
- boundary conditions are
-
- .. math:: \nabla^2 f = \frac{\partial}{\partial n} \nabla^2 f = 0
-
- on the boundary, where :math:`f(x, y)` is represented by the values
- in the grid file, and :math:`\partial/\partial n` is the derivative
- in the direction normal to a boundary, and
-
- .. math:: \nabla^2 = \left(\frac{\partial^2}{\partial x^2} + \frac{\partial^2}{\partial y^2}\right)
-
- is the two-dimensional Laplacian operator.
-
-Native binary grid files
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-The old style native grid file format that was common in earlier version
-of GMT is still supported, although the use of netCDF files is
-strongly recommended. The file starts with a header of 892 bytes
-containing a number of attributes defining the content. The
-:doc:`grdedit` utility program will allow you
-to edit parts of the header of an existing grid file. The attributes
-listed in Table :ref:`grdheader <tbl-grdheader>` are contained within the header record
-in the order given (except the *z*-array which is not part of the
-header structure, but makes up the rest of the file). As this header was
-designed long before 64-bit architectures became available, the jump
-from the first three integers to the subsequent doubles in the structure
-does not occur on a 16-byte alignment. While GMT handles the reading
-of these structures correctly, enterprising programmers must take care
-to read this header correctly (see our code for details).
-
-.. _tbl-grdheader:
-
-+---------------------------------+--------------------------------------------------------+
-| **Parameter** | **Description** |
-+=================================+========================================================+
-| **int** *nx* | Number of nodes in the *x*-dimension |
-+---------------------------------+--------------------------------------------------------+
-| **int** *ny* | Number of nodes in the *y*-dimension |
-+---------------------------------+--------------------------------------------------------+
-| **int** *registration* | 0 for grid line registration, 1 for pixel registration |
-+---------------------------------+--------------------------------------------------------+
-| **double** *x_min* | Minimum *x*-value of region |
-+---------------------------------+--------------------------------------------------------+
-| **double** *x_max* | Maximum *x*-value of region |
-+---------------------------------+--------------------------------------------------------+
-| **double** *y_min* | Minimum *y*-value of region |
-+---------------------------------+--------------------------------------------------------+
-| **double** *y_max* | Maximum *y*-value of region |
-+---------------------------------+--------------------------------------------------------+
-| **double** *z_min* | Minimum *z*-value in data set |
-+---------------------------------+--------------------------------------------------------+
-| **double** *z_max* | Maximum *z*-value in data set |
-+---------------------------------+--------------------------------------------------------+
-| **double** *x_inc* | Node spacing in *x*-dimension |
-+---------------------------------+--------------------------------------------------------+
-| **double** *y_inc* | Node spacing in *y*-dimension |
-+---------------------------------+--------------------------------------------------------+
-| **double** *z_scale_factor* | Factor to multiply *z*-values after read |
-+---------------------------------+--------------------------------------------------------+
-| **double** *z_add_offset* | Offset to add to scaled *z*-values |
-+---------------------------------+--------------------------------------------------------+
-| **char** *x_units*\ [80] | Units of the *x*-dimension |
-+---------------------------------+--------------------------------------------------------+
-| **char** *y_units*\ [80] | Units of the *y*-dimension |
-+---------------------------------+--------------------------------------------------------+
-| **char** *z_units*\ [80] | Units of the *z*-dimension |
-+---------------------------------+--------------------------------------------------------+
-| **char** *title*\ [80] | Descriptive title of the data set |
-+---------------------------------+--------------------------------------------------------+
-| **char** *command*\ [320] | Command line that produced the grid file |
-+---------------------------------+--------------------------------------------------------+
-| **char** *remark*\ [160] | Any additional comments |
-+---------------------------------+--------------------------------------------------------+
-| **TYPE** *z*\ [nx\*ny] | 1-D array with *z*-values in scanline format |
-+---------------------------------+--------------------------------------------------------+
-
-Sun raster files
-----------------
-
-The Sun raster file format consists of a header followed by a series of
-unsigned 1-byte integers that represents the bit-pattern. Bits are
-scanline oriented, and each row must contain an even number of bytes.
-The predefined 1-bit patterns in GMT have dimensions of 64 by 64, but
-other sizes will be accepted when using the **-Gp|P** option. The Sun
-header structure is outline in Table :ref:`sunheader <tbl-sunheader>`.
-
-.. _tbl-sunheader:
-
-+---------------------------+-------------------------------------+
-| **Parameter** | **Description** |
-+===========================+=====================================+
-| **int** *ras_magic* | Magic number |
-+---------------------------+-------------------------------------+
-| **int** *ras_width* | Width (pixels) of image |
-+---------------------------+-------------------------------------+
-| **int** *ras_height* | Height (pixels) of image |
-+---------------------------+-------------------------------------+
-| **int** *ras_depth* | Depth (1, 8, 24, 32 bits) of pixel |
-+---------------------------+-------------------------------------+
-| **int** *ras_length* | Length (bytes) of image |
-+---------------------------+-------------------------------------+
-| **int** *ras_type* | Type of file; see RT\_ below |
-+---------------------------+-------------------------------------+
-| **int** *ras_maptype* | Type of colormap; see RMT\_ below |
-+---------------------------+-------------------------------------+
-| **int** *ras_maplength* | Length (bytes) of following map |
-+---------------------------+-------------------------------------+
-
-After the header, the color map (if *ras_maptype* is not RMT_NONE)
-follows for *ras_maplength* bytes, followed by an image of
-*ras_length* bytes. Some related definitions are given in
-Table :ref:`sundef <tbl-sundef>`.
-
-.. _tbl-sundef:
-
-+---------------------+-------------------------------------------+
-| **Macro name** | **Description** |
-+=====================+===========================================+
-| RAS_MAGIC | 0x59a66a95 |
-+---------------------+-------------------------------------------+
-| RT_STANDARD | 1 (Raw pixrect image in 68000 byte order) |
-+---------------------+-------------------------------------------+
-| RT_BYTE_ENCODED | 2 (Run-length compression of bytes) |
-+---------------------+-------------------------------------------+
-| RT_FORMAT_RGB | 3 ([X]RGB instead of [X]BGR) |
-+---------------------+-------------------------------------------+
-| RMT_NONE | 0 (ras_maplength is expected to be 0) |
-+---------------------+-------------------------------------------+
-| RMT_EQUAL_RGB | 1 (red[ras_maplength/3],green[],blue[]) |
-+---------------------+-------------------------------------------+
-
-Numerous public-domain programs exist, such as **xv** and
-**convert** (in the GraphicsMagick or ImageMagick package), that will translate between
-various raster file formats such as tiff, gif, jpeg, and Sun raster.
-Raster patterns may be created with GMT plotting tools by generating
-PostScript plots that can be rasterized by ghostscript and
-translated into the right raster format.
-
-.. _include-gmt-graphics:
-
-C. Including GMT Graphics into your Documents
-=============================================
-
-
-Now that you made some nice graphics with GMT, it is time to add them
-to a document, an article, a report, your dissertation, a poster, a web
-page, or a presentation. Of course, you could try the old-fashioned
-scissors and glue stick. More likely, you want to incorporate your
-graphics electronically into the document. Depending on the application,
-the GMT PostScript file will need to be converted to Encapsulated
-PostScript (EPS), Portable Document Format (PDF), or some raster
-format (e.g., JPEG, PNG, or TIFF) in order to incorporate them into the
-document.
-
-- When creating a document intended for printing (article,
- dissertation, or poster) it is best to preserve the scalable vector
- characteristics of the PostScript file. Many applications can
- directly incorporate PostScript in the form of EPS files. Modern
- programs will often allow the inclusion of PDF files. Either way, the
- sharpness of lines and fonts will be preserved and can be scaled up
- or down as required.
-
-- When the aim is to display the graphics on a computer screen or
- present it using a projector, it is wise to convert the
- PostScript into a raster format. Although applications like
- PowerPoint can do this for you, you can best take the
- conversion into your own hands for the best results.
-
-A large number of questions to the GMT-Help mailing list are related to
-these rendering issues, showing that something as seemingly
-straightforward as incorporating a PostScript file into a document is
-a far from trivial exercise. This Appendix will show how to include
-GMT graphics into documents and how to achieve the best quality results.
-
-Making GMT Encapsulated PostScript Files
-------------------------------------------
-
-GMT produces freeform PostScript files. Note that a freeform
-PostScript file may contain special operators (such as
-``Setpagedevice``) that is specific to printers (e.g., selection of
-paper tray). Some previewers (among them, Sun's pageview) may not
-understand these valid instructions and may fail to image the file.
-Also, embedding freeform PostScript with such instructions in it into
-a larger document can cause printing to fail. While you could choose
-another viewer (we recommend **ghostview**) to view single plots
-prepared by GMT, it is generally wiser to convert PostScript to EPS
-output when you are creating a plot intended for inclusion into a larger
-document. Some programs (and some publishers as well) do not allow the
-use of instructions like ``Setpagedevice`` as part of embedded graphics.
-
-An EPS file that is to be placed into another document needs to have
-correct bounding box parameters. These are found in the
-PostScript Document Comment %%BoundingBox. Applications that generate
-EPS files should set these parameters correctly. Because GMT\ makes
-the PostScript files on the fly, often with several overlays, it is
-not possible to do so accurately. Therefore, if you need and EPS version
-with a "tight" BoundingBox you need to post-process your
-PostScript file. There are several ways in which this can be
-accomplished.
-
-- Programs such as Adobe Illustrator, Aldus Freehand, and
- Corel Draw will allow you to edit the BoundingBox graphically.
-
-- A command-line alternative is to use freely-available program
- **epstool** from the makers of Aladdin ghostscript. Running
-
- ::
-
- epstool -c -b myplot.ps
-
- should give a tight BoundingBox; **epstool** assumes the plot is
- page size and not a huge poster.
-
-- Another option is to use **ps2epsi** which also comes with the
- ghostscript package. Running
-
- ::
-
- ps2epsi myplot.ps myplot.eps
-
- should also do the trick. The downside is that this program adds an
- "image" of the plot in the preamble of the EPS file, thus increasing
- the file size significantly. This image is a rough rendering of your
- PostScript graphics that some programs will show on screen while
- you are editing your document. This image is basically a placeholder
- for the PostScript graphics that will actually be printed.
-
-- However, the preferred option is to use the GMT utility
- :doc:`ps2raster`. Its **-A** option will
- figure out the tightest BoundingBox, again using ghostscript in
- the background. For example, running
-
- ::
-
- ps2raster -A -Te myplot.ps
-
- will convert the PostScript file ``myplot.ps`` into an encapsulated
- PostScript file ``myplot.eps`` which is exactly cropped to the tightest possible
- BoundingBox.
-
-If you do not want to modify your illustration but just include it in a
-text document: many word processors (such as Microsoft Word or Apple Pages) will let you include a
-PostScript file that you may place but not edit. Newer versions of
-those programs also allow you to include PDF versions of your graphics.
-Except for Pages, you will not be able to view the figure
-on-screen, but it will print correctly.
-
-Converting GMT PostScript to PDF or raster images
----------------------------------------------------
-
-Since Adobe's PDF (Portable Document Format) seems to have become the
-*de facto* standard for vector graphics, you are often well off
-converting GMT produced PostScript files to PDF. Being both vector
-formats (i.e., they basically describe all objects, text and graphics as
-lines and curves), such conversion sounds awfully straightforward and
-not worth a full section in this document. But experience has shown
-differently, since most converters cut corners by using the same tool
-(Aladdin's ghostscript) with basic default options that are not
-devised to produce the best quality PDF files.
-
-For some applications it is practical or even essential that you convert
-your PostScript file into a raster format, such as GIF (Graphics
-Interchange Format), TIFF (Tagged Image File Format), PNG (Portable
-Network Graphics), or JPEG (Joint Photographic Experts Group). A web
-page is better served with a raster image that will immediately show on
-a web browser, than with a PostScript file that needs to be downloaded
-to view, despite the better printing quality of the PostScript image.
-A less obvious reason to convert your image to a raster format is to
-by-pass PowerPoint's rendering engine in case you want to embed
-the image into a presentation.
-
-The are a number of programs that will convert PostScript files to PDF
-or raster formats, like Aladdin's **pstopdf**, pbmplus' **pstoimg**,
-or GraphicsMagick's and ImageMagick's **convert**, most of which run ghostscript
-behind the scenes. The same is true for viewers like **ghostview** and
-Apple's Preview*. So a lot of the times when people report that
-their PostScript plot does not look right but prints fine, it is the
-way ghostscript is used with its most basic settings that is to blame.
-
-When converting or viewing PostScript goes awry
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Here are some notorious pitfalls with ghostscript (and other
-rendering programs for that matter).
-
-Rendering.
- When you are converting to a raster format, make sure you use a high
- enough resolution so that the pixels do not show when it is enlarged
- onto a screen or using a projector. The right choice of resolution
- depends on the application, but do not feel limited to the default
- 72 dpi (dots-per-inch) that is offered by most converters.
-
-Image compression.
- There are *lossy* and *non-lossy* compressions. A compression
- algorithm is called "lossy" when information is lost in the
- conversion: there is no way back to get the full original. The
- effect can be seen when there are sharp color transitions in your
- image: the edges will get blurry in order to allow a more efficient
- compression. JPEG uses a lossy compression, PNG is non-lossy, and
- TIFF generally does not use compression at all. We therefore
- recommend you convert to PNG if you need to rasterize your plot, and
- leave JPEG to photographs.
-
-Embedded image compression.
- When your GMT plot includes objects produced by
- :doc:`grdimage`, :doc:`psimage` or
- :doc:`pslegend`, they are seen as
- "images". The default options of ghostscript will use a
- *lossy* compression (similar to JPEG) on those images when
- converting them to PDF objects. This can be avoided, however, by
- inhibiting the compression altogether, or using the non-lossy
- *flate* compression, similar to the one used in the old
- **compress** program. This compression is fully reversible, so
- that your image does not suffer any loss.
-
-Auto-rotation.
- The ghostscript engine has the annoying habit to automatically
- rotate an image produced with portrait orientation (using the **-P**
- option) so that the height is always larger than the width. So if
- you have an image that was printed in portrait mode but happens to
- have a width larger than height (for example a global map), it would
- suddenly get rotated. Again, this function needs to be switched off.
- Apple's Preview uses the ghostscript engine and suffers
- from the same annoying habit. Oddly enough, ghostscript does
- not force landscape plots to be "horizontal".
-
-Anti-aliasing.
- This is not something to worry about when converting to PDF, but
- certainly when producing raster images (discussed below).
- *Anti-aliasing* in this context means that the rendering tries to
- avoid *aliasing*, for example, sampling only the blacks in a
- black-and-white hachure. It does so by first oversampling the image
- and then using "gray-shades" when a target pixel is only partially
- white or black.
-
- Clearly, this can lead to some unwanted results. First, all edges
- and lines get blurry and second, the assumption of a white
- background causes the gray shades to stand out when transferring the
- image to background with a different color (like the popular
- sleep-inducing blue in PowerPoint presentations). A more
- surprising effect of anti-aliasing is that the seams between tiles
- that make up the land mask when using
- :doc:`pscoast` will become visible. The
- anti-aliasing somehow decides to blur the edges of all polygons,
- even when they are seamlessly connected to other polygons.
-
- It is therefore wise to overrule the default anti-aliasing option
- and over-sample the image yourself by choosing a higher resolution.
-
-Including fonts.
- When you are producing print-ready copy to publishers, they will
- often (and justifiably) ask that you include all fonts in your PDF
- document. Again, ghostscript (and all converters relying on
- that engine) will not do so by default.
-
-Using :doc:`ps2raster`
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The remedy to all the problems mentioned in the previous section is
-readily available to you in the form of the GMT utility
-:doc:`ps2raster`. It is designed to provide
-the best quality PDF and raster files using ghostscript as a
-rendering engine. The program :doc:`ps2raster` avoids anti-aliasing and
-lossy compression techniques that are default to ghostscript and
-includes the fonts into the resulting PDF file to ensure portability. By
-default the fonts are rendered at 720 dots-per-inch in a PDF file and
-images are sampled to 300 dpi, but that can be changed with the **-E**
-option. Simply run
-
- ::
-
- gmt ps2raster -A -P -Tf *.ps
-
-to convert all PostScript files to PDF while cropping it to the
-smallest possible BoundingBox. Or use the **-Tg** option to convert your
-files to PNG.
-
-The **-P** option of :doc:`ps2raster` may
-also come in handy. When you have *not* supplied the **-P** option in
-your first GMT plot command, your plot will be in Landscape mode. That
-means that the plot will be rotated 90º (anti-clockwise) to fit
-on a Portrait mode page when coming out of the printer. The **-P**
-option of :doc:`ps2raster` will undo that
-rotation, so that you do not have to do so within your document. This
-will only affect Landscape plots; Portrait plots will not be rotated.
-
-Examples
---------
-
-GMT graphics in LaTeX
-~~~~~~~~~~~~~~~~~~~~~
-
-Nearly all illustrations in this GMT documentation were GMT-produced
-PostScript files. They were converted to PDF files using
-:doc:`ps2raster` and then included into a
-LaTeX document that was processed with **pdflatex** to create the PDF
-document you are reading.
-
-To add the graphics into the LaTeX document we use the
-``\includegraphics`` command supplied by the package. In the preamble of
-your LaTeX document you will need to include the line
-
- ::
-
- \usepackage{graphicx}
-
-The inclusion of the graphics will probably be inside a floating figure
-environment; something like this
-
- ::
-
- \begin{figure}
- \includegraphics{myplot}
- \caption{This is my first plot in \LaTeX.}
- \label{fig:myplot}
- \end{figure}
-
-Note that the ``\includegraphics`` command does not require you to add
-the suffix ``.pdf`` to the file name. If you run **pdflatex**, it will
-look automatically for ``myplot.pdf``. If you run **latex**, it will use ``myplot.eps`` instead.
-
-You can scale your plot using the options ``width=``, ``height=``, or
-``scale=``. In addition, if your original graphics was produced in
-Landscape mode (i.e., you did *not* use GMT's **-P** option: not
-while plotting, nor in :doc:`ps2raster`),
-you will need to rotate the plot as well. For example,
-
- ::
-
- \includegraphics[angle=-90,width=0.8\textwidth]{myplot}
-
-will rotate the image 90º clockwise and scale it such that its width
-(after rotation) will be 80% of the width of the text column.
-
-GMT graphics in **PowerPoint**
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. _Rendering:
-
-.. figure:: /_images/rendering.png
- :height: 540 px
- :width: 720 px
- :align: center
- :scale: 50 %
-
- Examples of rendered images in a PowerPoint presentation
-
-
-.. _PowerPoint_dialogue:
-
-.. figure:: /_images/formatpicture.png
- :height: 516 px
- :width: 545 px
- :align: center
- :scale: 50 %
-
- PowerPoint's Format Picture dialogue to set scale and rotation.
-
-In Figure :ref:`Rendered images <Rendering>` we have attempted to include
-Figure :ref:`Example 20 <Fig_example_20>` into a PowerPoint presentation.
-First the PostScript file was converted to PDF (using
-:doc:`ps2raster`), then loaded into
-PowerPoint and the white background color was made transparent
-using the formatting toolbar (shown on the left side of
-Figure :ref:`Rendered images <Rendering>`). Clearly, when we let PowerPoint
-do the rendering, we do not get the best result:
-
-* The anti-aliasing causes the tiles that make up the land to stand
- out. This is because the anti-aliasing algorithm blurs all edges,
- even when the tiles join seamlessly.
-
-* The background color was assumed to be white, hence the text is
- "smoothed" using gray shades. Instead, shades of blue which would be
- appropriate for the background we are using.
-
-On the central column of Figure :ref:`Rendered images <Rendering>` we have
-included PNG
-versions of a portion of the same example. This shows the workings of
-anti-aliasing and different resolutions. All samples were obtained with
-**convert**. The one on the top uses all default settings, resulting
-in an anti-aliased image at 72 dpi resolution (very much like the PDF
-included directly into PowerPoint).
-
-Just switching anti-aliasing off (middle) is clearly not an option
-either. It is true that we got rid of the gray blurring and the seams
-between the tiles, but without anti-aliasing the image becomes very
-blocky. The solution is to render the image at a higher resolution
-(e.g., 300 dpi) without anti-aliasing and then shrink the image to the
-appropriate size (bottom of the central column in
-Figure :ref:`Rendered images <Rendering>`). The scaling, rotation as well as
-the selection
-of the transparent color can be accomplished through the "Formatting"
-tool bar and the "Format Picture" dialogue box of PowerPoint
-(Figure :ref:`PowerPoint dialogue box <PowerPoint_dialogue>`), which can be
-found by double clicking the
-included image (or selecting and right-clicking or control-clicking on a
-one-button mouse).
-
-Concluding remarks
-------------------
-
-These examples do not constitute endorsements of the products mentioned
-above; they only represent our limited experience with adding
-PostScript to various types of documents. For other solutions and
-further help, please post messages to.
-
-E. Predefined Bit and Hachure Patterns in GMT
-=============================================
-
-
-GMT provides 90 different bit and hachure patterns that can be
-selected with the **-Gp** or **-GP** option in most plotting programs.
-The left side of each image was created using **-Gp**, the right side
-shows the inverted version using **-GP**. These patterns are reproduced
-below at 300 dpi using the default black and white shades.
-
-.. figure:: /_images/GMT_App_E.*
- :width: 500 px
- :align: center
-
-
-F. Chart of Octal Codes for Characters
-======================================
-
-The characters and their octal codes in the Standard and ISOLatin1
-encoded fonts are shown in
-Figure :ref:`Octal codes for Standard and ISO <Octal_codes_stand_iso>`. Light red areas signify
-codes reserved for control characters. In order to use all the extended
-characters (shown in the light green boxes) you need to set
-:ref:`PS_CHAR_ENCODING <PS_CHAR_ENCODING>` to Standard+ or ISOLatin1+ in your :doc:`gmt.conf` file [32]_.
-
-.. _Octal_codes_stand_iso:
-
-.. figure:: /_images/GMT_App_F_stand+_iso+.*
- :width: 500 px
- :align: center
-
- Octal codes and corresponding symbols for StandardEncoding (left) and ISOLatin1Encoding (right) fonts.
-
-The chart for the Symbol character set (GMT font number 12) and Pifont
-ZapfDingbats character set (font number 34) are presented in
-Figure :ref:`Octal codes for Symbol and ZapfDingbats <Octal_codes_symbol_zap>` below. The octal code
-is obtained by appending the column value to the \\??
-value, e.g., :math:`\partial` is \\266 in the Symbol
-font. The euro currency symbol is \\240 in the Symbol
-font and will print if your printer supports it (older printer's
-firmware will not know about the euro).
-
-.. _Octal_codes_symbol_zap:
-
-.. figure:: /_images/GMT_App_F_symbol_dingbats.*
- :width: 500 px
- :align: center
-
- Octal codes and corresponding symbols for Symbol (left) and ZapfDingbats (right) fonts.
-
-
-G. PostScript Fonts Used by GMT
-=================================
-
-GMT uses the standard 35 fonts that come with most
-PostScript laserwriters. If your printer does not support some of
-these fonts, it will automatically substitute the default font (which is
-usually Courier). The following is a list of the GMT fonts:
-
-.. figure:: /_images/GMT_App_G.*
- :width: 500 px
- :align: center
-
- The standard 35 PostScript fonts recognized by GMT.
-
-
-For the special fonts Symbol (12) and ZapfDingbats (34), see the octal
-charts in Appendix [app:F]. When specifying fonts in GMT, you can
-either give the entire font name *or* just the font number listed in
-this table. To change the fonts used in plotting basemap frames, see the
-man page for :doc:`gmt.conf`. For direct
-plotting of text-strings, see the man page for :doc:`pstext`.
-
-Using non-default fonts with GMT
---------------------------------
-
-To add additional fonts that you may have purchased or that are
-available freely in the internet or at your institution, see the
-instructions in the ``CUSTOM_font_info.d`` under the ``share/pslib`` directory and continue reading. GMT does
-not read or process any font files and thus does not know anything about
-installed fonts and their metrics. In order to use extra fonts in
-GMT you need to specify the PostScript name of the relevant fonts in
-the file ``CUSTOM_font_info.d``. You can either edit the existing file distributed with
-GMT to make the changes global or you can create a new file in the
-current working directory, e.g.,
-
- ::
-
- LinBiolinumO 0.700 0
- LinLibertineOB 0.700 0
-
-The format is a space delimited list of the PostScript font name, the
-font height-point size-ratio, and a boolean variable that tells GMT to
-re-encode the font (if set to zero). The latter has to be set to zero as
-additional fonts will most likely not come in standard
-PostScript encoding. GMT determines how tall typical annotations
-might be from the font size ratio so that the vertical position of
-labels and titles can be adjusted to a more uniform typesetting. Now,
-you can set the GMT font parameters to your non-standard fonts:
-
- ::
-
- gmt set FONT LinBiolinumO \
- FONT_TITLE 28p,LinLibertineOB \
- PS_CHAR_ENCODING ISO-8859-1 \
- MAP_DEGREE_SYMBOL degree
-
-After setting the encoding and the degree symbol, the configuration part
-for GMT is finished and you can proceed to create GMT-maps as usual.
-An example script is discussed in Example [sec:non-default-fonts-example].
-
-Embedding fonts in PostScript and PDF
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-If you have Type 1 fonts in PFA (Printer Font ASCII) format you can
-embed them directly by copying them at the very top of your
-PostScript-file, before even the %!PS header comment. PFB (Printer
-Font Binary), TrueType or OpenType fonts cannot be embedded in
-PostScript directly and therefore have to be converted to PFA first.
-
-However, you most likely will have to tell Ghostscript where to
-find your custom fonts in order to convert your GMT-PostScript-plot
-to PDF or an image with :doc:`ps2raster`.
-When you have used the correct PostScript-names of the fonts in ``CUSTOM_font_info.d`` you
-only need to point the ``GS_FONTPATH`` environment variable to the
-directory where the font files can be found and invoke
-:doc:`ps2raster` in the usual way. Likewise
-you can specify Ghostscript's ``-sFONTPATH`` option on the
-command line with ``C -sFONTPATH=/path/to/fontdir``. Ghostscript,
-which is invoked by :doc:`ps2raster`, does
-not depend on file names. It will automatically find the relevant font
-files by their PostScript-names and embed and subset them in
-PDF-files. This is quite convenient as the document can be displayed and
-printed even on other computers when the font is not available locally.
-There is no need to convert your fonts as Ghostscript can handle
-all Type 1, TrueType and OpenType fonts. Note also, that you do not need
-to edit Ghostscript's Fontmap.
-
-If you do not want or cannot embed the fonts you can convert them to
-outlines (shapes with fills) with Ghostscript in the following
-way:
-
- ::
-
- gs -q -dNOCACHE -dSAFER -dNOPAUSE -dBATCH -dNOPLATFONTS \
- -sDEVICE=pswrite -sFONTPATH="/path/to/fontdir" \
- -sOutputFile=mapWithOutlinedFonts.ps map.ps
-
-Note, that this only works with the *pswrite* device. If you need
-outlined fonts in PDF, create the PDF from the converted
-PostScript-file. Also, :doc:`ps2raster`
-cannot correctly crop Ghostscript converted PostScript-files
-anymore. Use Heiko Oberdiek's instead or crop with
-:doc:`ps2raster` **-A** **-Te** before (See
-Example [sec:non-default-fonts-example]).
-
-Character encoding
-~~~~~~~~~~~~~~~~~~
-
-Since PostScript itself does not support Unicode fonts,
-Ghostscript will re-encode the fonts on the fly. You have to make
-sure to set the correct :ref:`PS_CHAR_ENCODING <PS_CHAR_ENCODING>`
-with :doc:`gmtset` and save your
-script file with the same character encoding. Alternatively, you can
-substitute all non ASCII characters with their corresponding octal
-codes, e.g., \\265 instead of μ. Note, that PostScript fonts support
-only a small range of glyphs and you may have to switch the
-:ref:`PS_CHAR_ENCODING <PS_CHAR_ENCODING>` within your script.
-
-H. Color Space: The Final Frontier
-==================================
-
-
-In this Appendix, we are going to try to explain the relationship
-between the RGB, CMYK, and HSV color systems so as to (hopefully) make
-them more intuitive. GMT allows users to specify colors in CPT files
-in either of these three systems. Interpolation between colors is
-performed in either RGB or HSV, depending on the specification in the
-CPT file. Below, we will explain why this all matters.
-
-RGB color system
-----------------
-
-Remember your (parents') first color television set? Likely it had three
-little bright colored squares on it: red, green, and blue. And that is
-exactly what each color on the tube is made of: varying levels of red,
-green and blue light. Switch all of them off, *r=g=b=0*, then you
-have black. All of them at maximum, *r=g=b=255*, creates white.
-Your computer screen works the same way.
-
-A mix of levels of red, green, and blue creates basically any color
-imaginable. In GMT each color can be represented by the triplet
-*r7g7b*. For example, 127/255/0 (half red, full
-green, and no blue) creates a color called chartreuse. The color sliders
-in the graphics program GIMP are an excellent way to experiment
-with colors, since they show you in advance how moving one of the color
-sliders will change the color. As Figure :ref:`Chartreuse in GIMP <GIMP>`\ *a*
-shows: increase
-the red and you will get a more yellow color, while lowering the blue
-level will turn it into brown.
-
-.. _GIMP:
-
-.. figure:: /_images/gimp-sliders+panel.png
- :height: 230 px
- :width: 775 px
- :align: center
- :scale: 75 %
-
- Chartreuse in GIMP. *(a)* Sliders indicate how the color is altered
- when changing the H, S, V, R, G, or B levels. *(b)* For a constant hue (here 90)
- value increases to the right and saturation increases up, so the pure
- color is on the top right.
-
-
-Is chocolate your favorite color, but you do not know the RGB equivalent
-values? Then look them up in Figure :ref:`RGB chart <RGBchart>` or type
-``man gmtcolors`` for a full list. It's 210/105/30. But GMT makes it easy
-on you: you can specify pen, fill, and palette colors by any of the more
-than 500 unique colors found in that file.
-
-Are you very web-savvy and work best with hexadecimal color codes as
-they are used in HTML? Even that is allowed in GMT. Just start with a
-hash mark (``#``) and follow with the 2 hexadecimal characters for red,
-green, and blue. For example, you can use ``#79ff00`` for chartreuse,
-``#D2691E`` for chocolate.
-
-.. _RGBchart:
-
-.. figure:: /_images/GMT_RGBchart_a4.*
- :width: 700 px
- :align: center
-
- The 555 unique color names that can be used in GMT. Lower, upper, or mixed cases, as well as
- the british spelling of grey are allowed. A4, Letter, and Tabloid sized versions of this RGB chart can be
- found in the GMT documentation directory.
-
-
-HSV color system
-----------------
-
-If you have played around with RGB color sliders, you will have noticed
-that it is not intuitive to make a chosen color lighter or darker, more
-saturated or more gray. It would involve changing three sliders. To make
-it easier to manipulate colors in terms of lightness and saturation,
-another coordinate system was invented: HSV (hue, saturation, value).
-Those terms can be made clear best by looking at the color sliders in
-Figure :ref:`Chartreuse in GIMP <GIMP>`\ *a*. Hue (running from 0 to 360) gives you the full
-spectrum of saturated colors. Saturation (from 0 to 1, or 100%) tells
-you how ‘full' your color is: reduce it to zero and you only have gray
-scales. Value (from 0 to 1, or 100%) will bring you from black to a
-fully saturated color. Note that "value" is not the same as "intensity",
-or "lightness", used in other color geometries. "Brilliance" may be the
-best alternative word to describe "value". Apple calls it as
-"brightness", and hence refers to HSB for this color space.
-
-Want more chartreuse or chocolate? You can specify them in GMT as
-90-1-1 and 25-0.86-0.82, respectively.
-
-The color cube
---------------
-
-We are going to try to give you a geometric picture of color mixing in
-RGB and HSV by means of a tour of the RGB cube depicted in
-Figure :ref:`Example 11 <Fig_example_11>`. The geometric picture is most
-helpful, we think, since HSV are not orthogonal coordinates and not
-found from RGB by a simple algebraic transformation. So here goes: Look
-at the cube face with black, red, magenta, and blue corners. This is the
-*g* = 0 face. Orient the cube so that you are looking at this face
-with black in the lower left corner. Now imagine a right-handed
-cartesian (*rgb*) coordinate system with
-origin at the black point; you are looking at the *g = 0* plane
-with *r* increasing to your right, *g* increasing away from
-you, and *b* increasing up. Keep this sense of (*rgb*) as you look at the cube.
-
-Now tip the cube such that the black corner faces down and the white
-corner up. When looking from the top, you can see the hue, contoured in
-gray solid lines, running around in 360º counter-clockwise. It starts
-with shades of red (0), then goes through green (120) and blue (240),
-back to red.
-
-On the three faces that are now on the lower side (with the white print)
-one of (*rgb*) is equal to 0. These three
-faces meet at the black corner, where *r = g = b = 0*. On these
-three faces the colors are fully saturated: *s = 1*. The dashed
-white lines indicate different levels of *v*, ranging from 0 to 1
-with contours every 0.1.
-
-On the upper three faces (with the black print), one of
-(*rgb*) is equal to the maximum value. These
-three faces meet at the white corner, where *r = g = b = 255*. On
-these three faces value is at its maximum: *v = 1* (or 100%). The
-dashed black lines indicate varying levels of saturation: *s*
-ranges from 0 to 1 with contours every 0.1.
-
-Now turn the cube around on its vertical axis (running from the black to
-the white corner). Along the six edges that zigzag around the "equator",
-both saturation and value are maximum, so *s = v = 1*. Twirling
-the cube around and tracing the zigzag, you will visit six of the eight
-corners of the cube, with changing hue (*h*): red (0), yellow
-(60), green (120), cyan (180), blue (240), and magenta (300). Three of
-these are the RGB colors; the other three are the CMY colors which are
-the complement of RGB and are used in many color hardcopy devices (see
-below). The only cube corners you did not visit on this path are the
-black and white corners. They lie on the vertical axis where hue is
-undefined and *r = g = b*. Any point on this axis is a shade of gray.
-
-Let us call the points where *s = v = 1* (points along the RYGCBM
-path described above) the "pure" colors. If we start at a pure color and
-we want to whiten it, we can keep *h* constant and *v = 1*
-while decreasing *s*; this will move us along one of the cube
-faces toward the white point. If we start at a pure color and we want to
-blacken it, we can keep *h* constant and *s = 1* while
-decreasing *v*; this will move us along one of the cube faces
-toward the black point. Any point in (*rgb*)
-space which can be thought of as a mixture of pure color + white, or
-pure color + black, is on a face of the cube.
-
-The points in the interior of the cube are a little harder to describe.
-The definition for *h* above works at all points in (non-gray)
-(*rgb*) space, but so far we have only
-looked at (*s*, *v*) on the cube faces, not inside it. At
-interior points, none of (*rgb*) is equal to
-either 0 or 255. Choose such a point, not on the gray axis. Now draw a
-line through your point so that the line intersects the gray axis and
-also intersects the RYGCBM path of edges somewhere. It is always
-possible to construct this line, and all points on this line have the
-same hue. This construction shows that any point in RGB space can be
-thought of as a mixture of a pure color plus a shade of gray. If we move
-along this line away from the gray axis toward the pure color, we are
-"purifying" the color by "removing gray"; this move increases the
-color's saturation. When we get to the point where we cannot remove any
-more gray, at least one of (*rgb*) will have
-become zero and the color is now fully saturated; *s = 1*.
-Conversely, any point on the gray axis is completely undersaturated, so
-that *s = 0* there. Now we see that the black point is special,
-*s* is both 0 and 1 at the same time. In other words, at the black
-point saturation in undefined (and so is hue). The convention is to use
-*h = s = v = 0* at this point.
-
-It remains to define value. To do so, try this: Take your point in RGB
-space and construct a line through it so that this line goes through the
-black point; produce this line from black past your point until it hits
-a face on which *v = 1*. All points on this line have the same
-hue. Note that this line and the line we made in the previous paragraph
-are both contained in the plane whose hue is constant. These two lines
-meet at some arbitrary angle which varies depending on which point you
-chose. Thus HSV is not an orthogonal coordinate system. If the line you
-made in the previous paragraph happened to touch the gray axis at the
-black point, then these two lines are the same line, which is why the
-black point is special. Now, the line we made in this paragraph
-illustrates the following: If your chosen point is not already at the
-end of the line, where *v = 1*, then it is possible to move along
-the line in that direction so as to increase
-(*rgb*) while keeping the same hue. The
-effect this has on a color monitor is to make the color more
-"brilliant", your hue will become "stronger"; if you are already on a
-plane where at least one of (*rgb*) = 255,
-then you cannot get a stronger version of the same hue. Thus, *v*
-measures brilliance or strength. Note that it is not quite true to say
-that *v* measures distance away from the black point, because
-*v* is not equal to :math:`\sqrt{r^2 + g^2 + b^2}/255`.
-
-Another representation of the HSV space is the color cone illustrated in
-Figure :ref:`hsv_cone`.
-
-.. _hsv_cone:
-
-.. figure:: /_images/hsv-cone.png
- :height: 508 px
- :width: 750 px
- :align: center
- :scale: 50 %
-
- The HSV color space
-
-Color interpolation
--------------------
-
-From studying the RGB cube, we hope you will have understood that there
-are different routes to follow between two colors, depending whether you
-are in the RGB or HSV system. Suppose you would make an interpolation
-between blue and red. In the RGB system you would follow a path
-diagonally across a face of the cube, from 0/0/255 (blue) via 127/0/127
-(purple) to 255/0/0 (red). In the HSV system, you would trace two edges,
-from 240-1-1 (blue) via 300-1-1 (magenta) to 360-1-1 (red). That is even
-assuming software would be smart enough to go the shorter route. More
-likely, red will be recorded as 0-1-1, so hue will be interpolated the
-other way around, reducing hue from 240 to 0, via cyan, green, and yellow.
-
-Depending on the design of your color palette, you may want to have it
-either way. By default, GMT interpolates in RGB space, even when the
-original color palette is in the HSV system. However, when you add the
-line ``#COLOR_MODEL=+HSV`` (with the leading ‘+' sign) in the header of
-the color palette file, GMT will not only read the color
-representation as HSV values, but also interpolate colors in the HSV
-system. That means that H, S, and V values are interpolated linearly
-between two colors, instead of their respective R, G, and B values.
-
-The top row in Figure :ref:`Interpolating colors <color_interpolate>`
-illustrates two examples: a blue-white-red scale (the palette in
-Appendix [app:M]) interpolated in RGB and the palette interpolated in
-HSV. The bottom row of the Figure demonstrates how things can go
-terribly wrong when you do the interpolation in the other system.
-
-.. _color_interpolate:
-
-.. figure:: /_images/GMT_color_interpolate.*
- :width: 500 px
- :align: center
-
- When interpolating colors, the color system matters. The polar palette on the left needs to
- be interpolated in RGB, otherwise hue will change between blue (240) and white (0). The rainbow
- palette should be interpolated in HSV, since only hue should change between magenta (300) and red (0).
- Diamonds indicate which colors are defined in the palettes; they are fixed, the rest is interpolated.
-
-
-Artificial illumination
------------------------
-
-GMT uses the HSV system to achieve artificial illumination of colored
-images (e.g., **-I** option in :doc:`grdimage`) by changing the saturation
-*s* and value *v* coordinates of the color. When the intensity is zero
-(flat illumination), the data are colored according to the CPT file. If
-the intensity is non-zero, the color is either lightened or darkened
-depending on the illumination. The color is first converted to HSV (if
-necessary) and then darkened by moving (*sv*) toward
-(:ref:`COLOR_HSV_MIN_S <COLOR_HSV_MIN_S>`, :ref:`COLOR_HSV_MIN_V <COLOR_HSV_MIN_V>`)
-if the intensity is negative, or lightened by sliding (*sv*) toward
-(:ref:`COLOR_HSV_MAX_S <COLOR_HSV_MAX_S>`, :ref:`COLOR_HSV_MAX_V <COLOR_HSV_MAX_V>`)
-if the illumination is positive. The extremes of the *s* and *v* are defined in the
-:doc:`gmt.conf` file and are usually chosen so the corresponding points are nearly black
-(*s = 1*, *v = 0*) and white (*s = 0*, *v = 1*).
-The reason this works is that the HSV system allows movements in color
-space which correspond more closely to what we mean by "tint" and
-"shade"; an instruction like "add white" is easy in HSV and not so
-obvious in RGB.
-
-Thinking in RGB or HSV
-----------------------
-
-The RGB system is understandable because it is cartesian, and we all
-learned cartesian coordinates in school. But it doesn't help us create a
-tint or shade of a color; we cannot say, "We want orange, and a lighter
-shade of orange, or a less vivid orange". With HSV we can do this, by
-saying, "Orange must be between red and yellow, so its hue is about
-*h = 30*; a less vivid orange has a lesser *s*, a darker
-orange has a lesser *v*". On the other hand, the HSV system is a
-peculiar geometric construction, more like a cone
-(Figure :ref:`hsv_cone`). It is not an orthogonal coordinate system, and
-it is not found by a matrix transformation of RGB; these make it
-difficult in some cases too. Note that a move toward black or a move
-toward white will change both *s* and *v*, in the general
-case of an interior point in the cube. The HSV system also doesn't
-behave well for very dark colors, where the gray point is near black and
-the two lines we constructed above are almost parallel. If you are
-trying to create nice colors for drawing chocolates, for example, you
-may be better off guessing in RGB coordinates.
-
-CMYK color system
------------------
-
-Finally, you can imagine that printers work in a different way: they mix
-different paints to make a color. The more paint, the darker the color,
-which is the reverse of adding more light. Also, mixing more colored
-paints does not give you true black, so that means that you really need
-four colors to do it right. Open up your color printer and you'll
-probably find four cartridges: cyan, magenta, yellow (often these are
-combined into one), and black. They form the CMYK system of colors, each
-value running from 0 to 1 (or 100%). In GMT CMYK color coding can be
-achieved using *c/m/y/k* quadruplets.
-
-Obviously, there is no unique way to go from the 3-dimensional RGB
-system to the 4-dimensional CMYK system. So, again, there is a lot of
-hand waving applied in the transformation. Strikingly, CMYK actually
-covers a smaller color space than RGB. We will not try to explain you
-the details behind it, just know that there is a transformation needed
-to go from the colors on your screen to the colors on your printer. It
-might explain why what you see is not necessarily what you get. If you
-are really concerned about how your color plots will show up in your PhD
-thesis, for example, it might be worth trying to save and print all your
-color plots using the CMYK system. Letting GMT do the conversion to
-CMYK may avoid some nasty surprises when it comes down to printing. To
-specify the color space of your PostScript file, set
-:ref:`PS_COLOR_MODEL <PS_COLOR_MODEL>` in the :doc:`gmt.conf` file to RGB, HSV, or CMYK.
-
-I. Filtering of Data in GMT
-===========================
-
-The GMT programs :doc:`filter1d` (for
-tables of data indexed to one independent variable) and
-:doc:`grdfilter` (for data given as
-2-dimensional grids) allow filtering of data by a moving-window process.
-(To filter a grid by Fourier transform use
-:doc:`grdfft`.) Both programs use an argument
-**-F**\ <\ *type*\ ><\ *width*> to specify the
-type of process and the window's width (in 1-D) or diameter (in 2-D).
-(In :doc:`filter1d` the width is a length of
-the time or space ordinate axis, while in
-:doc:`grdfilter` it is the diameter of a
-circular area whose distance unit is related to the grid mesh via the
-**-D** option). If the process is a median, mode, or extreme value
-estimator then the window output cannot be written as a convolution and
-the filtering operation is not a linear operator. If the process is a
-weighted average, as in the boxcar, cosine, and gaussian filter types,
-then linear operator theory applies to the filtering process. These
-three filters can be described as convolutions with an impulse response
-function, and their transfer functions can be used to describe how they
-alter components in the input as a function of wavelength.
-
-Impulse responses are shown here for the boxcar, cosine, and gaussian
-filters. Only the relative amplitudes of the filter weights shown; the
-values in the center of the window have been fixed equal to 1 for ease
-of plotting. In this way the same graph can serve to illustrate both the
-1-D and 2-D impulse responses; in the 2-D case this plot is a
-diametrical cross-section through the filter weights
-(Figure :ref:`Impulse responses <Impulse_responses>`).
-
-.. _Impulse_responses:
-
-.. figure:: /_images/GMT_App_J_1.*
- :width: 500 px
- :align: center
-
- Impulse responses for GMT filters.
-
-
-Although the impulse responses look the same in 1-D and 2-D, this is not
-true of the transfer functions; in 1-D the transfer function is the
-Fourier transform of the impulse response, while in 2-D it is the Hankel
-transform of the impulse response. These are shown in Figures
-:ref:`Transfer functions for 1D <GMT_1D_filters>` and
-:ref:`2D <GMT_2D_filters>`,
-respectively. Note that in 1-D the
-boxcar transfer function has its first zero crossing at *f = 1*,
-while in 2-D it is around :math:`f \sim 1.2`. The 1-D cosine transfer
-function has its first zero crossing at *f = 2*; so a cosine
-filter needs to be twice as wide as a boxcar filter in order to zero the
-same lowest frequency. As a general rule, the cosine and gaussian
-filters are "better" in the sense that they do not have the "side lobes"
-(large-amplitude oscillations in the transfer function) that the boxcar
-filter has. However, they are correspondingly "worse" in the sense that
-they require more work (doubling the width to achieve the same cut-off wavelength).
-
-.. _GMT_1D_filters:
-
-.. figure:: /_images/GMT_App_J_2.*
- :width: 500 px
- :align: center
-
- Transfer functions for 1-D GMT filters.
-
-
-One of the nice things about the gaussian filter is that its transfer
-functions are the same in 1-D and 2-D. Another nice property is that it
-has no negative side lobes. There are many definitions of the gaussian
-filter in the literature (see page 7 of Bracewell [33]_). We define
-:math:`\sigma` equal to 1/6 of the filter width, and the impulse
-response proportional to :math:`\exp[-0.5(t/\sigma)^2)`. With this
-definition, the transfer function is :math:`\exp[-2(\pi\sigma f)^2]` and
-the wavelength at which the transfer function equals 0.5 is about 5.34
-:math:`\sigma`, or about 0.89 of the filter width.
-
-.. _GMT_2D_filters:
-
-.. figure:: /_images/GMT_App_J_3.*
- :width: 500 px
- :align: center
-
- Transfer functions for 2-D (radial) GMT filters.
-
-
-J. The GMT High-Resolution Coastline Data
-=========================================
-
-
-Starting with version 3.0, GMT use a completely new coastline database
-and the :doc:`pscoast` utility was been
-completely rewritten to handle the new file format. Many users have
-asked us why it has taken so long for GMT to use a high-resolution
-coastline database; after all, such data have been available in the
-public domain for years. To answer such questions we will take you along
-the road that starts with these public domain data sets and ends up with
-the database used by GMT.
-
-Selecting the right data
-------------------------
-
-There are two well-known public-domain data sets that could be used for
-this purpose. Once is known as the World Data Bank II or CIA Data Bank
-(WDB) and contains coastlines, lakes, political boundaries, and rivers.
-The other, the World Vector Shoreline (WVS) only contains shorelines
-between saltwater and land (i.e., no lakes). It turns out that the WVS
-data is far superior to the WDB data as far as data quality goes, but as
-noted it lacks lakes, not to mention rivers and borders. We decided to
-use the WVS whenever possible and supplement it with WDB data. We got
-these data over the Internet; they are also available on CD-ROM from the
-National Geophysical Data Center in Boulder, Colorado [34]_.
-
-Format required by GMT
-----------------------
-
-In order to paint continents or oceans it is necessary that the
-coastline data be organized in polygons that may be filled. Simple line
-segments can be used to draw the coastline, but for painting polygons
-are required. Both the WVS and WDB data consists of unsorted line
-segments: there is no information included that tells you which segments
-belong to the same polygon (e.g., Australia should be one large
-polygon). In addition, polygons enclosing land must be differentiated
-from polygons enclosing lakes since they will need different paint.
-Finally, we want :doc:`pscoast` to be
-flexible enough that it can paint the land *or* the oceans *or* both. If
-just land (or oceans) is selected we do not want to paint those areas
-that are not land (or oceans) since previous plot programs may have
-drawn in those areas. Thus, we will need to combine polygons into new
-polygons that lend themselves to fill land (or oceans) only (Note that
-older versions of :doc:`pscoast` always
-painted lakes and wiped out whatever was plotted beneath).
-
-The long and winding road
--------------------------
-
-The WVS and WDB together represent more than 100 Mb of binary data and
-something like 20 million data points. Hence, it becomes obvious that
-any manipulation of these data must be automated. For instance, the
-reasonable requirement that no coastline should cross another coastline
-becomes a complicated processing step.
-
-* To begin, we first made sure that all data were "clean", i.e., that
- there were no outliers and bad points. We had to write several
- programs to ensure data consistency and remove "spikes" and bad
- points from the raw data. Also, crossing segments were automatically
- "trimmed" provided only a few points had to be deleted. A few hundred
- more complicated cases had to be examined semi-manually.
-
-* Programs were written to examine all the loose segments and determine
- which segments should be joined to produce polygons. Because not all
- segments joined exactly (there were non-zero gaps between some
- segments) we had to find all possible combinations and choose the
- simplest combinations. The WVS segments joined to produce more than
- 200,000 polygons, the largest being the Africa-Eurasia polygon which
- has 1.4 million points. The WDB data resulted in a smaller data base
- (~25% of WVS).
-
-* We now needed to combine the WVS and WDB data bases. The main problem
- here is that we have duplicates of polygons: most of the features in
- WVS are also in WDB. However, because the resolution of the data
- differ it is nontrivial to figure out which polygons in WDB to
- include and which ones to ignore. We used two techniques to address
- this problem. First, we looked for crossovers between all possible
- pairs of polygons. Because of the crossover processing in step 1
- above we know that there are no remaining crossovers within WVS and
- WDB; thus any crossovers would be between WVS and WDB polygons.
- Crossovers could mean two things: (1) A slightly misplaced WDB
- polygon crosses a more accurate WVS polygon, both representing the
- same geographic feature, or (2) a misplaced WDB polygon (e.g., a
- small coastal lake) crosses the accurate WVS shoreline. We
- distinguished between these cases by comparing the area and centroid
- of the two polygons. In almost all cases it was obvious when we had
- duplicates; a few cases had to be checked manually. Second, on many
- occasions the WDB duplicate polygon did not cross its WVS counterpart
- but was either entirely inside or outside the WVS polygon. In those
- cases we relied on the area-centroid tests.
-
-* While the largest polygons were easy to identify by visual
- inspection, the majority remain unidentified. Since it is important
- to know whether a polygon is a continent or a small pond inside an
- island inside a lake we wrote programs that would determine the
- hierarchical level of each polygon. Here, level = 1 represents
- ocean/land boundaries, 2 is land/lakes borders, 3 is
- lakes/islands-in-lakes, and 4 is
- islands-in-lakes/ponds-in-islands-in-lakes. Level 4 was the highest
- level encountered in the data. To automatically determine the
- hierarchical levels we wrote programs that would compare all possible
- pairs of polygons and find how many polygons a given polygon was
- inside. Because of the size and number of the polygons such programs
- would typically run for 3 days on a Sparc-2 workstation.
-
-* Once we know what type a polygon is we can enforce a common
- "orientation" for all polygons. We arranged them so that when you
- move along a polygon from beginning to end, your left hand is
- pointing toward "land". At this step we also computed the area of all
- polygons since we would like the option to plot only features that
- are bigger than a minimum area to be specified by the user.
-
-* Obviously, if you need to make a map of Denmark then you do not want
- to read the entire 1.4 million points making up the Africa-Eurasia
- polygon. Furthermore, most plotting devices will not let you paint
- and fill a polygon of that size due to memory restrictions. Hence, we
- need to partition the polygons so that smaller subsets can be
- accessed rapidly. Likewise, if you want to plot a world map on a
- letter-size paper there is no need to plot 10 million data points as
- most of them will plot several times on the same pixel and the
- operation would take a very long time to complete. We chose to make 5
- versions on the database, corresponding to different resolutions. The
- decimation was carried out using the Douglas-Peucker (DP)
- line-reduction algorithm [35]_. We chose the cutoffs so that each
- subset was approximately 20% the size of the next higher resolution.
- The five resolutions are called **f**\ ull, **h**\ igh,
- **i**\ ntermediate, **l**\ ow, and **c**\ rude; they are accessed in
- :doc:`pscoast`, :doc:`gmtselect`, and
- :doc:`grdlandmask` with the **-D**
- option [36]_. For each of these 5 data sets (**f**, **h**, **i**,
- **l**, **c**) we specified an equidistant grid (1, 2, 5, 10, 20) and
- split all polygons into line-segments that each fit inside one of the
- many boxes defined by these grid lines. Thus, to paint the entire
- continent of Australia we instead paint many smaller polygons made up
- of these line segments and gridlines. Some book-keeping has to be
- done since we need to know which parent polygon these smaller pieces
- came from in order to prescribe the correct paint or ignore if the
- feature is smaller than the cutoff specified by the user. The
- resulting segment coordinates were then scaled to fit in short
- integer format to preserve precision and written in netCDF format for
- ultimate portability across hardware platforms [37]_.
-
-* While we are now back to a file of line-segments we are in a much
- better position to create smaller polygons for painting. Two problems
- must be overcome to correctly paint an area:
-
- - We must be able to join line segments and grid cell borders into
- meaningful polygons; how we do this will depend on whether we want
- to paint the land or the oceans.
-
- - We want to nest the polygons so that no paint falls on areas that
- are "wet" (or "dry"); e.g., if a grid cell completely on land
- contains a lake with a small island, we do not want to paint the
- lake and then draw the island, but paint the annulus or "donut"
- that is represented by the land and lake, and then plot the
- island.
-
- GMT uses a polygon-assembly routine that carries out these tasks on the fly.
-
-The Five Resolutions
---------------------
-
-We will demonstrate the power of the new database by starting with a
-regional hemisphere map centered near Papua New Guinea and zoom in on a
-specified point. The map regions will be specified in projected km from
-the projection center, e.g., we may want the map to go from km to km in
-the longitudinal and the latitudinal direction.
-Also, as we zoom in on the projection center we want to draw the outline
-of the next map region on the plot. To do that we use the **-D** option
-in :doc:`psbasemap`.
-
-The crude resolution (**-Dc**)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-We begin with an azimuthal equidistant map of the hemisphere centered on
-130\ |degree|\ 21'E, 0\ |degree|\ 12'S, which is slightly west of New Guinea, near the Strait of
-Dampier. The edges of the map are all 9000 km true distance from the
-projection center. At this scale (and for global maps) the crude
-resolution data will usually be adequate to capture the main geographic
-features. To avoid cluttering the map with insignificant detail we only
-plot features (i.e., polygons) that exceed 500 km^2 in area.
-Smaller features would only occupy a few pixels on the plot and make the
-map look "dirty". We also add national borders to the plot. The crude
-database is heavily decimated and simplified by the DP-routine: The
-total file size of the coastlines, rivers, and borders database is only
-283 kbytes. The plot is produced by the script:
-
- ::
-
- gmt set MAP_GRID_CROSS_SIZE_PRIMARY 0 MAP_ANNOT_OBLIQUE 22 MAP_ANNOT_MIN_SPACING 0.3i
- gmt pscoast -Rk-9000/9000/-9000/9000 -JE130.35/-0.2/3.5i -P -Dc -A500 \
- -Gburlywood -Sazure -Wthinnest -N1/thinnest,- -B20g20 -BWSne -K > GMT_App_K_1.ps
- gmt psbasemap -R -J -O -Dk2000+c130.35/-0.2+pthicker >> GMT_App_K_1.ps
-
-.. figure:: /_images/GMT_App_K_1.*
- :width: 500 px
- :align: center
-
- Map using the crude resolution coastline data.
-
-
-Here, we use the :ref:`MAP_ANNOT_OBLIQUE <MAP_ANNOT_OBLIQUE>` bit flags to achieve horizontal
-annotations and set :ref:`MAP_ANNOT_MIN_SPACING <MAP_ANNOT_MIN_SPACING>` to suppress some
-longitudinal annotations near the S pole that otherwise would overprint.
-The square box indicates the outline of the next map.
-
-The low resolution (**-Dl**)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-We have now reduced the map area by zooming in on the map center. Now,
-the edges of the map are all 2000 km true distance from the projection
-center. At this scale we choose the low resolution data that faithfully
-reproduce the dominant geographic features in the region. We cut back on
-minor features less than 100 km^2 in area. We still add
-national borders to the plot. The low database is less decimated and
-simplified by the DP-routine: The total file size of the coastlines,
-rivers, and borders combined grows to 907 kbytes; it is the default
-resolution in GMT. The plot is generated by the script:
-
- ::
-
- gmt pscoast -Rk-2000/2000/-2000/2000 -JE130.35/-0.2/3.5i -P -Dl -A100 -Gburlywood \
- -Sazure -Wthinnest -N1/thinnest,- -B10g5 -BWSne -K > GMT_App_K_2.ps
- gmt psbasemap -R -J -O -Dk500+c130.35/-0.2+pthicker >> GMT_App_K_2.ps
-
-.. figure:: /_images/GMT_App_K_2.*
- :width: 500 px
- :align: center
-
- Map using the low resolution coastline data.
-
-
-The intermediate resolution (**-Di**)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-We continue to zoom in on the map center. In this map, the edges of the
-map are all 500 km true distance from the projection center. We abandon
-the low resolution data set as it would look too jagged at this scale
-and instead employ the intermediate resolution data that faithfully
-reproduce the dominant geographic features in the region. This time, we
-ignore features less than 20 km^2 in area. Although the script
-still asks for national borders none exist within our region. The
-intermediate database is moderately decimated and simplified by the
-DP-routine: The combined file size of the coastlines, rivers, and
-borders now exceeds 3.35 Mbytes. The plot is generated by the script:
-
- ::
-
- gmt pscoast -Rk-500/500/-500/500 -JE130.35/-0.2/3.5i -P -Di -A20 -Gburlywood \
- -Sazure -Wthinnest -N1/thinnest,- -B2g1 -BWSne -K > GMT_App_K_3.ps
- echo 133 2 | gmt psxy -R -J -O -K -Sc1.4i -Gwhite >> GMT_App_K_3.ps
- gmt psbasemap -R -J -O -K --FONT_TITLE=12p --MAP_TICK_LENGTH_PRIMARY=0.05i \
- -Tm133/2/1i::+45/10/5 --FONT_ANNOT_SECONDARY=8p >> GMT_App_K_3.ps
- gmt psbasemap -R -J -O -Dk100+c130.35/-0.2+pthicker >> GMT_App_K_3.ps
-
-.. figure:: /_images/GMT_App_K_3.*
- :width: 500 px
- :align: center
-
- Map using the intermediate resolution coastline data. We have added a compass
- rose just because we have the power to do so.
-
-
-The high resolution (**-Dh**)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The relentless zooming continues! Now, the edges of the map are all 100
-km true distance from the projection center. We step up to the high
-resolution data set as it is needed to accurately portray the detailed
-geographic features within the region. Because of the small scale we
-only ignore features less than 1 km^2 in area. The high
-resolution database has undergone minor decimation and simplification by
-the DP-routine: The combined file size of the coastlines, rivers, and
-borders now swells to 12.3 Mbytes. The map and the final outline box are
-generated by these commands:
-
- ::
-
- gmt pscoast -Rk-100/100/-100/100 -JE130.35/-0.2/3.5i -P -Dh -A1 -Gburlywood \
- -Sazure -Wthinnest -N1/thinnest,- -B30mg10m -BWSne -K > GMT_App_K_4.ps
- gmt psbasemap -R -J -O -Dk20+c130.35/-0.2+pthicker >> GMT_App_K_4.ps
-
-.. figure:: /_images/GMT_App_K_4.*
- :width: 500 px
- :align: center
-
- Map using the high resolution coastline data.
-
-
-The full resolution (**-Df**)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-We now arrive at our final plot, which shows a detailed view of the
-western side of the small island of Waigeo. The map area is
-approximately 40 by 40 km. We call upon the full resolution data set to
-portray the richness of geographic detail within this region; no
-features are ignored. The full resolution has undergone no decimation
-and it shows: The combined file size of the coastlines, rivers, and
-borders totals a (once considered hefty) 55.9 Mbytes. Our final map is
-reproduced by the single command:
-
- ::
-
- gmt pscoast -Rk-20/20/-20/20 -JE130.35/-0.2/3.5i -P -Df -Gburlywood \
- -Sazure -Wthinnest -N1/thinnest,- -B10mg2m -BWSne > GMT_App_K_5.ps
-
-.. figure:: /_images/GMT_App_K_5.*
- :width: 500 px
- :align: center
-
- Map using the full resolution coastline data.
-
-
-We hope you will study these examples to enable you to make efficient
-and wise use of this vast data set.
-
-K. GMT on non-\ UNIX Platforms
-================================
-
-
-Introduction
-------------
-
-While GMT was ported to non-\ UNIX systems such as Windows, it is
-also true that one of the strengths of GMT lies its symbiotic
-relationship with UNIX. We therefore recommend that GMT be installed
-in a POSIX-compliant UNIX environment such as traditional
-UNIX-systems, Linux, or Mac OS X. If abandoning your
-non-\ UNIX operating system is not an option, consider one of these
-solutions:
-
-WINDOWS:
- Choose among these three possibilities:
-
- #. Install GMT under MinGW/MSYS (A collection of GNU utilities).
-
- #. Install GMT under Cygwin (A GNU port to Windows).
-
- #. Install GMT in Windows using Microsoft C/C++ or other
- compilers. Unlike the first two, this option will not provide you
- with any UNIX tools so you will be limited to what you can do
- with DOS batch files.
-
-Cygwin and GMT
---------------
-
-Because GMT works best in conjugation with UNIX tools we suggest you
-install GMT using the Cygwin product from Cygnus (now assimilated by
-Redhat, Inc.). This free version works on any Windows version and it
-comes with both the Bourne Again shell **bash** and the **tcsh**.
-You also have access to most standard GNU development tools such as
-compilers and text processing tools (**awk**, **grep**, **sed**,
-etc.). Note that executables prepared for Windows will also run under Cygwin.
-
-Follow the instructions on the Cygwin page on how to install the
-package; note you must explicitly add all the development tool packages
-(e.g., **gcc** etc) as the basic installation does not include them by
-default. Once you are up and running under Cygwin, you may install
-GMT the same way you do under any other UNIX platform by either
-running the automated install via **install_gmt** or manually running
-configure first, then type make all. If you install via the web form,
-make sure you save the parameter file without DOS CR/LF endings. Use
-**dos2unix** to get rid of those if need be.
-
-Finally, from Cygwin's User Guide: By default, no Cygwin program can
-allocate more than 384 MB of memory (program and data). You should not
-need to change this default in most circumstances. However, if you need
-to use more real or virtual memory in your machine you may add an entry
-in either the **HKEY_LOCAL_MACHINE** (to change the limit for all
-users) or **HKEY_CURRENT_USER** (for just the current user) section of
-the registry. Add the DWORD value **heap_chunk_in_mb** and set it to
-the desired memory limit in decimal Mb. It is preferred to do this in
-Cygwin using the **regtool** program included in the Cygwin package.
-(For more information about **regtool** or the other Cygwin utilities,
-see the Section called Cygwin Utilities in Chapter 3 of the Cygwin's
-User Guide or use the help option of each utility.) You should always be
-careful when using **regtool** since damaging your system registry can
-result in an unusable system. This example sets the local machine memory
-limit to 1024 Mb:
-
- ::
-
- regtool -i set /HKLM/Software/Cygnus\ Solutions/Cygwin/heap_chunk_in_mb 1024
- regtool -v list /HKLM/Software/Cygnus\ Solutions/Cygwin
-
-For more installation details see the general README file.
-
-MINGW|MSYS and GMT
-------------------
-
-Though one can install GMT natively using CMake, the simplest way of installing
-under MINGW|MSYS is to just install the Windows binaries and use them from
-the msys bash shell. As simple as that. Furthermore, GMT programs launch
-faster here than on Cygwin so this is the recommended way of running
-GMT on Windows.
-
-L. Of Colors and Color Legends
-==============================
-
-
-Built-in color palette tables
------------------------------
-
-Figures :ref:`CPT files a <CPT_files_a>` and
-:ref:`b <CPT_files_b>` show the 36 built-in
-color palettes, stored in so-called CPT tables [38]_. The programs
-:doc:`makecpt` and
-:doc:`grd2cpt` are used to access these
-master CPT tables and translate/scale them to fit the user's range of
-*z*-values. The top half of the color bars in the Figure shows the
-original color scale, which can be either discrete or continuous, though
-some (like **globe**) are a mix of the two. The bottom half the color
-bar are built by using :doc:`makecpt`
-**-T**-1/1/0.25, thus splitting the color scale into 8 discrete colors.
-
-.. _CPT_files_a:
-
-.. figure:: /_images/GMT_App_M_1a.*
- :width: 500 px
- :align: center
-
- The first 18 of the standard 36 CPT files supported by GMT
-
-.. _CPT_files_b:
-
-.. figure:: /_images/GMT_App_M_1b.*
- :width: 500 px
- :align: center
-
- The second 18 of the standard 36 CPT files supported by GMT
-
-
-Labeled and non-equidistant color legends
------------------------------------------
-
-[app:colorbars] The use of color legends has already been introduced in
-Chapter [ch:7] (examples 2, 16, and 17). Things become a bit more
-complicated when you want to label the legend with names for certain
-intervals (like geological time periods in the example below). To
-accomplish that, one should add a semi-colon and the label name at the
-end of a line in the CPT table and add the **-L** option to the
-:doc:`psscale` command that draws the color
-legend. This option also makes all intervals in the legend of equal
-length, even it the numerical values are not equally spaced.
-
-Normally, the name labels are plotted at the lower end of the intervals.
-But by adding a *gap* amount (even when zero) to the **-L** option, they
-are centered. The example below also shows how to annotate ranges using
-**-Li** (in which case no name labels should appear in the CPT file),
-and how to switch the color bar around (by using a negative length).
-
-.. figure:: /_images/GMT_App_M_2.*
- :width: 600 px
- :align: center
-
-For additional color tables, visit
-`cpt-city <http://soliton.vm.bytemark.co.uk/pub/cpt-city/>`_.
-
-
-.. _App-custom_symbols:
-
-M. Custom Plot Symbols
-======================
-
-Background
-----------
-
-The GMT tools :doc:`psxy` and :doc:`psxyz` are capable of using custom
-symbols as alternatives to the built-in, standard geometrical shapes
-like circles, triangles, and many others. One the command line, custom
-symbols are selected via the **-Sk**\ *symbolname*\ [*size*] symbol
-selection, where *symbolname* refers to a special symbol definition file
-called ``symbolname.def`` that must be available via the standard GMT user paths. Several
-custom symbols comes pre-configured with GMT\ (see
-Figure :ref:`Custom symbols <Custom_symbols>`)
-
-.. _Custom_symbols:
-
-.. figure:: /_images/GMT_App_N_1.*
- :width: 500 px
- :align: center
-
- Custom plot symbols supported by GMT. Note that we only show
- the symbol outline and not any fill. These are all single-parameter symbols.
- Be aware that some symbols may have a hardwired fill or no-fill component,
- while others duplicate what is already available as standard built-in symbols.
-
-
-You may find it convenient to examine some of these and use them as a
-starting point for your own design; they can be found in GMT's
-share/custom directory.
-
-The macro language
-------------------
-
-To make your own custom plot symbol, you will need to design your own
-\*.def files. This section defines the language used to build custom
-symbols. You can place these definition files in your current directory
-or your .gmt user directory. When designing the symbol, you are doing so
-in a relative coordinate system centered on (0,0). This point will be
-mapped to the actual location specified by your data coordinates.
-Furthermore, your symbol should be constructed within the domain
-:math:`{-\frac{1}{2},+\frac{1}{2},-\frac{1}{2},+\frac{1}{2}}`, resulting
-in a 1 by 1 relative canvas area. This 1 x 1 square will be scaled to your
-actual symbol size when plotted.
-
-Comment lines
-~~~~~~~~~~~~~
-
-Your definition file may have any number of comment lines, defined to
-begin with the character #. These are skipped by GMT but provides a
-mechanism for you to clarify what your symbol does.
-
-Symbol variables
-~~~~~~~~~~~~~~~~
-
-Simple symbols, such as circles and triangles, only take a single
-parameter: the symbol size, which is either given on the command line
-(via **-Sk**) or as part of the input data. However, more complicated
-symbols, such as the ellipse or vector symbols, may require more
-parameters. If your custom symbol requires more than the single size
-parameter you must include the line
-
- **N**: *n_extra_parameters* [*types*]
-
-before any other macro commands. It is an optional statement in that
-*n_extra_parameters* will default to 0 unless explicitly set. By
-default the extra parameters are considered to be quantities that should
-be passed directly to the symbol machinery. However, you can use the
-*types* argument to specify different types of parameters. The available
-types are
-
- **a** Geographic angle, to be converted to map angle given the current
- map projection.
-
- **l** Length, i.e., an additional length scale (in cm, inch, or point as
- per :ref:`PROJ_LENGTH_UNIT <PROJ_LENGTH_UNIT>`) in addition to the given symbol size.
-
- **o** Other, i.e., a numerical quantity to be passed to the custom symbol as is.
-
- **s** String, i.e., a single column of text to be placed by the **l** command.
- Use octal \\040 to include spaces while still remaining a single word.
-
-To use the extra parameters in your macro you address them as $1, $2, etc.
-
-Macro commands
-~~~~~~~~~~~~~~
-
-The custom symbol language contains commands to rotate the relative
-coordinate system, draw free-form polygons and lines, change the current
-fill and/or pen, place text, and include basic geometric symbols as part of the
-overall design (e.g., circles, triangles, etc.). The available commands
-are listed in Table :ref:`custsymb <tbl-custsymb>`.
-
-.. _tbl-custsymb:
-
-+---------------+------------+----------------------------------------+--------------------------------------------+
-| **Name** | **Code** | **Purpose** | **Arguments** |
-+===============+============+========================================+============================================+
-| rotate | **R** | Rotate the coordinate system | :math:`\alpha`\[**a**] |
-+---------------+------------+----------------------------------------+--------------------------------------------+
-| moveto | **M** | Set a new anchor point | :math:`x_0, y_0` |
-+---------------+------------+----------------------------------------+--------------------------------------------+
-| drawto | **D** | Draw line from previous point | :math:`x, y` |
-+---------------+------------+----------------------------------------+--------------------------------------------+
-| arc | **A** | Append circular arc to existing path | :math:`x_c, y_c, r, \alpha_1, \alpha_2` |
-+---------------+------------+----------------------------------------+--------------------------------------------+
-| stroke | **S** | Stroke existing path only | |
-+---------------+------------+----------------------------------------+--------------------------------------------+
-| texture | **T** | Change current pen and fill | |
-+---------------+------------+----------------------------------------+--------------------------------------------+
-| star | **a** | Plot a star | :math:`x, y`,\ *size* |
-+---------------+------------+----------------------------------------+--------------------------------------------+
-| circle | **c** | Plot a circle | :math:`x, y`,\ *size* |
-+---------------+------------+----------------------------------------+--------------------------------------------+
-| diamond | **d** | Plot a diamond | :math:`x, y`,\ *size* |
-+---------------+------------+----------------------------------------+--------------------------------------------+
-| ellipse | **e** | Plot a ellipse | :math:`x, y, \alpha`,\ *major*,\ *minor* |
-+---------------+------------+----------------------------------------+--------------------------------------------+
-| octagon | **g** | Plot an octagon | :math:`x, y`,\ *size* |
-+---------------+------------+----------------------------------------+--------------------------------------------+
-| hexagon | **h** | Plot a hexagon | :math:`x, y`,\ *size* |
-+---------------+------------+----------------------------------------+--------------------------------------------+
-| invtriangle | **i** | Plot an inverted triangle | :math:`x, y`,\ *size* |
-+---------------+------------+----------------------------------------+--------------------------------------------+
-| letter | **l** | Plot a letter | :math:`x, y`,\ *size*, *string* |
-+---------------+------------+----------------------------------------+--------------------------------------------+
-| marc | **m** | Plot a math arc | :math:`x, y, r, \alpha_1, \alpha_2` |
-+---------------+------------+----------------------------------------+--------------------------------------------+
-| pentagon | **n** | Plot a pentagon | :math:`x, y`,\ *size* |
-+---------------+------------+----------------------------------------+--------------------------------------------+
-| plus | **+** | Plot a plus sign | :math:`x, y`,\ *size* |
-+---------------+------------+----------------------------------------+--------------------------------------------+
-| rect | **r** | Plot a rectangle | :math:`x, y`, *width*, *height* |
-+---------------+------------+----------------------------------------+--------------------------------------------+
-| square | **s** | Plot a square | :math:`x, y`,\ *size* |
-+---------------+------------+----------------------------------------+--------------------------------------------+
-| triangle | **t** | Plot a triangle | :math:`x, y`,\ *size* |
-+---------------+------------+----------------------------------------+--------------------------------------------+
-| wedge | **w** | Plot a wedge | :math:`x, y, r, \alpha_1, \alpha_2` |
-+---------------+------------+----------------------------------------+--------------------------------------------+
-| cross | **x** | Plot a cross | :math:`x, y`,\ *size* |
-+---------------+------------+----------------------------------------+--------------------------------------------+
-| x-dash | **-** | Plot a x-dash | :math:`x, y`,\ *size* |
-+---------------+------------+----------------------------------------+--------------------------------------------+
-| y-dash | **y** | Plot a y-dash | :math:`x, y`,\ *size* |
-+---------------+------------+----------------------------------------+--------------------------------------------+
-
-Note for **R**\: if an **a** is appended then :math:`\alpha` is considered
-to be a map azimuth; otherwise it is a Cartesian angle.
-For **M**, **T**, and all the lower-case symbol codes you may optionally
-append specific pens (with **-W**\ *pen*) and fills (with
-**-G**\ *pen*). These settings will override the pens and fills you may
-have specified on the command line. Passing **-G**- or **-W**- means no
-fill or outline, respectively.
-
-Text substitution
-~~~~~~~~~~~~~~~~~
-
-Normally, the **l** macro code will place a hard-wired text string. However,
-you can also obtain the entire string from your input file via a single symbol
-variable that must be declared with type **s** (string). The string read
-from your input file must be a single word, so if you need spaces you must
-use the octal \\040 code. Similarly, to place the dollar sign $ you must
-use octal \\044 so as to not confuse the parser with a symbol variable.
-The string itself, if obtained from the symbol definition file,
-may contain special codes that will be expanded given the current record. You
-can embed %X or %Y to add the current longitude (or x) and latitude (or y) in
-your label string. You may also use $n to embed a numerical symbol variable as text.
-It will be formatted according to :ref:`FORMAT_FLOAT_MAP <FORMAT_FLOAT_MAP>`,
-unless you append the modifiers **+X** (longitude via :ref:`FORMAT_GEO_MAP <FORMAT_GEO_MAP>`),
-**+Y** (latitude via :ref:`FORMAT_GEO_MAP <FORMAT_GEO_MAP>`), or **+T** (calendar time via
-:ref:`FORMAT_DATE_MAP <FORMAT_DATE_MAP>` and :ref:`FORMAT_CLOCK_MAP <FORMAT_CLOCK_MAP>`.
-
-Text alignment and font attributes
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Like the **Sl** symbol in :doc:`psxy`, you can change the current
-font by appending to **l** the modifier **+f**\ *font* [FONT_ANNOT_PRIMARY] and change the text justification
-by appending the modifier **+j**\ *justify* [CM]. Note: Here, the *font* specification
-will only be considered for the font type and not its size (which is set separately by your *size*
-argument) or color and outline (which are set separately by **-G** and **-W** arguments).
-Finally, there are two ways to specify the font size. If a fixed font size is given in points
-(e.g,, 12p) then the text will be set at that size regardless of the symbol size specified in **-S**.
-Without the trailing **p** we interpret the size as a relative size in the 0-1 range and the actual
-font size will then scale with the symbol size, just like other symbol items.
-
-Conditional statements
-~~~~~~~~~~~~~~~~~~~~~~
-
-There are two types of conditional statements in the macro language: A
-simple condition preceding a single command, or a more elaborate
-if-then-elseif-else construct. In any test you may use one (and only
-one) of many logical operators, as listed in Table :ref:`custop <tbl-custop>`.
-
-.. _tbl-custop:
-
-+----------------+----------------------------------------------------------+
-| **Operator** | **Purpose** |
-+================+==========================================================+
-| < | Is *var* less than *constant*? |
-+----------------+----------------------------------------------------------+
-| <= | Is *var* less than or equal to *constant*? |
-+----------------+----------------------------------------------------------+
-| == | Is *var* equal to *constant*? |
-+----------------+----------------------------------------------------------+
-| != | Is *var* not equal to *constant*? |
-+----------------+----------------------------------------------------------+
-| >= | Is *var* greater than or equal to *constant*? |
-+----------------+----------------------------------------------------------+
-| > | Is *var* greater than *constant*? |
-+----------------+----------------------------------------------------------+
-| % | Does *var* have a remainder with *constant*? |
-+----------------+----------------------------------------------------------+
-| !% | Is *var* an exact multiple of *constant*? |
-+----------------+----------------------------------------------------------+
-| <> | Is *var* within the exclusive range of *constant*? |
-+----------------+----------------------------------------------------------+
-| [] | Is *var* within the inclusive range of *constant*? |
-+----------------+----------------------------------------------------------+
-| <] | Is *var* within the in/ex-clusive range of *constant*? |
-+----------------+----------------------------------------------------------+
-| [> | Is *var* within the ex/in-clusive range of *constant*? |
-+----------------+----------------------------------------------------------+
-
-Simple conditional test
-^^^^^^^^^^^^^^^^^^^^^^^
-
-The simple if-test uses a one-line format, defined as
-
- **if** *var OP constant* **then** *command*
-
-where *var* must be one of the symbol parameters, specified as $1, $2,
-$3, etc. You must document what these additional parameters control. For
-example, to plot a small cyan circle at (0.2, 0.3) with diameter 0.4
-only if $2 exceeds 45 you would write
-
- ::
-
- if $2 > 45 then 0.2 0.3 0.4 c -Gcyan
-
-Note that this form of the conditional test has no mechanism for an
-**else** branch, but this can be accomplished by repeating the test but
-reversing the logic for the second copy, e.g.,
-
- ::
-
- if $1 > 10 then 0 0 0.5 c -Gred
- if $1 <= 10 then 0 0 0.5 c -Gblue
-
-or you may instead consider the complete conditional construct below.
-
-Complete conditional test
-^^^^^^^^^^^^^^^^^^^^^^^^^
-
-The complete conditional test uses a multi-line format, such as
-
-| **if** *var* *OP constant* **then** {
-| <one or more lines with commands>
-| } **elseif** *var OP constant* **then** {
-| <one or more lines with commands>
-| } **else** {
-| <one or more lines with commands>
-| }
-
-The **elseif** (one or more) and **else** branches are optional. Note
-that the syntax is strictly enforced, meaning the opening brace must
-appear after **then** with nothing following it, and the closing brace
-must appear by itself with no other text, and that the **elseif** and
-**else** statements must have both closing and opening braces on the
-same line (and nothing else). You may nest tests as well (up to 10
-levels deep), e.g.,
-
- ::
-
- if $1 > 45 then {
- if $2 [> 0:10 then 0 0 0.5 c -Gred
- } elseif $1 < 15 then {
- if $2 [> 0:10 then 0 0 0.5 c -Ggreen
- } else {
- if $2 [> 10:20 then {
- 0 0 M -W1p,blue
- 0.3 0.3 D
- S
- 0.3 0.3 0.3 c -Gcyan
- }
- }
-
-N. Annotation of Contours and "Quoted Lines"
-============================================
-
-
-The GMT programs :doc:`grdcontour` (for
-data given as 2-dimensional grids) and
-:doc:`pscontour` (for *x,y,z* tables) allow
-for contouring of data sets, while :doc:`psxy`
-and :doc:`psxyz` can plot lines based on *x,y*-
-and *x,y,z*-tables, respectively. In both cases it may be necessary to
-attach labels to these lines. Clever or optimal placements of labels is
-a very difficult topic, and GMT provides several algorithms for this
-placement as well as complete freedom in specifying the attributes of
-the labels. Because of the richness of these choices we present this
-Appendix which summarizes the various options and gives several examples
-of their use.
-
-Label Placement
----------------
-
-While the previous GMT versions 1--3 allowed for a single algorithm
-that determined where labels would be placed, GMT 4 allows for five
-different algorithms. Furthermore, a new "symbol" option (**-Sq** for
-"quoted line") has been added to :doc:`psxy` and
-:doc:`psxyz` and hence the new label placement
-mechanisms apply to those programs as well. The contouring programs
-expect the algorithm to be specified as arguments to **-G** while the
-line plotting programs expect the same arguments to follow **-Sq**. The
-information appended to these options is the same in both cases and is
-of the form [**code**]\ *info*. The five algorithms correspond to the
-five codes below (some codes will appear in both upper and lower case;
-they share the same algorithm but differ in some other ways). In what
-follows, the phrase "line segment" is taken to mean either a contour or
-a line to be labeled. The codes are:
-
-d:
- Full syntax is
- **d**\ *dist*\ [**c\ \|\ i\ \|\ p**][/\ *frac*].
- Place labels according to the distance measured along the projected
- line on the map. Append the unit you want to measure distances in
- [Default is taken from :ref:`PROJ_LENGTH_UNIT <PROJ_LENGTH_UNIT>`]. Starting at the
- beginning of a line, place labels every *dist* increment of distance
- along the line. To ensure that closed lines whose total length is
- less than *dist* get annotated, we may append *frac* which will
- place the first label at the distance *d = dist*
- :math:`\times` *frac* from the start of a closed line (and every
- *dist* thereafter). If not given, *frac* defaults to 0.25.
-
-D:
- Full syntax is
- **D**\ *dist*\ [**d\ \|\ m\ \|\ s\ \|\ e\ \|\ f\ \|\ k\ \|\ M\ \|\ n**][/\ *frac*].
- This option is similar to **d** except the original data must be
- referred to geographic coordinates (and a map projection must have
- been chosen) and actual Earth [39]_ surface distances along the
- lines are considered. Append the unit you want to measure distances
- in; choose among arc **d**\ egree, **m**\ inute, and **s**\ econd,
- or m\ **e**\ ter [Default], **f**\ eet, **k**\ ilometer, statute
- **M**\ iles, or **n**\ autical miles. Other aspects are similar to
- code **d**.
-
-f:
- Full syntax is
- **f**\ *fix.txt*\ [/*slop*\ [**c\ \|\ i\ \|\ p**]].
- Here, an ASCII file *fix.txt* is given which must contain records
- whose first two columns hold the coordinates of points along the
- lines at which locations the labels should be placed. Labels will
- only be placed if the coordinates match the line coordinates to
- within a distance of *slop* (append unit or we use
- :ref:`PROJ_LENGTH_UNIT <PROJ_LENGTH_UNIT>`). The default *slop* is zero, meaning only
- exact coordinate matches will do.
-
-l:
- Full syntax is **l**\ *line1*\ [,\ *line2*\ [, ...]]. One or more
- straight line segments are specified separated by commas, and labels
- will be placed at the intersections between these lines and our line
- segments. Each *line* specification implies a *start* and *stop*
- point, each corresponding to a coordinate pair. These pairs can be
- regular coordinate pairs (i.e., longitude/latitude separated by a
- slash), or they can be two-character codes that refer to
- predetermined points relative to the map region. These codes are
- taken from the :doc:`pstext` justification keys
- [**L\ \|\ C\ \|\ R**][**B\ \|\ M\ \|\ T**]
- so that the first character determines the *x*-coordinate and
- the second determines the *y*-coordinate. In
- :doc:`grdcontour`, you can also use
- the two codes **Z+** and **Z-** as shorthands for the location of
- the grid's global maximum and minimum, respectively. For example,
- the *line* **LT**/**RB** is a diagonal from the upper left to the
- lower right map corner, while **Z-**/135W/15S is a line from the
- grid minimum to the point (135ºW, 15ºS).
-
-L:
- Same as **l** except we will treat the lines given as great circle
- start/stop coordinates and fill in the points between before looking
- for intersections.
-
-n:
- Full syntax is
- **n**\ *number*\ [/*minlength*\ [**c\ \|\ i\ \|\ p**]].
- Place *number* of labels along each line regardless of total line
- length. The line is divided into *number* segments and the labels
- are placed at the centers of these segments. Optionally, you may
- give a *minlength* distance to ensure that no labels are placed
- closer than this distance to its neighbors.
-
-N:
- Full syntax is
- **N**\ *number*\ [/*minlength*\ [**c\ \|\ i\ \|\ p**]].
- Similar to code **n** but here labels are placed at the ends of each
- segment (for *number* >= 2). A special case arises for
- *number = 1* when a single label will be placed according to
- the sign of *number*: -1 places one label justified at the
- start of the line, while +1 places one label justified at
- the end of the line.
-
-x:
- Full syntax is **x**\ *cross.d*. Here, an ASCII file *cross.d* is a
- multi-segment file whose lines will intersect our segment lines;
- labels will be placed at these intersections.
-
-X:
- Same as **x** except we treat the lines given as great circle
- start/stop coordinates and fill in the points between before looking
- for intersections.
-
-Only one algorithm can be specified at any given time.
-
-Label Attributes
-----------------
-
-Determining where to place labels is half the battle. The other half is
-to specify exactly what are the attributes of the labels. It turns out
-that there are quite a few possible attributes that we may want to
-control, hence understanding how to specify these attributes becomes
-important. In the contouring programs, one or more attributes may be
-appended to the **-A** option using the format +\ *code*\ [*args*\ ] for
-each attribute, whereas for the line plotting programs these attributes
-are appended to the **-Sq** option following a colon (:) that separates
-the label codes from the placement algorithm. Several of the attributes
-do not apply to contours so we start off with listing those that apply
-universally. These codes are:
-
-+a:
- Controls the angle of the label relative to the angle of the line.
- Append **n** for normal to the line, give a fixed *angle* measured
- counter-clockwise relative to the horizontal. or append **p** for
- parallel to the line [Default]. If using
- :doc:`grdcontour` the latter option
- you may further append **u** or **d** to get annotations whose upper
- edge always face the next higher or lower contour line.
-
-+c:
- Surrounding each label is an imaginary label "textbox" which defines
- a region in which no segment lines should be visible. The initial
- box provides an exact fit to the enclosed text but clearance may be
- extended in both the horizontal and vertical directions (relative to
- the label baseline) by the given amounts. If these should be
- different amounts please separate them by a slash; otherwise the
- single value applies to both directions. Append the distance units
- of your choice (**c\ \|\ i\ \|\ m\ \|\ p**), or
- give % to indicate that the clearance should be this fixed
- percentage of the label font size in use. The default is 15%.
-
-+d:
- Debug mode. This is useful when testing contour placement as it will
- draw the normally invisible helper lines and points in the label
- placement algorithms above.
-
-+d:
- Delayed mode, to delay the plotting of the text as text clipping is set instead.
-
-+f:
- Specifies the desired label font, including size or color. See
- :doc:`pstext` for font names or numbers.
- The default font is given by :ref:`FONT_ANNOT_PRIMARY <FONT_ANNOT_PRIMARY>`.
-
-+g:
- Selects opaque rather than the default transparent text boxes. You
- may optionally append the color you want to fill the label boxes;
- the default is the same as :ref:`PS_PAGE_COLOR <PS_PAGE_COLOR>`.
-
-+j:
- Selects the justification of the label relative to the placement
- points determined above. Normally this is center/mid justified
- (**CM** in :doc:`pstext` justification
- parlance) and this is indeed the default setting. Override by using
- this option and append another justification key code from
- [**L\ \|\ C\ \|\ R**\ ][**B\ \|\ M\ \|\ T**\ ].
- Note for curved text (**+v**) only vertical justification will be
- affected.
-
-+o:
- Request a rounded, rectangular label box shape; the default is
- rectangular. This is only manifested if the box is filled or
- outlined, neither of which is implied by this option alone (see
- **+g** and **+p**). As this option only applies to straight text, it
- is ignored if **+v** is given.
-
-+p:
- Selects the drawing of the label box outline; append your preferred
- *pen* unless you want the default GMT pen [0.25p,black].
-
-+r:
- Do not place labels at points along the line whose local radius of
- curvature falls below the given threshold value. Append the radius
- unit of your choice (**c\ \|\ i\ \|\ p**) [Default is 0].
-
-+u:
- Append the chosen *unit* to the label. Normally a space will
- separate the label and the unit. If you want to close this gap,
- append a *unit* that begins with a hyphen (-). If you are contouring
- with :doc:`grdcontour` and you specify
- this option without appending a unit, the unit will be taken from
- the *z*-unit attribute of the grid header.
-
-+v:
- Place curved labels that follow the wiggles of the line segments.
- This is especially useful if the labels are long relative to the
- length-scale of the wiggles. The default places labels on an
- invisible straight line at the angle determined.
-
-+w:
- The angle of the line at the point of straight label placement is
- calculated by a least-squares fit to the *width* closest points. If
- not specified, *width* defaults to 10.
-
-+=:
- Similar in most regards to **+u** but applies instead to a label
- *prefix* which you must append.
-
-For contours, the label will be the value of the contour (possibly
-modified by **+u** or **+=**). However, for quoted lines other options apply:
-
-+l:
- Append a fixed *label* that will be placed at all label locations.
- If the label contains spaces you must place it inside matching
- quotes.
-
-+L:
- Append a code *flag* that will determine the label. Available codes
- are:
-
- +Lh:
- Take the label from the current multi-segment header (hence it
- is assumed that the input line segments are given in the
- multi-segment file format; if not we pick the single label from
- the file's header record). We first scan the header for an
- embedded **-L**\ *label* option; if none is found we instead use
- the first word following the segment marker [>].
-
- +Ld:
- Take the Cartesian plot distances along the line as the label;
- append **c\ \|\ i\ \|\ p** as the unit [Default is
- :ref:`PROJ_LENGTH_UNIT <PROJ_LENGTH_UNIT>`]. The label will be formatted according
- to the :ref:`FORMAT_FLOAT_OUT <FORMAT_FLOAT_OUT>` string, *unless* label placement
- was determined from map distances along the segment lines, in
- which case we determine the appropriate format from the distance
- value itself.
-
- +LD:
- Calculate actual Earth surface distances and use the distance at
- the label placement point as the label; append
- **d\ \|\ e\ \|\ f\ \|\ k\ \|\ m\ \|\ M\ \|\ n\ \|\ s**
- to specify the unit [If not given we default to **d**\ egrees,
- *unless* label placement was determined from map distances along
- the segment lines, in which case we use the same unit specified
- for that algorithm]. Requires a map projection to be used.
-
- +Lf:
- Use all text after the 2nd column in the fixed label location
- file *fix.txt* as labels. This choice obviously requires the
- fixed label location algorithm (code **f**) to be in effect.
-
- +Ln:
- Use the running number of the current multi-segment as label.
-
- +LN:
- Use a slash-separated combination of the current file number and
- the current multi-segment number as label.
-
- +Lx:
- As **h** but use the multi-segment headers in the *cross.d* file
- instead. This choice obviously requires the crossing segments
- location algorithm (code **x\ \|\ X**) to be in effect.
-
-Examples of Contour Label Placement
------------------------------------
-
-We will demonstrate the use of these options with a few simple examples.
-First, we will contour a subset of the global geoid data used in
-GMT Example 01; the region selected encompasses the world's strongest
-"geoid dipole": the Indian Low and the New Guinea High.
-
-Equidistant labels
-~~~~~~~~~~~~~~~~~~
-
-Our first example uses the default placement algorithm. Because of the
-size of the map we request contour labels every 1.5 inches along the
-lines:
-
- ::
-
- gmt pscoast -R50/160/-15/15 -JM5.3i -Gburlywood -Sazure -A500 -K -P > GMT_App_O_1.ps
- gmt grdcontour geoid.nc -J -O -B20f10 -BWSne -C10 -A20+f8p -Gd1.5i -S10 -T:LH >> GMT_App_O_1.ps
-
-As seen in Figure :ref:`Contour label 1 <Contour_label_1>`, the contours are
-placed rather arbitrary. The string of contours for -40 to
-60 align well but that is a fortuitous consequence of reaching
-the 1.5 inch distance from the start at the bottom of the map.
-
-.. _Contour_label_1:
-
-.. figure:: /_images/GMT_App_O_1.*
- :width: 500 px
- :align: center
-
- Equidistant contour label placement with **-Gd**, the only algorithm
- available in previous GMT versions.
-
-
-Fixed number of labels
-~~~~~~~~~~~~~~~~~~~~~~
-
-We now exercise the option for specifying exactly how many labels each
-contour line should have:
-
- ::
-
- gmt pscoast -R50/160/-15/15 -JM5.3i -Gburlywood -Sazure -A500 -K -P > GMT_App_O_2.ps
- gmt grdcontour geoid.nc -J -O -B20f10 -BWSne -C10 -A20+f8p -Gn1/1i -S10 -T:LH >> GMT_App_O_2.ps
-
-By selecting only one label per contour and requiring that labels only
-be placed on contour lines whose length exceed 1 inch, we achieve the
-effect shown in Figure :ref:`Contour label 2 <Contour_label_2>`.
-
-.. _Contour_label_2:
-
-.. figure:: /_images/GMT_App_O_2.*
- :width: 500 px
- :align: center
-
- Placing one label per contour that exceed 1 inch in length, centered on the segment with **-Gn**.
-
-
-Prescribed label placements
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Here, we specify four points where we would like contour labels to be
-placed. Our points are not exactly on the contour lines so we give a
-nonzero "slop" to be used in the distance calculations: The point on the
-contour closest to our fixed points and within the given maximum
-distance will host the label.
-
- ::
-
- cat << EOF > fix.txt
- 80 -8.5
- 55 -7.5
- 102 0
- 130 10.5
- EOF
- gmt pscoast -R50/160/-15/15 -JM5.3i -Gburlywood -Sazure -A500 -K -P > GMT_App_O_3.ps
- gmt grdcontour geoid.nc -J -O -B20f10 -BWSne -C10 -A20+d+f8p -Gffix.txt/0.1i -S10 -T:LH >> GMT_App_O_3.ps
-
-The angle of the label is evaluated from the contour line geometry, and
-the final result is shown in Figure :ref:`Contour label 3 <Contour_label_3>`.
-To aid in understanding the algorithm we chose to specify "debug" mode
-(**+d**) which placed a small circle at each of the fixed points.
-
-.. _Contour_label_3:
-
-.. figure:: /_images/GMT_App_O_3.*
- :width: 500 px
- :align: center
-
- Four labels are positioned on the points along the contours that are
- closest to the locations given in the file fix.txt in the **-Gf** option.
-
-
-Label placement at simple line intersections
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Often, it will suffice to place contours at the imaginary intersections
-between the contour lines and a well-placed straight line segment. The
-**-Gl** or **-GL** algorithms work well in those cases:
-
- ::
-
- gmt pscoast -R50/160/-15/15 -JM5.3i -Gburlywood -Sazure -A500 -K -P > GMT_App_O_4.ps
- gmt grdcontour geoid.nc -J -O -B20f10 -BWSne -C10 -A20+d+f8p -GLZ-/Z+ -S10 -T:LH >> GMT_App_O_4.ps
-
-The obvious choice in this example is to specify a great circle between
-the high and the low, thus placing all labels between these extrema.
-
-.. _Contour_label_4:
-
-.. figure:: /_images/GMT_App_O_4.*
- :width: 500 px
- :align: center
-
- Labels are placed at the intersections between contours and the great circle specified in the **-GL** option.
-
-
-The thin debug line in Figure :ref:`Contour label 4 <Contour_label_4>` shows
-the great circle and the intersections where labels are plotted. Note
-that any number of such lines could be specified; here we are content
-with just one.
-
-Label placement at general line intersections
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-If (1) the number of intersecting straight line segments needed to pick
-the desired label positions becomes too large to be given conveniently
-on the command line, or (2) we have another data set or lines whose
-intersections we wish to use, the general crossing algorithm makes more
-sense:
-
- ::
-
- gmt pscoast -R50/160/-15/15 -JM5.3i -Gburlywood -Sazure -A500 -K -P > GMT_App_O_5.ps
- gmt grdcontour geoid.nc -J -O -B20f10 -BWSne -C10 -A20+d+f8p -GXcross.txt -S10 -T:LH >> GMT_App_O_5.ps
-
-.. _Contour_label_5:
-
-.. figure:: /_images/GMT_App_O_5.*
- :width: 500 px
- :align: center
-
- Labels are placed at the intersections between contours and the
- multi-segment lines specified in the **-GX** option.
-
-
-In this case, we have created three strands of lines whose intersections
-with the contours define the label placements, presented in
-Figure :ref:`Contour label 5 <Contour_label_5>`.
-
-Examples of Label Attributes
-----------------------------
-
-We will now demonstrate some of the ways to play with the label
-attributes. To do so we will use :doc:`psxy` on
-a great-circle line connecting the geoid extrema, along which we have
-sampled the ETOPO5 relief data set. The file thus contains *lon, lat,
-dist, geoid, relief*, with distances in km.
-
-Label placement by along-track distances, 1
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-This example will change the orientation of labels from along-track to
-across-track, and surrounds the labels with an opaque, outlined text box
-so that the label is more readable. We choose the place the labels every
-1000 km along the line and use that distance as the label. The labels
-are placed normal to the line:
-
- ::
- gmt pscoast -R50/160/-15/15 -JM5.3i -Gburlywood -Sazure -A500 -K -P > GMT_App_O_6.ps
- gmt grdcontour geoid.nc -J -O -K -B20f10 -BWSne -C10 -A20+d+f8p -Gl50/10S/160/10S -S10 \
- -T:'-+' >> GMT_App_O_6.ps
- gmt psxy -R -J -O -SqD1000k:+g+LD+an+p -Wthick transect.txt >> GMT_App_O_6.ps
-
-.. _Contour_label_6:
-
-.. figure:: /_images/GMT_App_O_6.*
- :width: 500 px
- :align: center
-
- Labels attributes are controlled with the arguments to the **-Sq** option.
-
-
-The composite illustration in Figure :ref:`Contour label 6 <Contour_label_6>`
-shows the new effects. Note that the line connecting the extrema does
-not end exactly at the ‘-' and ‘+' symbols. This is because the
-placements of those symbols are based on the mean coordinates of the
-contour and not the locations of the (local or global) extrema.
-
-Label placement by along-track distances, 2
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-A small variation on this theme is to place the labels parallel to the
-line, use spherical degrees for placement, append the degree symbol as a
-unit for the labels, choose a rounded rectangular text box, and
-inverse-video the label:
-
- ::
-
- gmt pscoast -R50/160/-15/15 -JM5.3i -Gburlywood -Sazure -A500 -K -P > GMT_App_O_7.ps
- gmt grdcontour geoid.nc -J -O -K -B20f10 -BWSne -C10 -A20+d+u" m"+f8p -Gl50/10S/160/10S -S10 \
- -T:-+ >> GMT_App_O_7.ps
- gmt psxy -R -J -O -SqD15d:+gblack+fwhite+Ld+o+u\\260 -Wthick transect.txt >> GMT_App_O_7.ps
-
-The output is presented as Figure :ref:`Contour label 7 <Contour_label_7>`.
-
-.. _Contour_label_7:
-
-.. figure:: /_images/GMT_App_O_7.*
- :width: 500 px
- :align: center
-
- Another label attribute example.
-
-
-Using a different data set for labels
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-In the next example we will use the bathymetry values along the transect
-as our label, with placement determined by the distance along track. We
-choose to place labels every 1500 km. To do this we need to pull out
-those records whose distances are multiples of 1500 km and create a
-"fixed points" file that can be used to place labels and specify the
-labels. This is done with **awk**.
-
- ::
-
- gmt gmtconvert -i0,1,4 -Em150 transect.txt | $AWK '{print $1,$2,int($3)}' > fix2.txt
- gmt pscoast -R50/160/-15/15 -JM5.3i -Gburlywood -Sazure -A500 -K -P > GMT_App_O_8.ps
- gmt grdcontour geoid.nc -J -O -K -B20f10 -BWSne -C10 -A20+d+u" m"+f8p -Gl50/10S/160/10S -S10 \
- -T:-+ >> GMT_App_O_8.ps
- gmt psxy -R -J -O -Sqffix2.txt:+g+an+p+Lf+u" m"+f8p -Wthick transect.txt >> GMT_App_O_8.ps
-
-The output is presented as Figure :ref:`Contour label 8 <Contour_label_8>`.
-
-.. _Contour_label_8:
-
-.. figure:: /_images/GMT_App_O_8.*
- :width: 500 px
- :align: center
-
- Labels based on another data set (here bathymetry) while the placement is based on distances.
-
-
-Putting it all together
------------------------
-
-Finally, we will make a more complex composite illustration that uses
-several of the label placement and label attribute settings discussed in
-the previous sections. We make a map showing the tsunami travel times
-(in hours) from a hypothetical catastrophic landslide in the Canary
-Islands [40]_. We lay down a color map based on the travel times and the
-shape of the seafloor, and travel time contours with curved labels as
-well as a few quoted lines. The final script is
-
- ::
-
- R=-R-85/5/10/55
- gmt grdgradient topo5.nc -Nt1 -A45 -Gtopo5_int.nc
- gmt gmtset FORMAT_GEO_MAP ddd:mm:ssF FONT_ANNOT_PRIMARY +9p FONT_TITLE 22p
- gmt project -E-74/41 -C-17/28 -G10 -Q > great_NY_Canaries.txt
- gmt project -E-74/41 -C2.33/48.87 -G100 -Q > great_NY_Paris.txt
- km=`echo -17 28 | gmt mapproject -G-74/41/k -fg --FORMAT_FLOAT_OUT=%.0f -o2`
- cat << EOF > ttt.cpt
- 0 lightred 3 lightred
- 3 lightyellow 6 lightyellow
- 6 lightgreen 100 lightgreen
- EOF
- gmt grdimage ttt_atl.nc -Itopo5_int.nc -Cttt.cpt $R -JM5.3i -P -K -nc+t1 > GMT_App_O_9.ps
- gmt grdcontour ttt_atl.nc -R -J -O -K -C0.5 -A1+u" hour"+v+f8p,Bookman-Demi \
- -GL80W/31N/17W/26N,17W/28N/17W/50N -S2 >> GMT_App_O_9.ps
- gmt psxy -R -J -Wfatter,white great_NY_Canaries.txt -O -K >> GMT_App_O_9.ps
- gmt pscoast -R -J -B20f5 -BWSne+t"Tsunami travel times from the Canaries" -N1/thick -O -K \
- -Glightgray -Wfaint -A500 >> GMT_App_O_9.ps
- gmt gmtconvert great_NY_*.txt -E | gmt psxy -R -J -O -K -Sa0.15i -Gred -Wthin >> GMT_App_O_9.ps
- gmt psxy -R -J -Wthick great_NY_Canaries.txt -O -K \
- -Sqn1:+f8p,Times-Italic+l"Distance Canaries to New York = $km km"+ap+v >> GMT_App_O_9.ps
- gmt psxy -R -J great_NY_Paris.txt -O -K -Sc0.08c -Gblack >> GMT_App_O_9.ps
- gmt psxy -R -J -Wthinner great_NY_Paris.txt -SqD1000k:+an+o+gblue+LDk+f7p,Helvetica-Bold,white \
- -O -K >> GMT_App_O_9.ps
- cat << EOF | gmt pstext -R -J -O -K -Gwhite -Wthin -Dj0.1i/0.1i -F+f8p,Bookman-Demi+j \
- >> GMT_App_O_9.ps
- 74W 41N RT New York
- 2.33E 48.87N CT Paris
- 17W 28N CT Canaries
- EOF
- gmt psxy -R -J -O -T >> GMT_App_O_9.ps
-
-with the complete illustration presented as Figure
-:ref:`Contour label 9 <Contour_label_9>`.
-
-.. _Contour_label_9:
-
-.. figure:: /_images/GMT_App_O_9.*
- :width: 500 px
- :align: center
-
- Tsunami travel times from the Canary Islands to places in the Atlantic,
- in particular New York. Should a catastrophic landslide occur it is possible
- that New York will experience a large tsunami about 8 hours after the event.
-
-
-O. Special Operations
-=====================
-
-.. _Isolation mode:
-
-Running GMT in *isolation mode*
--------------------------------
-
-In Chapter `General features`_ it is described how GMT creates
-several (temporary) files to communicate between the different commands
-that make up the script that finally creates a plot. Among those files
-are:
-
- **gmt.conf** This file covers about 100 different settings that influence the
- layout of your plot, from font sizes to tick lengths and date
- formats (See Section `GMT defaults`_). Those settings can be altered
- by editing the file, or by running the
- :doc:`gmtset` command. A problem may arise
- when those settings are changed half-way through the script: the
- next time you run the script it will start with the modified
- settings and hence might alter your scripts results. It is therefore
- often necessary to revert to the original ``gmt.conf`` file. *Isolation mode*
- avoids that issue.
-
- **gmt.history** This file is created to communicate the command line history from
- one command to the next (Section `Command line history`_) so that
- shorthands like **-R** or **-J** can be used once it has been set in
- a previous GMT command. The existence of this file makes if
- impossible to run two GMT scripts simultaneously in the same
- directory, since those ``gmt.history`` files may clash (contain different histories)
- and adversely affect the results of both scripts.
-
-A cure to all these woes is the *isolation mode* introduced in
-GMT version 4.2.2. This mode allows you to run a GMT script without
-leaving any traces other than the resulting PostScript or data files,
-and not altering the ``gmt.conf`` or ``gmt.history`` files. Those files will be placed in a temporary
-directory instead. And if properly set up, this temporary directory will
-only be used by a single script, even if another GMT script is running
-simultaneously. This also provides the opportunity to create any other
-temporary files that the script might create in the same directory.
-
-The example below shows how *isolation mode* works.
-
- ::
-
- ps=GMT_App_P_1.ps
-
- # Create a temporary directory. $GMT_TMPDIR will be set to its pathname.
- # XXXXXX is replaced by a unique random combination of characters.
- export GMT_TMPDIR=`mktemp -d /tmp/gmt.XXXXXX`
-
- # These settings will be local to this script only since it writes to
- # $GMT_TMPDIR/gmt.conf
- gmt gmtset COLOR_MODEL rgb FONT_ANNOT_PRIMARY 14p
-
- # Make grid file and color map in temporary directory
- gmt grdmath -Rd -I1 Y = $GMT_TMPDIR/lat.nc
- gmt makecpt -Crainbow -T-90/90/180 -Z > $GMT_TMPDIR/lat.cpt
-
- # The gmt grdimage command creates the history file $GMT_TMPDIR/gmt.history
- gmt grdimage $GMT_TMPDIR/lat.nc -JK6.5i -C$GMT_TMPDIR/lat.cpt -P -K -nl > $ps
- gmt pscoast -R -J -O -Dc -A5000 -Gwhite -Bx60g30 -By30g30 >> $ps
-
- # Clean up all temporary files and the temporary directory
- rm -rf $GMT_TMPDIR
-
-.. figure:: /_images/GMT_App_P_2.*
- :width: 500 px
- :align: center
-
- Example created in isolation mode
-
-
-The files ``gmt.conf`` and ``gmt.history`` are automatically created in the temporary directory
-``$GMT_TMPDIR``. The script is also adjusted such that the temporary grid file ``lat.nc`` and colormap
-``lat.cpt`` are created in that directory as well. To make things even more easy,
-GMT now provides a set of handy shell functions in :doc:`gmt_shell_functions.sh`:
-simply include that file in the script and the creation and the removal
-of the temporary directory is reduced to a single command.
-
-
-P. The GMT Vector Data Format for OGR Compatibility
-===================================================
-
-
-Background
-----------
-
-The National Institute for Water and Atmospheric Research (NIWA) in New
-Zealand has funded the implementation of a GMT driver (read and write)
-for the OGR package. OGR is an Open Source toolkit for accessing or
-reformatting vector (spatial) data stored in a variety of formats and is
-part of the. The intention was to enable the easy rendering (using
-GMT) of spatial data held in non-\ GMT formats, and the export of
-vector data (e.g., contours) created by GMT for use with other GIS and
-mapping packages. While **ogr2ogr** has had the capability to write
-this new format since 2009, GMT 4 did not have the capability to use
-the extra information.
-
-GMT 5 now allows for more advanced vector data, including donut
-polygons (polygons with holes) and aspatial attribute data. At the same
-time, the spatial data implementation will not disrupt older GMT 4
-programs since all the new information are written via comments.
-
-The identification of spatial feature types in GMT files generally
-follows the technical description, (which is largely consistent with the
-OGC SFS specification). This specification provides for non-topological
-point, line and polygon (area) features, as well as multipoint,
-multiline and multipolygon features, and was written by
-`Brent Wood <http://www.niwa.co.nz/key-contacts/brent-wood/>`_
-based on input from Paul Wessel and others on the GMT list.
-
-The OGR/GMT format
-------------------
-
-Several key properties of the OGR/GMT format is summarized below:
-
-- All new data fields are stored as comment lines, i.e., in lines
- starting with a "#". OGR/GMT files are therefore compatible with
- GMT 4 binaries, which will simply ignore this new information.
-
-- To be consistent with current practice in GMT, data fields are
- represented as whitespace-separated strings within the comments, each
- identified by the "@" character as a prefix, followed by a single
- character identifying the content of the field. To avoid confusion
- between words and strings, the word (field) separator within strings
- will be the "\|" (pipe or vertical bar) character.
-
-- Standard UNIX "\\" escaping is used, such as \\n for newline in a string.
-
-- All new data are stored before the spatial data (coordinates) in the
- file, so when any GMT 5 program is processing the coordinate data
- for a feature, it will already have parsed any non-spatial
- information for each feature, which may impact on how the spatial
- data is treated (e.g., utilizing the aspatial attribute data for a
- feature to control symbology).
-
-- The first comment line must specify the version of the OGR/GMT data
- format, to allow for future changes or enhancements to be supported
- by future GMT programs. This document describes v1.0.
-
-- For consistency with other GIS formats (such as shapefiles) the
- OGR/GMT format explicitly contains a field specifying whether the
- features are points, linestrings or polygons, or the "multi" versions
- of these. (Other shapefile feature types will not be supported at
- this stage). At present, GMT programs are informed of this via
- command line parameters. This will now be explicit in the data file,
- but does not preclude command line switches setting symbologies for
- plotting polygons as lines (perimeters) or with fills, as is
- currently the practice.
-
-- Note that what is currently called a "multiline" (multi-segment) file
- in GMT parlance is generally a set of "lines" in shapefile/OGR
- usage. A multiline in this context is a single feature comprising
- multiple lines. For example, all the transects from a particular
- survey may be stored as lines, each with it's own attribute set, such
- as transect number, date/time, etc. They may also be stored as a
- single multiline feature with one attribute set, such as trip ID.
- This difference is explicitly stored in the data in OGR/shapefiles,
- but currently specified only on the command line in GMT. This
- applies also to points and polygons. The GMT equivalent to
- {multipoint, multiline, multipolygon} datatypes is multiple
- GMT files, each comprising a single {multipoint, multiline,
- multipolygon} feature.
-
-- The new GMT vector data files includes a header comment specifying
- the type of spatial features it contains, as well as the description
- of the aspatial attribute data to be associated with each feature.
- Unlike the shapefile format, which stores the spatial and aspatial
- attribute data in separate files, the GMT format will store all
- data in a single file.
-
-- All the features in a GMT file must be of the same type.
-
-OGR/GMT Metadata
-----------------
-
-Several pieces of metadata information must be present in the header of
-the OGR/GMT file, followed by both spatial and aspatial data. In this
-section we look at the metadata.
-
-Format version
-~~~~~~~~~~~~~~
-
-The comment header line will include a version identifier providing for
-possible different versions in future. It is indicated by the **@V**
-sequence.
-
-+-----------+---------------+--------------------------------------------------------------------+
-| **Code** | **Argument** | **Description** |
-+===========+===============+====================================================================+
-| V | GMT1.0 | Data in this file is stored using v1.0 of the OGR/GMT data format |
-+-----------+---------------+--------------------------------------------------------------------+
-
-An OGR/GMT file must therefore begin with the line
-
- ::
-
- # @VGMT1.0
-
-Parsing of the OGR/GMT format is only activated if the version
-code-sequence has been found.
-
-Geometry types
-~~~~~~~~~~~~~~
-
-The words and characters used to specify the geometry type (preceded by
-the **@G** code sequence on the header comment line), are listed in
-Table :ref:`geometries <tbl-geometries>`.
-
-.. _tbl-geometries:
-
-+----------+-----------------+---------------------------------------------------------------------------------------+
-| **Code** | **Geometry** | **Description** |
-+==========+=================+=======================================================================================+
-| G | POINT | File with point features |
-+----------+-----------------+---------------------------------------------------------------------------------------+
-| | | (Each point will have it's own attribute/header line preceding the point coordinates) |
-+----------+-----------------+---------------------------------------------------------------------------------------+
-| G | MULTIPOINT | File with a single multipoint feature |
-+----------+-----------------+---------------------------------------------------------------------------------------+
-| | | (All the point features are a single multipoint, with the same attribute/header |
-+----------+-----------------+---------------------------------------------------------------------------------------+
-| | | information) |
-+----------+-----------------+---------------------------------------------------------------------------------------+
-| G | LINESTRING | File with features comprising multiple single lines |
-+----------+-----------------+---------------------------------------------------------------------------------------+
-| | | (Effectively the current GMT multiline file, each line feature will have it's own |
-+----------+-----------------+---------------------------------------------------------------------------------------+
-| | | attribute and header data) |
-+----------+-----------------+---------------------------------------------------------------------------------------+
-| G | MULTILINESTRING | File with features comprising a multiline |
-+----------+-----------------+---------------------------------------------------------------------------------------+
-| | | (All the line features in the file are a single multiline feature, only one attribute |
-+----------+-----------------+---------------------------------------------------------------------------------------+
-| | | and header which applies to all the lines) |
-+----------+-----------------+---------------------------------------------------------------------------------------+
-| G | POLYGON | File with one or more polygons |
-+----------+-----------------+---------------------------------------------------------------------------------------+
-| | | (Similar to a line file, except the features are closed polygons) |
-+----------+-----------------+---------------------------------------------------------------------------------------+
-| G | MULTIPOLYGON | File with a single multipolygon |
-+----------+-----------------+---------------------------------------------------------------------------------------+
-| | | (Similar to a GMT multiline file, except the feature is a closed multipolygon) |
-+----------+-----------------+---------------------------------------------------------------------------------------+
-
-An example GMT polygon file header using this specification (in format 1.0) is
-
- ::
-
- # @VGMT1.0 @GPOLYGON
-
-Domain and map projections
-~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The new format will also support region and projection information. The
-region will be stored in GMT **-R** format (i.e., **-R**\ *W/E/S/N*,
-where the *W/E/S/N* values represent the extent of features); the **@R**
-code sequence marks the domain information. A sample region header is:
-
- ::
-
- # @R150/190/-45/-54
-
-Projection information will be represented as four optional strings,
-prefixed by **@J** (J being the GMT character for projection
-information. The **@J** code will be followed by a character identifying
-the format, as shown in Table :ref:`projectspec <tbl-projectspec>`.
-
-.. _tbl-projectspec:
-
-+------------+-------------------------------------------------------------------------------------------------+
-| **Code** | **Projection Specification** |
-+============+=================================================================================================+
-| @Je | EPSG code for the projection |
-+------------+-------------------------------------------------------------------------------------------------+
-| @Jg | A string representing the projection parameters as used by GMT |
-+------------+-------------------------------------------------------------------------------------------------+
-| @Jp | A string comprising the Proj.4 parameters representing the projection parameters |
-+------------+-------------------------------------------------------------------------------------------------+
-| @Jw | A string comprising the OGR WKT (well known text) representation of the projection parameters |
-+------------+-------------------------------------------------------------------------------------------------+
-
-Sample projection strings are:
-
- ::
-
- # @Je4326 @JgX @Jp"+proj=longlat +ellps=WGS84+datum=WGS84 +no_defs"
- # @Jw"GEOGCS[\"WGS84\",DATUM[\"WGS_1984\",SPHEROID\"WGS84\",6378137,\
- 298.257223563,AUTHORITY[\"EPSG\",\"7030\"]],TOWGS84[0,0,0,0,0,0,0],
- AUTHORITY[\"EPSG\",\"6326\"]],PRIMEM[\"Greenwich\",0,\
- AUTHORITY[\"EPSG\",\"8901\"]],UNIT[\"degree\",0.01745329251994328,\
- AUTHORITY[\"EPSG\",\"9122\"]],AUTHORITY[\"EPSG\",\"4326\"]]"
-
-Note that an OGR-generated file will not have a **@Jg** string, as OGR
-does not have any knowledge of the GMT projection specification
-format. GMT supports at least one of the other formats to provide
-interoperability with other Open Source related GIS software packages.
-One relatively simple approach, (with some limitations), would be a
-lookup table matching EPSG codes to GMT strings.
-
-Declaration of aspatial fields
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The string describing the aspatial field names associated with the
-features is flagged by the **@N** prefix.
-
-+------------+-----------------------------+-----------------------------------------------------------------+
-| **Code** | **Argument** | **Description** |
-+============+=============================+=================================================================+
-| N | word\ \|\ word\ \|\ word | A "\|" -separated string of names of the attribute field names |
-+------------+-----------------------------+-----------------------------------------------------------------+
-
-Any name containing a space must be quoted. The **@N** selection must be
-combined with a matching string specifying the data type for each of the
-named fields, using the **@T** prefix.
-
-+------------+-----------------------------+-------------------------------------------------------------+
-| **Code** | **Argument** | **Description** |
-+============+=============================+=============================================================+
-| T | word\ \|\ word\ \|\ word | A "\|" -separated string of the attribute field data types |
-+------------+-----------------------------+-------------------------------------------------------------+
-
-Available datatypes should largely follow the shapefile (DB3)
-specification, including **string**, **integer**, **double**,
-**datetime**, and **logical** (boolean). In OGR/GMT vector files, they
-will be stored as appropriately formatted text strings.
-
-An example header record containing all these is
-
- ::
-
- # @VGMT1.0 @GPOLYGON @Nname|depth|id @Tstring|double|integer
-
-OGR/GMT Data
-------------
-
-All generic fields must be at the start of the file before any
-feature-specific content (feature attribute data follow the metadata, as
-do the feature coordinates, separated by a comment line comprising "#
-FEATURE_DATA". Provided each string is formatted as specified, and
-occurs on a line prefixed with "#" (i.e., is a comment), the format is
-free form, in that as many comment lines as desired may be used, with
-one or more parameter strings in any order in any line. E.g., one
-parameter per line, or all parameters on one line.
-
-Embedding aspatial data
-~~~~~~~~~~~~~~~~~~~~~~~
-
-Following this header line is the data itself, both aspatial and
-spatial. For line and polygon (including multiline and multipolygon)
-data, features are separated using a predefined character, by default
-">". For point (and multipoint) data, no such separator is required. The
-comment line containing the aspatial data for each feature will
-immediately precede the coordinate line(s). Thus in the case of lines
-and polygons, it will immediately follow the ">" line. The data line
-will be a comment flag ("#") followed by **@D**, followed by a string of
-"\|"-separated words comprising the data fields defined in the
-header record.
-
-To allow for names and values containing spaces, such string items among
-the **@N** or **@D** specifiers must be enclosed in double quotes.
-(Where double quotes or pipe characters are included in the string, they
-must be escaped using "\\"). Where any data values are
-null, they will be represented as no characters between the field
-separator, (e.g., #@D\ \|\ \|\ \|). A Sample header
-and corresponding data line for points are
-
- ::
-
- # @VGMT1.0 @GPOINT @Nname|depth|id @Tstring|double|integer
- # @D"Point 1"|-34.5|1
-
-while for a polygon it may look like
-
- ::
-
- # @VGMT1.0 @GPOLYGON @Nname|depth|id @Tstring|double|integer
- >
- # @D"Area 1"|-34.5|1
-
-Polygon topologies
-~~~~~~~~~~~~~~~~~~
-
-New to GMT is the concept of polygon holes. Most other formats do
-support this structure, so that a polygon is specified as a sequence of
-point defining the perimeter, optionally followed by similar coordinate
-sequences defining any holes (the "donut" polygon concept).
-
-To implement this in a way which is compatible with previous
-GMT versions, each polygon feature must be able to be identified as
-the outer perimeter, or an inner ring (hole). This is done using a
-**@P** or **@H** on the data comment preceding the polygon coordinates.
-The **@P** specifies a new feature boundary (perimeter), any following
-**@H** polygons are holes, and must be within the preceding **@P**
-polygon (as described in the shapefile specification). Any **@H**
-polygons will NOT have any **@D** values, as the aspatial attribute data
-pertain to the entire feature, the **@H** polygons are not new polygons,
-but are merely a continuation of the definition of the same feature.
-
-Examples
---------
-
-Sample point, line and polygon files are (the new data structures are in
-lines starting with "#" in strings prefixed with "@"). Here is a typical
-point file:
-
- ::
-
- # @VGMT1.0 @GPOINT @Nname|depth|id
- # @Tstring|double|integer
- # @R178.43/178.5/-57.98/-34.5
- # @Je4326
- # @Jp"+proj=longlat +ellps=WGS84 +datum=WGS84+no_defs"
- # FEATURE_DATA
- # @D"point 1"|-34.5|1
- 178.5 -45.7
- # @D"Point 2"|-57.98|2
- 178.43 -46.8
- ...
-
-Next is an example of a line file:
-
- ::
-
- # @VGMT1.0 @GLINESTRING @Nname|depth|id
- # @Tstring|double|integer
- # @R178.1/178.6/-48.7/-45.6
- # @Jp"+proj=longlat +ellps=WGS84 +datum=WGS84+no_defs"
- # FEATURE_DATA
- > -W0.25p
- # @D"Line 1"|-50|1
- 178.5 -45.7
- 178.6 -48.2
- 178.4 -48.7
- 178.1 -45.6
- > -W0.25p
- # @D"Line 2"|-57.98|$
- 178.43 -46.8
- ...
-
-Finally we show an example of a polygon file:
-
- ::
-
- # @VGMT1.0 @GPOLYGON @N"Polygon name"|substrate|id @Tstring|string|integer
- # @R178.1/178.6/-48.7/-45.6
- # @Jj at Jp"+proj=longlat +ellps=WGS84 +datum=WGS84+no_defs"
- # FEATURE_DATA
- > -Gblue -W0.25p
- # @P
- # @D"Area 1"|finesand|1
- 178.1 -45.6
- 178.1 -48.2
- 178.5 -48.2
- 178.5 -45.6
- 178.1 -45.6
- >
- # @H
- # First hole in the preceding perimeter, so is technically still
- # part of the same geometry, despite the preceding > character.
- # No attribute data is provided, as this is inherited.
- 178.2 -45.4
- 178.2 -46.5
- 178.4 -46.5
- 178.4 -45.4
- 178.2 -45.4
- >
- # @P
- ...
-
-.. [1]
- Version 1.0 was then informally released at the Lamont-Doherty Earth Observatory.
-
-.. [2]
- See GNU Lesser General Public License (`<http://www.gnu.org/copyleft/gpl.html>`_)
- for terms on redistribution and modifications.
-
-.. [3]
- The tools can also be installed on other platforms (see Appendix [app:L]).
-
-.. [4]
- One public-domain RIP is ghostscript, available from `<http://www.gnu.org/>`_.
-
-.. [5]
- Programs now also allow for fast, binary multicolumn file i/o.
-
-.. [6]
- While the netCDF format is the default, many other formats are also possible.
-
-.. [7]
- Vicenty, T. (1975), Direct and inverse solutions of geodesics on the
- ellipsoid with application of nested equations, *Surv. Rev.,
- XXII(176)*, 88--93.
-
-.. [8]
- PostScript definition. In the typesetting industry a slightly
- different definition of point (1/72.27 inch) is used, presumably to
- cause needless trouble.
-
-.. [9]
- Choose between SI and US default units by modifying in the
- GMT share directory.
-
-.. [10]
- To remain backwards compatible with GMT 4 we will also look for
- but only if cannot be found.
-
-.. [11]
- The Gregorian Calendar is a revision of the Julian Calendar which was
- instituted in a papal bull by Pope Gregory XIII in 1582. The reason
- for the calendar change was to correct for drift in the dates of
- significant religious observations (primarily Easter) and to prevent
- further drift in the dates. The important effects of the change were
- (a) Drop 10 days from October 1582 to realign the Vernal Equinox with
- 21 March, (b) change leap year selection so that not all years ending
- in "00" are leap years, and (c) change the beginning of the year to 1
- January from 25 March. Adoption of the new calendar was essentially
- immediate within Catholic countries. In the Protestant countries,
- where papal authority was neither recognized not appreciated,
- adoption came more slowly. England finally adopted the new calendar
- in 1752, with eleven days removed from September. The additional day
- came because the old and new calendars disagreed on whether 1700 was
- a leap year, so the Julian calendar had to be adjusted by one more
- day.
-
-.. [12]
- While UTM coordinates clearly refer to points on the Earth, in this
- context they are considered "other". Thus, when we refer to
- "geographical" coordinates herein we imply longitude, latitude.
-
-.. [13]
- Please consult the man page for *printf* or any book on C.
-
-.. [14]
- For historical reasons, the GMT default is Landscape; see
- :doc:`gmt.conf` to change this.
-
-.. [15]
- Ensures that boundary annotations do not fall off the page.
-
-.. [16]
- To keep PostScript files small, such comments are by default turned
- off; see :ref:`PS_COMMENTS <PS_COMMENTS>` to enable them.
-
-.. [17]
- For an overview of color systems such as HSV, see Appendix [app:I].
-
-.. [18]
- Convert other graphics formats to Sun ras format using GraphicsMagick's
- or ImageMagick's **convert** program.
-
-.. [19]
- Requires building GMT with GDAL.
-
-.. [20]
- Snyder, J. P., 1987, Map Projections A Working Manual, U.S.
- Geological Survey Prof. Paper 1395.
-
-.. [21]
- This is, however, not the shortest distance. It is given by the great
- circle connecting the two points.
-
-.. [22]
- Robinson provided a table of *y*-coordinates for latitudes
- every 5. To project values for intermediate latitudes one must
- interpolate the table. Different interpolants may result in slightly
- different maps. GMT uses the
- interpolant selected by the parameter :ref:`GMT_INTERPOLANT <GMT_INTERPOLANT>` in the
- file.
-
-.. [23]
- These data are available on CD-ROM from NGDC (`<http://www.ngdc.noaa.gov/>`_).
-
-.. [24]
- See `<http://topex.ucsd.edu/marine_grav/mar_grav.html>`_.
-
-.. [25]
- Pedants who wish to argue about the "other" arc going the long way
- should consider using it.
-
-.. [26]
- While Quicktime is free you must upgrade to QuickTime Pro (USD 30) to
- use the authoring functions.
-
-.. [27]
- QuickTime Pro can do this, as can most video-editing programs.
-
-.. [28]
- For data bases, see `http://topex.ucsd.edu/marine_grav/mar_grav.html`_.
-
-.. [29]
- The ASCII MGD77 data are available on CD-ROM from NGDC (`<http://www.ngdc.noaa.gov/>`_).
-
-.. [30]
- Okabe, M., 1979, Analytical expressions for gravity anomalies due to
- polyhedral bodies and translation into magnetic anomalies,
- *Geophysics, 44*, 730--741.
-
-.. [31]
- `Timothy J. Henstock <http://www.southampton.ac.uk/oes/research/staff/then.page>`_,
- University of Southampton
-
-.. [32]
- If you chose SI units during the installation then the default
- encoding is ISOLatin1+, otherwise it is Standard+.
-
-.. [33]
- R. Bracewell, *The Fourier Transform and its Applications*,
- McGraw-Hill, London, 444 p., 1965.
-
-.. [34]
- `National Geophysical Data Center, Boulder, Colorado <http://www.ngdc.noaa.gov/>`_
-
-.. [35]
- Douglas, D.H., and T. K. Peucker, 1973, Algorithms for the reduction
- of the number of points required to represent a digitized line or its
- caricature, *Canadian Cartographer*, 10, 112--122.
-
-.. [36]
- The full and high resolution files are in separate archives because
- of their size. Not all users may need these files as the intermediate
- data set is better than the data provided with version 2.2.4.
-
-.. [37]
- If you need complete polygons in a simpler format, see the article on
- GSHHG (Wessel, P., and W. H. F. Smith, 1996, A Global,
- self-consistent, hierarchical, high-resolution shoreline database,
- *J. Geophys. Res. 101*, 8741--8743).
-
-.. [38]
- The 23rd palette is called *random* and produces a random set of
- colors suitable for categorical plots.
-
-.. [39]
- or whatever planet we are dealing with.
-
-.. [40]
- Travel times were calculated using Geoware's travel time calculator,
- **ttt**; see `<http://www.geoware-online.com/>`_.
-
-.. |degree| unicode:: U+00B0 .. degree sign
-
-.. vim: textwidth=78 noexpandtab tabstop=2 softtabstop=2 shiftwidth=2
diff --git a/doc_release/html/_sources/GR.txt b/doc_release/html/_sources/GR.txt
deleted file mode 100644
index e0fb221..0000000
--- a/doc_release/html/_sources/GR.txt
+++ /dev/null
@@ -1,35 +0,0 @@
-##
-GR
-##
-
-.. toctree::
- :maxdepth: 1
-
- greenspline
- grd2cpt
- grd2rgb
- grd2xyz
- grdblend
- grdclip
- grdcontour
- grdcut
- grdedit
- grdfft
- grdfilter
- grdgradient
- grdhisteq
- grdimage
- grdinfo
- grdlandmask
- grdmask
- grdmath
- grdpaste
- grdproject
- grdraster
- grdreformat
- grdsample
- grdtrack
- grdtrend
- grdvector
- grdview
- grdvolume
diff --git a/doc_release/html/_sources/Gallery.txt b/doc_release/html/_sources/Gallery.txt
deleted file mode 100644
index 629e7d7..0000000
--- a/doc_release/html/_sources/Gallery.txt
+++ /dev/null
@@ -1,276 +0,0 @@
-.. _example_gallery:
-
-The GMT historical collection
-=============================
-
-The 40 Examples
-----------------
-
-In this section we will be giving numerous examples of typical usage of
-GMT programs. In general, we will start with a raw data set,
-manipulate the numbers in various ways, then display the results in
-diagram or map view. The resulting plots will have in common that they
-are all made up of simpler plots that have been overlaid to create a
-complex illustration.
-
-+------------------+--------------------+---------------------+
-|:ref:`example_01` | :ref:`example_02` | :ref:`example_03` |
-| | | |
-| |ex01| | |ex02| | |ex03| |
-+------------------+--------------------+---------------------+
-|:ref:`example_04` | :ref:`example_05` | :ref:`example_06` |
-| | | |
-| |ex04| | |ex05| | |ex06| |
-+------------------+--------------------+---------------------+
-|:ref:`example_07` | :ref:`example_08` | :ref:`example_09` |
-| | | |
-| |ex07| | |ex08| | |ex09| |
-+------------------+--------------------+---------------------+
-|:ref:`example_10` | :ref:`example_11` | :ref:`example_12` |
-| | | |
-| |ex10| | |ex11| | |ex12| |
-+------------------+--------------------+---------------------+
-|:ref:`example_13` | :ref:`example_14` | :ref:`example_15` |
-| | | |
-| |ex13| | |ex14| | |ex15| |
-+------------------+--------------------+---------------------+
-|:ref:`example_16` | :ref:`example_17` | :ref:`example_18` |
-| | | |
-| |ex16| | |ex17| | |ex18| |
-+------------------+--------------------+---------------------+
-|:ref:`example_19` | :ref:`example_20` | :ref:`example_21` |
-| | | |
-| |ex19| | |ex20| | |ex21| |
-+------------------+--------------------+---------------------+
-|:ref:`example_22` | :ref:`example_23` | :ref:`example_24` |
-| | | |
-| |ex22| | |ex23| | |ex24| |
-+------------------+--------------------+---------------------+
-|:ref:`example_25` | :ref:`example_26` | :ref:`example_27` |
-| | | |
-| |ex25| | |ex26| | |ex27| |
-+------------------+--------------------+---------------------+
-|:ref:`example_28` | :ref:`example_29` | :ref:`example_30` |
-| | | |
-| |ex28| | |ex29| | |ex30| |
-+------------------+--------------------+---------------------+
-|:ref:`example_31` | :ref:`example_32` | :ref:`example_33` |
-| | | |
-| |ex31| | |ex32| | |ex33| |
-+------------------+--------------------+---------------------+
-|:ref:`example_34` | :ref:`example_35` | :ref:`example_36` |
-| | | |
-| |ex34| | |ex35| | |ex36| |
-+------------------+--------------------+---------------------+
-|:ref:`example_37` | :ref:`example_38` | :ref:`example_39` |
-| | | |
-| |ex37| | |ex38| | |ex39| |
-+------------------+--------------------+---------------------+
-|:ref:`example_40` | | |
-| | | |
-| |ex40| | | |
-+------------------+--------------------+---------------------+
-
-.. |ex01| image:: /_images/example_01.*
- :width: 150 px
-
-.. |ex02| image:: /_images/example_02.*
- :width: 150 px
-
-.. |ex03| image:: /_images/example_03.*
- :width: 150 px
-
-.. |ex04| image:: /_images/example_04.*
- :width: 150 px
-
-.. |ex05| image:: /_images/example_05.*
- :width: 150 px
-
-.. |ex06| image:: /_images/example_06.*
- :width: 150 px
-
-.. |ex07| image:: /_images/example_07.*
- :width: 150 px
-
-.. |ex08| image:: /_images/example_08.*
- :width: 150 px
-
-.. |ex09| image:: /_images/example_09.*
- :width: 150 px
-
-.. |ex10| image:: /_images/example_10.*
- :width: 150 px
-
-.. |ex11| image:: /_images/example_11.*
- :width: 150 px
-
-.. |ex12| image:: /_images/example_12.*
- :width: 150 px
-
-.. |ex13| image:: /_images/example_13.*
- :width: 150 px
-
-.. |ex14| image:: /_images/example_14.*
- :width: 150 px
-
-.. |ex15| image:: /_images/example_15.*
- :width: 150 px
-
-.. |ex16| image:: /_images/example_16.*
- :width: 150 px
-
-.. |ex17| image:: /_images/example_17.*
- :width: 150 px
-
-.. |ex18| image:: /_images/example_18.*
- :width: 150 px
-
-.. |ex19| image:: /_images/example_19.*
- :width: 150 px
-
-.. |ex20| image:: /_images/example_20.*
- :width: 150 px
-
-.. |ex21| image:: /_images/example_21.*
- :width: 150 px
-
-.. |ex22| image:: /_images/example_22.*
- :width: 150 px
-
-.. |ex23| image:: /_images/example_23.*
- :width: 150 px
-
-.. |ex24| image:: /_images/example_24.*
- :width: 150 px
-
-.. |ex25| image:: /_images/example_25.*
- :width: 150 px
-
-.. |ex26| image:: /_images/example_26.*
- :width: 150 px
-
-.. |ex27| image:: /_images/example_27.*
- :width: 150 px
-
-.. |ex28| image:: /_images/example_28.*
- :width: 150 px
-
-.. |ex29| image:: /_images/example_29.*
- :width: 150 px
-
-.. |ex30| image:: /_images/example_30.*
- :width: 150 px
-
-.. |ex31| image:: /_images/example_31.*
- :width: 150 px
-
-.. |ex32| image:: /_images/example_32.*
- :width: 150 px
-
-.. |ex33| image:: /_images/example_33.*
- :width: 150 px
-
-.. |ex34| image:: /_images/example_34.*
- :width: 150 px
-
-.. |ex35| image:: /_images/example_35.*
- :width: 150 px
-
-.. |ex36| image:: /_images/example_36.*
- :width: 150 px
-
-.. |ex37| image:: /_images/example_37.*
- :width: 150 px
-
-.. |ex38| image:: /_images/example_38.*
- :width: 150 px
-
-.. |ex39| image:: /_images/example_39.*
- :width: 150 px
-
-.. |ex40| image:: /_images/example_40.*
- :width: 150 px
-
-.. toctree::
- :hidden:
-
- gallery/ex01.rst
- gallery/ex02.rst
- gallery/ex03.rst
- gallery/ex04.rst
- gallery/ex05.rst
- gallery/ex06.rst
- gallery/ex07.rst
- gallery/ex08.rst
- gallery/ex09.rst
- gallery/ex10.rst
- gallery/ex11.rst
- gallery/ex12.rst
- gallery/ex13.rst
- gallery/ex14.rst
- gallery/ex15.rst
- gallery/ex16.rst
- gallery/ex17.rst
- gallery/ex18.rst
- gallery/ex19.rst
- gallery/ex20.rst
- gallery/ex21.rst
- gallery/ex22.rst
- gallery/ex23.rst
- gallery/ex24.rst
- gallery/ex25.rst
- gallery/ex26.rst
- gallery/ex27.rst
- gallery/ex28.rst
- gallery/ex29.rst
- gallery/ex30.rst
- gallery/ex31.rst
- gallery/ex32.rst
- gallery/ex33.rst
- gallery/ex34.rst
- gallery/ex35.rst
- gallery/ex36.rst
- gallery/ex37.rst
- gallery/ex38.rst
- gallery/ex39.rst
- gallery/ex40.rst
-
-
-Animations
-----------
-
-.. toctree::
- :maxdepth: 2
-
- gallery/anim_introduction.rst
-
-+------------------+----------------+
-|:ref:`anim_01` | :ref:`anim_02` |
-| | |
-| |anim01| | |anim02| |
-+------------------+----------------+
-|:ref:`anim_03` | :ref:`anim_04` |
-| | |
-| |anim03| | |anim04| |
-+------------------+----------------+
-
-.. |anim01| image:: /_images/anim_01.*
- :width: 150 px
-
-.. |anim02| image:: /_images/anim_02.*
- :width: 150 px
-
-.. |anim03| image:: /_images/anim_03.*
- :width: 150 px
-
-.. |anim04| image:: /_images/anim_04.*
- :width: 150 px
-
-.. toctree::
- :hidden:
-
- gallery/anim01.rst
- gallery/anim02.rst
- gallery/anim03.rst
- gallery/anim04.rst
-
diff --git a/doc_release/html/_sources/I.txt b/doc_release/html/_sources/I.txt
deleted file mode 100644
index 0b9f6c1..0000000
--- a/doc_release/html/_sources/I.txt
+++ /dev/null
@@ -1,8 +0,0 @@
-#
-I
-#
-
-.. toctree::
- :maxdepth: 1
-
- isogmt
diff --git a/doc_release/html/_sources/K.txt b/doc_release/html/_sources/K.txt
deleted file mode 100644
index f1dc36d..0000000
--- a/doc_release/html/_sources/K.txt
+++ /dev/null
@@ -1,8 +0,0 @@
-#
-K
-#
-
-.. toctree::
- :maxdepth: 1
-
- kml2gmt
diff --git a/doc_release/html/_sources/M.txt b/doc_release/html/_sources/M.txt
deleted file mode 100644
index 7d5051c..0000000
--- a/doc_release/html/_sources/M.txt
+++ /dev/null
@@ -1,9 +0,0 @@
-#
-M
-#
-
-.. toctree::
- :maxdepth: 1
-
- makecpt
- mapproject
diff --git a/doc_release/html/_sources/N.txt b/doc_release/html/_sources/N.txt
deleted file mode 100644
index 5302ba8..0000000
--- a/doc_release/html/_sources/N.txt
+++ /dev/null
@@ -1,8 +0,0 @@
-#
-N
-#
-
-.. toctree::
- :maxdepth: 1
-
- nearneighbor
diff --git a/doc_release/html/_sources/P.txt b/doc_release/html/_sources/P.txt
deleted file mode 100644
index 5801a2a..0000000
--- a/doc_release/html/_sources/P.txt
+++ /dev/null
@@ -1,8 +0,0 @@
-#
-P
-#
-
-.. toctree::
- :maxdepth: 1
-
- project
diff --git a/doc_release/html/_sources/PS.txt b/doc_release/html/_sources/PS.txt
deleted file mode 100644
index f740b92..0000000
--- a/doc_release/html/_sources/PS.txt
+++ /dev/null
@@ -1,23 +0,0 @@
-##
-PS
-##
-
-.. toctree::
- :maxdepth: 1
-
- ps2raster
- psbasemap
- psclip
- pscoast
- pscontour
- pshistogram
- psimage
- pslegend
- pslib
- psmask
- psrose
- psscale
- pstext
- pswiggle
- psxy
- psxyz
diff --git a/doc_release/html/_sources/S.txt b/doc_release/html/_sources/S.txt
deleted file mode 100644
index 3e7060c..0000000
--- a/doc_release/html/_sources/S.txt
+++ /dev/null
@@ -1,15 +0,0 @@
-#
-S
-#
-
-.. toctree::
- :maxdepth: 1
-
- sample1d
- spectrum1d
- sph2grd
- sphdistance
- sphinterpolate
- sphtriangulate
- splitxyz
- surface
diff --git a/doc_release/html/_sources/SUP_GSHHS.txt b/doc_release/html/_sources/SUP_GSHHS.txt
deleted file mode 100644
index ca53f72..0000000
--- a/doc_release/html/_sources/SUP_GSHHS.txt
+++ /dev/null
@@ -1,8 +0,0 @@
-#####
-GSHHG
-#####
-
-.. toctree::
- :maxdepth: 1
-
- supplements/gshhg/gshhg
diff --git a/doc_release/html/_sources/SUP_IMGSRC.txt b/doc_release/html/_sources/SUP_IMGSRC.txt
deleted file mode 100644
index 7a75ebe..0000000
--- a/doc_release/html/_sources/SUP_IMGSRC.txt
+++ /dev/null
@@ -1,9 +0,0 @@
-######
-IMGSRC
-######
-
-.. toctree::
- :maxdepth: 1
-
- supplements/img/img2grd
- supplements/img/img2google
diff --git a/doc_release/html/_sources/SUP_MECA.txt b/doc_release/html/_sources/SUP_MECA.txt
deleted file mode 100644
index 592e6a7..0000000
--- a/doc_release/html/_sources/SUP_MECA.txt
+++ /dev/null
@@ -1,11 +0,0 @@
-####
-MECA
-####
-
-.. toctree::
- :maxdepth: 1
-
- supplements/meca/pscoupe
- supplements/meca/psmeca
- supplements/meca/pspolar
- supplements/meca/psvelo
diff --git a/doc_release/html/_sources/SUP_MGD77.txt b/doc_release/html/_sources/SUP_MGD77.txt
deleted file mode 100644
index e0789d8..0000000
--- a/doc_release/html/_sources/SUP_MGD77.txt
+++ /dev/null
@@ -1,15 +0,0 @@
-#####
-MGD77
-#####
-
-.. toctree::
- :maxdepth: 1
-
- supplements/mgd77/mgd77convert
- supplements/mgd77/mgd77info
- supplements/mgd77/mgd77list
- supplements/mgd77/mgd77magref
- supplements/mgd77/mgd77manage
- supplements/mgd77/mgd77path
- supplements/mgd77/mgd77sniffer
- supplements/mgd77/mgd77track
diff --git a/doc_release/html/_sources/SUP_MISC.txt b/doc_release/html/_sources/SUP_MISC.txt
deleted file mode 100644
index fb862bf..0000000
--- a/doc_release/html/_sources/SUP_MISC.txt
+++ /dev/null
@@ -1,8 +0,0 @@
-####
-MISC
-####
-
-.. toctree::
- :maxdepth: 1
-
- supplements/misc/dimfilter
diff --git a/doc_release/html/_sources/SUP_POTENTIAL.txt b/doc_release/html/_sources/SUP_POTENTIAL.txt
deleted file mode 100644
index cd29b52..0000000
--- a/doc_release/html/_sources/SUP_POTENTIAL.txt
+++ /dev/null
@@ -1,12 +0,0 @@
-#########
-POTENTIAL
-#########
-
-.. toctree::
- :maxdepth: 1
-
- supplements/potential/gmtgravmag3d
- supplements/potential/gravfft
- supplements/potential/grdgravmag3d
- supplements/potential/grdredpol
- supplements/potential/grdseamount
diff --git a/doc_release/html/_sources/SUP_SEGY.txt b/doc_release/html/_sources/SUP_SEGY.txt
deleted file mode 100644
index 8487983..0000000
--- a/doc_release/html/_sources/SUP_SEGY.txt
+++ /dev/null
@@ -1,10 +0,0 @@
-####
-SEGY
-####
-
-.. toctree::
- :maxdepth: 1
-
- supplements/segy/pssegy
- supplements/segy/pssegyz
- supplements/segy/segy2grd
diff --git a/doc_release/html/_sources/SUP_SPOTTER.txt b/doc_release/html/_sources/SUP_SPOTTER.txt
deleted file mode 100644
index a5957de..0000000
--- a/doc_release/html/_sources/SUP_SPOTTER.txt
+++ /dev/null
@@ -1,14 +0,0 @@
-#######
-SPOTTER
-#######
-
-.. toctree::
- :maxdepth: 1
-
- supplements/spotter/backtracker
- supplements/spotter/grdpmodeler
- supplements/spotter/grdrotater
- supplements/spotter/grdspotter
- supplements/spotter/hotspotter
- supplements/spotter/originator
- supplements/spotter/rotconverter
diff --git a/doc_release/html/_sources/SUP_X2SYS.txt b/doc_release/html/_sources/SUP_X2SYS.txt
deleted file mode 100644
index 1e4b801..0000000
--- a/doc_release/html/_sources/SUP_X2SYS.txt
+++ /dev/null
@@ -1,17 +0,0 @@
-#####
-X2SYS
-#####
-
-.. toctree::
- :maxdepth: 1
-
- supplements/x2sys/x2sys_binlist
- supplements/x2sys/x2sys_cross
- supplements/x2sys/x2sys_datalist
- supplements/x2sys/x2sys_get
- supplements/x2sys/x2sys_init
- supplements/x2sys/x2sys_list
- supplements/x2sys/x2sys_merge
- supplements/x2sys/x2sys_put
- supplements/x2sys/x2sys_report
- supplements/x2sys/x2sys_solve
diff --git a/doc_release/html/_sources/T.txt b/doc_release/html/_sources/T.txt
deleted file mode 100644
index c4665b9..0000000
--- a/doc_release/html/_sources/T.txt
+++ /dev/null
@@ -1,10 +0,0 @@
-#
-T
-#
-
-.. toctree::
- :maxdepth: 1
-
- trend1d
- trend2d
- triangulate
diff --git a/doc_release/html/_sources/Users_contrib_script.txt b/doc_release/html/_sources/Users_contrib_script.txt
deleted file mode 100644
index 12f5d31..0000000
--- a/doc_release/html/_sources/Users_contrib_script.txt
+++ /dev/null
@@ -1,21 +0,0 @@
-.. _users_gallery:
-
-Users Script Contributions
----------------------------
-
-.. toctree::
- :hidden:
-
- gallery/users_contrib_script/vertical_slice.rst
-
-.. |0001| image:: gallery/users_contrib_script/images/vertical_slice.png
- :width: 150
-
-======= =============================================
-======= =============================================
-|0001| :ref:`vertical_slice`
- A script to plot a vertical slice of a
- function p=f(x, y, z)
-
-======= =============================================
-
diff --git a/doc_release/html/_sources/Users_contrib_symbols.txt b/doc_release/html/_sources/Users_contrib_symbols.txt
deleted file mode 100644
index 3f7ba5f..0000000
--- a/doc_release/html/_sources/Users_contrib_symbols.txt
+++ /dev/null
@@ -1,19 +0,0 @@
-.. _symbols_gallery:
-
-Users Symbol Contributions
----------------------------
-
-.. toctree::
- :hidden:
-
- gallery/users_contrib_symbols/pirata.rst
-
-.. |0001| image:: gallery/users_contrib_symbols/images/pirata.png
- :width: 150
-
-+-----------------+----------------+
-| :ref:`pirata` | |
-| | |
-| |0001| | |
-+-----------------+----------------+
-
diff --git a/doc_release/html/_sources/X.txt b/doc_release/html/_sources/X.txt
deleted file mode 100644
index e9ab1ee..0000000
--- a/doc_release/html/_sources/X.txt
+++ /dev/null
@@ -1,8 +0,0 @@
-#
-X
-#
-
-.. toctree::
- :maxdepth: 1
-
- xyz2grd
diff --git a/doc_release/html/_sources/api.txt b/doc_release/html/_sources/api.txt
deleted file mode 100644
index 52230cc..0000000
--- a/doc_release/html/_sources/api.txt
+++ /dev/null
@@ -1,9 +0,0 @@
-#######
-GMT_API
-#######
-
-.. toctree::
- :maxdepth: 1
- :numbered:
-
- GMT_API
diff --git a/doc_release/html/_sources/blockmean.txt b/doc_release/html/_sources/blockmean.txt
deleted file mode 100644
index b3895b6..0000000
--- a/doc_release/html/_sources/blockmean.txt
+++ /dev/null
@@ -1,141 +0,0 @@
-.. index:: ! blockmean
-
-*********
-blockmean
-*********
-
-.. only:: not man
-
- blockmean - Block average (*x*,\ *y*,\ *z*) data tables by L2 norm
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**blockmean** [ *table* ]
-|SYN_OPT-I|
-|SYN_OPT-R|
-[ **-C** ]
-[ **-E**\ [**p**] ] [ **-S**\ [**m**\ \|\ **n**\ \|\ **s**\ \|\ **w**] ]
-[ |SYN_OPT-V| ]
-[ **-W**\ [**i**\ \|\ **o**] ]
-[ |SYN_OPT-b| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-o| ]
-[ **-r** ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**blockmean** reads arbitrarily located (*x*,\ *y*,\ *z*) triples [or
-optionally weighted quadruples (*x*,\ *y*,\ *z*,\ *w*)] from standard
-input [or *table*] and writes to standard output a mean position and
-value for every non-empty block in a grid region defined by the **-R**
-and **-I** arguments. Either **blockmean**, :doc:`blockmedian`, or
-:doc:`blockmode` should be used as a pre-processor before running
-:doc:`surface` to avoid aliasing short wavelengths. These routines are also
-generally useful for decimating or averaging (*x*,\ *y*,\ *z*) data. You
-can modify the precision of the output format by editing the
-:ref:`FORMAT_FLOAT_OUT <FORMAT_FLOAT_OUT>` parameter in your :doc:`gmt.conf` file, or you may
-choose binary input and/or output to avoid loss of precision.
-
-Required Arguments
-------------------
-
-.. include:: explain_-I.rst_
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-R.rst_
-
-Optional Arguments
-------------------
-
-*table*
- 3 [or 4, see **-W**] column ASCII data table file(s) [or binary, see
- **-bi**] holding (*x*,\ *y*,\ *z*\ [,\ *w*])
- data values. [\ *w*] is an optional weight for the data. If no file
- is specified, **blockmean** will read from standard input.
-
-**-C**
- Use the center of the block as the output location [Default uses the mean location].
-
-**-E**\ [**p**]
- Provide Extended report which includes **s** (the standard deviation
- about the mean), **l**, the lowest value, and **h**, the high value
- for each block. Output order becomes
- *x*,\ *y*,\ *z*,\ *s*,\ *l*,\ *h*\ [,\ *w*]. [Default outputs
- *x*,\ *y*,\ *z*\ [,\ *w*]. See **-W** for *w* output.
- If **-Ep** is used we assume weights are 1/(sigma squared) and *s*
- becomes the propagated error of the mean.
-
-**-S**\ [**m**\ \|\ **n**\ \|\ **s**\ \|\ **w**]
- Use **-Sn** to report the number of points inside each block,
- **-Ss** to report the sum of all *z*-values inside a block, **-Sw**
- to report the sum of weights [Default (or **-Sm** reports mean value].
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-W**\ [**i**\ \|\ **o**]
- Weighted modifier[s]. Unweighted input and output has 3 columns
- *x*,\ *y*,\ *z*; Weighted i/o has 4 columns *x*,\ *y*,\ *z*,\ *w*.
- Weights can be used in input to construct weighted mean values in
- blocks. Weight sums can be reported in output for later combining
- several runs, etc. Use **-W** for weighted i/o, **-Wi** for weighted
- input only, **-Wo** for weighted output only. [Default uses
- unweighted i/o].
-
-.. |Add_-bi| replace:: [Default is 3 (or 4 if **-Wi** is set)].
-.. include:: explain_-bi.rst_
-
-
-.. |Add_-bo| replace:: [Default is 3 (or 4 if **-Wo** is set)]. **-E** adds 3 additional columns.
-.. include:: explain_-bo.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-.. include:: explain_-ocols.rst_
-
-.. |Add_nodereg| replace::
- Each block is the locus of points nearest the grid value location. For example, with
- **-R**\ 10/15/10/15 and **-I**\ 1: with the **-r** option 10 <=
- (*x*,\ *y*) < 11 is one of 25 blocks; without it 9.5 <= (*x*,\ *y*)
- < 10.5 is one of 36 blocks.
-.. include:: explain_nodereg.rst_
-
-.. include:: explain_colon.rst_
-.. include:: explain_help.rst_
-.. include:: explain_precision.rst_
-
-Examples
---------
-
-To find 5 by 5 minute block mean values from the ASCII data in hawaii.xyg, run
-
- ::
-
- gmt blockmean hawaii.xyg -R198/208/18/25 -I5m > hawaii_5x5.xyg
-
-See Also
---------
-
-:doc:`blockmedian`,
-:doc:`blockmode`,
-:doc:`gmt`,
-:doc:`gmt.conf`,
-:doc:`greenspline`,
-:doc:`nearneighbor`,
-:doc:`sphtriangulate`,
-:doc:`surface`,
-:doc:`triangulate`
diff --git a/doc_release/html/_sources/blockmedian.txt b/doc_release/html/_sources/blockmedian.txt
deleted file mode 100644
index 14baccc..0000000
--- a/doc_release/html/_sources/blockmedian.txt
+++ /dev/null
@@ -1,163 +0,0 @@
-.. index:: ! blockmedian
-
-***********
-blockmedian
-***********
-
-.. only:: not man
-
- blockmedian - Block average (*x*,\ *y*,\ *z*) data tables by L1 norm
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**blockmedian** [ *table* ]
-|SYN_OPT-I|
-|SYN_OPT-R|
-[ **-C** ]
-[ **-E**\ [**b**] ] [ **-E**\ **r**\ \|\ **s**\ [**-**] ] [ **-Q** ]
-[ **-T**\ *quantile* ]
-[ |SYN_OPT-V| ]
-[ **-W**\ [**i**\ \|\ **o**] ]
-[ |SYN_OPT-b| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-o| ]
-[ **-r** ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**blockmedian** reads arbitrarily located (*x*,\ *y*,\ *z*) triples [or
-optionally weighted quadruples (*x*,\ *y*,\ *z*,\ *w*)] from standard
-input [or *table*] and writes to standard output a median position and
-value for every non-empty block in a grid region defined by the **-R**
-and **-I** arguments. Either :doc:`blockmean`, **blockmedian**, or
-:doc:`blockmode` should be used as a pre-processor before running
-:doc:`surface` to avoid aliasing short wavelengths. These routines are also
-generally useful for decimating or averaging (*x*,\ *y*,\ *z*) data. You
-can modify the precision of the output format by editing the
-:ref:`FORMAT_FLOAT_OUT <FORMAT_FLOAT_OUT>` parameter in your :doc:`gmt.conf` file, or you may
-choose binary input and/or output to avoid loss of precision.
-
-Required Arguments
-------------------
-
-.. include:: explain_-I.rst_
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-R.rst_
-
-Optional Arguments
-------------------
-
-*table*
- 3 [or 4, see **-W**] column ASCII data table] column ASCII file(s)
- [or binary, see **-bi**] holding
- (*x*,\ *y*,\ *z*\ [,\ *w*]) data values. [\ *w*] is an optional weight
- for the data. If no file is specified, **blockmedian** will read
- from standard input.
-**-C**
- Use the center of the block as the output location [Default uses the
- median x and median y as location (but see **-Q**)]..
-**-E**\ [**b**\ ]
- Provide Extended report which includes **s** (the L1 scale of the
- median), **l**, the lowest value, and **h**, the high value for each
- block. Output order becomes
- *x*,\ *y*,\ *z*,\ *s*,\ *l*,\ *h*\ [,\ *w*]. [Default outputs
- *x*,\ *y*,\ *z*\ [,\ *w*]. For box-and-whisker calculation, use
- **-Eb** which will output
- *x*,\ *y*,\ *z*,\ *l*,\ *q25*,\ *q75*,\ *h*\ [,*w*], where *q25* and
- *q75* are the 25% and 75% quantiles, respectively. See **-W** for
- *w* output.
-**-E**\ **r**\ \|\ **s**\ [**-**\ ]
- Provide source id **s** or record number **r** output, i.e., append
- the source id or record number associated with the median value. If
- tied then report the record number of the higher of the two values;
- append **-** to instead report the record number of the lower value.
- Note that both **-E**\ [**b**\ ] and **-E**\ **r**\ [**-**\ ] may be
- specified. For **-E**\ **s** we expect input records of the form
- *x*,\ *y*,\ *z*\ [,\ *w*],\ *sid*, where *sid* is an unsigned integer
- source id.
-**-Q**
- (Quicker) Finds median *z* and (*x*,\ *y*) at that the median *z*
- [Default finds median *x*, median *y* independent of *z*]. Also see
- **-C**.
-**-T**\ *quantile*
- Sets the *quantile* of the distribution to be returned [Default is
- 0.5 which returns the median *z*]. Here, 0 < *quantile* < 1.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-W**\ [**i**\ \|\ **o**]
- Weighted modifier[s]. Unweighted input and output has 3 columns
- *x*,\ *y*,\ *z*; Weighted i/o has 4 columns *x*,\ *y*,\ *z*,\ *w*.
- Weights can be used in input to construct weighted mean values in
- blocks. Weight sums can be reported in output for later combining
- several runs, etc. Use **-W** for weighted i/o, **-Wi** for weighted
- input only, **-Wo** for weighted output only. [Default uses
- unweighted i/o].
-
-.. |Add_-bi| replace:: [Default is 3 (or 4 if **-Wi** is set)].
-.. include:: explain_-bi.rst_
-
-.. |Add_-bo| replace:: [Default is 3 (or 4 if **-Wo** is set)]. **-E** adds 3 additional columns.
-.. include:: explain_-bo.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-.. include:: explain_-ocols.rst_
-
-.. |Add_nodereg| replace::
- Each block is the locus of points nearest the grid value location. For example, with
- **-R**\ 10/15/10/15 and **-I**\ 1: with the **-r** option 10 <=
- (*x*,\ *y*) < 11 is one of 25 blocks; without it 9.5 <= (*x*,\ *y*)
- < 10.5 is one of 36 blocks.
-.. include:: explain_nodereg.rst_
-
-.. include:: explain_colon.rst_
-.. include:: explain_help.rst_
-.. include:: explain_precision.rst_
-
-Examples
---------
-
-To find 5 by 5 minute block medians from the double precision binary
-data in hawaii_b.xyg and output an ASCII table, run
-
- ::
-
- gmt blockmedian hawaii_b.xyg -R198/208/18/25 -I5m -bi3d > hawaii_5x5.xyg
-
-To compute the shape of a data distribution per bin via a
-box-and-whisker diagram we need the 0%, 25%, 50%, 75%, and 100%
-quantiles. To do so on a global 5 by 5 degree basis from the ASCII table
-depths.xyz and send output to an ASCII table, run
-
- ::
-
- gmt blockmedian depths.xyz -Rg -I5 -Eb -r > depths_5x5.txt
-
-See Also
---------
-
-:doc:`blockmean`,
-:doc:`blockmode`, :doc:`gmt`,
-:doc:`gmt.conf`,
-:doc:`greenspline`,
-:doc:`nearneighbor`,
-:doc:`surface`,
-:doc:`sphtriangulate`,
-:doc:`triangulate`
diff --git a/doc_release/html/_sources/blockmode.txt b/doc_release/html/_sources/blockmode.txt
deleted file mode 100644
index a5a6ce2..0000000
--- a/doc_release/html/_sources/blockmode.txt
+++ /dev/null
@@ -1,166 +0,0 @@
-.. index:: ! blockmode
-
-*********
-blockmode
-*********
-
-.. only:: not man
-
- blockmode - Block average (*x*,\ *y*,\ *z*) data tables by mode estimation
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**blockmode** [ *table* ]
-|SYN_OPT-I|
-|SYN_OPT-R|
-[ **-C** ]
-[ **-D**\ [*width*]\ [**+c**][**+a**\ \|\ **+l**\ \|\ **+h** ]
-[ **-E**\ **r**\ \|\ **s**\ [**-**] ] [ **-Q** ]
-[ |SYN_OPT-V| ]
-[ **-W**\ [**i**\ \|\ **o**] ]
-[ |SYN_OPT-b| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-o| ]
-[ **-r** ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**blockmode** reads arbitrarily located (*x*,\ *y*,\ *z*) triples [or
-optionally weighted quadruples (*x*,\ *y*,\ *z*,\ *w*)] from standard
-input [or *table*] and writes to standard output mode estimates of
-position and value for every non-empty block in a grid region defined by
-the **-R** and **-I** arguments. Either :doc:`blockmean`,
-:doc:`blockmedian`,
-or **blockmode** should be used as a pre-processor before running
-:doc:`surface` to avoid aliasing short wavelengths. These routines are also
-generally useful for decimating or averaging (*x*,\ *y*,\ *z*) data. You
-can modify the precision of the output format by editing the
-:ref:`FORMAT_FLOAT_OUT <FORMAT_FLOAT_OUT>` parameter in your :doc:`gmt.conf` file, or you may
-choose binary input and/or output to avoid loss of precision.
-
-Required Arguments
-------------------
-
-.. include:: explain_-I.rst_
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-R.rst_
-
-Optional Arguments
-------------------
-
-*table*
- 3 [or 4, see **-W**] column ASCII data table file(s) [or binary, see
- **-bi**] holding (*x*,\ *y*,\ *z*\ [,\ *w*])
- data values. [\ *w*] is an optional weight for the data. If no file
- is specified, **blockmode** will read from standard input.
-
-**-C**
- Use the center of the block as the output location [Default uses the
- modal xy location (but see **-Q**)]. **-C** overrides **-Q**.
-
-**-D**\ [*width*]\ [**+c**][**+a**\ \|\ **+l**\ \|\ **+h** ]
- Perform unweighted mode calculation via histogram binning, using the
- specified histogram *width*. Append **+c** to center bins so that
- their mid point is a multiple of *width* [uncentered].
- If multiple modes are found for a block we return the average mode [**+a**].
- Append **+l** or **+h** to return the low of high mode instead, respectively.
- If *width* is not given it will default to 1 provided your data set only
- contains integers. Also, for integer data and integer bin *width* we
- enforce bin centering (**+c**) and select the lowest mode (**+l**) if
- there are multiples. [Default mode is normally the Least Median of Squares (LMS) statistic].
-
-**-E**
- Provide Extended report which includes **s** (the L1 scale of the
- mode), **l**, the lowest value, and **h**, the high value for each
- block. Output order becomes
- *x*,\ *y*,\ *z*,\ *s*,\ *l*,\ *h*\ [,\ *w*]. [Default outputs
- *x*,\ *y*,\ *z*\ [,\ *w*]. See **-W** for *w* output.
-**-E**\ **r**\ \|\ **s**\ [**-**\ ]
- Provide source id **s** or record number **r** output, i.e., append
- the source id or record number associated with the modal value. If
- tied then report the record number of the higher of the two values;
- append **-** to instead report the record number of the lower value.
- Note that both **-E** and **-E**\ **r**\ [**-**\ ] may be specified.
- For **-E**\ **s** we expect input records of the form
- *x*,\ *y*,\ *z*\ [,\ *w*],\ *sid*, where *sid* is an unsigned integer
- source id.
-**-Q**
- (Quicker) Finds mode *z* and mean (*x*,\ *y*) [Default finds mode
- *x*, mode *y*, mode *z*].
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-W**\ [**i**\ \|\ **o**]
- Weighted modifier[s]. Unweighted input and output has 3 columns
- *x*,\ *y*,\ *z*; Weighted i/o has 4 columns *x*,\ *y*,\ *z*,\ *w*.
- Weights can be used in input to construct weighted mean values in
- blocks. Weight sums can be reported in output for later combining
- several runs, etc. Use **-W** for weighted i/o, **-Wi** for weighted
- input only, **-Wo** for weighted output only. [Default uses
- unweighted i/o].
-
-.. |Add_-bi| replace:: [Default is 3 (or 4 if **-Wi** is set)].
-.. include:: explain_-bi.rst_
-
-.. |Add_-bo| replace:: [Default is 3 (or 4 if **-Wo** is set)]. **-E** adds 3 additional columns.
-.. include:: explain_-bo.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-.. include:: explain_-ocols.rst_
-
-.. |Add_nodereg| replace::
- Each block is the locus of points nearest the grid value location. For example, with
- **-R**\ 10/15/10/15 and **-I**\ 1: with the **-r** option 10 <=
- (*x*,\ *y*) < 11 is one of 25 blocks; without it 9.5 <= (*x*,\ *y*)
- < 10.5 is one of 36 blocks.
-.. include:: explain_nodereg.rst_
-
-.. include:: explain_colon.rst_
-.. include:: explain_help.rst_
-.. include:: explain_precision.rst_
-
-Examples
---------
-
-To find 5 by 5 minute block mode estimates from the double precision
-binary data in hawaii_b.xyg and output an ASCII table, run:
-
- ::
-
- gmt blockmode hawaii_b.xyg -R198/208/18/25 -I5m -bi3d > hawaii_5x5.xyg
-
-To determine the most frequently occurring values per 5x5 block using histogram binning, with
-data representing integer counts, try
-
- ::
-
- gmt blockmode data.txt -R0/100/0/100 -I5 -r -C -D
-
-See Also
---------
-
-:doc:`blockmean`,
-:doc:`blockmedian`, :doc:`gmt`,
-:doc:`gmt.conf`,
-:doc:`greenspline`,
-:doc:`nearneighbor`,
-:doc:`sphtriangulate`,
-:doc:`surface`,
-:doc:`triangulate`
diff --git a/doc_release/html/_sources/cookbook.txt b/doc_release/html/_sources/cookbook.txt
deleted file mode 100644
index 29d09ad..0000000
--- a/doc_release/html/_sources/cookbook.txt
+++ /dev/null
@@ -1,9 +0,0 @@
-########
-CookBook
-########
-
-.. toctree::
- :maxdepth: 1
- :numbered:
-
- GMT_Docs
diff --git a/doc_release/html/_sources/filter1d.txt b/doc_release/html/_sources/filter1d.txt
deleted file mode 100644
index 54b6076..0000000
--- a/doc_release/html/_sources/filter1d.txt
+++ /dev/null
@@ -1,178 +0,0 @@
-.. index:: ! filter1d
-
-********
-filter1d
-********
-
-.. only:: not man
-
- filter1d - Do time domain filtering of 1-D data tables
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**filter1d** [ *table* ] **-F**\ *type<width>*\ [*mode*\ ]
-[ **-D**\ *increment* ] [ **-E** ] [ **-I**\ *ignore\_val* ]
-[ **-L**\ *lack\_width* ] [ **-N**\ *t\_col* ] [ **-Q**\ *q\_factor* ]
-[ **-S**\ *symmetry\_factor* ] [ **-T**\ *t\_min/t\_max/t\_inc*\ [**+**] ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-b| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-g| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-o| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**filter1d** is a general time domain filter for multiple column time
-series data. The user specifies which column is the time (i.e., the
-independent variable). (See **-N** option below). The fastest operation
-occurs when the input time series are equally spaced and have no gaps or
-outliers and the special options are not needed. **filter1d** has
-options **-L**, **-Q**, and **-S** for unevenly sampled data with gaps.
-
-Required Arguments
-------------------
-
-**-F**\ *type<width>*\ [*mode*]
- Sets the filter *type*. Choose among convolution and non-convolution
- filters. Append the filter code followed by the full filter
- *<width>* in same units as time column. Available convolution
- filters are:
-
- (**b**) Boxcar: All weights are equal.
-
- (**c**) Cosine Arch: Weights follow a cosine arch curve.
-
- (**g**) Gaussian: Weights are given by the Gaussian function.
-
- (**f**) Custom: Instead of *width* give name of a one-column file
- with your own weight coefficients.
-
- Non-convolution filters are:
-
- (**m**) Median: Returns median value.
-
- (**p**) Maximum likelihood probability (a mode estimator): Return
- modal value. If more than one mode is found we return their average
- value. Append - or + to the filter width if you rather want to
- return the smallest or largest of the modal values.
-
- (**l**) Lower: Return the minimum of all values.
-
- (**L**) Lower: Return minimum of all positive values only.
-
- (**u**) Upper: Return maximum of all values.
-
- (**U**) Upper: Return maximum or all negative values only.
-
- Upper case type **B**, **C**, **G**, **M**, **P**, **F** will use
- robust filter versions: i.e., replace outliers (2.5 L1 scale off
- median) with median during filtering.
-
- In the case of **L**\ \|\ **U** it is possible that no data passes
- the initial sign test; in that case the filter will return 0.0.
-
-Optional Arguments
-------------------
-
-.. |Add_intables| unicode:: 0x20 .. just an invisible code
-.. include:: explain_intables.rst_
-
-**-D**\ *increment*
- *increment* is used when series is NOT equidistantly sampled. Then
- *increment* will be the abscissae resolution, i.e., all abscissae
- will be rounded off to a multiple of *increment*. Alternatively,
- resample data with :doc:`sample1d`.
-
-**-E**
- Include Ends of time series in output. Default loses half the
- filter-width of data at each end.
-
-**-I**\ *ignore\_val*
- To ignore values; If an input value equals *ignore\_val* it will be set to NaN.
-
-**-L**\ *lack_width*
- Checks for Lack of data condition. If input data has a gap exceeding
- *width* then no output will be given at that point [Default does not check Lack].
-
-**-N**\ *t_col*
- Indicates which column contains the independent variable (time). The
- left-most column is # 0, the right-most is # (*n_cols* - 1). [Default is 0].
-
-**-Q**\ *q_factor*
- Assess Quality of output value by checking mean weight in
- convolution. Enter *q_factor* between 0 and 1. If mean weight <
- *q_factor*, output is suppressed at this point [Default does not check Quality].
-
-**-S**\ *symmetry_factor*
- Checks symmetry of data about window center. Enter a factor between
- 0 and 1. If ( (abs(n_left - n_right)) / (n_left + n_right) ) >
- *factor*, then no output will be given at this point [Default does
- not check Symmetry].
-
-**-T**\ *t_min/t_max/t_inc*\ [**+**\ ]
- Make evenly spaced time-steps from *t\_min* to *t_max* by *t_inc*
- [Default uses input times]. Append **+** to *t_inc* if you are
- specifying the number of equidistant points instead.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. |Add_-bi| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-bi.rst_
-
-.. |Add_-bo| replace:: [Default is same as input].
-.. include:: explain_-bo.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-g| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-g.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. include:: explain_-ocols.rst_
-
-.. include:: explain_colon.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_precision.rst_
-
-Examples
---------
-
-To filter the data set in the file cruise.gmtd containing evenly spaced
-gravity, magnetics, topography, and distance (in m) with a 10 km
-Gaussian filter, removing outliers, and output a filtered value every 2
-km between 0 and 100 km:
-
- ::
-
- gmt filter1d cruise.gmtd -T0/1.0e5/2000 -FG10000 -N3 -V > filtered_cruise.gmtd
-
-Data along track often have uneven sampling and gaps which we do not
-want to interpolate using :doc:`sample1d`. To find the median depth in a 50
-km window every 25 km along the track of cruise v3312, stored in
-v3312.dt, checking for gaps of 10km and asymmetry of 0.3:
-
- ::
-
- gmt filter1d v3312.dt -FM50 -T0/100000/25 -L10 -S0.3 > v3312_filt.dt
-
-See Also
---------
-
-:doc:`gmt` , :doc:`sample1d` , :doc:`splitxyz`
diff --git a/doc_release/html/_sources/fitcircle.txt b/doc_release/html/_sources/fitcircle.txt
deleted file mode 100644
index e4e7f0d..0000000
--- a/doc_release/html/_sources/fitcircle.txt
+++ /dev/null
@@ -1,132 +0,0 @@
-.. index:: ! fitcircle
-
-*********
-fitcircle
-*********
-
-.. only:: not man
-
- fitcircle - find mean position and pole of best-fit great [or small] circle to points on a sphere.
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**fitcircle** [ *table* ] **-L**\ *norm* [ **-S**\ [*lat*] ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-bi| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-g| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-o| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**fitcircle** reads lon,lat [or lat,lon] values from the first two
-columns on standard input [or *xyfile*]. These are converted to
-Cartesian three-vectors on the unit sphere. Then two locations are
-found: the mean of the input positions, and the pole to the great circle
-which best fits the input positions. The user may choose one or both of
-two possible solutions to this problem. The first is called **-L1** and
-the second is called **-L2**. When the data are closely grouped along a
-great circle both solutions are similar. If the data have large
-dispersion, the pole to the great circle will be less well determined
-than the mean. Compare both solutions as a qualitative check.
-
-The **-L1** solution is so called because it approximates the
-minimization of the sum of absolute values of cosines of angular
-distances. This solution finds the mean position as the Fisher average
-of the data, and the pole position as the Fisher average of the
-cross-products between the mean and the data. Averaging cross-products
-gives weight to points in proportion to their distance from the mean,
-analogous to the "leverage" of distant points in linear regression in the plane.
-
-The **-L2** solution is so called because it approximates the
-minimization of the sum of squares of cosines of angular distances. It
-creates a 3 by 3 matrix of sums of squares of components of the data
-vectors. The eigenvectors of this matrix give the mean and pole
-locations. This method may be more subject to roundoff errors when there
-are thousands of data. The pole is given by the eigenvector
-corresponding to the smallest eigenvalue; it is the least-well
-represented factor in the data and is not easily estimated by either method.
-
-Required Arguments
-------------------
-
-**-L**\ *norm*
- Specify the desired *norm* as 1 or 2, or use **-L** or **-L3** to
- see both solutions.
-
-Optional Arguments
-------------------
-
-*table*
- One or more ASCII [or binary, see **-bi**] files containing lon,lat [or lat,lon; see
- **-:**\ [**i**\ \|\ **o**]] values in the first 2 columns. If no
- file is specified, **fitcircle** will read from standard input.
-
-**-S**\ [*lat*]
- Attempt to fit a small circle instead of a great circle. The pole
- will be constrained to lie on the great circle connecting the pole
- of the best-fit great circle and the mean location of the data.
- Optionally append the desired fixed latitude of the small circle
- [Default will determine the latitude].
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. |Add_-bi| replace:: [Default is 2 input columns].
-.. include:: explain_-bi.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-g| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-g.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. include:: explain_-ocols.rst_
-
-.. include:: explain_colon.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_precision.rst_
-
-
-Examples
---------
-
-Suppose you have lon,lat,grav data along a twisty ship track in the file
-ship.xyg. You want to project this data onto a great circle and resample
-it in distance, in order to filter it or check its spectrum. Do the
-following:
-
- ::
-
- gmt fitcircle ship.xyg -L2
- gmt project ship.xyg -Cox/oy -Tpx/py -S -Fpz | sample1d -S-100 -I1 > output.pg
-
-Here, *ox*/*oy* is the lon/lat of the mean from **fitcircle**, and
-*px*/*py* is the lon/lat of the pole. The file output.pg has distance,
-gravity data sampled every 1 km along the great circle which best fits
-ship.xyg
-
-See Also
---------
-
-:doc:`gmt`,
-:doc:`gmtvector`,
-:doc:`project`,
-:doc:`mapproject`,
-:doc:`sample1d`
diff --git a/doc_release/html/_sources/gallery/anim01.txt b/doc_release/html/_sources/gallery/anim01.txt
deleted file mode 100644
index 7ffa3e1..0000000
--- a/doc_release/html/_sources/gallery/anim01.txt
+++ /dev/null
@@ -1,30 +0,0 @@
-.. _anim_01:
-
-(1) Animation of the sine function
-----------------------------------
-
-Our first animation is not very ambitious: We wish to plot the sine
-function from 0-360 and take snap shots every 20. To get a smooth curve
-we must sample the function much more frequently; we settle on 10 times
-more frequently than the frame spacing. We place a bright red circle at
-the leading edge of the curve, and as we move forward in time (here,
-angles) we dim the older circles to a dark red color. We add a label
-that indicates the current angle value. Once the 18 frames are completed
-we convert them to a single animated GIF file and write a plain HTML
-wrapper with a simple legend. Opening the HTML page in ``anim01.html``
-the browser will display the animation.
-
-.. literalinclude:: /_verbatim/anim_01.txt
- :language: bash
-
-Make sure you understand the purpose of all the steps in our script. In
-this case we did some trial-and-error to determine the exact values to
-use for the map projection, the region, the spacing around the frame,
-etc. so that the final result gave a reasonable layout. Do this planning
-on a single PostScript plot before running a lengthy animation script.
-
-.. figure:: /_images/anim_01.*
- :width: 400 px
- :align: center
-
- Animation of a simple sine function.
diff --git a/doc_release/html/_sources/gallery/anim02.txt b/doc_release/html/_sources/gallery/anim02.txt
deleted file mode 100644
index 4604df5..0000000
--- a/doc_release/html/_sources/gallery/anim02.txt
+++ /dev/null
@@ -1,27 +0,0 @@
-.. _anim_02:
-
-(2) Examining DEMs using variable illumination
-----------------------------------------------
-
-Our next animation uses a gridded topography for parts of Colorado (US);
-the file is distributed with the tutorial examples. Here, we want to use
-:doc:`grdimage </grdimage>` to generate a shaded-relief
-image sequence in which we sweep the illumination azimuth around the
-entire horizon. The resulting animation illustrates how changing the
-illumination azimuth can bring out subtle features (or artifacts) in the
-gridded data. The red arrow points in the direction of the illumination.
-
-.. literalinclude:: /_verbatim/anim_02.txt
- :language: bash
-
-As you can see, these sorts of animations are not terribly difficult to
-put together, especially since our vantage point is fixed. In the next
-example we will move the "camera" around and must therefore deal with
-how to frame perspective views.
-
-.. figure:: /_images/anim_02.*
- :width: 400 px
- :align: center
-
- Animation of a DEM using variable illumination.
-
diff --git a/doc_release/html/_sources/gallery/anim03.txt b/doc_release/html/_sources/gallery/anim03.txt
deleted file mode 100644
index 3ae56c8..0000000
--- a/doc_release/html/_sources/gallery/anim03.txt
+++ /dev/null
@@ -1,20 +0,0 @@
-.. _anim_03:
-
-(3) Orbiting a static map
--------------------------
-
-Our third animation keeps a fixed gridded data set but moves the camera
-angle around the full 360. We use
-:doc:`grdview </grdview>` to generate a shaded-relief
-image sequence using the new enhanced **-E** option. No additional
-information is plotted on the image. As before we produce an animated
-GIF image and a simple HTML wrapper for it.
-
-.. literalinclude:: /_verbatim/anim_03.txt
- :language: bash
-
-.. figure:: /_images/anim_03.*
- :width: 400 px
- :align: center
-
- Orbiting a static map.
diff --git a/doc_release/html/_sources/gallery/anim04.txt b/doc_release/html/_sources/gallery/anim04.txt
deleted file mode 100644
index abbbec4..0000000
--- a/doc_release/html/_sources/gallery/anim04.txt
+++ /dev/null
@@ -1,40 +0,0 @@
-.. _anim_04:
-
-(4) Flying over topography
---------------------------
-
-Our next animation simulates what an imaginary satellite might see as it
-passes in a great circle from New York to Miami at an altitude of 160
-km. We use the general perspective view projection with
-:doc:`grdimage </grdimage>` and use
-:doc:`project </project>` to create a great circle path
-between the two cities, sampled every 5 km. The main part of the script
-will make the DVD-quality frames from different view points, draw the
-path on the ground, and add frame numbers to each frame. As this
-animation generates 355 frames we can use 3rd party tools to turn the
-image sequence into a MPEG-4 movie. Note: At the moment,
-:doc:`grdview </grdview>` cannot use general perspective
-view projection to allow "fly-through" animations like Fledermaus; we
-expect to add this functionality in a future version.
-
-.. literalinclude:: /_verbatim/anim_04.txt
- :language: bash
-
-
-.. Need to include the following 0 px wide dummy image for video poster
-
-.. only:: html
-
- .. image:: /_images/anim_04.png
- :width: 0 px
-
-.. raw:: html
-
- <div class="figure align-center">
- <video width="720" height="480" poster="../_images/anim_04.png" controls>
- <source src="../_static/anim_04.mp4" type="video/mp4">
- <source src="../_static/anim_04.webm" type="video/webm">
- Your browser does not support the video tag.
- </video>
- <p class="caption">Flying over topography.</p>
- </div>
diff --git a/doc_release/html/_sources/gallery/anim_introduction.txt b/doc_release/html/_sources/gallery/anim_introduction.txt
deleted file mode 100644
index 44702e5..0000000
--- a/doc_release/html/_sources/gallery/anim_introduction.txt
+++ /dev/null
@@ -1,111 +0,0 @@
-Introduction
-=============
-
-Here we will explore what is
-involved in creating animations (i.e., movies). Of course, an animation
-is nothing more than a series of individual images played back in an
-orderly fashion. Here, these images will have been created with GMT.
-To ensure a smooth transition from frame to frame we will be following
-some general guidelines when writing our scripts. Since there is no
-"movie" mode in GMT we must take care of all the book-keeping in our
-script. Thus, animations may require a bit of planning and may use more
-advanced scripting than the previous static examples. Note: This is a
-new chapter introduced with the 4.4.0 version and should be considered
-work in progress.
-
-Most, if not all, animation scripts must deal with several specific
-phases of movie making:
-
-#. Define parameters that determine the dimension of the final movie.
-
-#. Pre-calculate all variables, data tables, grids, or background map
- layers that are *independent* of your time variable.
-
-#. Have a frame-number loop where each frame is created as a
- PostScript plot, then rasterized to a TIFF file of chosen
- dimension.
-
-#. Convert the individual frames to a single movie of suitable format.
-
-#. Clean up temporary files and eventually the individual frames.
-
-We will discuss these phases in more detail before showing our first
-example.
-
-#. There are several coordinates that you need to consider when planning
- your movie. The first is the coordinates of your data, i.e., the
- *user coordinates*. As with all GMT plots you will transform those
- to the second set of *plot coordinates* in inches (or cm) by applying
- a suitable region and map projection. As before, you normally do this
- with a particular paper size in mind. When printed you get a
- high-resolution plot in monochrome or color. However, movies are not
- device-independent and you must finally consider the third set of
- *pixel coordinates* which specifies the resolution of the final
- movie. We control the frame size by selecting a suitable *dpi*
- setting that will scale your physical dimensions to the desired frame
- size in pixels. If you decide up front on a particular resolution
- (e.g., 480 by 320 pixels) then you should specify a paper size and
- *dpi* so that their product yields the desired pixel dimensions. For
- instance, here it might make sense to plan your plotting on a 4.8 by
- 3.2 inch "paper" and use 100 *dpi* to convert it to pixels, but you
- are free to use any combination that multiplies to the desired
- dimensions. After deciding on frame size you need to consider how
- many frames your movie should have. This depends on lots of things
- such as how patient you are, how many frames per second you need and
- the time range of your animation. We recommend you use variables to
- specify the items that go into computing the number of frames so that
- you can easily test your script with a few frames before changing
- settings and running the full Hollywood production overnight.
-
-#. Depending on what you want to display, there are usually many
- elements that do not change between frames. Examples include a
- coastline base map for background, an overlay of text legends,
- perhaps some variables that hold information that will be used during
- the movie, and possibly subsets of larger data sets. Since
- movie-making can take a long time if you are ambitious, it is best to
- compute or plot all the elements that can be done outside your main
- frame-loop rather than waste time doing the same thing over and over
- again. You are then ready for the main loop.
-
-#. Initialize a frame counter to 0 and have a loop that continues until
- your frame counter equals the desired number of frames. You must use
- your frame counter to create a unique file name for each frame image
- so that the series of images can be lexically arranged. We recommend
- using the GMT shell function **gmt_set_framename** to format
- the frame counter with an adequate number of leading zeros; see our
- examples for details. The bulk of your main loop involves create the
- single PostScript plot for this particular frame (time). This can
- be trivial or a serious scripting exercise depending on what you want
- to show. We will give a few examples with increasing complexity. Once
- the PostScript plot is created you need to rasterize it; we
- recommend you use :doc:`ps2raster </ps2raster>` to
- generate a TIFF image at the agreed-upon resolution. We also
- recommend that you place all frame images in a sub-directory. You may
- increment your frame counter using **gmt_set_framenext**.
-
-#. Once you have all your frames you are ready to combine them into an
- animation. There are two general approaches. (a) If your image
- sequence is not too long then you can convert the images into a
- single animated GIF file. This file can be included in PowerPoint
- presentations or placed on a web page and will play back as a movie
- by pausing the specified amount between frames, optionally repeating
- the entire sequence one or more times. (b) For more elaborate
- projects you will need to convert the frames into a proper movie
- format such as Quicktime, AVI, MPEG-2, MPEG-4, etc., etc. There are
- both free and commercial tools that can help with this conversion and
- they tend to be platform-specific. Most movie tools such as iMovie or
- MovieMaker can ingest still images and let you specify the frame
- duration. Under OS X we prefer to use Quicktime 7. [1]_ . Another choice is to use the free
- `ffmpeg <https://ffmpeg.org/>`_ encoder. You will find yourself
- experimenting with compression settings and movie formats so that the
- final movie has the resolution and portability you require.
-
-#. Finally, when all is done you should delete any temporary files
- created. However, since creating the frames may take a lot of time it
- is best to not automatically delete the frame sub directory. That way
- you can redo the frames-to-movie conversion with different settings
- until you are satisfied.
-
-.. [1]
- While Quicktime 7 is free you must upgrade to QuickTime Pro (USD 30) to
- use the authoring functions. At some point Apple will discontinue this tool.
diff --git a/doc_release/html/_sources/gallery/ex01.txt b/doc_release/html/_sources/gallery/ex01.txt
deleted file mode 100644
index 5c1a6b4..0000000
--- a/doc_release/html/_sources/gallery/ex01.txt
+++ /dev/null
@@ -1,34 +0,0 @@
-.. _example_01:
-
-(1) Contour maps
-----------------
-
-We want to create two contour maps of the low order geoid using the
-Hammer equal area projection. Our gridded data file is called ``osu91a1f_16.nc`` and
-contains a global 1 by 1 gridded geoid (we will see how to make gridded
-files later). We would like to show one map centered on Greenwich and
-one centered on the dateline. Positive contours should be drawn with a
-solid pen and negative contours with a dashed pen. Annotations should
-occur for every 50 m contour level, and both contour maps should show
-the continents in light brown in the background. Finally, we want a
-rectangular frame surrounding the two maps. This is how it is done:
-
-.. literalinclude:: /_verbatim/example_01.txt
- :language: bash
-
-The first command draws a box surrounding the maps. This is followed by
-two sequences of :doc:`pscoast </pscoast>`, :doc:`grdcontour </grdcontour>`,
-:doc:`grdcontour </grdcontour>`. They differ in that the
-first is centered on Greenwich; the second on the dateline. We use the
-limit option (**-L**) in :doc:`grdcontour </grdcontour>`
-to select negative contours only and plot those with a dashed pen, then
-positive contours only and draw with a solid pen [Default]. The **-T**
-option causes tick marks pointing in the downhill direction to be drawn
-on the innermost, closed contours. For the upper panel we also added -
-and + to the local lows and highs. You can find this illustration as
-
-.. figure:: /_images/example_01.*
- :width: 500 px
- :align: center
-
- Contour maps of gridded data.
diff --git a/doc_release/html/_sources/gallery/ex02.txt b/doc_release/html/_sources/gallery/ex02.txt
deleted file mode 100644
index 1c4f5e7..0000000
--- a/doc_release/html/_sources/gallery/ex02.txt
+++ /dev/null
@@ -1,53 +0,0 @@
-.. _example_02:
-
-(2) Image presentations
------------------------
-
-As our second example we will demonstrate how to make color images from
-gridded data sets (again, we will defer the actual making of grid files
-to later examples). We will use :doc:`grdraster </grdraster>` to extract 2-D grid files
-of bathymetry and Geosat geoid heights and put the two images on the
-same page. The region of interest is the Hawaiian islands, and due to
-the oblique trend of the island chain we prefer to rotate our
-geographical data sets using an oblique Mercator projection defined by
-the hotspot pole at (68W, 69N). We choose the point (190, 25.5) to be
-the center of our projection (e.g., the local origin), and we want to
-image a rectangular region defined by the longitudes and latitudes of
-the lower left and upper right corner of region. In our case we choose
-(160, 20) and (220, 30) as the corners. We use
-:doc:`grdimage </grdimage>` to make the illustration:
-
-.. literalinclude:: /_verbatim/example_02.txt
- :language: bash
-
-The first step extracts the 2-D data sets from the local data base using
-:doc:`grdraster </grdraster>` that may be adapted to reflect
-the nature of your data base format. It automatically figures out the
-required extent of the region given the two corners points and the
-projection. The extreme meridians and parallels enclosing the oblique
-region is **-R**\ 159:50/220:10/3:10/47:35. This is the area extracted
-by :doc:`grdraster </grdraster>`. For your convenience
-we have commented out those lines and provided the two extracted files
-so you do not need :doc:`grdraster </grdraster>` to try
-this example. By using the embedded grid file format mechanism we saved
-the topography using kilometers as the data unit. We now have two grid
-files with bathymetry and geoid heights, respectively. We use
-:doc:`makecpt </makecpt>` to generate a linear color
-palette file ``geoid.cpt`` for the geoid and use
-:doc:`grd2cpt </grd2cpt>` to get a histogram-equalized
-cpt file ``topo.cpt`` for the topography data. To emphasize the structures in the
-data we calculate the slopes in the north-south direction using
-:doc:`grdgradient </grdgradient>`; these will be used to
-modulate the color image. Next we run
-:doc:`grdimage </grdimage>` to create a color-code image
-of the Geosat geoid heights, and draw a color legend to the right of the
-image with :doc:`psscale </psscale>`. Similarly, we run
-:doc:`grdimage </grdimage>` but specify **-Y**\ 4.5i to
-plot above the previous image. Adding scale and label the two plots a)
-and b) completes the illustration.
-
-.. figure:: /_images/example_02.*
- :width: 500 px
- :align: center
-
- Color images from gridded data.
diff --git a/doc_release/html/_sources/gallery/ex03.txt b/doc_release/html/_sources/gallery/ex03.txt
deleted file mode 100644
index cdb6ff3..0000000
--- a/doc_release/html/_sources/gallery/ex03.txt
+++ /dev/null
@@ -1,50 +0,0 @@
-.. _example_03:
-
-(3) Spectral estimation and xy-plots
-------------------------------------
-
-In this example we will show how to use the GMT programs
-:doc:`fitcircle </fitcircle>`, :doc:`project </project>`,
-:doc:`sample1d </sample1d>`, :doc:`spectrum1d </spectrum1d>`,
-:doc:`psxy </psxy>`, and
-:doc:`pstext </pstext>`. Suppose you have (lon, lat,
-gravity) along a satellite track in a file called ``sat.xyg``, and (lon, lat,
-gravity) along a ship track in a file called ``ship.xyg``. You want to make a
-cross-spectral analysis of these data. First, you will have to get the
-two data sets into equidistantly sampled time-series form. To do this,
-it will be convenient to project these along the great circle that best
-fits the sat track. We must use
-:doc:`fitcircle </fitcircle>` to find this great circle
-and choose the L\ :sub:`2` estimates of best pole. We project the data
-using :doc:`project </project>` to find out what their
-ranges are in the projected coordinate. The
-:doc:`gmtinfo </gmtinfo>` utility will report the minimum
-and maximum values for multi-column ASCII tables. Use this information
-to select the range of the projected distance coordinate they have in
-common. The script prompts you for that information after reporting the
-values. We decide to make a file of equidistant sampling points spaced 1
-km apart from -1167 to +1169, and use the UNIX utility **awk** to
-accomplish this step. We can then resample the projected data, and carry
-out the cross-spectral calculations, assuming that the ship is the input
-and the satellite is the output data. There are several intermediate
-steps that produce helpful plots showing the effect of the various
-processing steps (``example_03[a-f].ps``), while the final plot ``example_03.ps`` shows the ship and sat power
-in one diagram and the coherency on another diagram, both on the same
-page. Note the extended use of :doc:`pstext </pstext>`
-and :doc:`psxy </psxy>` to put labels and legends
-directly on the plots. For that purpose we often use **-Jx**\ 1i and
-specify positions in inches directly. Thus, the complete automated script reads:
-
-.. literalinclude:: /_verbatim/example_03.txt
- :language: bash
-
-The final illustration shows that the
-ship gravity anomalies have more power than altimetry derived gravity
-for short wavelengths and that the coherency between the two signals
-improves dramatically for wavelengths > 20 km.
-
-.. figure:: /_images/example_03.*
- :width: 500 px
- :align: center
-
- Spectral estimation and x=y-plots.
diff --git a/doc_release/html/_sources/gallery/ex04.txt b/doc_release/html/_sources/gallery/ex04.txt
deleted file mode 100644
index bb16857..0000000
--- a/doc_release/html/_sources/gallery/ex04.txt
+++ /dev/null
@@ -1,47 +0,0 @@
-.. _example_04:
-
-(4) A 3-D perspective mesh plot
--------------------------------
-
-This example will illustrate how to make a fairly complicated composite
-figure. We need a subset of the ETOPO5 bathymetry [1]_ and Geosat geoid
-data sets which we will extract from the local data bases using
-:doc:`grdraster </grdraster>`. We would like to show a
-2-layer perspective plot where layer one shows a contour map of the
-marine geoid with the location of the Hawaiian islands superposed, and a
-second layer showing the 3-D mesh plot of the topography. We also add an
-arrow pointing north and some text. The first part of this script shows
-how to do it:
-
-.. literalinclude:: /_verbatim/example_04.txt
- :language: bash
-
-The purpose of the color palette file ``zero.cpt`` is to have the positive topography
-mesh painted light gray (the remainder is white). The left side of
-Figure shows the complete illustration.
-
-.. figure:: /_images/example_04.*
- :width: 500 px
- :align: center
-
- 3-D perspective mesh plot (left) and colored version (right).
-
-The second part of the script shows how to make the color version of
-this figure that was printed in our first article in *EOS Trans. AGU* (8
-October 1991). Using :doc:`grdview </grdview>` one can
-choose to either plot a mesh surface (left) or a color-coded surface
-(right). We have also added artificial illumination from a light-source
-due north, which is simulated by computing the gradient of the surface
-grid in that direction though the
-:doc:`grdgradient </grdgradient>` program. We choose to
-use the **-Qc** option in :doc:`grdview </grdview>` to
-achieve a high degree of smoothness. Here, we select 100 dpi since that
-will be the resolution of our final raster (The EOS raster was 300 dpi).
-Note that the size of the resulting output file is directly dependent on
-the square of the dpi chosen for the scanline conversion and how well
-the resulting image compresses. A higher value for dpi in **-Qc** would
-have resulted in a much larger output file. The CPT files were taken
-from Section [sec:example\ :sub:`0`\ 2].
-
-.. [1]
- These data are available on CD-ROM from NGDC (www.ngdc.noaa.gov).
diff --git a/doc_release/html/_sources/gallery/ex05.txt b/doc_release/html/_sources/gallery/ex05.txt
deleted file mode 100644
index 9ff778a..0000000
--- a/doc_release/html/_sources/gallery/ex05.txt
+++ /dev/null
@@ -1,37 +0,0 @@
-.. _example_05:
-
-(5) A 3-D illuminated surface (in bw)
--------------------------------------
-
-Instead of a mesh plot we may choose to show 3-D surfaces using
-artificial illumination. For this example we will use
-:doc:`grdmath </grdmath>` to make a grid file that
-contains the surface given by the function
-:math:`z(x, y) = \cos (2\pi r/8)\cdot e^{-r/10}`, where
-:math:`r^2 = (x^2 + y^2)`. The illumination is obtained by passing two
-grid files to :doc:`grdview </grdview>`: One with the
-*z*-values (the surface) and another with intensity values (which should
-be in the 1 range). We use
-:doc:`grdgradient </grdgradient>` to compute the
-horizontal gradients in the direction of the artificial light source.
-The ``gray.cpt`` file only has one line that states that all *z* values should have
-the gray level 128. Thus, variations in shade are entirely due to
-variations in gradients, or illuminations. We choose to illuminate from
-the SW and view the surface from SE:
-
-.. literalinclude:: /_verbatim/example_05.txt
- :language: bash
-
-The variations in intensity could be made more dramatic by using
-:doc:`grdmath </grdmath>` to scale the intensity file
-before running :doc:`grdview </grdview>`. For very rough
-data sets one may improve the smoothness of the intensities by passing
-the output of :doc:`grdgradient </grdgradient>` to
-:doc:`grdhisteq </grdhisteq>`. The shell-script above
-will result in a plot like the one in Figure.
-
-.. figure:: /_images/example_05.*
- :width: 500 px
- :align: center
-
- 3-D illuminated surface.
diff --git a/doc_release/html/_sources/gallery/ex06.txt b/doc_release/html/_sources/gallery/ex06.txt
deleted file mode 100644
index 7cc575f..0000000
--- a/doc_release/html/_sources/gallery/ex06.txt
+++ /dev/null
@@ -1,23 +0,0 @@
-.. _example_06:
-
-(6) Plotting of histograms
---------------------------
-
-GMT provides two tools to render histograms:
-:doc:`pshistogram </pshistogram>` and :doc:`psrose </psrose>`. The former takes care of
-regular histograms whereas the latter deals with polar histograms (rose
-diagrams, sector diagrams, and wind rose diagrams). We will show an
-example that involves both programs. The file ``fractures.yx`` contains a compilation of
-fracture lengths and directions as digitized from geological maps. The
-file ``v3206.t`` contains all the bathymetry measurements from *Vema* cruise 3206.
-Our complete figure was made running
-this script:
-
-.. literalinclude:: /_verbatim/example_06.txt
- :language: bash
-
-.. figure:: /_images/example_06.*
- :width: 500 px
- :align: center
-
- Two kinds of histograms.
diff --git a/doc_release/html/_sources/gallery/ex07.txt b/doc_release/html/_sources/gallery/ex07.txt
deleted file mode 100644
index 12ac4b3..0000000
--- a/doc_release/html/_sources/gallery/ex07.txt
+++ /dev/null
@@ -1,34 +0,0 @@
-.. _example_07:
-
-(7) A simple location map
--------------------------
-
-Many scientific papers start out by showing a location map of the region
-of interest. This map will typically also contain certain features and
-labels. This example will present a location map for the equatorial
-Atlantic ocean, where fracture zones and mid-ocean ridge segments have
-been plotted. We also would like to plot earthquake locations and
-available isochrons. We have obtained one file, ``quakes.xym``, which contains the
-position and magnitude of available earthquakes in the region. We choose
-to use magnitude/100 for the symbol-size in inches. The digital fracture
-zone traces (``fz.xy``) and isochrons (0 isochron as ``ridge.xy``, the rest as ``isochrons.xy``) were
-digitized from available maps [1]_. We create the final location map
-with the following script:
-
-.. literalinclude:: /_verbatim/example_07.txt
- :language: bash
-
-The same figure could equally well be made in color, which could be
-rasterized and made into a slide for a meeting presentation. The script
-is similar to the one outlined above, except we would choose a color for
-land and oceans, and select colored symbols and pens rather than black
-and white.
-
-.. figure:: /_images/example_07.*
- :width: 500 px
- :align: center
-
- A typical location map.
-
-.. [1]
- These data are available on CD-ROM from NGDC (www.ngdc.noaa.gov).
diff --git a/doc_release/html/_sources/gallery/ex08.txt b/doc_release/html/_sources/gallery/ex08.txt
deleted file mode 100644
index 6b7c9b4..0000000
--- a/doc_release/html/_sources/gallery/ex08.txt
+++ /dev/null
@@ -1,21 +0,0 @@
-.. _example_08:
-
-(8) A 3-D histogram
--------------------
-
-The program :doc:`psxyz </psxyz>` allows us to plot
-three-dimensional symbols, including columnar plots. As a simple
-demonstration, we will convert a gridded netCDF of bathymetry into an
-ASCII *xyz* table and use the height information to draw a 2-D
-histogram in a 3-D perspective view. Our gridded bathymetry file is
-called ``guinea_bay.nc`` and covers the region from 0 to 5 E and 0 to 5 N. Depth ranges
-from -5000 meter to sea-level. We produce the Figure by running this script:
-
-.. literalinclude:: /_verbatim/example_08.txt
- :language: bash
-
-.. figure:: /_images/example_08.*
- :width: 500 px
- :align: center
-
- A 3-D histogram.
diff --git a/doc_release/html/_sources/gallery/ex09.txt b/doc_release/html/_sources/gallery/ex09.txt
deleted file mode 100644
index 7f27a84..0000000
--- a/doc_release/html/_sources/gallery/ex09.txt
+++ /dev/null
@@ -1,38 +0,0 @@
-.. _example_09:
-
-(9) Time-series along tracks
-----------------------------
-
-A common application in many scientific disciplines involves plotting
-one or several time-series as as "wiggles" along tracks. Marine
-geophysicists often display magnetic anomalies in this manner, and
-seismologists use the technique when plotting individual seismic traces.
-In our example we will show how a set of Geosat sea surface slope
-profiles from the south Pacific can be plotted as "wiggles" using the
-:doc:`pswiggle </pswiggle>` program. We will embellish
-the plot with track numbers, the location of the Pacific-Antarctic
-Ridge, recognized fracture zones in the area, and a "wiggle" scale. The
-Geosat tracks are stored in the file ``tracks.txt``, the ridge in ``ridge.xy``, and all the
-fracture zones are stored in the multiple segment file ``fz.xy``. The
-profile id is contained in the segment headers and we wish to use the
-last data point in each of the track segments to construct an input file
-for :doc:`pstext </pstext>` that will label each profile
-with the track number. We know the profiles trend approximately N40E so
-we want the labels to have that same orientation (i.e., the angle with
-the baseline must be 50). We do this by extracting the last record from
-each track and select segment header as textstring when running
-the output through :doc:`pstext </pstext>`. Note we
-offset the positions by -0.05 inch with **-D** in order to have a small
-gap between the profile and the label:
-
-.. literalinclude:: /_verbatim/example_09.txt
- :language: bash
-
-The output shows the sea-surface slopes along 42 descending Geosat
-tracks in the Eltanin and Udintsev fracture zone region in a Mercator projection.
-
-.. figure:: /_images/example_09.*
- :width: 500 px
- :align: center
-
- Time-series as wiggles along a track.
diff --git a/doc_release/html/_sources/gallery/ex10.txt b/doc_release/html/_sources/gallery/ex10.txt
deleted file mode 100644
index d8d6552..0000000
--- a/doc_release/html/_sources/gallery/ex10.txt
+++ /dev/null
@@ -1,27 +0,0 @@
-.. _example_10:
-
-(10) A geographical bar graph plot
-----------------------------------
-
-Our next and perhaps most business-like example presents a
-three-dimensional bar graph plot showing the geographic distribution of
-all the languages of the world. The input data
-was taken from `Ethnologue <http://www.ethnologue.com/>`_. We decide to plot a 3-D column
-centered on each continent with a height that is proportional to the
-languages used. We choose a plain
-linear projection for the basemap and add the columns and text on top.
-Eventually we make it a bit more fancy by splitting the columns up in different colors
-indicating how commonly the languages are used, from institutional languages to
-languages threatened by extinction.
-The script also shows how to effectively use transparency of the boxes around the numbers
-and in the shade surrounding the legend.
-Our script that produces Figure ex_10 reads:
-
-.. literalinclude:: /_verbatim/example_10.txt
- :language: bash
-
-.. figure:: /_images/example_10.*
- :width: 500 px
- :align: center
-
- Geographical bar graph.
diff --git a/doc_release/html/_sources/gallery/ex11.txt b/doc_release/html/_sources/gallery/ex11.txt
deleted file mode 100644
index 40919c0..0000000
--- a/doc_release/html/_sources/gallery/ex11.txt
+++ /dev/null
@@ -1,38 +0,0 @@
-.. _example_11:
-
-(11) A 3-D RGB color cube
--------------------------
-
-In this example we generate a series of 6 color images, arranged so that
-they can be cut out and assembled into a 3-D color cube. The six faces
-of the cube represent the outside of the R-G-B color space. On each face
-one of the color components is fixed at either 0 or 255 and the other
-two components vary smoothly across the face from 0 to 255. The cube is
-configured as a right-handed coordinate system with *x-y-z* mapping
-R-G-B. Hence, the 8 corners of the cube represent the primaries red,
-green, and blue, plus the secondaries cyan, magenta and yellow, plus
-black and white.
-
-The 6 color faces are generated by feeding
-:doc:`grdimage </grdimage>` three grids, one for each
-color component (R, G, and B). In some cases the X or Y axes of a face
-are reversed by specifying a negative width or height in order to change
-the variation of the color value in that direction from ascending to
-descending, or vice versa.
-
-A number of rays emanating from the white and black corners indicate the
-Hue value (ranging from 0 to 360). The dashed and dotted lines near the
-white corner reflect saturation levels, running from 0 to 1 (in black
-font). On these 3 faces the brightness is a constant value of 1. On the
-other 3 faces of the cube, around the black corner, the white decimal
-numbers indicate brightnesses between 0 and 1, with saturation fixed at 1.
-
-.. literalinclude:: /_verbatim/example_11.txt
- :language: bash
-
-
-.. figure:: /_images/example_11.*
- :width: 500 px
- :align: center
-
- The RGB color cube.
diff --git a/doc_release/html/_sources/gallery/ex12.txt b/doc_release/html/_sources/gallery/ex12.txt
deleted file mode 100644
index 85b0448..0000000
--- a/doc_release/html/_sources/gallery/ex12.txt
+++ /dev/null
@@ -1,25 +0,0 @@
-.. _example_12:
-
-(12) Optimal triangulation of data
-----------------------------------
-
-Our next example operates on a data
-set of topographic readings non-uniformly distributed in the plane
-(Table 5.11 in Davis: *Statistics and Data Analysis in Geology*, J.
-Wiley). We use :doc:`triangulate </triangulate>` to
-perform the optimal Delaunay triangulation, then use the output to draw
-the resulting network. We label the node numbers as well as the node
-values, and call :doc:`pscontour </pscontour>` to make a
-contour map and image directly from the raw data. Thus, in this example
-we do not actually make grid files but still are able to contour and
-image the data. We use a color palette table ``topo.cpt`` (created via
-:doc:`gmtinfo </gmtinfo>` and :doc:`makecpt </makecpt>`). The script becomes:
-
-.. literalinclude:: /_verbatim/example_12.txt
- :language: bash
-
-.. figure:: /_images/example_12.*
- :width: 500 px
- :align: center
-
- Optimal triangulation of data.
diff --git a/doc_release/html/_sources/gallery/ex13.txt b/doc_release/html/_sources/gallery/ex13.txt
deleted file mode 100644
index 5fa9faf..0000000
--- a/doc_release/html/_sources/gallery/ex13.txt
+++ /dev/null
@@ -1,26 +0,0 @@
-.. _example_13:
-
-(13) Plotting of vector fields
-------------------------------
-
-In many areas, such as fluid dynamics and elasticity, it is desirable to
-plot vector fields of various kinds. GMT provides a way to illustrate
-2-component vector fields using the
-:doc:`grdvector </grdvector>` utility. The two
-components of the field (Cartesian or polar components) are stored in
-separate grid files. In this example we use
-:doc:`grdmath </grdmath>` to generate a surface
-:math:`z(x, y) = x \cdot \exp(-x^2 -y^2)` and to calculate
-:math:`\nabla z` by returning the *x*- and *y*-derivatives separately.
-We superpose the gradient vector field and the surface *z* and also plot
-the components of the gradient in separate windows. A
-:doc:`pstext </pstext>` call to place a header finishes the plot
-
-.. literalinclude:: /_verbatim/example_13.txt
- :language: bash
-
-.. figure:: /_images/example_13.*
- :width: 500 px
- :align: center
-
- Display of vector fields in GMT.
diff --git a/doc_release/html/_sources/gallery/ex14.txt b/doc_release/html/_sources/gallery/ex14.txt
deleted file mode 100644
index 01b1aad..0000000
--- a/doc_release/html/_sources/gallery/ex14.txt
+++ /dev/null
@@ -1,34 +0,0 @@
-.. _example_14:
-
-(14) Gridding of data and trend surfaces
-----------------------------------------
-
-This example shows how one goes from randomly spaced data points to an
-evenly sampled surface. First we plot the distribution and values of our
-raw data set (same as in Section [sec:example\ :sub:`1`\ 2]). We choose an equidistant grid and run
-:doc:`blockmean </blockmean>` which preprocesses the
-data to avoid aliasing. The dashed lines indicate the logical blocks
-used by :doc:`blockmean </blockmean>`; all points inside
-a given bin will be averaged. The logical blocks are drawn from a
-temporary file we make on the fly within the shell script. The processed
-data is then gridded with the :doc:`surface </surface>`
-program and contoured every 25 units. A most important point here is
-that :doc:`blockmean </blockmean>`, :doc:`blockmedian </blockmedian>`, or
-:doc:`blockmode </blockmode>` should always be run prior
-to running :doc:`surface </surface>`, and both of these
-steps must use the same grid interval. We use
-:doc:`grdtrend </grdtrend>` to fit a bicubic trend
-surface to the gridded data, contour it as well, and sample both grid
-files along a diagonal transect using
-:doc:`grdtrack </grdtrack>`. The bottom panel compares
-the gridded (solid line) and bicubic trend (dashed line) along the
-transect using :doc:`psxy </psxy>`
-
-.. literalinclude:: /_verbatim/example_14.txt
- :language: bash
-
-.. figure:: /_images/example_14.*
- :width: 500 px
- :align: center
-
- Gridding of data and trend surfaces.
diff --git a/doc_release/html/_sources/gallery/ex15.txt b/doc_release/html/_sources/gallery/ex15.txt
deleted file mode 100644
index 8fd1e5f..0000000
--- a/doc_release/html/_sources/gallery/ex15.txt
+++ /dev/null
@@ -1,36 +0,0 @@
-.. _example_15:
-
-(15) Gridding, contouring, and masking of unconstrained areas
--------------------------------------------------------------
-
-This example demonstrates some off the
-different ways one can use to grid data in GMT, and how to deal with
-unconstrained areas. We first convert a large ASCII file to binary with
-:doc:`gmtconvert </gmtconvert>` since the binary file
-will read and process much faster. Our lower left plot illustrates the
-results of gridding using a nearest neighbor technique
-(:doc:`nearneighbor </nearneighbor>`) which is a local
-method: No output is given where there are no data. Next (lower right),
-we use a minimum curvature technique
-(:doc:`surface </surface>`) which is a global method.
-Hence, the contours cover the entire map although the data are only
-available for portions of the area (indicated by the gray areas plotted
-using :doc:`psmask </psmask>`). The top left scenario
-illustrates how we can create a clip path (using
-:doc:`psmask </psmask>`) based on the data coverage to
-eliminate contours outside the constrained area. Finally (top right) we
-simply employ :doc:`pscoast </pscoast>` to overlay gray
-land masses to cover up the unwanted contours, and end by plotting a
-star at the deepest point on the map with
-:doc:`psxy </psxy>`. This point was extracted from the
-grid files using :doc:`grdinfo </grdinfo>`.
-
-.. literalinclude:: /_verbatim/example_15.txt
- :language: bash
-
-.. figure:: /_images/example_15.*
- :width: 500 px
- :align: center
-
- Gridding, contouring, and masking of data.
-
diff --git a/doc_release/html/_sources/gallery/ex16.txt b/doc_release/html/_sources/gallery/ex16.txt
deleted file mode 100644
index 04971ac..0000000
--- a/doc_release/html/_sources/gallery/ex16.txt
+++ /dev/null
@@ -1,63 +0,0 @@
-.. _example_16:
-
-(16) Gridding of data, continued
---------------------------------
-
-:doc:`pscontour </pscontour>` (for contouring) and
-:doc:`triangulate </triangulate>` (for gridding) use the
-simplest method of interpolating data: a Delaunay triangulation (see
-Section [sec:example\ :sub:`1`\ 2]) which forms *z(x, y)* as a
-union of planar triangular facets. One advantage of this method is that
-it will not extrapolate *z(x, y)* beyond the convex hull of the
-input (*x, y*) data. Another is that it will not estimate a *z* value
-above or below the local bounds on any triangle. A disadvantage is that
-the *z(x, y)* surface is not differentiable, but has sharp kinks
-at triangle edges and thus also along contours. This may not look
-physically reasonable, but it can be filtered later (last panel below).
-:doc:`surface </surface>` can be used to generate a
-higher-order (smooth and differentiable) interpolation of
-*z(x, y)* onto a grid, after which the grid may be illustrated
-(:doc:`grdcontour </grdcontour>`, :doc:`grdimage </grdimage>`,
-:doc:`grdview </grdview>`).
-:doc:`surface </surface>` will interpolate to all (*x,
-y*) points in a rectangular region, and thus will extrapolate beyond the
-convex hull of the data. However, this can be masked out in various ways
-(see Section [sec:example\ :sub:`1`\ 5]).
-
-A more serious objection is that :doc:`surface </surface>` may estimate *z* values
-outside the local range of the data (note area near *x* = 0.8, *y* =
-5.3). This commonly happens when the default tension value of zero is
-used to create a "minimum curvature" (most smooth) interpolant.
-:doc:`surface </surface>` can be used with non-zero
-tension to partially overcome this problem. The limiting value
-*tension = 1* should approximate the triangulation, while a value
-between 0 and 1 may yield a good compromise between the above two cases.
-A value of 0.5 is shown here (Figure [fig:example:sub:`1`\ 6]). A side
-effect of the tension is that it tends to make the contours turn near
-the edges of the domain so that they approach the edge from a
-perpendicular direction. A solution is to use
-:doc:`surface </surface>` in a larger area and then use
-:doc:`grdcut </grdcut>` to cut out the desired smaller
-area. Another way to achieve a compromise is to interpolate the data to
-a grid and then filter the grid using :doc:`grdfft </grdfft>` or
-:doc:`grdfilter </grdfilter>`. The latter can handle
-grids containing "NaN" values and it can do median and mode filters as
-well as convolutions. Shown here is :doc:`triangulate </triangulate>` followed by
-:doc:`grdfilter </grdfilter>`. Note that the filter has
-done some extrapolation beyond the convex hull of the original *x, y*
-values. The "best" smooth approximation of *z(x, y)* depends on
-the errors in the data and the physical laws obeyed by *z*. GMT cannot
-always do the "best" thing but it offers great flexibility through its
-combinations of tools. We illustrate all four solutions using a CPT file
-that contains color fills, predefined patterns for interval (900,925)
-and NaN, an image pattern for interval (875,900), and a "skip slice"
-request for interval (700,725).
-
-.. literalinclude:: /_verbatim/example_16.txt
- :language: bash
-
-.. figure:: /_images/example_16.*
- :width: 500 px
- :align: center
-
- More ways to grid data.
diff --git a/doc_release/html/_sources/gallery/ex17.txt b/doc_release/html/_sources/gallery/ex17.txt
deleted file mode 100644
index adb6617..0000000
--- a/doc_release/html/_sources/gallery/ex17.txt
+++ /dev/null
@@ -1,39 +0,0 @@
-.. _example_17:
-
-(17) Images clipped by coastlines
----------------------------------
-
-This example demonstrates how :doc:`pscoast </pscoast>`
-can be used to set up clip paths based on coastlines. This approach is
-well suited when different gridded data sets are to be merged on a plot
-using different color palette files. Merging the files themselves may
-not be doable since they may represent different data sets, as we show
-in this example. Here, we lay down a color map of the geoid field near
-India with :doc:`grdimage </grdimage>`, use
-:doc:`pscoast </pscoast>` to set up land clip paths, and
-then overlay topography from the ETOPO5 data set with another call to
-:doc:`grdimage </grdimage>`. We finally undo the
-clippath with a second call to :doc:`pscoast </pscoast>`
-with the option **-Q** (Figure [fig:example:sub:`1`\ 7]):
-
-We also plot a color legend on top of the land. So here we basically
-have three layers of "paint" stacked on top of each other: the
-underlaying geoid map, the land mask, and finally the color legend. This
-legend makes clear how :doc:`grd2cpt </grd2cpt>`
-distributed the colors over the range: they are not of equal length put
-are associated with equal amounts of area in the plot. Since the high
-amounts (in red) are not very prevalent, that color spans a long range.
-
-For this image it is appropriate to use the **-I** option in
-:doc:`psscale </psscale>` so the legend gets shaded,
-similar to the geoid grid. See Appendix [app:M] to learn more about
-color palettes and ways to draw color legends.
-
-.. literalinclude:: /_verbatim/example_17.txt
- :language: bash
-
-.. figure:: /_images/example_17.*
- :width: 500 px
- :align: center
-
- Clipping of images using coastlines.
diff --git a/doc_release/html/_sources/gallery/ex18.txt b/doc_release/html/_sources/gallery/ex18.txt
deleted file mode 100644
index 251ee0c..0000000
--- a/doc_release/html/_sources/gallery/ex18.txt
+++ /dev/null
@@ -1,32 +0,0 @@
-.. _example_18:
-
-(18) Volumes and Spatial Selections
------------------------------------
-
-To demonstrate potential usage of the programs
-:doc:`gmtspatial </gmtspatial>`, :doc:`grdvolume </grdvolume>` and
-:doc:`gmtselect </gmtselect>` we extract a subset of the
-Sandwell & Smith altimetric gravity field [1]_ for the northern Pacific
-and decide to isolate all seamounts that (1) exceed 50 mGal in amplitude
-and (2) are within 200 km of the Pratt seamount. We do this by dumping
-the 50 mGal contours to disk, then use gmtspatial that
-returns the mean location of the points making up each closed polygon,
-and then pass these locations to
-:doc:`gmtselect </gmtselect>`, which retains only the
-points within 200 km of Pratt. We then mask out all the data outside
-this radius and use :doc:`grdvolume </grdvolume>` to
-determine the combined area and (gravimetric) volumes of the chosen seamounts. Our
-illustration is presented in Figure.
-
-.. literalinclude:: /_verbatim/example_18.txt
- :language: bash
-
-.. figure:: /_images/example_18.*
- :width: 500 px
- :align: center
-
- Volumes and geo-spatial selections.
-
-
-.. [1]
- See http://topex.ucsd.edu/marine_grav/mar_grav.html.
diff --git a/doc_release/html/_sources/gallery/ex19.txt b/doc_release/html/_sources/gallery/ex19.txt
deleted file mode 100644
index 3e0919a..0000000
--- a/doc_release/html/_sources/gallery/ex19.txt
+++ /dev/null
@@ -1,30 +0,0 @@
-.. _example_19:
-
-(19) Color patterns on maps
----------------------------
-
-GMT 3.1 introduced color patterns and this examples give a few cases
-of how to use this new feature. We make a phony poster that advertises
-an international conference on GMT in Honolulu. We use
-:doc:`grdmath </grdmath>`, :doc:`makecpt </makecpt>`, and
-:doc:`grdimage </grdimage>` to draw pleasing color
-backgrounds on maps, and overlay
-:doc:`pscoast </pscoast>` clip paths to have the
-patterns change at the coastlines. The middle panel demonstrates a
-simple :doc:`pscoast </pscoast>` call where the built-in
-pattern # 86 is drawn at 100 dpi but with the black and white pixels
-replaced with color combinations. At the same time the ocean is filled
-with a repeating image of a circuit board (provides in Sun raster
-format). The text GMT in the center is an off-line PostScript file
-that was overlaid using :doc:`psimage </psimage>`. The
-final panel repeats the top panel except that the land and sea images
-have changed places.
-
-.. literalinclude:: /_verbatim/example_19.txt
- :language: bash
-
-.. figure:: /_images/example_19.*
- :width: 500 px
- :align: center
-
- Using color patterns and additional PostScript material in illustrations.
diff --git a/doc_release/html/_sources/gallery/ex20.txt b/doc_release/html/_sources/gallery/ex20.txt
deleted file mode 100644
index db60c08..0000000
--- a/doc_release/html/_sources/gallery/ex20.txt
+++ /dev/null
@@ -1,98 +0,0 @@
-.. _example_20:
-
-(20) Custom plot symbols
-------------------------
-
-One is often required to make special maps that shows the distribution
-of certain features but one would prefer to use a custom symbol instead
-of the built-in circles, squares, triangles, etc. in the GMT plotting
-programs :doc:`psxy </psxy>` and
-:doc:`psxyz </psxyz>`. Here we demonstrate one approach
-that allows for a fair bit of flexibility in designing ones own symbols.
-The following recipe is used when designing a new symbol.
-
-#. Use :doc:`psbasemap </psbasemap>` (or engineering
- paper!) to set up an empty grid that goes from -0.5 to +0.5 in both
- *x* and *y*. Use ruler and compass to draw your new symbol using
- straight lines, arcs of circles, and stand-alone geometrical objects
- (see :doc:`psxy </psxy>` man page for a full
- description of symbol design). In this Section we will create two new
- symbols: a volcano and a bulls eye.
-
-.. figure:: /_images/GMT_volcano.*
- :width: 500 px
- :align: center
-
-
-#. After designing the symbol we will encode it using a simple set of
- rules. In our case we describe our volcano and bulls eye using these
- three freeform polygon generators:
-
- :math:`x_0` :math:`y_0` *r* **C** [ **-G**\ *fill* ] [
- **-W**\ *pen* ] Draw :math:`x_0` :math:`y_0` **M** [ **-G**\ *fill* ]
- [ **-W**\ *pen* ] Start new element at :math:`x_0`, :math:`y_0`
-
- :math:`x_1` :math:`y_1` **D** Draw straight line from current point
- to :math:`x_1`, :math:`y_1` around (:math:`x_0`, :math:`y_0`)
-
- :math:`x_0` :math:`y_0` *r* :math:`\alpha_1` :math:`\alpha_2`
- **A** Draw arc segment of radius *r* from angle
- :math:`\alpha_1` to :math:`\alpha_2`
-
- We also add a few stand-alone circles (for other symbols, see
- :doc:`psxy </psxy>` man page):
-
- :math:`x_0` :math:`y_0` *r* **C** [ **-G**\ *fill* ] [
- **-W**\ *pen* ] Draw :math:`x_0` :math:`y_0` *r* **c** [
- **-G**\ *fill* ] [ **-W**\ *pen* ] Draw single circle of radius
- *r* around :math:`x_0`, :math:`y_0`
-
- The optional **-G** and **-W** can be used to hardwire the color fill
- and pen for segments (use **-** to disallow fill or line for any
- specific feature). By default the segments are painted based on the
- values of the command line settings.
-
- Manually applying these rules to our volcano symbol results in a
- definition file ``volcano.def``:
-
- Without much further discussion we also make a definition file ``bullseye.def`` for a
- multi-colored bulls eye symbol. Note that the symbol can be created
- beyond the -0.5 to +0.5 range, as shown by the red lines. There is no
- limit in GMT to the size of the symbols. The center, however, will
- always be at (0,0). This is the point to which the coordinates in
- :doc:`psxy </psxy>` refers.
-
- The values refer to positions and dimensions illustrated in the
- Figure above.
-
-#. Given proper definition files we may now use them with
- :doc:`psxy </psxy>` or :doc:`psxyz </psxyz>`.
-
-We are now ready to give it a try. Based on the hotspot locations in the
-file ``hotspots.d`` (with a 3rd column giving the desired symbol sizes in inches) we
-lay down a world map and overlay red volcano symbols using our
-custom-built volcano symbol and :doc:`psxy </psxy>`. We
-do something similar with the bulls eye symbols. Without the **-G**
-option, however, they get the colors defined in ``bullseye.def``.
-
-Here is our final map script that produces the Figure:
-
-.. literalinclude:: /_verbatim/example_20.txt
- :language: bash
-
-.. figure:: /_images/example_20.*
- :width: 500 px
- :align: center
-
- Using custom symbols in GMT.
-
-
-Given these guidelines you can easily make your own symbols. Symbols
-with more than one color can be obtained by making several symbol
-components. E.g., to have yellow smoke coming out of red volcanoes we
-would make two symbols: one with just the cone and caldera and the other
-with the bubbles. These would be plotted consecutively using the desired
-colors. Alternatively, like in ``bullseye.def``, we may specify colors directly for the
-various segments. Note that the custom symbols (Appendix [app:N]),
-unlike the built-in symbols in GMT, can be used with the built-in
-patterns (Appendix [app:E]). Other approaches are also possible, of course.
diff --git a/doc_release/html/_sources/gallery/ex21.txt b/doc_release/html/_sources/gallery/ex21.txt
deleted file mode 100644
index e6eb160..0000000
--- a/doc_release/html/_sources/gallery/ex21.txt
+++ /dev/null
@@ -1,42 +0,0 @@
-.. _example_21:
-
-(21) Time-series of RedHat stock price
---------------------------------------
-
-As discussed in Section [sec:timeaxis], the annotation of time-series is
-generally more complicated due to the extra degrees of freedom afforded
-by the dual annotation system. In this example we will display the trend
-of the stock price of RedHat (RHAT) from their initial public offering
-until late 2006. The data file is a comma-separated table and the
-records look like this:
-
-::
-
- Date,Open,High,Low,Close,Volume,Adj.Close*
- 12-Mar-04,17.74,18.49,17.67,18.02,4827500,18.02
- 11-Mar-04,17.60,18.90,17.37,18.09,7700400,18.09
-
-Hence, we have a single header record and various prices in USD for each
-day of business. We will plot the trend of the opening price as a red
-line superimposed on a yellow envelope representing the low-to-high
-fluctuation during each day. We also indicate when and at what cost Paul
-Wessel bought a few shares, and zoom in on the developments since 2004;
-in the inset we label the time-axis in Finnish in honor of Linus
-Thorvalds. Because the time coordinates are Y2K-challenged and the order
-is backwards (big units of years come *after* smaller units like days)
-we must change the default input/output formats used by GMT. Finally,
-we want to prefix prices with the $ symbol to indicate the currency.
-Here is how it all comes out:
-
-.. literalinclude:: /_verbatim/example_21.txt
- :language: bash
-
-which produces the plot in Figure, suggesting
-Wessel has missed a few trains if he had hoped to cash in on the
-Internet bubble...
-
-.. figure:: /_images/example_21.*
- :width: 500 px
- :align: center
-
- Time-series of RedHat stock price since IPO.
diff --git a/doc_release/html/_sources/gallery/ex22.txt b/doc_release/html/_sources/gallery/ex22.txt
deleted file mode 100644
index 12be891..0000000
--- a/doc_release/html/_sources/gallery/ex22.txt
+++ /dev/null
@@ -1,35 +0,0 @@
-.. _example_22:
-
-(22) World-wide seismicity the last 7 days
-------------------------------------------
-
-The next example uses the command-line tool **wget** to obtain a data
-file from a specified URL [1]_. In the example script this line is
-commented out so the example will run even if you do not have **wget**
-(we use the supplied ``neic_quakes.d`` which normally would be created by **wget**);
-remove the comment to get the actual current seismicity plot using the
-live data. The main purpose of this script is not to show how to plot a
-map background and a few circles, but rather demonstrate how a map
-legend may be composed using the new tool
-:doc:`pslegend </pslegend>`. Some scripting is used to
-pull out information from the data file that is later used in the
-legend. The legend will normally have the email address of the script
-owner; here that command is commented out and the user is hardwired to
-"GMT guru". The USGS logo, taken from their web page and converted to a
-Sun raster file, is used to spice up the legend.
-
-The script produces the plot in Figure,
-giving the URL where these and similar data can be obtained.
-
-.. literalinclude:: /_verbatim/example_22.txt
- :language: bash
-
-.. figure:: /_images/example_22.*
- :width: 500 px
- :align: center
-
- World-wide seismicity the last 7 days.
-
-
-.. [1]
- You can also use the utility **curl**
diff --git a/doc_release/html/_sources/gallery/ex23.txt b/doc_release/html/_sources/gallery/ex23.txt
deleted file mode 100644
index c337ad1..0000000
--- a/doc_release/html/_sources/gallery/ex23.txt
+++ /dev/null
@@ -1,38 +0,0 @@
-.. _example_23:
-
-(23) All great-circle paths lead to Rome
-----------------------------------------
-
-While motorists recently have started to question the old saying "all
-roads lead to Rome", aircraft pilots have known from the start that only
-one great-circle path connects the points of departure and
-arrival [1]_. This provides the inspiration for our next example which
-uses :doc:`grdmath </grdmath>` to calculate distances
-from Rome to anywhere on Earth and
-:doc:`grdcontour </grdcontour>` to contour these
-distances. We pick five cities that we connect to Rome with great circle
-arcs, and label these cities with their names and distances (in km) from
-Rome, all laid down on top of a beautiful world map. Note that we
-specify that contour labels only be placed along the straight map-line
-connecting Rome to its antipode, and request curved labels that follows
-the shape of the contours.
-
-The script produces the plot in Figure; note
-how interesting the path to Seattle appears in this particular
-projection (Hammer). We also note that Rome's antipode lies somewhere
-near the Chatham plateau (antipodes will be revisited in
-Section [sec:example\ :sub:`2`\ 5]).
-
-.. literalinclude:: /_verbatim/example_23.txt
- :language: bash
-
-.. figure:: /_images/example_23.*
- :width: 500 px
- :align: center
-
- All great-circle paths lead to Rome.
-
-
-.. [1]
- Pedants who wish to argue about the "other" arc going the long way
- should consider using it.
diff --git a/doc_release/html/_sources/gallery/ex24.txt b/doc_release/html/_sources/gallery/ex24.txt
deleted file mode 100644
index 7cb9c33..0000000
--- a/doc_release/html/_sources/gallery/ex24.txt
+++ /dev/null
@@ -1,39 +0,0 @@
-.. _example_24:
-
-(24) Data selection based on geospatial criteria
-------------------------------------------------
-
-Although we are not seismologists, we have yet another example involving
-seismicity. We use seismicity data for the Australia/New Zealand region
-to demonstrate how we can extract subsets of data using geospatial
-criteria. In particular, we wish to plot the epicenters given in the
-file ``oz_quakes.d`` as red or green circles. Green circles should only be used for
-epicenters that satisfy the following three criteria:
-
-#. They are located in the ocean and not on land
-
-#. They are within 3000 km of Hobart
-
-#. They are more than 1000 km away from the International Dateline
-
-All remaining earthquakes should be plotted in red. Rather that doing
-the selection process twice we simply plot all quakes as red circles and
-then replot those that pass our criteria. Most of the work here is done
-by :doc:`gmtselect </gmtselect>`; the rest is carried
-out by the usual :doc:`pscoast </pscoast>` and
-:doc:`psxy </psxy>` workhorses. Note for our purposes
-the Dateline is just a line along the 180 meridian.
-
-The script produces the plot in Figure. Note
-that the horizontal distance from the dateline seems to increase as we
-go south; however that is just the projected distance (Mercator
-distortion) and not the actual distance which remains constant at 1000 km.
-
-.. literalinclude:: /_verbatim/example_24.txt
- :language: bash
-
-.. figure:: /_images/example_24.*
- :width: 500 px
- :align: center
-
- Data selection based on geospatial criteria.
diff --git a/doc_release/html/_sources/gallery/ex25.txt b/doc_release/html/_sources/gallery/ex25.txt
deleted file mode 100644
index fcc7184..0000000
--- a/doc_release/html/_sources/gallery/ex25.txt
+++ /dev/null
@@ -1,49 +0,0 @@
-.. _example_25:
-
-(25) Global distribution of antipodes
--------------------------------------
-
-As promised in Section [sec:example\ :sub:`2`\ 3], we will study
-antipodes. The antipode of a point at :math:`(\phi, \lambda)` is the
-point at :math:`(-\phi, \lambda + 180)`. We seek an answer to the
-question that has plagued so many for so long: Given the distribution of
-land and ocean, how often is the antipode of a point on land also on
-land? And what about marine antipodes? We use :doc:`grdlandmask </grdlandmask>` and
-:doc:`grdmath </grdmath>` to map these distributions and
-calculate the area of the Earth (in percent) that goes with each of the
-three possibilities. To make sense of our
-:doc:`grdmath </grdmath>` equations below, note that we
-first calculate a grid that is +1 when a point and its antipode is on
-land, -1 if both are in the ocean, and 0 elsewhere. We then seek to
-calculate the area distribution of dry antipodes by only pulling out the
-nodes that equal +1. As each point represent an area approximated by
-:math:`\Delta \phi \times \Delta \lambda` where the
-:math:`\Delta \lambda` term's actual dimension depends on
-:math:`\cos (\phi)`, we need to allow for that shrinkage, normalize our
-sum to that of the whole area of the Earth, and finally convert that
-ratio to percent. Since the :math:`\Delta \lambda`, :math:`\Delta \phi`
-terms appear twice in these expressions they cancel out, leaving the
-somewhat intractable expressions below where the sum of
-:math:`\cos (\phi)` for all :math:`\phi` is known to equal :math:`2N_y / \pi`:
-
-In the end we obtain a funny-looking map depicting the antipodal
-distribution as well as displaying in legend form the requested
-percentages. Note that the script is
-set to evaluate a global 30 minute grid for expediency (*D = 30*),
-hence several smaller land masses that do have terrestrial antipodes do
-not show up. If you want a more accurate map you can set the parameter
-*D* to a smaller increment (try 5 and wait a few minutes).
-
-The call to :doc:`grdimage </grdimage>` includes the
-``-Sn`` to suspend interpolation and only return the value of the
-nearest neighbor. This option is particularly practical for plotting
-categorical data, like these, that should not be interpolated.
-
-.. literalinclude:: /_verbatim/example_25.txt
- :language: bash
-
-.. figure:: /_images/example_25.*
- :width: 500 px
- :align: center
-
- Global distribution of antipodes.
diff --git a/doc_release/html/_sources/gallery/ex26.txt b/doc_release/html/_sources/gallery/ex26.txt
deleted file mode 100644
index c70cffe..0000000
--- a/doc_release/html/_sources/gallery/ex26.txt
+++ /dev/null
@@ -1,30 +0,0 @@
-.. _example_26:
-
-(26) General vertical perspective projection
---------------------------------------------
-
-Next, we present a recent extension to the **-JG** projection option
-which allows the user to specify a particular altitude (this was always
-at infinity before), as well as several further parameters to limit the
-view from the chosen vantage point. In this example we show a view of
-the eastern continental US from a height of 160 km. Below we add a view
-with a specific tilt of 55 and azimuth 210; here we have chosen a
-boresight twist of 45. We view the land from New York towards
-Washington, D.C.
-
-At this point the full projection has not been properly optimized and
-the map annotations will need additional work. Also, note that the
-projection is only implemented in
-:doc:`pscoast </pscoast>` and
-:doc:`grdimage </grdimage>`. We hope to refine this
-further and extend the availability of the full projection to all of the
-GMT mapping programs.
-
-.. literalinclude:: /_verbatim/example_26.txt
- :language: bash
-
-.. figure:: /_images/example_26.*
- :width: 500 px
- :align: center
-
- General vertical perspective projection.
diff --git a/doc_release/html/_sources/gallery/ex27.txt b/doc_release/html/_sources/gallery/ex27.txt
deleted file mode 100644
index eee0983..0000000
--- a/doc_release/html/_sources/gallery/ex27.txt
+++ /dev/null
@@ -1,47 +0,0 @@
-.. _example_27:
-
-(27) Plotting Sandwell/Smith Mercator img grids
------------------------------------------------
-
-Next, we show how to plot a data grid that is distributed in projected
-form. The gravity and predicted bathymetry grids produced by David
-Sandwell and Walter H. F. Smith are not geographical grids but instead
-given on a spherical Mercator grid. The GMT supplement imgsrc has
-tools to extract subsets of these large grids. If you need to make a
-non-Mercator map then you must extract a geographic grid using
-:doc:`img2grd </supplements/img/img2grd>` and then plot it using your
-desired map projection. However, if you want to make a Mercator map then
-you can save time and preserve data quality by avoiding to re-project
-the data set twice since it is already in a Mercator projection. This
-example shows how this is accomplished. We use the **-M** option in
-:doc:`img2grd </supplements/img/img2grd>`\ [1]_ to pull out the grid
-in Mercator units (i.e., do *not* invert the Mercator projection) and
-then simply plot the grid using a linear projection with a suitable
-scale (here 0.25 inches per degrees of longitude). To overlay basemaps
-and features that has geographic longitude/latitude coordinates we must
-remember two key issues:
-
-#. This is a *spherical* Mercator grid so we must use
- --**PROJ_ELLIPSOID**\ =Sphere with all commands that involve
- projections (or use :doc:`gmtset </gmtset>` to change the setting).
-
-#. Select Mercator projection and use the same scale that was used with
- the linear projection.
-
-This map of the Tasman Sea shows the marine gravity anomalies with land
-painted black. A color scale bar was then added to complete the illustration.
-
-
-.. literalinclude:: /_verbatim/example_27.txt
- :language: bash
-
-.. figure:: /_images/example_27.*
- :width: 500 px
- :align: center
-
- Plotting Sandwell/Smith Mercator img grids.
-
-
-.. [1]
- You could also use :doc:`img2grd </supplements/img/img2grd>`
- directly - your only option under DOS
diff --git a/doc_release/html/_sources/gallery/ex28.txt b/doc_release/html/_sources/gallery/ex28.txt
deleted file mode 100644
index 7203c76..0000000
--- a/doc_release/html/_sources/gallery/ex28.txt
+++ /dev/null
@@ -1,36 +0,0 @@
-.. _example_28:
-
-(28) Mixing UTM and geographic data sets
-----------------------------------------
-
-Next, we present a similar case: We wish to plot a data set given in UTM
-coordinates (meter) and want it to be properly registered with overlying
-geographic data, such as coastlines or data points. The mistake many
-GMT rookies make is to specify the UTM projection with their UTM data.
-However, that data have already been projected and is now in linear
-meters. The only sensible way to plot such data is with a linear
-projection, yielding a UTM map. In this step one can choose to annotate
-or tick the map in UTM meters as well. To plot geographic (lon/lat) data
-on the same map you simply have to specify the region using the UTM
-meters but supply the actual UTM projection parameters. Make sure you
-use the same scale with both the linear and UTM projection.
-
-Our script illustrates how we would plot a UTM grid (with coordinates in
-meters) of elevations near Kilauea volcano on the Big Island of Hawaii
-and overlay geographical information (with longitude, latitude
-coordinates). We first lay down the UTM grid using the linear
-projection. Then, given we are in UTM zone 5Q, we use the UTM domain and
-the UTM projection when overlaying the coastline and light blue ocean.
-We do some trickery by converting the UTM domain to km so that we can
-add custom annotations to the map. Finally, we place a scale bar and
-label Kilauea crater to complete the figure.
-
-.. literalinclude:: /_verbatim/example_28.txt
- :language: bash
-
-.. figure:: /_images/example_28.*
- :width: 500 px
- :align: center
-
- Mixing UTM and geographic data sets requires knowledge of the map region domain in
- both UTM and lon/lat coordinates and consistent use of the same map scale.
diff --git a/doc_release/html/_sources/gallery/ex29.txt b/doc_release/html/_sources/gallery/ex29.txt
deleted file mode 100644
index 39efd9a..0000000
--- a/doc_release/html/_sources/gallery/ex29.txt
+++ /dev/null
@@ -1,35 +0,0 @@
-.. _example_29:
-
-(29) Gridding spherical surface data using splines
---------------------------------------------------
-
-Finally, we demonstrate how gridding on a spherical surface can be
-accomplished using Green's functions of surface splines, with or without
-tension. Global gridding does not work particularly well in Cartesian
-coordinates hence the chosen approach. We use
-:doc:`greenspline </greenspline>` to produce a crude
-topography grid for Mars based on radii estimates from the Mariner 9 and
-Viking Orbiter spacecrafts. This data comes from *Smith and Zuber*
-[Science, 1996] and is used here as a small (*N* = 370) data set we can
-use to demonstrate spherical surface gridding. Since
-:doc:`greenspline </greenspline>` must solve a *N* by
-*N* matrix system your system memory may impose limits on how large data
-sets you can handle; also note that the spherical surface spline in
-tension is particularly slow to compute.
-
-Our script must first estimate the ellipsoidal shape of Mars from the
-parameters given by *Smith and Zuber* so that we can remove this
-reference surface from the gridded radii. We run the gridding twice:
-First with no tension using *Parker*\ 's [1990] method and then with
-tension using the *Wessel and Becker* [2008] method. The grids are then
-imaged with :doc:`grdimage </grdimage>` and
-:doc:`grdcontour </grdcontour>` and a color scale is placed between them.
-
-.. literalinclude:: /_verbatim/example_29.txt
- :language: bash
-
-.. figure:: /_images/example_29.*
- :width: 500 px
- :align: center
-
- Gridding of spherical surface data using Green's function splines.
diff --git a/doc_release/html/_sources/gallery/ex30.txt b/doc_release/html/_sources/gallery/ex30.txt
deleted file mode 100644
index 2b13ba5..0000000
--- a/doc_release/html/_sources/gallery/ex30.txt
+++ /dev/null
@@ -1,22 +0,0 @@
-.. _example_30:
-
-(30) Trigonometric functions plotted in graph mode
---------------------------------------------------
-
-Finally, we end with a simple mathematical illustration of sine and
-cosine, highlighting the *graph* mode for linear projections and the new
-curved vectors for angles.
-
-The script simply draws a graph basemap, computes sine and cosine and
-plots them as lines, then indicates on a circle that these quantities
-are simply the projections of an unit vector on the x- and y-axis, at
-the given angle.
-
-.. literalinclude:: /_verbatim/example_30.txt
- :language: bash
-
-.. figure:: /_images/example_30.*
- :width: 500 px
- :align: center
-
- Trigonometric functions plotted in graph mode.
diff --git a/doc_release/html/_sources/gallery/ex31.txt b/doc_release/html/_sources/gallery/ex31.txt
deleted file mode 100644
index fab62a2..0000000
--- a/doc_release/html/_sources/gallery/ex31.txt
+++ /dev/null
@@ -1,36 +0,0 @@
-.. _example_31:
-
-(31) Using non-default fonts in PostScript
---------------------------------------------
-
-This example illustrates several possibilities to create GMT plots
-with non-default fonts. As these fonts are not part of the standard
-PostScript font collection they have to be embedded in the PS- or
-PDF-file with Ghostscript. See also
-Appendix [sec:non-default-fonts] for further information. The script
-includes the following steps:
-
-- create a ``CUSTOM_font_info.d`` file;
-
-- set the GMT parameters ``MAP_DEGREE_SYMBOL``, ``PS_CHAR_ENCODING``, and ``FONT``;
-
-- replace the default Helvetica font in the GMT-PostScript-File with sed;
-
-- create a PostScript-File with outlined fonts (optional);
-
-- convert GMT's PostScript output to PDF or any image format (optional).
-
-The script produces the plot in Figure. All
-standard fonts have been substituted by the free OpenType fonts Linux
-Libertine (title) and Linux Biolinum (annotations). Uncomment the
-appropriate lines in the script to make a PostScript-file with
-outlined fonts or to convert to a PDF-file.
-
-.. literalinclude:: /_verbatim/example_31.txt
- :language: bash
-
-.. figure:: /_images/example_31.*
- :width: 500 px
- :align: center
-
- Using non-default fonts in PostScript.
diff --git a/doc_release/html/_sources/gallery/ex32.txt b/doc_release/html/_sources/gallery/ex32.txt
deleted file mode 100644
index 3915296..0000000
--- a/doc_release/html/_sources/gallery/ex32.txt
+++ /dev/null
@@ -1,52 +0,0 @@
-.. _example_32:
-
-(32) Draping an image over topography
--------------------------------------
-
-In some cases, it is nice to "drape" an arbitrary image over a
-topographic map. We have already seen how to use
-:doc:`psimage </psimage>` to plot an image anywhere in
-out plot. But here are aim is different, we want to manipulate an image
-to shade it and plot it in 3-D over topography. This example was
-originally created by Stephan Eickschen for a flyer emphasizing the
-historical economical and cultural bond between Brussels, Maastricht and
-Bonn. Obviously, the flag of the European Union came to mind as a good
-"background".
-
-To avoid adding large files to this example, some steps have been
-already done. First we get the EU flag directly from the web and convert
-it to a grid with values ranging from 0 to 255, where the higher values
-will become yellow and the lower values blue. This use of
-:doc:`grdreformat </grdreformat>` requires GDAL support.
-:doc:`grdedit </grdedit>` then adds the right grid dimension.
-
-The second step is to reformat the GTOPO30 DEM file to a netCDF grid as
-well and then subsample it at the same pixels as the EU flag. We then
-illuminate the topography grid so we can use it later to emphasize the
-topography. The colors that we will use are those of the proper flag.
-Lower values will become blue and the upper values yellow.
-
-The call the :doc:`grdview </grdview>` plots a
-topography map of northwest continental Europe, with the flagged draped
-over it and with shading to show the little topography there is.
-:doc:`pscoast </pscoast>` is used in conjunction with
-:doc:`grdtrack </grdtrack>` and :doc:`psxyz </psxyz>` to plot
-borders "at altitude". Something similar is done at the end to plot some
-symbols and names for cities.
-
-The script produces the plot in Figure [fig:example\ :sub:`3`\ 2]. Note
-that the PNG image of the flag can be downloaded directly in the call
-the :doc:`grdreformat </grdreformat>`, but we have
-commented that out in the example because it requires compilation with
-GDAL support. You will also see the
-:doc:`grdcut </grdcut>` command commented out because we
-did not want to store the 58 MB DEM file, whose location is mentioned in the script.
-
-.. literalinclude:: /_verbatim/example_32.txt
- :language: bash
-
-.. figure:: /_images/example_32.*
- :width: 500 px
- :align: center
-
- Draping an image over topography.
diff --git a/doc_release/html/_sources/gallery/ex33.txt b/doc_release/html/_sources/gallery/ex33.txt
deleted file mode 100644
index e49c9dc..0000000
--- a/doc_release/html/_sources/gallery/ex33.txt
+++ /dev/null
@@ -1,22 +0,0 @@
-.. _example_33:
-
-(33) Stacking automatically generated cross-profiles
-----------------------------------------------------
-
-The script produces the plot in Figure. Here
-we demonstrate how :doc:`grdtrack </grdtrack>` can be
-used to automatically create a suite of crossing profiles of uniform
-spacing and length and then sample one or more grids along these
-profiles; we also use the median stacking option to create a stacked
-profile, showed above the map, with the gray area representing the
-variations about the stacked median profile.
-
-
-.. literalinclude:: /_verbatim/example_33.txt
- :language: bash
-
-.. figure:: /_images/example_33.*
- :width: 500 px
- :align: center
-
- Stacking automatically generated cross-profiles.
diff --git a/doc_release/html/_sources/gallery/ex34.txt b/doc_release/html/_sources/gallery/ex34.txt
deleted file mode 100644
index c75a97c..0000000
--- a/doc_release/html/_sources/gallery/ex34.txt
+++ /dev/null
@@ -1,21 +0,0 @@
-.. _example_34:
-
-(34) Using country polygons for plotting and shading
-----------------------------------------------------
-
-The script produces the plot in Figure. Here
-we demonstrate how :doc:`pscoast </pscoast>` can be used to extract
-and plot country polygons. We show two panels; one in which we do
-a basic basemap and another where we lay down a color topography
-image and then place a transparent layer identifying the future
-Franco-Italian Union whose untimely breakup in 2045 the historians
-will continue to debate for some time.
-
-.. literalinclude:: /_verbatim/example_34.txt
- :language: bash
-
-.. figure:: /_images/example_34.*
- :width: 500 px
- :align: center
-
- Using country polygons for plotting and shading.
diff --git a/doc_release/html/_sources/gallery/ex35.txt b/doc_release/html/_sources/gallery/ex35.txt
deleted file mode 100644
index 6240f01..0000000
--- a/doc_release/html/_sources/gallery/ex35.txt
+++ /dev/null
@@ -1,21 +0,0 @@
-.. _example_35:
-
-(35) Spherical triangulation and distance calculations
-------------------------------------------------------
-
-The script produces the plot in Figure. Here
-we demonstrate how :doc:`sphtriangulate </sphtriangulate>` and
-:doc:`sphdistance </sphdistance>` are used to compute the Delauney and
-Voronoi information on a sphere, using a decimated GSHHG crude coastline.
-We show a color image of the distances, highlighted with 500-km contours,
-and overlay the Voronoi polygons in green. Finally, the continents are
-placed on top.
-
-.. literalinclude:: /_verbatim/example_35.txt
- :language: bash
-
-.. figure:: /_images/example_35.*
- :width: 500 px
- :align: center
-
- Spherical triangulation and distance calculations
diff --git a/doc_release/html/_sources/gallery/ex36.txt b/doc_release/html/_sources/gallery/ex36.txt
deleted file mode 100644
index 51b791b..0000000
--- a/doc_release/html/_sources/gallery/ex36.txt
+++ /dev/null
@@ -1,25 +0,0 @@
-.. _example_36:
-
-(36) Spherical gridding using Renka's algorithms
-------------------------------------------------
-
-The next script produces the plot in Figure. Here
-we demonstrate how :doc:`sphinterpolate </sphinterpolate>` can be used
-to perform spherical gridding. Our example uses early measurements of
-the radius of Mars from Mariner 9 and Viking Orbiter spacecrafts. The
-middle panels shows the data distribution while the top and bottom panel
-are images of the interpolation using a piecewise linear interpolation
-and a smoothed spline interpolation, respectively. For spherical gridding
-with large volumes of data we recommend :doc:`sphinterpolate </sphinterpolate>`
-while for small data sets (such as this one, actually) you have more flexibility
-with :doc:`greenspline </greenspline>`.
-
-.. literalinclude:: /_verbatim/example_36.txt
- :language: bash
-
-.. figure:: /_images/example_36.*
- :width: 500 px
- :align: center
-
- Spherical gridding using Renka\'s algorithms.
-
diff --git a/doc_release/html/_sources/gallery/ex37.txt b/doc_release/html/_sources/gallery/ex37.txt
deleted file mode 100644
index 08044c3..0000000
--- a/doc_release/html/_sources/gallery/ex37.txt
+++ /dev/null
@@ -1,21 +0,0 @@
-.. _example_37:
-
-(37) Spectral coherence between gravity and bathymetry grids
-------------------------------------------------------------
-
-The next script produces the plot in Figure.
-We demonstrate how :doc:`grdfft </grdfft>` is used to compute the
-spectral coherence between two data sets, here multibeam bathymetry
-and satellite-derived gravity. The grids are detrended and tapered
-before the Fourier transform is computed; the intermediate plots show
-the grids being extended and padded to a suitable dimension.
-
-.. literalinclude:: /_verbatim/example_37.txt
- :language: bash
-
-.. figure:: /_images/example_37.*
- :width: 500 px
- :align: center
-
- Spectral coherence between gravity and bathymetry grids.
-
diff --git a/doc_release/html/_sources/gallery/ex38.txt b/doc_release/html/_sources/gallery/ex38.txt
deleted file mode 100644
index f370307..0000000
--- a/doc_release/html/_sources/gallery/ex38.txt
+++ /dev/null
@@ -1,18 +0,0 @@
-.. _example_38:
-
-(38) Histogram equalization of bathymetry grids
------------------------------------------------
-
-This example shows how to use histogram equalization to enhance various
-ranges of a grid depending on its frequency distribution. The key tool
-used here is :doc:`grdhisteq </grdhisteq>`.
-
-.. literalinclude:: /_verbatim/example_38.txt
- :language: bash
-
-.. figure:: /_images/example_38.*
- :width: 500 px
- :align: center
-
- Histogram equalization of bathymetry grids.
-
diff --git a/doc_release/html/_sources/gallery/ex39.txt b/doc_release/html/_sources/gallery/ex39.txt
deleted file mode 100644
index 8ac86d4..0000000
--- a/doc_release/html/_sources/gallery/ex39.txt
+++ /dev/null
@@ -1,23 +0,0 @@
-.. _example_39:
-
-(39) Evaluation of spherical harmonics coefficients
----------------------------------------------------
-
-We use a spherical harmonic model for the topography of Venus and evaluate
-the resulting global grid for three sets of upper order/degrees, here 30,
-90, and 180; the original file (see below) goes to order and degree 720.
-We use the coefficients to evaluate the grids and make perspective globes
-of the different resolutions. The key tool
-used here is :doc:`sph2grd </sph2grd>`.
-
-Note that we use a special format in :doc:`psscale </psscale>` so that the
-annotations will include the separators for the thousands.
-
-.. literalinclude:: /_verbatim/example_39.txt
- :language: bash
-
-.. figure:: /_images/example_39.*
- :width: 500 px
- :align: center
-
- Evaluation of spherical harmonics coefficients.
diff --git a/doc_release/html/_sources/gallery/ex40.txt b/doc_release/html/_sources/gallery/ex40.txt
deleted file mode 100644
index 8c4cce1..0000000
--- a/doc_release/html/_sources/gallery/ex40.txt
+++ /dev/null
@@ -1,18 +0,0 @@
-.. _example_40:
-
-(40) Line simplification
-------------------------
-
-This example demonstrate the Douglas-Peucker line simplification algorithm as
-implemented in the tool :doc:`gmtsimplify </gmtsimplify>`. We show the full
-resolution coastline of Australia and two much simplified versions using two
-different thresholds.
-
-.. literalinclude:: /_verbatim/example_40.txt
- :language: bash
-
-.. figure:: /_images/example_40.*
- :width: 500 px
- :align: center
-
- Illustrate line simplification and area calculations.
diff --git a/doc_release/html/_sources/gallery/users_contrib_script/vertical_slice.txt b/doc_release/html/_sources/gallery/users_contrib_script/vertical_slice.txt
deleted file mode 100644
index 42e8686..0000000
--- a/doc_release/html/_sources/gallery/users_contrib_script/vertical_slice.txt
+++ /dev/null
@@ -1,131 +0,0 @@
-.. _vertical_slice:
-
-A Vertical slice
-------------------------
-
-This is an example of how to graph a function p=f(x, y, z)
-and include in the graph a slice of it using GMT 5.
-
-In this case, my function is f(latitude, longitude, height) and to make
-the example self-contained I make the grid and the slice in the script.
-
-To keep the example easy to me, I did the slice in a N-S direction at a
-fixed longitude, so the slice is f(latitude, height). Nothing will prevent
-you from making the slices in other orientations. If you instead of a more
-or less straight line, you have an arbitrary path, you must be careful that
-the track does not have "folds" and if it has them you must break it into parts.
-
-Due to my slice is f(lat, height) I must dump it, add the column for the fixed
-longitude, and project the coordinates using mappproject and then re-grid it.
-
-The biggest problem that I found, and it took longer to me was how to locate
-the slice. In a 2D map it is easy to do, transforming (lat, lon) to (x, y) with
-mapproject, and then using J[xX] but in this case it was trial and error for me.
-Maybe someone has the recipe to do it analytically.
-
-The grid in the horizontal plane is to make sure the slice is located exactly where it should be.
-
-I also had to re-draw the box, because the slice partially covered it.
-
-I tried to make the script as clear as possible with comments, but
-yet they can be tricky.
-
-Regards, Eduardo.-
-
---
-Eduardo A. Suarez
-Facultad de Ciencias Astronomicas y Geofisicas - UNLP
-
-.. code-block:: bash
-
- #!/bin/bash
- #
- gmt gmtset GMT_COMPATIBILITY=5 MAP_FRAME_TYPE=plain
- #
- # f(x,y,z) = sin(x+y)*e(-(x+y)*(3 - (z/1e4)))
- #
- # create base grid (z = 0)
- #
- gmt grdmath -R-75/-60/-50/-40 -I0.005 X D2R Y D2R ADD STO at xySum SIN @xySum \
- 3 MUL NEG EXP MUL = base.nc
- #
- # create slice grid (lon = -67.5) (-47.5 <= lat <= 42.5) (0 <= z <= 999)
- #
- gmt grdmath -R-47.5/-42.5/0/999 -I0.005/0.5 X D2R -67.5 D2R ADD STO at xySum SIN @xySum \
- 3 Y 1E4 DIV SUB MUL NEG EXP MUL = slice.nc
- #
- # dump slice grid and reproject X
- #
- gmt grd2xyz slice.nc | awk '{print -67.5,$0}' | gmt mapproject -R-75/-60/-50/-40 -JM-67.5/-45/16 | \
- awk '{print $2,$3,$4}'> points.d
- #
- # calculate projected region X-limits
- #
- lMin=`echo '-67.5 -47.5' | gmt mapproject -R-75/-60/-50/-40 -JM-67.5/-45/16 | awk '{print $2}'`
- lMax=`echo '-67.5 -42.5' | gmt mapproject -R-75/-60/-50/-40 -JM-67.5/-45/16 | awk '{print $2}'`
- #
- # re-grid slice
- #
- gmt surface points.d -Gslice_cut.nc -R$lMin/$lMax/0/999 -I1500+/2000+ -C0.1 -T0.25
- #
- # create color palette
- #
- deltaZ=`gmt grdinfo -T10 slice_cut.nc base.nc`
- gmt makecpt -Cseis -I $deltaZ -Z > colors.cpt
- #
- # make basemap (this is not necessary but...)
- #
- gmt psbasemap -R-75/-60/-50/-40/0/999 -JM-67.5/-45/16 -JZ8 -Bxa2f1 -Bya1f1 -Bza250f50g250+l"Km" \
- -B+b -BwESn -pz135/30+v10/5 -K > mag.ps
- #
- # plot base grid (z = 0)
- #
- gmt grdimage base.nc -R -JM -JZ -Bxa2f1 -Bya1f1 -Bza250f50g250+l"Km" -B+b -BwESn \
- -Ccolors.cpt -p -O -K >> mag.ps
- #
- # plot map (coast, country borders). Grid plotted to check slice location
- #
- gmt pscoast -R -JM -JZ -Bxa2f1g0.5 -Bya1f1g0.5 -Bza250f50g250+l"Km" -B+b -BwESn -Df -A0/0/1 \
- -N1/0.5p,black,-..- -W0.5p,black -p -O -K >> mag.ps
- #
- # calculate max X projected
- #
- xMax=`echo '-60 -40' | gmt mapproject -R-75/-60/-50/-40 -JM-67.5/-45/16 | awk '{print $2}'`
- #
- # plot slice
- #
- gmt grdimage slice_cut.nc -R0/$xMax/0/999 -JX15.0922064999/8 -Bxa0f0 -Bya250f50+l"Km" -Ccolors.cpt \
- -px135/30+v12.59/0.96 -O -K --MAP_FRAME_AXES='' >> mag.ps
- #
- # plot slice box
- #
- gmt psxy -R -JX -W1p,black -px135/30+v12.59/0.96 -O -K >> mag.ps << EOF
- $lMin 0
- $lMin 999
- $lMax 999
- $lMax 0
- $lMin 0
- EOF
- #
- # add missing Z-box lines overwritten by slice plot
- #
- gmt psxyz -R-75/-60/-50/-40/0/999 -JM-67.5/-45/16 -JZ8 -W1p,black -pz135/30+v10/5 -O >> mag.ps << EOF
- -75 -50 999
- -75 -40 999
- -60 -40 999
- -60 -50 999
- -75 -50 999
- >
- -60 -50 0
- -60 -50 999
- EOF
- #
- gmt ps2raster -Tg -Qt4 -Qg4 -E300 -P mag.ps
- #
- rm -f base.nc points.d slice.nc slice_cut.nc gmt.history gmt.conf
-
-.. figure:: images/vertical_slice.png
- :width: 500 px
- :align: center
-
- A vertical slice ...
diff --git a/doc_release/html/_sources/gallery/users_contrib_symbols/pirata.txt b/doc_release/html/_sources/gallery/users_contrib_symbols/pirata.txt
deleted file mode 100644
index 2961eba..0000000
--- a/doc_release/html/_sources/gallery/users_contrib_symbols/pirata.txt
+++ /dev/null
@@ -1,6 +0,0 @@
-.. _pirata:
-
-A pirate
-----------
-
-.. literalinclude:: pirata.def
diff --git a/doc_release/html/_sources/gmt.conf.txt b/doc_release/html/_sources/gmt.conf.txt
deleted file mode 100644
index c0f2231..0000000
--- a/doc_release/html/_sources/gmt.conf.txt
+++ /dev/null
@@ -1,1181 +0,0 @@
-.. index:: ! gmt.conf
-
-********
-gmt.conf
-********
-
-.. only:: not man
-
- gmt.conf - Configuration for GMT
-
-Description
------------
-
-The following is a list of the parameters that are user-definable in
-GMT. The parameter names are always given in UPPER CASE. The
-parameter values are case-insensitive unless otherwise noted. The system
-defaults are given in brackets [ for SI (and US) ]. Those marked **\***
-can be set on the command line as well (the corresponding option is
-given in parentheses). Note that default distances and lengths below are
-given in both cm or inch; the chosen default depends on your choice of
-default unit (see :ref:`PROJ_LENGTH_UNIT <PROJ_LENGTH_UNIT>`). You can explicitly specify
-the unit used for distances and lengths by appending **c** (cm), **i**
-(inch), or **p** (points). When no unit is indicated the value will be
-assumed to be in the unit set by :ref:`PROJ_LENGTH_UNIT <PROJ_LENGTH_UNIT>`. Several
-parameters take only **true** or **false**. Finally, most of these
-parameters can be changed on-the-fly via the **-**\ **-PARAMETER**\ =\ *VALUE*
-option to any GMT program. However, a few are static and are only
-read via the **gmt.conf** file; these are labeled (static).
-
-Common Specifications
----------------------
-
-The full explanation for how to specify pens, pattern fills, colors, and
-fonts can be found in the :doc:`gmt` man page.
-
-
-+---------------------------------+----------------+
-| THEMATIC SUB-SECTIONS | *prefix* |
-+=================================+================+
-| `COLOR Parameters`_ | **COLOR_** |
-+---------------------------------+----------------+
-| `DIR Parameters`_ | **DIR_** |
-+---------------------------------+----------------+
-| `FONT Parameters`_ | **FONT_** |
-+---------------------------------+----------------+
-| `FORMAT Parameters`_ | **FORMAT_** |
-+---------------------------------+----------------+
-| `GMT Miscellaneous Parameters`_ | **GMT_** |
-+---------------------------------+----------------+
-| `I/O Parameters`_ | **IO_** |
-+---------------------------------+----------------+
-| `MAP Parameters`_ | **MAP_** |
-+---------------------------------+----------------+
-| `Projection Parameters`_ | **PROJ_** |
-+---------------------------------+----------------+
-| `PostScript Parameters`_ | **PS_** |
-+---------------------------------+----------------+
-| `Calendar/Time Parameters`_ | **TIME_** |
-+---------------------------------+----------------+
-
-.. _COLOR Parameters:
-
-.. _COLOR_BACKGROUND:
-
-**COLOR_BACKGROUND**
- Color used for the background of images (i.e., when z < lowest color
- table entry) [black].
-
-.. _COLOR_FOREGROUND:
-
-**COLOR_FOREGROUND**
- Color used for the foreground of images (i.e., when z > highest
- color table entry) [white].
-
-.. _COLOR_HSV_MAX_S:
-
-**COLOR_HSV_MAX_S**
- Maximum saturation (0-1) assigned for most positive intensity value [0.1].
-
-.. _COLOR_HSV_MIN_S:
-
-**COLOR_HSV_MIN_S**
- Minimum saturation (0-1) assigned for most negative intensity value [1.0].
-
-.. _COLOR_HSV_MAX_V:
-
-**COLOR_HSV_MAX_V**
- Maximum value (0-1) assigned for most positive intensity value [1.0].
-
-.. _COLOR_HSV_MIN_V:
-
-**COLOR_HSV_MIN_V**
- Minimum value (0-1) assigned for most negative intensity value [0.3].
-
-.. _COLOR_MODEL:
-
-**COLOR_MODEL**
- Selects in which color space a color palette should be interpolated.
- By default, color interpolation takes place directly on the RGB
- values which can produce some unexpected hues, whereas interpolation
- directly on the HSV values better preserves those hues. The choices
- are: **none** (default: use whatever the COLOR_MODEL setting in the
- color palette file demands), **rgb** (force interpolation in RGB),
- **hsv** (force interpolation in HSV), **cmyk** (assumes colors are
- in CMYK but interpolates in RGB).
-
-.. _COLOR_NAN:
-
-**COLOR_NAN**
- Color used for the non-defined areas of images (i.e., where z == NaN) [127.5].
-
-.. _DIR Parameters:
-
-**DIR_DATA**
- Session data dir. Overrides the value of the environment variable **$GMT_DATADIR**
- (see :ref:`Directory parameters` in the CookBook).
-
-**DIR_DCW**
- Path to optional Digital Chart of the World polygon files.
-
-**DIR_GSHHG**
- Path to GSHHG files. Defaults to **$GMT_SHAREDIR**/coast if empty.
-
-.. _FONT Parameters:
-
-**FONT**
- Sets the default for all fonts, except FONT_LOGO. This setting is
- not included in the **gmt.conf** file.
-
-.. _FONT_ANNOT_PRIMARY:
-
-**FONT_ANNOT_PRIMARY**
- Font used for primary annotations, etc. [12p,Helvetica,black]. When
- **+** is prepended, scale fonts, offsets and tick-lengths relative
- to **FONT_ANNOT_PRIMARY**.
-
-.. _FONT_ANNOT_SECONDARY:
-
-**FONT_ANNOT_SECONDARY**
- Font to use for time axis secondary annotations
- [14p,Helvetica,black].
-
-.. _FONT_LABEL:
-
-**FONT_LABEL**
- Font to use when plotting labels below axes [16p,Helvetica,black].
-
-.. _FONT_LOGO:
-
-**FONT_LOGO**
- Font to use for text plotted as part of the GMT time logo
- [8p,Helvetica,black].
-
-.. _FONT_TITLE:
-
-**FONT_TITLE**
- Font to use when plotting titles over graphs [24p,Helvetica,black].
-
-.. _FORMAT Parameters:
-
-.. _FORMAT_CLOCK_IN:
-
-**FORMAT_CLOCK_IN**
- Formatting template that indicates how an input clock string is
- formatted. This template is then used to guide the reading of clock
- strings in data fields. To properly decode 12-hour clocks, append am
- or pm (or upper case) to match your data records. As examples, try
- hh:mm, hh:mm:ssAM, etc. [hh:mm:ss].
-
-.. _FORMAT_CLOCK_MAP:
-
-**FORMAT_CLOCK_MAP**
- Formatting template that indicates how an output clock string is to
- be plotted. This template is then used to guide the formatting of
- clock strings in plot annotations. See **FORMAT_CLOCK_OUT** for
- details. [hh:mm:ss].
-
-.. _FORMAT_CLOCK_OUT:
-
-**FORMAT_CLOCK_OUT**
- Formatting template that indicates how an output clock string is to
- be formatted. This template is then used to guide the writing of
- clock strings in data fields. To use a floating point format for the
- smallest unit (e.g., seconds), append .xxx, where the number of x
- indicates the desired precision. If no floating point is indicated
- then the smallest specified unit will be rounded off to nearest
- integer. For 12-hour clocks, append am, AM, a.m., or A.M. (GMT
- will replace a\|A with p\|P for pm). If your template starts with a
- leading hyphen (-) then each integer item (y,m,d) will be printed
- without leading zeros (default uses fixed width formats). As
- examples, try hh:mm, hh.mm.ss, hh:mm:ss.xxxx, hha.m., etc.
- [hh:mm:ss]. If the format is simply - then no clock is output and
- the ISO T divider between date and clock is omitted.
-
-.. _FORMAT_DATE_IN:
-
-**FORMAT_DATE_IN**
- Formatting template that indicates how an input date string is
- formatted. This template is then used to guide the reading of date
- strings in data fields. You may specify either Gregorian calendar
- format or ISO week calendar format. Gregorian calendar: Use any
- combination of yyyy (or yy for 2-digit years; if so see
- **TIME_Y2K_OFFSET_YEAR**), mm (or o for abbreviated month name in
- the current time language), and dd, with or without delimiters. For
- day-of-year data, use jjj instead of mm and/or dd. Examples can be
- ddmmyyyy, yy-mm-dd, dd-o-yyyy, yyyy/dd/mm, yyyy-jjj, etc. ISO
- Calendar: Expected template is yyyy[-]W[-]ww[-]d, where ww is ISO
- week and d is ISO week day. Either template must be consistent,
- e.g., you cannot specify months if you do not specify years.
- Examples are yyyyWwwd, yyyy-Www, etc. [yyyy-mm-dd].
-
-.. _FORMAT_DATE_MAP:
-
-**FORMAT_DATE_MAP**
- Formatting template that indicates how an output date string is to
- be plotted. This template is then used to guide the plotting of date
- strings in data fields. See **FORMAT_DATE_OUT** for details. In
- addition, you may use a single o instead of mm (to plot month name)
- and u instead of W[-]ww to plot "Week ##". Both of these text
- strings will be affected by the **TIME_LANGUAGE**,
- **FORMAT_TIME_PRIMARY_MAP** and **FORMAT_TIME_SECONDARY_MAP**
- setting. [yyyy-mm-dd].
-
-.. _FORMAT_DATE_OUT:
-
-**FORMAT_DATE_OUT**
- Formatting template that indicates how an output date string is to
- be formatted. This template is then used to guide the writing of
- date strings in data fields. You may specify either Gregorian
- calendar format or ISO week calendar format. Gregorian calendar: Use
- any combination of yyyy (or yy for 2-digit years; if so see
- **TIME_Y2K_OFFSET_YEAR**), mm (or o for abbreviated month name in
- the current time language), and dd, with or without delimiters. For
- day-of-year data, use jjj instead of mm and/or dd. As examples, try
- yy/mm/dd, yyyy=jjj, dd-o-yyyy, dd-mm-yy, yy-mm, etc. ISO Calendar:
- Expected template is yyyy[-]W[-]ww[-]d, where ww is ISO week and d
- is ISO week day. Either template must be consistent, e.g., you
- cannot specify months if you do not specify years. As examples, try
- yyyyWww, yy-W-ww-d, etc. If your template starts with a leading
- hyphen (-) then each integer item (y,m,d) will be printed without
- leading zeros (default uses fixed width formats) [yyyy-mm-dd]. If
- the format is simply - then no date is output and the ISO T divider
- between date and clock is omitted.
-
-.. _FORMAT_GEO_MAP:
-
-**FORMAT_GEO_MAP**
- Formatting template that indicates how an output geographical
- coordinate is to be plotted. This template is then used to guide the
- plotting of geographical coordinates in data fields. See
- **FORMAT_GEO_OUT** for details. In addition, you can append A
- which plots the absolute value of the coordinate. The default is
- ddd:mm:ss. Not all items may be plotted as this depends on the
- annotation interval.
-
-.. _FORMAT_GEO_OUT:
-
-**FORMAT_GEO_OUT**
- Formatting template that indicates how an output geographical
- coordinate is to be formatted. This template is then used to guide
- the writing of geographical coordinates in data fields. The template
- is in general of the form [+\|-]D or [+\|-]ddd[:mm[:ss]][.xxx][F].
- By default, longitudes will be reported in the range [-180,180]. The
- various terms have the following purpose:
-
- +D Output longitude in the range [0,360]
-
- -D Output longitude in the range [-360,0]
-
- D Use **FORMAT_FLOAT_OUT** for floating point degrees.
-
- ddd Fixed format integer degrees
-
- : delimiter used
-
- mm Fixed format integer arc minutes
-
- ss Fixed format integer arc seconds
-
- .xxx Floating fraction of previous integer field, fixed width.
-
- F Encode sign using WESN suffix
-
- G Same as F but with a leading space before suffix
-
- The default is D.
-
-.. _FORMAT_FLOAT_MAP:
-
-**FORMAT_FLOAT_MAP**
- Format (C language printf syntax) to be used when plotting double
- precision floating point numbers along plot frames and contours.
- For geographic coordinates, see **FORMAT_GEO_MAP**. [%.12lg].
-
-.. _FORMAT_FLOAT_OUT:
-
-**FORMAT_FLOAT_OUT**
- Format (C language printf syntax) to be used when printing double
- precision floating point numbers to output files. For geographic
- coordinates, see **FORMAT_GEO_OUT**. [%.12lg]. To give some
- columns a separate format, supply one or more comma-separated
- *cols*:*format* specifications, where *cols* can be specific columns
- (e.g., 5 for 6th since 0 is the first) or a range of columns (e.g.,
- 3-7). The last specification without column information will
- override the format for all other columns.
-
-.. _FORMAT_TIME_PRIMARY_MAP:
-
-**FORMAT_TIME_PRIMARY_MAP**
- Controls how primary month-, week-, and weekday-names are formatted.
- Choose among **full**, **abbreviated**, and **character**. If the
- leading **f**, **a**, or **c** are replaced with **F**, **A**, and
- **C** the entire annotation will be in upper case [full].
-
-.. _FORMAT_TIME_SECONDARY_MAP:
-
-**FORMAT_TIME_SECONDARY_MAP**
- Controls how secondary month-, week-, and weekday-names are
- formatted. Choose among **full**, **abbreviated**, and
- **character**. If the leading **f**, **a**, or **c** are replaced
- with **F**, **A**, and **C** the entire annotation will be in upper case [full].
-
-.. _FORMAT_TIME_STAMP:
-
-**FORMAT_TIME_STAMP**
- Defines the format of the time information in the UNIX time stamp.
- This format is parsed by the C function **strftime**, so that
- virtually any text can be used (even not containing any time
- information) [%Y %b %d %H:%M:%S].
-
-.. _GMT Miscellaneous Parameters:
-
-.. _GMT_COMPATIBILITY:
-
-
-**GMT_COMPATIBILITY**
- Determines if this GMT version should be able to parse command-line
- options for a prior major release. Specify either 4 or 5. If 4 is
- set we will parse obsolete GMT 4 options and issue warnings; if 5
- is set then parsing GMT 4 only syntax will result in errors [4].
-
-.. _GMT_EXTRAPOLATE_VAL:
-
-**GMT_EXTRAPOLATE_VAL**
- Determines what to do if extrapolating beyond the data domain.
- Choose among 'NaN', 'extrap' or 'extrapval,val' (without quotes). In
- the first case return NaN for any element of x that is outside range
- [Default]. Second case lets the selected algorithm compute the
- extrapolation values. Third case sets the extrapolation values to
- the constant value passed in 'val' (this value must off course be
- numeric).
-
-.. _GMT_CUSTOM_LIBS:
-
-**GMT_CUSTOM_LIBS**
- Comma-separated list of GMT-compliant shared libraries that extend
- the capability of GMT with additional custom modules [none]. Alternatively,
- provide a directory name, that MUST end with a slash (or back slash),
- to use all shared libraries in that directory. On Windows, if the dir
- name is made up only of a single slash ('/') search inside a subdirectory
- called 'gmt_plugins' of the directory that contains the 'gmt' executable.
- See the API documentation for how to build your own shared modules.
-
-.. _GMT_FFT:
-
-**GMT_FFT**
- Determines which Fast Fourier Transform (FFT) should be used among
- those that have been configured during installation. Choose from
- **auto** (pick the most suitable for the task among available
- algorithms), **fftw**\ [,\ *planner_flag*] (The Fastest Fourier
- Transform in the West), **accelerate** (Use the Accelerate Framework
- under OS X; Note, that the number of samples to be processed must be
- a base 2 exponent), **kiss**, (Kiss FFT), **brenner** Brenner Legacy
- FFT [auto].
- FFTW can "learn" how to optimally compute Fourier transforms on the
- current hardware and OS by computing several FFTs and measuring
- their execution time. This so gained "Wisdom" will be stored in and
- reloaded from the file fftw_wisdom_<hostname> in $GMT_USERDIR or, if
- $GMT_USERDIR is not writable, in the current directory. To use this
- feature append *planner_flag*, which can be one of *measure*,
- *patient*, and *exhaustive*; see FFTW reference for details. The
- default FFTW planner flag is *estimate*, i.e., pick a (probably
- sub-optimal) plan quickly. Note: if you need a single transform of a
- given size only, the one-time cost of the smart planner becomes
- significant. In that case, stick to the default planner, *estimate*,
- based on heuristics.
-
-.. _GMT_HISTORY:
-
-**GMT_HISTORY**
- Passes the history of past common command options via the
- gmt.history file. The different values for this setting are:
- **true**, **readonly**, **false**, to either read and write to the
- gmt.history file, only read, or not use the file at all [true].
-
-.. _GMT_INTERPOLANT:
-
-**GMT_INTERPOLANT**
- Determines if linear (linear), Akima's spline (akima), natural cubic
- spline (cubic) or no interpolation (none) should be used for 1-D
- interpolations in various programs [akima].
-
-.. _GMT_TRIANGULATE:
-
-**GMT_TRIANGULATE**
- Determines if we use the **Watson** [Default] or **Shewchuk**
- algorithm (if configured during installation) for triangulation.
- Note that Shewchuk is required for operations involving Voronoi
- constructions.
-
-.. _GMT_VERBOSE:
-
-**GMT_VERBOSE**
- (**-V**) Determines the level of verbosity used by GMT
- programs. Choose among 6 levels; each level adds to the verbosity of
- the lower levels: **q**\ uiet, **n**\ normal (errors and warnings),
- **c**\ ompatibility warnings, **v**\ erbose progress reports, **l**\ ong
- verbose progress reports, **d**\ ebugging messages [c].
-
-.. _I/O Parameters:
-
-.. _IO_COL_SEPARATOR:
-
-**IO_COL_SEPARATOR**
- This setting determines what character will separate ASCII output
- data columns written by GMT. Choose from tab, space, comma, and
- none [tab].
-
-.. _IO_GRIDFILE_FORMAT:
-
-**IO_GRIDFILE_FORMAT**
- Default file format for grids, with optional scale, offset and
- invalid value, written as *ff*/*scale*/*offset*/*invalid*. The
- 2-letter format indicator can be one of
- [**abcegnrs**][**bsifd**]. See
- :doc:`grdreformat` and Section 4.20 of the
- GMT Technical Reference and Cookbook for more information. The
- *scale* and *offset* modifiers may be left empty to select default
- values (scale = 1, offset = 0), or you may specify *a* for
- auto-adjusting the scale and/or offset of packed integer grids
- (=\ *id/a* is a shorthand for =\ *id/a/a*). When *invalid* is omitted
- the appropriate value for the given format is used (NaN or largest
- negative). [nf].
-
-.. _IO_GRIDFILE_SHORTHAND:
-
-**IO_GRIDFILE_SHORTHAND**
- If true, all grid file names are examined to see if they use the
- file extension shorthand discussed in Section 4.17 of the GMT
- Technical Reference and Cookbook. If false, no filename expansion is
- done [false].
-
-.. _IO_HEADER:
-
-**IO_HEADER**
- (**-h**) Specifies whether input/output ASCII files have header
- record(s) or not [false].
-
-.. _IO_LONLAT_TOGGLE:
-
-**IO_LONLAT_TOGGLE**
- (**-:**) Set if the first two columns of input and output files
- contain (latitude,longitude) or (y,x) rather than the expected
- (longitude,latitude) or (x,y). false means we have (x,y) both on
- input and output. true means both input and output should be (y,x).
- IN means only input has (y,x), while OUT means only output should be
- (y,x). [false].
-
-.. _IO_N_HEADER_RECS:
-
-**IO_N_HEADER_RECS**
- Specifies how many header records to expect if **-h** is used [0].
- Note: This will skip the specified number of records regardless of
- what they are. Since any records starting with # is automatically
- considered a header you will only specify a non-zero number in order
- to skip headers that do not conform to that convention.
-
-.. _IO_NAN_RECORDS:
-
-**IO_NAN_RECORDS**
- Determines what happens when input records containing NaNs for *x*
- or *y* (and in some cases *z*) are read. Choose between **skip**,
- which will simply report how many bad records were skipped, and
- **pass** [Default], which will pass these records on to the calling
- programs. For most programs this will result in output records with
- NaNs as well, but some will interpret these NaN records to indicate
- gaps in a series; programs may then use that information to detect
- segmentation (if applicable).
-
-.. _IO_NC4_CHUNK_SIZE:
-
-**IO_NC4_CHUNK_SIZE**
- Sets the default chunk size for the **lat** and **lon** dimension of
- the **z** variable. Very large chunk sizes and sizes smaller than
- 128 should be avoided because they can lead to unexpectedly bad
- performance. Note that a chunk of a single precision floating point
- variable of size 2896x2896 completely fills the chunk cache of
- 32MiB. Specify the chunk size for each dimension separated by a
- comma, or **a**\ uto for optimally chosen chunk sizes in the range
- [128,256). Setting IO_NC4_CHUNK_SIZE will produce netCDF version 4
- files, which can only be read with the netCDF 4 library, unless all
- dimensions are less than 128 or **c**\ lassic is specified for
- classic netCDF. [auto]
-
-.. _IO_NC4_DEFLATION_LEVEL:
-
-**IO_NC4_DEFLATION_LEVEL**
- Sets the compression level for netCDF4 files upon output. Values
- allowed are integers from 0 (no compression) to 9 (maximum
- compression). Enabling a low compression level can dramatically
- improve performance and reduce the size of certain data. While
- higher compression levels further reduce the data size, they do so
- at the cost of extra processing time. This parameter does not
- apply to classic netCDF files. [3]
-
-.. _IO_SEGMENT_MARKER:
-
-**IO_SEGMENT_MARKER**
- This holds the character we expect to indicate a segment header in
- an incoming ASCII data or text table [>]. If this marker should be
- different for output then append another character for the output
- segment marker. The two characters must be separated by a comma. Two
- marker characters have special meaning: B means "blank line" and
- will treat blank lines as initiating a new segment, whereas N means
- "NaN record" and will treat records with all NaNs as initiating a
- new segment. If you choose B or N for the output marker then the
- normal GMT segment header is replaced by a blank or NaN record,
- respectively, and no segment header information is written. To use B
- or N as regular segment markers you must escape them with a leading
- backslash.
-
-.. _MAP Parameters:
-
-.. _MAP_ANNOT_MIN_ANGLE:
-
-**MAP_ANNOT_MIN_ANGLE**
- If the angle between the map boundary and the annotation baseline is
- less than this minimum value (in degrees), the annotation is not
- plotted (this may occur for certain oblique projections.) Give a
- value in the range [0,90]. [20]
-
-.. _MAP_ANNOT_MIN_SPACING:
-
-**MAP_ANNOT_MIN_SPACING**
- If an annotation would be plotted less than this minimum distance
- from its closest neighbor, the annotation is not plotted (this may
- occur for certain oblique projections.) [0p]
-
-.. _MAP_ANNOT_OBLIQUE:
-
-**MAP_ANNOT_OBLIQUE**
- This integer is a sum of 6 bit flags (most of which only are
- relevant for oblique projections): If bit 1 is set (1),
- annotations will occur wherever a gridline crosses the map
- boundaries, else longitudes will be annotated on the lower and upper
- boundaries only, and latitudes will be annotated on the left and
- right boundaries only. If bit 2 is set (2), then
- longitude annotations will be plotted horizontally. If bit 3 is set
- (4), then latitude annotations will be plotted
- horizontally. If bit 4 is set (8), then oblique
- tick-marks are extended to give a projection equal to the specified
- tick length. If bit 5 is set (16), tick-marks will be drawn normal
- to the border regardless of gridline angle. If bit 6 is set (32),
- then latitude annotations will be plotted parallel to the border. To
- set a combination of these, add up the values in parentheses. [1].
-
-.. _MAP_ANNOT_OFFSET_PRIMARY:
-
-**MAP_ANNOT_OFFSET_PRIMARY**
- Distance from end of tick-mark to start of annotation [5p].
-
-.. _MAP_ANNOT_OFFSET_SECONDARY:
-
-**MAP_ANNOT_OFFSET_SECONDARY**
- Distance from base of primary annotation to the top of the secondary
- annotation [5p] (Only applies to time axes with both primary and
- secondary annotations).
-
-.. _MAP_ANNOT_ORTHO:
-
-**MAP_ANNOT_ORTHO**
- Determines which axes will get their annotations (for linear
- projections) plotted orthogonally to the axes. Combine any **w**,
- **e**, **s**, **n**, **z** (uppercase allowed as well). [we].
-
-.. _MAP_DEFAULT_PEN:
-
-**MAP_DEFAULT_PEN**
- Sets the default of all pens related to **-W** options. Prepend
- **+** to overrule the color of the parameters
- **MAP_GRID_PEN_PRIMARY**, **MAP_GRID_PEN_SECONDARY**,
- **MAP_FRAME_PEN**, **MAP_TICK_PEN_PRIMARY**, and
- **MAP_TICK_PEN_SECONDARY** by the color of **MAP_DEFAULT_PEN**
- [default,black].
-
-.. _MAP_DEGREE_SYMBOL:
-
-**MAP_DEGREE_SYMBOL**
- Determines what symbol is used to plot the degree symbol on
- geographic map annotations. Choose between ring, degree, colon, or
- none [ring].
-
-.. _MAP_FRAME_AXES:
-
-**MAP_FRAME_AXES**
- Sets which axes to draw and annotate. Combine any uppercase **W**,
- **E**, **S**, **N**, **Z** to draw and annotate west, east, south,
- north and/or vertical (perspective view only) axis. Use lower case
- to draw the axis only, but not annotate. Add an optional **+** to
- draw a cube of axes in perspective view. [WESN].
-
-.. _MAP_FRAME_PEN:
-
-**MAP_FRAME_PEN**
- Pen attributes used to draw plain map frame [thicker,black].
-
-.. _MAP_FRAME_TYPE:
-
-**MAP_FRAME_TYPE**
- Choose between **inside**, **plain** and **fancy** (thick boundary,
- alternating black/white frame; append **+** for rounded corners)
- [fancy]. For some map projections (e.g., Oblique Mercator), plain is
- the only option even if fancy is set as default. In general, fancy
- only applies to situations where the projected x and y directions
- parallel the longitude and latitude directions (e.g., rectangular
- projections, polar projections). For situations where all boundary
- ticks and annotations must be inside the maps (e.g., for preparing
- geotiffs), chose **inside**.
-
-.. _MAP_FRAME_WIDTH:
-
-**MAP_FRAME_WIDTH**
- Width (> 0) of map borders for fancy map frame [5p].
-
-.. _MAP_GRID_CROSS_SIZE_PRIMARY:
-
-**MAP_GRID_CROSS_SIZE_PRIMARY**
- Size (>= 0) of grid cross at lon-lat intersections. 0 means draw
- continuous gridlines instead [0p].
-
-.. _MAP_GRID_CROSS_SIZE_SECONDARY:
-
-**MAP_GRID_CROSS_SIZE_SECONDARY**
- Size (>= 0) of grid cross at secondary lon-lat intersections. 0
- means draw continuous gridlines instead [0p].
-
-.. _MAP_GRID_PEN_PRIMARY:
-
-**MAP_GRID_PEN_PRIMARY**
- Pen attributes used to draw primary grid lines in dpi units or
- points (append p) [default,black].
-
-.. _MAP_GRID_PEN_SECONDARY:
-
-**MAP_GRID_PEN_SECONDARY**
- Pen attributes used to draw secondary grid lines in dpi units or
- points (append p) [thinner,black].
-
-.. _MAP_LABEL_OFFSET:
-
-**MAP_LABEL_OFFSET**
- Distance from base of axis annotations to the top of the axis label [8p].
-
-.. _MAP_LINE_STEP:
-
-**MAP_LINE_STEP**
- Determines the maximum length (> 0) of individual straight
- line-segments when drawing arcuate lines [0.75p]
-
-.. _MAP_LOGO:
-
-**MAP_LOGO**
- (**-U**) Specifies if a GMT logo with system timestamp should be
- plotted at the lower left corner of the plot [false].
-
-.. _MAP_LOGO_POS:
-
-**MAP_LOGO_POS**
- (**-U**) Sets the justification and the position of the
- logo/timestamp box relative to the current plots lower left corner
- of the plot [BL/-54p/-54p].
-
-.. _MAP_ORIGIN_X:
-
-**MAP_ORIGIN_X**
- (**-X**) Sets the x-coordinate of the origin on the paper for a
- new plot [1i]. For an overlay, the default offset is 0.
-
-.. _MAP_ORIGIN_Y:
-
-**MAP_ORIGIN_Y**
- (**-Y**) Sets the y-coordinate of the origin on the paper for a
- new plot [1i]. For an overlay, the default offset is 0.
-
-.. _MAP_POLAR_CAP:
-
-**MAP_POLAR_CAP**
- Controls the appearance of gridlines near the poles for all
- azimuthal projections and a few others in which the geographic poles
- are plotted as points (Lambert Conic, Hammer, Mollweide, Sinusoidal,
- and van der Grinten). Specify either none (in which case there is no
- special handling) or *pc_lat*/*pc_dlon*. In that case, normal
- gridlines are only drawn between the latitudes
- -*pc_lat*/+*pc_lat*, and above those latitudes the gridlines are
- spaced at the (presumably coarser) *pc_dlon* interval; the two
- domains are separated by a small circle drawn at the *pc_lat*
- latitude [85/90]. Note for r-theta (polar) projection where r = 0 is
- at the center of the plot the meaning of the cap is reversed, i.e.,
- the default 85/90 will draw a r = 5 radius circle at the center of
- the map with less frequent radial lines there.
-
-.. _MAP_SCALE_HEIGHT:
-
-**MAP_SCALE_HEIGHT**
- Sets the height (> 0) on the map of the map scale bars drawn by
- various programs [5p].
-
-.. _MAP_TICK_LENGTH_PRIMARY:
-
-**MAP_TICK_LENGTH_PRIMARY**
- The length of a primary major/minor tick-marks [5p/2.5p]. If only
- the first value is set, the second is assumed to be 50% of the first.
-
-.. _MAP_TICK_LENGTH_SECONDARY:
-
-**MAP_TICK_LENGTH_SECONDARY**
- The length of a secondary major/minor tick-marks [15p/3.75p]. If
- only the first value is set, the second is assumed to be 25% of the first.
-
-.. _MAP_TICK_PEN_PRIMARY:
-
-**MAP_TICK_PEN_PRIMARY**
- Pen attributes to be used for primary tick-marks in dpi units or
- points (append p) [thinner,black].
-
-.. _MAP_TICK_PEN_SECONDARY:
-
-**MAP_TICK_PEN_SECONDARY**
- Pen attributes to be used for secondary tick-marks in dpi units or
- points (append p) [thinner,black].
-
-.. _MAP_TITLE_OFFSET:
-
-**MAP_TITLE_OFFSET**
- Distance from top of axis annotations (or axis label, if present) to
- base of plot title [14p].
-
-.. _MAP_VECTOR_SHAPE:
-
-**MAP_VECTOR_SHAPE**
- Determines the shape of the head of a vector. Normally (i.e., for
- vector_shape = 0), the head will be triangular, but can be changed
- to an arrow (1) or an open V (2).
- Intermediate settings give something in between. Negative values (up
- to -2) are allowed as well [0].
-
-.. _PROJ_AUX_LATITUDE:
-
-**PROJ_AUX_LATITUDE**
- Only applies when geodesics are approximated by great circle
- distances on an equivalent sphere. Select from authalic, geocentric,
- conformal, meridional, parametric, or none [authalic]. When not none
- we convert any latitude used in the great circle calculation to the
- chosen auxiliary latitude before doing the distance calculation. See
- also **PROJ_MEAN_RADIUS**.
-
-.. _Projection Parameters:
-
-.. _PROJ_ELLIPSOID:
-
-**PROJ_ELLIPSOID**
- The (case sensitive) name of the ellipsoid used for the map projections [WGS-84]. Choose among:
-
-|
-| *Airy*: Applies to Great Britain (1830)
-| *Airy-Ireland*: Applies to Ireland in 1965 (1830)
-| *Andrae*: Applies to Denmark and Iceland (1876)
-| *APL4.9*: Appl. Physics (1965)
-| *ATS77*: Average Terrestrial System, Canada Maritime provinces (1977)
-| *Australian*: Applies to Australia (1965)
-| *Bessel*: Applies to Central Europe, Chile, Indonesia (1841)
-| *Bessel-Namibia*: Same as Bessel-Schwazeck (1841)
-| *Bessel-NGO1948*: Modified Bessel for NGO 1948 (1841)
-| *Bessel-Schwazeck*: Applies to Namibia (1841)
-| *Clarke-1858*: Clarke's early ellipsoid (1858)
-| *Clarke-1866*: Applies to North America, the Philippines (1866)
-| *Clarke-1866-Michigan*: Modified Clarke-1866 for Michigan (1866)
-| *Clarke-1880*: Applies to most of Africa, France (1880)
-| *Clarke-1880-Arc1950*: Modified Clarke-1880 for Arc 1950 (1880)
-| *Clarke-1880-IGN*: Modified Clarke-1880 for IGN (1880)
-| *Clarke-1880-Jamaica*: Modified Clarke-1880 for Jamaica (1880)
-| *Clarke-1880-Merchich*: Modified Clarke-1880 for Merchich (1880)
-| *Clarke-1880-Palestine*: Modified Clarke-1880 for Palestine (1880)
-| *CPM*: Comm. des Poids et Mesures, France (1799)
-| *Delambre*: Applies to Belgium (1810)
-| *Engelis*: Goddard Earth Models (1985)
-| *Everest-1830*: India, Burma, Pakistan, Afghanistan, Thailand (1830)
-| *Everest-1830-Kalianpur*: Modified Everest for Kalianpur (1956) (1830)
-| *Everest-1830-Kertau*: Modified Everest for Kertau, Malaysia & Singapore (1830)
-| *Everest-1830-Pakistan*: Modified Everest for Pakistan (1830)
-| *Everest-1830-Timbalai*: Modified Everest for Timbalai, Sabah Sarawak (1830)
-| *Fischer-1960*: Used by NASA for Mercury program (1960)
-| *Fischer-1960-SouthAsia*: Same as Modified-Fischer-1960 (1960)
-| *Fischer-1968*: Used by NASA for Mercury program (1968)
-| *FlatEarth*: As Sphere, but implies fast "Flat Earth" distance calculations (1984)
-| *GRS-67*: International Geodetic Reference System (1967)
-| *GRS-80*: International Geodetic Reference System (1980)
-| *Hayford-1909*: Same as the International 1924 (1909)
-| *Helmert-1906*: Applies to Egypt (1906)
-| *Hough*: Applies to the Marshall Islands (1960)
-| *Hughes-1980*: Hughes Aircraft Company for DMSP SSM/I grid products (1980)
-| *IAG-75*: International Association of Geodesy (1975)
-| *Indonesian*: Applies to Indonesia (1974)
-| *International-1924*: Worldwide use (1924)
-| *International-1967*: Worldwide use (1967)
-| *Kaula*: From satellite tracking (1961)
-| *Krassovsky*: Used in the (now former) Soviet Union (1940)
-| *Lerch*: For geoid modelling (1979)
-| *Maupertius*: Really old ellipsoid used in France (1738)
-| *Mercury-1960*: Same as Fischer-1960 (1960)
-| *MERIT-83*: United States Naval Observatory (1983)
-| *Modified-Airy*: Same as Airy-Ireland (1830)
-| *Modified-Fischer-1960*: Applies to Singapore (1960)
-| *Modified-Mercury-1968*: Same as Fischer-1968 (1968)
-| *NWL-10D*: Naval Weapons Lab (Same as WGS-72) (1972)
-| *NWL-9D*: Naval Weapons Lab (Same as WGS-66) (1966)
-| *OSU86F*: Ohio State University (1986)
-| *OSU91A*: Ohio State University (1991)
-| *Plessis*: Old ellipsoid used in France (1817)
-| *SGS-85*: Soviet Geodetic System (1985)
-| *South-American*: Applies to South America (1969)
-| *Sphere*: The mean radius in WGS-84 (for spherical/plate tectonics applications) (1984)
-| *Struve*: Friedrich Georg Wilhelm Struve (1860)
-| *TOPEX*: Used commonly for altimetry (1990)
-| *Walbeck*: First least squares solution by Finnish astronomer (1819)
-| *War-Office*: Developed by G. T. McCaw (1926)
-| *WGS-60*: World Geodetic System (1960)
-| *WGS-66*: World Geodetic System (1966)
-| *WGS-72*: World Geodetic System (1972)
-| *WGS-84*: World Geodetic System [Default] (1984)
-| *Moon*: Moon (IAU2000) (2000)
-| *Mercury*: Mercury (IAU2000) (2000)
-| *Venus*: Venus (IAU2000) (2000)
-| *Mars*: Mars (IAU2000) (2000)
-| *Jupiter*: Jupiter (IAU2000) (2000)
-| *Saturn*: Saturn (IAU2000) (2000)
-| *Uranus*: Uranus (IAU2000) (2000)
-| *Neptune*: Neptune (IAU2000) (2000)
-| *Pluto*: Pluto (IAU2000) (2000)
-
- Note that for some global projections, GMT may use a spherical
- approximation of the ellipsoid chosen, setting the flattening to
- zero, and using a mean radius. A warning will be given when this
- happens. If a different ellipsoid name than those mentioned here is
- given, GMT will attempt to parse the name to extract the
- semi-major axis (*a* in m) and the flattening. Formats allowed are:
-
- *a* implies a zero flattening
-
- *a*,\ *inv_f* where *inv_f* is the inverse flattening
-
- *a*,\ **b=**\ *b* where *b* is the semi-minor axis (in m)
-
- *a*,\ **f=**\ *f* where *f* is the flattening
-
- This way a custom ellipsoid (e.g., those used for other planets) may
- be used. Further note that coordinate transformations in
- **mapproject** can also specify specific datums; see the
- :doc:`mapproject` man page for further details and how to view
- ellipsoid and datum parameters.
-
-.. _PROJ_LENGTH_UNIT:
-
-**PROJ_LENGTH_UNIT**
- Sets the unit length. Choose between **c**\ m, **i**\ nch, or
- **p**\ oint [c (or i)]. Note that, in GMT, one point is defined
- as 1/72 inch (the PostScript definition), while it is often
- defined as 1/72.27 inch in the typesetting industry. There is no
- universal definition.
-
-.. _PROJ_MEAN_RADIUS:
-
-**PROJ_MEAN_RADIUS**
- Applies when geodesics are approximated by great circle distances on
- an equivalent sphere or when surface areas are computed. Select from
- mean (R_1), authalic (R_2), volumetric (R_3), meridional, or
- quadratic [authalic]. See also PROJ_MEAN_RADIUS.
-
-.. _PROJ_SCALE_FACTOR:
-
-**PROJ_SCALE_FACTOR**
- Changes the default map scale factor used for the Polar
- Stereographic [0.9996], UTM [0.9996], and Transverse Mercator [1]
- projections in order to minimize areal distortion. Provide a new
- scale-factor or leave as default.
-
-.. _PostScript Parameters:
-
-.. _PS_CHAR_ENCODING:
-
-**PS_CHAR_ENCODING**
- (static) Names the eight bit character set being used for text in
- files and in command line parameters. This allows GMT to ensure
- that the PostScript output generates the correct characters on the
- plot.. Choose from Standard, Standard+, ISOLatin1, ISOLatin1+, and
- ISO-8859-x (where x is in the ranges [1,10] or [13,15]). See
- Appendix F for details [ISOLatin1+ (or Standard+)].
-
-.. _PS_COLOR_MODEL:
-
-**PS_COLOR_MODEL**
- Determines whether PostScript output should use RGB, HSV, CMYK, or
- GRAY when specifying color [rgb]. Note if HSV is selected it does
- not apply to images which in that case uses RGB. When selecting
- GRAY, all colors will be converted to gray scale using YIQ
- (television) conversion.
-
-.. _PS_COMMENTS:
-
-**PS_COMMENTS**
- (static) If true we will issue comments in the PostScript file
- that explain the logic of operations. These are useful if you need
- to edit the file and make changes; otherwise you can set it to false
- which yields a somewhat slimmer PostScript file [false].
-
-.. _PS_IMAGE_COMPRESS:
-
-**PS_IMAGE_COMPRESS**
- Determines if PostScript images are compressed using the Run-Length
- Encoding scheme (rle), Lempel-Ziv-Welch compression (lzw), DEFLATE
- compression (deflate[,level]), or not at all (none) [deflate,5]. When
- specifying deflate, the compression level (1--9) may optionally be
- appended.
-
-.. _PS_LINE_CAP:
-
-**PS_LINE_CAP**
- Determines how the ends of a line segment will be drawn. Choose
- among a *butt* cap (default) where there is no projection beyond the
- end of the path, a *round* cap where a semicircular arc with
- diameter equal to the line-width is drawn around the end points, and
- *square* cap where a half square of size equal to the line-width
- extends beyond the end of the path [butt].
-
-.. _PS_LINE_JOIN:
-
-**PS_LINE_JOIN**
- Determines what happens at kinks in line segments. Choose among a
- *miter* join where the outer edges of the strokes for the two
- segments are extended until they meet at an angle (as in a picture
- frame; if the angle is too acute, a bevel join is used instead, with
- threshold set by **PS_MITER_LIMIT**), *round* join where a
- circular arc is used to fill in the cracks at the kinks, and *bevel*
- join which is a miter join that is cut off so kinks are triangular in shape [miter].
-
-.. _PS_MEDIA:
-
-**PS_MEDIA**
- Sets the physical format of the current plot paper [a4 (or letter)].
- The following formats (and their widths and heights in points) are
- recognized (Additional site-specific formats may be specified in the
- gmt_custom_media.conf file in **$GMT_SHAREDIR**/conf or ~/.gmt;
- see that file for details):
-
- Media width height
-
- * A0 2380 3368
- * A1 1684 2380
- * A2 1190 1684
- * A3 842 1190
- * A4 595 842
- * A5 421 595
- * A6 297 421
- * A7 210 297
- * A8 148 210
- * A9 105 148
- * A10 74 105
- * B0 2836 4008
- * B1 2004 2836
- * B2 1418 2004
- * B3 1002 1418
- * B4 709 1002
- * B5 501 709
- * archA 648 864
- * archB 864 1296
- * archC 1296 1728
- * archD 1728 2592
- * archE 2592 3456
- * flsa 612 936
- * halfletter 396 612
- * statement 396 612
- * note 540 720
- * letter 612 792
- * legal 612 1008
- * 11x17 792 1224
- * tabloid 792 1224
- * ledger 1224 792
-
- For a completely custom format (e.g., for large format plotters) you
- may also specify WxH, where W and H are in points unless you append
- a unit to each dimension (**c**, **i**, **m** or **p** [Default]).
-
-.. _PS_MITER_LIMIT:
-
-**PS_MITER_LIMIT**
- Sets the threshold angle in degrees (integer in range [0,180]) used
- for mitered joins only. When the angle between joining line segments
- is smaller than the threshold the corner will be bevelled instead of
- mitered. The default threshold is 35 degrees. Setting the threshold
- angle to 0 implies the PostScript default of about 11 degrees.
- Setting the threshold angle to 180 causes all joins to be beveled.
-
-.. _PS_PAGE_COLOR:
-
-**PS_PAGE_COLOR**
- Sets the color of the imaging background, i.e., the paper [white].
-
-.. _PS_PAGE_ORIENTATION:
-
-**PS_PAGE_ORIENTATION**
- (**\* -P**) Sets the orientation of the page. Choose portrait or
- landscape [landscape].
-
-.. _PS_SCALE_X:
-
-**PS_SCALE_X**
- Global x-scale (> 0) to apply to plot-coordinates before plotting.
- Normally used to shrink the entire output down to fit a specific
- height/width [1.0].
-
-.. _PS_SCALE_Y:
-
-**PS_SCALE_Y**
- Global y-scale (> 0) to apply to plot-coordinates before plotting.
- Normally used to shrink the entire output down to fit a specific
- height/width [1.0].
-
-.. _PS_TRANSPARENCY:
-
-**PS_TRANSPARENCY**
- Sets the transparency mode to use when preparing PS for rendering to
- PDF. Choose from Color, ColorBurn, ColorDodge, Darken, Difference,
- Exclusion, HardLight, Hue, Lighten, Luminosity, Multiply, Normal,
- Overlay, Saturation, SoftLight, and Screen [Normal].
-
-.. _Calendar/Time Parameters:
-
-.. _TIME_EPOCH:
-
-**TIME_EPOCH**
- Specifies the value of the calendar and clock at the origin (zero
- point) of relative time units (see **TIME_UNIT**). It is a string
- of the form yyyy-mm-ddT[hh:mm:ss] (Gregorian) or
- yyyy-Www-ddT[hh:mm:ss] (ISO) Default is 1970-01-01T00:00:00, the
- origin of the UNIX time epoch.
-
-.. _TIME_INTERVAL_FRACTION:
-
-**TIME_INTERVAL_FRACTION**
- Determines if partial intervals at the start and end of an axis
- should be annotated. If the range of the partial interval exceeds
- the specified fraction of the normal interval stride we will place
- the annotation centered on the partial interval [0.5].
-
-.. _TIME_IS_INTERVAL:
-
-**TIME_IS_INTERVAL**
- Used when input calendar data should be truncated and adjusted to
- the middle of the relevant interval. In the following discussion,
- the unit **u** can be one of these time units: (**y** year, **o**
- month, **u** ISO week, **d** day, **h** hour, **m** minute, and
- **s** second). **TIME_IS_INTERVAL** can have any of the following
- three values: (1) OFF [Default]. No adjustment, time is decoded as
- given. (2) +\ *n*\ **u**. Activate interval adjustment for input by
- truncate to previous whole number of *n* units and then center time
- on the following interval. (3) -*n*\ **u**. Same, but center time on
- the previous interval. For example, with **TIME_IS_INTERVAL** =
- +1o, an input data string like 1999-12 will be interpreted to mean
- 1999-12-15T12:00:00.0 (exactly middle of December), while if
- **TIME_IS_INTERVAL** = off then that date is interpreted to mean
- 1999-12-01T00:00:00.0 (start of December) [off].
-
-.. _TIME_LANGUAGE:
-
-**TIME_LANGUAGE**
- Language to use when plotting calendar items such as months and
- days. Select from:
-
- * BR Brazilian Portuguese
- * CN1 Simplified Chinese
- * CN2 Traditional Chinese
- * DE German
- * DK Danish
- * EH Basque
- * ES Spanish
- * FI Finnish
- * FR French
- * GR Greek
- * HI Hawaiian
- * HU Hungarian
- * IE Irish
- * IL Hebrew
- * IS Icelandic
- * IT Italian
- * JP Japanese
- * NL Dutch
- * NO Norwegian
- * PL Polish
- * PT Portuguese
- * RU Russian
- * SE Swedish
- * SG Scottish Gaelic
- * TO Tongan
- * TR Turkish
- * UK British English
- * US US English
-
- If your language is not supported, please examine the
- **$GMT_SHAREDIR**/time/us.d file and make a similar file. Please
- submit it to the GMT Developers for official inclusion. Custom
- language files can be placed in directories **$GMT_SHAREDIR**/time
- or ~/.gmt. Note: Some of these languages may require you to also
- change the **PS_CHAR_ENCODING** setting.
-
-.. _TIME_SYSTEM:
-
-**TIME_SYSTEM**
- Shorthand for a combination of **TIME_EPOCH** and **TIME_UNIT**,
- specifying which time epoch the relative time refers to and what the
- units are. Choose from one of the preset systems below (epoch and
- units are indicated):
-
- JD -4713-11-25T12:00:00 d (Julian Date)
-
- MJD 1858-11-17T00:00:00 d (Modified Julian Date)
-
- J2000 2000-01-01T12:00:00 d (Astronomical time)
-
- S1985 1985-01-01T00:00:00 s (Altimetric time)
-
- UNIX 1970-01-01T00:00:00 s (UNIX time)
-
- RD0001 0001-01-01T00:00:00 s
-
- RATA 0000-12-31T00:00:00 d
-
- This parameter is not stored in the **gmt.conf** file but is
- translated to the respective values of **TIME_EPOCH** and
- **TIME_UNIT**.
-
-.. _TIME_UNIT:
-
-**TIME_UNIT**
- Specifies the units of relative time data since epoch (see
- **TIME_EPOCH**). Choose y (year - assumes all years are 365.2425
- days), o (month - assumes all months are of equal length y/12), d
- (day), h (hour), m (minute), or s (second) [s].
-
-.. _TIME_WEEK_START:
-
-**TIME_WEEK_START**
- When weeks are indicated on time axes, this parameter determines the
- first day of the week for Gregorian calendars. (The ISO weekly
- calendar always begins weeks with Monday.) [Monday (or Sunday)].
-
-.. _TIME_Y2K_OFFSET_YEAR:
-
-**TIME_Y2K_OFFSET_YEAR**
- When 2-digit years are used to represent 4-digit years (see various
- **FORMAT_DATE**\ s), **TIME_Y2K_OFFSET_YEAR** gives the first
- year in a 100-year sequence. For example, if
- **TIME_Y2K_OFFSET_YEAR** is 1729, then numbers 29 through 99
- correspond to 1729 through 1799, while numbers 00 through 28
- correspond to 1800 through 1828. [1950].
-
-See Also
---------
-
-:doc:`gmt` , :doc:`gmtdefaults` ,
-:doc:`gmtcolors` , :doc:`gmtget` ,
-:doc:`gmtset`
diff --git a/doc_release/html/_sources/gmt.txt b/doc_release/html/_sources/gmt.txt
deleted file mode 100644
index 46d0ba8..0000000
--- a/doc_release/html/_sources/gmt.txt
+++ /dev/null
@@ -1,187 +0,0 @@
-.. index:: ! gmt
-
-***
-gmt
-***
-
-.. only:: not man
-
- gmt - The Generic Mapping Tools data processing and display software package
-
-Introduction
-------------
-
-GMT is a collection of public-domain Unix tools that allows you to
-manipulate x,y and x,y,z data sets (filtering, trend fitting, gridding,
-projecting, etc.) and produce PostScript illustrations ranging from
-simple x-y plots, via contour maps, to artificially illuminated surfaces
-and 3-D perspective views in black/white or full color. Linear, log10,
-and power scaling is supported in addition to over 30 common map
-projections. The processing and display routines within GMT are
-completely general and will handle any (x,y) or (x,y,z) data as input.
-
-Synopsis
---------
-
-**gmt** is the main program that can start any of the modules:
-
-**gmt** module module-options
-
-where module is the name of a GMT module and the options are those
-that pertain to that particular module. If no module is given then
-several other options are available:
-
-**-**\ **-help**
- List and description of GMT modules.
-
-**-**\ **-version**
- Print version and exit.
-
-**-**\ **-show-datadir**
- Show data directory and exit.
-
-**-**\ **-show-bindir**
- Show directory of executables and exit.
-
-**=**
- Check if that module exist and if so the
- program will exit with status of 0; otherwise the status of exit will
- be non-zero.
-
-Command-line completion
------------------------
-
-GMT provides basic command-line completion (tab completion) for bash.
-The completion rules are either installed in ``/etc/bash_completion.d/gmt``
-or ``<prefix>/share/tools/gmt_completion.bash``. Depending on the
-distribution, you may still need to source the gmt completion file from
-``~/.bash_completion`` or ``~/.bashrc``. For more information see Section
-:ref:`command-line-completion` in the CookBook.
-
-GMT Overview
-------------
-
-The following is a summary of all the programs supplied with GMT and
-a very short description of their purpose. Detailed information about
-each program can be found in the separate manual pages.
-
-.. include:: explain_gmt_modules.rst_
-
-Custom Modules
---------------
-
-The **gmt** program can also load custom modules from shared libraries
-built as specified in the GMT API documentation. This way your modules
-can benefit form the GMT infrastructure and extend GMT in specific ways.
-
-The Common GMT Options
-----------------------
-
-.. include:: common_SYN_OPTs.rst_
-
-|SYN_OPT-B|
-**-J**\ *parameters*
-**-Jz**\ \|\ **Z**\ *parameters* **-K** **-O** **-P**
-|SYN_OPT-Rz|
-|SYN_OPT-U|
-|SYN_OPT-V|
-|SYN_OPT-X|
-|SYN_OPT-Y|
-|SYN_OPT-a|
-|SYN_OPT-b|
-|SYN_OPT-f|
-|SYN_OPT-g|
-|SYN_OPT-h|
-|SYN_OPT-i|
-|SYN_OPT-o|
-|SYN_OPT-p|
-**-r**
-|SYN_OPT-s|
-|SYN_OPT-t|
-|SYN_OPT-:|
-
-Description
------------
-
-These are all the common GMT options that remain the same for all GMT
-programs. No space between the option flag and the associated arguments.
-
-.. include:: explain_-B_full.rst_
-
-.. include:: explain_-J_full.rst_
-
-.. include:: explain_-Jz_full.rst_
-
-.. include:: explain_-K_full.rst_
-
-.. include:: explain_-O_full.rst_
-
-.. include:: explain_-P_full.rst_
-
-.. include:: explain_-R_full.rst_
-
-.. include:: explain_-Rz_full.rst_
-
-.. include:: explain_-U_full.rst_
-
-.. include:: explain_-V_full.rst_
-
-.. include:: explain_-XY_full.rst_
-
-.. include:: explain_-aspatial_full.rst_
-
-.. |Add_-bi| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-bi_full.rst_
-
-.. include:: explain_-bo_full.rst_
-
-.. include:: explain_-c_full.rst_
-
-.. include:: explain_colon_full.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f_full.rst_
-
-.. |Add_-g| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-g_full.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h_full.rst_
-
-.. include:: explain_-icols_full.rst_
-
-.. include:: explain_-n_full.rst_
-
-.. include:: explain_-ocols_full.rst_
-
-.. include:: explain_perspective_full.rst_
-
-.. include:: explain_nodereg_full.rst_
-
-.. include:: explain_-s_full.rst_
-
-.. include:: explain_-t_full.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_color.rst_
-
-.. include:: explain_fill.rst_
-
-.. include:: explain_font.rst_
-
-.. include:: explain_pen.rst_
-
-.. include:: explain_precision.rst_
-
-.. include:: explain_grd_inout.rst_
-
-See Also
---------
-
-Look up the individual man pages for more details and full syntax. Run
-``gmt --help`` to list all GMT programs and to show all installation
-directories. For an explanation of the various GMT settings in this
-man page (like :ref:`FORMAT_FLOAT_OUT <FORMAT_FLOAT_OUT>`), see the man page of the GMT
-configuration file :doc:`gmt.conf`. Information is also available on the
-GMT home page http://gmt.soest.hawaii.edu/
diff --git a/doc_release/html/_sources/gmt2kml.txt b/doc_release/html/_sources/gmt2kml.txt
deleted file mode 100644
index 45e9d2e..0000000
--- a/doc_release/html/_sources/gmt2kml.txt
+++ /dev/null
@@ -1,358 +0,0 @@
-.. index:: ! gmt2kml
-
-*******
-gmt2kml
-*******
-
-.. only:: not man
-
- gmt2kml - Convert GMT data tables to KML files for Google Earth
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**gmt2kml** [ *table* ]
-[ **-A**\ **a**\ \|\ **g**\ \|\ **s**\ [*alt*\ \|\ **x**\ *scale*] ]
-[ **-C**\ *cpt* ] [ **-D**\ *descriptfile* ] [ **-E**\ [*altitude*] ]
-[ **-F**\ **e**\ \|\ **s**\ \|\ **t**\ \|\ **l**\ \|\ **p** ]
-[ **-G**\ **f\|n**\ **-**\ \|\ *fill* ] [ **-I**\ *icon* ] [ **-K**]
-[ **-L**\ *col1:name1*,\ *col2:name2*,... ]
-[ **-N**\ [+\|*name\_template*\ \|\ *name*] ] [ **-O**]
-[ **-Ra**\ \|\ *w/e/s/n* ] [ **-S**\ **c**\ \|\ **n**\ *scale*] ]
-[ **-T**\ *title*\ [/*foldername*] ]
-[ |SYN_OPT-V| ]
-[ **-W**\ [**-**\ \|\ **+**]\ *pen* ] [ **-Z**\ *args* ]
-[ |SYN_OPT-bi| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-:| ]
-[ > *output.kml* ]
-
-|No-spaces|
-
-Description
------------
-
-**gmt2kml** reads one or more GMT table file and converts them to a
-single output file using Google Earth's KML format. Data may represent
-points, lines, or polygons, and you may specify additional attributes
-such as title, altitude mode, colors, pen widths, transparency, regions,
-and data descriptions. You may also extend the feature down to ground
-level (assuming it is above it) and use custom icons for point symbols.
-
-The input files should contain the following columns:
-
-*lon* *lat* [ *alt* ] [ *timestart* [ *timestop* ] ]
-
-where *lon* and *lat* are required for all features, *alt* is optional
-for all features (see also **-A** and **-C**), and *timestart* and
-*timestop* apply to events and timespan features.
-
-Required Arguments
-------------------
-
-None.
-
-Optional Arguments
-------------------
-
-.. |Add_intables| unicode:: 0x20 .. just an invisible code
-.. include:: explain_intables.rst_
-
-**-A**\ **a**\ \|\ **g**\ \|\ **s**\ [*alt*\ \|\ **x**\ *scale*]
- Select one of three altitude modes recognized by Google Earth that
- determines the altitude (in m) of the feature: **a** absolute
- altitude, **g** altitude relative to sea surface or ground, **s**
- altitude relative to seafloor or ground. To plot the features at a
- fixed altitude, append an altitude *alt* (in m). Use 0 to clamp the
- features to the chosen reference surface. Append **x**\ *scale* to
- scale the altitude from the input file by that factor. If no value
- is appended, the altitude (in m) is read from the 3rd column of the
- input file. [By default the features are clamped to the sea surface or ground].
-
-**-C**\ *cpt*
- Use color palette for assigning colors to the symbol, event, or
- timespan icons, based on the value in the 3rd column of the input
- file. For lines or polygons we examine the segment header for
- -Z<value> statements and obtain the color via the cpt lookup. Note
- only discrete colors are possible.
-
-**-D**\ *descriptfile*
- File with HTML snippets that will be included as part of the main
- description content for the KML file [no description]. See SEGMENT
- INFORMATION below for feature-specific descriptions.
-
-**-E**\ [*altitude*]
- Extrude feature down to ground level [no extrusion].
-
-**-F**\ **e**\ \|\ **s**\ \|\ **t**\ \|\ **l**\ \|\ **p**
- Sets the feature type. Choose from points (**e**\ vent,
- **s**\ ymbol, or **t**\ imespan), **l**\ ine, or **p**\ olygon
- [symbol]. The first two columns of the input file should contain
- (*lon*, *lat*). When altitude or value is required (i.e., no
- *altitude* value was given with **-A**, or **-C** is set), the third
- column needs to contain the *altitude* (in m) or *value*. The event
- (**-Fe**) is a symbol that should only be active at a particular
- *time*, given in the next column. Timespan (**-Ft**) is a symbol
- that should only be active during a particular time period indicated
- by the next two columns (*timestart*, *timestop*). Use NaN to
- indicate unbounded time limits. If used, times should be in ISO
- format yyyy-mm-ddThh:mm:ss[.xxx] or in GMT relative time format (see **-f**).
-
-**-G**\ **f\|n**\ *fill*
- Set fill color for symbols, extrusions and polygons (**-Gf**)
- [Default is light orange at 75% transparency] or text labels
- (**-Gn**) [Default is white]. Optionally, use **-Gf-** to turn off
- polygon fill, and **-Gn-** to disable labels.
-
-**-I**\ *icon*
- Specify the URL to an alternative icon that should be used for the
- symbol [Default is a Google Earth circle]. If the URL starts with +
- then we will prepend
- `http://maps.google.com/mapfiles/kml/ <http://maps.google.com/mapfiles/kml/>`_
- to the name. To turn off icons entirely (e.g., when just wanting a
- text label), use **-I**-. [Default is a local icon with no directory path].
-
-**-K**
- Allow more KML code to be appended to the output later [finalize the KML file].
-
-**-L**\ *name1*,\ *name2*,...
- Extended data given. Append one or more column names separated by
- commas. We will expect the listed data columns to exist in the input
- immediately following the data coordinates and they will be encoded
- in the KML file as Extended Data sets, whose attributes will be
- available in the Google Earth balloon when the item is selected.
- This option is not available unless input is an ASCII file.
-
-**-N**\ [-\|+\|\ *name\_template*\ \|\ *name*]
- By default, if segment headers contain a **-L**"label string" then
- we use that for the name of the KML feature (polygon, line segment
- or set of symbols). Default names for these segments are "Line %d"
- and "Point Set %d", depending on the feature, where %d is a sequence
- number of line segments within a file. Each point within a line
- segment will be named after the line segment plus a sequence number.
- Default is simply "Point %d".
- Alternatively, select one of these options: (1) append **-** to
- supply individual symbol labels (single word) via the field
- immediately following the data coordinates, (2) append **+** to
- supply individual symbol labels as the rest the end of the data
- record following the data coordinates, (3) append a string that may
- include %d or a similar integer format to assign unique name IDs for
- each feature, with the segment number (for lines and polygons) or
- point number (symbols) appearing where %d is placed, (4) give no
- arguments to turn symbol labeling off; line segments will still be
- named. Note: if **-N-** is used with **-L** then the label must
- appear before the extended data columns. Also note that options
- (1) and (2) are not available unless input is an ASCII file.
-
-**-O**
- Appended KML code to an existing KML file [initialize a new KML file].
-
-**-Ra**\ \|\ *w/e/s/n*
- Issue a single Region tag. Append *w/e/s/n* to set a particular
- region (will ignore points outside the region), or append **a** to
- determine and use the actual domain of the data (single file only)
- [no region tags issued].
-
-**-S**\ **c**\ \|\ **n**\ *scale*]
- Scale icons or labels. Here, **-Sc** sets a scale for the symbol
- icon, whereas **-Sn** sets a scale for the name labels [1 for both].
-
-**-T**\ *title*\ [/*foldername*]
- Sets the document title [default is unset]. Optionally, append
- /*FolderName*; this allows you, with **-O**, **-K**, to group
- features into folders within the KML document. [The default folder
- name is "*Name* Features", where *Name* is Point, Event, Timespan,
- Line, or Polygon].
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-W**\ [**-**\ \|\ **+**]\ *pen*
- Set pen attributes for lines or polygon outlines. Append pen
- attributes to use [Defaults: width = default, color = black, style =
- solid]. If **-C** is given you may optionally use **-W-** to apply
- the cpt color to the polygon outline only (fill determined by
- **-G**) or **-W+** to use the cpt color for both polygon fill and
- outline. Note that for KML the pen width is given as integer pixel
- widths so you must specify pen width as *n*\ **p**, where *n* is an
- integer.
-**-Z**\ *args*
- Set one or more attributes of the Document and Region tags. Append
- **+a**\ *alt\_min/alt\_max* to specify limits on visibility based on
- altitude. Append **+l**\ *lod\_min/lod\_max* to specify limits on
- visibility based on Level Of Detail, where *lod\_max* == -1 means it
- is visible to infinite size. Append **+f**\ *fade\_min/fade\_max* to
- fade in and out over a ramp [abrupt]. Append **+v** to make a
- feature *not* visible when loaded [visible]. Append **+o** to open a
- folder or document in the sidebar when loaded [closed].
-
-.. |Add_-bi| replace:: [Default is 2 input columns].
-.. include:: explain_-bi.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-g| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-g.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. include:: explain_colon.rst_
-
-.. include:: explain_help.rst_
-
-
-Examples
---------
-
-To convert a file with point locations (lon, lat) into a KML file with
-red circle symbols, try
-
- ::
-
- gmt2kml mypoints.txt -Gfred -Fs > mypoints.kml
-
-To convert a multisegment file with lines (lon, lat) separated by
-segment headers that contain a **-L**\ labelstring with the feature
-name, selecting a thick white pen, and title the document, try
-
- ::
-
- gmt2kml mylines.txt -Wthick,white -Fl -T"Lines from here to there" > mylines.kml
-
-To convert a multisegment file with polygons (lon, lat) separated by
-segment headers that contain a **-L**\ labelstring with the feature
-name, selecting a thick black pen and semi-transparent yellow fill,
-giving a title to the document, and prescribing a particular region
-limit, try
-
- ::
-
- gmt gmt2kml mypolygons.txt -Gfyellow at 50 -Fp -T"My polygons" -R30/90/-20/40 > mypolygons.kml
-
-To convert a file with point locations (lon, lat, time) into a KML file
-with green circle symbols that will go active at the specified time and
-stay active going forward, try
-
- ::
-
- awk '{print $1, $2, $3, "NaN"}' mypoints.txt | gmt gmt2kml -Gfgreen -Ft > mytimepoints.kml
-
-To extract contours and labels every 10 units from the grid temp.nc and
-plot them in KML, using red lines at 75% transparency and red labels (no
-transparency), try
-
- ::
-
- gmt grdcontour temp.nc -Jx1id -A10+tlabel.txt -C10 -Dcontours.txt
- gmt gmt2kml contours.txt -Fl -W1p,red at 75 -K > contours.kml
- gmt gmt2kml -O -N+ -Fs -Sn2 -Gnred at 0 label.txt -I- >> contours.kml
-
-To instead plot the contours as lines with colors taken from the cpt
-file contours.cpt, try
-
- ::
-
- gmt gmt2kml contours.txt -Fl -Ccontours.cpt > contours.kml
-
-Limitations
------------
-
-Google Earth has trouble displaying filled polygons across the Dateline.
-For now you must manually break any polygon crossing the dateline into a
-west and east polygon and plot them separately.
-
-Making Kmz Files
-----------------
-
-Using the KMZ format is preferred as it takes less space. KMZ is simply
-a KML file and any data files, icons, or images referenced by the KML,
-contained in a zip archive. One way to organize large data sets is to
-split them into groups called Folders. A Document can contain any number
-of folders. Using scripts you can create a composite KML file using the
-**-K**, **-O** options just like you do with GMT plots. See **-T** for
-switching between folders and documents.
-
-Kml Hierarchy
--------------
-
-GMT stores the different features in hierarchical folders by feature
-type (when using **-O**, **-K** or **-T/**\ *foldername*), by input file
-(if not standard input), and by line segment (using the name from the
-segment header, or **-N**). This makes it more easy in Google Earth to
-switch on or off parts of the contents of the Document. The following is
-a crude example:
-
-[ KML header information; not present if **-O** was used ]
-
-<Document><name>GMT Data Document</name>
-
-<Folder><name>Point Features</name>
-
-<!--This level of folder is inserted only when using -O, -K>
-
-<Folder><name>file1.dat</name>
-
-<!--One folder for each input file (not when standard input)>
-
-<Folder><name>Point Set 0</name>
-
-<!--One folder per line segment>
-
-<!--Points from the first line segment in file file1.dat go here>
-
-<Folder><name>Point Set 1</name>
-
-<!--Points from the second line segment in file file1.dat go here>
-
-</Folder>
-
-</Folder>
-
-<Folder><name>Line Features</name>
-
-<Folder><name>file1.dat</name>
-
-<!--One folder for each input file (not when standard input)>
-
-<Placemark><name>Line 0</name>
-
-<!--Here goes the first line segment>
-
-</Placemark>
-
-<Placemark><name>Line 1</name>
-
-<!--Here goes the second line segment>
-
-</Placemark>
-
-</Folder>
-
-<Folder>
-
-</Document>
-
-[ KML trailer information; not present if **-K** was used ]
-
-Segment Information
--------------------
-
-**gmt2kml** will scan the segment headers for substrings of the form
-**-L**"*some label*\ " [also see **-N** discussion] and **-T**"*some
-text description*\ ". If present, these are parsed to supply name and
-description tags, respectively, for the current feature.
-
-See Also
---------
-
-:doc:`gmt` , :doc:`gmt.conf`,
-:doc:`img2google <supplements/img/img2google>`,
-:doc:`kml2gmt` , :doc:`ps2raster`
diff --git a/doc_release/html/_sources/gmt5syntax.txt b/doc_release/html/_sources/gmt5syntax.txt
deleted file mode 100644
index 7d57624..0000000
--- a/doc_release/html/_sources/gmt5syntax.txt
+++ /dev/null
@@ -1,27 +0,0 @@
-.. index:: ! gmt5syntax
-
-**********
-gmt5syntax
-**********
-
-.. only:: not man
-
- gmt5syntax - Convert old GMT script to use new 'gmt <module>' syntax
-
-Synopsis
---------
-
-**gmt5syntax** old_script > new_script
-
-Description
------------
-
-**gmt5syntax** is a perl script that converts old-style GMT commands in,
-e.g., shell scripts, to the new ``gmt <module>``-syntax. This utility is located
-in the tools subdirectory of the data directory. ``gmt --show-datadir`` will
-show the path to the latter.
-
-See Also
---------
-
-:doc:`gmt`
diff --git a/doc_release/html/_sources/gmt_shell_functions.sh.txt b/doc_release/html/_sources/gmt_shell_functions.sh.txt
deleted file mode 100644
index e2a761c..0000000
--- a/doc_release/html/_sources/gmt_shell_functions.sh.txt
+++ /dev/null
@@ -1,144 +0,0 @@
-.. index:: ! gmt_shell_functions.sh
-
-**********************
-gmt_shell_functions.sh
-**********************
-
-.. only:: not man
-
- gmt_shell_functions.sh - Practical functions to be used in GMT bourne shell scripts
-
-Synopsis
---------
-
-**gmt_init_tmpdir**
-
-**gmt_remove_tmpdir**
-
-**gmt_clean_up** [*prefix*]
-
-**gmt_message** *message*
-
-**gmt_abort** *message*
-
-**gmt_get_nrecords** *file(s)*
-
-**gmt_get_ndatarecords** *file(s)*
-
-**gmt_get_nfields** *string*
-
-**gmt_get_field** *string*
-
-**gmt_get_region** *file(s)* [*options*]
-
-**gmt_get_gridregion** *file* [*options*]
-
-**gmt_get_map_width** **-R** **-J**
-
-**gmt_get_map_height** **-R** **-J**
-
-**gmt_set_psfile** *file*
-
-**gmt_set_pdffile** *file*
-
-**gmt_set_framename** *prefix framenumber*
-
-**gmt_set_framenext** *framenumber*
-
-Description
------------
-
-**gmt_shell_functions.sh** provides a set of functions to Bourne
-(again) shell scripts in support of GMT. The calling shell script
-should include the following line, before the functions can be used:
-
-**. gmt_shell_functions.sh**
-
-Once included in a shell script, **gmt_shell_functions.sh** allows
-GMT users to do some scripting more easily than otherwise. The
-functions made available are:
-
-**gmt_init_tmpdir**
- Creates a temporary directory in **/tmp** or (when defined) in the
- directory specified by the environment variable **TMPDIR**. The name
- of the temporary directory is returned as environment variable
- **GMT_TMPDIR**. This function also causes GMT to run in
- 'isolation mode', i.e., all temporary files will be created in
- **GMT_TMPDIR** and the :doc:`gmt.conf` file will not be adjusted.
-
-**gmt_remove_tmpdir**
- Removes the temporary directory and unsets the **GMT_TMPDIR**
- environment variable.
-
-**gmt_cleanup**
- Remove all files and directories in which the current process number
- is part of the file name. If the optional *prefix* is given then we
- also delete all files and directories that begins with the given prefix.
-
-**gmt_message**
- Send a message to standard error.
-
-**gmt_abort**
- Send a message to standard error and exit the shell.
-
-**gmt_get_nrecords**
- Returns the total number of lines in *file(s)*
-
-**gmt_get_ndatarecords**
- Returns the total number of data records in *file(s)*, i.e., not counting headers.
-
-**gmt_get_nfields**
- Returns the number of fields or words in *string*
-
-**gmt_get_field**
- Returns the given *field* in a *string*. Must pass *string* between
- double quotes to preserve it as one item.
-
-**gmt_get_region**
- Returns the region in the form w/e/s/n based on the data in table
- *file(s)*. Optionally add -I*dx*/\ *dy* to round off the answer.
-
-**gmt_get_gridregion**
- Returns the region in the form w/e/s/n based on the header of a grid
- *file*. Optionally add -I*dx*/\ *dy* to round off the answer.
-
-**gmt_get_map_width**
- Expects the user to give the desired **-R** **-J** settings and
- returns the map width in the current measurement unit.
-
-**gmt_get_map_height**
- Expects the user to give the desired **-R** **-J** settings and
- returns the map height in the current measurement unit.
-
-**gmt_set_psfile**
- Create the output PostScript file name based on the base name of a
- given file (usually the script name **$0**).
-
-**gmt_set_framename**
- Returns a lexically ordered filename stem (i.e., no extension) given
- the file prefix and the current frame number, using a width of 6 for
- the integer including leading zeros. Useful when creating animations
- and lexically sorted filenames are required.
-
-**gmt_set_framenext**
- Accepts the current frame integer counter and returns the next
- integer counter.
-
-Notes
------
-
-1. These functions only work in the Bourne shell (**sh**) and their
-derivatives (like **ash**, **bash**, **ksh** and **zsh**). These
-functions do not work in the C shell (**csh**) or their derivatives
-(like **tcsh**), and cannot be used in DOS batch scripts either.
-
-2. **gmt_shell_functions.sh** were first introduced in GMT version
-4.2.2 and have since been regularly expanded with other practical
-scripting short-cuts. If you want to suggest other functions, please do
-so by adding a New Issue request on gmt.soest.hawaii.edu.
-
-See Also
---------
-
-:doc:`gmt` , :doc:`gmt.conf` ,
-:doc:`gmtinfo` , :doc:`grdinfo`
diff --git a/doc_release/html/_sources/gmtcolors.txt b/doc_release/html/_sources/gmtcolors.txt
deleted file mode 100644
index 5401fc1..0000000
--- a/doc_release/html/_sources/gmtcolors.txt
+++ /dev/null
@@ -1,1085 +0,0 @@
-.. index:: ! gmtcolors
-
-*********
-gmtcolors
-*********
-
-.. only:: not man
-
- gmtcolors - Explanation of color codes in GMT
-
-Description
------------
-
-Colors can be specified in GMT as arguments to commands, generally
-as part of the **-G** or **-W** options to select polygon fill or
-outline pen. Colors are also used in color pallette tables (cpt files)
-that help convert numerical values to colors.
-
-GMT allows several ways to represent a color:
-
-**Colorname**
- Specify one of the named colors below. All names are case-insensitive.
-
-**R/G/B**
- Specify **R**\ ed, **G**\ reen, and **B**\ lue levels. Each value is
- separated by a slash and is in the range from 0 (dark) to 255
- (light). This representation is used to color monitors.
-
-**#RRGGBB**
- Specify **R**\ ed, **G**\ reen, and **B**\ lue levels in the way
- that it is done in HTML. Use two characters for each color channel,
- ranging from 00 (dark) to FF (light). Upper and lower case are allowed.
-
-**Graylevel**
- For shades of gray, R = G = B, and only one number needs to be used.
- This representation is popular with black and white printers.
-
-**H-S-V**
- Specify **H**\ ue in the range 0 to 360 (degrees), **S** saturation
- between 0 (not saturated) and 1 (fully saturated), and value **V**
- between 0 (dark) and 1 (light). Number are separated by hyphens.
- This representation can be helpful when hue varies a lot.
-
-**C/M/Y/K**
- Specify **C**\ yan, **M**\ agenta, **Y**\ ellow, and blacBD(K). Each
- number is in the range from 0 (no paint) to 1 (maximum paint). This
- representation is used by most color printers.
-
-List Of Colors
---------------
-
-The following list contains the named colors that can be used in GMT
-and their equivalent color codes.
-
-
-+-----+-----+-----+----------------------+
-| *R* | *G* | *B* | *Name* |
-+=====+=====+=====+======================+
-| 255 | 250 | 250 | snow |
-+-----+-----+-----+----------------------+
-| 248 | 248 | 255 | ghostwite |
-+-----+-----+-----+----------------------+
-| 255 | 250 | 240 | floralwhite |
-+-----+-----+-----+----------------------+
-| 255 | 245 | 238 | seashell |
-+-----+-----+-----+----------------------+
-| 253 | 245 | 230 | oldlace |
-+-----+-----+-----+----------------------+
-| 250 | 240 | 230 | linen |
-+-----+-----+-----+----------------------+
-| 250 | 235 | 215 | antiquewhite |
-+-----+-----+-----+----------------------+
-| 255 | 239 | 213 | papayawhip |
-+-----+-----+-----+----------------------+
-| 255 | 235 | 205 | blanchedalmond |
-+-----+-----+-----+----------------------+
-| 255 | 228 | 196 | bisque |
-+-----+-----+-----+----------------------+
-| 255 | 218 | 185 | peachpuff |
-+-----+-----+-----+----------------------+
-| 255 | 222 | 173 | navajowhite |
-+-----+-----+-----+----------------------+
-| 255 | 228 | 181 | moccasin |
-+-----+-----+-----+----------------------+
-| 255 | 250 | 205 | lemonchiffon |
-+-----+-----+-----+----------------------+
-| 255 | 248 | 220 | cornsilk |
-+-----+-----+-----+----------------------+
-| 255 | 255 | 240 | ivory |
-+-----+-----+-----+----------------------+
-| 240 | 255 | 240 | honeydew |
-+-----+-----+-----+----------------------+
-| 245 | 255 | 250 | mintcream |
-+-----+-----+-----+----------------------+
-| 240 | 255 | 255 | azure |
-+-----+-----+-----+----------------------+
-| 240 | 248 | 255 | aliceblue |
-+-----+-----+-----+----------------------+
-| 230 | 230 | 250 | lavender |
-+-----+-----+-----+----------------------+
-| 255 | 240 | 245 | lavenderblush |
-+-----+-----+-----+----------------------+
-| 255 | 228 | 225 | mistyrose |
-+-----+-----+-----+----------------------+
-| 100 | 149 | 237 | cornflowerblue |
-+-----+-----+-----+----------------------+
-| 106 | 90 | 205 | slateblue |
-+-----+-----+-----+----------------------+
-| 123 | 104 | 238 | mediumslateblue |
-+-----+-----+-----+----------------------+
-| 132 | 112 | 255 | lightslateblue |
-+-----+-----+-----+----------------------+
-| 135 | 206 | 235 | skyblue |
-+-----+-----+-----+----------------------+
-| 135 | 206 | 250 | lightskyblue |
-+-----+-----+-----+----------------------+
-| 119 | 136 | 153 | lightslategray |
-+-----+-----+-----+----------------------+
-| 119 | 136 | 153 | lightslategrey |
-+-----+-----+-----+----------------------+
-| 112 | 128 | 144 | slategray |
-+-----+-----+-----+----------------------+
-| 112 | 128 | 144 | slategrey |
-+-----+-----+-----+----------------------+
-| 176 | 196 | 222 | lightsteelblue |
-+-----+-----+-----+----------------------+
-| 173 | 216 | 230 | lightblue |
-+-----+-----+-----+----------------------+
-| 224 | 255 | 255 | lightcyan |
-+-----+-----+-----+----------------------+
-| 176 | 224 | 230 | powderblue |
-+-----+-----+-----+----------------------+
-| 175 | 238 | 238 | paleturquoise |
-+-----+-----+-----+----------------------+
-| 102 | 205 | 170 | mediumaquamarine |
-+-----+-----+-----+----------------------+
-| 127 | 255 | 212 | aquamarine |
-+-----+-----+-----+----------------------+
-| 144 | 238 | 144 | lightgreen |
-+-----+-----+-----+----------------------+
-| 143 | 188 | 143 | darkseagreen |
-+-----+-----+-----+----------------------+
-| 152 | 251 | 152 | palegreen |
-+-----+-----+-----+----------------------+
-| 124 | 252 | 0 | lawngreen |
-+-----+-----+-----+----------------------+
-| 127 | 255 | 0 | chartreuse |
-+-----+-----+-----+----------------------+
-| 173 | 255 | 47 | greenyellow |
-+-----+-----+-----+----------------------+
-| 154 | 205 | 50 | yellowgreen |
-+-----+-----+-----+----------------------+
-| 107 | 142 | 35 | olivedrab |
-+-----+-----+-----+----------------------+
-| 189 | 183 | 107 | darkkhaki |
-+-----+-----+-----+----------------------+
-| 240 | 230 | 140 | khaki |
-+-----+-----+-----+----------------------+
-| 238 | 232 | 170 | palegoldenrod |
-+-----+-----+-----+----------------------+
-| 238 | 221 | 130 | lightgoldenrod |
-+-----+-----+-----+----------------------+
-| 255 | 255 | 224 | lightyellow |
-+-----+-----+-----+----------------------+
-| 250 | 250 | 210 | lightgoldenrodyellow |
-+-----+-----+-----+----------------------+
-| 255 | 255 | 0 | yellow |
-+-----+-----+-----+----------------------+
-| 128 | 128 | 0 | darkyellow |
-+-----+-----+-----+----------------------+
-| 255 | 215 | 0 | gold |
-+-----+-----+-----+----------------------+
-| 218 | 165 | 32 | goldenrod |
-+-----+-----+-----+----------------------+
-| 184 | 134 | 11 | darkgoldenrod |
-+-----+-----+-----+----------------------+
-| 188 | 143 | 143 | rosybrown |
-+-----+-----+-----+----------------------+
-| 205 | 92 | 92 | indianred |
-+-----+-----+-----+----------------------+
-| 139 | 69 | 19 | saddlebrown |
-+-----+-----+-----+----------------------+
-| 160 | 82 | 45 | sienna |
-+-----+-----+-----+----------------------+
-| 205 | 133 | 63 | peru |
-+-----+-----+-----+----------------------+
-| 222 | 184 | 135 | burlywood |
-+-----+-----+-----+----------------------+
-| 245 | 245 | 220 | beige |
-+-----+-----+-----+----------------------+
-| 245 | 222 | 179 | wheat |
-+-----+-----+-----+----------------------+
-| 244 | 164 | 96 | sandybrown |
-+-----+-----+-----+----------------------+
-| 210 | 180 | 140 | tan |
-+-----+-----+-----+----------------------+
-| 210 | 105 | 30 | chocolate |
-+-----+-----+-----+----------------------+
-| 178 | 34 | 34 | firebrick |
-+-----+-----+-----+----------------------+
-| 235 | 190 | 85 | lightbrown |
-+-----+-----+-----+----------------------+
-| 165 | 42 | 42 | brown |
-+-----+-----+-----+----------------------+
-| 120 | 60 | 30 | darkbrown |
-+-----+-----+-----+----------------------+
-| 233 | 150 | 122 | darksalmon |
-+-----+-----+-----+----------------------+
-| 250 | 128 | 114 | salmon |
-+-----+-----+-----+----------------------+
-| 255 | 160 | 122 | lightsalmon |
-+-----+-----+-----+----------------------+
-| 255 | 192 | 128 | lightorange |
-+-----+-----+-----+----------------------+
-| 255 | 165 | 0 | orange |
-+-----+-----+-----+----------------------+
-| 255 | 140 | 0 | darkorange |
-+-----+-----+-----+----------------------+
-| 255 | 127 | 80 | coral |
-+-----+-----+-----+----------------------+
-| 240 | 128 | 128 | lightcoral |
-+-----+-----+-----+----------------------+
-| 255 | 99 | 71 | tomato |
-+-----+-----+-----+----------------------+
-| 255 | 69 | 0 | orangered |
-+-----+-----+-----+----------------------+
-| 255 | 0 | 0 | red |
-+-----+-----+-----+----------------------+
-| 255 | 128 | 128 | lightred |
-+-----+-----+-----+----------------------+
-| 139 | 0 | 0 | darkred |
-+-----+-----+-----+----------------------+
-| 255 | 20 | 147 | deeppink |
-+-----+-----+-----+----------------------+
-| 255 | 105 | 180 | hotpink |
-+-----+-----+-----+----------------------+
-| 255 | 192 | 203 | pink |
-+-----+-----+-----+----------------------+
-| 255 | 182 | 193 | lightpink |
-+-----+-----+-----+----------------------+
-| 219 | 112 | 147 | palevioletred |
-+-----+-----+-----+----------------------+
-| 176 | 48 | 96 | maroon |
-+-----+-----+-----+----------------------+
-| 199 | 21 | 133 | mediumvioletred |
-+-----+-----+-----+----------------------+
-| 208 | 32 | 144 | violetred |
-+-----+-----+-----+----------------------+
-| 139 | 0 | 139 | darkmagenta |
-+-----+-----+-----+----------------------+
-| 255 | 0 | 255 | magenta |
-+-----+-----+-----+----------------------+
-| 255 | 128 | 255 | lightmagenta |
-+-----+-----+-----+----------------------+
-| 238 | 130 | 238 | violet |
-+-----+-----+-----+----------------------+
-| 218 | 112 | 214 | orchid |
-+-----+-----+-----+----------------------+
-| 221 | 160 | 221 | plum |
-+-----+-----+-----+----------------------+
-| 186 | 85 | 211 | mediumorchid |
-+-----+-----+-----+----------------------+
-| 153 | 50 | 204 | darkorchid |
-+-----+-----+-----+----------------------+
-| 148 | 0 | 211 | darkviolet |
-+-----+-----+-----+----------------------+
-| 138 | 43 | 226 | blueviolet |
-+-----+-----+-----+----------------------+
-| 160 | 32 | 240 | purple |
-+-----+-----+-----+----------------------+
-| 147 | 112 | 219 | mediumpurple |
-+-----+-----+-----+----------------------+
-| 216 | 191 | 216 | thistle |
-+-----+-----+-----+----------------------+
-| 105 | 105 | 105 | dimgray |
-+-----+-----+-----+----------------------+
-| 105 | 105 | 105 | dimgrey |
-+-----+-----+-----+----------------------+
-| 169 | 169 | 169 | darkgray |
-+-----+-----+-----+----------------------+
-| 169 | 169 | 169 | darkgrey |
-+-----+-----+-----+----------------------+
-| 190 | 190 | 190 | gray |
-+-----+-----+-----+----------------------+
-| 190 | 190 | 190 | grey |
-+-----+-----+-----+----------------------+
-| 211 | 211 | 211 | lightgrey |
-+-----+-----+-----+----------------------+
-| 211 | 211 | 211 | lightgray |
-+-----+-----+-----+----------------------+
-| 220 | 220 | 220 | gainsboro |
-+-----+-----+-----+----------------------+
-| 245 | 245 | 245 | whitesmoke |
-+-----+-----+-----+----------------------+
-| 255 | 255 | 255 | white |
-+-----+-----+-----+----------------------+
-| 255 | 250 | 250 | snow1 |
-+-----+-----+-----+----------------------+
-| 238 | 233 | 233 | snow2 |
-+-----+-----+-----+----------------------+
-| 205 | 201 | 201 | snow3 |
-+-----+-----+-----+----------------------+
-| 139 | 137 | 137 | snow4 |
-+-----+-----+-----+----------------------+
-| 255 | 245 | 238 | seashell1 |
-+-----+-----+-----+----------------------+
-| 238 | 229 | 222 | seashell2 |
-+-----+-----+-----+----------------------+
-| 205 | 197 | 191 | seashell3 |
-+-----+-----+-----+----------------------+
-| 139 | 134 | 130 | seashell4 |
-+-----+-----+-----+----------------------+
-| 255 | 239 | 219 | antiquewhite1 |
-+-----+-----+-----+----------------------+
-| 238 | 223 | 204 | antiquewhite2 |
-+-----+-----+-----+----------------------+
-| 205 | 192 | 176 | antiquewhite3 |
-+-----+-----+-----+----------------------+
-| 139 | 131 | 120 | antiquewhite4 |
-+-----+-----+-----+----------------------+
-| 255 | 228 | 196 | bisque1 |
-+-----+-----+-----+----------------------+
-| 238 | 213 | 183 | bisque2 |
-+-----+-----+-----+----------------------+
-| 205 | 183 | 158 | bisque3 |
-+-----+-----+-----+----------------------+
-| 139 | 125 | 107 | bisque4 |
-+-----+-----+-----+----------------------+
-| 255 | 218 | 185 | peachpuff1 |
-+-----+-----+-----+----------------------+
-| 238 | 203 | 173 | peachpuff2 |
-+-----+-----+-----+----------------------+
-| 205 | 175 | 149 | peachpuff3 |
-+-----+-----+-----+----------------------+
-| 139 | 119 | 101 | peachpuff4 |
-+-----+-----+-----+----------------------+
-| 255 | 222 | 173 | navajowhite1 |
-+-----+-----+-----+----------------------+
-| 238 | 207 | 161 | navajowhite2 |
-+-----+-----+-----+----------------------+
-| 205 | 179 | 139 | navajowhite3 |
-+-----+-----+-----+----------------------+
-| 139 | 121 | 94 | navajowhite4 |
-+-----+-----+-----+----------------------+
-| 255 | 250 | 205 | lemonchiffon1 |
-+-----+-----+-----+----------------------+
-| 238 | 233 | 191 | lemonchiffon2 |
-+-----+-----+-----+----------------------+
-| 205 | 201 | 165 | lemonchiffon3 |
-+-----+-----+-----+----------------------+
-| 139 | 137 | 112 | lemonchiffon4 |
-+-----+-----+-----+----------------------+
-| 255 | 248 | 220 | cornsilk1 |
-+-----+-----+-----+----------------------+
-| 238 | 232 | 205 | cornsilk2 |
-+-----+-----+-----+----------------------+
-| 205 | 200 | 177 | cornsilk3 |
-+-----+-----+-----+----------------------+
-| 139 | 136 | 120 | cornsilk4 |
-+-----+-----+-----+----------------------+
-| 255 | 255 | 240 | ivory1 |
-+-----+-----+-----+----------------------+
-| 238 | 238 | 224 | ivory2 |
-+-----+-----+-----+----------------------+
-| 205 | 205 | 193 | ivory3 |
-+-----+-----+-----+----------------------+
-| 139 | 139 | 131 | ivory4 |
-+-----+-----+-----+----------------------+
-| 240 | 255 | 240 | honeydew1 |
-+-----+-----+-----+----------------------+
-| 224 | 238 | 224 | honeydew2 |
-+-----+-----+-----+----------------------+
-| 193 | 205 | 193 | honeydew3 |
-+-----+-----+-----+----------------------+
-| 131 | 139 | 131 | honeydew4 |
-+-----+-----+-----+----------------------+
-| 255 | 240 | 245 | lavenderblush1 |
-+-----+-----+-----+----------------------+
-| 238 | 224 | 229 | lavenderblush2 |
-+-----+-----+-----+----------------------+
-| 205 | 193 | 197 | lavenderblush3 |
-+-----+-----+-----+----------------------+
-| 139 | 131 | 134 | lavenderblush4 |
-+-----+-----+-----+----------------------+
-| 255 | 228 | 225 | mistyrose1 |
-+-----+-----+-----+----------------------+
-| 238 | 213 | 210 | mistyrose2 |
-+-----+-----+-----+----------------------+
-| 205 | 183 | 181 | mistyrose3 |
-+-----+-----+-----+----------------------+
-| 139 | 125 | 123 | mistyrose4 |
-+-----+-----+-----+----------------------+
-| 240 | 255 | 255 | azure1 |
-+-----+-----+-----+----------------------+
-| 224 | 238 | 238 | azure2 |
-+-----+-----+-----+----------------------+
-| 193 | 205 | 205 | azure3 |
-+-----+-----+-----+----------------------+
-| 131 | 139 | 139 | azure4 |
-+-----+-----+-----+----------------------+
-| 131 | 111 | 255 | slateblue1 |
-+-----+-----+-----+----------------------+
-| 122 | 103 | 238 | slateblue2 |
-+-----+-----+-----+----------------------+
-| 105 | 89 | 205 | slateblue3 |
-+-----+-----+-----+----------------------+
-| 135 | 206 | 255 | skyblue1 |
-+-----+-----+-----+----------------------+
-| 126 | 192 | 238 | skyblue2 |
-+-----+-----+-----+----------------------+
-| 108 | 166 | 205 | skyblue3 |
-+-----+-----+-----+----------------------+
-| 176 | 226 | 255 | lightskyblue1 |
-+-----+-----+-----+----------------------+
-| 164 | 211 | 238 | lightskyblue2 |
-+-----+-----+-----+----------------------+
-| 141 | 182 | 205 | lightskyblue3 |
-+-----+-----+-----+----------------------+
-| 198 | 226 | 255 | slategray1 |
-+-----+-----+-----+----------------------+
-| 185 | 211 | 238 | slategray2 |
-+-----+-----+-----+----------------------+
-| 159 | 182 | 205 | slategray3 |
-+-----+-----+-----+----------------------+
-| 108 | 123 | 139 | slategray4 |
-+-----+-----+-----+----------------------+
-| 202 | 225 | 255 | lightsteelblue1 |
-+-----+-----+-----+----------------------+
-| 188 | 210 | 238 | lightsteelblue2 |
-+-----+-----+-----+----------------------+
-| 162 | 181 | 205 | lightsteelblue3 |
-+-----+-----+-----+----------------------+
-| 110 | 123 | 139 | lightsteelblue4 |
-+-----+-----+-----+----------------------+
-| 191 | 239 | 255 | lightblue1 |
-+-----+-----+-----+----------------------+
-| 178 | 223 | 238 | lightblue2 |
-+-----+-----+-----+----------------------+
-| 154 | 192 | 205 | lightblue3 |
-+-----+-----+-----+----------------------+
-| 104 | 131 | 139 | lightblue4 |
-+-----+-----+-----+----------------------+
-| 224 | 255 | 255 | lightcyan1 |
-+-----+-----+-----+----------------------+
-| 209 | 238 | 238 | lightcyan2 |
-+-----+-----+-----+----------------------+
-| 180 | 205 | 205 | lightcyan3 |
-+-----+-----+-----+----------------------+
-| 122 | 139 | 139 | lightcyan4 |
-+-----+-----+-----+----------------------+
-| 187 | 255 | 255 | paleturquoise1 |
-+-----+-----+-----+----------------------+
-| 174 | 238 | 238 | paleturquoise2 |
-+-----+-----+-----+----------------------+
-| 150 | 205 | 205 | paleturquoise3 |
-+-----+-----+-----+----------------------+
-| 102 | 139 | 139 | paleturquoise4 |
-+-----+-----+-----+----------------------+
-| 152 | 245 | 255 | cadetblue1 |
-+-----+-----+-----+----------------------+
-| 142 | 229 | 238 | cadetblue2 |
-+-----+-----+-----+----------------------+
-| 122 | 197 | 205 | cadetblue3 |
-+-----+-----+-----+----------------------+
-| 151 | 255 | 255 | darkslategray1 |
-+-----+-----+-----+----------------------+
-| 141 | 238 | 238 | darkslategray2 |
-+-----+-----+-----+----------------------+
-| 121 | 205 | 205 | darkslategray3 |
-+-----+-----+-----+----------------------+
-| 127 | 255 | 212 | aquamarine1 |
-+-----+-----+-----+----------------------+
-| 118 | 238 | 198 | aquamarine2 |
-+-----+-----+-----+----------------------+
-| 102 | 205 | 170 | aquamarine3 |
-+-----+-----+-----+----------------------+
-| 193 | 255 | 193 | darkseagreen1 |
-+-----+-----+-----+----------------------+
-| 180 | 238 | 180 | darkseagreen2 |
-+-----+-----+-----+----------------------+
-| 155 | 205 | 155 | darkseagreen3 |
-+-----+-----+-----+----------------------+
-| 105 | 139 | 105 | darkseagreen4 |
-+-----+-----+-----+----------------------+
-| 154 | 255 | 154 | palegreen1 |
-+-----+-----+-----+----------------------+
-| 144 | 238 | 144 | palegreen2 |
-+-----+-----+-----+----------------------+
-| 124 | 205 | 124 | palegreen3 |
-+-----+-----+-----+----------------------+
-| 127 | 255 | 0 | chartreuse1 |
-+-----+-----+-----+----------------------+
-| 118 | 238 | 0 | chartreuse2 |
-+-----+-----+-----+----------------------+
-| 102 | 205 | 0 | chartreuse3 |
-+-----+-----+-----+----------------------+
-| 192 | 255 | 62 | olivedrab1 |
-+-----+-----+-----+----------------------+
-| 179 | 238 | 58 | olivedrab2 |
-+-----+-----+-----+----------------------+
-| 154 | 205 | 50 | olivedrab3 |
-+-----+-----+-----+----------------------+
-| 105 | 139 | 34 | olivedrab4 |
-+-----+-----+-----+----------------------+
-| 202 | 255 | 112 | darkolivegreen1 |
-+-----+-----+-----+----------------------+
-| 188 | 238 | 104 | darkolivegreen2 |
-+-----+-----+-----+----------------------+
-| 162 | 205 | 90 | darkolivegreen3 |
-+-----+-----+-----+----------------------+
-| 110 | 139 | 61 | darkolivegreen4 |
-+-----+-----+-----+----------------------+
-| 255 | 246 | 143 | khaki1 |
-+-----+-----+-----+----------------------+
-| 238 | 230 | 133 | khaki2 |
-+-----+-----+-----+----------------------+
-| 205 | 198 | 115 | khaki3 |
-+-----+-----+-----+----------------------+
-| 139 | 134 | 78 | khaki4 |
-+-----+-----+-----+----------------------+
-| 255 | 236 | 139 | lightgoldenrod1 |
-+-----+-----+-----+----------------------+
-| 238 | 220 | 130 | lightgoldenrod2 |
-+-----+-----+-----+----------------------+
-| 205 | 190 | 112 | lightgoldenrod3 |
-+-----+-----+-----+----------------------+
-| 139 | 129 | 76 | lightgoldenrod4 |
-+-----+-----+-----+----------------------+
-| 255 | 255 | 224 | lightyellow1 |
-+-----+-----+-----+----------------------+
-| 238 | 238 | 209 | lightyellow2 |
-+-----+-----+-----+----------------------+
-| 205 | 205 | 180 | lightyellow3 |
-+-----+-----+-----+----------------------+
-| 139 | 139 | 122 | lightyellow4 |
-+-----+-----+-----+----------------------+
-| 255 | 255 | 0 | yellow1 |
-+-----+-----+-----+----------------------+
-| 238 | 238 | 0 | yellow2 |
-+-----+-----+-----+----------------------+
-| 205 | 205 | 0 | yellow3 |
-+-----+-----+-----+----------------------+
-| 139 | 139 | 0 | yellow4 |
-+-----+-----+-----+----------------------+
-| 255 | 215 | 0 | gold1 |
-+-----+-----+-----+----------------------+
-| 238 | 201 | 0 | gold2 |
-+-----+-----+-----+----------------------+
-| 205 | 173 | 0 | gold3 |
-+-----+-----+-----+----------------------+
-| 139 | 117 | 0 | gold4 |
-+-----+-----+-----+----------------------+
-| 255 | 193 | 37 | goldenrod1 |
-+-----+-----+-----+----------------------+
-| 238 | 180 | 34 | goldenrod2 |
-+-----+-----+-----+----------------------+
-| 205 | 155 | 29 | goldenrod3 |
-+-----+-----+-----+----------------------+
-| 139 | 105 | 20 | goldenrod4 |
-+-----+-----+-----+----------------------+
-| 255 | 185 | 15 | darkgoldenrod1 |
-+-----+-----+-----+----------------------+
-| 238 | 173 | 14 | darkgoldenrod2 |
-+-----+-----+-----+----------------------+
-| 205 | 149 | 12 | darkgoldenrod3 |
-+-----+-----+-----+----------------------+
-| 139 | 101 | 8 | darkgoldenrod4 |
-+-----+-----+-----+----------------------+
-| 255 | 193 | 193 | rosybrown1 |
-+-----+-----+-----+----------------------+
-| 238 | 180 | 180 | rosybrown2 |
-+-----+-----+-----+----------------------+
-| 205 | 155 | 155 | rosybrown3 |
-+-----+-----+-----+----------------------+
-| 139 | 105 | 105 | rosybrown4 |
-+-----+-----+-----+----------------------+
-| 255 | 106 | 106 | indianred1 |
-+-----+-----+-----+----------------------+
-| 238 | 99 | 99 | indianred2 |
-+-----+-----+-----+----------------------+
-| 205 | 85 | 85 | indianred3 |
-+-----+-----+-----+----------------------+
-| 139 | 58 | 58 | indianred4 |
-+-----+-----+-----+----------------------+
-| 255 | 130 | 71 | sienna1 |
-+-----+-----+-----+----------------------+
-| 238 | 121 | 66 | sienna2 |
-+-----+-----+-----+----------------------+
-| 205 | 104 | 57 | sienna3 |
-+-----+-----+-----+----------------------+
-| 139 | 71 | 38 | sienna4 |
-+-----+-----+-----+----------------------+
-| 255 | 211 | 155 | burlywood1 |
-+-----+-----+-----+----------------------+
-| 238 | 197 | 145 | burlywood2 |
-+-----+-----+-----+----------------------+
-| 205 | 170 | 125 | burlywood3 |
-+-----+-----+-----+----------------------+
-| 139 | 115 | 85 | burlywood4 |
-+-----+-----+-----+----------------------+
-| 255 | 231 | 186 | wheat1 |
-+-----+-----+-----+----------------------+
-| 238 | 216 | 174 | wheat2 |
-+-----+-----+-----+----------------------+
-| 205 | 186 | 150 | wheat3 |
-+-----+-----+-----+----------------------+
-| 139 | 126 | 102 | wheat4 |
-+-----+-----+-----+----------------------+
-| 255 | 165 | 79 | tan1 |
-+-----+-----+-----+----------------------+
-| 238 | 154 | 73 | tan2 |
-+-----+-----+-----+----------------------+
-| 205 | 133 | 63 | tan3 |
-+-----+-----+-----+----------------------+
-| 139 | 90 | 43 | tan4 |
-+-----+-----+-----+----------------------+
-| 255 | 127 | 36 | chocolate1 |
-+-----+-----+-----+----------------------+
-| 238 | 118 | 33 | chocolate2 |
-+-----+-----+-----+----------------------+
-| 205 | 102 | 29 | chocolate3 |
-+-----+-----+-----+----------------------+
-| 139 | 69 | 19 | chocolate4 |
-+-----+-----+-----+----------------------+
-| 255 | 48 | 48 | firebrick1 |
-+-----+-----+-----+----------------------+
-| 238 | 44 | 44 | firebrick2 |
-+-----+-----+-----+----------------------+
-| 205 | 38 | 38 | firebrick3 |
-+-----+-----+-----+----------------------+
-| 139 | 26 | 26 | firebrick4 |
-+-----+-----+-----+----------------------+
-| 255 | 64 | 64 | brown1 |
-+-----+-----+-----+----------------------+
-| 238 | 59 | 59 | brown2 |
-+-----+-----+-----+----------------------+
-| 205 | 51 | 51 | brown3 |
-+-----+-----+-----+----------------------+
-| 139 | 35 | 35 | brown4 |
-+-----+-----+-----+----------------------+
-| 255 | 140 | 105 | salmon1 |
-+-----+-----+-----+----------------------+
-| 238 | 130 | 98 | salmon2 |
-+-----+-----+-----+----------------------+
-| 205 | 112 | 84 | salmon3 |
-+-----+-----+-----+----------------------+
-| 139 | 76 | 57 | salmon4 |
-+-----+-----+-----+----------------------+
-| 255 | 160 | 122 | lightsalmon1 |
-+-----+-----+-----+----------------------+
-| 238 | 149 | 114 | lightsalmon2 |
-+-----+-----+-----+----------------------+
-| 205 | 129 | 98 | lightsalmon3 |
-+-----+-----+-----+----------------------+
-| 139 | 87 | 66 | lightsalmon4 |
-+-----+-----+-----+----------------------+
-| 255 | 165 | 0 | orange1 |
-+-----+-----+-----+----------------------+
-| 238 | 154 | 0 | orange2 |
-+-----+-----+-----+----------------------+
-| 205 | 133 | 0 | orange3 |
-+-----+-----+-----+----------------------+
-| 139 | 90 | 0 | orange4 |
-+-----+-----+-----+----------------------+
-| 255 | 127 | 0 | darkorange1 |
-+-----+-----+-----+----------------------+
-| 238 | 118 | 0 | darkorange2 |
-+-----+-----+-----+----------------------+
-| 205 | 102 | 0 | darkorange3 |
-+-----+-----+-----+----------------------+
-| 139 | 69 | 0 | darkorange4 |
-+-----+-----+-----+----------------------+
-| 255 | 114 | 86 | coral1 |
-+-----+-----+-----+----------------------+
-| 238 | 106 | 80 | coral2 |
-+-----+-----+-----+----------------------+
-| 205 | 91 | 69 | coral3 |
-+-----+-----+-----+----------------------+
-| 139 | 62 | 47 | coral4 |
-+-----+-----+-----+----------------------+
-| 255 | 99 | 71 | tomato1 |
-+-----+-----+-----+----------------------+
-| 238 | 92 | 66 | tomato2 |
-+-----+-----+-----+----------------------+
-| 205 | 79 | 57 | tomato3 |
-+-----+-----+-----+----------------------+
-| 139 | 54 | 38 | tomato4 |
-+-----+-----+-----+----------------------+
-| 255 | 69 | 0 | orangered1 |
-+-----+-----+-----+----------------------+
-| 238 | 64 | 0 | orangered2 |
-+-----+-----+-----+----------------------+
-| 205 | 55 | 0 | orangered3 |
-+-----+-----+-----+----------------------+
-| 139 | 37 | 0 | orangered4 |
-+-----+-----+-----+----------------------+
-| 255 | 0 | 0 | red1 |
-+-----+-----+-----+----------------------+
-| 238 | 0 | 0 | red2 |
-+-----+-----+-----+----------------------+
-| 205 | 0 | 0 | red3 |
-+-----+-----+-----+----------------------+
-| 139 | 0 | 0 | red4 |
-+-----+-----+-----+----------------------+
-| 255 | 20 | 147 | deeppink1 |
-+-----+-----+-----+----------------------+
-| 238 | 18 | 137 | deeppink2 |
-+-----+-----+-----+----------------------+
-| 205 | 16 | 118 | deeppink3 |
-+-----+-----+-----+----------------------+
-| 139 | 10 | 80 | deeppink4 |
-+-----+-----+-----+----------------------+
-| 255 | 110 | 180 | hotpink1 |
-+-----+-----+-----+----------------------+
-| 238 | 106 | 167 | hotpink2 |
-+-----+-----+-----+----------------------+
-| 205 | 96 | 144 | hotpink3 |
-+-----+-----+-----+----------------------+
-| 139 | 58 | 98 | hotpink4 |
-+-----+-----+-----+----------------------+
-| 255 | 181 | 197 | pink1 |
-+-----+-----+-----+----------------------+
-| 238 | 169 | 184 | pink2 |
-+-----+-----+-----+----------------------+
-| 205 | 145 | 158 | pink3 |
-+-----+-----+-----+----------------------+
-| 139 | 99 | 108 | pink4 |
-+-----+-----+-----+----------------------+
-| 255 | 174 | 185 | lightpink1 |
-+-----+-----+-----+----------------------+
-| 238 | 162 | 173 | lightpink2 |
-+-----+-----+-----+----------------------+
-| 205 | 140 | 149 | lightpink3 |
-+-----+-----+-----+----------------------+
-| 139 | 95 | 101 | lightpink4 |
-+-----+-----+-----+----------------------+
-| 255 | 130 | 171 | palevioletred1 |
-+-----+-----+-----+----------------------+
-| 238 | 121 | 159 | palevioletred2 |
-+-----+-----+-----+----------------------+
-| 205 | 104 | 137 | palevioletred3 |
-+-----+-----+-----+----------------------+
-| 139 | 71 | 93 | palevioletred4 |
-+-----+-----+-----+----------------------+
-| 255 | 52 | 179 | maroon1 |
-+-----+-----+-----+----------------------+
-| 238 | 48 | 167 | maroon2 |
-+-----+-----+-----+----------------------+
-| 205 | 41 | 144 | maroon3 |
-+-----+-----+-----+----------------------+
-| 139 | 28 | 98 | maroon4 |
-+-----+-----+-----+----------------------+
-| 255 | 62 | 150 | violetred1 |
-+-----+-----+-----+----------------------+
-| 238 | 58 | 140 | violetred2 |
-+-----+-----+-----+----------------------+
-| 205 | 50 | 120 | violetred3 |
-+-----+-----+-----+----------------------+
-| 139 | 34 | 82 | violetred4 |
-+-----+-----+-----+----------------------+
-| 255 | 0 | 255 | magenta1 |
-+-----+-----+-----+----------------------+
-| 238 | 0 | 238 | magenta2 |
-+-----+-----+-----+----------------------+
-| 205 | 0 | 205 | magenta3 |
-+-----+-----+-----+----------------------+
-| 139 | 0 | 139 | magenta4 |
-+-----+-----+-----+----------------------+
-| 255 | 131 | 250 | orchid1 |
-+-----+-----+-----+----------------------+
-| 238 | 122 | 233 | orchid2 |
-+-----+-----+-----+----------------------+
-| 205 | 105 | 201 | orchid3 |
-+-----+-----+-----+----------------------+
-| 139 | 71 | 137 | orchid4 |
-+-----+-----+-----+----------------------+
-| 255 | 187 | 255 | plum1 |
-+-----+-----+-----+----------------------+
-| 238 | 174 | 238 | plum2 |
-+-----+-----+-----+----------------------+
-| 205 | 150 | 205 | plum3 |
-+-----+-----+-----+----------------------+
-| 139 | 102 | 139 | plum4 |
-+-----+-----+-----+----------------------+
-| 224 | 102 | 255 | mediumorchid1 |
-+-----+-----+-----+----------------------+
-| 209 | 95 | 238 | mediumorchid2 |
-+-----+-----+-----+----------------------+
-| 180 | 82 | 205 | mediumorchid3 |
-+-----+-----+-----+----------------------+
-| 122 | 55 | 139 | mediumorchid4 |
-+-----+-----+-----+----------------------+
-| 191 | 62 | 255 | darkorchid1 |
-+-----+-----+-----+----------------------+
-| 178 | 58 | 238 | darkorchid2 |
-+-----+-----+-----+----------------------+
-| 154 | 50 | 205 | darkorchid3 |
-+-----+-----+-----+----------------------+
-| 104 | 34 | 139 | darkorchid4 |
-+-----+-----+-----+----------------------+
-| 155 | 48 | 255 | purple1 |
-+-----+-----+-----+----------------------+
-| 145 | 44 | 238 | purple2 |
-+-----+-----+-----+----------------------+
-| 125 | 38 | 205 | purple3 |
-+-----+-----+-----+----------------------+
-| 171 | 130 | 255 | mediumpurple1 |
-+-----+-----+-----+----------------------+
-| 159 | 121 | 238 | mediumpurple2 |
-+-----+-----+-----+----------------------+
-| 137 | 104 | 205 | mediumpurple3 |
-+-----+-----+-----+----------------------+
-| 255 | 225 | 255 | thistle1 |
-+-----+-----+-----+----------------------+
-| 238 | 210 | 238 | thistle2 |
-+-----+-----+-----+----------------------+
-| 205 | 181 | 205 | thistle3 |
-+-----+-----+-----+----------------------+
-| 139 | 123 | 139 | thistle4 |
-+-----+-----+-----+----------------------+
-| 102 | 102 | 102 | gray40 |
-+-----+-----+-----+----------------------+
-| 102 | 102 | 102 | grey40 |
-+-----+-----+-----+----------------------+
-| 105 | 105 | 105 | gray41 |
-+-----+-----+-----+----------------------+
-| 105 | 105 | 105 | grey41 |
-+-----+-----+-----+----------------------+
-| 107 | 107 | 107 | gray42 |
-+-----+-----+-----+----------------------+
-| 107 | 107 | 107 | grey42 |
-+-----+-----+-----+----------------------+
-| 110 | 110 | 110 | gray43 |
-+-----+-----+-----+----------------------+
-| 110 | 110 | 110 | grey43 |
-+-----+-----+-----+----------------------+
-| 112 | 112 | 112 | gray44 |
-+-----+-----+-----+----------------------+
-| 112 | 112 | 112 | grey44 |
-+-----+-----+-----+----------------------+
-| 115 | 115 | 115 | gray45 |
-+-----+-----+-----+----------------------+
-| 115 | 115 | 115 | grey45 |
-+-----+-----+-----+----------------------+
-| 117 | 117 | 117 | gray46 |
-+-----+-----+-----+----------------------+
-| 117 | 117 | 117 | grey46 |
-+-----+-----+-----+----------------------+
-| 120 | 120 | 120 | gray47 |
-+-----+-----+-----+----------------------+
-| 120 | 120 | 120 | grey47 |
-+-----+-----+-----+----------------------+
-| 122 | 122 | 122 | gray48 |
-+-----+-----+-----+----------------------+
-| 122 | 122 | 122 | grey48 |
-+-----+-----+-----+----------------------+
-| 125 | 125 | 125 | gray49 |
-+-----+-----+-----+----------------------+
-| 125 | 125 | 125 | grey49 |
-+-----+-----+-----+----------------------+
-| 127 | 127 | 127 | gray50 |
-+-----+-----+-----+----------------------+
-| 127 | 127 | 127 | grey50 |
-+-----+-----+-----+----------------------+
-| 130 | 130 | 130 | gray51 |
-+-----+-----+-----+----------------------+
-| 130 | 130 | 130 | grey51 |
-+-----+-----+-----+----------------------+
-| 133 | 133 | 133 | gray52 |
-+-----+-----+-----+----------------------+
-| 133 | 133 | 133 | grey52 |
-+-----+-----+-----+----------------------+
-| 135 | 135 | 135 | gray53 |
-+-----+-----+-----+----------------------+
-| 135 | 135 | 135 | grey53 |
-+-----+-----+-----+----------------------+
-| 138 | 138 | 138 | gray54 |
-+-----+-----+-----+----------------------+
-| 138 | 138 | 138 | grey54 |
-+-----+-----+-----+----------------------+
-| 140 | 140 | 140 | gray55 |
-+-----+-----+-----+----------------------+
-| 140 | 140 | 140 | grey55 |
-+-----+-----+-----+----------------------+
-| 143 | 143 | 143 | gray56 |
-+-----+-----+-----+----------------------+
-| 143 | 143 | 143 | grey56 |
-+-----+-----+-----+----------------------+
-| 145 | 145 | 145 | gray57 |
-+-----+-----+-----+----------------------+
-| 145 | 145 | 145 | grey57 |
-+-----+-----+-----+----------------------+
-| 148 | 148 | 148 | gray58 |
-+-----+-----+-----+----------------------+
-| 148 | 148 | 148 | grey58 |
-+-----+-----+-----+----------------------+
-| 150 | 150 | 150 | gray59 |
-+-----+-----+-----+----------------------+
-| 150 | 150 | 150 | grey59 |
-+-----+-----+-----+----------------------+
-| 153 | 153 | 153 | gray60 |
-+-----+-----+-----+----------------------+
-| 153 | 153 | 153 | grey60 |
-+-----+-----+-----+----------------------+
-| 156 | 156 | 156 | gray61 |
-+-----+-----+-----+----------------------+
-| 156 | 156 | 156 | grey61 |
-+-----+-----+-----+----------------------+
-| 158 | 158 | 158 | gray62 |
-+-----+-----+-----+----------------------+
-| 158 | 158 | 158 | grey62 |
-+-----+-----+-----+----------------------+
-| 161 | 161 | 161 | gray63 |
-+-----+-----+-----+----------------------+
-| 161 | 161 | 161 | grey63 |
-+-----+-----+-----+----------------------+
-| 163 | 163 | 163 | gray64 |
-+-----+-----+-----+----------------------+
-| 163 | 163 | 163 | grey64 |
-+-----+-----+-----+----------------------+
-| 166 | 166 | 166 | gray65 |
-+-----+-----+-----+----------------------+
-| 166 | 166 | 166 | grey65 |
-+-----+-----+-----+----------------------+
-| 168 | 168 | 168 | gray66 |
-+-----+-----+-----+----------------------+
-| 168 | 168 | 168 | grey66 |
-+-----+-----+-----+----------------------+
-| 171 | 171 | 171 | gray67 |
-+-----+-----+-----+----------------------+
-| 171 | 171 | 171 | grey67 |
-+-----+-----+-----+----------------------+
-| 173 | 173 | 173 | gray68 |
-+-----+-----+-----+----------------------+
-| 173 | 173 | 173 | grey68 |
-+-----+-----+-----+----------------------+
-| 176 | 176 | 176 | gray69 |
-+-----+-----+-----+----------------------+
-| 176 | 176 | 176 | grey69 |
-+-----+-----+-----+----------------------+
-| 179 | 179 | 179 | gray70 |
-+-----+-----+-----+----------------------+
-| 179 | 179 | 179 | grey70 |
-+-----+-----+-----+----------------------+
-| 181 | 181 | 181 | gray71 |
-+-----+-----+-----+----------------------+
-| 181 | 181 | 181 | grey71 |
-+-----+-----+-----+----------------------+
-| 184 | 184 | 184 | gray72 |
-+-----+-----+-----+----------------------+
-| 184 | 184 | 184 | grey72 |
-+-----+-----+-----+----------------------+
-| 186 | 186 | 186 | gray73 |
-+-----+-----+-----+----------------------+
-| 186 | 186 | 186 | grey73 |
-+-----+-----+-----+----------------------+
-| 189 | 189 | 189 | gray74 |
-+-----+-----+-----+----------------------+
-| 189 | 189 | 189 | grey74 |
-+-----+-----+-----+----------------------+
-| 191 | 191 | 191 | gray75 |
-+-----+-----+-----+----------------------+
-| 191 | 191 | 191 | grey75 |
-+-----+-----+-----+----------------------+
-| 194 | 194 | 194 | gray76 |
-+-----+-----+-----+----------------------+
-| 194 | 194 | 194 | grey76 |
-+-----+-----+-----+----------------------+
-| 196 | 196 | 196 | gray77 |
-+-----+-----+-----+----------------------+
-| 196 | 196 | 196 | grey77 |
-+-----+-----+-----+----------------------+
-| 199 | 199 | 199 | gray78 |
-+-----+-----+-----+----------------------+
-| 199 | 199 | 199 | grey78 |
-+-----+-----+-----+----------------------+
-| 201 | 201 | 201 | gray79 |
-+-----+-----+-----+----------------------+
-| 201 | 201 | 201 | grey79 |
-+-----+-----+-----+----------------------+
-| 204 | 204 | 204 | gray80 |
-+-----+-----+-----+----------------------+
-| 204 | 204 | 204 | grey80 |
-+-----+-----+-----+----------------------+
-| 207 | 207 | 207 | gray81 |
-+-----+-----+-----+----------------------+
-| 207 | 207 | 207 | grey81 |
-+-----+-----+-----+----------------------+
-| 209 | 209 | 209 | gray82 |
-+-----+-----+-----+----------------------+
-| 209 | 209 | 209 | grey82 |
-+-----+-----+-----+----------------------+
-| 212 | 212 | 212 | gray83 |
-+-----+-----+-----+----------------------+
-| 212 | 212 | 212 | grey83 |
-+-----+-----+-----+----------------------+
-| 214 | 214 | 214 | gray84 |
-+-----+-----+-----+----------------------+
-| 214 | 214 | 214 | grey84 |
-+-----+-----+-----+----------------------+
-| 217 | 217 | 217 | gray85 |
-+-----+-----+-----+----------------------+
-| 217 | 217 | 217 | grey85 |
-+-----+-----+-----+----------------------+
-| 219 | 219 | 219 | gray86 |
-+-----+-----+-----+----------------------+
-| 219 | 219 | 219 | grey86 |
-+-----+-----+-----+----------------------+
-| 222 | 222 | 222 | gray87 |
-+-----+-----+-----+----------------------+
-| 222 | 222 | 222 | grey87 |
-+-----+-----+-----+----------------------+
-| 224 | 224 | 224 | gray88 |
-+-----+-----+-----+----------------------+
-| 224 | 224 | 224 | grey88 |
-+-----+-----+-----+----------------------+
-| 227 | 227 | 227 | gray89 |
-+-----+-----+-----+----------------------+
-| 227 | 227 | 227 | grey89 |
-+-----+-----+-----+----------------------+
-| 229 | 229 | 229 | gray90 |
-+-----+-----+-----+----------------------+
-| 229 | 229 | 229 | grey90 |
-+-----+-----+-----+----------------------+
-| 232 | 232 | 232 | gray91 |
-+-----+-----+-----+----------------------+
-| 232 | 232 | 232 | grey91 |
-+-----+-----+-----+----------------------+
-| 235 | 235 | 235 | gray92 |
-+-----+-----+-----+----------------------+
-| 235 | 235 | 235 | grey92 |
-+-----+-----+-----+----------------------+
-| 237 | 237 | 237 | gray93 |
-+-----+-----+-----+----------------------+
-| 237 | 237 | 237 | grey93 |
-+-----+-----+-----+----------------------+
-| 240 | 240 | 240 | gray94 |
-+-----+-----+-----+----------------------+
-| 240 | 240 | 240 | grey94 |
-+-----+-----+-----+----------------------+
-| 242 | 242 | 242 | gray95 |
-+-----+-----+-----+----------------------+
-| 242 | 242 | 242 | grey95 |
-+-----+-----+-----+----------------------+
-| 245 | 245 | 245 | gray96 |
-+-----+-----+-----+----------------------+
-| 245 | 245 | 245 | grey96 |
-+-----+-----+-----+----------------------+
-| 247 | 247 | 247 | gray97 |
-+-----+-----+-----+----------------------+
-| 247 | 247 | 247 | grey97 |
-+-----+-----+-----+----------------------+
-| 250 | 250 | 250 | gray98 |
-+-----+-----+-----+----------------------+
-| 250 | 250 | 250 | grey98 |
-+-----+-----+-----+----------------------+
-| 252 | 252 | 252 | gray99 |
-+-----+-----+-----+----------------------+
-| 252 | 252 | 252 | grey99 |
-+-----+-----+-----+----------------------+
-| 255 | 255 | 255 | gray100 |
-+-----+-----+-----+----------------------+
-| 255 | 255 | 255 | grey100 |
-+-----+-----+-----+----------------------+
-
-Further Information
--------------------
-
-For more information on the use of color, read Appendix I of the **GMT
-TECHNICAL REFERENCE AND COOKBOOK**.
-
-See Also
---------
-
-:doc:`gmt.conf` , :doc:`gmtlogo` ,
-:doc:`grdcontour` ,
-:doc:`grdvector` , :doc:`grdview`
-:doc:`psbasemap` ,
-:doc:`pscoast` , :doc:`pscontour`,
-:doc:`pshistogram` ,
-:doc:`psimage` , :doc:`pslegend` ,
-:doc:`psmask` , :doc:`psrose` ,
-:doc:`pstext` , :doc:`pswiggle` ,
-:doc:`psxy` , :doc:`psxyz`
-
diff --git a/doc_release/html/_sources/gmtconnect.txt b/doc_release/html/_sources/gmtconnect.txt
deleted file mode 100644
index d0c7269..0000000
--- a/doc_release/html/_sources/gmtconnect.txt
+++ /dev/null
@@ -1,166 +0,0 @@
-.. index:: ! gmtconnect
-
-**********
-gmtconnect
-**********
-
-.. only:: not man
-
- gmtconnect - Connect individual lines whose end points match within tolerance
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**gmtconnect** [ *table* ] [ **-C**\ [*closed*] ]
-[ **-D**\ [*template*] ] [ **-L**\ [*linkfile*] ]
-[ **-Q**\ [*template*] ] [ **-T**\ *cutoff*\ [*unit*][/\ *nn\_dist*] ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-b| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-g| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-o| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**gmtconnect** reads standard input or one or more data files, which may
-be multisegment files, and examines the coordinates of the end points of
-all line segments. If a pair of end points are identical or closer to
-each other than the specified separation tolerance then the two line
-segments are joined into a single segment. The process repeats until all
-the remaining endpoints no longer pass the tolerance test; the resulting
-segments are then written out to standard output or specified output
-file. If it is not clear what the separation tolerance should be then
-use **-L** to get a list of all separation distances and analyze them to
-determine a suitable cutoff.
-
-Required Arguments
-------------------
-
-None.
-
-Optional Arguments
-------------------
-
-.. |Add_intables| unicode:: 0x20 .. just an invisible code
-.. include:: explain_intables.rst_
-
-
-**-C**\ [*closed*]
- Write all the closed polygons to *closed* [gmtconnect_closed.txt]
- and all other segments as they are to stdout. No connection takes
- place. Use **-T**\ *cutoff* to set a minimum separation [0], and if
- *cutoff* is > 0 then we also explicitly close the polygons on output.
-
-**-D**\ [*template*]
- For multiple segment data, dump each segment to a separate output
- file [Default writes a single multiple segment file]. Append a
- format template for the individual file names; this template
- **must** contain a C format specifier that can format an integer
- argument (the segment number); this is usually %d but could be %08d
- which gives leading zeros, etc. Optionally, it may also contain the
- format %c *before* the integer; this will then be replaced by C
- (closed) or O (open) to indicate segment type. [Default is
- gmtconnect_segment_%d.txt]. Note that segment headers will be
- written in either case. For composite segments, a generic segment
- header will be written and the segment headers of individual pieces
- will be written out as comments to make it possible to identify
- where the connected pieces came from.
-
-**-L**\ [*linkfile*]
- Writes the link information to the specified file
- [gmtconnect_link.txt]. For each segment we write the original
- segment id, and for the beginning and end point of the segment we
- report the id of the closest segment, whether it is the beginning
- (B) or end (E) point that is closest, and the distance between those
- points in units determined by **-T**.
-
-**-Q**\ [*template*]
- Used with **-D** to a list file with the names of the individual
- output files. Optionally, append a filename template for the
- individual file names; this template **may** contain a C format
- specifier that can format an character (C or O for closed or open,
- respectively). [Default is gmtconnect_list.txt].
-
-**-T**\ *cutoff*\ [*unit*][/\ *nn\_dist*]
- Specifies the separation tolerance in the data coordinate units [0];
- append distance unit (see UNITS). If two lines has end-points that
- are closer than this cutoff they will be joined. Optionally, append
- /*nn_dist* which adds the requirement that a link will only be made
- if the second closest connection exceeds the *nn_dist*. The latter
- distance must be given in the same units as *cutoff*.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. |Add_-bi| replace:: [Default is 2 input columns].
-.. include:: explain_-bi.rst_
-
-.. |Add_-bo| replace:: [Default is same as input].
-.. include:: explain_-bo.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-g| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-g.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. include:: explain_-ocols.rst_
-
-.. include:: explain_colon.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_distunits.rst_
-
-.. include:: explain_precision.rst_
-
-Examples
---------
-
-To combine the digitized segment lines segment\_\*.txt (whose
-coordinates are in cm) into as few complete lines as possible, assuming
-the end points slop could be up to 0.1 mm, run
-
- ::
-
- gmt connect segment_*.txt -Tf0.1 > new_segments.txt
-
-To combine the digitized segments in the multisegment file my_lines.txt
-(whose coordinates are in lon,lat) into as few complete lines as
-possible, assuming the end points slop could be up to 150 m, and write
-the complete segments to separate files called Map_segment_0001.dat,
-Map_segment_0002.dat, etc., run
-
- ::
-
- gmt connect my_lines.txt -T150e -DMap_segment_%04d.dat
-
-Bugs
-----
-
-The line connection does not work if a line only has a single point.
-However, gmtconnect will correctly add the point to the nearest segment.
-Running gmtconnect again on the new set of lines will eventually connect
-all close lines.
-
-See Also
---------
-
-:doc:`gmt`,
-:doc:`gmt.conf`,
-:doc:`gmtsimplify`,
-:doc:`gmtspatial`,
-:doc:`mapproject`
diff --git a/doc_release/html/_sources/gmtconvert.txt b/doc_release/html/_sources/gmtconvert.txt
deleted file mode 100644
index 4872971..0000000
--- a/doc_release/html/_sources/gmtconvert.txt
+++ /dev/null
@@ -1,253 +0,0 @@
-.. index:: ! gmtconvert
-
-**********
-gmtconvert
-**********
-
-.. only:: not man
-
- gmtconvert - Convert, Paste, and/or Extract columns from data tables
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**gmtconvert** [ *table* ] [ **-A** ] [ **-D**\ [*template*] ]
-[ **-E**\ [**f**\ \|\ **l**\ \|\ **m**\ *stride*] ] [ **-L** ]
-[ **-I**\ [**tsr**\ ] ] [ **-Q**\ [**~**\ ]*selection* ]
-[ **-S**\ [**~**\ ]\ *"search string"* \|
-**-S**\ [**~**\ ]/\ *regexp*/[**i**\ ] ]
-[ **-T** ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-a| ]
-[ |SYN_OPT-b| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-g| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-o| ]
-[ |SYN_OPT-s| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**gmtconvert** reads its standard input [or input files] and writes out
-the desired information to standard output. It can do a combination of
-seven tasks: (1) convert between binary and ASCII data tables, (2) paste
-corresponding records from multiple files horizontally into a single
-file, (3) extract a subset of the available columns, (4) only extract
-segments whose header record matches a text pattern search, (5) only
-list segment headers and no data records, (6) extract first and/or last
-data record for each segment, and (7) reverse the order
-of items on output. Input (and hence output) may have multiple
-sub-headers, and ASCII tables may have regular headers as well.
-
-Required Arguments
-------------------
-
-None
-
-Optional Arguments
-------------------
-
-.. |Add_intables| unicode:: 0x20 .. just an invisible code
-.. include:: explain_intables.rst_
-
-**-A**
- The records from the input files should be pasted horizontally, not
- appended vertically [Default]. All files must have the same number
- of segments and number of rows per segment. Note for binary input,
- all the files you want to paste must have the same number of columns
- (as set with **-bi**); ascii tables can have different number of columns.
-
-**-D**\ [*template*]
- For multiple segment data, dump each segment to a separate output
- file [Default writes a multiple segment file to stdout]. Append a
- format template for the individual file names; this template
- **must** contain a C format specifier that can format an integer
- argument (the running segment number across all tables); this is
- usually %d but could be %08d which gives leading zeros, etc.
- [Default is gmtconvert_segment\_%d.{txt\|bin}, depending on
- **-bo**]. Alternatively, give a template with
- two C format specifiers and we will supply the table number and the
- segment number within the table to build the file name.
-
-**-E**\ [**f**\ \|\ **l**\ \|\ **m**\ *stride*]
- Only extract the first and last record for each segment of interest
- [Default extracts all records]. Optionally, append **f** or **l** to
- only extract the first or last record of each segment, respectively.
- Alternatively, append **m**\ *stride* to extract only one out of *stride* records.
-
-**-I**
- Invert the order of items, i.e., output the items in reverse order,
- starting with the last and ending up with the first item [Default
- keeps original order]. Append up to three items that should be
- reversed: **t** will reverse the order of tables, **s** will reverse
- the order of segments within each table, and **r** will reverse the
- order of records within each segment [Default].
-
-**-L**
- Only output a listing of all segment header records and no data
- records (requires ASCII data).
-
-**-Q**\ [**~**\ ]*selection*
- Only write segments whose number is included in *selection* and skip
- all others. Cannot be used with **-S**. The *selection* syntax is
- *range*[,*range*,...] where each *range* of items is either a single
- segment *number*, a range of segment numbers *start-stop*, or a range with
- stepped increments given via *start:step:stop*. A leading **~** will
- invert the selection and write all segments but the ones listed. Instead
- of a list of ranges, use **+f**\ *file* to supply a file list with one
- *range* per line.
-
-**-S**\ [**~**]\ *"search string"* or **-S**\ [**~**]/\ *regexp*/[**i**]
- Only output those segments whose header record contains the
- specified text string. To reverse the search, i.e., to output
- segments whose headers do *not* contain the specified pattern, use
- **-S~**. Should your pattern happen to start with ~ you need to
- escape this character with a backslash [Default output all
- segments]. Cannot be used with **-Q**. For matching segments based
- on aspatial values (via OGR/GMT format), give the search string as
- *varname*\ =\ *value* and we will compare *value* against the value
- of *varname* for each segment. Note: If the features are polygons
- then a match of a particular polygon perimeter also means that any
- associated polygon holes will also be matched. For matching segment
- headers against extended regular expressions enclose the expression
- in slashes. Append **i** for caseless matching.
- For a list of such patterns, give **+f**\ *file* with one pattern per line.
- To give a single pattern starting with +f, escape it with a backslash.
-
-**-T**
- Suppress the writing of segment headers on output.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. include:: explain_-aspatial.rst_
-
-.. |Add_-bi| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-bi.rst_
-
-.. |Add_-bo| replace:: [Default is same as input].
-.. include:: explain_-bo.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-g| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-g.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. include:: explain_-ocols.rst_
-
-.. include:: explain_-s.rst_
-
-.. include:: explain_colon.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_precision.rst_
-
-
-Examples
---------
-
-To convert the binary file test.b (single precision) with 4 columns to ASCII:
-
- ::
-
- gmt gmtconvert test.b -bi4f > test.dat
-
-To convert the multiple segment ASCII table test.d to a double precision binary file:
-
- ::
-
- gmt gmtconvert test.d -bo > test.b
-
-You have an ASCII table with 6 columns and you want to plot column 5 versus column 0. Try
-
- ::
-
- gmt gmtconvert table.d -o5,0 | psxy ...
-
-If the file instead is the binary file results.b which has 9
-single-precision values per record, we extract the last column and
-columns 4-6 and write ASCII with the command
-
- ::
-
- gmt gmtconvert results.b -o8,4-6 -bi9s | psxy ...
-
-You want to plot the 2nd column of a 2-column file left.d versus the
-first column of a file right.d:
-
- ::
-
- gmt gmtconvert left.d right.d -A -o1,2 | psxy ...
-
-To extract all segments in the file big_file.d whose headers contain
-the string "RIDGE AXIS", try
-
- ::
-
- gmt gmtconvert big_file.d -S"RIDGE AXIS" > subset.d
-
-To invert the selection of segments whose headers begin with "profile "
-followed by an integer number and any letter between "g" and "l", try
-
- ::
-
- gmt gmtconvert -S~"/^profile [0-9]+[g-l]$/"
-
-To reverse the order of segments in a file without reversing the order
-of records within each segment, try
-
- ::
-
- gmt gmtconvert lots_of_segments.txt -Is > last_segment_first.txt
-
-To extract segments 20 to 40 in steps of 2, plus segment 0 in a file, try
-
- ::
-
- gmt gmtconvert lots_of_segments.txt -Q0,20:2:40 > my_segments.txt
-
-
-To extract the attribute ELEVATION from an ogr gmt file like this
-
- ::
-
- # @VGMT1.0 @GPOINT
- ...
- # @NELEVATION|DISPX|DISPY
- # @Tdouble|double|double
- # FEATURE_DATA
- # @D4.945000|-106500.00000000|-32700.00000000
- -9.36890245902635 39.367156766570389
-
-do
-
- ::
-
- gmt gmtconvert file.gmt -a2=ELEVATION > xyz.dat
-
-or just
-
- ::
-
- gmt gmtconvert file.gmt -aELEVATION > xyz.dat
-
-See Also
---------
-
-:doc:`gmt`,
-:doc:`gmtinfo`,
-:doc:`gmtselect`
diff --git a/doc_release/html/_sources/gmtdefaults.txt b/doc_release/html/_sources/gmtdefaults.txt
deleted file mode 100644
index 5f6c486..0000000
--- a/doc_release/html/_sources/gmtdefaults.txt
+++ /dev/null
@@ -1,89 +0,0 @@
-.. index:: ! gmtdefaults
-
-***********
-gmtdefaults
-***********
-
-.. only:: not man
-
- gmtdefaults - List current GMT default parameters
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**gmtdefaults** [ **-D**\ [**u**\ \|\ **s**] ]
-
-|No-spaces|
-
-Description
------------
-
-**gmtdefaults** lists the GMT parameter defaults if the option
-**-D** is used. There are three ways to change some of the settings: (1)
-Use the command :doc:`gmtset`, (2) use any texteditor to edit the file
-:doc:`gmt.conf` in your home, ~/.gmt or current directory (if you do not
-have this file, run :doc:`gmtset` **-D** to get one with the system default
-settings), or (3) override any parameter by specifying one
-or more **-**\ **-PARAMETER**\ =\ *VALUE* statements on the commandline of any
-GMT command (**PARAMETER** and *VALUE* are any combination listed
-below). The first two options are permanent changes until explicitly
-changed back, while the last option is ephemeral and only applies to the
-single GMT command that received the override. GMT can provide
-default values in US or SI units. This choice is determined at compile time.
-
-Required Arguments
-------------------
-
-None.
-
-Optional Arguments
-------------------
-
-**-D**
- Print the system GMT defaults to standard output. Append **u**
- for US defaults or **s** for SI defaults. [**-D** alone gives the
- version selected at compile time; If **-D** is omitted, the user's
- currently active defaults are printed.]
-
-.. include:: explain_help.rst_
-
-Your currently active defaults come from the :doc:`gmt.conf` file in
-the current working directory, if present; else from the
-:doc:`gmt.conf` file in your home directory, if present; else from the
-file **~/.gmt/gmt.conf** if present; else from the system defaults
-set at the time GMT was compiled.
-
-GMT PARAMETERS
---------------
-
-Read the :doc:`gmt.conf` man page for a full list of the parameters that
-are user-definable in GMT.
-
-Examples
---------
-
-To get a copy of the GMT parameter defaults in your home directory, run
-
- ::
-
- gmt gmtdefaults -D > ~/gmt.conf
-
-You may now change the settings by editing this file using a text editor
-of your choice, or use **gmtset** to change specified parameters on the
-command line.
-
-Bugs
-----
-
-If you have typographical errors in your :doc:`gmt.conf` file(s), a warning
-message will be issued, and the GMT defaults for the affected
-parameters will be used.
-
-See Also
---------
-
-:doc:`gmt`, :doc:`gmt.conf`,
-:doc:`gmtcolors`, :doc:`gmtget`,
-:doc:`gmtset`
diff --git a/doc_release/html/_sources/gmtget.txt b/doc_release/html/_sources/gmtget.txt
deleted file mode 100644
index 7889474..0000000
--- a/doc_release/html/_sources/gmtget.txt
+++ /dev/null
@@ -1,67 +0,0 @@
-.. index:: ! gmtget
-
-******
-gmtget
-******
-
-.. only:: not man
-
- gmtget - Get individual GMT default parameters
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**gmtget** [ **-G**\ *defaultsfile* ] [ **-L** ] *PARAMETER1* [ *PARAMETER2* *PARAMETER3* ... ]
-
-|No-spaces|
-
-Description
------------
-
-**gmtget** will list the value of one or more GMT default parameters.
-
-Required Arguments
-------------------
-
-PARAMETER
- Provide one or several parameters of interest. The current value of
- those parameters will be writen to *stdout*. For a complete listing
- of available parameters and their meaning, see the :doc:`gmt.conf` man page.
-
-Optional Arguments
-------------------
-
-**-G**\ *defaultsfile*
- Name of specific :doc:`gmt.conf` file to read [Default looks first in
- current directory, then in your home directory, then in ~/.gmt and
- finally in the system defaults].
-**-L**
- Return the values of the parameters on separate lines [Default
- returns all selected parameter values on one line separated by
- spaces]
-
-Example
--------
-
-To list the value of the parameter PS_COMMENTS:
-
- ::
-
- gmt get PS_COMMENTS
-
-To get both the values of the parameter
-MAP_GRID_CROSS_SIZE_PRIMARY and MAP_GRID_CROSS_SIZE_SECONDARY on one line, try
-
- ::
-
- gmt get MAP_GRID_CROSS_SIZE_PRIMARY MAP_GRID_CROSS_SIZE_SECONDARY
-
-See Also
---------
-
-:doc:`gmt`,
-:doc:`gmt.conf`,
-:doc:`gmtdefaults`,
-:doc:`gmtset`
diff --git a/doc_release/html/_sources/gmtinfo.txt b/doc_release/html/_sources/gmtinfo.txt
deleted file mode 100644
index a9b9394..0000000
--- a/doc_release/html/_sources/gmtinfo.txt
+++ /dev/null
@@ -1,177 +0,0 @@
-.. index:: ! gmtinfo
-
-*******
-gmtinfo
-*******
-
-.. only:: not man
-
- gmtinfo - Get information about data tables
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**gmtinfo** [ *table* ] [ **-A**\ **a**\ \|\ **f**\ \|\ **s** ] [ **-C** ]
-[ **-D**\ [*dx*\ [/*dy*\ ]] ] [ **-EL**\ \|\ **l**\ \|\ **H**\ \|\ **h**\ *col* ]
-[ **-I**\ [**p**\ \|\ **f**\ \|\ **s**]\ *dx*\ [/*dy*\ [/*dz*...] ]
-[ **-S**\ [**x**\ ][**y**] ] [ **-T**\ *dz*\ [/*col*] ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-bi| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-g| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-o| ]
-[ **-r** ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**gmtinfo** reads its standard input [or from files] and finds the
-extreme values in each of the columns. It recognizes NaNs and will print
-warnings if the number of columns vary from record to record. As an
-option, **gmtinfo** will find the extent of the first *n* columns rounded
-up and down to the nearest multiple of the supplied increments. By
-default, this output will be in the form **-R**\ *w/e/s/n* which can be
-used directly in the command line for other programs (hence only *dx*
-and *dy* are needed), or the output will be in column form for as many
-columns as there are increments provided. A similar option (**-T**) will
-provide a **-T**\ *zmin/zmax/dz* string for makecpt.
-
-Required Arguments
-------------------
-
-None.
-
-Optional Arguments
-------------------
-
-.. |Add_intables| unicode:: 0x20 .. just an invisible code
-.. include:: explain_intables.rst_
-
-**-A**\ **a**\ \|\ **f**\ \|\ **s**
- Specify how the range should be reported. Choose **-Aa** for the
- range of all files combined, **-Af** to report the range for each
- file separately, and **-As** to report the range for each segment
- (in multisegment files) separately. [Default is **-Aa**].
-**-C**
- Report the min/max values per column in separate columns [Default
- uses <min/max> format]. When used, users may also use **-o** to
- limit which output columns should be reported [all].
-**-D**
- Modifies results obtained by **-I** by shifting the region to better
- align with the center of the data. Optionally, append granularity
- for this shift [Default performs an exact shift].
-**-EL**\ \|\ **l**\ \|\ **H**\ \|\ **h**\ *col*
- Returns the record whose column *col* contains the minimum
- (**l**) or maximum (**h**) value. Upper case
- (**L\|H**) works on absolute value of the data. In case of multiple
- matches, only the first record is returned. If *col* is not
- specified we default to the last column in the data.
-**-I**\ [**p**\ \|\ **f**\ \|\ **s**]\ *dx*\ [/*dy*\ [/*dz*...]
- Report the min/max of the first *n* columns to the nearest multiple
- of the provided increments (separate the *n* increments by slashes),
- and output results in the form **-R**\ *w/e/s/n* (unless **-C** is
- set). If only one increment is given we also use it for the second
- column (for backwards compatibility). To override this behavior, use
- **-Ip**\ *dx*. If the input *x*- and *y*-coordinates all have the
- same phase shift relative to the *dx* and *dy* increments then we
- use those phase shifts in determining the region, and you may use
- **-r** to switch from gridline-registration to pixel-registration.
- For irregular data both phase shifts are set to 0 and the **-r** is ignored.
- Use **-If**\ *dx*\ [/*dy*] to report an extended region optimized
- to give grid dimensions for fastest results in programs using FFTs.
- Use **-Is**\ *dx*\ [/*dy*] to report an extended region optimized to
- give grid dimensions for fastest results in programs like surface.
- If *dx* is given as - then the actual min/max of the input is given
- in the **-R** string.
-**-S**\ [**x**][**y**]
- Add extra space for error bars. Useful together with **-I** option
- and when later plotting with **psxy** **-E**. **-Sx** leaves space
- for horizontal error bars using the values in third
- (2) column. **-Sy** leaves space for vertical error
- bars using the values in third (2) column. **-S**
- or **-Sxy** leaves space for both error bars using the values in
- third and fourth (2 and 3) columns.
-**-T**\ *dz*\ [/*col*]
- Report the min/max of the first (0'th) column to the nearest
- multiple of *dz* and output this in the form **-T**\ *zmin/zmax/dz*.
- To use another column, append /\ *col*. Only works when **-I** is
- selected.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. |Add_-bi| replace:: [Default is 2 input columns].
-.. include:: explain_-bi.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-g| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-g.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. |Add_nodereg| unicode:: 0x20 .. just an invisible code
-.. include:: explain_nodereg.rst_
-
-.. include:: explain_colon.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_precision.rst_
-
-Examples
---------
-
-To find the extreme values in the file ship\_gravity.xygd:
-
- ::
-
- gmt info ship_gravity.xygd
-
-Output should look like
-
- ::
-
- ship_gravity.xygd: N = 6992 <326.125/334.684> <-28.0711/-8.6837> <-47.7/177.6> <0.6/3544.9>
-
-To find the extreme values in the file track.xy to the nearest 5 units
-but shifted to within 1 unit of the data center, and use this region to
-draw a line using psxy, run
-
- ::
-
- gmt psxy `gmt info -I5 -D1 track.xy` track.xy -Jx1 -B5 -P > track.ps
-
-To find the min and max values for each of the first 4 columns, but
-rounded to integers, and return the result individually for each data
-file, use
-
- ::
-
- gmt info profile_*.txt -C -I1/1/1/1
-
-Bugs
-----
-
-The **-I** option does not yet work properly with time series data
-(e.g., **-f**\ 0T). Thus, such variable intervals as months and years
-are not calculated. Instead, specify your interval in the same units as
-the current setting of :ref:`TIME_UNIT <TIME_UNIT>`.
-
-See Also
---------
-
-:doc:`gmt`,
-:doc:`gmtconvert`
-
diff --git a/doc_release/html/_sources/gmtlogo.txt b/doc_release/html/_sources/gmtlogo.txt
deleted file mode 100644
index 46911e5..0000000
--- a/doc_release/html/_sources/gmtlogo.txt
+++ /dev/null
@@ -1,48 +0,0 @@
-.. index:: ! gmtlogo
-
-*******
-gmtlogo
-*******
-
-.. only:: not man
-
- gmtlogo - Adding a GMT graphics logo overlay to an illustration
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**gmtlogo** *dx* *dy* [ **-G**\ *fill* ] [ **-W**\ [*pen*] ] >> *plot.ps*
-
-|No-spaces|
-
-Description
------------
-
-This script appends the GMT logo as an overlay to an "open"
-PostScript file. The logo is 2 inches wide and 1 inch high and will be
-positioned relative to the current plot origin.
-
-Required Arguments
-------------------
-
-*dx*,\ *dy*
- Sets the lower-left corner of the logo relative to current plot
- origin.
-
-Optional Arguments
-------------------
-
-**-G**\ *fill*
- Select color or pattern for filling the underlying box [Default is
- no fill].
-**-W**\ [*pen*]
- Set pen attributes for the outline of the box [Default is no
- outline].
-
-See Also
---------
-
-:doc:`gmt`, :doc:`gmtcolors`,
-:doc:`psimage`
diff --git a/doc_release/html/_sources/gmtmath.txt b/doc_release/html/_sources/gmtmath.txt
deleted file mode 100644
index 4a6913d..0000000
--- a/doc_release/html/_sources/gmtmath.txt
+++ /dev/null
@@ -1,657 +0,0 @@
-.. index:: ! gmtmath
-
-*******
-gmtmath
-*******
-
-.. only:: not man
-
- gmtmath - Reverse Polish Notation (RPN) calculator for data tables
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**gmtmath** [ **-A**\ *t_f(t).d*\ [**+s**\ \|\ **r**] ] [ **-C**\ *cols* ]
-[ **-E**\ *eigen* ] [ **-I** ]
-[ **-N**\ *n\_col*\ [/*t_col*] ] [ **-Q** ] [ **-S**\ [**f**\ \|\ **l**]
-] [ **-T**\ *t\_min*/*t_max*/*t_inc*\ [**+**\ ]\|\ *tfile* ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-b| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-g| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-o| ]
-[ |SYN_OPT-s| ]
-*operand* [ *operand* ] **OPERATOR** [ *operand* ] **OPERATOR** ...
-**=** [ *outfile* ]
-
-|No-spaces|
-
-Description
------------
-
-**gmtmath** will perform operations like add, subtract, multiply, and
-divide on one or more table data files or constants using Reverse Polish
-Notation (RPN) syntax (e.g., Hewlett-Packard calculator-style).
-Arbitrarily complicated expressions may therefore be evaluated; the
-final result is written to an output file [or standard output]. Data
-operations are element-by-element, not matrix manipulations (except
-where noted). Some operators only require one operand (see below). If no
-data tables are used in the expression then options **-T**, **-N** can
-be set (and optionally **-bo** to indicate the
-data type for binary tables). If STDIN is given, the standard input will
-be read and placed on the stack as if a file with that content had been
-given on the command line. By default, all columns except the "time"
-column are operated on, but this can be changed (see **-C**).
-Complicated or frequently occurring expressions may be coded as a macro
-for future use or stored and recalled via named memory locations.
-
-Required Arguments
-------------------
-
-*operand*
- If *operand* can be opened as a file it will be read as an ASCII (or
- binary, see **-bi**) table data file. If not
- a file, it is interpreted as a numerical constant or a special
- symbol (see below). The special argument STDIN means that *stdin*
- will be read and placed on the stack; STDIN can appear more than
- once if necessary.
-*outfile*
- The name of a table data file that will hold the final result. If
- not given then the output is sent to stdout.
-
-Optional Arguments
-------------------
-
-**-A**\ *t_f(t).d*
- Requires **-N** and will partially initialize a table with values
- from the given file containing *t* and *f(t)* only. The *t* is
- placed in column *t\_col* while *f(t)* goes into column *n\_col* - 1
- (see **-N**). If used with operators LSQFIT and SVDFIT you can
- optionally append the modifiers **+s** or **+r** which will write
- out the model solution or the residuals, respectively [Default
- writes one column with model coefficients].
-**-C**\ *cols*
- Select the columns that will be operated on until next occurrence of
- **-C**. List columns separated by commas; ranges like 1,3-5,7 are
- allowed. **-C** (no arguments) resets the default action of using
- all columns except time column (see **-N**). **-Ca** selects all
- columns, including time column, while **-Cr** reverses (toggles) the
- current choices. When **-C** is in effect it also controls which
- columns from a file will be placed on the stack.
-**-E**\ *eigen*
- Sets the minimum eigenvalue used by operators LSQFIT and SVDFIT [1e-7].
- Smaller eigenvalues are set to zero and will not be considered in the
- solution.
-**-I**
- Reverses the output row sequence from ascending time to descending
- [ascending].
-**-N**\ *n_col*\ [/*t_col*]
- Select the number of columns and optionally the column number that
- contains the "time" variable [0]. Columns are numbered starting at 0
- [2/0]. If input files are specified then **-N** will add any missing
- columns.
-**-Q**
- Quick mode for scalar calculation. Shorthand for **-Ca** **-N**\ 1/0
- **-T**\ 0/0/1.
-**-S**\ [**f**\ \|\ **l**]
- Only report the first or last row of the results [Default is all
- rows]. This is useful if you have computed a statistic (say the
- **MODE**) and only want to report a single number instead of
- numerous records with identical values. Append **l** to get the last
- row and **f** to get the first row only [Default].
-**-T**\ *t\_min*/*t\_max*/*t\_inc*\ [**+**\ ]\|\ *tfile*
- Required when no input files are given. Sets the t-coordinates of
- the first and last point and the equidistant sampling interval for
- the "time" column (see **-N**). Append **+** if you are specifying
- the number of equidistant points instead. If there is no time column
- (only data columns), give **-T** with no arguments; this also
- implies **-Ca**. Alternatively, give the name of a file whose first
- column contains the desired t-coordinates which may be irregular.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. |Add_-bi| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-bi.rst_
-
-.. |Add_-bo| replace:: [Default is same as input, but see **-o**]
-.. include:: explain_-bo.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-g| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-g.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. include:: explain_-ocols.rst_
-
-.. include:: explain_-s.rst_
-
-.. include:: explain_help.rst_
-
-Operators
----------
-
-Choose among the following 143 operators. "args" are the number of input
-and output arguments.
-
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| Operator | args | Returns |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **ABS** | 1 1 | abs (A) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **ACOS** | 1 1 | acos (A) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **ACOSH** | 1 1 | acosh (A) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **ACSC** | 1 1 | acsc (A) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **ACOT** | 1 1 | acot (A) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **ADD** | 2 1 | A + B |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **AND** | 2 1 | B if A == NaN, else A |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **ASEC** | 1 1 | asec (A) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **ASIN** | 1 1 | asin (A) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **ASINH** | 1 1 | asinh (A) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **ATAN** | 1 1 | atan (A) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **ATAN2** | 2 1 | atan2 (A, B) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **ATANH** | 1 1 | atanh (A) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **BEI** | 1 1 | bei (A) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **BER** | 1 1 | ber (A) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **BITAND** | 2 1 | A & B (bitwise AND operator) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **BITLEFT** | 2 1 | A << B (bitwise left-shift operator) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **BITNOT** | 1 1 | ~A (bitwise NOT operator, i.e., return two's complement) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **BITOR** | 2 1 | A \| B (bitwise OR operator) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **BITRIGHT** | 2 1 | A >> B (bitwise right-shift operator) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **BITTEST** | 2 1 | 1 if bit B of A is set, else 0 (bitwise TEST operator) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **BITXOR** | 2 1 | A ^ B (bitwise XOR operator) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **CEIL** | 1 1 | ceil (A) (smallest integer >= A) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **CHICRIT** | 2 1 | Critical value for chi-squared-distribution, with alpha = A and n = B |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **CHIDIST** | 2 1 | chi-squared-distribution P(chi2,n), with chi2 = A and n = B |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **COL** | 1 1 | Places column A on the stack |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **CORRCOEFF** | 2 1 | Correlation coefficient r(A, B) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **COS** | 1 1 | cos (A) (A in radians) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **COSD** | 1 1 | cos (A) (A in degrees) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **COSH** | 1 1 | cosh (A) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **COT** | 1 1 | cot (A) (A in radians) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **COTD** | 1 1 | cot (A) (A in degrees) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **CSC** | 1 1 | csc (A) (A in radians) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **CSCD** | 1 1 | csc (A) (A in degrees) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **CPOISS** | 2 1 | Cumulative Poisson distribution F(x,lambda), with x = A and lambda = B |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **DDT** | 1 1 | d(A)/dt Central 1st derivative |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **D2DT2** | 1 1 | d^2(A)/dt^2 2nd derivative |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **D2R** | 1 1 | Converts Degrees to Radians |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **DILOG** | 1 1 | dilog (A) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **DIFF** | 1 1 | Difference between adjacent elements of A (A[1]-A[0], A[2]-A[1], ..., 0) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **DIV** | 2 1 | A / B |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **DUP** | 1 2 | Places duplicate of A on the stack |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **ERF** | 1 1 | Error function erf (A) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **ERFC** | 1 1 | Complementary Error function erfc (A) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **ERFINV** | 1 1 | Inverse error function of A |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **EQ** | 2 1 | 1 if A == B, else 0 |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **EXCH** | 2 2 | Exchanges A and B on the stack |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **EXP** | 1 1 | exp (A) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **FACT** | 1 1 | A! (A factorial) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **FCRIT** | 3 1 | Critical value for F-distribution, with alpha = A, n1 = B, and n2 = C |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **FDIST** | 3 1 | F-distribution Q(F,n1,n2), with F = A, n1 = B, and n2 = C |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **FLIPUD** | 1 1 | Reverse order of each column |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **FLOOR** | 1 1 | floor (A) (greatest integer <= A) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **FMOD** | 2 1 | A % B (remainder after truncated division) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **GE** | 2 1 | 1 if A >= B, else 0 |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **GT** | 2 1 | 1 if A > B, else 0 |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **HYPOT** | 2 1 | hypot (A, B) = sqrt (A\*A + B\*B) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **I0** | 1 1 | Modified Bessel function of A (1st kind, order 0) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **I1** | 1 1 | Modified Bessel function of A (1st kind, order 1) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **IFELSE** | 3 1 | B if A != 0, else C |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **IN** | 2 1 | Modified Bessel function of A (1st kind, order B) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **INRANGE** | 3 1 | 1 if B <= A <= C, else 0 |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **INT** | 1 1 | Numerically integrate A |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **INV** | 1 1 | 1 / A |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **ISFINITE** | 1 1 | 1 if A is finite, else 0 |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **ISNAN** | 1 1 | 1 if A == NaN, else 0 |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **J0** | 1 1 | Bessel function of A (1st kind, order 0) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **J1** | 1 1 | Bessel function of A (1st kind, order 1) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **JN** | 2 1 | Bessel function of A (1st kind, order B) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **K0** | 1 1 | Modified Kelvin function of A (2nd kind, order 0) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **K1** | 1 1 | Modified Bessel function of A (2nd kind, order 1) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **KN** | 2 1 | Modified Bessel function of A (2nd kind, order B) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **KEI** | 1 1 | kei (A) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **KER** | 1 1 | ker (A) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **KURT** | 1 1 | Kurtosis of A |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **LE** | 2 1 | 1 if A <= B, else 0 |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **LMSSCL** | 1 1 | LMS scale estimate (LMS STD) of A |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **LOG** | 1 1 | log (A) (natural log) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **LOG10** | 1 1 | log10 (A) (base 10) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **LOG1P** | 1 1 | log (1+A) (accurate for small A) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **LOG2** | 1 1 | log2 (A) (base 2) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **LOWER** | 1 1 | The lowest (minimum) value of A |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **LRAND** | 2 1 | Laplace random noise with mean A and std. deviation B |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **LSQFIT** | 1 0 | Let current table be [A \| b] return least squares solution x = A \\ b |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **LT** | 2 1 | 1 if A < B, else 0 |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **MAD** | 1 1 | Median Absolute Deviation (L1 STD) of A |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **MAX** | 2 1 | Maximum of A and B |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **MEAN** | 1 1 | Mean value of A |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **MED** | 1 1 | Median value of A |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **MIN** | 2 1 | Minimum of A and B |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **MOD** | 2 1 | A mod B (remainder after floored division) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **MODE** | 1 1 | Mode value (Least Median of Squares) of A |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **MUL** | 2 1 | A \* B |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **NAN** | 2 1 | NaN if A == B, else A |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **NEG** | 1 1 | -A |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **NEQ** | 2 1 | 1 if A != B, else 0 |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **NORM** | 1 1 | Normalize (A) so max(A)-min(A) = 1 |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **NOT** | 1 1 | NaN if A == NaN, 1 if A == 0, else 0 |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **NRAND** | 2 1 | Normal, random values with mean A and std. deviation B |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **OR** | 2 1 | NaN if B == NaN, else A |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **PLM** | 3 1 | Associated Legendre polynomial P(A) degree B order C |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **PLMg** | 3 1 | Normalized associated Legendre polynomial P(A) degree B order C (geophysical convention) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **POP** | 1 0 | Delete top element from the stack |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **POW** | 2 1 | A ^ B |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **PQUANT** | 2 1 | The B'th Quantile (0-100%) of A |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **PSI** | 1 1 | Psi (or Digamma) of A |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **PV** | 3 1 | Legendre function Pv(A) of degree v = real(B) + imag(C) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **QV** | 3 1 | Legendre function Qv(A) of degree v = real(B) + imag(C) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **R2** | 2 1 | R2 = A^2 + B^2 |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **R2D** | 1 1 | Convert Radians to Degrees |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **RAND** | 2 1 | Uniform random values between A and B |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **RINT** | 1 1 | rint (A) (round to integral value nearest to A) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **ROTT** | 2 1 | Rotate A by the (constant) shift B in the t-direction |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **SEC** | 1 1 | sec (A) (A in radians) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **SECD** | 1 1 | sec (A) (A in degrees) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **SIGN** | 1 1 | sign (+1 or -1) of A |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **SIN** | 1 1 | sin (A) (A in radians) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **SINC** | 1 1 | sinc (A) (sin (pi\*A)/(pi\*A)) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **SIND** | 1 1 | sin (A) (A in degrees) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **SINH** | 1 1 | sinh (A) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **SKEW** | 1 1 | Skewness of A |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **SQR** | 1 1 | A^2 |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **SQRT** | 1 1 | sqrt (A) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **STD** | 1 1 | Standard deviation of A |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **STEP** | 1 1 | Heaviside step function H(A) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **STEPT** | 1 1 | Heaviside step function H(t-A) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **SUB** | 2 1 | A - B |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **SUM** | 1 1 | Cumulative sum of A |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **TAN** | 1 1 | tan (A) (A in radians) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **TAND** | 1 1 | tan (A) (A in degrees) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **TANH** | 1 1 | tanh (A) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **TAPER** | 1 1 | Unit weights cosine-tapered to zero within A of end margins |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **TN** | 2 1 | Chebyshev polynomial Tn(-1<A<+1) of degree B |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **TCRIT** | 2 1 | Critical value for Student's t-distribution, with alpha = A and n = B |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **TDIST** | 2 1 | Student's t-distribution A(t,n), with t = A, and n = B |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **UPPER** | 1 1 | The highest (maximum) value of A |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **XOR** | 2 1 | B if A == NaN, else A |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **Y0** | 1 1 | Bessel function of A (2nd kind, order 0) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **Y1** | 1 1 | Bessel function of A (2nd kind, order 1) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **YN** | 2 1 | Bessel function of A (2nd kind, order B) |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **ZCRIT** | 1 1 | Critical value for the normal-distribution, with alpha = A |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **ZDIST** | 1 1 | Cumulative normal-distribution C(x), with x = A |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-| **ROOTS** | 2 1 | Treats col A as f(t) = 0 and returns its roots |
-+-----------------+--------+--------------------------------------------------------------------------------------------+
-
-Symbols
--------
-
-The following symbols have special meaning:
-
-+-------------+----------------------------+
-| **PI** | 3.1415926... |
-+-------------+----------------------------+
-| **E** | 2.7182818... |
-+-------------+----------------------------+
-| **EULER** | 0.5772156... |
-+-------------+----------------------------+
-| **TMIN** | Minimum t value |
-+-------------+----------------------------+
-| **TMAX** | Maximum t value |
-+-------------+----------------------------+
-| **TINC** | t increment |
-+-------------+----------------------------+
-| **N** | The number of records |
-+-------------+----------------------------+
-| **T** | Table with t-coordinates |
-+-------------+----------------------------+
-
-.. include:: explain_precision.rst_
-
-
-Notes On Operators
-------------------
-
-1. The operators **PLM** and **PLMg** calculate the associated Legendre
-polynomial of degree L and order M in x which must satisfy -1 <= x <= +1
-and 0 <= M <= L. x, L, and M are the three arguments preceding the
-operator. **PLM** is not normalized and includes the Condon-Shortley
-phase (-1)^M. **PLMg** is normalized in the way that is most commonly
-used in geophysics. The C-S phase can be added by using -M as argument.
-**PLM** will overflow at higher degrees, whereas **PLMg** is stable
-until ultra high degrees (at least 3000).
-
-2. Files that have the same names as some operators, e.g., **ADD**,
-**SIGN**, **=**, etc. should be identified by prepending the current
-directory (i.e., ./).
-
-3. The stack depth limit is hard-wired to 100.
-
-4. All functions expecting a positive radius (e.g., **LOG**, **KEI**,
-etc.) are passed the absolute value of their argument.
-
-5. The **DDT** and **D2DT2** functions only work on regularly spaced data.
-
-6. All derivatives are based on central finite differences, with
-natural boundary conditions.
-
-7. **ROOTS** must be the last operator on the stack, only followed by **=**.
-
-.. include:: explain_sto_rcl_clr.rst_
-
-
-8. The bitwise operators
-(**BITAND**, **BITLEFT**, **BITNOT**, **BITOR**, **BITRIGHT**,
-**BITTEST**, and **BITXOR**) convert a tables's double precision values
-to unsigned 64-bit ints to perform the bitwise operations. Consequently,
-the largest whole integer value that can be stored in a double precision
-value is 2^53 or 9,007,199,254,740,992. Any higher result will be masked
-to fit in the lower 54 bits. Thus, bit operations are effectively limited
-to 54 bits. All bitwise operators return NaN if given NaN arguments or
-bit-settings <= 0.
-
-9. TAPER will interpret its argument to be a width in the same units as
-the time-axis, but if no time is provided (i.e., plain data tables) then
-the width is taken to be given in number of rows.
-
-Macros
-------
-
-Users may save their favorite operator combinations as macros via the
-file *gmtmath.macros* in their current or user directory. The file may contain
-any number of macros (one per record); comment lines starting with # are
-skipped. The format for the macros is **name** = **arg1 arg2 ... arg2**
-[ : *comment*] where **name** is how the macro will be used. When this
-operator appears on the command line we simply replace it with the
-listed argument list. No macro may call another macro. As an example,
-the following macro expects that the time-column contains seafloor ages
-in Myr and computes the predicted half-space bathymetry:
-
-**DEPTH** = **SQRT 350 MUL 2500 ADD NEG** : *usage: DEPTH to return
-half-space seafloor depths*
-
-Note: Because geographic or time constants may be present in a macro, it
-is required that the optional comment flag (:) must be followed by a space.
-As another example, we show a macro **GPSWEEK** which determines which GPS week
-a timestamp belongs to:
-
-**GPSWEEK** = 1980-01-06T00:00:00 SUB 86400 DIV 7 DIV FLOOR : GPS week without rollover
-
-Examples
---------
-
-To take the square root of the content of the second data column being
-piped through **gmtmath** by process1 and pipe it through a 3rd process, use
-
- ::
-
- process1 | gmt gmtmath STDIN SQRT = | process3
-
-To take log10 of the average of 2 data files, use
-
- ::
-
- gmt gmtmath file1.d file2.d ADD 0.5 MUL LOG10 = file3.d
-
-Given the file samples.d, which holds seafloor ages in m.y. and seafloor
-depth in m, use the relation depth(in m) = 2500 + 350 \* sqrt (age) to
-print the depth anomalies:
-
- ::
-
- gmt gmtmath samples.d T SQRT 350 MUL 2500 ADD SUB = | lpr
-
-To take the average of columns 1 and 4-6 in the three data sets sizes.1,
-sizes.2, and sizes.3, use
-
- ::
-
- gmt gmtmath -C1,4-6 sizes.1 sizes.2 ADD sizes.3 ADD 3 DIV = ave.d
-
-To take the 1-column data set ages.d and calculate the modal value and
-assign it to a variable, try
-
- ::
-
- gmt set mode_age = `gmt gmtmath -S -T ages.d MODE =`
-
-To evaluate the dilog(x) function for coordinates given in the file t.d:
-
- ::
-
- gmt gmtmath -Tt.d T DILOG = dilog.d
-
-To demonstrate the use of stored variables, consider this sum of the
-first 3 cosine harmonics where we store and repeatedly recall the
-trigonometric argument (2\*pi\*T/360):
-
- ::
-
- gmt gmtmath -T0/360/1 2 PI MUL 360 DIV T MUL STO at kT COS @kT 2 MUL COS ADD \
- @kT 3 MUL COS ADD = harmonics.d
-
-To use gmtmath as a RPN Hewlett-Packard calculator on scalars (i.e., no
-input files) and calculate arbitrary expressions, use the **-Q** option.
-As an example, we will calculate the value of Kei (((1 + 1.75)/2.2) +
-cos (60)) and store the result in the shell variable z:
-
- ::
-
- set z = `gmt gmtmath -Q 1 1.75 ADD 2.2 DIV 60 COSD ADD KEI =`
-
-To use **gmtmath** as a general least squares equation solver, imagine
-that the current table is the augmented matrix [ A \| b ] and you want
-the least squares solution x to the matrix equation A \* x = b. The
-operator **LSQFIT** does this; it is your job to populate the matrix
-correctly first. The **-A** option will facilitate this. Suppose you
-have a 2-column file ty.d with *t* and *b(t)* and you would like to fit
-a the model y(t) = a + b\*t + c\*H(t-t0), where H is the Heaviside step
-function for a given t0 = 1.55. Then, you need a 4-column augmented
-table loaded with t in column 1 and your observed y(t) in column 3. The
-calculation becomes
-
- ::
-
- gmt gmtmath -N4/1 -Aty.d -C0 1 ADD -C2 1.55 STEPT ADD -Ca LSQFIT = solution.d
-
-Note we use the **-C** option to select which columns we are working on,
-then make active all the columns we need (here all of them, with
-**-Ca**) before calling **LSQFIT**. The second and fourth columns (col
-numbers 1 and 3) are preloaded with t and y(t), respectively, the other
-columns are zero. If you already have a pre-calculated table with the
-augmented matrix [ A \| b ] in a file (say lsqsys.d), the least squares
-solution is simply
-
- ::
-
- gmt gmtmath -T lsqsys.d LSQFIT = solution.d
-
-Users must be aware that when **-C** controls which columns are to be
-active the control extends to placing columns from files as well.
-Constrast the different result obtained by these very similar commands:
-
-::
-
- echo 1 2 3 4 | gmt math STDIN -C3 1 ADD =
- 1 2 3 5
-
-versus
-
-::
-
- echo 1 2 3 4 | gmt math -C3 STDIN 1 ADD =
- 0 0 0 5
-
-References
-----------
-
-Abramowitz, M., and I. A. Stegun, 1964, *Handbook of Mathematical
-Functions*, Applied Mathematics Series, vol. 55, Dover, New York.
-
-Holmes, S. A., and W. E. Featherstone, 2002, A unified approach to the
-Clenshaw summation and the recursive computation of very high degree and
-order normalized associated Legendre functions. *Journal of Geodesy*,
-76, 279-299.
-
-Press, W. H., S. A. Teukolsky, W. T. Vetterling, and B. P. Flannery,
-1992, *Numerical Recipes*, 2nd edition, Cambridge Univ., New York.
-
-Spanier, J., and K. B. Oldman, 1987, *An Atlas of Functions*, Hemisphere
-Publishing Corp.
-
-See Also
---------
-
-:doc:`gmt`,
-:doc:`grdmath`
diff --git a/doc_release/html/_sources/gmtselect.txt b/doc_release/html/_sources/gmtselect.txt
deleted file mode 100644
index c4ced8d..0000000
--- a/doc_release/html/_sources/gmtselect.txt
+++ /dev/null
@@ -1,274 +0,0 @@
-.. index:: ! gmtselect
-
-*********
-gmtselect
-*********
-
-.. only:: not man
-
- gmtselect - Select data table subsets based on multiple spatial criteria
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**gmtselect** [ *table* ]
-[ **-A**\ *min\_area*\ [/*min\_level*/*max\_level*][\ **+as**\ ][\ **+r**\ \|\ **l**][\ **p**\ *percent*] ]
-[ **-C**\ *dist*\ [*unit*]/\ *ptfile* ]
-[ **-D**\ *resolution*\ [**+**] ] [ **-E**\ [**fn**] ]
-[ **-F**\ *polygonfile* ] [ **-I**\ [**cflrsz**] ]
-[ **-J**\ *parameters* ]
-[ **-L**\ [**p**]\ *dist*\ [*unit*]/\ *linefile* ]
-[ **-N**\ *maskvalues* ]
-[ |SYN_OPT-R| ]
-[ **-Z**\ *min*\ [/*max*]\ [**+c**\ *col*] ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-b| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-g| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-o| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**gmtselect** is a filter that reads (longitude, latitude) positions
-from the first 2 columns of *infiles* [or standard input] and uses a
-combination of 1-6 criteria to pass or reject the records. Records can
-be selected based on whether or not they are 1) inside a rectangular
-region (**-R** [and **-J**]), 2) within *dist* km of any point in
-*ptfile*, 3) within *dist* km of any line in *linefile*, 4) inside one
-of the polygons in the *polygonfile*, 5) inside geographical features
-(based on coastlines), or 6) has z-values within a given range. The
-sense of the tests can be reversed for each of these 6 criteria by using
-the **-I** option. See option **-:** on how to read (latitude,longitude)
-files.
-
-Required Arguments
-------------------
-
-None
-
-Optional Arguments
-------------------
-
-.. |Add_intables| unicode:: 0x20 .. just an invisible code
-.. include:: explain_intables.rst_
-
-.. |Add_-A| replace:: Ignored unless **-N** is set.
-.. include:: explain_-A.rst_
-
-**-C**\ *dist*\ [*unit*]/\ *ptfile*
- Pass all records whose location is within *dist* of any of the
- points in the ASCII file *ptfile*. If *dist* is zero then the 3rd
- column of *ptfile* must have each point's individual radius of
- influence. Distances are Cartesian and in user units; specify
- **-fg** to indicate spherical distances and append a distance unit
- (see UNITS). Alternatively, if **-R** and **-J** are used then
- geographic coordinates are projected to map coordinates (in cm,
- inch, or points, as determined by :ref:`PROJ_LENGTH_UNIT <PROJ_LENGTH_UNIT>`) before
- Cartesian distances are compared to *dist*.
-
-**-D**\ *resolution*\ [**+**]
- Ignored unless **-N** is set. Selects the resolution of the
- coastline data set to use ((**f**)ull, (**h**)igh,
- (**i**)ntermediate, (**l**)ow, or (**c**)rude). The resolution drops
- off by ~80% between data sets. [Default is **l**]. Append (+) to
- automatically select a lower resolution should the one requested not
- be available [abort if not found]. Note that because the coastlines
- differ in details it is not guaranteed that a point will remain
- inside [or outside] when a different resolution is selected.
-
-**-E**\ [**fn**]
- Specify how points exactly on a polygon boundary should be
- considered. By default, such points are considered to be inside the
- polygon. Append **n** and/or **f** to change this behavior for the
- **-F** and **-N** options, respectively, so that boundary points are
- considered to be outside.
-
-**-F**\ *polygonfile*
- Pass all records whose location is within one of the closed polygons
- in the multiple-segment file *polygonfile*. For spherical polygons
- (lon, lat), make sure no consecutive points are separated by 180
- degrees or more in longitude. Note that *polygonfile* must be in
- ASCII regardless of whether **-bi** is used.
-
-**-I**\ [**cflrsz**]
- Reverses the sense of the test for each of the criteria specified:
-
- **c** select records NOT inside any point's circle of influence.
-
- **f** select records NOT inside any of the polygons.
-
- **l** select records NOT within the specified distance of any line.
-
- **r** select records NOT inside the specified rectangular region.
-
- **s** select records NOT considered inside as specified by **-N**
- (and **-A**, **-D**).
-
- **z** select records NOT within the range specified by **-Z**.
-
-.. include:: explain_-J.rst_
-
-**-L**\ [**p**]\ *dist*\ [*unit*]/\ *linefile*
- Pass all records whose location is within *dist* of any of the line
- segments in the ASCII multiple-segment file *linefile*. If *dist* is
- zero then we will scan each sub-header in the *ptfile* for an
- embedded **-D**\ *dist* setting that sets each line's individual
- distance value. Distances are Cartesian and in user units; specify
- **-fg** to indicate spherical distances append a distance unit (see
- UNITS). Alternatively, if **-R** and **-J** are used then geographic
- coordinates are projected to map coordinates (in cm, inch, m, or
- points, as determined by :ref:`PROJ_LENGTH_UNIT <PROJ_LENGTH_UNIT>`) before Cartesian
- distances are compared to *dist*. Use **-Lp** to ensure only points
- whose orthogonal projections onto the nearest line-segment fall
- within the segments endpoints [Default considers points "beyond" the
- line's endpoints.
-
-**-N**\ *maskvalues*
- Pass all records whose location is inside specified geographical
- features. Specify if records should be skipped (s) or kept (k) using
- 1 of 2 formats:
-
- **-N**\ *wet/dry*.
-
- **-N**\ *ocean/land/lake/island/pond*.
-
- [Default is s/k/s/k/s (i.e., s/k), which passes all points on dry land].
-
-.. |Add_-R| replace:: If no map projection is supplied we implicitly set **-Jx**\ 1.
-.. include:: explain_-R.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-Z**\ *min*\ [/*max*]\ [**+c**\ *col*]
- Pass all records whose 3rd column (*z*; *col* = 2) lies within the given range
- or is NaN (use **-s** to skip NaN records).
- If *max* is omitted then we test if *z* equals *min* instead.
- Input file must have at least three columns. To indicate no limit on
- min or max, specify a hyphen (-). If your 3rd column is absolute
- time then remember to supply **-f**\ 2T. To specify another column, append
- **+c**\ *col*, and to specify several tests just repeat the **Z** option as
- many times has you have columns to test. Note: when more than one **Z** option
- is given then the **Iz** option cannot be used.
-
-.. |Add_-bi| replace:: [Default is 2 input columns].
-.. include:: explain_-bi.rst_
-
-.. |Add_-bo| replace:: [Default is same as input].
-.. include:: explain_-bo.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-g| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-g.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. include:: explain_-ocols.rst_
-
-.. include:: explain_-s.rst_
-
-.. include:: explain_colon.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_distunits.rst_
-
-.. include:: explain_precision.rst_
-
-This note applies to ASCII output only in combination with binary or
-netCDF input or the **-:** option. See also the note below.
-
-Note On Processing Ascii Input Records
---------------------------------------
-
-Unless you are using the **-:** option, selected ASCII input records are
-copied verbatim to output. That means that options like **-foT** and
-settings like :ref:`FORMAT_FLOAT_OUT <FORMAT_FLOAT_OUT>` and :ref:`FORMAT_GEO_OUT <FORMAT_GEO_OUT>` will not
-have any effect on the output. On the other hand, it allows selecting
-records with diverse content, including character strings, quoted or
-not, comments, and other non-numerical content.
-
-Note On Distances
------------------
-
-If options **-C** or **-L** are selected then distances are Cartesian
-and in user units; use **-fg** to imply spherical distances in km and
-geographical (lon, lat) coordinates. Alternatively, specify **-R** and
-**-J** to measure projected Cartesian distances in map units (cm, inch,
-or points, as determined by :ref:`PROJ_LENGTH_UNIT <PROJ_LENGTH_UNIT>`).
-
-This program has evolved over the years. Originally, the **-R** and
-**-J** were mandatory in order to handle geographic data, but now there
-is full support for spherical calculations. Thus, **-J** should only be
-used if you want the tests to be applied on projected data and not the
-original coordinates. If **-J** is used the distances given via **-C**
-and **-L** are projected distances.
-
-Note On Segments
-----------------
-
-Segment headers in the input files are copied to output if one or more
-records from a segment passes the test. Selection is always done point
-by point, not by segment.
-
-Examples
---------
-
-To extract the subset of data set that is within 300 km of any of the
-points in pts.d but more than 100 km away from the lines in lines.d, run
-
- ::
-
- gmt gmtselect lonlatfile -fg -C300k/pts.d -L100/lines.d -Il > subset
-
-Here, you must specify **-fg** so the program knows you are processing
-geographical data.
-
-To keep all points in data.d within the specified region, except the
-points on land (as determined by the high-resolution coastlines), use
-
- ::
-
- gmt gmtselect data.d -R120/121/22/24 -Dh -Nk/s > subset
-
-To return all points in quakes.d that are inside or on the spherical
-polygon lonlatpath.d, try
-
- ::
-
- gmt gmtselect quakes.d -Flonlatpath.d -fg > subset1
-
-To return all points in stations.d that are within 5 cm of the point in
-origin.d for a certain projection, try
-
- ::
-
- gmt gmtselect stations.d -C5/origin.d -R20/50/-10/20 -JM20c \
- --PROJ_LENGTH_UNIT=cm > subset2
-
-.. include:: explain_gshhs.rst_
-
-
-See Also
---------
-
-:doc:`gmt`,
-:doc:`gmt.conf`,
-:doc:`gmtconvert`,
-:doc:`gmtsimplify`,
-:doc:`gmtspatial`,
-:doc:`grdlandmask`,
-:doc:`pscoast`
diff --git a/doc_release/html/_sources/gmtset.txt b/doc_release/html/_sources/gmtset.txt
deleted file mode 100644
index eea2cec..0000000
--- a/doc_release/html/_sources/gmtset.txt
+++ /dev/null
@@ -1,81 +0,0 @@
-.. index:: ! gmtset
-
-******
-gmtset
-******
-
-.. only:: not man
-
- gmtset - Change individual GMT default parameters
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**gmtset** [ **-C** \| **-D**\ [**s**\ \|\ **u**] \|
-**-G**\ *defaultsfile* ] [ **-**\ [**BJRXxYycp**\ ]\ *value* ]
-PARAMETER1 [=] *value1* PARAMETER2 [=] *value2* PARAMETER3 [=] *value3*
-...
-
-|No-spaces|
-
-Description
------------
-
-**gmtset** will adjust individual GMT defaults settings in the
-current directory's :doc:`gmt.conf` file. If no such file exists one will
-be created. The main purpose of **gmtset** is temporarily to change
-certain parameters inside a shell script, e.g., set the dots-per-inch to
-72, run the script, and reset to 1200 dpi. Optionally, you can specify
-one or more temporary changes directly on any GMT command line with
-the syntax **-**\ **-PARAMETER**\ =\ *VALUE*; such changes are only in effect
-for that command and do not permanently change the default settings on
-disk.
-
-Required Arguments
-------------------
-
-PARAMETER *value*
- Provide one or several pairs of parameter/value combinations that
- you want to modify. For a complete listing of available parameters
- and their meaning, see the :doc:`gmt.conf` man page.
-
-Optional Arguments
-------------------
-
-**-C**
- Convert a .gmtdefaults4 file created by GMT4 to a :doc:`gmt.conf` file
- used by GMT5. The original file is retained.
-
-**-D**\ [**s**\ \|\ **u**]
- Modify the GMT defaults based on the system settings. Append
- **u** for US defaults or **s** for SI defaults. [**-D** alone gives
- the version selected at compile time]
-
-**-G**\ *defaultsfile*
- Name of specific :doc:`gmt.conf` file to read and modify [Default looks
- first in current directory, then in your home directory, then in
- ~/.gmt and finally in the system defaults].
-
-**-**\ [**BJRXxYycp**]\ *value*
- Set the expansion of any of these shorthand options.
-
-.. include:: explain_help.rst_
-
-Examples
---------
-
-To change annotation font to 12-point Helvetica, select grid-crosses of
-size 0.1 inch, and set annotation offset to 0.2 cm:
-
- ::
-
- gmt set FONT_ANNOT_PRIMARY 12p,Helvetica \
- MAP_GRID_CROSS_SIZE_PRIMARY 0.1i MAP_ANNOT_OFFSET_PRIMARY 0.2c
-
-See Also
---------
-
-:doc:`gmt`, :doc:`gmt.conf`,
-:doc:`gmtdefaults`, :doc:`gmtget`
diff --git a/doc_release/html/_sources/gmtsimplify.txt b/doc_release/html/_sources/gmtsimplify.txt
deleted file mode 100644
index 243c164..0000000
--- a/doc_release/html/_sources/gmtsimplify.txt
+++ /dev/null
@@ -1,137 +0,0 @@
-.. index:: ! gmtsimplify
-
-***********
-gmtsimplify
-***********
-
-.. only:: not man
-
- gmtsimplify - Line reduction using the Douglas-Peucker algorithm
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**gmtsimplify** [ *table* ] **-T**\ *tolerance*\ [*unit*]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-b| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-g| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-o| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**gmtsimplify** reads one or more data files and apply the Douglas-Peucker
-line simplification algorithm. The method recursively subdivides a
-polygon until a run of points can be replaced by a straight line
-segment, with no point in that run deviating from the straight line by
-more than the tolerance. Have a look at this site to get a visual
-insight on how the algorithm works
-(http://geometryalgorithms.com/Archive/algorithm_0205/algorithm_0205.htm)
-
-Required Arguments
-------------------
-
-**-T**\ *tolerance*\ [*unit*]
- Specifies the maximum mismatch tolerance in the user units. If the
- data is not Cartesian then append the distance unit (see UNITS).
-
-Optional Arguments
-------------------
-
-.. |Add_intables| unicode:: 0x20 .. just an invisible code
-.. include:: explain_intables.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. |Add_-bi| replace:: [Default is 2 input columns].
-.. include:: explain_-bi.rst_
-
-.. |Add_-bo| replace:: [Default is same as input].
-.. include:: explain_-bo.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-g| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-g.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. include:: explain_-ocols.rst_
-
-.. include:: explain_colon.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_distunits.rst_
-
-.. include:: explain_precision.rst_
-
-Examples
---------
-
-To reduce the geographic line segment.d using a tolerance of 2 km, run
-
- ::
-
- gmt gmtsimplify segment.d -T2k > new_segment.d
-
-To reduce the Cartesian lines xylines.d using a tolerance of 0.45 and
-write the reduced lines to file new_xylines.d, run
-
- ::
-
- gmt gmtsimplify xylines.d -T0.45 > new_xylines.d
-
-Notes
------
-
-There is a slight difference in how gmtsimplify processes lines versus
-closed polygons. Segments that are explicitly closed will be considered
-polygons, otherwise we treat them as line segments. Hence, segments
-recognized as polygons may reduce to a 3-point polygon with no area;
-these are suppressed from the output.
-
-Bugs
-----
-
-One known issue with the Douglas-Peucker has to do with crossovers.
-Specifically, it cannot be guaranteed that the reduced line does not
-cross itself. Depending on how many lines you are considering it is also
-possible that reduced lines may intersect other reduced lines. Finally,
-the current implementation only does Flat Earth calculations even if you
-specify spherical; **gmtsimplify** will issue a warning and reset the
-calculation mode to Flat Earth.
-
-References
-----------
-
-Douglas, D. H., and T. K. Peucker, Algorithms for the reduction of the
-number of points required to represent a digitized line of its
-caricature, *Can. Cartogr.*, **10**, 112-122, 1973.
-
-This implementation of the algorithm has been kindly provided by Dr.
-`Gary J. Robinson <http://www.met.reading.ac.uk/users/users/1327/>`_,
-Department of Meteorology, University of Reading, Reading, UK; his
-subroutine forms the basis for this program.
-
-See Also
---------
-
-:doc:`gmt`,
-:doc:`gmt.conf`,
-:doc:`gmtconnect`,
-:doc:`gmtconvert`,
-:doc:`gmtselect`
diff --git a/doc_release/html/_sources/gmtspatial.txt b/doc_release/html/_sources/gmtspatial.txt
deleted file mode 100644
index 8b259be..0000000
--- a/doc_release/html/_sources/gmtspatial.txt
+++ /dev/null
@@ -1,207 +0,0 @@
-.. index:: ! gmtspatial
-
-**********
-gmtspatial
-**********
-
-.. only:: not man
-
- gmtspatial - Do geospatial operations on lines and polygons
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**gmtspatial** [ *table* ] [ **-A**\ [**a**\ *min_dist*][*unit*]] [ **-C** ]
-[ **-D**\ [**+f**\ *file*][\ **+a**\ *amax*][\ **+d**\ *dmax*][\ **+c\|C**\ *cmax*][\ **+s**\ *fact*] ]
-[ **-E**\ **+**\ \|\ **-** ] [ **-I**\ [**e**\ \|\ **i**] ]
-[ **-N**\ *pfile*\ [**+a**][\ **+p**\ *start*][**+r**][**+z**] ]
-[ **-Q**\ [**+**\ [*unit*\ ]] ]
-[ |SYN_OPT-R| ]
-[ **-S**\ **i**\ \|\ **u**\ \|\ **s**\ \|\ **j** ]
-[ **-T**\ [*clippolygon*] ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-b| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-g| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-o| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**gmtspatial** reads one or more data files (which may be multisegment
-files) that contains closed polygons and operates of these polygons in
-the specified way. Operations include area calculation, handedness
-reversals, and polygon intersections.
-
-Required Arguments
-------------------
-
-None.
-
-Optional Arguments
-------------------
-
-.. |Add_intables| unicode:: 0x20 .. just an invisible code
-.. include:: explain_intables.rst_
-
-**-A**\ [**a**\ *min_dist*][*unit*]
- Perform spatial nearest neighbor (NN) analysis: Determine the nearest
- neighbor of each point and report the NN distances and the point IDs
- involved in each pair (IDs are the input record numbers starting at 0).
- Use **-Aa** to decimate a data set so that no NN distance is lower than
- the threshold *min_dist*. In this case we write out the (possibly
- averaged) coordinates and the updated NN distances and point IDs. A
- negative point number means the original point was replaced by a weighted
- average (the absolute ID value gives the ID of the first original point
- ID to be included in the average.)
-
-**-C**
- Clips polygons to the map region, including map boundary to the
- polygon as needed. The result is a closed polygon (see **-T** for
- truncation instead). Requires **-R**.
-
-**-D**\ [**+f**\ *file*][\ **+a**\ *amax*][\ **+d**\ *dmax*][\ **+c\|C**\ *cmax*][\ **+s**\ *fact*]
- Check for duplicates among the input lines or polygons, or, if
- *file* is given via **+f**, check if the input features already
- exist among the features in *file*. We consider the cases of exact
- (same number and coordinates) and approximate matches (average
- distance between nearest points of two features is less than a
- threshold). We also consider that some features may have been
- reversed. Features are considered approximate matches if their
- minimum distance is less than *dmax* [0] (see UNITS) and their
- closeness (defined as the ratio between the average distance between
- the features divided by their average length) is less than *cmax*
- [0.01]. For each duplicate found, the output record begins with the
- single letter Y (exact match) or ~ (approximate match). If the two
- matching segments differ in length by more than a factor of 2 then
- we consider the duplicate to be either a subset (-) or a superset
- (+). For polygons we also consider the fractional difference in
- areas; duplicates must differ by less than *amax* [0.01]. By
- default, we compute the mean line separation. Use **-+C**\ *cmin* to
- instead compute the median line separation and therefore a robust
- closeness value. Also by default we consider all distances between
- points on one line and another. Append **-+p** to limit the
- comparison to points that project perpendicularly to points on the
- other line (and not its extension).
-
-**-E**\ **+**\ \|\ **-** ]
- Reset the handedness of all polygons to match the given **+**
- (counter-clockwise) or **-** (clockwise). Implies **-Q+**.
-
-**-I**\ [**e**\ \|\ **i**]
- Determine the intersection locations between all pairs of polygons.
- Append **i** to only compute internal (i.e., self-intersecting
- polygons) crossovers or **e** to only compute external (i.e.,
- between paris of polygons) crossovers [Default is both].
-
-**-N**\ *pfile*\ [**+a**][\ **+p**\ *start*][**+r**][**+z**]
- Determine if one (or all, with **+a**) points of each feature in the
- input data are inside any of the polygons given in the *pfile*. If
- inside, then report which polygon it is; the polygon ID is either
- taken from the aspatial value assigned to Z, the segment header
- (first **-Z**, then **-L** are scanned), or it is assigned the
- running number that is initialized to *start* [0]. By default the
- input segment that are found to be inside a polygon are written to
- stdout with the polygon ID encoded in the segment header as
- **-Z**\ *ID*. Alternatively, append **+r** to just report which
- polygon contains a feature or **+z** to have the IDs added as an
- extra data column on output. Segments that fail to be inside a
- polygon are not written out. If more than one polygon contains the
- same segment we skip the second (and further) scenario.
-
-**-Q**\ [**+**\ [*unit*]]
- Measure the area of all polygons or length of line segments. Use
- **-Q+** to append the area to each polygons segment header [Default
- simply writes the area to stdout]. For polygons we also compute the
- centroid location while for line data we compute the mid-point
- (half-length) position. Append a distance unit to select the unit
- used (see UNITS). Note that the area will depend on the current
- setting of :ref:`PROJ_ELLIPSOID <PROJ_ELLIPSOID>`; this should be a recent ellipsoid to get
- accurate results.
-
-.. |Add_-Rgeo| replace:: Clips polygons to the map
- region, including map boundary to the polygon as needed. The result
- is a closed polygon.
-.. include:: explain_-Rgeo.rst_
-
-**-S**\ **i**\ \|\ **j**\ \|\ **s**\ \|\ **u**
- Spatial processing of polygons. Choose from **-Si** which returns
- the intersection of polygons (closed), **-Su** which returns the
- union of polygons (closed), **-Ss** which will split polygons that
- straddle the Dateline, and **-Sj** which will join polygons that
- were split by the Dateline. Note: Only **-Ss** has been implemented.
-
-**-T**\ [*clippolygon*]
- Truncate polygons against the specified polygon given, possibly
- resulting in open polygons. If no argument is given to **-T** we
- create a clipping polygon from **-R** which then is required. Note
- that when the **-R** clipping is in effect we will also look for
- polygons of length 4 or 5 that exactly match the **-R** clipping polygon.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. |Add_-bi| replace:: [Default is 2 input columns].
-.. include:: explain_-bi.rst_
-
-.. |Add_-bo| replace:: [Default is same as input].
-.. include:: explain_-bo.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-g| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-g.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. include:: explain_-ocols.rst_
-
-.. include:: explain_colon.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_distunits.rst_
-
-.. include:: explain_precision.rst_
-
-Example
--------
-
-To compute the area of all geographic polygons in the multisegment file
-polygons.d, run
-
- ::
-
- gmt gmtspatial polygons.d -Q > areas.d
-
-Same data, but now orient all polygons to go counter-clockwise and write
-their areas to the segment headers, run
-
- ::
-
- gmt gmtspatial polygons.d -Q+ -E+ > areas.d
-
-To determine the intersections between the polygons A.d and B.d, run
-
- ::
-
- gmt gmtspatial A.d B.d -Ce > crossovers.d
-
-See Also
---------
-
-:doc:`gmt`,
-:doc:`gmtconvert`,
-:doc:`gmtselect`,
-:doc:`gmtsimplify`
diff --git a/doc_release/html/_sources/gmtswitch.txt b/doc_release/html/_sources/gmtswitch.txt
deleted file mode 100644
index a967c7b..0000000
--- a/doc_release/html/_sources/gmtswitch.txt
+++ /dev/null
@@ -1,153 +0,0 @@
-.. index:: ! gmtswitch
-
-*********
-gmtswitch
-*********
-
-.. only:: not man
-
- gmtswitch - Switching between different GMT versions
-
-Synopsis
---------
-
-**gmtswitch** [ D \| *version* ]
-
-Introduction
-------------
-
-**gmtswitch** helps you modify your environment to allow for the
-switching back and forth between several installed GMT versions, in
-particular GMT 5 and versions from the GMT 4 series. It works by
-maintaining a list of directories to GMT installations in a file in your
-home directory, then manipulates a symbolic link to point to the GMT
-directory whose executables we wish to use [The Windows version works a
-bit differently; see WINDOWS below].
-
-Required Arguments
-------------------
-
-None. If no arguments are given you are presented with a menu of
-installed GMT versions from 1 to *n* and you specify which one you wish
-to switch to.
-
-Optional Arguments
-------------------
-
-**D**
- Select the default GMT version. This is the first entry in the
- ~/.gmtversions file
-*version*
- Search for a unique match in the ~/.gmtversions file. If one match
- is found we switch to that entry; otherwise an error is generated.
- where module is the name of a GMT program and the options are
- those that pertain to that particular program.
-
-Setup
------
-
-If you have official versions installed then running gmtswitch the very
-first time will examine your hard disk starting at / and look for
-directories with GMT4 or GMT5 in the name. This will fail to find the
-subversion directories and possibly others you have placed elsewhere.
-The fastest way to get up and running is this:
-
-1. Edit/Create ~/.gmtversions and add the paths to all GMT installations
- you have or care to consider. Each path goes on separate lines and
- points to the top dir of each distribution, e.g.,
- /Users/pwessel/UH/RESEARCH/PROJECTS/GMTdev/GMT4.5.7
-
-2. In your .bashrc or .[t]csrh or wherever you are maintaining your PATH
- or path variable, remove any directories you have added that contain
- GMT, and add the new path $HOME/this\_gmt/bin (might be $home for csh users).
- Make sure this path appears before any others that might contain a GMT
- installation, such as those used by package managers (e.g., /sw/bin for
- fink, /opt/local/bin for Macports, etc.).
-
-3. Make the new path take effect (quit/restart terminal, logout/login, etc).
-
-4. cd to the most recent GMT directory where a gmtswitch version lives,
- and run gmtswitch with no argument. Select one of the version from the
- menu.
-
-5. If in csh you may have to say rehash afterwards.
-
-6. Type "psxy -" and the synopsis should tell you that you got the
- correct version. You can now run gmtswitch from anywhere; try it out and
- make sure that you can switch between the versions.
-
-Examples
---------
-
-To switch to GMT version 4.5.7 (assuming it was installed as such and not
-via a package manager), try
-
- gmtswitch GMT4.5.7
-
-To switch to the default (your top choice), do
-
- gmtswitch D
-
-Finally, to select from the menu, just run
-
- gmtswitch
-
-and pick the one you want.
-
-Beware
-------
-
-GMT remembers where it was installed the first time and uses that dir to
-find the default GMT share directory. If you move entire GMT
-installation after compilation then you may have to set GMT\_SHAREDIR to
-point to the top dir in order for things to work. It is best not to move
-things after installation.
-
-Windows
--------
-
-Under Windows use gmtswitch.bat which is a batch script that changes the
-Windows PATH variable so that the BIN directory of the preferred version
-always comes first. To do that the batch works in two alternative modes:
-
-1 - Permanent mode
-
-2 - Temporary mode
-
-The permanent mode makes use of the free executable program "EditPath"
-to change the user path in the registry. It's called permanent because
-the changes remains until ... next change. See
-
-`http://www.softpedia.com/get/Tweak/Registry-Tweak/EditPath.shtml <http://www.softpedia.com/get/Tweak/Registry-Tweak/EditPath.shtml>`_
-
-Of course the editpath.exe binary must be in your system's path as well.
-WARNING: The path change will not be visible on the shell cmd where it
-was executed. For the change to be active you will need to open a new
-cmd window.
-
-The second mode is temporary because the path to the selected GMT binary
-dir is prepended to the previous path via a shell command line. This
-modification disappears when the shell cmd window where it was executes
-is deleted.
-
-It is the user responsibility to set the contents of the G32\_32 to
-G5\_64 below to valid paths where the binaries of the different GMT
-versions are installed Note that it is not mandatory to have all four of
-them in you computer. For the ones you do not have just let them
-pointing to nothing e.g.,
-
-set G4\_64=
-
-The permanent mode is the default one (but this can be changed. See edit
-section) To run in the temporary mode just give a second argument
-(doesn't matter what)
-
-Example usage to set a GMT5 64 bits permanent
-
-gmtswitch g5\_64
-
-To temporary set a GMT4 32 bits do
-
-gmtswitch g4\_32 1
-
-Run without arguments to get a "Usage" (for permanent mode)
diff --git a/doc_release/html/_sources/gmtvector.txt b/doc_release/html/_sources/gmtvector.txt
deleted file mode 100644
index 9a0798f..0000000
--- a/doc_release/html/_sources/gmtvector.txt
+++ /dev/null
@@ -1,200 +0,0 @@
-.. index:: ! gmtvector
-
-*********
-gmtvector
-*********
-
-.. only:: not man
-
- gmtvector - Basic manipulation of Cartesian vectors
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**gmtvector** [ *table* ] [ **-A**\ **m**\ [*conf*]\|\ *vector* ]
-[ **-C**\ [**i**\ \|\ **o**] ]
-[ **-E** ] [ **-N** ] [ **-S**\ *vector* ]
-[ **-T**\ **a**\ \|\ **d**\ \|\ **D**\ \|\ **p**\ *az*\ \|\ **r**\ [*arg*\ \|\ **R**\ \|\ **s**\ \|\ **x**] ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-b| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-g| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-o| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**gmtvector** reads either (x, y), (x, y, z), (r, theta) or (lon, lat)
-[or (lat,lon); see **-:**] coordinates from the first 2-3 columns on
-standard input [or *infiles*]. If **-fg** is selected and only two items
-are read (i.e., lon, lat) then these coordinates are converted to
-Cartesian three-vectors on the unit sphere. Otherwise we expect (r,
-theta) unless **-Ci** is in effect. If no file is found we expect a
-single vector to be given as argument to **-A**; this argument will also
-be interpreted as an x/y[/z], lon/lat, or r/theta vector. The input
-vectors (or the one provided via **-A**) are denoted the prime
-vector(s). Several standard vector operations (angle between vectors,
-cross products, vector sums, and vector rotations) can be selected; most
-require a single second vector, provided via **-S**. The output vectors
-will be converted back to (lon, lat) or (r, theta) unless **-Co** is set
-which requests (x, y[, z]) Cartesian coordinates.
-
-Required Arguments
-------------------
-
-None.
-
-Optional Arguments
-------------------
-
-*table*
- One or more ASCII [or binary, see **-bi**]
- file containing lon,lat [lat,lon if **-:**] values in the first 2
- columns (if **-fg** is given) or (r, theta), or perhaps (x, y[, z])
- if **-Ci** is given). If no file is specified, **gmtvector**, will
- read from standard input.
-
-**-A**\ **m**\ [*conf*\ ]\|\ *vector*
- Specify a single, primary vector instead of reading *infiles*; see
- *infiles* for possible vector formats. Alternatively, append **m**
- to read *infiles* and set the single, primary vector to be the mean
- resultant vector first. We also compute the confidence ellipse for
- the mean vector (azimuth of major axis, major axis, and minor axis;
- for geographic data the axes will be reported in km). You may
- optionally append the confidence level in percent [95]. These three
- parameters are reported in the final three output columns.
-
-**-C**\ [**i**\ \|\ **o**]
- Select Cartesian coordinates on input and output. Append **i** for
- input only or **o** for output only; otherwise both input and output
- will be assumed to be Cartesian [Default is polar r/theta for 2-D
- data and geographic lon/lat for 3-D].
-
-**-E**
- Convert input geographic coordinates from geodetic to geocentric and
- output geographic coordinates from geocentric to geodetic. Ignored
- unless **-fg** is in effect, and is bypassed if **-C** is selected.
-
-**-N**
- Normalize the resultant vectors prior to reporting the output [No
- normalization]. This only has an effect if **-Co** is selected.
-
-**-S**\ [*vector*]
- Specify a single, secondary vector in the same format as the first
- vector. Required by operations in **-T** that need two vectors
- (average, bisector, dot product, cross product, and sum).
-
-**-T**\ **a**\ \|\ **d**\ \|\ **D**\ \|\ **p**\ *az*\ \|\ **s**\ \|\ **r**\ [*arg*\ \|\ **R**\ \|\ **x**]
- Specify the vector transformation of interest. Append **a** for
- average, **b** for the pole of the two points bisector, **d** for
- dot product (use **D** to get angle in degrees between the two
- vectors), **p**\ *az* for the pole to the great circle specified by
- input vector and the circle's *az* (no second vector used), **s** for vector sum,
- **r**\ *par* for vector rotation (here, *par* is a single
- angle for 2-D Cartesian data and *lon/lat/angle* for a 3-D rotation
- pole and angle), **R** will instead rotate the fixed secondary vector
- by the rotations implied by the input records, and **x** for cross-product.
- If **-T** is not given then no transformation takes place; the
- output is determined by other options such as **-A**, **-C**,
- **-E**, and **-N**.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. |Add_-bi| replace:: [Default is 2 or 3 input columns].
-.. include:: explain_-bi.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-g| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-g.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. include:: explain_-ocols.rst_
-
-.. include:: explain_colon.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_precision.rst_
-
-`Examples <#toc7>`_
--------------------
-
-Suppose you have a file with lon, lat called points.txt. You want to
-compute the spherical angle between each of these points and the
-location 133/34. Try
-
- ::
-
- gmt gmtvector points.txt -S133/34 -TD -fg > angles.txt
-
-To rotate the same points 35 degrees around a pole at 133/34, and output
-Cartesian 3-D vectors, use
-
- ::
-
- gmt gmtvector points.txt -Tr133/34/35 -Co -fg > reconstructed.txt
-
-To rotate the point 65/33 by all rotations given in file rots.txt, use
-
- ::
-
- gmt gmtvector rots.txt -TR -S64/33 -fg > reconstructed.txt
-
-To compute the cross-product between the two Cartesian vectors 0.5/1/2
-and 1/0/0.4, and normalizing the result, try
-
- ::
-
- gmt gmtvector -A0.5/1/2 -Tx -S1/0/0.4 -N -C > cross.txt
-
-To rotate the 2-D vector, given in polar form as r = 2 and theta = 35,
-by an angle of 120, try
-
- ::
-
- gmt gmtvector -A2/35 -Tr120 > rotated.txt
-
-To find the mid-point along the great circle connecting the points 123/35 and -155/-30, use
-
- ::
-
- gmt gmtvector -A123/35 -S-155/-30 -Ta -fg > midpoint.txt
-
-To find the mean location of the geographical points listed in
-points.txt, with its 99% confidence ellipse, use
-
- ::
-
- gmt gmtvector points.txt -Am99 -fg > centroid.txt
-
-To find the pole corresponding to the great circle that goes through
-the point -30/60 at an azimuth of 105 degrees, use
-
- ::
-
- gmt gmtvector -A-30/60 -Tp105 -fg > pole.txt
-
-Rotations
----------
-
-For more advanced 3-D rotations as used in plate tectonic
-reconstructions, see the GMT "spotter" supplement.
-
-See Also
---------
-
-:doc:`gmt`, :doc:`project`, :doc:`mapproject`
diff --git a/doc_release/html/_sources/gmtwhich.txt b/doc_release/html/_sources/gmtwhich.txt
deleted file mode 100644
index 7980f85..0000000
--- a/doc_release/html/_sources/gmtwhich.txt
+++ /dev/null
@@ -1,60 +0,0 @@
-.. index:: ! gmtwhich
-
-********
-gmtwhich
-********
-
-.. only:: not man
-
- gmtwhich - Find full path to specified files
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**gmtwhich** *files* [ **-A** ] [ **-C** ] [ **-D** ] [ |SYN_OPT-V| ]
-
-|No-spaces|
-
-Description
------------
-
-**gmtwhich** reports the full paths to the files given on the command
-line. We look for the file in (1) the current directory,
-(2) in $GMT_USERDIR (if defined), (3) in $GMT_DATADIR (if defined). If
-found we print the full path name to the file, just the directory (see
-**-D**), or a confirmation (see **-C**). The $GMT_USERDIR and
-$GMT_DATADIR environment variables can be colon-separated list of
-directories, and we search recursively down any directory that ends with
-/ (i.e., /export/data is a single directory whereas /export/data/ will
-be searched recursively.)
-
-Required Arguments
-------------------
-
-*files*
- One or more file names of any data type (grids, tables, etc.).
-
-Optional Arguments
-------------------
-
-**-A**
- Only consider files that the user has permission to read [Default consider
- all files found].
-**-C**
- Instead of reporting the paths, print the confirmation Y if the file
- is found and N if it is not.
-**-D**
- Instead of reporting the paths, print the directories that contains
- the files.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. include:: explain_help.rst_
-
-See Also
---------
-
-:doc:`gmt`
diff --git a/doc_release/html/_sources/grd2cpt.txt b/doc_release/html/_sources/grd2cpt.txt
deleted file mode 100644
index ac60af6..0000000
--- a/doc_release/html/_sources/grd2cpt.txt
+++ /dev/null
@@ -1,193 +0,0 @@
-.. index:: ! grd2cpt
-
-*******
-grd2cpt
-*******
-
-.. only:: not man
-
- grd2cpt - Make linear or histogram-equalized color palette table from grid
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**grd2cpt** *grid* [ **-A**\ [**+**\ ]\ *transparency* ]
-[ **-C**\ *cptmaster* ] [ **-D**\ [**i**\ \|\ **o**] ] [ **-E**\ *nlevels* ]
-[ **-F**\ [**R**\ \|\ **r**\ \|\ **h**\ \|\ **c** ] [ **-G**\ *zlo*\ /\ *zhi* ] [ **-I** ]
-[ **-L**\ *minlimit/maxlimit* ] [ **-M** ] [ **-N** ]
-[ **-Q**\ [**i**\ \|\ **o**] ]
-[ |SYN_OPT-R| ]
-[ **-S**\ *zstart/zstop/zinc* ]
-[ **-T**\ **-**\ \|\ **+**\ \|\ **\_**\ \|\ **=** ]
-[ |SYN_OPT-V| ]
-[ **-W** ]
-[ **-Z** ]
-
-|No-spaces|
-
-Description
------------
-
-**grd2cpt** reads one or more grid files and writes a color palette
-(cpt) file to standard output. The cpt file is based on an existing
-master cpt file of your choice, and the mapping from data value to
-colors is through the data's cumulative distribution function (CDF), so
-that the colors are histogram equalized. Thus if the grid(s) and the
-resulting cpt file are used in **grdimage** with a linear projection,
-the colors will be uniformly distributed in area on the plot. Let z be
-the data values in the grid. Define CDF(Z) = (# of z < Z) / (# of z in
-grid). (NaNs are ignored). These z-values are then normalized to the
-master cpt file and colors are sampled at the desired intervals.
-
-The color palette includes three additional colors beyond the range of
-z-values. These are the background color (B) assigned to values lower
-than the lowest *z*-value, the foreground color (F) assigned to values
-higher than the highest *z*-value, and the NaN color (N) painted
-wherever values are undefined. For color tables beyond the
-standard GMT offerings, visit cpt-city:
-http://soliton.vm.bytemark.co.uk/pub/cpt-city/.
-
-If the master cpt file includes B, F, and N entries, these will be
-copied into the new master file. If not, the parameters
-**COLOR_BACKGROUND**, **COLOR_FOREGROUND**, and **COLOR_NAN** from
-the :doc:`gmt.conf` file or the command line will be used. This default
-behavior can be overruled using the options **-D**, **-M** or **-N**.
-
-The color model (RGB, HSV or CMYK) of the palette created by **makecpt**
-will be the same as specified in the header of the master cpt file. When
-there is no **COLOR_MODEL** entry in the master cpt file, the
-**COLOR_MODEL** specified in the :doc:`gmt.conf` file or on the command
-line will be used.
-
-Required Arguments
-------------------
-
-*grid*
- Names of one or more grid files used to derive the color palette
- table. All grids need to have the same size and dimensions. (See
- GRID FILE FORMATS below).
-
-Optional Arguments
-------------------
-
-**-A**\ [**+**\ ]\ *transparency*
- Sets a constant level of transparency (0-100) for all color slices.
- Prepend **+** to also affect the fore-, back-, and nan-colors
- [Default is no transparency, i.e., 0 (opaque)].
-
-**-C**\ *cptmaster*
- Selects the master color table to use in the interpolation. Choose
- among the built-in tables (type **grd2cpt** to see the list) or give
- the name of an existing cpt file [Default gives a rainbow cpt file].
-
-**-D**\ [**i**\ \|\ **o**]
- Select the back- and foreground colors to match the colors for
- lowest and highest *z*-values in the output cpt file [Default uses
- the colors specified in the master file, or those defined by the
- parameters **COLOR_BACKGROUND**, **COLOR_FOREGROUND**, and
- **COLOR\_NAN**]. Append **i** to match the colors for the lowest and
- highest values in the input (instead of the output) cpt file.
-
-**-E**\ *nlevels*
- Create a linear color table by dividing the grid z-range into
- *nlevels* equidistant slices.
-
-**-F**\ [**R**\ \|\ **r**\ \|\ **h**\ \|\ **c**]
- Force output cpt file to written with r/g/b codes, gray-scale values
- or color name (**R**, default) or r/g/b codes only (**r**), or h-s-v
- codes (**h**), or c/m/y/k codes (**c**).
-
-**-G**\ *zlo*\ /\ *zhi*
- Truncate the incoming CPT so that the lowest and highest z-levels
- are to *zlo* and *zhi*. If one of these equal NaN then
- we leave that end of the CPT alone. The truncation takes place
- before any resampling.
-
-**-I**
- Reverses the sense of color progression in the master cpt file. Also
- exchanges the foreground and background colors, including those
- specified by the parameters **COLOR\_BACKGROUND** and
- **COLOR\_FOREGROUND**.
-
-**-L**\ *minlimit/maxlimit*
- Limit range of cpt file to *minlimit/maxlimit*, and don't count data
- outside this range when estimating CDF(Z). [Default uses min and max of data.]
-
-**-M**
- Overrule background, foreground, and NaN colors specified in the
- master cpt file with the values of the parameters
- **COLOR_BACKGROUND**, **COLOR_FOREGROUND**, and **COLOR_NAN**
- specified in the :doc:`gmt.conf` file or on the command line. When
- combined with **-D**, only **COLOR_NAN** is considered.
-
-**-N**
- Do not write out the background, foreground, and NaN-color fields
- [Default will write them].
-
-**-Q**\ [**i**\ \|\ **o**]
- Selects a logarithmic interpolation scheme [Default is linear].
- **-Qi** expects input z-values to be log10(z), assigns colors, and
- writes out z [Default]. **-Qo** takes log10(z) first, assigns
- colors, and writes out z.
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-R.rst_
-
-**-S**\ *zstart/zstop/zinc* or **-S**\ *n*
- Set steps in cpt file. Calculate entries in cpt file from *zstart*
- to *zstop* in steps of (*zinc*). Default chooses arbitrary values by
- a crazy scheme based on equidistant values for a Gaussian CDF.
- Use **-S**\ *n* to select *n* points from such a
- cumulative normal distribution [11].
-
-**-T**\ **-**\ \|\ **+**\ \|\ **\_**\ \|\ **=**
- Force the color table to be symmetric about zero (from -R to +R).
- Append flag to set the range R: **-** for R =\|zmin\|, **+** for R =
- \|zmax\|, **\_** for R = min(\|zmin\|, \|zmax\|), or **=** for R =
- max(\|zmin\|, \|zmax\|).
-
-**-V**
- Verbose operation. This will write CDF(Z) estimates to stderr.
- [Default is silent.]
-
-**-W**
- Do not interpolate the input color table but pick the output colors
- starting at the beginning of the map. This is particularly useful in
- combination with a categorical color table. Cannot be used in
- combination with **-Z**.
-
-**-Z**
- Will create a continuous color palette. [Default is discontinuous,
- i.e., constant color intervals]
-
-.. include:: explain_help.rst_
-
-.. include:: explain_grd_inout.rst_
-
-Examples
---------
-
-Sometimes you don't want to make a cpt file (yet) but would find it
-helpful to know that 90% of your data lie between z1 and z2, something
-you cannot learn from :doc:`grdinfo`. So you can do this to see some points
-on the CDF(Z) curve (use **-V** option to see more):
-
- ::
-
- gmt grd2cpt mydata.nc -V > /dev/null
-
-To make a cpt file with entries from 0 to 200 in steps of 20, and ignore
-data below zero in computing CDF(Z), and use the built-in master cpt
-file relief, run
-
- ::
-
- gmt grd2cpt mydata.nc -Crelief -L0/10000 -S0/200/20 > mydata.cpt
-
-See Also
---------
-
-:doc:`gmt`, :doc:`gmt.conf`,
-:doc:`grdhisteq`, :doc:`grdinfo`, :doc:`makecpt`
diff --git a/doc_release/html/_sources/grd2rgb.txt b/doc_release/html/_sources/grd2rgb.txt
deleted file mode 100644
index 5c21882..0000000
--- a/doc_release/html/_sources/grd2rgb.txt
+++ /dev/null
@@ -1,101 +0,0 @@
-.. index:: ! grd2rgb
-
-*******
-grd2rgb
-*******
-
-.. only:: not man
-
- grd2rgb - Write r/g/b grid files from a grid file, a raw RGB file, or SUN rasterfile
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**grd2rgb** *infile* **-G**\ *template* [ **-C**\ *cptfile* ] [
-**-I**\ *xinc*\ [**m**\ \|\ **s**][/\ *yinc*\ [**m**\ \|\ **s**]] ]
-[ **-L**\ *layer* ]
-|SYN_OPT-R|
-|SYN_OPT-V|
-[ **-W**\ *width*/*height*\ [/*n\_bytes*] ]
-[ **-r** ]
-
-|No-spaces|
-
-Description
------------
-
-**grd2rgb** reads one of three types of input files: (1) A Sun 8-, 24-,
-or 32-bit raster file; we the write out the red, green, and blue
-components (0-255 range) to separate grid files. Since the raster file
-header is limited you may use the **-R**, **-I**, **-r** options to set
-a complete header record [Default is simply based on the number of rows
-and columns]. (2) A binary 2-D grid file; we then convert the z-values
-to red, green, blue via the provided cpt file. Optionally, only write
-out one of the r, g, b, layers. (3) A RGB or RGBA raw raster file. Since
-raw rasterfiles have no header, you have to give the image dimensions
-via the **-W** option.
-
-Required Arguments
-------------------
-
-*infile*
- The (1) Sun raster file, (2) 2-D binary grid file, or (3) raw raster file to be converted.
-**-G**\ *template*
- Provide an output name template for the three output grids. The
- template should be a regular grid file name except it must contain
- the string %c which on output will be replaced by r, g, or b.
-
-Optional Arguments
-------------------
-
-**-C**\ *cptfile*
- name of the color palette table (for 2-D binary input grid only).
-
-.. include:: explain_-I.rst_
-
-**-L**\ *layer*
- Output only the specified layer (r, g, or b). [Default outputs all 3 layers].
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-R.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-W**\ *width*/*height*\ [/*n\_bytes*]
- Sets the size of the raw raster file. By default an RGB file (which
- has 3 bytes/pixel) is assumed. For RGBA files use *n\_bytes* = 4.
- Use **-W** for guessing the image size of a RGB raw file, and
- **-W**\ *=/=/4* if the raw image is of the RGBA type. Notice that
- this might be a bit slow because the guessing algorithm makes uses
- of FFTs.
-
-.. |Add_nodereg| unicode:: 0x20 .. just an invisible code
-.. include:: explain_nodereg.rst_
-
-.. include:: explain_help.rst_
-
-Examples
---------
-
-To use the color palette topo.cpt to create r, g, b component grids from
-hawaii_grv.nc file, use
-
- ::
-
- gmt grd2rgb hawaii_grv.nc -Ctopo.cpt -Ghawaii_grv_%c.nc
-
-To output the red component from the Sun raster radiation.ras file, use
-
- ::
-
- gmt grd2rgb radiation.ras -Lr -Gcomp_%c.nc
-
-See Also
---------
-
-:doc:`gmt`, :doc:`gmt.conf`,
-:doc:`grdedit`, :doc:`grdimage`,
-:doc:`grdmath` , :doc:`grdview`
diff --git a/doc_release/html/_sources/grd2xyz.txt b/doc_release/html/_sources/grd2xyz.txt
deleted file mode 100644
index 9b51583..0000000
--- a/doc_release/html/_sources/grd2xyz.txt
+++ /dev/null
@@ -1,158 +0,0 @@
-.. index:: ! grd2xyz
-
-*******
-grd2xyz
-*******
-
-.. only:: not man
-
- grd2xyz - Convert grid file to data table
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**grd2xyz** *grid* [ **-C**\ [**f**\ \|\ **i**] ] [ **-N**\ [**i**]\ *nodata* ]
-[ |SYN_OPT-R| ]
-[ |SYN_OPT-V| ]
-[ **-W**\ [*weight*] ] [ **-Z**\ [*flags*] ]
-[ |SYN_OPT-bo| ]
-[ |SYN_OPT-f| ]
-[ **-ho**\ [*n*] ]
-[ |SYN_OPT-o| ]
-[ |SYN_OPT-s| ]
-
-|No-spaces|
-
-Description
------------
-
-**grd2xyz** reads one or more binary 2-D grid files and writes out
-xyz-triplets in ASCII [or binary] format to standard output. Modify the
-precision of the ASCII output format by editing the
-:ref:`FORMAT_FLOAT_OUT <FORMAT_FLOAT_OUT>` parameter in your :doc:`gmt.conf` file or use
-**-**\ **-D_FORMAT**\ =\ *format* on the command line, or choose binary
-output using single or double precision storage. As an option you may
-output z-values without the (x,y) coordinates; see **-Z** below.
-
-Required Arguments
-------------------
-
-*grid*
- Names of 2-D binary grid files to be converted. (See GRID FILE
- FORMATS below.)
-
-Optional Arguments
-------------------
-
-**-C**\ [**f**\ \|\ **i**]
- Replace the x- and y-coordinates on output with the corresponding
- column and row numbers. These start at 0 (C-style counting); append
- **f** to start at 1 (Fortran-style counting). Alternatively, append
- **i** to write just the two columns *index* and *z*, where *index*
- is the 1-D indexing that GMT uses when referring to grid nodes.
-
-**-N**\ [**i**]\ *nodata*
- Output this z-value where the latter equals NaN [Default writes NaN].
- Alternatively prepend **i** to do the inverse. That is, to replace the
- *nodata* values in grid with NaN. Useful to use with the **-s** option.
-
-.. |Add_-R| replace:: Using the **-R** option
- will select a subsection of the grid. If this subsection exceeds the
- boundaries of the grid, only the common region will be output.
-.. include:: explain_-R.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-W**\ [*weight*]
- Write out x,y,z,w, where w is the supplied *weight* (or 1 if not
- supplied) [Default writes x,y,z only].
-
-**-Z**\ [*flags*]
- Write a 1-column ASCII [or binary] table. Output will be organized
- according to the specified ordering convention contained in *flags*.
- If data should be written by rows, make *flags* start with
- **T** (op) if first row is y = ymax or
- **B** (ottom) if first row is y = ymin. Then,
- append **L** or **R** to indicate that first element should start at
- left or right end of row. Likewise for column formats: start with
- **L** or **R** to position first column, and then append **T** or
- **B** to position first element in a row. For gridline registered
- grids: If grid is periodic in x but the outcoming data should not
- contain the (redundant) column at x = xmax, append **x**. For grid
- periodic in y, skip writing the redundant row at y = ymax by
- appending **y**. If the byte-order needs to be swapped, append
- **w**. Select one of several data types (all binary except **a**):
-
- * **a** ASCII representation of a single item per record
- * **c** int8_t, signed 1-byte character
- * **u** uint8_t, unsigned 1-byte character
- * **h** int16_t, short 2-byte integer
- * **H** uint16_t, unsigned short 2-byte integer
- * **i** int32_t, 4-byte integer
- * **I** uint32_t, unsigned 4-byte integer
- * **l** int64_t, long (8-byte) integer
- * **L** uint64_t, unsigned long (8-byte) integer
- * **f** 4-byte floating point single precision
- * **d** 8-byte floating point double precision
-
- Default format is scanline orientation of ASCII numbers: **-ZTLa**.
- Note that **-Z** only applies to 1-column output.
-
-.. |Add_-bo| replace:: [Default is 3]. This option
- only applies to xyz output; see **-Z** for z table output.
-.. include:: explain_-bo.rst_
-
-.. |Add_-f| replace:: See also **TIME
- COORDINATES** below. **-h** Output 1 header record based on
- information in the first grid file header. Ignored if binary output
- is selected. [Default is no header].
-.. include:: explain_-f.rst_
-
-.. include:: explain_-ocols.rst_
-
-.. include:: explain_-s.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_precision.rst_
-
-.. include:: explain_grd_inout.rst_
-
-Time Coordinates
-----------------
-
-Time coordinates in netCDF grids, be it the x, y, or z coordinate, will
-be recognized as such. The variable's **unit** attribute is parsed to
-determine the unit and epoch of the time coordinate in the grid. Values
-are then converted to the internal time system specified by
-:ref:`TIME_UNIT <TIME_UNIT>` and :ref:`TIME_EPOCH <TIME_EPOCH>` in the
-:doc:`gmt.conf` file or on the
-command line. The default output is relative time in that time system,
-or absolute time when using the option **-f0T**, **-f1T**, or **-f2T**
-for x, y, or z coordinate, respectively.
-
-Examples
---------
-
-To edit individual values in the 5' by 5' hawaii_grv.nc file, dump the .nc to ASCII:
-
- ::
-
- gmt grd2xyz hawaii_grv.nc > hawaii_grv.xyz
-
-To write a single precision binary file without the x,y positions from
-the file raw_data.nc file, using scanline orientation, run
-
- ::
-
- gmt grd2xyz raw_data.nc -ZTLf > hawaii_grv.b
-
-See Also
---------
-
-:doc:`gmt.conf`, :doc:`gmt`,
-:doc:`grdedit`, :doc:`grdreformat`,
-:doc:`xyz2grd`
diff --git a/doc_release/html/_sources/grdblend.txt b/doc_release/html/_sources/grdblend.txt
deleted file mode 100644
index d6b554b..0000000
--- a/doc_release/html/_sources/grdblend.txt
+++ /dev/null
@@ -1,172 +0,0 @@
-.. index:: ! grdblend
-
-********
-grdblend
-********
-
-.. only:: not man
-
- grdblend - Blend several partially over-lapping grids into one large grid
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**grdblend** [ *blendfile* \| *grid1* *grid2* ... ] **-G**\ *outgrid*
-[ |SYN_OPT-I| ]
-[ |SYN_OPT-R| ]
-[ **-C**\ **f**\ \|\ **l**\ \|\ **o**\ \|\ **u** ] [ **-N**\ *nodata* ]
-[ **-Q** ] [ **-Z**\ *scale* ]
-[ |SYN_OPT-V| ]
-[ **-W** ]
-[ |SYN_OPT-f| ]
-[ **-r** ]
-
-|No-spaces|
-
-Description
------------
-
-**grdblend** reads a listing of grid files and blend parameters and
-creates a binary grid file by blending the other grids using
-cosine-taper weights. **grdblend** will report if some of the nodes are
-not filled in with data. Such unconstrained nodes are set to a value
-specified by the user [Default is NaN]. Nodes with more than one value
-will be set to the weighted average value. Any input grid that does not
-share the final output grid's node registration and grid spacing will
-automatically be resampled via calls to grdsample. Note: Due to the
-row-by-row i/o nature of operations in grdblend we only support the
-netCDF and native binary grid formats for both input and output.
-
-Required Arguments
-------------------
-
-**-G**\ *outgrid*
- *outgrid* is the name of the binary output grid file. (See GRID FILE
- FORMATS below). Only netCDF and native binary grid formats are can
- be written directly. Other output format choices will be handled by
- reformatting the output once blending is complete.
-
-.. include:: explain_-I.rst_
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-R.rst_
-
-Optional Arguments
-------------------
-
-*blendfile*
- ASCII file with one record per grid file to include in the blend.
- Each record may contain up to three items, separated by spaces or tabs:
- the gridfile name (required), the **-R**-setting for the interior region
- (optional), and the relative weight *wr* (optional). In the combined weighting scheme, this
- grid will be given zero weight outside its domain, weight = *wr*
- inside the interior region, and a 2-D cosine-tapered weight between
- those end-members in the boundary strip. However, if a negative *wr*
- is given then the sense of tapering is inverted (i.e., zero weight
- inside its domain). If the inner region should instead exactly match
- the grid region then specify a - instead of the **-R**-setting, or
- leave it off entirely. Likewise, if a weight *wr* is not specified
- we default to a weight of 1. If the ASCII *blendfile* file is not
- given **grdblend** will read standard input. Alternatively, if you
- have more than one grid file to blend and you wish (a) all input
- grids to have the same weight (1) and (b) all grids
- should use their actual region as the interior region, then you may simply
- list all the grids on the command line instead of providing a
- *blendfile*. You must specify at least 2 input grids for this
- mechanism to work. Any grid that is not co-registered with the
- desired output layout implied by **-R**, **-I** (and **-r**) will
- first be resampled via **grdsample**. Also, grids that are not in
- netCDF or native binary format will first be reformatted via
- **grdreformat**.
-
-**-C**
- Clobber mode: Instead of blending, simply pick the value of one of
- the grids that covers a node. Select from the following modes: **f**
- for the first grid to visit a node; **o** for the last grid to visit
- a node; **l** for the grid with the lowest value, and **u** for the
- grid with the uppermost value. For modes **f** and **o** the
- ordering of grids in the *blendfile* will dictate which grid
- contributes to the final result. Weights and cosine tapering are not
- considered when clobber mode is active.
-
-**-N**\ *nodata*
- No data. Set nodes with no input grid to this value [Default is NaN].
-
-**-Q**
- Create a header-less grid file suitable for use with **grdraster**.
- Requires that the output grid file is a native format (i.e., not netCDF).
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-W**
- Do not blend, just output the weights used for each node. This
- option is valid when only one input grid is provided [Default makes the blend].
-
-**-Z**\ *scale*
- Scale output values by *scale* before writing to file. [1].
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_nodereg| unicode:: 0x20 .. just an invisible code
-.. include:: explain_nodereg.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_grd_output.rst_
-
-.. include:: explain_grd_coord.rst_
-
-
-Tapering
---------
-
-While the weights computed are tapered from 1 to 0, we are computing weighted
-averages, so if there is only a single grid given then the weighted output
-will be identical to the input. If you are looking for a way to taper your
-data grid, see grdmath's TAPER operator.
-
-Examples
---------
-
-To create a grid file from the four grid files piece\_?.nc, giving them each the different
-weights, make the blendfile like this
-
- ::
-
- piece_1.nc -R<subregion_1> 1
- piece_2.nc -R<subregion_2> 1.5
- piece_3.nc -R<subregion_3> 0.9
- piece_4.nc -R<subregion_4> 1
-
-Then run
-
- ::
-
- gmt grdblend blend.job -Gblend.nc -R<full_region> -I<dx/dy> -V
-
-To blend all the grids called MB\_\*.nc given them all equal weight, try
-
- ::
-
- gmt grdblend MB_*.nc -Gblend.nc -R<full_region> -I<dx/dy> -V
-
-Warning on large file sets
---------------------------
-
-While grdblend can process any number of files, it works by keeping those
-files open that are being blended, and close files as soon as they are finished.
-Depending on your session, many files may remain open at the same time.
-Some operating systems set fairly modest
-default limits on how many concurrent files can be open, e.g., 256. If you
-run into this problem then you can change this limit; see your operating system
-documentation for how to change system limits.
-
-See Also
---------
-
-:doc:`gmt`, :doc:`grd2xyz`,
-:doc:`grdedit` :doc:`grdraster`
diff --git a/doc_release/html/_sources/grdclip.txt b/doc_release/html/_sources/grdclip.txt
deleted file mode 100644
index 0b0890d..0000000
--- a/doc_release/html/_sources/grdclip.txt
+++ /dev/null
@@ -1,94 +0,0 @@
-.. index:: ! grdclip
-
-*******
-grdclip
-*******
-
-.. only:: not man
-
- grdclip - Clip the range of grids
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**grdclip** *ingrid* **-G**\ *outgrid*
-[ |SYN_OPT-R| ]
-[ **-Sa**\ *high/above* ]
-[ **-Sb**\ *low/below* ] [ **-Si**\ *low/high/between* ] [ **-Sr**\ *old/new* ]
-[ |SYN_OPT-V| ]
-
-|No-spaces|
-
-Description
------------
-
-**grdclip** will set values < *low* to *below* and/or values > *high* to
-*above*. You can also specify one or more intervals where all values should be
-set to IT(between), or replace individual values. Such operations are useful
-when you want all of a continent or an ocean to fall
-into one color or gray shade in image processing, when clipping of the
-range of data values is required, or for reclassification of data values.
-*above*, *below*, *between*, *old* and *new* can be any number or even NaN
-(Not a Number). You must choose at least one of the **-S** options. Use
-**-R** to only extract a subset of the *ingrid* file.
-
-Required Arguments
-------------------
-
-*ingrid*
- The input 2-D binary grid file.
-
-**-G**\ *outgrid*
- *outgrid* is the modified output grid file.
-
-Optional Arguments
-------------------
-
-.. |Add_-R| replace:: Using the **-R** option
- will select a subsection of *ingrid* grid. If this subsection
- exceeds the boundaries of the grid, only the common region will be extracted.
-.. include:: explain_-R.rst_
-
-**-Sa**\ *high/above*
- Set all data[i] > *high* to *above*.
-**-Sb**\ *low/below*
- Set all data[i] < *low* to *below*.
-**-Si**\ *low/high/between*
- Set all data[i] >= *low* and <= *high* to *between*.
- Repeat the option for as many intervals as are needed.
-**-Sr**\ *old/new*
- Set all data[i] == *old* to *new*. This is mostly useful when
- your data are known to be integer values. Repeat the option
- for as many replacements as are needed.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_grd_inout.rst_
-
-Examples
---------
-
-To set all values > 70 to NaN and all values < 0 to 0 in file data.nc:
-
- ::
-
- gmt grdclip data.nc -Gnew_data.nc -Sa70/NaN -Sb0/0 -V
-
-To reclassify all values in the 25-30 range to 99, those in 35-39 to 55,
-exchange 17 for 11 and all values < 10 to 0 in file classes.nc, try
-
- ::
-
- gmt grdclip classes.nc -Gnew_classes.nc -Si25/30/99 -Si35/39/55 -Sr17/11 -Sb10/0 -V
-
-See Also
---------
-
-:doc:`gmt`, :doc:`grdlandmask`,
-:doc:`grdmask`, :doc:`grdmath`,
-:doc:`grd2xyz`, :doc:`xyz2grd`
diff --git a/doc_release/html/_sources/grdcontour.txt b/doc_release/html/_sources/grdcontour.txt
deleted file mode 100644
index b2259ff..0000000
--- a/doc_release/html/_sources/grdcontour.txt
+++ /dev/null
@@ -1,252 +0,0 @@
-.. index:: ! grdcontour
-
-**********
-grdcontour
-**********
-
-.. only:: not man
-
- grdcontour - Make contour map using a grid
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**grdcontour** *grid* **-C**\ [+]\ *cont_int*\ \|\ *cpt*
-**-J**\ *parameters* [ **-A**\ [**-**\ \|\ [+]\ *annot_int*][*labelinfo*] ]
-[ |SYN_OPT-B| ]
-[ **-D**\ *<template>* ]
-[ **-F**\ [**l**\ \|\ **r**] ]
-[ **-G**\ [**d**\ \|\ **f**\ \|\ **n**\ \|\ **l**\ \|\ **L**\ \|\ **x**\ \|\ **X**]\ *params* ]
-[ **-Jz**\ \|\ **Z**\ *parameters* ] [ **-K** ] [ **-L**\ *low/high* ]
-[ **-O** ] [ **-P** ] [ **-Q**\ *cut* ]
-[ |SYN_OPT-Rz| ]
-[ **-S**\ *smoothfactor* ]
-[ **-T**\ [**+\|-**][*gap/length*][\ **:**\ [*labels*]] ]
-[ |SYN_OPT-U| ]
-[ |SYN_OPT-V| ]
-[ **-W**\ [**+**][*type*]\ *pen* ]
-[ |SYN_OPT-X| ]
-[ |SYN_OPT-Y| ]
-[ **-Z**\ [*factor*\ [/*shift*]][**p**] ]
-[ |SYN_OPT-bo| ]
-[ |SYN_OPT-c| ]
-[ **-ho**\ [*n*] ]
-[ |SYN_OPT-p| ]
-[ |SYN_OPT-t| ]
-
-|No-spaces|
-
-Description
------------
-
-**grdcontour** reads a 2-D grid file and produces a contour map by
-tracing each contour through the grid. PostScript code is generated
-and sent to standard output. Various options that affect the plotting
-are available. Alternatively, the x/y/z positions of the contour lines
-may be saved to one or more output files (or stdout) and no plot is produced.
-
-Required Arguments
-------------------
-
-*grid*
- 2-D gridded data set to be contoured. (See GRID FILE FORMATS below).
-
-**-C**\ [+]\ *cont_int*
- The contours to be drawn may be specified in one of three possible ways:
-
- (1) If *cont_int* has the suffix ".cpt" and can be opened as a
- file, it is assumed to be a color palette table. The color
- boundaries are then used as contour levels. If the cpt-file has
- annotation flags in the last column then those contours will be
- annotated. By default all contours are labeled; use **-A-** to
- disable all annotations.
-
- (2) If *cont_int* is a file but not a cpt-file, it is expected to
- contain contour levels in column 1 and a
- C(ontour) OR A(nnotate) in
- col 2. The levels marked C (or c) are contoured, the levels marked A
- (or a) are contoured and annotated. Optionally, a third column may
- be present and contain the fixed annotation angle for this contour
- level.
-
- (3) If no file is found, then *cont_int* is interpreted as a
- constant contour interval. However, if prepended with the + sign the
- *cont_int* is taken as meaning draw that single contour. The **-A**
- option offers the same possibility so they may be used together to
- plot only one annotated and one non-annotated contour.
- If **-A** is set and **-C** is not, then the contour interval is set
- equal to the specified annotation interval.
-
- If a file is given and **-T** is set, then only contours marked with
- upper case C or A will have tickmarks. In all cases the contour
- values have the same units as the grid.
-
-.. include:: explain_-J.rst_
-
-Optional Arguments
-------------------
-
-**-A**\ [**-**\ \|\ [+]\ *annot_int*][*labelinfo*]
- *annot_int* is annotation interval in data units; it is ignored if
- contour levels are given in a file. [Default is no annotations]. Append
- **-** to disable all annotations implied by **-C**. Alternatively prepend
- + to the annotation interval to plot that as a single contour. The optional
- *labelinfo* controls the specifics of the label formatting and consists
- of a concatenated string made up of any of the following control arguments:
-
-.. include:: explain_clabelinfo.rst_
-
-.. include:: explain_-B.rst_
-
-**-D**\ *<template>*
- Dump contours as data line segments; no plotting takes place.
- Append filename template which may contain C-format specifiers.
- If no filename template is given we write all lines to stdout.
- If filename has no specifiers then we write all lines to a single file.
- If a float format (e.g., %6.2f) is found we substitute the contour z-value.
- If an integer format (e.g., %06d) is found we substitute a running segment count.
- If an char format (%c) is found we substitute C or O for closed and open contours.
- The 1-3 specifiers may be combined and appear in any order to produce the
- the desired number of output files (e.g., just %c gives two files, just %f would.
- separate segments into one file per contour level, and %d would write all segments.
- to individual files; see manual page for more examples.
-
-**-F**\ [**l**\ \|\ **r**]
- Force dumped contours to be oriented so that higher z-values are to the
- left (**-Fl** [Default]) or right (**-Fr**) as we move along the contour
- [Default is arbitrary orientation]. Requires **-D**.
-
-**-G**\ [**d**\ \|\ **f**\ \|\ **n**\ \|\ **l**\ \|\ **L**\ \|\ **x**\ \|\ **X**]\ *params*
-
-.. include:: explain_contlabel.rst_
-
-.. include:: explain_-Jz.rst_
-
-.. include:: explain_-K.rst_
-
-**-L**\ *low/high*
- Limit range: Do not draw contours for data values below *low* or
- above *high*.
-
-.. include:: explain_-O.rst_
-
-.. include:: explain_-P.rst_
-
-**-Q**\ *cut*
- Do not draw contours with less than *cut* number of points [Draw all contours].
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-R.rst_
-
-.. |Add_-Rz| replace:: [Default is region defined in the grid file].
-.. include:: explain_-Rz.rst_
-
-**-S**\ *smoothfactor*
- Used to resample the contour lines at roughly every
- (gridbox_size/*smoothfactor*) interval.
-**-T**\ [**+\|-**\ ][*gap/length*][\ **:**\ [*labels*]]
- Will draw tickmarks pointing in the downward direction every *gap*
- along the innermost closed contours. Append *gap* and tickmark
- length (append units as **c**, **i**, or **p**) or use defaults
- [15\ **p**/3\ **p**]. User may choose to tick only local highs or local
- lows by specifying **-T+** or **-T-**, respectively. Append
- **:**\ *labels* to annotate the centers of closed innermost contours
- (i.e, the local lows and highs). If no *labels* is appended we use -
- and + as the labels. Appending two characters, **:LH**, will plot
- the two characters (here, L and H) as labels. For more elaborate
- labels, separate the two label strings by a comma (e.g.,
- **:**\ *lo*,\ *hi*). If a file is given by **-C** and **-T** is set,
- then only contours marked with upper case C or A will have tickmarks
- [and annotation].
-
-.. include:: explain_-U.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-W**\ [**+**][*type*]\ *pen* :ref:`(more ...) <set-pens>`
- *type*, if present, can be **a** for annotated contours or **c** for
- regular contours [Default]. *pen* sets the attributes for the
- particular line. Default pen for annotated contours: 0.75p,black.
- Regular contours use pen 0.25p,black. If the **+** flag is prepended
- then the color of the contour lines are taken from the cpt file (see
- **-C**). If the **-** flag is prepended then the color from the cpt
- file is applied both to the contours and the contour annotations.
-
-.. include:: explain_-XY.rst_
-
-**-Z**\ [*factor*\ [/*shift*]][**p**]
- Use to subtract *shift* from the data and multiply the results by
- *factor* before contouring starts [1/0]. (Numbers in **-A**, **-C**,
- **-L** refer to values after this scaling has occurred.) Append
- **p** to indicate that this grid file contains z-values that are
- periodic in 360 degrees (e.g., phase data, angular distributions)
- and that special precautions must be taken when determining
- 0-contours.
-
-.. |Add_-bo| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-bo.rst_
-
-.. include:: explain_-c.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. |Add_perspective| unicode:: 0x20 .. just an invisible code
-.. include:: explain_perspective.rst_
-
-.. include:: explain_-t.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_precision.rst_
-
-.. include:: explain_grd_inout.rst_
-
-Examples
---------
-
-To contour the file hawaii_grav.nc every 25 mGal on a Mercator map at
-0.5 inch/degree, annotate every 50 mGal (using fontsize = 10p), using 1
-degree tickmarks, and draw 30 minute gridlines:
-
- ::
-
- gmt grdcontour hawaii_grav.nc -Jm0.5i -C25 -A50+f10p -B1g30m > hawaii_grav.ps
-
-To contour the file image.nc using the levels in the file cont.d on a
-linear projection at 0.1 cm/x-unit and 50 cm/y-unit, using 20 (x) and
-0.1 (y) tickmarks, smooth the contours a bit, use "RMS Misfit" as
-plot-title, use a thick red pen for annotated contours, and a thin,
-dashed, blue pen for the rest, and send the output to the default printer:
-
- ::
-
- gmt grdcontour image.nc -Jx0.1c/50.0c -Ccont.d -S4 -B20/0.1:."RMS \
- Misfit":-Wathick,red -Wcthinnest,blue,- | lp
-
-The labeling of local highs and lows may plot outside the innermost
-contour since only the mean value of the contour coordinates is used to
-position the label.
-
-To save the smoothed 100-m contour lines in topo.nc and separate them
-into two multisegment files: contours_C.txt for closed and
-contours_O.txt for open contours, try
-
- ::
-
- gmt grdcontour topo.nc -C100 -S4 -Dcontours_%c.txt
-
-See Also
---------
-
-:doc:`gmt`, :doc:`gmt.conf`,
-:doc:`gmtcolors`,
-:doc:`psbasemap`,
-:doc:`grdimage`, :doc:`grdview`,
-:doc:`pscontour`
diff --git a/doc_release/html/_sources/grdcut.txt b/doc_release/html/_sources/grdcut.txt
deleted file mode 100644
index d790184..0000000
--- a/doc_release/html/_sources/grdcut.txt
+++ /dev/null
@@ -1,118 +0,0 @@
-.. index:: ! grdcut
-
-******
-grdcut
-******
-
-.. only:: not man
-
- grdcut - Extract subregion from a grid
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**grdcut** *ingrid* **-G**\ *outgrid*
-|SYN_OPT-R|
-[ **-N**\ [*nodata*] ]
-[ **-S**\ [**n**]\ *lon/lat/radius*\ [*unit*] ]
-[ |SYN_OPT-V| ]
-[ **-Z**\ [\ **n**\ \|\ **r**]\ *min/max* ]
-[ |SYN_OPT-f| ]
-
-|No-spaces|
-
-Description
------------
-
-**grdcut** will produce a new *outgrid* file which is a subregion of
-*ingrid*. The subregion is specified with **-R** as in other programs;
-the specified range must not exceed the range of *ingrid* (but see **-N**).
-If in doubt, run **grdinfo** to check range. Alternatively, define the subregion
-indirectly via a range check on the node values or via distances from a
-given point. Complementary to **grdcut** there is **grdpaste**, which
-will join together two grid files along a common edge.
-
-Required Arguments
-------------------
-
-*ingrid*
- This is the input grid file.
-
-**-G**\ *outgrid*
- This is the output grid file.
-
-Optional Arguments
-------------------
-
-**-N**\ [*nodata*]
- Allow grid to be extended if new **-R** exceeds existing boundaries.
- Append *nodata* value to initialize nodes outside current region [Default is NaN].
-
-.. |Add_-R| replace:: This defines the subregion to be cut out.
-.. include:: explain_-R.rst_
-
-**-S**\ [**n**]\ *lon/lat/radius*\ [*unit*]
- Specify an origin and radius; append a distance unit (see UNITS) and
- we determine the corresponding rectangular region so that all grid
- nodes on or inside the circle are contained in the subset. If
- **-Sn** is used we set all nodes outside the circle to NaN.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-Z**\ [\ **n**\ \|\ **r**]\ *min/max*
- Determine the new rectangular region so that all nodes *outside* this
- region are also outside the given *z*-range [-inf/+inf]. To indicate
- no limit on min or max, specify a hyphen (-). Normally, any NaNs
- encountered are simply skipped and not considered in the decision.
- Use **-Zn** to consider a NaN to be outside the *z*-range. This means
- the new subset will be NaN-free. Alternatively, use **-Zr** to
- consider NaNs to be within the data range. In this case we stop
- shrinking the boundaries once a NaN is found [Default simply skips NaNs
- when making the range decision].
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_distunits.rst_
-
-.. include:: explain_grd_inout.rst_
-
-.. include:: explain_grd_coord.rst_
-
-Examples
---------
-
-Suppose you have used **surface** to grid ship gravity in the region
-between 148E - 162E and 8N - 32N, and you do not trust the gridding near
-the edges, so you want to keep only the area between 150E - 160E and 10N - 30N, then:
-
- ::
-
- gmt grdcut grav_148_162_8_32.nc -Ggrav_150_160_10_30.nc -R150/160/10/30 -V
-
-To return the subregion of a grid such that any boundary strips where
-all values are entirely above 0 are excluded, try
-
- ::
-
- gmt grdcut bathy.nc -Gtrimmed_bathy.nc -Z-/0 -V
-
-To return the subregion of a grid that contains all nodes within a
-distance of 500 km from the point 45,30 try
-
- ::
-
- gmt grdcut bathy.nc -Gsubset_bathy.nc -S45/30/500k -V
-
-`See Also <#toc10>`_
---------------------
-
-:doc:`gmt`,
-:doc:`grdclip`,
-:doc:`grdpaste`,
-:doc:`grdinfo`
diff --git a/doc_release/html/_sources/grdedit.txt b/doc_release/html/_sources/grdedit.txt
deleted file mode 100644
index ff81bd6..0000000
--- a/doc_release/html/_sources/grdedit.txt
+++ /dev/null
@@ -1,141 +0,0 @@
-.. index:: ! grdedit
-
-*******
-grdedit
-*******
-
-.. only:: not man
-
- grdedit - Modify header or content of a grid
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**grdedit** *grid* [ **-A** ]
-[ **-D**\ *xname*/*yname*/*zname*/*scale*/*offset*/*invalid*/*title*/*remark* ]
-[ **-E** ] [ **-N**\ *table* ]
-[ |SYN_OPT-R| ]
-[ **-S** ] [ **-T** ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-bi| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**grdedit** reads the header information in a binary 2-D grid file and
-replaces the information with values provided on the command line [if
-any]. As an option, global, geographical grids (with 360 degrees
-longitude range) can be rotated in the east-west direction, and
-individual nodal values can be replaced from a table of *x*, *y*, *z*
-values. **grdedit** only operates on files containing a grdheader. Note:
-If it is important to retain the original data you should work on a copy
-of that file.
-
-Required Arguments
-------------------
-
-*grid*
- Name of the 2-D grid file to modify. (See GRID FILE FORMATS below).
-
-Optional Arguments
-------------------
-
-**-A**
- If necessary, adjust the file's *x_inc*, *y_inc* to be compatible
- with its domain (or a new domain set with **-R**). Older grid files
- (i.e., created prior to GMT 3.1) often had excessive slop in
- *x_inc*, *y_inc* and an adjustment is necessary. Newer files are
- created correctly.
-
-.. include:: explain_-D_cap.rst_
-
-**-E**
- Transpose the grid and exchange the *x* and *y* information.
- Incompatible with the other options.
-**-N**\ *table*
- Read the ASCII (or binary; see **-bi**) file
- *table* and replace the corresponding nodal values in the grid with
- these *x*,\ *y*,\ *z* values.
-
-.. |Add_-R| replace:: The new w/e/s/n values will
- replace those in the grid, and the *x\_inc*, *y\_inc* values are
- adjusted, if necessary.
-.. include:: explain_-R.rst_
-
-**-S**
- For global, geographical grids only. Grid values will be shifted
- longitudinally according to the new borders given in **-R**.
-**-T**
- Make necessary changes in the header to convert a
- gridline-registered grid to a pixel-registered grid, or vice-versa.
- Basically, gridline-registered grids will have their domain extended
- by half the x- and y-increments whereas pixel-registered grids will
- have their domain shrunk by the same amount.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. |Add_-bi| replace:: [Default is 3 input columns].
-.. include:: explain_-bi.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_grd_inout.rst_
-
-.. include:: explain_grd_coord.rst_
-
-Examples
---------
-
-Let us assume the file data.nc covers the area 300/310/10/30. We want to
-change the boundaries from geodetic longitudes to geographic and put a
-new title in the header. We accomplish this by
-
- ::
-
- gmt grdedit data.nc -R-60/-50/10/30 -D//////"Gravity Anomalies"
-
-The grid world.nc has the limits 0/360/-72/72. To shift the data so that
-the limits would be -180/180/-72/72, use
-
- ::
-
- gmt grdedit world.nc -R-180/180/-72/72 -S
-
-The file junk.nc was created prior to GMT 3.1 with incompatible
-**-R** and **-I** arguments. To reset the x- and y-increments we run
-
- ::
-
- gmt grdedit junk.nc -A
-
-The file junk.nc was created prior to GMT 4.1.3 and does not contain
-the required information to indicate that the grid is geographic. To add
-this information, run
-
- ::
-
- gmt grdedit junk.nc -fg
-
-See Also
---------
-
-:doc:`gmt`,
-:doc:`grd2xyz`,
-:doc:`grdinfo`
-:doc:`xyz2grd`
diff --git a/doc_release/html/_sources/grdfft.txt b/doc_release/html/_sources/grdfft.txt
deleted file mode 100644
index 649dd24..0000000
--- a/doc_release/html/_sources/grdfft.txt
+++ /dev/null
@@ -1,217 +0,0 @@
-.. index:: ! grdfft
-
-******
-grdfft
-******
-
-.. only:: not man
-
- grdfft - Do mathematical operations on grids in the wavenumber (or frequency) domain
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**grdfft** *ingrid* [ *ingrid2* ] **-G**\ *outfile* [ **-A**\ *azimuth* ]
-[ **-C**\ *zlevel* ] [ **-D**\ [*scale*\ \|\ **g**] ]
-[ **-E**\ [**r**\ \|\ **x**\ \|\ **y**][\ **w**\ [**k**]] ]
-[ **-F**\ [**r**\ \|\ **x**\ \|\ **y**]\ *params* ]
-[ **-I**\ [*scale*\ \|\ **g**] ]
-[ **-N**\ [**f**\ \|\ **q**\ \|\ **s**\ \|\ *nx/ny*][\ **+a**\ \|\ **d**\ \|\ **h**\ \|\ **l**][\ **+e**\ \|\ **n**\ \|\ **m**][\ **+t**\ *width*][\ **+w**\ [*suffix*]][\ **+z**\ [**p**]] ]
-[ **-S**\ *scale* ]
-[ |SYN_OPT-V| ]
-[ **-fg** ]
-
-|No-spaces|
-
-Description
------------
-
-**grdfft** will take the 2-D forward Fast Fourier Transform and perform
-one or more mathematical operations in the frequency domain before
-transforming back to the space domain. An option is provided to scale
-the data before writing the new values to an output file. The horizontal
-dimensions of the grid are assumed to be in meters. Geographical grids
-may be used by specifying the **-fg** option that scales degrees to
-meters. If you have grids with dimensions in km, you could change this
-to meters using :doc:`grdedit` or scale the output with :doc:`grdmath`.
-
-Required Arguments
-------------------
-
-*ingrid*
- 2-D binary grid file to be operated on. (See GRID FILE FORMATS
- below). For cross-spectral operations, also give the second grid
- file *ingrd2*.
-**-G**\ *outfile*
- Specify the name of the output grid file or the 1-D spectrum table
- (see **-E**). (See GRID FILE FORMATS below).
-
-Optional Arguments
-------------------
-
-**-A**\ *azimuth*
- Take the directional derivative in the *azimuth* direction measured
- in degrees CW from north.
-
-**-C**\ *zlevel*
- Upward (for *zlevel* > 0) or downward (for *zlevel* < 0) continue
- the field *zlevel* meters.
-
-**-D**\ [*scale*\ \|\ **g**]
- Differentiate the field, i.e., take d(field)/dz. This is equivalent
- to multiplying by kr in the frequency domain (kr is radial wave
- number). Append a scale to multiply by (kr \* *scale*) instead.
- Alternatively, append **g** to indicate that your data are geoid
- heights in meters and output should be gravity anomalies in mGal.
- [Default is no scale].
-
-**-E**\ [**r**\ \|\ **x**\ \|\ **y**][\ **w**\ [**k**]]
- Estimate power spectrum in the radial direction [**r**\ ]. Place
- **x** or **y** immediately after **-E** to compute the spectrum in
- the x or y direction instead. No grid file is created. If one grid
- is given then f (i.e., frequency or wave number), power[f],
- and 1 standard deviation in power[f] are written to the file set by
- **-G** [stdout]. If two grids are given we write f and 8 quantities:
- Xpower[f], Ypower[f], coherent power[f], noise power[f], phase[f],
- admittance[f], gain[f], coherency[f]. Each quantity is followed by
- its own 1-std dev error estimate, hence the output is 17 columns wide.
- Append **w** to write wavelength instead of frequency. If your grid
- is geographic you may further append **k** to scale wavelengths from
- meter [Default] to km.
-
-**-F**\ [**r**\ \|\ **x**\ \|\ **y**]\ *params*
- Filter the data. Place **x** or **y** immediately after **-F** to
- filter *x* or *y* direction only; default is isotropic [**r**\ ].
- Choose between a cosine-tapered band-pass, a Gaussian band-pass
- filter, or a Butterworth band-pass filter.
-
- Cosine-taper:
- Specify four wavelengths *lc*/*lp*/*hp*/*hc* in correct units (see **-fg**)
- to design a bandpass filter: wavelengths greater than *lc* or less
- than *hc* will be cut, wavelengths greater than *lp* and less than
- *hp* will be passed, and wavelengths in between will be
- cosine-tapered. E.g., **-F**\ 1000000/250000/50000/10000 **-fg**
- will bandpass, cutting wavelengths > 1000 km and < 10 km, passing
- wavelengths between 250 km and 50 km. To make a highpass or lowpass
- filter, give hyphens (-) for *hp*/*hc* or *lc*/*lp*. E.g.,
- **-Fx**-/-/50/10 will lowpass *x*, passing wavelengths > 50 and
- rejecting wavelengths < 10. **-Fy**\ 1000/250/-/- will highpass *y*,
- passing wavelengths < 250 and rejecting wavelengths > 1000.
- Gaussian band-pass:
- Append *lo*/*hi*, the two wavelengths in correct units
- (see **-fg**) to design a bandpass filter. At the given wavelengths
- the Gaussian filter weights will be 0.5. To make a highpass or
- lowpass filter, give a hyphen (-) for the *hi* or *lo* wavelength,
- respectively. E.g., **-F**-/30 will lowpass the data using a
- Gaussian filter with half-weight at 30, while **-F**\ 400/- will
- highpass the data.
- Butterworth band-pass:
- Append *lo*/*hi*/*order*,
- the two wavelengths in correct units (see **-fg**) and the filter
- order (an integer) to design a bandpass filter. At the given
- wavelengths the Butterworth filter weights will be 0.5. To make a
- highpass or lowpass filter, give a hyphen (-) for the *hi* or *lo*
- wavelength, respectively. E.g., **-F**-/30/2 will lowpass the data
- using a 2nd-order Butterworth filter, with half-weight at 30, while
- **-F**\ 400/-/2 will highpass the data.
-
-**-I**\ [*scale*\ \|\ **g**]
- Integrate the field, i.e., compute integral\_over\_z (field \* dz).
- This is equivalent to divide by kr in the frequency domain (kr is
- radial wave number). Append a scale to divide by (kr \* *scale*)
- instead. Alternatively, append **g** to indicate that your data set
- is gravity anomalies in mGal and output should be geoid heights in
- meters. [Default is no scale].
-
-.. include:: explain_fft.rst_
-
-**-S**\ *scale*
- Multiply each element by *scale* in the space domain (after the
- frequency domain operations). [Default is 1.0].
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-fg**
- Geographic grids (dimensions of longitude, latitude) will be converted to
- meters via a "Flat Earth" approximation using the current ellipsoid parameters.
-
-.. include:: explain_help.rst_
-
-.. include:: explain_grd_inout.rst_
-
-Grid Distance Units
--------------------
-
-If the grid does not have meter as the horizontal unit, append **+u**\ *unit* to the input file name to convert from the
-specified unit to meter. If your grid is geographic, convert distances to meters by supplying **-fg** instead.
-
-Considerations
---------------
-
-netCDF COARDS grids will automatically be recognized as geographic. For
-other grids geographical grids were you want to convert degrees into
-meters, select **-fg**. If the data are close to either pole, you should
-consider projecting the grid file onto a rectangular coordinate system
-using :doc:`grdproject`
-
-Examples
---------
-
-To upward continue the sea-level magnetic anomalies in the file
-mag_0.nc to a level 800 m above sealevel:
-
- ::
-
- gmt grdfft mag_0.nc -C800 -V -Gmag_800.nc
-
-To transform geoid heights in m (geoid.nc) on a geographical grid to
-free-air gravity anomalies in mGal:
-
- ::
-
- gmt grdfft geoid.nc -Dg -V -Ggrav.nc
-
-To transform gravity anomalies in mGal (faa.nc) to deflections of the
-vertical (in micro-radians) in the 038 direction, we must first
-integrate gravity to get geoid, then take the directional derivative,
-and finally scale radians to micro-radians:
-
- ::
-
- gmt grdfft faa.nc -Ig -A38 -S1e6 -V -Gdefl_38.nc
-
-Second vertical derivatives of gravity anomalies are related to the
-curvature of the field. We can compute these as mGal/m^2 by
-differentiating twice:
-
- ::
-
- gmt grdfft gravity.nc -D -D -V -Ggrav_2nd_derivative.nc
-
-To compute cross-spectral estimates for co-registered bathymetry and
-gravity grids, and report result as functions of wavelengths in km, try
-
- ::
-
- gmt grdfft bathymetry.nc gravity.grd -Ewk -fg -V > cross_spectra.txt
-
-To examine the pre-FFT grid after detrending, point-symmetry reflection,
-and tapering has been applied, as well as saving the real and imaginary
-components of the raw spectrum of the data in topo.nc, try
-
- ::
-
- gmt grdfft topo.nc -N+w+z -fg -V
-
-You can now make plots of the data in topo_taper.nc, topo_real.nc, and topo_imag.nc.
-
-See Also
---------
-
-:doc:`gmt`, :doc:`grdedit`,
-:doc:`grdfilter`,
-:doc:`grdmath`,
-:doc:`grdproject`
diff --git a/doc_release/html/_sources/grdfilter.txt b/doc_release/html/_sources/grdfilter.txt
deleted file mode 100644
index b6fb2d3..0000000
--- a/doc_release/html/_sources/grdfilter.txt
+++ /dev/null
@@ -1,210 +0,0 @@
-.. index:: ! grdfilter
-
-*********
-grdfilter
-*********
-
-.. only:: not man
-
- grdfilter - Filter a grid in the space (or time) domain
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**grdfilter** *ingrid* **-D**\ *distance\_flag*
-**-Fx**\ *width*\ [/*width2*][*mode*][\ **+q**\ *quantile*]
-**-G**\ *outgrid*
-[ |SYN_OPT-I| ]
-[ **-N**\ **i**\ \|\ **p**\ \|\ **r** ]
-[ |SYN_OPT-R| ] [ **-T** ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-f| ]
-
-|No-spaces|
-
-Description
------------
-
-**grdfilter** will filter a *.nc* file in the time domain using one of
-the selected convolution or non-convolution isotropic or rectangular
-filters and compute distances using Cartesian or Spherical geometries.
-The output *.nc* file can optionally be generated as a sub-region of the
-input (via **-R**) and/or with new increment (via **-I**) or
-registration (via **-T**). In this way, one may have "extra space" in
-the input data so that the edges will not be used and the output can be
-within one-half- width of the input edges. If the filter is low-pass,
-then the output may be less frequently sampled than the input.
-
-Required Arguments
-------------------
-
-*ingrid*
- The grid file of points to be filtered. (See GRID FILE FORMATS below).
-**-D**\ *distance\_flag*
- Distance *flag* tells how grid (x,y) relates to filter *width* as
- follows:
-
- *flag* = p: grid (px,py) with *width* an odd number of pixels;
- Cartesian distances.
-
- *flag* = 0: grid (x,y) same units as *width*, Cartesian distances.
-
- *flag* = 1: grid (x,y) in degrees, *width* in kilometers, Cartesian
- distances.
-
- *flag* = 2: grid (x,y) in degrees, *width* in km, dx scaled by
- cos(middle y), Cartesian distances.
-
- The above options are fastest because they allow weight matrix to be
- computed only once. The next three options are slower because they
- recompute weights for each latitude.
-
- *flag* = 3: grid (x,y) in degrees, *width* in km, dx scaled by
- cosine(y), Cartesian distance calculation.
-
- *flag* = 4: grid (x,y) in degrees, *width* in km, Spherical distance
- calculation.
-
- *flag* = 5: grid (x,y) in Mercator **-Jm**\ 1 img units, *width* in
- km, Spherical distance calculation.
-
-**-Fx**\ *width*\ [/*width2*][*mode*\ ]
- Sets the filter type. Choose among convolution and non-convolution
- filters. Use any filter code **x** (listed below) followed by the full
- diameter *width*. This gives an isotropic filter; append /*width2*
- for a rectangular filter (requires **-Dp** or **-D0**).
-
- Convolution filters (and their codes) are:
-
- (**b**) Boxcar: All weights are equal.
-
- (**c**) Cosine Arch: Weights follow a cosine arch curve.
-
- (**g**) Gaussian: Weights are given by the Gaussian function, where
- *width* is 6 times the conventional Gaussian sigma.
-
- (**f**) Custom: Weights are given by the precomputed values in the
- filter weight grid file *weight*, which must have odd dimensions;
- also requires **-D0** and output spacing must match input spacing or
- be integer multiples.
-
- (**o**) Operator: Weights are given by the precomputed values in the
- filter weight grid file *weight*, which must have odd dimensions;
- also requires **-D0** and output spacing must match input spacing or
- be integer multiples. Weights are assumed to sum to zero so no
- accumulation of weight sums and normalization will be done.
-
- Non-convolution filters (and their codes) are:
-
- (**m**) Median: Returns median value. To select another quantile
- append **+q**\ *quantile* in the 0-1 range [Default is 0.5, i.e., median].
-
- (**p**) Maximum likelihood probability (a mode estimator): Return
- modal value. If more than one mode is found we return their average
- value. Append **-** or **+** to the filter width if you rather want
- to return the smallest or largest of the modal values. By mode we mean
- the least median of squares approximation to the mode.
-
- (**l**) Lower: Return the minimum of all values.
-
- (**L**) Lower: Return minimum of all positive values only.
-
- (**u**) Upper: Return maximum of all values.
-
- (**U**) Upper: Return maximum or all negative values only.
-
- In the case of **L**\ \|\ **U** it is possible that no data passes
- the initial sign test; in that case the filter will return NaN.
-
-**-G**\ *outgrid*
- *outgrid* is the output grid file of the filter. (See GRID FILE FORMATS below).
-
-Optional Arguments
-------------------
-
-**-I**\ *xinc*\ [*unit*\ ][\ **=**\ \|\ **+**][/\ *yinc*\ [*unit*\ ][\ **=**\ \|\ **+**]]
- *x\_inc* [and optionally *y\_inc*] is the output Increment. Append
- **m** to indicate arc minutes, or **s** to indicate arc seconds. If
- the new *x\_inc*, *y\_inc* are NOT integer multiples of the old ones
- (in the input data), filtering will be considerably slower.
- [Default: Same as input.]
-**-N**\ **i**\ \|\ **p**\ \|\ **r**
- Determine how NaN-values in the input grid affects the filtered
- output: Append **i** to ignore all NaNs in the calculation of
- filtered value [Default], **r** is same as **i** except if the input
- node was NaN then the output node will be set to NaN (only applies
- if both grids are co-registered), and **p** which will force the
- filtered value to be NaN if any grid-nodes with NaN-values are found
- inside the filter circle.
-**-R**
- *west*, *east*, *south*, and *north* defines the Region of the
- output points. [Default: Same as input.]
-**-T**
- Toggle the node registration for the output grid so as to become the
- opposite of the input grid [Default gives the same registration as
- the input grid].
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_grd_inout.rst_
-
-.. include:: explain_grd_coord.rst_
-
-Examples
---------
-
-Suppose that north_pacific_etopo5.nc is a file of 5 minute bathymetry
-from 140E to 260E and 0N to 50N, and you want to find the medians of
-values within a 300km radius (600km full width) of the output points,
-which you choose to be from 150E to 250E and 10N to 40N, and you want
-the output values every 0.5 degree. Using spherical distance
-calculations, you need:
-
- ::
-
- gmt grdfilter north_pacific_etopo5.nc -Gfiltered_pacific.nc -Fm600 \
- -D4 -R150/250/10/40 -I0.5 -V
-
-If we instead wanted a high-pass result then one can perform the
-corresponding low-pass filter using a coarse grid interval as grdfilter
-will resample the result to the same resolution as the input grid so we
-can compute the residuals, e.g.,
-
- ::
-
- gmt grdfilter north_pacific_etopo5.nc -Gresidual_pacific.nc -Fm-600 \
- -D4 -R150/250/10/40 -I0.5 -V
-
-Here, the residual_pacific.nc grid will have the same 5 minute
-resolution as the original.
-
-To filter the dataset in ripples.nc using a custom anisotropic Gaussian
-filter exp (-0.5\*r^2) whose distances r from the center is given by
-(2x^2 + y^2 -2xy)/6, with major axis at an angle of 63 degrees with the
-horizontal, try
-
- ::
-
- gmt grdmath -R-10/10/-10/10 -I1 X 2 POW 2 MUL Y 2 POW ADD X Y MUL 2 MUL \
- SUB 6 DIV NEG 2 DIV EXP DUP SUM DIV = gfilter.nc
- gmt grdfilter ripples.nc -Ffgfilter.nc -D0 -Gsmooth.nc -V
-
-Limitations
------------
-
-To use the **-D**\ 5 option the input Mercator grid must be created by
-img2mercgrd using the **-C** option so the origin of the y-values is the
-Equator (i.e., x = y = 0 correspond to lon = lat = 0).
-
-See Also
---------
-
-:doc:`gmt`, :doc:`grdfft` :doc:`img2grd <supplements/img/img2grd>`
diff --git a/doc_release/html/_sources/grdgradient.txt b/doc_release/html/_sources/grdgradient.txt
deleted file mode 100644
index 4b1c267..0000000
--- a/doc_release/html/_sources/grdgradient.txt
+++ /dev/null
@@ -1,191 +0,0 @@
-.. index:: ! grdgradient
-
-***********
-grdgradient
-***********
-
-.. only:: not man
-
- grdgradient - Compute directional derivative or gradient from a grid
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**grdgradient** *in_grdfile* **-G**\ *out_grdfile*
-[ **-A**\ *azim*\ [/*azim2*] ] [ **-D**\ [**c**][**o**][**n**] ]
-[ **-E**\ [**s\|p**\ ]\ *azim/elev*\ [/*ambient*/*diffuse*/*specular*/*shine*] ]
-[ **-L**\ *flag* ]
-[ **-N**\ [**e**\ ][**t**][*amp*][/\ *sigma*\ [/*offset*]] ]
-[ |SYN_OPT-R| ] [ **-S**\ *slopefile* ]
-[ |SYN_OPT-V| ] [ **-fg** ]
-[ |SYN_OPT-n| ]
-
-|No-spaces|
-
-Description
------------
-
-**grdgradient** may be used to compute the directional derivative in a
-given direction (**-A**), or the direction (**-S**) [and the magnitude
-(**-D**)] of the vector gradient of the data.
-
-Estimated values in the first/last row/column of output depend on
-boundary conditions (see **-L**).
-
-Required Arguments
-------------------
-
-*in_grdfile*
- 2-D grid file from which to compute directional derivative. (See
- GRID FILE FORMATS below).
-**-G**\ *out\_grdfile*
- Name of the output grid file for the directional derivative. (See
- GRID FILE FORMATS below).
-
-Optional Arguments
-------------------
-
-**-A**\ *azim*\ [/*azim2*]
- Azimuthal direction for a directional derivative; *azim* is the
- angle in the x,y plane measured in degrees positive clockwise from
- north (the +y direction) toward east (the +x direction). The
- negative of the directional derivative, -[dz/dx\*sin(*azim*) +
- dz/dy\*cos(\ *azim*)], is found; negation yields positive values
- when the slope of z(x,y) is downhill in the *azim* direction, the
- correct sense for shading the illumination of an image (see
- :doc:`grdimage` and :doc:`grdview`) by a light source above the x,y plane
- shining from the *azim* direction. Optionally, supply two azimuths,
- **-A**\ *azim*/*azim2*, in which case the gradients in each of these
- directions are calculated and the one larger in magnitude is
- retained; this is useful for illuminating data with two directions
- of lineated structures, e.g., **-A**\ *0*/*270* illuminates from the
- north (top) and west (left).
-**-D**\ [**c**][**o**][**n**]
- Find the direction of the gradient of the data. By default, the
- directions are measured clockwise from north, as *azim* in **-A**
- above. Append **c** to use conventional Cartesian angles measured
- counterclockwise from the positive x (east) direction. Append **o**
- to report orientations (0-180) rather than directions (0-360).
- Append **n** to add 90 degrees to all angles (e.g., to give
- orientation of lineated features). Unlike **-A**, here we return
- the up-slope direction of the gradient.
-**-E**\ [**s\|p**]\ *azim/elev*\ [/*ambient*/*diffuse*/*specular*/*shine*]
- Compute Lambertian radiance appropriate to use with :doc:`grdimage` and :doc:`grdview`.
- The Lambertian Reflection assumes an ideal surface that
- reflects all the light that strikes it and the surface appears
- equally bright from all viewing directions. *azim* and *elev* are
- the azimuth and elevation of light vector. Optionally, supply
- *ambient* *diffuse* *specular* *shine* which are parameters that
- control the reflectance properties of the surface. Default values
- are: *0.55*/*0.6*/*0.4*/*10* To leave some of the values untouched,
- specify = as the new value. For example **-E**\ *60*/*30*/*=*/*0.5*
- sets the *azim* *elev* and *diffuse* to 60, 30 and 0.5 and leaves
- the other reflectance parameters untouched. Append **s** to use a
- simpler Lambertian algorithm. Note that with this form you only have
- to provide the azimuth and elevation parameters. Append **p** to use
- the Peucker piecewise linear approximation (simpler but faster
- algorithm; in this case the *azim* and *elev* are hardwired to 315
- and 45 degrees. This means that even if you provide other values
- they will be ignored.)
-**-L**\ *flag*
- Boundary condition *flag* may be *x* or *y* or *xy* indicating data
- is periodic in range of x or y or both, or *flag* may be *g*
- indicating geographical conditions (x and y are lon and lat).
- [Default uses "natural" conditions (second partial derivative normal
- to edge is zero).]
-**-N**\ [**e**][**t**][*amp*][/\ *sigma*\ [/*offset*]]
- Normalization. [Default: no normalization.] The actual gradients *g*
- are offset and scaled to produce normalized gradients *gn* with a
- maximum output magnitude of *amp*. If *amp* is not given, default
- *amp* = 1. If *offset* is not given, it is set to the average of
- *g*. **-N** yields *gn* = *amp* \* (*g* - *offset*)/max(abs(\ *g* -
- *offset*)). **-Ne** normalizes using a cumulative Laplace
- distribution yielding *gn* = *amp* \* (1.0 -
- exp(sqrt(2) \* (*g* - *offset*)/ *sigma*)) where
- *sigma* is estimated using the L1 norm of (*g* - *offset*) if it is
- not given. **-Nt** normalizes using a cumulative Cauchy distribution
- yielding *gn* = (2 \* *amp* / PI) \* atan( (*g* - *offset*)/
- *sigma*) where *sigma* is estimated using the L2 norm of (*g* -
- *offset*) if it is not given.
-
-.. |Add_-R| replace:: Using the **-R** option
- will select a subsection of *in\_grdfile* grid. If this subsection
- exceeds the boundaries of the grid, only the common region will be extracted.
-.. include:: explain_-R.rst_
-
-**-S**\ *slopefile*
- Name of output grid file with scalar magnitudes of gradient vectors.
- Requires **-D** but makes **-G** optional.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-fg**
- Geographic grids (dimensions of longitude, latitude) will be converted to
- meters via a "Flat Earth" approximation using the current ellipsoid parameters.
-
-.. include:: explain_-n.rst_
-
-.. include:: explain_help.rst_
-
-Grid Distance Units
--------------------
-
-If the grid does not have meter as the horizontal unit, append **+u**\ *unit* to the input file name to convert from the
-specified unit to meter. If your grid is geographic, convert distances to meters by supplying **-fg** instead.
-
-Hints
------
-
-If you don't know what **-N** options to use to make an intensity file
-for :doc:`grdimage` or :doc:`grdview`, a good first try is **-Ne**\ 0.6.
-
-Usually 255 shades are more than enough for visualization purposes. You
-can save 75% disk space by appending =nb/a to the output filename
-*out_grdfile*.
-
-If you want to make several illuminated maps of subregions of a large
-data set, and you need the illumination effects to be consistent across
-all the maps, use the **-N** option and supply the same value of *sigma*
-and *offset* to **grdgradient** for each map. A good guess is *offset* =
-0 and *sigma* found by **grdinfo** **-L2** or **-L1** applied to an
-unnormalized gradient grd.
-
-If you simply need the *x*- or *y*-derivatives of the grid, use :doc:`grdmath`.
-
-.. include:: explain_grd_inout.rst_
-
-Examples
---------
-
-To make a file for illuminating the data in geoid.nc using exp-
-normalized gradients in the range [-0.6,0.6] imitating light sources in
-the north and west directions:
-
- ::
-
- gmt grdgradient geoid.nc -A0/270 -Ggradients.nc=nb/a -Ne0.6 -V
-
-To find the azimuth orientations of seafloor fabric in the file topo.nc:
-
- ::
-
- gmt grdgradient topo.nc -Dno -Gazimuths.nc -V
-
-References
-----------
-
-Horn, B.K.P., Hill-Shading and the Reflectance Map, Proceedings of the
-IEEE, Vol. 69, No. 1, January 1981, pp. 14-47.
-(http://people.csail.mit.edu/bkph/papers/Hill-Shading.pdf)
-
-See Also
---------
-
-:doc:`gmt`, :doc:`gmt.conf`
-:doc:`grdhisteq`,
-:doc:`grdmath`,
-:doc:`grdimage`, :doc:`grdview`,
-:doc:`grdvector`
diff --git a/doc_release/html/_sources/grdhisteq.txt b/doc_release/html/_sources/grdhisteq.txt
deleted file mode 100644
index e39682e..0000000
--- a/doc_release/html/_sources/grdhisteq.txt
+++ /dev/null
@@ -1,139 +0,0 @@
-.. index:: ! grdhisteq
-
-*********
-grdhisteq
-*********
-
-.. only:: not man
-
- grdhisteq - Perform histogram equalization for a grid
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**grdhisteq** *in_grdfile* [ **-G**\ *out_grdfile* ]
-[ **-C**\ *n_cells* ] [ **-D**\ [*file*] ] [ **-N**\ [*norm*] ]
-[ **-Q** ]
-|SYN_OPT-R|
-|SYN_OPT-V|
-
-|No-spaces|
-
-Description
------------
-
-**grdhisteq** allows the user to find the data values which divide a
-given grid file into patches of equal area. One common use of
-**grdhisteq** is in a kind of histogram equalization of an image. In
-this application, the user might have a grid of flat topography with a
-mountain in the middle. Ordinary gray shading of this file (using
-grdimage/grdview) with a linear mapping from topography to graytone will
-result in most of the image being very dark gray, with the mountain
-being almost white. One could use **grdhisteq** to write to stdout or file an
-ASCII list of those data values which divide the range of the data into
-*n_cells* segments, each of which has an equal area in the image. Using
-**awk** or :doc:`makecpt` one can take this output and build a cpt file;
-using the cptfile with grdimage will result in an image with all levels
-of gray occurring equally. Alternatively, see :doc:`grd2cpt`.
-
-The second common use of **grdhisteq** is in writing a grid with
-statistics based on some kind of cumulative distribution function. In
-this application, the output has relative highs and lows in the same
-(x,y) locations as the input file, but the values are changed to reflect
-their place in some cumulative distribution. One example would be to
-find the lowest 10% of the data: Take a grid, run **grdhisteq** and make
-a grid using *n_cells* = 10, and then contour the result to trace the 1
-contour. This will enclose the lowest 10% of the data, regardless of
-their original values. Another example is in equalizing the output of
-:doc:`grdgradient`. For shading purposes it is desired that the data have a
-smooth distribution, such as a Gaussian. If you run **grdhisteq** on
-output from :doc:`grdgradient` and make a grid file output with the
-Gaussian option, you will have a grid whose values are distributed
-according to a Gaussian distribution with zero mean and unit variance.
-The locations of these values will correspond to the locations of the
-input; that is, the most negative output value will be in the (x,y)
-location of the most negative input value, and so on.
-
-Required Arguments
-------------------
-
-*in_grdfile*
- 2-D grid file to be equalized. (See GRID FILE FORMATS below).
-
-Optional Arguments
-------------------
-
-**-C**\ *n_cells*
- Sets how many cells (or divisions) of data range to make [16].
-**-D**
- Dump level information to *file*, or standard output if no file is
- provided.
-**-G**\ *out_grdfile*
- Name of output 2-D grid file. Used with **-N** only. (See GRID FILE
- FORMATS below).
-**-N**\ [*norm*]
- Gaussian output. Use with **-G** to make an output grid with
- standard normal scores. Append *norm* to force the scores to fall in
- the <-1,+1> range [Default is standard normal scores].
-**-Q**
- Use quadratic intensity scaling. [Default is linear].
-
-.. |Add_-R| replace:: Using the **-R** option
- will select a subsection of *in_grdfile* grid. If this subsection
- exceeds the boundaries of the grid, only the common region will be extracted.
-.. include:: explain_-R.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_grd_inout.rst_
-
-Examples
---------
-
-To find the height intervals that divide the file heights.nc into 16
-divisions of equal area:
-
- ::
-
- gmt grdhisteq heights.nc -C16 -D > levels.d
-
-To make the poorly distributed intensities in the file raw_intens.nc
-suitable for use with :doc:`grdimage` or :doc:`grdview`, run
-
- ::
-
- gmt grdhisteq raw_intens.nc -Gsmooth_intens.nc -N -V
-
-Restrictions
-------------
-
-If you use **grdhisteq** to make a Gaussian output for gradient shading
-in :doc:`grdimage` or :doc:`grdview`, you should be aware of the following:
-the output will be in the range [-x, x], where x is based on the number
-of data in the input grid (nx \* ny) and the cumulative Gaussian
-distribution function F(x). That is, let N = nx \* ny. Then x will be
-adjusted so that F(x) = (N - 1 + 0.5)/N. Since about 68% of the values
-from a standard normal distribution fall within +/- 1, this will be true
-of the output grid. But if N is very large, it is possible for x to be
-greater than 4. Therefore, with the :doc:`grdview` program clipping
-gradients to the range [-1, 1], you will get correct shading of 68% of
-your data, while 16% of them will be clipped to -1 and 16% of them
-clipped to +1. If this makes too much of the image too light or too
-dark, you should take the output of **grdhisteq** and rescale it using
-**grdmath** and multiplying by something less than 1.0, to shrink the
-range of the values, thus bringing more than 68% of the image into the
-range [-1, 1]. Alternatively, supply a normalization factor with **-N**.
-
-See Also
---------
-
-:doc:`gmt`, :doc:`gmt.conf`,
-:doc:`grd2cpt`,
-:doc:`grdgradient`,
-:doc:`grdimage`, :doc:`grdmath`,
-:doc:`grdview`, :doc:`makecpt`
diff --git a/doc_release/html/_sources/grdimage.txt b/doc_release/html/_sources/grdimage.txt
deleted file mode 100644
index b87e5f8..0000000
--- a/doc_release/html/_sources/grdimage.txt
+++ /dev/null
@@ -1,250 +0,0 @@
-.. index:: ! grdimage
-
-********
-grdimage
-********
-
-.. only:: not man
-
- grdimage - Project grids or images and plot them on maps
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**grdimage** *grd_z* \| *grd_r grd_g grd_b*
-[ **-A**\ *out_img*\ **=**\ *driver* ] [ **-C**\ *cptfile* ]
-[ **-D**\ [**r**\ ] ] **-J**\ *parameters*
-[ |SYN_OPT-U| ]
-[ **-G**\ [**f**\ \|\ **b**]\ *color* ] [ **-I**\ *intensfile*\ \|\ *intensity* ]
-[ **-Jz**\ \|\ **Z**\ *parameters* ] [ **-K** ] [ **-M** ] [ **-N** ]
-[ **-O** ] [ **-P** ] [ **-Q** ]
-[ |SYN_OPT-Rz| ]
-[ **-T** ]
-[ |SYN_OPT-U| ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-X| ]
-[ |SYN_OPT-Y| ]
-[ |SYN_OPT-c| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-n| ]
-[ |SYN_OPT-p| ]
-[ **-tr** ]
-
-|No-spaces|
-
-Description
------------
-
-**grdimage** reads one 2-D grid file and produces a gray-shaded (or
-colored) map by plotting rectangles centered on each grid node and
-assigning them a gray-shade (or color) based on the z-value.
-Alternatively, **grdimage** reads three 2-D grid files with the red,
-green, and blue components directly (all must be in the 0-255 range).
-Optionally, illumination may be added by providing a file with
-intensities in the (-1,+1) range. Values outside this range will be
-clipped. Such intensity files can be created from the grid using
-:doc:`grdgradient` and, optionally, modified by :doc:`grdmath` or
-:doc:`grdhisteq`. Yet as a third alternative available when GMT is build
-with GDAL support the grd_z file can be an image referenced or not
-(than see **-Dr**). In this case the images can be illuminated with the
-file provided via the **-I** option. Here if image has no coordinates
-those of the intensity file will be used.
-
-When using map projections, the grid is first resampled on a new
-rectangular grid with the same dimensions. Higher resolution images can
-be obtained by using the **-E** option. To obtain the resampled value
-(and hence shade or color) of each map pixel, its location is inversely
-projected back onto the input grid after which a value is interpolated
-between the surrounding input grid values. By default bi-cubic
-interpolation is used. Aliasing is avoided by also forward projecting
-the input grid nodes. If two or more nodes are projected onto the same
-pixel, their average will dominate in the calculation of the pixel
-value. Interpolation and aliasing is controlled with the **-n** option.
-
-The **-R** option can be used to select a map region larger or smaller
-than that implied by the extent of the grid.
-
-A (color) PostScript file is output.
-
-Required Arguments
-------------------
-
-*grd_z* \| *grd_r grd_g grd_b*
- 2-D gridded data set (or red, green, blue grids) to be imaged (See
- GRID FILE FORMATS below.)
-
-.. include:: explain_-J.rst_
-
-Optional Arguments
-------------------
-
-**-A**\ *out\_img*\ **=**\ *driver*
- With GDAL aware versions: save image in a raster format instead of
- PostScript. Append *out\_img*\ **=**\ *driver* to select the file
- name and image format. The *driver* is the driver code name used by
- GDAL. For example, **-A**\ img.tif=GTiff will write a GeoTiff image
- if the subset of GMT syntax projections that is currently possible
- to translate into the PROJ4 syntax allows it, or a plain tiff file
- otherwise. Note: any vector elements are lost.
-
-.. include:: explain_-B.rst_
-
-**-C**\ *cptfile*
- Name of the color palette table (for *grd\_z* only). Alternatively,
- supply the name of a GMT color master CPT [rainbow] and let
- **grdimage** automatically determine a 16-level continuous CPT from
- the grid's z-range.
-**-D**\ [**r**]
- Specifies that the grid supplied is an image file to be read via
- GDAL. Obviously this option will work only with GMT versions
- built with GDAL support. The image can be indexed or true color
- (RGB) and can be an URL of a remotely located file. That is **-D**
- `http://www.somewhere.com/image.jpg <http://www.somewhere.com/image.jpg>`_
- is a valid file syntax. Note, however, that to use it this way you
- must not be blocked by a proxy. If you are, chances are good that it
- can work by setting the environmental variable
- *http_proxy* with the value 'your_proxy:port' Append
- **r** to use the region specified by **-R** to apply to the image.
- For example, if you have used **-Rd** then the image will be
- assigned the limits of a global domain. The interest of this mode is
- that you can project a raw image (an image without referencing
- coordinates).
-**-Ei**\ [\|*dpi*]
- Sets the resolution of the projected grid that will be created if a
- map projection other than Linear or Mercator was selected [100]. By
- default, the projected grid will be of the same size (rows and
- columns) as the input file. Specify **i** to use the PostScript
- image operator to interpolate the image at the device resolution.
-**-G**\ [**f**\ \|\ **b**]\ *color*
- This option only applies when the resulting image otherwise would
- consist of only two colors: black (0) and white (255). If so, this
- option will instead use the image as a transparent mask and paint
- the mask (or its inverse, with **-Gb**) with the given color
- combination.
-**-I**\ *intensfile*\ \|\ *intensity*
- Gives the name of a grid file with intensities in the (-1,+1) range,
- or a constant intensity to apply everywhere.
- [Default is no illumination].
-
-.. include:: explain_-Jz.rst_
-
-.. include:: explain_-K.rst_
-
-**-M**
- Force conversion to monochrome image using the (television) YIQ
- transformation. Cannot be used with **-Q**.
-**-N**
- Do not clip the image at the map boundary (only relevant for
- non-rectangular maps).
-
-.. include:: explain_-O.rst_
-
-.. include:: explain_-P.rst_
-
-**-Q**
- Make grid nodes with z = NaN transparent, using the colormasking
- feature in PostScript Level 3 (the PS device must support PS Level 3).
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-R.rst_
-
-.. |Add_-Rz| replace:: You may ask for a larger
- *w/e/s/n* region to have more room between the image and the axes. A
- smaller region than specified in the grid file will result in a
- subset of the grid [Default is the region given by the grid file].
-.. include:: explain_-Rz.rst_
-
-
-.. include:: explain_-U.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. include:: explain_-XY.rst_
-
-.. include:: explain_-c.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. include:: explain_-n.rst_
-
-.. |Add_perspective| unicode:: 0x20 .. just an invisible code
-.. include:: explain_perspective.rst_
-
-.. include:: explain_-t.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_grd_inout.rst_
-
-
-Imaging Grids With Nans
------------------------
-
-Be aware that if your input grid contains patches of NaNs, these patches
-can become larger as a consequence of the resampling that must take
-place with most map projections. Because **grdimage** uses the
-PostScript colorimage operator, for most non-linear projections we
-must resample your grid onto an equidistant rectangular lattice. If you
-find that the NaN areas are not treated adequately, consider (a) use a
-linear projection, or (b) use :doc:`grdview` **-Ts** instead.
-
-.. include:: explain_grdresample.rst_
-
-Examples
---------
-
-For a quick-and-dirty color map of the data in the file stuff.nc, with
-the maximum map dimension limited to be 6 inches, try
-
- ::
-
- gmt grdimage stuff.nc -JX6i+ > quick.ps
-
-To gray-shade the file hawaii_grav.nc with shades given in shades.cpt
-on a Lambert map at 1.5 cm/degree along the standard parallels 18 and
-24, and using 1 degree tickmarks:
-
- ::
-
- gmt grdimage hawaii_grav.nc -Jl18/24/1.5c -Cshades.cpt -B1 > hawaii_grav_image.ps
-
-To create an illuminated color PostScript plot of the gridded data set
-image.nc, using the intensities provided by the file intens.nc, and
-color levels in the file colors.cpt, with linear scaling at 10
-inch/x-unit, tickmarks every 5 units:
-
- ::
-
- gmt grdimage image.nc -Jx10i -Ccolors.cpt -Iintens.nc -B5 > image.ps
-
-To create an false color PostScript plot from the three grid files
-red.nc, green.nc, and blue.nc, with linear scaling at 10 inch/x-unit,
-tickmarks every 5 units:
-
- ::
-
- gmt grdimage red.nc green.nc blue.nc -Jx10i -B5 > rgbimage.ps
-
-When GDAL support is built in: To create a sinusoidal projection of a
-remotely located Jessica Rabbit
-
- ::
-
- gmt grdimage -JI15c -Rd -Dr
- http://larryfire.files.wordpress.com/2009/07/untooned_jessicarabbit.jpg \
- -P > jess.ps
-
-See Also
---------
-
-:doc:`gmt`,
-:doc:`gmt.conf`,
-:doc:`grd2rgb`,
-:doc:`grdcontour`,
-:doc:`grdview`,
-:doc:`grdgradient`,
-:doc:`grdhisteq`
diff --git a/doc_release/html/_sources/grdinfo.txt b/doc_release/html/_sources/grdinfo.txt
deleted file mode 100644
index 4163aaf..0000000
--- a/doc_release/html/_sources/grdinfo.txt
+++ /dev/null
@@ -1,112 +0,0 @@
-.. index:: ! grdinfo
-
-*******
-grdinfo
-*******
-
-.. only:: not man
-
- grdinfo - Extract information from grids
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**grdinfo** *grdfiles* [ **-C** ] [ **-F** ]
-[ **-I**\ [*dx*\ [/*dy*]\|\ **-**\ \|\ **b**] ]
-[ **-L**\ [**0**\ \|\ **1**\ \|\ **2**] ] [ **-M** ]
-[ |SYN_OPT-R| ]
-[ **-T**\ [**s**]\ *dz* ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-f| ]
-
-|No-spaces|
-
-Description
------------
-
-**grdinfo** reads a 2-D binary grid file and reports metadata and
-various statistics for the (*x*,\ *y*,\ *z*) data in the grid file(s).
-The output information contains the minimum/maximum values for *x*, *y*,
-and *z*, where the min/max of *z* occur, the *x*- and *y*-increments,
-and the number of *x* and *y* nodes, and [optionally] the mean, standard
-deviation, and/or the median, L1 scale of *z*, and number of nodes set
-to NaN. We also report if the grid is pixel- or gridline-registered and
-if it is a Cartesian or Geographic data set (based on metadata in the file).
-
-Required Arguments
-------------------
-
-*grdfile*
- The name of one or several 2-D grid files. (See GRID FILE FORMATS below.)
-
-Optional Arguments
-------------------
-
-**-C**
- Formats the report using tab-separated fields on a single line. The
- output is *w e s n z0 z1 dx dy nx ny*\ [ *x0 y0 x1 y1* ] [ *med
- scale* ] [*mean std rms*\ ] [*n\_nan*\ ]. The data in brackets are
- output only if the corresponding options **-M**, **-L1**, **-L2**,
- and **-M** are used, respectively. If the **-I** option is used, the
- output format is instead *NF w e s n z0 z1*, where *NF* is the total
- number of grids read and *w e s n* are rounded off (see **-I**).
-**-F**
- Report grid domain and x/y-increments in world mapping format
- [Default is generic]. Does not apply to the **-C** option.
-**-I**\ [*dx*\ [/*dy*]\|\ **-**\ \|\ **b**]
- Report the min/max of the region to the nearest multiple of *dx* and
- *dy*, and output this in the form **-R**\ *w/e/s/n* (unless **-C**
- is set). To report the actual grid region, select **-I-**. If no
- argument is given then we report the grid increment in the form
- **-I**\ *xinc/yinc*. If **-Ib** is given we write each grid's
- bounding box polygon instead.
-**-L**\ [**0** \| **1** \| **2**]
- **-L0**
- Report range of z after actually scanning the data, not just
- reporting what the header says.
- **-L1**
- Report median and L1 scale of z (L1 scale = 1.4826 \* Median
- Absolute Deviation (MAD)).
- **-L2**
- Report mean, standard deviation, and root-mean-square (rms) of z.
-**-M**
- Find and report the location of min/max z-values, and count and
- report the number of nodes set to NaN, if any.
-
-.. |Add_-R| replace:: Using the **-R** option
- will select a subsection of the input grid(s). If this subsection
- exceeds the boundaries of the grid, only the common region will be extracted.
-.. include:: explain_-R.rst_
-
-**-T**\ *dz*
- Determine min and max z-value, round off to multiples of *dz*, and
- report as the text string **-T**\ *zmin/zmax/dz* for use by
- **makecpt**. To get a symmetrical range about zero, using the max
- absolute multiple of *dz*, use **-Ts**\ *dz* instead.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_grd_inout.rst_
-
-Examples
---------
-
-To obtain all the information about the data set in file hawaii\_topo.nc:
-
- ::
-
- gmt grdinfo -L1 -L2 -M hawaii_topo.nc
-
-See Also
---------
-
-:doc:`gmt`, :doc:`grd2cpt`,
-:doc:`grd2xyz`, :doc:`grdedit`
diff --git a/doc_release/html/_sources/grdlandmask.txt b/doc_release/html/_sources/grdlandmask.txt
deleted file mode 100644
index 3967c89..0000000
--- a/doc_release/html/_sources/grdlandmask.txt
+++ /dev/null
@@ -1,104 +0,0 @@
-.. index:: ! grdlandmask
-
-***********
-grdlandmask
-***********
-
-.. only:: not man
-
- grdlandmask - Create a "wet-dry" mask grid from shoreline data base
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**grdlandmask** **-G**\ *mask\_grd\_file*]
-**-I**\ *xinc*\ [*unit*\ ][\ **=**\ \|\ **+**][/\ *yinc*\ [*unit*\ ][\ **=**\ \|\ **+**]]
-**-R**\ *west*/*east*/*south*/*north*\ [**r**\ ] [
-**-A**\ *min\_area*\ [/*min\_level*/*max\_level*][\ **+as**\ ][\ **+r**\ \|\ **l**][\ **p**\ *percent*]
-] [ **-D**\ *resolution*\ [**+**\ ] ] [ **-N**\ *maskvalues*\ [**o**\ ]
-] [ **-V**\ [*level*\ ] ] [ **-r** ]
-
-|No-spaces|
-
-Description
------------
-
-**grdlandmask** reads the selected shoreline database and uses that
-information to decide which nodes in the specified grid are over land or
-over water. The nodes defined by the selected region and lattice spacing
-will be set according to one of two criteria: (1) land vs water, or
-(2) the more detailed (hierarchical) ocean vs land vs lake
-vs island vs pond. The resulting mask may be used in subsequent
-operations involving **grdmath** to mask out data from land [or water] areas.
-
-Required Arguments
-------------------
-
-**-G**\ *mask_grd_file*]
- Name of resulting output mask grid file. (See GRID FILE FORMATS below).
-
-.. include:: explain_-I.rst_
-
-.. |Add_-Rgeo| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-Rgeo.rst_
-
-Optional Arguments
-------------------
-
-.. |Add_-A| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-A.rst_
-
-**-D**\ *resolution*\ [**+**\ ]
- Selects the resolution of the data set to use ((**f**)ull,
- (**h**)igh, (**i**)ntermediate, (**l**)ow, or (**c**)rude). The
- resolution drops off by ~80% between data sets. [Default is **l**].
- Append **+** to automatically select a lower resolution should the
- one requested not be available [abort if not found]. Note that
- because the coastlines differ in details a node in a mask file using
- one resolution is not guaranteed to remain inside [or outside] when
- a different resolution is selected.
-**-N**\ *maskvalues*\ [**o**\ ]
- Sets the values that will be assigned to nodes. Values can be any
- number, including the textstring NaN. Append **o** to let nodes
- exactly on feature boundaries be considered outside [Default is
- inside]. Specify this information using 1 of 2 formats:
-
- **-N**\ *wet/dry*.
-
- **-N**\ *ocean/land/lake/island/pond*.
-
- [Default is 0/1/0/1/0 (i.e., 0/1)].
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. |Add_nodereg| unicode:: 0x20 .. just an invisible code
-.. include:: explain_nodereg.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_grd_output.rst_
-
-Examples
---------
-
-To set all nodes on land to NaN, and nodes over water to 1, using the
-high resolution data set, do
-
- gmt grdlandmask -R-60/-40/-40/-30 -Dh -I5m -N1/NaN -Gland_mask.nc -V
-
-To make a 1x1 degree global grid with the hierarchical levels of the
-nodes based on the low resolution data:
-
- gmt grdlandmask -R0/360/-90/90 -Dl -I1 -N0/1/2/3/4 -Glevels.nc -V
-
-.. include:: explain_gshhs.rst_
-
-See Also
---------
-
-:doc:`gmt`, :doc:`grdmath`,
-:doc:`grdclip`, :doc:`psmask`,
-:doc:`psclip`, :doc:`pscoast`
diff --git a/doc_release/html/_sources/grdmask.txt b/doc_release/html/_sources/grdmask.txt
deleted file mode 100644
index 3a783ec..0000000
--- a/doc_release/html/_sources/grdmask.txt
+++ /dev/null
@@ -1,156 +0,0 @@
-.. index:: ! grdmask
-
-*******
-grdmask
-*******
-
-.. only:: not man
-
- grdmask - Create mask grid from polygons or point coverage
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**grdmask** *pathfiles* **-G**\ *mask_grd_file*]
-|SYN_OPT-I|
-|SYN_OPT-R|
-[ **-A**\ [**m**\ \|\ **p**] ]
-[ **-N**\ [**z**\ \|\ **Z**\ \|\ **p**\ \|\ **P**]\ *values* ]
-[ **-S**\ *search\_radius*\ [*unit*] ] [ |SYN_OPT-V| ]
-[ |SYN_OPT-bi| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-g| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ **-r** ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**grdmask** can operate in two different modes. 1. It reads one or more
-xy-files that each define a closed polygon. The nodes defined by the
-specified region and lattice spacing will be set equal to one of three
-possible values depending on whether the node is outside, on the polygon
-perimeter, or inside the polygon. The resulting mask may be used in
-subsequent operations involving **grdmath** to mask out data from
-polygonal areas. 2. The xy-files simply represent data point locations
-and the mask is set to the inside or outside value depending on whether
-a node is within a maximum distance from the nearest data point. If the
-distance specified is zero then only the nodes nearest each data point
-are considered "inside".
-
-Required Arguments
-------------------
-
-*pathfiles*
- The name of 1 or more ASCII [or binary, see
- **-bi**] files holding the polygon(s) or data points.
-
-**-G**\ *mask_grd_file*]
- Name of resulting output mask grid file. (See GRID FILE FORMATS below).
-
-.. include:: explain_-I.rst_
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-R.rst_
-
-Optional Arguments
-------------------
-
-**-A**\ [**m**\ \|\ **p**]
- If the input data are geographic (as indicated by **-fi**) then the
- sides in the polygons will be approximated by great circle arcs.
- When using the **-A** sides will be regarded as straight lines.
- Alternatively, append **m** to have sides first follow meridians,
- then parallels. Or append **p** to first follow parallels, then meridians.
-
-**-N**\ [**z**\ \|\ **Z**\ \|\ **p**\ \|\ **P**]\ *values*
- Sets the *out/edge/in* that will be assigned to nodes that are
- *out*\ side the polygons, on the *edge*, or *in*\ side. Values can
- be any number, including the textstring NaN [Default is 0/0/1].
- Optionally, use **Nz** to set polygon insides to the z-value
- obtained from the data (either segment header **-Z**\ *zval*,
- **-L**\ *header* or via **-a**\ Z=\ *name*); use **-NZ** to consider
- the polygon boundary as part of the inside. Alternatively, use
- **-Np** to use a running number as polygon ID; optionally append
- start of the sequence [0]. Here, **-NP** includes the polygon
- perimeter as inside. Note:
- **-N**\ **z**\ \|\ **Z**\ \|\ **p**\ \|\ **P** cannot be used in
- conjunction with **-S**; they also all optionally accept /*out* [0].
-
-**-S**\ *search\_radius*\ [*unit*]
- Set nodes to inside, on edge, or outside depending on their distance
- to the nearest data point. Nodes within *radius* [0] from the
- nearest data point are considered inside; append a distance unit
- (see UNITS). If *radius* is given as **z** then we instead read
- individual radii from the 3rd input column. If **-S** is not set
- then we consider the input data to define closed polygon(s) instead.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. |Add_-bi| replace:: [Default is 2 input columns].
-.. include:: explain_-bi.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-g| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-g.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. |Add_nodereg| unicode:: 0x20 .. just an invisible code
-.. include:: explain_nodereg.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_distunits.rst_
-
-.. include:: explain_grd_output.rst_
-
-.. include:: explain_grd_coord.rst_
-
-Examples
---------
-
-To set all nodes inside and on the polygons coastline_*.xy to 0, and
-outside points to 1, do
-
- ::
-
- gmt grdmask coastline_*.xy -R-60/-40/-40/-30 -I5m -N1/0/0 -Gland_mask.nc=nb -V
-
-To set nodes within 50 km of data points to 1 and other nodes to NaN, do
-
- ::
-
- gmt grdmask data.xyz -R-60/-40/-40/-30 -I5m -NNaN/1/1 -S50k -Gdata_mask.nc=nb -V
-
-To assign polygon IDs to the gridnodes using the insides of the polygons
-in plates.gmt, based on the attribute POL_ID, do
-
- ::
-
- gmt grdmask plates.gmt -R-40/40/-40/40 -I2m -Nz -Gplate_IDs.nc -aZ=POL_ID -V
-
-Same exercise, but instead compute running polygon IDs starting at 100, do
-
- ::
-
- gmt grdmask plates.gmt -R-40/40/-40/40 -I2m -Np100 -Gplate_IDs.nc -V
-
-See Also
---------
-
-:doc:`gmt`, :doc:`grdlandmask`,
-:doc:`grdmath`, :doc:`grdclip`,
-:doc:`psmask`, :doc:`psclip`
diff --git a/doc_release/html/_sources/grdmath.txt b/doc_release/html/_sources/grdmath.txt
deleted file mode 100644
index c23b608..0000000
--- a/doc_release/html/_sources/grdmath.txt
+++ /dev/null
@@ -1,629 +0,0 @@
-.. index:: ! grdmath
-
-*******
-grdmath
-*******
-
-.. only:: not man
-
- grdmath - Reverse Polish Notation (RPN) calculator for grids (element by element)
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**grdmath**
-[ |SYN_OPT-I| ]
-[ **-M** ] [ **-N** ]
-[ |SYN_OPT-R| ] [ |SYN_OPT-V| ]
-[ |SYN_OPT-bi| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-n| ]
-[ **-r** ] *operand* [ *operand* ] **OPERATOR** [ *operand* ]
-**OPERATOR** ... **=** *outgrdfile*
-
-|No-spaces|
-
-Description
------------
-
-**grdmath** will perform operations like add, subtract, multiply, and
-divide on one or more grid files or constants using Reverse Polish
-Notation (RPN) syntax (e.g., Hewlett-Packard calculator-style).
-Arbitrarily complicated expressions may therefore be evaluated; the
-final result is written to an output grid file. Grid operations are
-element-by-element, not matrix manipulations. Some operators only
-require one operand (see below). If no grid files are used in the
-expression then options **-R**, **-I** must be set (and optionally
-**-r**). The expression **=** *outgrdfile* can occur as many times as
-the depth of the stack allows in order to save intermediate results.
-Complicated or frequently occurring expressions may be coded as a macro
-for future use or stored and recalled via named memory locations.
-
-Required Arguments
-------------------
-
-*operand*
- If *operand* can be opened as a file it will be read as a grid file.
- If not a file, it is interpreted as a numerical constant or a
- special symbol (see below).
-
-*outgrdfile*
- The name of a 2-D grid file that will hold the final result. (See
- GRID FILE FORMATS below).
-
-Optional Arguments
-------------------
-
-.. include:: explain_-I.rst_
-
-**-M**
- By default any derivatives calculated are in z_units/ x(or
- y)\_units. However, the user may choose this option to convert dx,dy
- in degrees of longitude,latitude into meters using a flat Earth
- approximation, so that gradients are in z_units/meter.
-
-**-N**
- Turn off strict domain match checking when multiple grids are
- manipulated [Default will insist that each grid domain is within
- 1e-4 \* grid_spacing of the domain of the first grid listed].
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-R.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. |Add_-bi| replace:: The binary input option
- only applies to the data files needed by operators **LDIST**,
- **PDIST**, and **INSIDE**.
-.. include:: explain_-bi.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-g| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-g.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. include:: explain_-n.rst_
-
-.. |Add_nodereg| replace:: Only used with **-R** **-I**.
-.. include:: explain_nodereg.rst_
-
-.. include:: explain_help.rst_
-
-Operators
----------
-
-Choose among the following 161 operators. "args" are the number of input
-and output arguments.
-
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| Operator | args | Returns |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **ABS** | 1 1 | abs (A) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **ACOS** | 1 1 | acos (A) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **ACOSH** | 1 1 | acosh (A) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **ACOT** | 1 1 | acot (A) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **ACSC** | 1 1 | acsc (A) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **ADD** | 2 1 | A + B |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **AND** | 2 1 | B if A == NaN, else A |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **ASEC** | 1 1 | asec (A) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **ASIN** | 1 1 | asin (A) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **ASINH** | 1 1 | asinh (A) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **ATAN** | 1 1 | atan (A) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **ATAN2** | 2 1 | atan2 (A, B) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **ATANH** | 1 1 | atanh (A) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **BEI** | 1 1 | bei (A) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **BER** | 1 1 | ber (A) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **BITAND** | 2 1 | A & B (bitwise AND operator) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **BITLEFT** | 2 1 | A << B (bitwise left-shift operator) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **BITNOT** | 1 1 | ~A (bitwise NOT operator, i.e., return two's complement) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **BITOR** | 2 1 | A \| B (bitwise OR operator) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **BITRIGHT** | 2 1 | A >> B (bitwise right-shift operator) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **BITTEST** | 2 1 | 1 if bit B of A is set, else 0 (bitwise TEST operator) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **BITXOR** | 2 1 | A ^ B (bitwise XOR operator) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **CAZ** | 2 1 | Cartesian azimuth from grid nodes to stack x,y (i.e., A, B) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **CBAZ** | 2 1 | Cartesian backazimuth from grid nodes to stack x,y (i.e., A, B) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **CDIST** | 2 1 | Cartesian distance between grid nodes and stack x,y (i.e., A, B) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **CEIL** | 1 1 | ceil (A) (smallest integer >= A) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **CHICRIT** | 2 1 | Critical value for chi-squared-distribution, with alpha = A and n = B |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **CHIDIST** | 2 1 | chi-squared-distribution P(chi2,n), with chi2 = A and n = B |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **CORRCOEFF** | 2 1 | Correlation coefficient r(A, B) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **COS** | 1 1 | cos (A) (A in radians) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **COSD** | 1 1 | cos (A) (A in degrees) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **COSH** | 1 1 | cosh (A) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **COT** | 1 1 | cot (A) (A in radians) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **COTD** | 1 1 | cot (A) (A in degrees) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **CPOISS** | 2 1 | Cumulative Poisson distribution F(x,lambda), with x = A and lambda = B |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **CSC** | 1 1 | csc (A) (A in radians) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **CSCD** | 1 1 | csc (A) (A in degrees) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **CURV** | 1 1 | Curvature of A (Laplacian) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **D2DX2** | 1 1 | d^2(A)/dx^2 2nd derivative |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **D2DY2** | 1 1 | d^2(A)/dy^2 2nd derivative |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **D2DXY** | 1 1 | d^2(A)/dxdy 2nd derivative |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **D2R** | 1 1 | Converts Degrees to Radians |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **DDX** | 1 1 | d(A)/dx Central 1st derivative |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **DDY** | 1 1 | d(A)/dy Central 1st derivative |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **DEG2KM** | 1 1 | Converts Spherical Degrees to Kilometers |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **DILOG** | 1 1 | dilog (A) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **DIV** | 2 1 | A / B |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **DUP** | 1 2 | Places duplicate of A on the stack |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **ERF** | 1 1 | Error function erf (A) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **ERFC** | 1 1 | Complementary Error function erfc (A) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **EQ** | 2 1 | 1 if A == B, else 0 |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **ERFINV** | 1 1 | Inverse error function of A |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **EXCH** | 2 2 | Exchanges A and B on the stack |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **EXP** | 1 1 | exp (A) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **FACT** | 1 1 | A! (A factorial) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **EXTREMA** | 1 1 | Local Extrema: +2/-2 is max/min, +1/-1 is saddle with max/min in x, 0 elsewhere |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **FCRIT** | 3 1 | Critical value for F-distribution, with alpha = A, n1 = B, and n2 = C |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **FDIST** | 3 1 | F-distribution Q(F,n1,n2), with F = A, n1 = B, and n2 = C |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **FLIPLR** | 1 1 | Reverse order of values in each row |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **FLIPUD** | 1 1 | Reverse order of values in each column |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **FLOOR** | 1 1 | floor (A) (greatest integer <= A) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **FMOD** | 2 1 | A % B (remainder after truncated division) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **GE** | 2 1 | 1 if A >= B, else 0 |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **GT** | 2 1 | 1 if A > B, else 0 |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **HYPOT** | 2 1 | hypot (A, B) = sqrt (A\*A + B\*B) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **I0** | 1 1 | Modified Bessel function of A (1st kind, order 0) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **I1** | 1 1 | Modified Bessel function of A (1st kind, order 1) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **IFELSE** | 3 1 | B if A != 0, else C |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **IN** | 2 1 | Modified Bessel function of A (1st kind, order B) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **INRANGE** | 3 1 | 1 if B <= A <= C, else 0 |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **INSIDE** | 1 1 | 1 when inside or on polygon(s) in A, else 0 |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **INV** | 1 1 | 1 / A |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **ISFINITE** | 1 1 | 1 if A is finite, else 0 |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **ISNAN** | 1 1 | 1 if A == NaN, else 0 |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **J0** | 1 1 | Bessel function of A (1st kind, order 0) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **J1** | 1 1 | Bessel function of A (1st kind, order 1) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **JN** | 2 1 | Bessel function of A (1st kind, order B) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **K0** | 1 1 | Modified Kelvin function of A (2nd kind, order 0) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **K1** | 1 1 | Modified Bessel function of A (2nd kind, order 1) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **KEI** | 1 1 | kei (A) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **KER** | 1 1 | ker (A) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **KM2DEG** | 1 1 | Converts Kilometers to Spherical Degrees |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **KN** | 2 1 | Modified Bessel function of A (2nd kind, order B) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **KURT** | 1 1 | Kurtosis of A |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **LDIST** | 1 1 | Compute minimum distance (in km if -fg) from lines in multi-segment ASCII file A |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **LDIST2** | 2 1 | As LDIST, from lines in ASCII file B but only to nodes where A != 0 |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **LE** | 2 1 | 1 if A <= B, else 0 |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **LOG** | 1 1 | log (A) (natural log) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **LOG10** | 1 1 | log10 (A) (base 10) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **LOG1P** | 1 1 | log (1+A) (accurate for small A) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **LOG2** | 1 1 | log2 (A) (base 2) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **LMSSCL** | 1 1 | LMS scale estimate (LMS STD) of A |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **LOWER** | 1 1 | The lowest (minimum) value of A |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **LRAND** | 2 1 | Laplace random noise with mean A and std. deviation B |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **LT** | 2 1 | 1 if A < B, else 0 |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **MAD** | 1 1 | Median Absolute Deviation (L1 STD) of A |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **MAX** | 2 1 | Maximum of A and B |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **MEAN** | 1 1 | Mean value of A |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **MED** | 1 1 | Median value of A |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **MIN** | 2 1 | Minimum of A and B |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **MOD** | 2 1 | A mod B (remainder after floored division) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **MODE** | 1 1 | Mode value (Least Median of Squares) of A |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **MUL** | 2 1 | A \* B |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **NAN** | 2 1 | NaN if A == B, else A |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **NEG** | 1 1 | -A |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **NEQ** | 2 1 | 1 if A != B, else 0 |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **NORM** | 1 1 | Normalize (A) so max(A)-min(A) = 1 |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **NOT** | 1 1 | NaN if A == NaN, 1 if A == 0, else 0 |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **NRAND** | 2 1 | Normal, random values with mean A and std. deviation B |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **OR** | 2 1 | NaN if B == NaN, else A |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **PDIST** | 1 1 | Compute minimum distance (in km if -fg) from points in ASCII file A |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **PDIST2** | 2 1 | As PDIST, from points in ASCII file B but only to nodes where A != 0 |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **POP** | 1 0 | Delete top element from the stack |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **PLM** | 3 1 | Associated Legendre polynomial P(A) degree B order C |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **PLMg** | 3 1 | Normalized associated Legendre polynomial P(A) degree B order C (geophysical convention) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **POW** | 2 1 | A ^ B |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **PQUANT** | 2 1 | The B'th Quantile (0-100%) of A |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **PSI** | 1 1 | Psi (or Digamma) of A |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **PV** | 3 1 | Legendre function Pv(A) of degree v = real(B) + imag(C) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **QV** | 3 1 | Legendre function Qv(A) of degree v = real(B) + imag(C) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **R2** | 2 1 | R2 = A^2 + B^2 |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **R2D** | 1 1 | Convert Radians to Degrees |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **RAND** | 2 1 | Uniform random values between A and B |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **RINT** | 1 1 | rint (A) (round to integral value nearest to A) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **ROTX** | 2 1 | Rotate A by the (constant) shift B in x-direction |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **ROTY** | 2 1 | Rotate A by the (constant) shift B in y-direction |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **SDIST** | 2 1 | Spherical (Great circle|geodesic) distance (in km) between nodes and stack (A, B) :ref:`(...) <SDIST>` |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **SAZ** | 2 1 | Spherical azimuth from grid nodes to stack lon, lat (i.e., A, B) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **SBAZ** | 2 1 | Spherical backazimuth from grid nodes to stack lon, lat (i.e., A, B) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **SEC** | 1 1 | sec (A) (A in radians) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **SECD** | 1 1 | sec (A) (A in degrees) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **SIGN** | 1 1 | sign (+1 or -1) of A |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **SIN** | 1 1 | sin (A) (A in radians) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **SINC** | 1 1 | sinc (A) (sin (pi\*A)/(pi\*A)) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **SIND** | 1 1 | sin (A) (A in degrees) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **SINH** | 1 1 | sinh (A) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **SKEW** | 1 1 | Skewness of A |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **SQR** | 1 1 | A^2 |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **SQRT** | 1 1 | sqrt (A) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **STD** | 1 1 | Standard deviation of A |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **STEP** | 1 1 | Heaviside step function: H(A) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **STEPX** | 1 1 | Heaviside step function in x: H(x-A) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **STEPY** | 1 1 | Heaviside step function in y: H(y-A) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **SUB** | 2 1 | A - B |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **SUM** | 1 1 | Sum of all values in A |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **TAN** | 1 1 | tan (A) (A in radians) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **TAND** | 1 1 | tan (A) (A in degrees) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **TANH** | 1 1 | tanh (A) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **TAPER** | 2 1 | Unit weights cosine-tapered to zero within A and B of x and y grid margins |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **TN** | 2 1 | Chebyshev polynomial Tn(-1<t<+1,n), with t = A, and n = B |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **TCRIT** | 2 1 | Critical value for Student's t-distribution, with alpha = A and n = B |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **TDIST** | 2 1 | Student's t-distribution A(t,n), with t = A, and n = B |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **UPPER** | 1 1 | The highest (maximum) value of A |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **XOR** | 2 1 | 0 if A == NaN and B == NaN, NaN if B == NaN, else A |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **Y0** | 1 1 | Bessel function of A (2nd kind, order 0) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **Y1** | 1 1 | Bessel function of A (2nd kind, order 1) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **YLM** | 2 2 | Re and Im orthonormalized spherical harmonics degree A order B |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **YLMg** | 2 2 | Cos and Sin normalized spherical harmonics degree A order B (geophysical convention) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **YN** | 2 1 | Bessel function of A (2nd kind, order B) |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **ZCRIT** | 1 1 | Critical value for the normal-distribution, with alpha = A |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-| **ZDIST** | 1 1 | Cumulative normal-distribution C(x), with x = A |
-+---------------+-------+--------------------------------------------------------------------------------------------------------+
-
-Symbols
--------
-
-The following symbols have special meaning:
-
-+-------------+-------------------------------------------------+
-| **PI** | 3.1415926... |
-+-------------+-------------------------------------------------+
-| **E** | 2.7182818... |
-+-------------+-------------------------------------------------+
-| **EULER** | 0.5772156... |
-+-------------+-------------------------------------------------+
-| **XMIN** | Minimum x value |
-+-------------+-------------------------------------------------+
-| **XMAX** | Maximum x value |
-+-------------+-------------------------------------------------+
-| **XINC** | x increment |
-+-------------+-------------------------------------------------+
-| **NX** | The number of x nodes |
-+-------------+-------------------------------------------------+
-| **YMIN** | Minimum y value |
-+-------------+-------------------------------------------------+
-| **YMAX** | Maximum y value |
-+-------------+-------------------------------------------------+
-| **YINC** | y increment |
-+-------------+-------------------------------------------------+
-| **NY** | The number of y nodes |
-+-------------+-------------------------------------------------+
-| **X** | Grid with x-coordinates |
-+-------------+-------------------------------------------------+
-| **Y** | Grid with y-coordinates |
-+-------------+-------------------------------------------------+
-| **Xn** | Grid with normalized [-1 to +1] x-coordinates |
-+-------------+-------------------------------------------------+
-| **Yn** | Grid with normalized [-1 to +1] y-coordinates |
-+-------------+-------------------------------------------------+
-
-Notes On Operators
-------------------
-
-#. The operator **SDIST** calculates spherical distances in km between the
- (lon, lat) point on the stack and all node positions in the grid. The
- grid domain and the (lon, lat) point are expected to be in degrees.
- Similarly, the **SAZ** and **SBAZ** operators calculate spherical
- azimuth and back-azimuths in degrees, respectively. The operators
- **LDIST** and **PDIST** compute spherical distances in km if **-fg** is
- set or implied, else they return Cartesian distances. Note: If the current
- :ref:`PROJ_ELLIPSOID <Projection Parameters>` is ellipsoidal then
- geodesics are used in calculations of distances, which can be slow.
- You can trade speed with accuracy by changing the algorithm used to
- compute the geodesic (see :ref:`PROJ_GEODESIC <Projection Parameters>`).
-
-#. The operator **PLM** calculates the associated Legendre polynomial
- of degree L and order M (0 <= M <= L), and its argument is the sine of
- the latitude. **PLM** is not normalized and includes the Condon-Shortley
- phase (-1)^M. **PLMg** is normalized in the way that is most commonly
- used in geophysics. The C-S phase can be added by using -M as argument.
- **PLM** will overflow at higher degrees, whereas **PLMg** is stable
- until ultra high degrees (at least 3000).
-
-#. The operators **YLM** and **YLMg** calculate normalized spherical
- harmonics for degree L and order M (0 <= M <= L) for all positions in
- the grid, which is assumed to be in degrees. **YLM** and **YLMg** return
- two grids, the real (cosine) and imaginary (sine) component of the
- complex spherical harmonic. Use the **POP** operator (and **EXCH**) to
- get rid of one of them, or save both by giving two consecutive = file.nc calls.
-
- The orthonormalized complex harmonics **YLM** are most commonly used in
- physics and seismology. The square of **YLM** integrates to 1 over a
- sphere. In geophysics, **YLMg** is normalized to produce unit power when
- averaging the cosine and sine terms (separately!) over a sphere (i.e.,
- their squares each integrate to 4 pi). The Condon-Shortley phase (-1)^M
- is not included in **YLM** or **YLMg**, but it can be added by using -M
- as argument.
-
-#. All the derivatives are based on central finite differences, with
- natural boundary conditions.
-
-#. Files that have the same names as some operators, e.g., **ADD**,
- **SIGN**, **=**, etc. should be identified by prepending the current
- directory (i.e., ./LOG).
-
-#. Piping of files is not allowed.
-
-#. The stack depth limit is hard-wired to 100.
-
-#. All functions expecting a positive radius (e.g., **LOG**, **KEI**,
- etc.) are passed the absolute value of their argument. (9) The bitwise
- operators (**BITAND**, **BITLEFT**, **BITNOT**, **BITOR**, **BITRIGHT**,
- **BITTEST**, and **BITXOR**) convert a grid's single precision values to
- unsigned 32-bit ints to perform the bitwise operations. Consequently,
- the largest whole integer value that can be stored in a float grid is
- 2^24 or 16,777,216. Any higher result will be masked to fit in the lower
- 24 bits. Thus, bit operations are effectively limited to 24 bit. All
- bitwise operators return NaN if given NaN arguments or bit-settings <= 0.
-
-.. include:: explain_float.rst_
-
-.. include:: explain_grd_inout.rst_
-
-.. include:: explain_grd_coord.rst_
-
-.. include:: explain_sto_rcl_clr.rst_
-
-Macros
-------
-
-Users may save their favorite operator combinations as macros via the
-file *grdmath.macros* in their current or user directory. The file may contain
-any number of macros (one per record); comment lines starting with # are
-skipped. The format for the macros is **name** = **arg1 arg2 ... arg2**
-: *comment* where **name** is how the macro will be used. When this
-operator appears on the command line we simply replace it with the
-listed argument list. No macro may call another macro. As an example,
-the following macro expects three arguments (radius x0 y0) and sets the
-modes that are inside the given circle to 1 and those outside to 0:
-
-INCIRCLE = CDIST EXCH DIV 1 LE : usage: r x y INCIRCLE to return 1
-inside circle
-
-Note: Because geographic or time constants may be present in a macro, it
-is required that the optional comment flag (:) must be followed by a space.
-
-Examples
---------
-
-.. include:: grdmath_examples.rst_
-
-To take log10 of the average of 2 files, use
-
- ::
-
- gmt grdmath file1.nc file2.nc ADD 0.5 MUL LOG10 = file3.nc
-
-Given the file ages.nc, which holds seafloor ages in m.y., use the
-relation depth(in m) = 2500 + 350 \* sqrt (age) to estimate normal seafloor depths:
-
- ::
-
- gmt grdmath ages.nc SQRT 350 MUL 2500 ADD = depths.nc
-
-To find the angle a (in degrees) of the largest principal stress from
-the stress tensor given by the three files s_xx.nc s_yy.nc, and
-s_xy.nc from the relation tan (2\*a) = 2 \* s_xy / (s_xx - s_yy), use
-
- ::
-
- gmt grdmath 2 s_xy.nc MUL s_xx.nc s_yy.nc SUB DIV ATAN 2 DIV = direction.nc
-
-To calculate the fully normalized spherical harmonic of degree 8 and
-order 4 on a 1 by 1 degree world map, using the real amplitude 0.4 and
-the imaginary amplitude 1.1:
-
- ::
-
- gmt grdmath -R0/360/-90/90 -I1 8 4 YML 1.1 MUL EXCH 0.4 MUL ADD = harm.nc
-
-To extract the locations of local maxima that exceed 100 mGal in the file faa.nc:
-
- ::
-
- gmt grdmath faa.nc DUP EXTREMA 2 EQ MUL DUP 100 GT MUL 0 NAN = z.nc
- gmt grd2xyz z.nc -s > max.xyz
-
-To demonstrate the use of named variables, consider this radial wave
-where we store and recall the normalized radial arguments in radians:
-
- ::
-
- gmt grdmath -R0/10/0/10 -I0.25 5 5 CDIST 2 MUL PI MUL 5 DIV STO at r COS @r SIN MUL = wave.nc
-
-References
-----------
-
-Abramowitz, M., and I. A. Stegun, 1964, *Handbook of Mathematical
-Functions*, Applied Mathematics Series, vol. 55, Dover, New York.
-
-Holmes, S. A., and W. E. Featherstone, 2002, A unified approach to the
-Clenshaw summation and the recursive computation of very high degree and
-order normalised associated Legendre functions. *Journal of Geodesy*,
-76, 279-299.
-
-Press, W. H., S. A. Teukolsky, W. T. Vetterling, and B. P. Flannery,
-1992, *Numerical Recipes*, 2nd edition, Cambridge Univ., New York.
-
-Spanier, J., and K. B. Oldman, 1987, *An Atlas of Functions*, Hemisphere
-Publishing Corp.
-
-See Also
---------
-
-:doc:`gmt`, :doc:`gmtmath`,
-:doc:`grd2xyz`, :doc:`grdedit`,
-:doc:`grdinfo`, :doc:`xyz2grd`
diff --git a/doc_release/html/_sources/grdpaste.txt b/doc_release/html/_sources/grdpaste.txt
deleted file mode 100644
index 75cac2f..0000000
--- a/doc_release/html/_sources/grdpaste.txt
+++ /dev/null
@@ -1,74 +0,0 @@
-.. index:: ! grdpaste
-
-********
-grdpaste
-********
-
-.. only:: not man
-
- grdpaste - Join two grids along their common edge
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**grdpaste** *file_a.nc file_b.nc* **-G**\ *outfile.nc*
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-f| ]
-
-|No-spaces|
-
-Description
------------
-
-**grdpaste** will combine *file_a.nc* and *file_b.nc* into
-*outfile.nc* by pasting them together along their common edge. Files
-*file_a.nc* and *file_b.nc* must have the same dx, dy and have one
-edge in common. If in doubt, check with **grdinfo** and use **grdcut**
-and/or **grdsample** if necessary to prepare the edge joint. Note: For
-geographical grids, you may have to use **-f** to handle periodic longitudes
-unless the input grids are properly recognized as such via their meta-data.
-
-Required Arguments
-------------------
-
-*file_a.nc*
- One of two files to be pasted together.
-*file_b.nc*
- The other of two files to be pasted together.
-**-G**\ *outfile.nc*
- The name for the combined output.
-
-Optional Arguments
-------------------
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_grd_inout.rst_
-
-Examples
---------
-
-Suppose file_a.nc is 150E - 180E and 0 - 30N, and file_b.nc is 150E -
-180E, -30S - 0, then you can make outfile.nc which will be 150 - 180 and
--30S - 30N by:
-
- ::
-
- gmt grdpaste file_a.nc file_b.nc -Goutfile.nc -V -fg
-
-See Also
---------
-
-:doc:`gmt`, :doc:`grdblend`,
-:doc:`grdclip`,
-:doc:`grdcut`,
-:doc:`grdinfo`,
-:doc:`grdsample`
diff --git a/doc_release/html/_sources/grdproject.txt b/doc_release/html/_sources/grdproject.txt
deleted file mode 100644
index 4d8e38a..0000000
--- a/doc_release/html/_sources/grdproject.txt
+++ /dev/null
@@ -1,150 +0,0 @@
-.. index:: ! grdproject
-
-**********
-grdproject
-**********
-
-.. only:: not man
-
- grdproject - Forward and inverse map transformation of grids
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**grdproject** *in_grdfile* **-G**\ *out_grdfile* **-J**\ *parameters*
-[ **-A**\ [**c\|i\|p\|e\|f\|k\|M\|n\|u**\ ] ] [ **-C**\ [*dx/dy*] ] [
-**-D**\ *xinc*\ [*unit*][\ **=**\ \|\ **+**][/\ *yinc*\ [*unit*\ ][\ **=**\ \|\ **+**]]
-] [ **-E**\ *dpi* ] [ **-I** ] [ **-Mc**\ \|\ **i**\ \|\ **p** ] [
-[ |SYN_OPT-R| ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-n| ]
-[ **-r** ]
-
-|No-spaces|
-
-Description
------------
-
-**grdproject** will do one of two things depending whether **-I** has
-been set. If set, it will transform a gridded data set from a
-rectangular coordinate system onto a geographical system by resampling
-the surface at the new nodes. If not set, it will project a geographical
-gridded data set onto a rectangular grid. To obtain the value at each
-new node, its location is inversely projected back onto the input grid
-after which a value is interpolated between the surrounding input grid
-values. By default bi-cubic interpolation is used. Aliasing is avoided
-by also forward projecting the input grid nodes. If two or more nodes
-are projected onto the same new node, their average will dominate in the
-calculation of the new node value. Interpolation and aliasing is
-controlled with the **-n** option. The new node spacing may be
-determined in one of several ways by specifying the grid spacing, number
-of nodes, or resolution. Nodes not constrained by input data are set to
-NaN.
-
-The **-R** option can be used to select a map region larger or smaller
-than that implied by the extent of the grid file.
-
-Required Arguments
-------------------
-
-*in_grdfile*
- 2-D binary grid file to be transformed. (See GRID FILE FORMATS below.)
-
-**-G**\ *out_grdfile*
- Specify the name of the output grid file. (See GRID FILE FORMATS below.)
-
-.. include:: explain_-J.rst_
-
-Optional Arguments
-------------------
-
-**-A**\ [**c\|i\|p\|e\|f\|k\|M\|n\|u**\ ]
- Force 1:1 scaling, i.e., output (or input, see **-I**) data are in
- actual projected meters [**e**\ ]. To specify other units, append
- **f** (foot), **k** (km), **M** (statute mile), **n** (nautical
- mile), **u** (US survey foot), **i** (inch), **c** (cm), or **p**
- (point). Without **-A**, the output (or input, see **-I**) are in
- the units specified by :ref:`PROJ_LENGTH_UNIT <PROJ_LENGTH_UNIT>` (but see **-M**).
-
-**-C**\ [*dx/dy*\ ]
- Let projected coordinates be relative to projection center [Default
- is relative to lower left corner]. Optionally, add offsets in the
- projected units to be added (or subtracted when **-I** is set) to
- (from) the projected coordinates, such as false eastings and
- northings for particular projection zones [0/0].
-
-**-D**\ *xinc*\ [*unit*\ ][\ **=**\ \|\ **+**][/\ *yinc*\ [*unit*\ ][\ **=**\ \|\ **+**]]
- Set the grid spacing for the new grid. Append **m** for arc minute,
- **s** for arc second. If neither **-D** nor **-E** are set then we
- select the same number of output nodes as there are input nodes.
-
-**-E**\ *dpi*
- Set the resolution for the new grid in dots per inch.
-
-**-I**
- Do the Inverse transformation, from rectangular to geographical.
-
-**-Mc**\ \|\ **i**\ \|\ **p**
- Append **c**, **i**, or **p** to indicate that cm, inch, or point
- should be the projected measure unit [Default is set by
- :ref:`PROJ_LENGTH_UNIT <PROJ_LENGTH_UNIT>` in :doc:`gmt.conf`]. Cannot be used with **-A**.
-
-.. |Add_-R| replace:: You may ask to project only
- a subset of the grid by specifying a smaller input *w/e/s/n* region
- [Default is the region given by the grid file].
-.. include:: explain_-R.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. include:: explain_-n.rst_
-
-.. |Add_nodereg| unicode:: 0x20 .. just an invisible code
-.. include:: explain_nodereg.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_grd_inout.rst_
-
-Examples
---------
-
-To transform the geographical grid dbdb5.nc onto a pixel Mercator grid
-at 300 dpi, run
-
- ::
-
- gmt grdproject dbdb5.nc -R20/50/12/25 -Jm0.25i -E300 -r -Gdbdb5_merc.nc
-
-To inversely transform the file topo_tm.nc back onto a geographical grid, use
-
- ::
-
- gmt grdproject topo_tm.nc -R-80/-70/20/40 -Jt-75/1:500000 -I -D5m -V -Gtopo.nc
-
-This assumes, of course, that the coordinates in topo_tm.nc were
-created with the same projection parameters.
-
-To inversely transform the file topo_utm.nc (which is in UTM meters)
-back to a geographical grid we specify a one-to-one mapping with meter
-as the measure unit:
-
- ::
-
- gmt grdproject topo_utm.nc -R203/205/60/65 -Ju5/1:1 -I -Mm -Gtopo.nc -V
-
-Restrictions
-------------
-
-The boundaries of a projected (rectangular) data set will not
-necessarily give rectangular geographical boundaries (Mercator is one
-exception). In those cases some nodes may be unconstrained (set to NaN).
-To get a full grid back, your input grid may have to cover a larger area
-than you are interested in.
-
-See Also
---------
-
-:doc:`gmt`, :doc:`gmt.conf`, :doc:`mapproject`
diff --git a/doc_release/html/_sources/grdraster.txt b/doc_release/html/_sources/grdraster.txt
deleted file mode 100644
index 5aad890..0000000
--- a/doc_release/html/_sources/grdraster.txt
+++ /dev/null
@@ -1,121 +0,0 @@
-.. index:: ! grdraster
-
-*********
-grdraster
-*********
-
-.. only:: not man
-
- grdraster - Extract subregion from a binary raster and save as a GMT grid
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**grdraster** [ *filenumber* \| *"text pattern"* ]
-|SYN_OPT-R|
-[ **-G**\ *grdfile* ]
-[ |SYN_OPT-I| ]
-[ **-J**\ *parameters* ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-bo| ]
-[ |SYN_OPT-o| ]
-
-|No-spaces|
-
-Description
------------
-
-**grdraster** reads a file called *grdraster.info* from the current
-working directory, the directories pointed to by the environment
-variables **$GMT_USERDIR** and **$GMT_DATADIR**, or in
-**$GMT_SHAREDIR**/dbase (in that order). The file *grdraster.info*
-defines binary arrays of data stored in scan-line format in data files.
-Each file is given a *filenumber* in the info file. **grdraster**
-figures out how to load the raster data into a grid file spanning a
-region defined by **-R**. By default the grid spacing equals the raster
-spacing. The **-I** option may be used to sub-sample the raster data. No
-filtering or interpolating is done, however; the *x_inc* and *y_inc*
-of the grid must be multiples of the increments of the raster file and
-**grdraster** simply takes every n'th point. The output of **grdraster**
-is either grid or pixel registered depending on the registration of the
-raster used. It is up to the GMT system person to maintain the
-*grdraster.info* file in accordance with the available rasters at each
-site. Raster data sets are not supplied with GMT but can be obtained
-by anonymous ftp and on CD-ROM (see README page in dbase directory).
-**grdraster** will list the available files if no arguments are given.
-Finally, **grdraster** will write xyz-triplets to stdout if no output
-gridfile name is given
-
-Required Arguments
-------------------
-
-*filenumber*
- If an integer matching one of the files listed in the
- *grdraster.info* file is given we will use that data set, else we
- will match the given text pattern with the data set description in
- order to determine the data set.
-
-.. |Add_-Rgeo| replace:: If **r** is appended, you may also specify a
- map projection to define the shape of your region. The output region
- will be rounded off to the nearest whole grid-step in both dimensions.
-.. include:: explain_-Rgeo.rst_
-
-Optional Arguments
-------------------
-
-**-G**\ *grdfile*
- Name of output grid file. If not set, the grid will be written as
- ASCII (or binary; see **-bo**) xyz-triplets
- to stdout instead.
-
-.. include:: explain_-I.rst_
-
-.. include:: explain_-J.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. |Add_-bo| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-bo.rst_
-
-.. include:: explain_-ocols.rst_
-|
-| This option applies only if no **-G** option has been set.
-
-.. include:: explain_help.rst_
-
-Examples
---------
-
-To extract data from raster 1, taking one point every 30 minutes, in an
-area extended beyond 360 degrees to allow later filtering, run
-
- ::
-
- gmt grdraster 1 -R-4/364/-62/62 -I30m -Gdata.nc
-
-To obtain data for an oblique Mercator projection we need to extract
-more data that is actually used. This is necessary because the output of
-**grdraster** has edges defined by parallels and meridians, while the
-oblique map in general does not. Hence, to get all the data from the
-ETOPO2 data needed to make a contour map for the region defined by its
-lower left and upper right corners and the desired projection, use
-
- ::
-
- gmt grdraster ETOPO2 -R160/20/220/30r -Joc190/25.5/292/69/1 -Gdata.nc
-
-To extract data from the 2 min Geoware relief blend and write it as
-binary double precision xyz-triplets to standard output:
-
- ::
-
- gmt grdraster "2 min Geoware" -R20/25/-10/5 -bo > triplets.b
-
-See Also
---------
-
-:doc:`gmtdefaults`, :doc:`gmt`,
-:doc:`grdsample`, :doc:`grdfilter`
diff --git a/doc_release/html/_sources/grdreformat.txt b/doc_release/html/_sources/grdreformat.txt
deleted file mode 100644
index 35f6dfd..0000000
--- a/doc_release/html/_sources/grdreformat.txt
+++ /dev/null
@@ -1,269 +0,0 @@
-.. index:: ! grdreformat
-
-***********
-grdreformat
-***********
-
-.. only:: not man
-
- grdreformat - Convert between different grid formats
-
-`Synopsis <#toc1>`_
--------------------
-
-.. include:: common_SYN_OPTs.rst_
-
-**grdreformat** *ingrdfile*\ [*=id*\ [*/scale/offset*\ [*/NaNvalue*]]]
-*outgrdfile*\ [*=id*\ [*/scale/offset*\ [*/NaNvalue*]][\ *:driver*\ [*/datatype*]]]
-[ **-N** ]
-[ |SYN_OPT-R| ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-f| ]
-
-|No-spaces|
-
-Description
------------
-
-**grdreformat** reads a grid file in one format and writes it out using
-another format. As an option the user may select a subset of the data to
-be written and to specify scaling, translation, and NaN-value.
-
-Required Arguments
-------------------
-
-*ingrdfile*
- The grid file to be read. Append format =\ *id* code if not a
- standard COARDS-compliant netCDF grid file. If =\ *id* is set (see
- below), you may optionally append *scale* and *offset*. These
- options will scale the data and then offset them with the specified
- amounts after reading.
- If *scale* and *offset* are supplied you may also append a value
- that represents 'Not-a-Number' (for floating-point grids this is
- unnecessary since the IEEE NaN is used; however integers need a
- value which means no data available). The *scale* and *offset*
- modifiers may be left empty to select default values (scale = 1,
- offset = 0).
-
-*outgrdfile*
- The grid file to be written. Append format =\ *id* code if not a
- standard COARDS-compliant netCDF grid file. If =\ *id* is set (see
- below), you may optionally append *scale* and *offset*. These
- options are particularly practical when storing the data as
- integers, first removing an offset and then scaling down the values.
- Since the scale and offset are applied in reverse order when
- reading, this does not affect the data values (except for
- round-offs).
-
- If *scale* and *offset* are supplied you may also append a value
- that represents 'Not-a-Number' (for floating-point grids this is
- unnecessary since the IEEE NaN is used; however integers need a
- value which means no data available). The *scale* and *offset*
- modifiers may be left empty to select default values (scale = 1,
- offset = 0), or you may specify *a* for auto-adjusting the scale
- and/or offset of packed integer grids (=\ *id/a* is a shorthand for
- =\ *id/a/a*). When *id*\ =\ *gd*, the file will be saved using the
- GDAL library. Append the format *:driver* and optionally the output
- *datatype*. The driver names are those used by GDAL itself (e.g.,
- netCDF, GTiFF, etc.), and the data type is one of
- *u8*\ \|\ *u16*\ \|\ *i16*\ \|\ *u32*\ \|\ *i32*\ \|\ *float32*,
- where 'i' and 'u' denote signed and unsigned integers respectively.
- The default type is *float32*. Note also that both driver names and
- data types are case insensitive.
-
- Consider setting :ref:`IO_NC4_DEFLATION_LEVEL <IO_NC4_DEFLATION_LEVEL>`
- to reduce file size and to further increase read/write performace.
- Especially when working with subsets of global grids, masks, and grids with
- repeating grid values, the improvement is usually significant.
-
-Optional Arguments
-------------------
-
-**-N**
- Suppress the writing of the GMT header structure. This is useful
- when you want to write a native grid to be used by **grdraster**. It
- only applies to native grids and is ignored for netCDF output.
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-R.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. include:: explain_help.rst_
-
-Format Identifier
------------------
-
-By default, grids will be written as floating point data stored in
-binary files using the netCDF format and meta-data structure. This
-format is conform the COARDS conventions. GMT versions prior to 4.1
-produced netCDF files that did not conform to these conventions.
-Although these files are still supported, their use is deprecated. To
-write other than floating point COARDS-compliant netCDF files, append
-the =\ *id* suffix to the filename *outgrdfile*.
-
-When reading files, **grdreformat** and other GMT programs will try
-to automatically recognize the type of the input grid file. If this
-fails you may append the =\ *id* suffix to the filename *ingrdfile*.
-
-+----------+---------------------------------------------------------------+
-| ID | Explanation |
-+----------+---------------------------------------------------------------+
-| **nb** | GMT netCDF format (8-bit integer, COARDS, CF-1.5) |
-+----------+---------------------------------------------------------------+
-| **ns** | GMT netCDF format (16-bit integer, COARDS, CF-1.5) |
-+----------+---------------------------------------------------------------+
-| **ni** | GMT netCDF format (32-bit integer, COARDS, CF-1.5) |
-+----------+---------------------------------------------------------------+
-| **nf** | GMT netCDF format (32-bit float, COARDS, CF-1.5) |
-+----------+---------------------------------------------------------------+
-| **nd** | GMT netCDF format (64-bit float, COARDS, CF-1.5) |
-+----------+---------------------------------------------------------------+
-| **cb** | GMT netCDF format (8-bit integer, deprecated) |
-+----------+---------------------------------------------------------------+
-| **cs** | GMT netCDF format (16-bit integer, deprecated) |
-+----------+---------------------------------------------------------------+
-| **ci** | GMT netCDF format (32-bit integer, deprecated) |
-+----------+---------------------------------------------------------------+
-| **cf** | GMT netCDF format (32-bit float, deprecated) |
-+----------+---------------------------------------------------------------+
-| **cd** | GMT netCDF format (64-bit float, deprecated) |
-+----------+---------------------------------------------------------------+
-| **bm** | GMT native, C-binary format (bit-mask) |
-+----------+---------------------------------------------------------------+
-| **bb** | GMT native, C-binary format (8-bit integer) |
-+----------+---------------------------------------------------------------+
-| **bs** | GMT native, C-binary format (16-bit integer) |
-+----------+---------------------------------------------------------------+
-| **bi** | GMT native, C-binary format (32-bit integer) |
-+----------+---------------------------------------------------------------+
-| **bf** | GMT native, C-binary format (32-bit float) |
-+----------+---------------------------------------------------------------+
-| **bd** | GMT native, C-binary format (64-bit float) |
-+----------+---------------------------------------------------------------+
-| **rb** | SUN rasterfile format (8-bit standard) |
-+----------+---------------------------------------------------------------+
-| **rf** | GEODAS grid format GRD98 (NGDC) |
-+----------+---------------------------------------------------------------+
-| **sf** | Golden Software Surfer format 6 (32-bit float) |
-+----------+---------------------------------------------------------------+
-| **sd** | Golden Software Surfer format 7 (64-bit float, read-only) |
-+----------+---------------------------------------------------------------+
-| **af** | Atlantic Geoscience Center format AGC (32-bit float) |
-+----------+---------------------------------------------------------------+
-| **ei** | ESRI Arc/Info ASCII Grid Interchange format (ASCII integer) |
-+----------+---------------------------------------------------------------+
-| **ef** | ESRI Arc/Info ASCII Grid Interchange format (ASCII float) |
-+----------+---------------------------------------------------------------+
-| **gd** | Import/export through GDAL |
-+----------+---------------------------------------------------------------+
-
-Gmt Standard Netcdf Files
--------------------------
-
-The standard format used for grdfiles is based on netCDF and conforms to
-the COARDS conventions. Files written in this format can be read by
-numerous third-party programs and are platform-independent. Some
-disk-space can be saved by storing the data as bytes or shorts in stead
-of integers. Use the *scale* and *offset* parameters to make this work
-without loss of data range or significance. For more details, see
-:ref:`App-file-formats`.
-
-**Multi-variable grid files**
-
-By default, GMT programs will read the first 2-dimensional grid
-contained in a COARDS-compliant netCDF file. Alternatively, use
-*ingrdfile*\ **?**\ *varname* (ahead of any optional suffix **=**\ *id*)
-to specify the requested variable *varname*. Since **?** has special
-meaning as a wildcard, escape this meaning by placing the full filename
-and suffix between quotes.
-
-**Multi-dimensional grids**
-
-To extract one *layer* or *level* from a 3-dimensional grid stored in a
-COARDS-compliant netCDF file, append both the name of the variable and
-the index associated with the layer (starting at zero) in the form:
-*ingrdfile*\ **?**\ *varname*\ **[**\ *layer*\ **]**. Alternatively,
-specify the value associated with that layer using parentheses in stead
-of brackets:
-*ingridfile*\ **?**\ *varname*\ **(**\ *layer*\ **)**.
-
-In a similar way layers can be extracted from 4- or even 5-dimensional
-grids. For example, if a grid has the dimensions (parameter, time,
-depth, latitude, longitude), a map can be selected by using:
-*ingridfile*\ **?**\ *varname*\ **(**\ *parameter*,\ *time*,\ *depth*\ **)**.
-
-Since question marks, brackets and parentheses have special meanings on
-the command line, escape these meanings by placing the full filename and
-suffix between quotes.
-
-Native Binary Files
--------------------
-
-For binary native GMT files the size of the GMT grdheader block
-is *hsize* = 892 bytes, and the total size of the file is *hsize* + *nx*
-\* *ny* \* *item_size*, where *item_size* is the size in bytes of each
-element (1, 2, 4). Bit grids are stored using 4-byte integers, each
-holding 32 bits, so for these files the size equation is modified by
-using ceil (*nx* / 32) \* 4 instead of *nx*. Note that these files are
-platform-dependent. Files written on Little Endian machines (e.g., PCs)
-can not be read on Big Endian machines (e.g., most workstations). Also
-note that it is not possible for GMT to determine uniquely if a
-4-byte grid is float or int; in such cases it is best to use the *=ID*
-mechanism to specify the file format. In all cases a native grid is
-considered to be signed (i.e., there are no provision for unsigned short
-ints or unsigned bytes). For header and grid details, see :ref:`App-file-formats`.
-
-.. include:: explain_float.rst_
-
-Examples
---------
-
-To extract the second layer from a 3-dimensional grid named temp from a
-COARDS-compliant netCDF file climate.nc:
-
- ::
-
- gmt grdreformat climate.nc?temp[1] temp.nc -V
-
-To create a 4-byte native floating point grid from the COARDS-compliant
-netCDF file data.nc:
-
- ::
-
- gmt grdreformat data.nc ras_data.b4=bf -V
-
-To make a 2-byte short integer file, scale it by 10, subtract 32000,
-setting NaNs to -9999, do
-
- ::
-
- gmt grdreformat values.nc shorts.i2=bs/10/-32000/-9999 -V
-
-To create a Sun standard 8-bit rasterfile for a subset of the data file
-image.nc, assuming the range in image.nc is 0-1 and we need 0-255, run
-
- ::
-
- gmt grdreformat image.nc -R-60/-40/-40/-30 image.ras8=rb/255/0 -V
-
-To convert etopo2.nc to etopo2.i2 that can be used by **grdraster**, try
-
- ::
-
- gmt grdreformat etopo2.nc etopo2.i2=bs -N -V
-
-To creat a dumb file saved as a 32 bits float GeoTiff using GDAL, run
-
- ::
-
- gmt grdmath -Rd -I10 X Y MUL = lixo.tiff=gd:GTiff
-
-See Also
---------
-
-:doc:`gmt.conf`, :doc:`gmt`, :doc:`grdmath`
diff --git a/doc_release/html/_sources/grdsample.txt b/doc_release/html/_sources/grdsample.txt
deleted file mode 100644
index 853372d..0000000
--- a/doc_release/html/_sources/grdsample.txt
+++ /dev/null
@@ -1,113 +0,0 @@
-.. index:: ! grdsample
-
-*********
-grdsample
-*********
-
-.. only:: not man
-
- grdsample - Resample a grid onto a new lattice
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**grdsample** *in_grdfile* **-G**\ *out_grdfile*
-[ |SYN_OPT-I| ]
-[ |SYN_OPT-R| ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-n| ]
-[ **-r** ]
-
-|No-spaces|
-
-Description
------------
-
-**grdsample** reads a grid file and interpolates it to create a new grid
-file with either: a different registration (**-r** or **-T**); or, a new
-grid-spacing or number of nodes (**-I**), and perhaps also a new
-sub-region (**-R**). A bicubic [Default], bilinear, B-spline or
-nearest-neighbor interpolation is used; see **-n** for settings. Note
-that using **-R** only is equivalent to **grdcut** or **grdedit -S**.
-**grdsample** safely creates a fine mesh from a coarse one; the converse
-may suffer aliasing unless the data are filtered using **grdfft** or
-**grdfilter**.
-
-When **-R** is omitted, the output grid will cover the same region as
-the input grid. When **-I** is omitted, the grid spacing of the output
-grid will be the same as the input grid. Either **-r** or **-T** can be
-used to change the grid registration. When omitted, the output grid will
-have the same registration as the input grid.
-
-Required Arguments
-------------------
-
-*in\_grdfile*
- The name of the input 2-D binary grid file. (See GRID FILE FORMAT below.)
-
-**-G**\ *out\_grdfile*
- The name of the output grid file. (See GRID FILE FORMAT below.)
-
-Optional Arguments
-------------------
-
-.. include:: explain_-I.rst_
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-R.rst_
-
-**-T**
- Translate between grid and pixel registration; if the input is
- grid-registered, the output will be pixel-registered and vice-versa.
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. include:: explain_-n.rst_
-
-.. |Add_nodereg| unicode:: 0x20 .. just an invisible code
-.. include:: explain_nodereg.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_float.rst_
-
-.. include:: explain_grd_inout.rst_
-
-.. include:: explain_grdresample2.rst_
-
-Hints
------
-
-If an interpolation point is not on a node of the input grid, then a NaN
-at any node in the neighborhood surrounding the point will yield an
-interpolated NaN. Bicubic interpolation [default] yields continuous
-first derivatives but requires a neighborhood of 4 nodes by 4 nodes.
-Bilinear interpolation [**-n**] uses only a 2 by 2 neighborhood, but
-yields only zero-order continuity. Use bicubic when smoothness is
-important. Use bilinear to minimize the propagation of NaNs.
-
-Examples
---------
-
-To resample the 5 x 5 minute grid in hawaii_5by5_topo.nc onto a 1 minute grid:
-
- ::
-
- gmt grdsample hawaii_5by5_topo.nc -I1m -Ghawaii_1by1_topo.nc
-
-To translate the gridline-registered file surface.nc to pixel
-registration while keeping the same region and grid interval:
-
- ::
-
- gmt grdsample surface.nc -T -Gpixel.nc
-
-See Also
---------
-
-:doc:`gmt`, :doc:`grdedit`,
-:doc:`grdfft`, :doc:`grdfilter`
diff --git a/doc_release/html/_sources/grdtrack.txt b/doc_release/html/_sources/grdtrack.txt
deleted file mode 100644
index 96edb9f..0000000
--- a/doc_release/html/_sources/grdtrack.txt
+++ /dev/null
@@ -1,275 +0,0 @@
-.. index:: ! grdtrack
-
-********
-grdtrack
-********
-
-.. only:: not man
-
- grdtrack - Sample grids at specified (x,y) locations
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**grdtrack** [ *xyfile* ] **-G**\ *grd1* **-G**\ *grd2* ...
-[ **-A**\ **f**\ \|\ **p**\ \|\ **m**\ \|\ **r**\ \|\ **R**\ [**+l**] ]
-[ **-C**\ *length*\ [**u**]/\ *ds*\ [*spacing*][**+a**] ] [**-D**\ *dfile* ]
-[ **-E**\ *line*\ [,\ *line*,...][**+a**\ *az*][**+d**][**+i**\ *inc*\ [**u**]][**+l**\ *length*\ [**u**]][**+n**\ *np*][**+o**\ *az*][**+r**\ *radius*\ [**u**] ]
-[ **-N** ]
-[ |SYN_OPT-R| ]
-[ **-S**\ *method*/*modifiers* ] [ **-T**\ [*radius*\ [**u**]][**+e**\ \|\ **p**]]
-[ **-V**\ [*level*] ] [ **-Z** ]
-[ **-b**\ [*ncol*][**t**][\ **+L**\ \|\ **+B**] ]
-[ **-f**\ [**i**\ \|\ **o**]\ *colinfo* ]
-[ |SYN_OPT-g| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-n| ]
-[ **-o**\ *cols*\ [,...] ] [ **-s**\ [*cols*][\ **a**\ \|\ **r**] ]
-[ **-:**\ [**i**\ \|\ **o**] ]
-
-|No-spaces|
-
-Description
------------
-
-**grdtrack** reads one or more grid files (or a Sandwell/Smith IMG
-files) and a table (from file or standard input; but see **-E** for
-exception) with (x,y) [or (lon,lat)] positions in the first two columns
-(more columns may be present). It interpolates the grid(s) at the
-positions in the table and writes out the table with the interpolated
-values added as (one or more) new columns. Alternatively (**-C**), the
-input is considered to be line-segments and we create orthogonal
-cross-profiles at each data point or with an equidistant separation and
-sample the grid(s) along these profiles. A bicubic [Default], bilinear,
-B-spline or nearest-neighbor (see **-n**) interpolation is used,
-requiring boundary conditions at the limits of the region (see **-n**;
-Default uses "natural" conditions (second partial derivative normal to
-edge is zero) unless the grid is automatically recognized as periodic.)
-
-Required Arguments
-------------------
-
-**-G**\ *gridfile*
- *grdfile* is a 2-D binary grid file with the function f(x,y). If the
- specified grid is in Sandwell/Smith Mercator format you must append
- a comma-separated list of arguments that includes a scale to
- multiply the data (usually 1 or 0.1), the mode which stand for the
- following: (0) Img files with no constraint code, returns data at
- all points, (1) Img file with constraints coded, return data at all
- points, (2) Img file with constraints coded, return data only at
- constrained points and NaN elsewhere, and (3) Img file
- with constraints coded, return 1 at constraints and 0 elsewhere, and
- optionally the max latitude in the IMG file [80.738]. You may repeat
- **-G** as many times as you have grids you wish to sample. The grids
- are sampled and results are output in the order given. (See GRID
- FILE FORMAT below.)
-
-Optional Arguments
-------------------
-
-*xyfile*
- This is an ASCII (or binary, see **-bi**)
- file where the first 2 columns hold the (x,y) positions where the
- user wants to sample the 2-D data set.
-**-A**\ **f**\ \|\ **p**\ **m**\ \|\ **r**\ \|\ **R**
- For track resampling (if **-C** is set) we can select how this is to
- be performed. Append **f** to keep original points, but add
- intermediate points if needed [Default], **m** as **f**, but first
- follow meridian (along y) then parallel (along x), **p** as **f**,
- but first follow parallel (along y) then meridian (along x), **r**
- to resample at equidistant locations; input points are not
- necessarily included in the output, and **R** as **r**, but adjust
- given spacing to fit the track length exactly. Finally, append
- **+l** if distances should be measured along rhumb lines
- (loxodromes). Ignored unless **-C** is used.
-**-C**\ *length*\ [**u**]/\ *ds*\ [*spacing*][**+a**]
- Use input line segments to create an equidistant and (optionally)
- equally-spaced set of crossing profiles along which we sample the
- grid(s) [Default simply samples the grid(s) at the input locations].
- Specify two length scales that control how the sampling is done:
- *length* sets the full length of each cross-profile, while *ds* is
- the sampling spacing along each cross-profile. Optionally, append
- **/**\ *spacing* for an equidistant spacing between cross-profiles
- [Default erects cross-profiles at the input coordinates]. By
- default, all cross-profiles have the same direction. Append **+a**
- to alternate the direction of cross-profiles. Append suitable units
- to *length*; it sets the unit used for *ds* [and *spacing*] (See
- UNITS below). The default unit for geographic grids is meter while
- Cartesian grids implies the user unit. The output columns will be
- *lon*, *lat*, *dist*, *azimuth*, *z1*, *z2*, ..., *zn* (The *zi* are
- the sampled values for each of the *n* grids)
-**-D**\ *dfile*
- In concert with **-C** we can save the (possibly resampled) original
- lines to the file *dfile* [Default only saves the cross-profiles].
- The columns will be *lon*, *lat*, *dist*, *azimuth*, *z1*, *z2*, ...
- (sampled value for each grid)
-**-E**\ *line*\ [,\ *line*,...][**+a**\ *az*][**+d**][**+i**\ *inc*\ [**u**]][**+l**\ *length*\ [**u**]][**+n**\ *np*][**+o**\ *az*][**+r**\ *radius*\ [**u**]
- Instead of reading input track coordinates, specify profiles via
- coordinates and modifiers. The format of each *line* is
- *start*/*stop*, where *start* or *stop* are either *lon*/*lat* (*x*/*y* for
- Cartesian data) or a 2-character XY key that uses the "pstext"-style
- justification format format to specify a point on the map as
- [LCR][BMT]. In addition, you can use Z-, Z+ to mean the global
- minimum and maximum locations in the grid (only available if only
- one grid is given). Instead of two coordinates you can specify an
- origin and one of **+a**, **+o**, or **+r**. You may append
- **+i**\ *inc*\ [**u**] to set the sampling interval; if not given then we default to half the minimum grid interval.
- The **+a** sets the azimuth of a profile of given
- length starting at the given origin, while **+o** centers the profile
- on the origin; both require **+l**. For circular sampling specify
- **+r** to define a circle of given radius centered on the origin;
- this option requires either **+n** or **+i**. The **+n**\ *np* sets
- the desired number of points, while **+l**\ *length* gives the
- total length of the profile. Append **+d** to output the along-track
- distances after the coordinates. Note: No track file will be read.
- Also note that only one distance unit can be chosen. Giving different units
- will result in an error. If no units are specified we default to
- great circle distances in km (if geographic). If working with geographic
- data you can prepend - (Flat Earth) or + (Geodesic) to *inc*, *length*, or *radius*
- to change the mode of distance calculation [Great Circle].
-**-N**
- Do *not* skip points that fall outside the domain of the grid(s)
- [Default only output points within grid domain].
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-R.rst_
-
-**-S**\ *method*/*modifiers*
- In conjunction with **-C**, compute a single stacked profile from
- all profiles across each segment. Append how stacking should be
- computed: **a** = mean (average), **m** = median, **p** = mode
- (maximum likelihood), **l** = lower, **L** = lower but only consider
- positive values, **u** = upper, **U** = upper but only consider
- negative values [**a**]. The *modifiers* control the output;
- choose one or more among these choices: **+a** : Append stacked
- values to all cross-profiles. **+d** : Append stack deviations to
- all cross-profiles. **+d** : Append data residuals (data - stack) to
- all cross-profiles. **+s**\ [*file*] : Save stacked profile to
- *file* [grdtrack\_stacked_profile.txt]. **+c**\ *fact* : Compute
- envelope on stacked profile as +/- *fact*\ \*\ *deviation* [2].
- Notes: (1) Deviations depend on *method* and are st.dev (**a**), L1
- scale (**m** and **p**), or half-range (upper-lower)/2. (2) The
- stacked profile file contains 1 plus groups of 4-6 columns, one
- group for each sampled grid. The first column holds cross distance,
- while the first 4 in a group hold stacked value, deviation, min
- value, and max value. If *method* is one of
- **a**\ \|\ **m**\ \|\ **p** then we also write the lower and upper
- confidence bounds (see **+c**). When one or more of **+a**, **+d**,
- and **+r** are used then we append the results to the end of each
- row for all cross-profiles. The order is always stacked value
- (**+a**), followed by deviations (**+d**) and residuals (**+r**).
- When more than one grid is sampled this sequence of 1-3 columns are
- repeated for each grid.
-
-**-T**\ [*radius*\ [**u**]][**+e**\ \|\ **p**]
- To be used with normal grid sampling, and limited to a single, non-IMG grid.
- If the nearest node to the input point is NaN, search outwards until we find
- the nearest non-NaN node and report that value instead. Optionally specify
- a search radius which limits the consideration to points within this distance
- from the input point. To report the location of the nearest node and its
- distance from the input point, append **+e**. To instead replace the input
- point with the coordinates of the nearest node, append **+p**.
-
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-Z**
- Only write out the sampled z-values [Default writes all columns].
-
-**-:**
- Toggles between (longitude,latitude) and (latitude,longitude)
- input/output. [Default is (longitude,latitude)].
-
-.. |Add_-bi| replace:: [Default is 2 input columns].
-.. include:: explain_-bi.rst_
-
-.. |Add_-bo| replace:: [Default is one more than input].
-.. include:: explain_-bo.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-g| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-g.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. include:: explain_-n.rst_
-
-.. include:: explain_-ocols.rst_
-
-.. include:: explain_-s.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_distunits.rst_
-
-.. include:: explain_precision.rst_
-
-.. include:: explain_grd_inout.rst_
-
-.. include:: explain_grdresample2.rst_
-
-Hints
------
-
-If an interpolation point is not on a node of the input grid, then a NaN
-at any node in the neighborhood surrounding the point will yield an
-interpolated NaN. Bicubic interpolation [default] yields continuous
-first derivatives but requires a neighborhood of 4 nodes by 4 nodes.
-Bilinear interpolation [**-n**] uses only a 2 by 2 neighborhood, but
-yields only zeroth-order continuity. Use bicubic when smoothness is
-important. Use bilinear to minimize the propagation of NaNs, or lower
-*threshold*.
-
-Examples
---------
-
-To sample the file hawaii_topo.nc along the SEASAT track track_4.xyg
-(An ASCII table containing longitude, latitude, and SEASAT-derived
-gravity, preceded by one header record):
-
- ::
-
- grdtrack track_4.xyg -Ghawaii_topo.nc -h > track_4.xygt
-
-To sample the Sandwell/Smith IMG format file topo.8.2.img (2 minute
-predicted bathymetry on a Mercator grid) and the Muller et al age grid
-age.3.2.nc along the lon,lat coordinates given in the file
-cruise_track.xy, try
-
- ::
-
- grdtrack cruise_track.xy -Gtopo.8.2.img,1,1 -Gage.3.2.nc > depths-age.d
-
-To sample the Sandwell/Smith IMG format file grav.18.1.img (1 minute
-free-air anomalies on a Mercator grid) along 100-km-long cross-profiles
-that are orthogonal to the line segment given in the file track.xy,
-erecting cross-profiles every 25 km and sampling the grid every 3 km, try
-
- ::
-
- grdtrack track.xy -Ggrav.18.1.img,0.1,1 -C100k/3/25 -Ar > xprofiles.txt
-
-To sample the grid data.nc along a line from the lower left to the upper
-right corner, using a grid spacing of 1 km, and output distances as well,
-try
-
- ::
-
- grdtrack -ELB/RT+i1k+d -Gdata.nc > profiles.txt
-
-See Also
---------
-
-:doc:`gmt`,
-:doc:`gmtconvert`,
-:doc:`sample1d`,
-:doc:`surface`
diff --git a/doc_release/html/_sources/grdtrend.txt b/doc_release/html/_sources/grdtrend.txt
deleted file mode 100644
index bb9b7e6..0000000
--- a/doc_release/html/_sources/grdtrend.txt
+++ /dev/null
@@ -1,117 +0,0 @@
-.. index:: ! grdtrend
-
-********
-grdtrend
-********
-
-.. only:: not man
-
- grdtrend - Fit trend surface to grids and compute residuals
-
-`Synopsis <#toc1>`_
--------------------
-
-.. include:: common_SYN_OPTs.rst_
-
-**grdtrend** *grdfile* **-N**\ *n\_model*\ [**r**] [ **-D**\ *diff.nc* ]
-[ |SYN_OPT-R| ]
-[ **-T**\ *trend.nc* ] [ **-W**\ *weight.nc* ]
-
-|No-spaces|
-
-Description
------------
-
-**grdtrend** reads a 2-D grid file and fits a low-order polynomial trend
-to these data by [optionally weighted] least-squares. The trend surface
-is defined by:
-
- m1 + m2\*x + m3\*y + m4\*x\*y + m5\*x\*x + m6\*y\*y + m7\*x\*x\*x +
- m8\*x\*x\*y + m9\*x\*y\*y + m10\*y\*y\*y.
-
-The user must specify **-N**\ *n\_model*, the number of model parameters
-to use; thus, **-N**\ *3* fits a bilinear trend, **-N**\ *6* a quadratic
-surface, and so on. Optionally, append **r** to the **-N** option to
-perform a robust fit. In this case, the program will iteratively
-reweight the data based on a robust scale estimate, in order to converge
-to a solution insensitive to outliers. This may be handy when separating
-a "regional" field from a "residual" which should have non-zero mean,
-such as a local mountain on a regional surface.
-
-If data file has values set to NaN, these will be ignored during
-fitting; if output files are written, these will also have NaN in the
-same locations.
-
-Required Arguments
-------------------
-
-*grdfile*
- The name of a 2-D binary grid file.
-**-N**\ *n\_model*\ [**r**\ ]
- *n\_model* sets the number of model parameters to fit.
- Append **r** for robust fit.
-
-Optional Arguments
-------------------
-
-**-D**\ *diff.nc*
- Write the difference (input data - trend) to the file *diff.nc*.
-
-.. |Add_-R| replace:: Using the **-R** option
- will select a subsection of the input grid. If this subsection
- exceeds the boundaries of the grid, only the common region will be extracted.
-.. include:: explain_-R.rst_
-
-**-T**\ *trend.nc*
- Write the fitted trend to the file *trend.nc*.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-W**\ *weight.nc*
- If *weight.nc* exists, it will be read and used to solve a weighted
- least-squares problem. [Default: Ordinary least-squares fit.] If the
- robust option has been selected, the weights used in the robust fit
- will be written to *weight.nc*.
-
-.. include:: explain_help.rst_
-
-Remarks
--------
-
-The domain of x and y will be shifted and scaled to [-1, 1] and the
-basis functions are built from Legendre polynomials. These have a
-numerical advantage in the form of the matrix which must be inverted and
-allow more accurate solutions. NOTE: The model parameters listed with
-**-V** are Legendre polynomial coefficients; they are not numerically
-equivalent to the m#s in the equation described above. The description
-above is to allow the user to match **-N** with the order of the
-polynomial surface. See **grdmath** if you need to evaluate the trend
-using the reported coefficients.
-
-.. include:: explain_grd_inout.rst_
-
-Examples
---------
-
-To remove a planar trend from hawaii_topo.nc and write result in hawaii_residual.nc:
-
- ::
-
- gmt grdtrend hawaii_topo.nc -N3 -Dhawaii_residual.nc
-
-To do a robust fit of a bicubic surface to hawaii_topo.nc, writing the
-result in hawaii_trend.nc and the weights used in hawaii_weight.nc,
-and reporting the progress:
-
- ::
-
- gmt grdtrend hawaii_topo.nc -N10r -Thawaii_trend.nc -Whawaii_weight.nc -V
-
-See Also
---------
-
-:doc:`gmt`,
-:doc:`grdfft`,
-:doc:`grdfilter`,
-:doc:`grdmath`
diff --git a/doc_release/html/_sources/grdvector.txt b/doc_release/html/_sources/grdvector.txt
deleted file mode 100644
index b9935be..0000000
--- a/doc_release/html/_sources/grdvector.txt
+++ /dev/null
@@ -1,160 +0,0 @@
-.. index:: ! grdvector
-
-*********
-grdvector
-*********
-
-.. only:: not man
-
- grdvector - Plot vector field from two component grids
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**grdvector** *compx.nc* *compy.nc* **-J**\ *parameters* [ **-A** ]
-[ |SYN_OPT-B| ]
-[ **-G**\ *fill* ]
-[ |SYN_OPT-I| ]
-[ **-K** ] [ **-N** ] [ **-O** ] [ **-P** ] [ **-Q**\ *parameters* ]
-[ |SYN_OPT-R| ]
-[ **-S**\ [**i**\ \|\ **l**\ ]\ *scale* ] [ **-T** ]
-[ |SYN_OPT-U| ]
-[ **-W**\ *pen* ]
-[ |SYN_OPT-X| ]
-[ |SYN_OPT-Y| ]
-[ **-Z** ]
-[ |SYN_OPT-c| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-p| ]
-[ |SYN_OPT-t| ]
-
-|No-spaces|
-
-Description
------------
-
-**grdvector** reads two 2-D grid files which represents the x- and
-y-components of a vector field and produces a vector field plot by
-drawing vectors with orientation and length according to the information
-in the files. Alternatively, polar coordinate components may be used (r,
-theta). **grdvector** is basically a short-hand for using 2 calls to
-:doc:`grd2xyz` and pasting the output through **psxy -SV**.
-
-Required Arguments
-------------------
-
-*compx.nc*
- Contains the x-component of the vector field.
-*compy.nc*
- Contains the y-component of the vector field. (See GRID FILE FORMATS below.)
-
-.. include:: explain_-J.rst_
-
-Optional Arguments
-------------------
-
-**-A**
- Means grid files have polar (r, theta) components instead of
- Cartesian (x, y).
-
-.. include:: explain_-B.rst_
-
-**-C**\ [*cptfile*]
- Use *cptfile* to assign colors based on vector length. Alternatively,
- supply the name of a GMT color master CPT [rainbow] and let
- **grdvector** automatically determine a 16-level continuous CPT from
- the grid's z-range.
-**-G**\ *fill*
- Sets color or shade for vector interiors [Default is no fill].
-**-I**
- Only plot vectors at nodes every *x\_inc*, *y\_inc* apart (must be
- multiples of original grid spacing). Append **m** for arc minutes or
- **s** for arc seconds. [Default plots every node].
-
-.. include:: explain_-K.rst_
-
-**-N**
- Do NOT clip vectors at map boundaries [Default will clip].
-
-.. include:: explain_-O.rst_
-
-.. include:: explain_-P.rst_
-
-**-Q**\ *parameters*
- Modify vector parameters. For vector heads, append vector head
- *size* [Default is 0, i.e., stick-plot]. See VECTOR ATTRIBUTES for
- specifying additional attributes.
-
-.. |Add_-R| replace:: Specify a subset of the grid.
-.. include:: explain_-R.rst_
-
-**-S**\ [**i**\ \|\ **l**\ ]\ *scale*
- Sets scale for Cartesian vector length in data units per distance measurement
- unit [1]. Append **c**, **i**, or **p** to indicate the measurement
- unit (cm, inch,or point). Prepend **l** to indicate a fixed length
- for all vectors. For Geographic data, give scale in data units per
- km. Use **-Si** if it is simpler to give the reciprocal scale in
- measurement unit per data unit or km per data unit.
-
-**-T**
- Means azimuth of Cartesian data sets should be adjusted for different scales
- in the x- and y-directions [Leave alone].
-
-.. include:: explain_-U.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-W**\ *pen*
- Set pen attributes used for vector outlines [Default: width =
- default, color = black, style = solid].
-
-.. include:: explain_-XY.rst_
-
-**-Z**
- Means the angles provided are azimuths rather than direction
- (requires **-A**).
-
-.. include:: explain_-c.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_perspective| unicode:: 0x20 .. just an invisible code
-.. include:: explain_perspective.rst_
-
-.. include:: explain_-t.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_grd_inout.rst_
-
-.. include:: explain_vectors.rst_
-
-
-Examples
---------
-
-To draw the vector field given by the files r.nc and theta.nc on a
-linear plot with scale 5 cm per data unit, using vector rather than
-stick plot, scale vector magnitudes so that 10 units equal 1 inch, and
-center vectors on the node locations, run
-
- ::
-
- gmt grdvector r.nc theta.nc -Jx5c -A -Q0.1i+e+jc -S10i > gradient.ps
-
-To plot a geographic data sets given the files com_x.nc and comp_y.nc,
-using a scale of 200 km per data unit, try
-
- ::
-
- gmt grdvector comp_x.nc comp_y.nc -JH0/20c -Q0.1i+e+jc -S200 > globe.ps
-
-See Also
---------
-
-:doc:`gmt`, :doc:`gmtcolors`,
-:doc:`grdcontour`, :doc:`psxy`
diff --git a/doc_release/html/_sources/grdview.txt b/doc_release/html/_sources/grdview.txt
deleted file mode 100644
index 3428fe8..0000000
--- a/doc_release/html/_sources/grdview.txt
+++ /dev/null
@@ -1,244 +0,0 @@
-.. index:: ! grdview
-
-*******
-grdview
-*******
-
-.. only:: not man
-
- grdview - Create 3-D perspective image or surface mesh from a grid
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**grdview** *relief_file* **-J**\ *parameters*
-[ |SYN_OPT-B| ]
-[ **-C**\ [*cptfile*]]
-[ **-G**\ *drapefile* \| **-G**\ *grd_r*,\ *grd_g*,\ *grd_b* ]
-[ **-I**\ *intensfile*\ \|\ *intensity* ] [ **-Jz**\ \|\ **Z**\ *parameters* ] [ **-K** ]
-[ **-N**\ *level*\ [**+g**\ *fill*] ] [ **-O** ] [ **-P** ]
-[ **-Q**\ *args*\ [**+m**] ]
-[ |SYN_OPT-Rz| ]
-[ **-S**\ *smooth* ]
-[ **-T**\ [**s**][\ **o**\ [*pen*]] ]
-[ |SYN_OPT-U| ]
-[ **-W**\ **type**\ *pen* ]
-[ |SYN_OPT-X| ]
-[ |SYN_OPT-Y| ]
-[ |SYN_OPT-c| ]
-[ |SYN_OPT-n| ]
-[ |SYN_OPT-p| ]
-[ |SYN_OPT-t| ]
-
-|No-spaces|
-
-Description
------------
-
-**grdview** reads a 2-D grid file and produces a 3-D perspective plot by
-drawing a mesh, painting a colored/grayshaded surface made up of
-polygons, or by scanline conversion of these polygons to a raster image.
-Options include draping a data set on top of a surface, plotting of
-contours on top of the surface, and apply artificial illumination based
-on intensities provided in a separate grid file.
-
-Required Arguments
-------------------
-
-*relief_file*
- 2-D gridded data set to be imaged (the relief of the surface). (See
- GRID FILE FORMAT below.)
-
-.. include:: explain_-J.rst_
-
-.. include:: explain_-Jz.rst_
-
-Optional Arguments
-------------------
-
-.. include:: explain_-B.rst_
-
-**-C**\ [*cptfile*]
- name of the color palette file. Must be present if you want
- (1) mesh plot with contours (**-Qm**), or
- (2) shaded/colored perspective image (**-Qs** or
- **-Qi**). For **-Qs**: You can specify that you want to skip a
- z-slice by setting red = -; to use a pattern give red =
- **P\|p**\ *dpi/pattern*\ [:**F**\ *color*\ [**B**\ *color*]].
- Alternatively, supply the name of a GMT color master CPT [rainbow] and let
- **grdview** automatically determine a 16-level continuous CPT from
- the grid's z-range.
-**-G**\ *drapefile* \| **-G**\ *grd_r*,\ *grd_g*,\ *grd_b*
- Drape the image in *drapefile* on top of the relief provided by
- *relief_file*. [Default is *relief_file*]. Note that **-Jz** and
- **-N** always refers to the *relief_file*. The *drapefile* only
- provides the information pertaining to colors, which is looked-up
- via the cpt file (see **-C**). Alternatively, give three grid files
- separated by commas. These files must contain the red, green, and
- blue colors directly (in 0-255 range) and no cpt file is needed. The
- *drapefile* may be of higher resolution than the *relief_file*.
-**-I**\ *intensfile*\ \|\ *intensity*
- Gives the name of a grid file with intensities in the (-1,+1) range,
- or a constant intensity to apply everywhere.
- [Default is no illumination].
-
-.. include:: explain_-K.rst_
-
-**-N**\ *level*\ [**+g**\ *fill*]
- Draws a plane at this z-level. If the optional *color* is provided
- via the **+g** modifier,
- the frontal facade between the plane and the data perimeter is
- colored. See **-Wf** for setting the pen used for the outline.
-
-.. include:: explain_-O.rst_
-
-.. include:: explain_-P.rst_
-
-**-Q**\ *args*\ [**+m**]
- Select one of four settings: 1. Specify **m** for mesh plot
- [Default], and optionally append *color* for a different mesh paint
- [white]. 2. Specify **s** for surface plot, and optionally append
- **m** to have mesh lines drawn on top of surface. 3. Specify **i**
- for image plot, and optionally append the effective dpi resolution
- for the rasterization [100]. 4. Specify **c**. Same as **-Qi** but
- will make nodes with z = NaN transparent, using the colormasking
- feature in PostScript Level 3 (the PS device must support PS Level
- 3). For any of these choices, you may force a monochrome image by
- appending the modifier **+m**. Colors are then converted to shades
- of gray using the (monochrome television) YIQ transformation.
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-R.rst_
-
-.. |Add_-Rz| replace:: This option may be used to
- indicate the range used for the 3-D axes [Default is region given by
- the *relief_file*]. You may ask for a larger *w/e/s/n* region to
- have more room between the image and the axes. A smaller region than
- specified in the *relief_file* will result in a subset of the grid.
-.. include:: explain_-Rz.rst_
-
-**-S**\ *smooth*
- Smooth the contours before plotting (see **grdcontour**) [Default is
- no smoothing].
-**-T**\ [**s**\ ][\ **o**\ [*pen*]]
- Plot image without any interpolation. This involves converting each
- node-centered bin into a polygon which is then painted separately.
- Append **s** to skip nodes with z = NaN. This option is useful for
- categorical data where interpolating between values is meaningless.
- Optionally, append **o** to draw the tile outlines, and specify a
- custom pen if the default pen is not to your liking. As this option
- produces a flat surface it cannot be combined with **-JZ** or
- **-Jz**.
-
-.. include:: explain_-U.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-W**\ **type**\ *pen*
-
- **-Wc**
- Draw contour lines on top of surface or mesh (not image). Append pen
- attributes used for the contours. [Default: width = 0.75p, color =
- black, style = solid].
- **-Wm**
- Sets the pen attributes used for the mesh. [Default: width = 0.25p,
- color = black, style = solid]. You must also select **-Qm** or
- **-Qsm** for meshlines to be drawn.
- **-Wf**
- Sets the pen attributes used for the facade. [Default: width =
- 0.25p, color = black, style = solid]. You must also select **-N**
- for the facade outline to be drawn.
-
-.. include:: explain_-XY.rst_
-
-.. include:: explain_-c.rst_
-
-.. include:: explain_-n.rst_
-
-.. |Add_perspective| unicode:: 0x20 .. just an invisible code
-.. include:: explain_perspective.rst_
-
-.. include:: explain_-t.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_grd_inout.rst_
-
-.. include:: explain_grdresample.rst_
-
-Examples
---------
-
-To make a mesh plot from the file hawaii_grav.nc and drawing the
-contours given in the color palette file hawaii.cpt on a Lambert map at
-1.5 cm/degree along the standard parallels 18 and 24, with vertical
-scale 20 mgal/cm, and looking at the surface from SW at 30 degree
-elevation, run
-
- ::
-
- gmt grdview hawaii_grav.nc -Jl18/24/1.5c -Chawaii.cpt \
- -Jz0.05c -Qm -N-100 -p225/30 -Wc > hawaii_grav_image.ps
-
-To create a illuminated color perspective plot of the gridded data set
-image.nc, using the color palette file color.rgb, with linear scaling at
-10 cm/x-unit and tickmarks every 5 units, with intensities provided by
-the file intens.nc, and looking from the SE, use
-
- ::
-
- gmt grdview image.nc -Jx10.0c -Ccolor.rgb -Qs -p135/30 -Iintens.nc > image3D.ps
-
-To make the same plot using the rastering option with dpi = 50, use
-
- ::
-
- gmt grdview image.nc -Jx10.0c -Ccolor.rgb -Qi50 -p135/30 -Iintens.nc > image3D.ps
-
-To create a color PostScript perspective plot of the gridded data set
-magnetics.nc, using the color palette file mag_intens.cpt, draped over
-the relief given by the file topography.nc, with Mercator map width of 6
-inch and tickmarks every 1 degree, with intensities provided by the file
-topo_intens.nc, and looking from the SE, run
-
- ::
-
- gmt grdview topography.nc -JM6i -Gmagnetics.nc -Cmag_intens.cpt \
- -Qs -p140/30 -Itopo_intens.nc > draped3D.ps
-
-Given topo.nc and the Landsat image veggies.ras, first run **grd2rgb**
-to get the red, green, and blue grids, and then drape this image over
-the topography and shade the result for good measure. The commands are
-
- ::
-
- gmt grd2rgb veggies.ras -Glayer_%c.nc
- gmt grdview topo.nc -JM6i -Qi -p140/30 -Itopo_intens.nc \
- -Glayer_r.nc,layer_g.nc,layer_b.nc > image.ps
-
-Remarks
--------
-
-For the **-Qs** option: PostScript provides no way of smoothly varying
-colors within a polygon, so colors can only vary from polygon to
-polygon. To obtain smooth images this way you may resample the grid
-file(s) using **grdsample** or use a finer grid size when running
-gridding programs like **surface** or **nearneighbor**. Unfortunately,
-this produces huge PostScript files. The alternative is to use the
-**-Qi** option, which computes bilinear or bicubic continuous color
-variations within polygons by using scanline conversion to image the polygons.
-
-See Also
---------
-
-:doc:`gmt`, :doc:`grd2rgb`,
-:doc:`gmtcolors`,
-:doc:`grdcontour`,
-:doc:`grdimage`,
-:doc:`nearneighbor`,
-:doc:`psbasemap`,
-:doc:`pscontour`, :doc:`pstext`,
-:doc:`surface`
diff --git a/doc_release/html/_sources/grdvolume.txt b/doc_release/html/_sources/grdvolume.txt
deleted file mode 100644
index bcc3bf2..0000000
--- a/doc_release/html/_sources/grdvolume.txt
+++ /dev/null
@@ -1,151 +0,0 @@
-.. index:: ! grdvolume
-
-*********
-grdvolume
-*********
-
-.. only:: not man
-
- grdvolume - Calculate grid volume and area constrained by a contour
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**grdvolume** *grdfile* [ **-C**\ *cval* or **-C**\ *low/high/delta* or **-Cr**\ *low/high* ]
-[ **-L**\ *base* ]
-[ |SYN_OPT-R| ]
-[ **-S**\ [*unit*\ ] ] [ **-T**\ [**c**\ \|\ **h**] ]
-[ |SYN_OPT-V| ]
-[ **-Z**\ *fact*\ [/*shift*] ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-o| ]
-
-
-|No-spaces|
-
-Description
------------
-
-**grdvolume** reads a 2-D binary grid file and calculates the volume
-contained between the surface and the plane specified by the given
-contour (or zero if not given) and reports the area, volume, and maximum
-mean height (volume/area). Alternatively, specify a range of contours to
-be tried and **grdvolume** will determine the volume and area inside the
-contour for all contour values. Using **-T**, the contour that produced
-the maximum mean height (or maximum curvature of heights vs contour
-value) is reported as well. This feature may be used with **grdfilter**
-in designing an Optimal Robust Separator [*Wessel*, 1998].
-
-Required Arguments
-------------------
-
-*grdfile*
- The name of the input 2-D binary grid file. (See GRID FILE FORMAT below.)
-
-Optional Arguments
-------------------
-
-**-C**\ *cval* or **-C**\ *low/high/delta* or **-Cr**\ *low/high*
- find area, volume and mean height (volume/area) inside the *cval*
- contour. Alternatively, search using all contours from *low* to
- *high* in steps of *delta*. [Default returns area, volume and mean
- height of the entire grid]. The area is measured in the plane of the contour.
- The **Cr** form on the other hand computes volume between the grid
- surface and the plans defined by *low* and *high*. Note that this is an
- *outside* volume whilst the other forms compute an *inside* (bellow the surface)
- area volume. Use this form to compute for example the volume of water
- between two contours.
-**-L**\ *base*
- Also add in the volume from the level of the contour down to *base*
- [Default base is contour].
-**-S**\ [*unit*\ ]
- Convert degrees to Flat Earth distances, append a unit from
- **e**\ \|\ **f**\ \|\ **k**\ \|\ **M**\ \|\ **n**\ \|\ **u**
- [Default is Cartesian].
-**-T**\ [**c**\ \|\ **h**]
- Determine the single contour that maximized the average height (=
- volume/area). Select **-Tc** to use the maximum curvature of heights
- versus contour value rather than the contour with the maximum height
- to pick the best contour value (requires **-C**).
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-R.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-Z**\ *fact*\ [/*shift*]
- Optionally subtract *shift* before scaling data by *fact*. [Default
- is no scaling]. (Numbers in **-C**, **-L** refer to values after
- this scaling has occurred).
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. include:: explain_-ocols.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_grd_inout.rst_
-
-Examples
---------
-
-To determine the volume in km^3 under the surface hawaii_topo.nc (height in km), use
-
- ::
-
- gmt grdvolume hawaii_topo.nc -Sk
-
-To find the volume between the surface peaks.nc and the contour z = 250, use
-
- ::
-
- gmt grdvolume peaks.nc -Sk -C250
-
-To search for the contour, between 100 and 300 in steps of 10, that
-maximizes the ratio of volume to surface area for the file peaks.nc, use
-
- ::
-
- gmt grdvolume peaks.nc -Sk -C100/300/10 -Th > results.d
-
-To see the areas and volumes for all the contours in the previous example, use
-
- ::
-
- gmt grdvolume peaks.nc -Sk -C100/300/10 > results.d
-
-To find the volume of water in a lake with its free surface at 0 and max depth of 300 meters, use
-
- ::
-
- gmt grdvolume lake.nc -Cr-300/0
-
-Notes
------
-
-**grdvolume** distinguishes between gridline and pixel-registered grids.
-In both cases the area and volume are computed up to the grid
-boundaries. That means that in the first case the grid cells on the
-boundary only contribute half their area (and volume), whereas in the
-second case all grid cells are fully used. The exception is when the
-**-C** flag is used: since contours do not extend beyond the outermost
-grid point, both grid types are treated the same. That means the outer
-rim in pixel oriented grids is ignored when using the **-C** flag.
-
-See Also
---------
-
-:doc:`gmt`,
-:doc:`grdfilter`,
-:doc:`grdmask`,
-:doc:`grdmath`
-
-References
-----------
-
-Wessel, P., 1998, An empirical method for optimal robust
-regional-residual separation of geophysical data, *Math. Geol.*, **30**\ (4), 391-408.
diff --git a/doc_release/html/_sources/greenspline.txt b/doc_release/html/_sources/greenspline.txt
deleted file mode 100644
index db5a177..0000000
--- a/doc_release/html/_sources/greenspline.txt
+++ /dev/null
@@ -1,390 +0,0 @@
-.. index:: ! greenspline
-
-***********
-greenspline
-***********
-
-.. only:: not man
-
- greenspline - Interpolate using Green's functions for splines in 1-3 dimensions
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**greenspline** [ *table* ]
-[ **-A**\ [**1**\ \|\ **2**\ \|\ **3**\ \|\ **4**\ \|\ **5**,]\ *gradfile* ]
-[ **-C**\ [**n**\ \|\ **v**]\ *cut*\ [/*file*] ] [ **-D**\ *mode* ] [ **-G**\ *grdfile* ]
-[ **-I**\ *xinc*\ [/*yinc*\ [/*zinc*]] ] [ **-L** ] [ **-N**\ *nodefile* ]
-[ **-Q**\ *az*\ \|\ *x/y/z* ]
-[ |SYN_OPT-Rz| ]
-[ **-S**\ **c\|t\|l\|r\|p\|q**\ [*pars*] ] [ **-T**\ *maskgrid* ]
-[ |SYN_OPT-V| ]
-[ **-W** ]
-[ |SYN_OPT-b| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-o| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**greenspline** uses the Green's function G(\ **x**; **x'**) for the
-chosen spline and geometry to interpolate data at regular [or arbitrary]
-output locations. Mathematically, the solution is composed as
-*w*\ (**x**) = sum {*c*\ (*i*) G(\ **x'**; **x**\ (*i*))}, for *i* = 1,
-*n*, the number of data points {**x**\ (*i*), *w*\ (*i*)}. Once the *n*
-coefficients *c*\ (*i*) have been found the sum can be evaluated at any
-output point **x**. Choose between minimum curvature, regularized, or
-continuous curvature splines in tension for either 1-D, 2-D, or 3-D
-Cartesian coordinates or spherical surface coordinates. After first
-removing a linear or planar trend (Cartesian geometries) or mean value
-(spherical surface) and normalizing these residuals, the least-squares
-matrix solution for the spline coefficients *c*\ (*i*) is found by
-solving the *n* by *n* linear system *w*\ (*j*) = sum-over-*i*
-{*c*\ (*i*) G(\ **x**\ (*j*); **x**\ (*i*))}, for *j* = 1, *n*; this
-solution yields an exact interpolation of the supplied data points.
-Alternatively, you may choose to perform a singular value decomposition
-(SVD) and eliminate the contribution from the smallest eigenvalues; this
-approach yields an approximate solution. Trends and scales are restored
-when evaluating the output.
-
-Required Arguments
-------------------
-
-None.
-
-Optional Arguments
-------------------
-
-*table*
- The name of one or more ASCII [or binary, see
- **-bi**] files holding the **x**, *w* data
- points. If no file is given then we read standard input instead.
-**-A**\ [**1**\ \|\ **2**\ \|\ **3**\ \|\ **4**\ \|\ **5**,]\ *gradfile*
- The solution will partly be constrained by surface gradients **v** =
- *v*\ \*\ **n**, where *v* is the gradient magnitude and **n** its
- unit vector direction. The gradient direction may be specified
- either by Cartesian components (either unit vector **n** and
- magnitude *v* separately or gradient components **v** directly) or
- angles w.r.t. the coordinate axes. Specify one of five input
- formats: **0**: For 1-D data there is no direction, just gradient
- magnitude (slope) so the input format is *x*, *gradient*. Options
- 1-2 are for 2-D data sets: **1**: records contain *x*, *y*,
- *azimuth*, *gradient* (*azimuth* in degrees is measured clockwise
- from the vertical (north) [Default]). **2**: records contain *x*,
- *y*, *gradient*, *azimuth* (*azimuth* in degrees is measured
- clockwise from the vertical (north)). Options 3-5 are for either 2-D
- or 3-D data: **3**: records contain **x**, *direction(s)*, *v*
- (*direction(s)* in degrees are measured counter-clockwise from the
- horizontal (and for 3-D the vertical axis). **4**: records contain
- **x**, **v**. **5**: records contain **x**, **n**, *v*. Append name
- of ASCII file with the surface gradients (following a comma if a
- format is specified).
-**-C**\ [**n**\ \|\ **v**]\ *cut*\ [/*file*]
- Find an approximate surface fit: Solve the linear system for the
- spline coefficients by SVD and eliminate the contribution from all
- eigenvalues whose ratio to the largest eigenvalue is less than *cut*
- [Default uses Gauss-Jordan elimination to solve the linear system
- and fit the data exactly]. Optionally, append /*file* to save the
- eigenvalue ratios to the specified file for further analysis.
- Finally, if a negative *cut* is given then /*file* is required and
- execution will stop after saving the eigenvalues, i.e., no surface
- output is produced. Specify **-Cv** to use the
- largest eigenvalues needed to explain *cut* % of the data variance.
- Alternatively, use **-Cn** to select the *cut* largest eigenvalues.
- If a *file* is given with **-Cv** then we save the eigenvalues instead
- of the ratios.
-**-D**\ *mode*
- Sets the distance flag that determines how we calculate distances
- between data points. Select *mode* 0 for Cartesian 1-D spline
- interpolation: **-D**\ 0 means (*x*) in user units, Cartesian
- distances, Select *mode* 1-3 for Cartesian 2-D surface spline
- interpolation: **-D**\ 1 means (*x*,\ *y*) in user units, Cartesian
- distances, **-D**\ 2 for (*x*,\ *y*) in degrees, Flat Earth
- distances, and **-D**\ 3 for (*x*,\ *y*) in degrees, Spherical
- distances in km. Then, if :ref:`PROJ_ELLIPSOID <PROJ_ELLIPSOID>` is spherical, we
- compute great circle arcs, otherwise geodesics. Option *mode* = 4
- applies to spherical surface spline interpolation only: **-D**\ 4
- for (*x*,\ *y*) in degrees, use cosine of great circle (or geodesic)
- arcs. Select *mode* 5 for Cartesian 3-D surface spline
- interpolation: **-D**\ 5 means (*x*,\ *y*,\ *z*) in user units,
- Cartesian distances.
-**-G**\ *grdfile*
- Name of resulting output file. (1) If options **-R**, **-I**, and
- possibly **-r** are set we produce an equidistant output table. This
- will be written to stdout unless **-G** is specified. Note: for 2-D
- grids the **-G** option is required. (2) If option **-T** is
- selected then **-G** is required and the output file is a 2-D binary
- grid file. Applies to 2-D interpolation only. (3) If **-N** is
- selected then the output is an ASCII (or binary; see
- **-bo**) table; if **-G** is not given then
- this table is written to standard output. Ignored if **-C** or
- **-C**\ 0 is given.
-**-I**\ *xinc*\ [/*yinc*\ [/*zinc*\ ]]
- Specify equidistant sampling intervals, on for each dimension,
- separated by slashes.
-**-L**
- Do *not* remove a linear (1-D) or planer (2-D) trend when **-D**
- selects mode 0-3 [For those Cartesian cases a least-squares line or
- plane is modeled and removed, then restored after fitting a spline
- to the residuals]. However, in mixed cases with both data values and
- gradients, or for spherical surface data, only the mean data value
- is removed (and later and restored).
-**-N**\ *nodefile*
- ASCII file with coordinates of desired output locations **x** in the
- first column(s). The resulting *w* values are appended to each
- record and written to the file given in **-G** [or stdout if not
- specified]; see **-bo** for binary output
- instead. This option eliminates the need to specify options **-R**,
- **-I**, and **-r**.
-**-Q**\ *az*\ \|\ *x/y/z*
- Rather than evaluate the surface, take the directional derivative in
- the *az* azimuth and return the magnitude of this derivative
- instead. For 3-D interpolation, specify the three components of the
- desired vector direction (the vector will be normalized before use).
-**-R**\ *xmin*/*xmax*\ [/*ymin*/*ymax*\ [/*zmin*\ *zmax*]]
- Specify the domain for an equidistant lattice where output
- predictions are required. Requires **-I** and optionally **-r**.
-
- *1-D:* Give *xmin/xmax*, the minimum and maximum *x* coordinates.
-
- *2-D:* Give *xmin/xmax/ymin/ymax*, the minimum and maximum *x* and
- *y* coordinates. These may be Cartesian or geographical. If
- geographical, then *west*, *east*, *south*, and *north* specify the
- Region of interest, and you may specify them in decimal degrees or
- in [+-]dd:mm[:ss.xxx][W\|E\|S\|N] format. The two shorthands **-Rg**
- and **-Rd** stand for global domain (0/360 and -180/+180 in
- longitude respectively, with -90/+90 in latitude).
-
- *3-D:* Give *xmin/xmax/ymin/ymax/zmin/zmax*, the minimum and maximum
- *x*, *y* and *z* coordinates. See the 2-D section if your horizontal
- coordinates are geographical; note the shorthands **-Rg** and
- **-Rd** cannot be used if a 3-D domain is specified.
-
-**-S**\ **c\|t\|l\|r\|p\|q**\ [*pars*]
- Select one of six different splines. The first two are used for
- 1-D, 2-D, or 3-D Cartesian splines (see **-D** for discussion). Note
- that all tension values are expected to be normalized tension in the
- range 0 < *t* < 1: (**c**) Minimum curvature spline [*Sandwell*,
- 1987], (**t**) Continuous curvature spline in tension [*Wessel and
- Bercovici*, 1998]; append *tension*\ [/*scale*] with *tension* in
- the 0-1 range and optionally supply a length scale [Default is the
- average grid spacing]. The next is a 1-D or 2-D spline: (**l**)
- Linear (1-D) or Bilinear (2-D) spline; these produce output that do
- not exceed the range of the given data. The next is a 2-D or 3-D spline: (**r**)
- Regularized spline in tension [*Mitasova and Mitas*, 1993]; again,
- append *tension* and optional *scale*. The last two are spherical
- surface splines and both imply **-D**\ 4: (**p**) Minimum
- curvature spline [*Parker*, 1994], (**q**) Continuous curvature
- spline in tension [*Wessel and Becker*, 2008]; append *tension*. The
- G(\ **x'**; **x'**) for the last method is slower to compute (a series solution) so we
- pre-calculate values and use cubic spline interpolation lookup instead.
- Optionally append **+n**\ *N* (an odd integer) to change how many
- points to use in the spline setup [10001]. The finite Legendre sum has
- a truncation error [1e-6]; you can lower that by appending **+e**\ *limit*
- at the expense of longer run-time.
-**-T**\ *maskgrid*
- For 2-D interpolation only. Only evaluate the solution at the nodes
- in the *maskgrid* that are not equal to NaN. This option eliminates
- the need to specify options **-R**, **-I**, and **-r**.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-W**
- Expect data weights in the final input column, typically given as
- weight = 1 / sigma, the data uncertainty. This results in a weighted
- least squares fit. Note that this only has an effect if **-CC** is used.
-
-.. |Add_-bi| replace:: [Default is 2-4 input
- columns (**x**,\ *w*); the number depends on the chosen dimension].
-.. include:: explain_-bi.rst_
-
-.. |Add_-bo| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-bo.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. include:: explain_-ocols.rst_
-
-.. |Add_nodereg| unicode:: 0x20 .. just an invisible code
-.. include:: explain_nodereg.rst_
-
-.. include:: explain_help.rst_
-
-1-d Examples
-------------
-
-To resample the *x*,\ *y* Gaussian random data created by :doc:`gmtmath`
-and stored in 1D.txt, requesting output every 0.1 step from 0 to 10, and
-using a minimum cubic spline, try
-
- ::
-
- gmt gmtmath -T0/10/1 0 1 NRAND = 1D.txt
- gmt psxy -R0/10/-5/5 -JX6i/3i -B2f1/1 -Sc0.1 -Gblack 1D.txt -K > 1D.ps
- gmt greenspline 1D.txt -R0/10 -I0.1 -Sc -V | psxy -R -J -O -Wthin >> 1D.ps
-
-To apply a spline in tension instead, using a tension of 0.7, try
-
- ::
-
- gmt psxy -R0/10/-5/5 -JX6i/3i -B2f1/1 -Sc0.1 -Gblack 1D.txt -K > 1Dt.ps
- gmt greenspline 1D.txt -R0/10 -I0.1 -St0.7 -V | psxy -R -J -O -Wthin >> 1Dt.ps
-
-2-d Examples
-------------
-
-To make a uniform grid using the minimum curvature spline for the same
-Cartesian data set from Davis (1986) that is used in the GMT Technical
-Reference and Cookbook example 16, try
-
- ::
-
- gmt greenspline table_5.11 -R0/6.5/-0.2/6.5 -I0.1 -Sc -V -D1 -GS1987.nc
- gmt psxy -R0/6.5/-0.2/6.5 -JX6i -B2f1 -Sc0.1 -Gblack table_5.11 -K > 2D.ps
- gmt grdcontour -JX6i -B2f1 -O -C25 -A50 S1987.nc >> 2D.ps
-
-To use Cartesian splines in tension but only evaluate the solution where
-the input mask grid is not NaN, try
-
- ::
-
- gmt greenspline table_5.11 -Tmask.nc -St0.5 -V -D1 -GWB1998.nc
-
-To use Cartesian generalized splines in tension and return the magnitude
-of the surface slope in the NW direction, try
-
- ::
-
- gmt greenspline table_5.11 -R0/6.5/-0.2/6.5 -I0.1 -Sr0.95 -V -D1 -Q-45 -Gslopes.nc
-
-Finally, to use Cartesian minimum curvature splines in recovering a
-surface where the input data is a single surface value (pt.d) and the
-remaining constraints specify only the surface slope and direction
-(slopes.d), use
-
- ::
-
- gmt greenspline pt.d -R-3.2/3.2/-3.2/3.2 -I0.1 -Sc -V -D1 -A1,slopes.d -Gslopes.nc
-
-3-d Examples
-------------
-
-To create a uniform 3-D Cartesian grid table based on the data in
-table_5.23 in Davis (1986) that contains *x*,\ *y*,\ *z* locations and
-a measure of uranium oxide concentrations (in percent), try
-
- ::
-
- gmt greenspline table_5.23 -R5/40/-5/10/5/16 -I0.25 -Sr0.85 -V -D5 -G3D_UO2.txt
-
-2-d Spherical Surface Examples
-------------------------------
-
-To recreate Parker's [1994] example on a global 1x1 degree grid,
-assuming the data are in file mag_obs_1990.d, try
-
- ::
-
- greenspline -V -Rg -Sp -D3 -I1 -GP1994.nc mag_obs_1990.d
-
-To do the same problem but applying tension of 0.85, use
-
- ::
-
- greenspline -V -Rg -Sq0.85 -D3 -I1 -GWB2008.nc mag_obs_1990.d
-
-Considerations
---------------
-
-(1) For the Cartesian cases we use the free-space Green functions, hence
-no boundary conditions are applied at the edges of the specified domain.
-For most applications this is fine as the region typically is
-arbitrarily set to reflect the extent of your data. However, if your
-application requires particular boundary conditions then you may
-consider using :doc:`surface` instead.
-
-(2) In all cases, the solution is obtained by inverting a *n* x *n*
-double precision matrix for the Green function coefficients, where *n*
-is the number of data constraints. Hence, your computer's memory may
-place restrictions on how large data sets you can process with
-`greenspline <greenspline.html>`. Pre-processing your data with `blockmean <blockmean.html>`,
-`blockmedian <blockmedian.html>`, or `blockmode <blockmode.html>` is recommended to avoid aliasing and
-may also control the size of *n*. For information, if *n* = 1024 then
-only 8 Mb memory is needed, but for *n* = 10240 we need 800 Mb. Note
-that `greenspline <greenspline.html>` is fully 64-bit compliant if compiled as such.
-For spherical data you may consider decimating using `gmtspatial <gmtspatial.html>`
-nearest neighbor reduction.
-
-(3) The inversion for coefficients can become numerically unstable when
-data neighbors are very close compared to the overall span of the data.
-You can remedy this by pre-processing the data, e.g., by averaging
-closely spaced neighbors. Alternatively, you can improve stability by
-using the SVD solution and discard information associated with the
-smallest eigenvalues (see **-C**).
-
-(4) The series solution implemented for **-Sq** was developed by
-Robert L. Parker, Scripps Institution of Oceanography, which we
-gratefully acknowledge.
-
-Tension
--------
-
-Tension is generally used to suppress spurious oscillations caused by
-the minimum curvature requirement, in particular when rapid gradient
-changes are present in the data. The proper amount of tension can only
-be determined by experimentation. Generally, very smooth data (such as
-potential fields) do not require much, if any tension, while rougher
-data (such as topography) will typically interpolate better with
-moderate tension. Make sure you try a range of values before choosing
-your final result. Note: the regularized spline in tension is only
-stable for a finite range of *scale* values; you must experiment to find
-the valid range and a useful setting. For more information on tension
-see the references below.
-
-References
-----------
-
-Davis, J. C., 1986, *Statistics and Data Analysis in Geology*, 2nd
-Edition, 646 pp., Wiley, New York,
-
-Mitasova, H., and L. Mitas, 1993, Interpolation by regularized spline
-with tension: I. Theory and implementation, *Math. Geol.*, **25**,
-641-655.
-
-Parker, R. L., 1994, *Geophysical Inverse Theory*, 386 pp., Princeton
-Univ. Press, Princeton, N.J.
-
-Sandwell, D. T., 1987, Biharmonic spline interpolation of Geos-3 and
-Seasat altimeter data, *Geophys. Res. Lett.*, **14**, 139-142.
-
-Wessel, P., and D. Bercovici, 1998, Interpolation with splines in
-tension: a Green's function approach, *Math. Geol.*, **30**, 77-93.
-
-Wessel, P., and J. M. Becker, 2008, Interpolation using a generalized
-Green's function for a spherical surface spline in tension, *Geophys. J.
-Int*, **174**, 21-28.
-
-Wessel, P., 2009, A general-purpose Green's function interpolator,
-*Computers & Geosciences*, **35**, 1247-1254, doi:10.1016/j.cageo.2008.08.012.
-
-See Also
---------
-
-:doc:`gmt`, :doc:`gmtmath`,
-:doc:`nearneighbor`, :doc:`psxy`,
-:doc:`sphtriangulate`,
-:doc:`surface`,
-:doc:`triangulate`, :doc:`xyz2grd`
diff --git a/doc_release/html/_sources/index.txt b/doc_release/html/_sources/index.txt
deleted file mode 100644
index a089eec..0000000
--- a/doc_release/html/_sources/index.txt
+++ /dev/null
@@ -1,68 +0,0 @@
-.. GMT documentation master file
- Include man_pages to avoid "not included in toctree warning":
-
-.. toctree::
- :hidden:
-
- man_pages
-
-Man pages
-=========
-
-+-----------------+-----------------+-----------------+-----------------+
-| .. toctree:: | .. toctree:: | .. toctree:: | .. toctree:: |
-| :maxdepth: 2 | :maxdepth: 2 | :maxdepth: 2 | :maxdepth: 2 |
-| | | | |
-| B | GR | I | S |
-| F | | K | T |
-| GM | | M | X |
-| | | N | |
-| | | P | |
-| | | PS | |
-+-----------------+-----------------+-----------------+-----------------+
-
-Supplements
------------
-
-+-----------------+-----------------+-----------------+
-| .. toctree:: | .. toctree:: | .. toctree:: |
-| :maxdepth: 2 | :maxdepth: 2 | :maxdepth: 2 |
-| | | |
-| SUP_GSHHS | SUP_MISC | SUP_X2SYS |
-| SUP_IMGSRC | SUP_POTENTIAL| |
-| SUP_MECA | SUP_SEGY | |
-| SUP_MGD77 | SUP_SPOTTER | |
-+-----------------+-----------------+-----------------+
-
-Gallery
-=======
-
-+----------------------------+
-| .. toctree:: |
-| :maxdepth: 2 |
-| |
-| Gallery |
-| Users_contrib_script |
-| Users_contrib_symbols |
-+----------------------------+
-
-The CookBook
-============
-
-+--------------------+
-| .. toctree:: |
-| :maxdepth: 2 |
-| |
-| cookbook |
-+--------------------+
-
-
-API Reference
-=============
-
-+--------------------+
-| .. toctree:: |
-| :maxdepth: 2 |
-| |
-| api |
-+--------------------+
diff --git a/doc_release/html/_sources/isogmt.txt b/doc_release/html/_sources/isogmt.txt
deleted file mode 100644
index a377bfd..0000000
--- a/doc_release/html/_sources/isogmt.txt
+++ /dev/null
@@ -1,37 +0,0 @@
-.. index:: ! isogmt
-
-******
-isogmt
-******
-
-.. only:: not man
-
- isogmt - Run GMT command or script in isolation mode
-
-Synopsis
---------
-
-**isogmt** *command*
-
-Description
------------
-
-**isogmt** runs a single GMT command or shell script in **isolation
-mode**. This means that the files *gmt.history* and *gmt.conf* will be
-read from the usual locations (current directory, *~/.gmt*, or home
-directory), but changes will only be written in a temporary directory,
-which will be removed after execution. The name of the temporary
-directory will be available to the command or script as the environment
-variable GMT_TMPDIR.
-
-Examples
---------
-
-Run the shell script *script.gmt* in isolation mode
-
- isogmt sh script.gmt
-
-`See Also <#toc4>`_
--------------------
-
-:doc:`gmt`, :doc:`gmt.conf`
diff --git a/doc_release/html/_sources/kml2gmt.txt b/doc_release/html/_sources/kml2gmt.txt
deleted file mode 100644
index 1765d7f..0000000
--- a/doc_release/html/_sources/kml2gmt.txt
+++ /dev/null
@@ -1,71 +0,0 @@
-.. index:: ! kml2gmt
-
-*******
-kml2gmt
-*******
-
-.. only:: not man
-
- kml2gmt - Extract GMT table data from Google Earth KML files
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**kml2gmt** [ *kmlfiles* ] [ |SYN_OPT-V| ] [ **-Z** ]
-[ |SYN_OPT-bo| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**kml2gmt** reads a Google Earth KML file and outputs a GMT table file.
-Only KML files that contain points, lines, or polygons can be processed.
-This is a bare-bones operation that aims to extract coordinates and
-possibly the name and description tags of each feature. The main use
-intended is to capture coordinates modified in Google Earth and then
-reinsert the modified data into the original GMT data file. For a more
-complete reformatting, consider using **ogr2ogr -f** "GMT" somefile.gmt
-somefile.kml.
-
-Required Arguments
-------------------
-
-None.
-
-Optional Arguments
-------------------
-
-*kmlfiles*
- Name of one or more KML files to work on. If not are given, then
- standard input is read.
-**-Z**
- Output the altitude coordinates as GMT z coordinates [Default will
- output just longitude and latitude].
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. |Add_-bo| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-bo.rst_
-
-.. include:: explain_colon.rst_
-
-.. include:: explain_help.rst_
-
-Examples
---------
-
-To extract the lon,lat values from the KML file google.kml, try
-
- gmt kml2gmt google.kml -V > google.txt
-
-See Also
---------
-
-:doc:`gmt`, :doc:`gmt.conf`,
-:doc:`img2google <supplements/img/img2google>`,
-:doc:`ps2raster`, :doc:`gmt2kml`
diff --git a/doc_release/html/_sources/makecpt.txt b/doc_release/html/_sources/makecpt.txt
deleted file mode 100644
index 9f8bfc7..0000000
--- a/doc_release/html/_sources/makecpt.txt
+++ /dev/null
@@ -1,166 +0,0 @@
-.. index:: ! makecpt
-
-*******
-makecpt
-*******
-
-.. only:: not man
-
- makecpt - Make GMT color palette tables
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**makecpt** [ **-A**\ [**+**\ ]\ *transparency* ] [ **-C**\ *table* ]
-[ **-D**\ [**i**\ \|\ **o**] ]
-[ **-F**\ [**R**\ \|\ **r**\ \|\ **h**\ \|\ **c** ] [ **-G**\ *zlo*\ /\ *zhi* ] [ **-I** ] [ **-M** ]
-[ **-N** ] [ **-Q**\ [**i**\ \|\ **o**] ]
-[ **-T**\ *z_min*/*z_max*\ [/*z_inc*\ [+]] \| **-T**\ *ztable* ]
-[ **-V**\ [*level*\ ] ] [ **-W** ] [ **-Z** ]
-
-|No-spaces|
-
-Description
------------
-
-**makecpt** is a utility that will help you make color palette tables
-(cpt files). You define an equidistant set of contour intervals or pass
-your own z-table, and create a new cpt file based on an existing master
-cpt file. The resulting cpt file can be reversed relative to the master
-cpt, and can be made continuous or discrete. For color tables beyond the
-standard GMT offerings, visit cpt-city:
-http://soliton.vm.bytemark.co.uk/pub/cpt-city/.
-
-The color palette includes three additional colors beyond the range of
-z-values. These are the background color (B) assigned to values lower
-than the lowest *z*-value, the foreground color (F) assigned to values
-higher than the highest *z*-value, and the NaN color (N) painted
-whereever values are undefined.
-
-If the master cpt file includes B, F, and N entries, these will be
-copied into the new master file. If not, the parameters
-:ref:`COLOR_BACKGROUND <COLOR_BACKGROUND>`, :ref:`COLOR_FOREGROUND <COLOR_FOREGROUND>`,
-and :ref:`COLOR_NAN <COLOR_NAN>` from
-the :doc:`gmt.conf` file or the command line will be used. This default
-behavior can be overruled using the options **-D**, **-M** or **-N**.
-
-The color model (RGB, HSV or CMYK) of the palette created by **makecpt**
-will be the same as specified in the header of the master cpt file. When
-there is no :ref:`COLOR_MODEL <COLOR_MODEL>` entry in the master cpt file, the
-:ref:`COLOR_MODEL <COLOR_MODEL>` specified in the :doc:`gmt.conf` file or on the command
-line will be used.
-
-Required Arguments
-------------------
-
-None.
-
-Optional Arguments
-------------------
-
-**-A**\ [**+**\ ]\ *transparency*
- Sets a constant level of transparency (0-100) for all color slices.
- Prepend **+** to also affect the fore-, back-, and nan-colors
- [Default is no transparency, i.e., 0 (opaque)].
-**-C**\ *table*
- Selects the master color table *table* to use in the interpolation.
- Choose among the built-in tables (type **makecpt** to see the list)
- or give the name of an existing cpt file [Default gives a rainbow
- cpt file].
-**-D**\ [**i**\ \|\ **o**]
- Select the back- and foreground colors to match the colors for
- lowest and highest *z*-values in the output cpt file [Default uses
- the colors specified in the master file, or those defined by the
- parameters :ref:`COLOR_BACKGROUND <COLOR_BACKGROUND>`, :ref:`COLOR_FOREGROUND <COLOR_FOREGROUND>`, and
- :ref:`COLOR_NAN <COLOR_NAN>`]. Append **i** to match the colors for the lowest and
- highest values in the input (instead of the output) cpt file.
-**-F**\ [**R**\ \|\ **r**\ \|\ **h**\ \|\ **c**]
- Force output cpt file to written with r/g/b codes, gray-scale values
- or color name (**R**, default) or r/g/b codes only (**r**), or h-s-v
- codes (**h**), or c/m/y/k codes (**c**).
-**-G**\ *zlo*\ /\ *zhi*
- Truncate the incoming CPT so that the lowest and highest z-levels
- are to *zlo* and *zhi*. If one of these equal NaN then
- we leave that end of the CPT alone. The truncation takes place
- before any resampling.
-**-I**
- Reverses the sense of color progression in the master cpt file. Also
- exchanges the foreground and background colors, including those
- specified by the parameters :ref:`COLOR_BACKGROUND <COLOR_BACKGROUND>` and
- :ref:`COLOR_FOREGROUND <COLOR_FOREGROUND>`.
-**-M**
- Overrule background, foreground, and NaN colors specified in the
- master cpt file with the values of the parameters
- :ref:`COLOR_BACKGROUND <COLOR_BACKGROUND>`, :ref:`COLOR_FOREGROUND <COLOR_FOREGROUND>`,
- and :ref:`COLOR_NAN <COLOR_NAN>`
- specified in the :doc:`gmt.conf` file or on the command line. When
- combined with **-D**, only :ref:`COLOR_NAN <COLOR_NAN>` is considered.
-**-N**
- Do not write out the background, foreground, and NaN-color fields
- [Default will write them].
-**-Q**\ [**i**\ \|\ **o**]
- Selects a logarithmic interpolation scheme [Default is linear].
- **-Qi** expects input z-values to be log10(z), assigns colors, and
- writes out z [Default]. **-Qo** takes log10(z) first, assigns
- colors, and writes out z.
-**-T**\ *z_min*/*z_max*\ [/*z_inc*\ [+]] \| **-T**\ *ztable*
- Defines the range of the new cpt file by giving the lowest and
- highest z-value and interval. When used with **-C** and *z_inc* is
- not specified, the number of intervals remains the same as in the
- input palette. If *z_inc* is specified with a trailing **+** we
- interpret *z_inc* as the number of desired intervals instead.
- Alternatively, give the name of a ASCII file that has one z-value
- per record. If **-T** is not given, the existing range in the master
- cpt file will be used intact.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-W**
- Do not interpolate the input color table but pick the output colors
- starting at the beginning of the color table, until colors for all
- intervals are assigned. This is particularly useful in combination
- with a categorical color table, like "categorical". Cannot be used
- in combination with **-Z**.
-**-Z**
- Creates a continuous cpt file [Default is discontinuous, i.e.,
- constant colors for each interval].
-
-.. include:: explain_help.rst_
-
-Examples
---------
-
-To make a cpt file with z-values from -200 to 200, with discrete color
-changes every 25, and using a polar blue-white-red colortable:
-
- ::
-
- gmt makecpt -Cpolar -T-200/200/25 > colors.cpt
-
-To make an equidistant cpt file from z = -2 to 6, in steps of 1, using
-continuous default rainbow colors:
-
- ::
-
- gmt makecpt -T-2/6/1 -Z > rainbow.cpt
-
-To make a GEBCO look-alike cpt file for bathymetry, run
-
- ::
-
- gmt makecpt -Cgebco > my_gebco.cpt
-
-Bugs
-----
-
-Since **makecpt** will also interpolate from any existing .cpt file you
-may have in your directory, you cannot use one of the listed cpt names
-as an output filename; hence the my_gebco.cpt in the example.
-
-See Also
---------
-
-:doc:`gmt`, :doc:`grd2cpt`
diff --git a/doc_release/html/_sources/man_pages.txt b/doc_release/html/_sources/man_pages.txt
deleted file mode 100644
index 670364d..0000000
--- a/doc_release/html/_sources/man_pages.txt
+++ /dev/null
@@ -1,146 +0,0 @@
-#########
-Man Pages
-#########
-
-************
-Core modules
-************
-
-.. toctree::
- :maxdepth: 1
-
- blockmean
- blockmedian
- blockmode
- filter1d
- fitcircle
- gmt_shell_functions.sh
- gmt.conf
- gmt
- gmt2kml
- gmt5syntax
- gmtcolors
- gmtconnect
- gmtconvert
- gmtdefaults
- gmtget
- gmtinfo
- gmtlogo
- gmtmath
- gmtselect
- gmtset
- gmtsimplify
- gmtspatial
- gmtswitch
- gmtvector
- gmtwhich
- grd2cpt
- grd2rgb
- grd2xyz
- grdblend
- grdclip
- grdcontour
- grdcut
- grdedit
- grdfft
- grdfilter
- grdgradient
- grdhisteq
- grdimage
- grdinfo
- grdlandmask
- grdmask
- grdmath
- grdpaste
- grdproject
- grdraster
- grdreformat
- grdsample
- grdtrack
- grdtrend
- grdvector
- grdview
- grdvolume
- greenspline
- isogmt
- kml2gmt
- makecpt
- mapproject
- nearneighbor
- project
- ps2raster
- psbasemap
- psclip
- pscoast
- pscontour
- pshistogram
- psimage
- pslegend
- pslib
- psmask
- psrose
- psscale
- pstext
- pswiggle
- psxy
- psxyz
- sample1d
- spectrum1d
- sph2grd
- sphdistance
- sphinterpolate
- sphtriangulate
- splitxyz
- surface
- trend1d
- trend2d
- triangulate
- xyz2grd
-
-*********************
-Supplementary modules
-*********************
-
-.. toctree::
- :maxdepth: 1
-
- supplements/gshhg/gshhg
- supplements/img/img2grd
- supplements/meca/pscoupe
- supplements/meca/psmeca
- supplements/meca/pspolar
- supplements/meca/psvelo
- supplements/mgd77/mgd77convert
- supplements/mgd77/mgd77info
- supplements/mgd77/mgd77list
- supplements/mgd77/mgd77magref
- supplements/mgd77/mgd77manage
- supplements/mgd77/mgd77path
- supplements/mgd77/mgd77sniffer
- supplements/mgd77/mgd77track
- supplements/misc/dimfilter
- supplements/potential/gmtgravmag3d
- supplements/potential/gravfft
- supplements/potential/grdgravmag3d
- supplements/potential/grdredpol
- supplements/potential/grdseamount
- supplements/segy/pssegy
- supplements/segy/pssegyz
- supplements/segy/segy2grd
- supplements/spotter/backtracker
- supplements/spotter/grdpmodeler
- supplements/spotter/grdrotater
- supplements/spotter/grdspotter
- supplements/spotter/hotspotter
- supplements/spotter/originator
- supplements/spotter/rotconverter
- supplements/x2sys/x2sys_binlist
- supplements/x2sys/x2sys_cross
- supplements/x2sys/x2sys_datalist
- supplements/x2sys/x2sys_get
- supplements/x2sys/x2sys_init
- supplements/x2sys/x2sys_list
- supplements/x2sys/x2sys_merge
- supplements/x2sys/x2sys_put
- supplements/x2sys/x2sys_report
- supplements/x2sys/x2sys_solve
diff --git a/doc_release/html/_sources/mapproject.txt b/doc_release/html/_sources/mapproject.txt
deleted file mode 100644
index f62e0f3..0000000
--- a/doc_release/html/_sources/mapproject.txt
+++ /dev/null
@@ -1,294 +0,0 @@
-.. index:: ! mapproject
-
-**********
-mapproject
-**********
-
-.. only:: not man
-
- mapproject - Do forward and inverse map transformations, datum conversions and geodesy
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**mapproject** [ *table* ] **-J**\ *parameters*
-|SYN_OPT-R|
-[ **-Ab**\ \|\ **B**\ \|\ **f**\ \|\ **F**\ \|\ **o**\ \|\ **O**\ [*lon0*/*lat0*] ]
-[ **-C**\ [*dx*/*dy*] ] [ **-Dc**\ \|\ **i**\ \|\ **p** ]
-[ **-E**\ [*datum*\ ] ] [ **-F**\ [*unit*\ ] ]
-[ **-G**\ [*x0*/*y0*/][[**+**\ \|\ **-**]\ *unit*][\ **+**\ \|\ **-**] ]
-[ **-I** ]
-[ **-L**\ *line.xy*\ [/[**+**\ \|\ **-**]\ *unit*][**+**] ]
-[ **-N**\ [**a**\ \|\ **c**\ \|\ **g**\ \|\ **m**] ]
-[ **-Q**\ [**d**\ \|\ **e** ] [ **-S** ]
-[ **-T**\ [**h**\ ]\ *from*\ [/*to*] ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-b| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-g| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-o| ]
-[ |SYN_OPT-s| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**mapproject** reads (longitude, latitude) positions from *infiles* [or
-standard input] and computes (x,y) coordinates using the specified map
-projection and scales. Optionally, it can read (x,y) positions and
-compute (longitude, latitude) values doing the inverse transformation.
-This can be used to transform linear (x,y) points obtained by digitizing
-a map of known projection to geographical coordinates. May also
-calculate distances along track, to a fixed point, or closest approach
-to a line. Finally, can be used to perform various datum conversions.
-Additional data fields are permitted after the first 2 columns which
-must have (longitude,latitude) or (x,y). See option **-:** on how to
-read (latitude,longitude) files.
-
-Required Arguments
-------------------
-
-.. include:: explain_-J.rst_
-
-.. |Add_-R| replace:: Special case for the UTM
- projection: If **-C** is used and **-R** is not given then the
- region is set to coincide with the given UTM zone so as to preserve
- the full ellipsoidal solution (See RESTRICTIONS for more information).
-.. include:: explain_-R.rst_
-
-Optional Arguments
-------------------
-
-.. |Add_intables| unicode:: 0x20 .. just an invisible code
-.. include:: explain_intables.rst_
-
-**-Ab**\ \|\ **B**\ \|\ **f**\ \|\ **F**\ \|\ **o**\ \|\ **O**\ [*lon0*/*lat0*]
- **-Af** calculates the (forward) azimuth from fixed point *lon/lat*
- to each data point. Use **-Ab** to get back-azimuth from data points
- to fixed point. Use **-Ao** to get orientations (-90/90) rather than
- azimuths (0/360). Upper case **F**, **B** or **O** will convert from
- geodetic to geocentric latitudes and estimate azimuth of geodesics
- (assuming the current ellipsoid is not a sphere). If no fixed point
- is given then we compute the azimuth (or back-azimuth) from the
- previous point.
-**-C**\ [*dx*/*dy*]
- Set center of projected coordinates to be at map projection center
- [Default is lower left corner]. Optionally, add offsets in the
- projected units to be added (or subtracted when **-I** is set) to
- (from) the projected coordinates, such as false eastings and
- northings for particular projection zones [0/0]. The unit used for
- the offsets is the plot distance unit in effect (see
- :ref:`PROJ_LENGTH_UNIT <PROJ_LENGTH_UNIT>`) unless **-F** is used, in which case the
- offsets are in meters.
-**-Dc**\ \|\ **i**\ \|\ **p**
- Temporarily override :ref:`PROJ_LENGTH_UNIT <PROJ_LENGTH_UNIT>` and use **c** (cm),
- **i** (inch), or **p** (points) instead. Cannot be used with **-F**.
-**-E**\ [*datum*\ ]
- Convert from geodetic (lon, lat, height) to Earth Centered Earth
- Fixed (ECEF) (x,y,z) coordinates (add **-I** for the inverse
- conversion). Append datum ID (see **-Qd**) or give
- *ellipsoid*:*dx*,\ *dy*,\ *dz* where *ellipsoid* may be an ellipsoid
- ID (see **-Qe**) or given as *a*\ [,*inv_f*], where *a* is the
- semi-major axis and *inv_f* is the inverse flattening (0 if
- omitted). If *datum* is - or not given we assume WGS-84.
-**-F**\ [*unit*\ ]
- Force 1:1 scaling, i.e., output (or input, see **-I**) data are in
- actual projected meters. To specify other units, append the desired
- unit (see UNITS). Without **-F**, the output (or input, see **-I**)
- are in the units specified by :ref:`PROJ_LENGTH_UNIT <PROJ_LENGTH_UNIT>` (but see
- **-D**).
-**-G**\ [*x0*/*y0*/][[**+**\ \|\ **-**]\ *unit*][\ **+**\ \|\ **-**]
- Calculate distances along track *or* to the optional point set with
- **-G**\ *x0/y0*. Append the distance unit (see UNITS), including
- **c** (Cartesian distance using input coordinates) or **C**
- (Cartesian distance using projected coordinates). The **C** unit
- requires **-R** and **-J** to be set. With no fixed point is given
- we calculate cumulate distances along track. Append **-** to obtain
- incremental distance between successive points. Append **+** to
- specify the 2nd point via two extra columns in the input file.
-**-I**
- Do the Inverse transformation, i.e., get (longitude,latitude) from (x,y) data.
-**-L**\ *line.xy*\ [/[**+**\ \|\ **-**]\ *unit*][**+**\ ]
- Determine the shortest distance from the input data points to the
- line(s) given in the ASCII multisegment file *line.xy*. The distance
- and the coordinates of the nearest point will be appended to the
- output as three new columns. Append the distance unit (see UNITS),
- including **c** (Cartesian distance using input coordinates) or
- **C** (Cartesian distance using projected coordinates). The **C**
- unit requires **-R** and **-J** to be set. Finally, append **+** to
- report the line segment id and the fractional point number instead
- of lon/lat of the nearest point.
-**-N**\ [**a**\ \|\ **c**\ \|\ **g**\ \|\ **m**]
- Convert from geodetic latitudes (using the current ellipsoid; see
- :ref:`PROJ_ELLIPSOID <PROJ_ELLIPSOID>`) to one of four different auxiliary latitudes
- (longitudes are unaffected). Choose from **a**\ uthalic,
- **c**\ onformal, **g**\ eocentric, and **m**\ eridional latitudes
- [geocentric]. Use **-I** to convert from auxiliary latitudes to
- geodetic latitudes.
-**-Q**\ [**d**\ \|\ **e**
- List all projection parameters. To only list datums, use **-Qd**. To
- only list ellipsoids, use **-Qe**.
-**-S**
- Suppress points that fall outside the region.
-**-T**\ [**h**\ ]\ *from*\ [/*to*]
- Coordinate conversions between datums *from* and *to* using the
- standard Molodensky transformation. Use **-Th** if 3rd input column
- has height above ellipsoid [Default assumes height = 0, i.e., on the
- ellipsoid]. Specify datums using the datum ID (see **-Qd**) or give
- *ellipsoid*:*dx*,\ *dy*,\ *dz* where *ellipsoid* may be an ellipsoid
- ID (see **-Qe**) or given as *a*\ [,*inv_f*], where *a* is the
- semi-major axis and *inv_f* is the inverse flattening (0 if
- omitted). If *datum* is - or not given we assume WGS-84. **-T** may
- be used in conjunction with **-R** **-J** to change the datum before
- coordinate projection (add **-I** to apply the datum conversion
- after the inverse projection). Make sure that the
- :ref:`PROJ_ELLIPSOID <PROJ_ELLIPSOID>` setting is correct for your case.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. |Add_-bi| replace:: [Default is 2 input columns].
-.. include:: explain_-bi.rst_
-
-.. |Add_-bo| replace:: [Default is same as input].
-.. include:: explain_-bo.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-g| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-g.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. include:: explain_-ocols.rst_
-
-.. include:: explain_-s.rst_
-
-.. include:: explain_colon.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_distunits.rst_
-
-.. include:: explain_precision.rst_
-
-
-Examples
---------
-
-To transform a file with (longitude,latitude) into (x,y) positions in cm
-on a Mercator grid for a given scale of 0.5 cm per degree, run
-
- ::
-
- gmt mapproject lonlatfile -R20/50/12/25 -Jm0.5c > xyfile
-
-To transform several 2-column, binary, double precision files with
-(latitude,longitude) into (x,y) positions in inch on a Transverse
-Mercator grid (central longitude 75W) for scale = 1:500000 and suppress
-those points that would fall outside the map area, run
-
- ::
-
- gmt mapproject tracks.* -R-80/-70/20/40 -Jt-75/1:500000 -: -S -Di -bo -bi2 > tmfile.b
-
-To convert the geodetic coordinates (lon, lat, height) in the file
-old.dat from the NAD27 CONUS datum (Datum ID 131 which uses the
-Clarke-1866 ellipsoid) to WGS 84, run
-
- ::
-
- gmt mapproject old.dat -Th131 > new.dat
-
-To compute the closest distance (in km) between each point in the input
-file quakes.dat and the line segments given in the multisegment ASCII
-file coastline.xy, run
-
- ::
-
- gmt mapproject quakes.dat -Lcoastline.xy/k > quake_dist.dat
-
-Restrictions
-------------
-
-The rectangular input region set with **-R** will in general be mapped
-into a non-rectangular grid. Unless **-C** is set, the leftmost point on
-this grid has xvalue = 0.0, and the lowermost point will have yvalue =
-0.0. Thus, before you digitize a map, run the extreme map coordinates
-through **mapproject** using the appropriate scale and see what (x,y)
-values they are mapped onto. Use these values when setting up for
-digitizing in order to have the inverse transformation work correctly,
-or alternatively, use **awk** to scale and shift the (x,y) values before
-transforming.
-
-For some projection, a spherical solution may be used despite the user
-having selected an ellipsoid. This occurs when the users **-R** setting
-implies a region that exceeds the domain in which the ellipsoidal series
-expansions are valid. These are the conditions: (1) Lambert Conformal
-Conic (**-JL**)and Albers Equal-Area (**-JB**) will use the spherical
-solution when the map scale exceeds 1.0E7. (2) Transverse Mercator
-(**-JT**) and UTM (**-JU**) will will use the spherical solution when
-either the west or east boundary given in **-R** is more than 10 degrees
-from the central meridian, and (3) same for Cassini
-(**-JC**) but with a limit of only 4 degrees.
-
-Ellipsoids And Spheroids
-------------------------
-
-GMT will use ellipsoidal formulae if they are implemented and the
-user have selected an ellipsoid as the reference shape (see
-:ref:`PROJ_ELLIPSOID <PROJ_ELLIPSOID>`). The user needs to be aware of a
-few potential pitfalls: (1) For some projections, such as Transverse
-Mercator, Albers, and Lambert's conformal conic we use the ellipsoidal
-expressions when the areas mapped are small, and switch to the spherical
-expressions (and substituting the appropriate auxiliary latitudes) for
-larger maps. The ellipsoidal formulae are used as follows: (a)
-Transverse Mercator: When all points are within 10 degrees of central
-meridian, (b) Conic projections when longitudinal range is less than 90
-degrees, (c) Cassini projection when all points are within 4 degrees of
-central meridian. (2) When you are trying to match some historical data
-(e.g., coordinates obtained with a certain projection and a certain
-reference ellipsoid) you may find that GMT gives results that are
-slightly different. One likely source of this mismatch is that older
-calculations often used less significant digits. For instance, Snyder's
-examples often use the Clarke 1866 ellipsoid (defined by him as having a
-flattening f = 1/294.98). From f we get the eccentricity squared to be
-0.00676862818 (this is what GMT uses), while Snyder rounds off and
-uses 0.00676866. This difference can give discrepancies of several tens
-of cm. If you need to reproduce coordinates projected with this slightly
-different eccentricity, you should specify your own ellipsoid with the
-same parameters as Clarke 1866, but with f = 1/294.97861076. Also, be
-aware that older data may be referenced to different datums, and unless
-you know which datum was used and convert all data to a common datum you
-may experience mismatches of tens to hundreds of meters. (3) Finally, be
-aware that :ref:`PROJ_SCALE_FACTOR <PROJ_SCALE_FACTOR>` have certain default values for some
-projections so you may have to override the setting in order to match
-results produced with other settings.
-
-See Also
---------
-
-:doc:`gmt`, :doc:`gmt.conf`,
-:doc:`gmtvector`,
-:doc:`project`
-
-References
-----------
-
-Bomford, G., 1952, Geodesy, Oxford U. Press.
-
-Snyder, J. P., 1987, Map Projections - A Working Manual, U.S. Geological
-Survey Prof. Paper 1395.
-
-Vanicek, P. and Krakiwsky, E, 1982, Geodesy - The Concepts,
-North-Holland Publ., ISBN: 0 444 86149 1.
diff --git a/doc_release/html/_sources/nearneighbor.txt b/doc_release/html/_sources/nearneighbor.txt
deleted file mode 100644
index 63b3428..0000000
--- a/doc_release/html/_sources/nearneighbor.txt
+++ /dev/null
@@ -1,150 +0,0 @@
-.. index:: ! nearneighbor
-
-**************
-nearneighbor
-**************
-
-.. only:: not man
-
- nearneighbor - Grid table data using a "Nearest neighbor" algorithm
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**nearneighbor** [ *table* ] **-G**\ *out_grdfile*
-|SYN_OPT-I|
-**-N**\ *sectors*\ [/*min_sectors*]
-|SYN_OPT-R|
-[ **-S**\ *search_radius*\ [*unit*\ ] [ **-E**\ *empty* ]
-[ |SYN_OPT-V| ]
-[ **-W** ]
-[ |SYN_OPT-bi| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-n| ]
-[ **-r** ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**nearneighbor** reads arbitrarily located (x,y,z[,w]) triples
-[quadruplets] from standard input [or *table*] and uses a nearest
-neighbor algorithm to assign an average value to each node that have one
-or more points within a radius centered on the node. The average value
-is computed as a weighted mean of the nearest point from each sector
-inside the search radius. The weighting function used is w(r) = 1 / (1 +
-d ^ 2), where d = 3 \* r / search_radius and r is distance from the
-node. This weight is modulated by the weights of the observation points [if
-supplied].
-
-Required Arguments
-------------------
-
-**-G**\ *out_grdfile*
- Give the name of the output grid file.
-
-.. include:: explain_-I.rst_
-
-**-N**\ *sectors*\ [/*min_sectors*]
- The circular area centered on each node is divided into *sectors*
- sectors. Average values will only be computed if there is at least
- one value inside each of at least *min_sectors* of the sectors for a given
- node. Nodes that fail this test are assigned the value NaN (but see
- **-E**). If *Imin_sectors* is omitted it is set to be at least 50%
- of *sectors* (i.e., rounded up to next integer). [Default is a quadrant
- search with 100% coverage, i.e., *sectors* = *min_sectors* = 4]. Note
- that only the nearest value per sector enters into the averaging; the
- more distant points are ignored.
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-R.rst_
-
-**-S**\ *search_radius*\ [*unit*]
- Sets the *search_radius* that determines which data points are
- considered close to a node. Append the distance unit (see UNITS).
-
-Optional Arguments
-------------------
-
-*table*
- 3 [or 4, see **-W**] column ASCII file(s) [or binary, see
- **-bi**] holding (x,y,z[,w]) data values. If
- no file is specified, **nearneighbor** will read from standard
- input.
-**-E**\ *empty*
- Set the value assigned to empty nodes [NaN].
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-W**
- Input data have a 4th column containing observation point weights.
- These are multiplied with the geometrical weight factor to determine
- the actual weights used in the calculations.
-
-.. |Add_-bi| replace:: [Default is 3 (or 4 if **-W** is set) columns].
-.. include:: explain_-bi.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-**-n**\ [**b**\ \|\ **c**\ \|\ **l**\ \|\ **n**][**+a**\ ][\ **+b**\ *BC*][\ **+t**\ *threshold*]
- Append **+b**\ *BC* to set any boundary conditions to be used,
- adding **g** for geographic, **p** for periodic, or **n** for
- natural boundary conditions. For the latter two you may append **x**
- or **y** to specify just one direction, otherwise both are assumed.
- [Default is geographic if grid is geographic].
-
-.. |Add_nodereg| unicode:: 0x20 .. just an invisible code
-.. include:: explain_nodereg.rst_
-
-.. include:: explain_colon.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_distunits.rst_
-
-.. include:: explain_float.rst_
-
-Examples
---------
-
-To create a gridded data set from the file seaMARCII_bathy.lon_lat_z
-using a 0.5 min grid, a 5 km search radius, using an octant search with
-100% sector coverage, and set empty nodes to -9999:
-
- ::
-
- gmt nearneighbor seaMARCII_bathy.lon_lat_z -R242/244/-22/-20 -I0.5m \
- -E-9999 -Gbathymetry.nc -S5k -N8/8
-
-To make a global grid file from the data in geoid.xyz using a 1 degree
-grid, a 200 km search radius, spherical distances, using an quadrant
-search, and set nodes to NaN only when fewer than two quadrants contain
-at least one value:
-
- ::
-
- gmt nearneighbor geoid.xyz -R0/360/-90/90 -I1 -Lg -Ggeoid.nc -S200k -N4
-
-See Also
---------
-
-:doc:`blockmean`,
-:doc:`blockmedian`,
-:doc:`blockmode`, :doc:`gmt`,
-:doc:`greenspline`,
-:doc:`sphtriangulate`,
-:doc:`surface`,
-:doc:`triangulate`
diff --git a/doc_release/html/_sources/project.txt b/doc_release/html/_sources/project.txt
deleted file mode 100644
index e2b0ea8..0000000
--- a/doc_release/html/_sources/project.txt
+++ /dev/null
@@ -1,271 +0,0 @@
-.. index:: ! project
-
-*******
-project
-*******
-
-.. only:: not man
-
- project - Project table data onto lines or great circles, generate tracks, or translate coordinates
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**project** [ *table* ] **-C**\ *cx*/*cy* [ **-A**\ *azimuth* ] [
-**-E**\ *bx*/*by* ] [ **-F**\ *flags* ]
-[ **-G**\ *dist*\ [/*colat*][**+**] ]
-[ **-L**\ [**w**\ ][\ *l\_min*/*l\_max*] ] [ **-N** ] [ **-Q** ] [ **-S** ]
-[ **-T**\ *px*/*py* ]
-[ |SYN_OPT-V| ]
-[ **-W**\ *w\_min*/*w\_max* ]
-[ |SYN_OPT-b| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-g| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-s| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**project** reads arbitrary (*x*, *y*\ [,\ *z*]) data from standard input
-[or *infile* ] and writes to standard output any combination of (*x*,
-*y*, *z*, *p*, *q*, *r*, *s*), where (*p*, *q*) are the coordinates in
-the projection, (*r*, *s*) is the position in the (*x*, *y*) coordinate
-system of the point on the profile (*q* = 0 path) closest to (*x*, *y*),
-and *z* is all remaining columns in the input (beyond the required *x*
-and *y* columns).
-
-Alternatively, **project** may be used to generate (*r*, *s*, *p*)
-triples at equal increments *dist* along a profile. In this case (
-**-G** option), no input is read.
-
-Projections are defined in any (but only) one of three ways:
-
-(Definition 1) By a Center **-C** and an Azimuth **-A** in degrees
-clockwise from North.
-
-(Definition 2) By a Center **-C** and end point E of the projection path **-E**.
-
-(Definition 3) By a Center **-C** and a roTation pole position **-T**.
-
-To spherically project data along a great circle path, an oblique
-coordinate system is created which has its equator along that path, and
-the zero meridian through the Center. Then the oblique longitude
-(*p*) corresponds to the distance from the Center
-along the great circle, and the oblique latitude (*q*) corresponds to
-the distance perpendicular to the great circle path. When moving in the
-increasing (*p*) direction, (toward *B* or in the
-*azimuth* direction), the positive (*q*) direction is to your left. If a
-Pole has been specified, then the positive (*q*) direction is toward the
-pole.
-
-To specify an oblique projection, use the **-T** option to set the Pole.
-Then the equator of the projection is already determined and the **-C**
-option is used to locate the *p* = 0 meridian. The Center *cx/cy* will
-be taken as a point through which the *p* = 0 meridian passes. If you do
-not care to choose a particular point, use the South pole (*ox* = 0,
-*oy* = -90).
-
-Data can be selectively windowed by using the **-L** and **-W** options.
-If **-W** is used, the projection Width is set to use only points with
-*w\_min* < q < *w\_max*. If **-L** is set, then the Length is set to use
-only those points with *l\_min* < p < *l\_max*. If the **-E** option has
-been used to define the projection, then **-Lw** may be selected to
-window the length of the projection to exactly the span from **O** to
-**B**.
-
-Flat Earth (Cartesian) coordinate transformations can also be made. Set
-**-N** and remember that *azimuth* is clockwise from North (the *y*
-axis), NOT the usual cartesian theta, which is counterclockwise from the
-*x* axis. *azimuth* = 90 - theta.
-
-No assumptions are made regarding the units for *x*, *y*, *r*, *s*, *p*,
-*q*, *dist*, *l\_min*, *l\_max*, *w\_min*, *w\_max*. If **-Q** is
-selected, map units are assumed and *x*, *y*, *r*, *s* must be in
-degrees and *p*, *q*, *dist*, *l\_min*, *l\_max*, *w\_min*, *w\_max*
-will be in km.
-
-Calculations of specific great-circle and geodesic distances or for
-back-azimuths or azimuths are better done using **mapproject**.
-
-**project** is CASE SENSITIVE. Use UPPER CASE for all one-letter
-designators which begin optional arguments. Use lower case for the
-xyzpqrs letters in **-flags**.
-
-Required Arguments
-------------------
-
-**-C**\ *cx*/*cy*
- *cx/cy* sets the origin of the projection, in Definition 1 or 2. If
- Definition 3 is used (**-T**), then *cx/cy* are the coordinates of a
- point through which the oblique zero meridian (*p* = 0) should pass.
- The *cx/cy* is not required to be 90 degrees from the pole.
-
-Optional Arguments
-------------------
-
-.. |Add_intables| unicode:: 0x20 .. just an invisible code
-.. include:: explain_intables.rst_
-
-**-A**\ *azimuth*
- *azimuth* defines the azimuth of the projection (Definition 1).
-**-E**\ *bx*/*by*
- *bx/by* defines the end point of the projection path (Definition 2).
-**-F**\ *flags*
- Specify your desired output using any combination of *xyzpqrs*, in
- any order. Do not space between the letters. Use lower case. The
- output will be ASCII (or binary, see **-bo**)
- columns of values corresponding to *xyzpqrs* [Default]. If both
- input and output are using ASCII format then the *z* data are
- treated as textstring(s). If the **-G** option is selected, the
- output will be *rsp*.
-**-G**\ *dist*\ [/*colat*]
- Generate mode. No input is read. Create (*r*, *s*, *p*) output
- points every *dist* units of *p*. See **-Q** option. Alternatively,
- append **/**\ *colat* for a small circle instead [Default is a
- colatitude of 90, i.e., a great circle]. Use **-C** and **-E** to
- generate a circle that goes through the center and end point. Note,
- in this case the center and end point cannot be farther apart than
- 2\*\|\ *colat*\ \|. Finally, if you append **+** the we will report
- the position of the pole as part of the segment header [no header].
-**-L**\ [**w**\ ][\ *l\_min*/*l\_max*]
- Length controls. Project only those points whose *p* coordinate is
- within *l\_min* < *p* < *l\_max*. If **-E** has been set, then you
- may use **-Lw** to stay within the distance from **C** to **E**.
-**-N**
- Flat Earth. Make a Cartesian coordinate transformation in the plane.
- [Default uses spherical trigonometry.]
-**-Q**
- Map type units, i.e., project assumes *x*, *y*, *r*, *s* are in
- degrees while *p*, *q*, *dist*, *l\_min*, *l\_max*, *w\_min*,
- *w\_max* are in km. If **-Q** is not set, then all these are assumed
- to be in the same units.
-**-S**
- Sort the output into increasing *p* order. Useful when projecting
- random data into a sequential profile.
-**-T**\ *px*/*py*
- *px/py* sets the position of the rotation pole of the projection.
- (Definition 3).
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-W**\ *w\_min*/*w\_max*
- Width controls. Project only those points whose *q* coordinate is
- within *w\_min* < *q* < *w\_max*.
-
-.. |Add_-bi| replace:: [Default is 2 input columns].
-.. include:: explain_-bi.rst_
-
-.. |Add_-bo| replace:: [Default is given by **-F** or **-G**].
-.. include:: explain_-bo.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-g| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-g.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. include:: explain_-s.rst_
-
-.. include:: explain_colon.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_precision.rst_
-
-Examples
---------
-
-To generate points every 10km along a great circle from 10N,50W to 30N,10W:
-
- ::
-
- gmt project -C-50/10 -E-10/30 -G10 -Q > great_circle_points.xyp
-
-(Note that great_circle_points.xyp could now be used as input for **grdtrack**, etc. ).
-
-To generate points every 10km along a small circle of colatitude 60 from 10N,50W to 30N,10W:
-
- ::
-
- gmt project -C-50/10 -E-10/30 -G10/60 -Q > small_circle_points.xyp
-
-To create a partial small circle of colatitude 80 about a pole at
-40E,85N, with extent of 45 degrees to either side of the meridian
-defined by the great circle from the pole to a point 15E,15N, try
-
- ::
-
- gmt project -C15/15 -T40/85 -G1/80 -L-45/45 > some_circle.xyp
-
-To project the shiptrack gravity, magnetics, and bathymetry in
-c2610.xygmb along a great circle through an origin at 30S, 30W, the
-great circle having an azimuth of N20W at the origin, keeping only the
-data from NE of the profile and within +/- 500 km of the origin, run:
-
- ::
-
- gmt project c2610.xygmb -C-30/-30 -A-20 -W-10000/0 -L-500/500 -Fpz -Q > c2610_projected.pgmb
-
-(Note in this example that **-W**-10000/0 is used to admit any value
-with a large negative *q* coordinate. This will take those points which
-are on our right as we walk along the great circle path, or to the NE in this example.)
-
-To make a Cartesian coordinate transformation of mydata.xy so that the
-new origin is at 5,3 and the new *x* axis (*p*) makes
-an angle of 20 degrees with the old *x* axis, use:
-
- ::
-
- gmt project mydata.xy -C5/3 -A70 -Fpq > mydata.pq
-
-To take data in the file pacific.lonlat and transform it into oblique
-coordinates using a pole from the hotspot reference frame and placing
-the oblique zero meridian (*p* = 0 line) through Tahiti, run:
-
- ::
-
- gmt project pacific.lonlat -T-75/68 -C-149:26/-17:37 -Fpq > pacific.pq
-
-Suppose that pacific_topo.nc is a grid file of bathymetry, and you want
-to make a file of flowlines in the hotspot reference frame. If you run:
-
- ::
-
- gmt grd2xyz pacific_topo.nc | project -T-75/68 -C0/-90 -Fxyq | xyz2grd -Retc -Ietc -Cflow.nc
-
-then flow.nc is a file in the same area as pacific_topo.nc, but flow
-contains the latitudes about the pole of the projection. You now can use
-grdcontour on flow.nc to draw lines of constant oblique latitude, which
-are flow lines in the hotspot frame.
-
-If you have an arbitrarily rotation pole *px/py* and you would like to
-draw an oblique small circle on a map, you will first need to make a
-file with the oblique coordinates for the small circle (i.e., lon =
-0-360, lat is constant), then create a file with two records: the north
-pole (0/90) and the origin (0/0), and find what their oblique
-coordinates are using your rotation pole. Now, use the projected North
-pole and origin coordinates as the rotation pole and center,
-respectively, and project your file as in the pacific example above.
-This gives coordinates for an oblique small circle.
-
-See Also
---------
-
-:doc:`fitcircle`,
-:doc:`gmt`,
-:doc:`gmtvector`,
-:doc:`mapproject`,
-:doc:`grdproject`
diff --git a/doc_release/html/_sources/ps2raster.txt b/doc_release/html/_sources/ps2raster.txt
deleted file mode 100644
index 7ebea9b..0000000
--- a/doc_release/html/_sources/ps2raster.txt
+++ /dev/null
@@ -1,344 +0,0 @@
-.. index:: ! ps2raster
-
-*********
-ps2raster
-*********
-
-.. only:: not man
-
- ps2raster - Convert [E]PS file(s) to other formats using GhostScript
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**ps2raster** *psfile(s)*
-[ **-A**\ [**u**][*margins*][**-**][**+r**][**+s**\ \|\ **S**\ *width*\ [**u**]/\ *height*\ [**u**]] ]
-[ **-C**\ *gs_option* ] [ **-D**\ *outdir* ] [ **-E**\ *resolution* ]
-[ **-G**\ *ghost_path* ] [ **-I** ] [ **-L**\ *listfile* ] [ **-P** ]
-[ **-Q**\ [**g**\ \|\ **t**][1\|2\|4] ] [ **-S** ]
-[ **-Tb**\ \|\ **e**\ \|\ **E**\ \|\ **f**\ \|\ **F**\ \|\ **j**\ \|\ **g**\ \|\ **G**\ \|\ **m**\ \|\ **t** ]
-[ |SYN_OPT-V| ]
-[ **-W**\ [**+g**][\ **+t**\ *docname*][**+n**\ *layername*][**+o**\ *foldername*][**+a**\ *altmode*\ [*alt*]][**+l**\ *minLOD/maxLOD*][**+f**\ *minfade/maxfade*][**+u**\ *URL*] ]
-
-|No-spaces|
-
-Description
------------
-
-**ps2raster** converts one or more PostScript files to other formats
-(BMP, EPS, JPEG, PDF, PNG, PPM, TIFF) using GhostScript. Input file
-names are read from the command line or from a file that lists them. The
-size of the resulting images is determined by the BoundingBox (or
-HiResBoundingBox, if present). As an option, a tight (HiRes)BoundingBox
-may be computed first. As another option, it can compute ESRI type world
-files used to reference, for instance, tif files and make them be
-recognized as geotiff. Note: If the PostScript file calls on any of
-the Adobe PDF transparency extensions *and* PDF is not the selected output
-format, then the file will first be converted to a temporary PDF file
-(for the transparency to take effect) before converting the PDF to the
-desired output format.
-
-Required Arguments
-------------------
-
-*psfiles*
- Names of PostScript files to be converted. The output files will
- have the same name (unless **-F** is used) but with the conventional
- extension name associated to the raster format (e.g., .jpg for the
- jpeg format). Use **-D** to redirect the output to a different
- directory.
-
-Optional Arguments
-------------------
-
-**-A**\ [**u**][*margins*][**-**][**+r**][**+s**\ \|\ **S**\ *width*\ [**u**]/\ *height*\ [**u**]]
- Adjust the BoundingBox and HiResBoundingBox to the minimum required
- by the image content. Append **u** to first remove any GMT-produced
- time-stamps. Optionally, append extra margins to the bounding box.
- Give either one (uniform), two (x and y) or four (individual sides)
- margins; append unit [Default is set by :ref:`PROJ_LENGTH_UNIT <PROJ_LENGTH_UNIT>`].
- Alternatively, use **-A-** to override any automatic setting of **-A** by **-W**.
-
- Use the **-A+s**\ *new_width* to resize the output image to exactly *new_width* units.
- The default is to use what is set by :ref:`PROJ_LENGTH_UNIT <PROJ_LENGTH_UNIT>`
- but you can append a new unit and/or impose different width and height. What happens
- here is that GhostScript will do the re-interpolation work and the final image will
- retain the DPI resolution set by **-E**.
- Alternatively use **-A+S**\ *scale* to scale the image by a constant factor.
-
- Use the **-A+r** to round the HighRes BoundingBox instead of using the `ceil` function.
- This is going against Adobe Law but can be useful when creating very small images
- where the difference of one pixel might matter.
-
-**-C**\ *gs_option*
- Specify a single, custom option that will be passed on to
- GhostScript as is. Repeat to add several options [none].
-
-**-D**\ *outdir*
- Sets an alternative output directory (which must exist) [Default is
- the same directory as the PS files]. Use **-D.** to place the output
- in the current directory instead.
-
-**-E**\ *resolution*
- Set raster resolution in dpi [default = 720 for PDF, 300 for others].
-
-**-F**
- Force the output file name. By default output names are constructed
- using the input names as base, which are appended with an
- appropriate extension. Use this option to provide a different name,
- but without extension. Extension is still determined automatically.
-
-**-G**\ *ghost_path*
- Full path to your GhostScript executable. NOTE: For Unix systems
- this is generally not necessary. Under Windows, the GhostScript path
- is now fetched from the registry. If this fails you can still add
- the GS path to system's path or give the full path here. (e.g.,
- **-G**\ c:\\programs\\gs\\gs9.02\\bin\\gswin64c). WARNING: because
- of the poor decision of embedding the bits on the gs exe name we
- cannot satisfy both the 32 and 64 bits GhostScript executable names.
- So in case of 'get from registry' failure the default name (when no
- **-G** is used) is the one of the 64 bits version, or gswin64c
-
-**-I**
- Enforce gray-shades by using ICC profiles. GhostScript versions
- >= 9.00 change gray-shades by using ICC profiles. GhostScript 9.05
- and above provide the '-dUseFastColor=true' option to prevent that
- and that is what ps2raster does by default, unless option **-I** is
- set. Note that for GhostScript >= 9.00 and < 9.05 the gray-shade
- shifting is applied to all but PDF format. We have no solution to
- offer other than upgrade GhostScript.
-
-**-L**\ *listfile*
- The *listfile* is an ASCII file with the names of the PostScript
- files to be converted.
-
-**-N**
- This option is obsolete. Use **-S** to print the GhostScript
- command, if applicable. Use **-Te** to save the intermediate EPS file.
-
-**-P**
- Force Portrait mode. All Landscape mode plots will be rotated back
- so that they show unrotated in Portrait mode. This is practical when
- converting to image formats or preparing EPS or PDF plots for
- inclusion in documents.
-
-**-Q**\ [**g**\ \|\ **t**][1\|2\|4]
- Set the anti-aliasing options for **g**\ raphics or **t**\ ext.
- Append the size of the subsample box (1, 2, or 4) [4]. Default is no
- anti-aliasing (same as *bits* = 1).
-
-**-S**
- Print to standard error the GhostScript command after it has been executed.
- This option also prevent all intermediate files from being removed.
-
-**-Tb**\ \|\ **e**\ \|\ **E**\ \|\ **f**\ \|\ **F**\ \|\ **j**\ \|\ **g**\ \|\ **G**\ \|\ **m**\ \|\ **t**
- Sets the output format, where **b** means BMP, **e** means EPS,
- **E** means EPS with PageSize command, **f** means PDF, **F** means
- multi-page PDF, **j** means JPEG, **g** means PNG, **G** means
- transparent PNG (untouched regions are transparent), **m** means
- PPM, and **t** means TIFF [default is JPEG]. To **bjgt** you can
- append **-** in order to get a grayscale image. The EPS format can be
- combined with any of the other formats. For example, **-Tef**
- creates both an EPS and a PDF file. The **-TF** creates a multi-page
- PDF file from the list of input PS or PDF files. It requires the **-F** option.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-W**\ [**+g**][**+t**\ *docname*][**+n**\ *layername*][**+o**\ *foldername*][**+a**\ *altmode*\ [*alt*]][**+l**\ *minLOD/maxLOD*][**+f**\ *minfade/maxfade*][**+u**\ *URL*]
- Write a ESRI type world file suitable to make (e.g) .tif files be
- recognized as geotiff by softwares that know how to do it. Be aware,
- however, that different results are obtained depending on the image
- contents and if the **-B** option has been used or not. The trouble
- with the **-B** option is that it creates a frame and very likely
- its annotations. That introduces pixels outside the map data extent,
- and therefore the map extents estimation will be wrong. To avoid
- this problem use -\ -MAP_FRAME_TYPE=inside option which plots all
- annotations and ticks inside the image and therefore does not
- compromise the coordinate computations. Pay attention also to the
- cases when the plot has any of the sides with whites only because
- than the algorithm will fail miserably as those whites will be eaten
- by the GhostScript. In that case you really must use **-B** or use a
- slightly off-white color.
-
- Together with **-V** it prints on screen the gdal_translate
- (gdal_translate is a command line tool from the GDAL package)
- command that reads the raster + world file and creates a true
- geotiff file. Use **-W+g** to do a system call to gdal_translate
- and create a geoTIFF image right away. The output file will have a
- .tiff extension.
-
- The world file naming follows the convention of jamming a 'w' in the
- file extension. So, if output is tif **-Tt** the world file is a
- .tfw, for jpeg we have a .jgw and so on. This option automatically
- sets **-A** **-P**.
-
- Use **-W+k** to create a minimalist KML file that allows loading the
- image in GoogleEarth. Note that for this option the image must be in
- geographical coordinates. If not, a warning is issued but the KML
- file is created anyway. Several modifier options are available to
- customize the KML file in the form of **+**\ *opt* strings. Append
- **+t**\ *title* to set the document title [GMT KML Document],
- **+n**\ *layername* to set the layer name, and
- **+a**\ */altmode*\ [*altitude*] to select one of 5 altitude modes
- recognized by Google Earth that determines the altitude (in m) of
- the image: **G** clamped to the ground, **g** append altitude
- relative to ground, **a** append absolute altitude, **s** append
- altitude relative to seafloor, and **S** clamp it to the seafloor.
- Control visibility of the layer with the **+l**\ *minLOD/maxLOD* and
- **+f**\ *minfade/maxfade* options. Finally, if you plan to leave the
- image itself on a server and only distribute the KML, use
- **+u**\ *URL* to prepend the URL to the image reference. If you are
- building a multi-component KML file then you can issue a KML snipped
- without the KML header and trailer by using the **+o**\ *foldername*
- modification; it will enclose the image and associated KML code
- within a KML folder of the specified name. See the KML documentation
- for further explanation
- (http://code.google.com/apis/kml/documentation/).
-
- Further notes on the creation of georeferenced rasters.
- **ps2raster** can create a georeferenced raster image with a world
- file OR uses GDAL to convert the GMT PostScript file to geotiff.
- GDAL uses Proj.4 for its projection library. To provide with the
- information it needs to do the georeferencing, GMT 4.5 embeds a
- comment near the start of the PostScript file defining the
- projection using Proj.4 syntax. Users with pre-GMT v4.5 PostScript
- files, or even non-GMT ps files, can provide the information
- **ps2raster** requires by manually editing a line into the
- PostScript file, prefixed with %%PROJ.
-
- For example the command
-
- ::
-
- gmt pscoast -JM0/12c -R-10/-4/37/43 \
- -W1 -Di -Bg30m --MAP_FRAME_TYPE=inside > cara.ps
-
- adds this comment line
-
- ::
-
- %%PROJ: merc -10.0 -4.0 37.0 43.0 -1113194.908 -445277.963
- 4413389.889 5282821.824 +proj=merc +lon_0=0 +k=-1 +x_0=0 +y_0=0
- +a=6378137.0 +b=6356752.314245
-
- where 'merc' is the keyword for the coordinate conversion; the 2 to
- 5th elements contain the map limits, 6 to 9th the map limits in
- projected coordinates and the rest of the line has the regular proj4
- string for this projection.
-
-.. include:: explain_help.rst_
-
-Notes
------
-
-The conversion to raster images (BMP, JPEG, PNG, PPM or TIFF) inherently
-results in loss of details that are available in the original
-PostScript file. Choose a resolution that is large enough for the
-application that the image will be used for. For web pages, smaller dpi
-values suffice, for Word documents and PowerPoint presentations a higher
-dpi value is recommended. **ps2raster** uses the loss-less DEFLATE
-compression technique when creating PDF and PNG files and LZW compression
-for TIFF images.
-
-EPS is a vector, not a raster format. Therefore, the **-E** option has
-no effect on the creation of EPS files. Using the option **-Te** will
-remove PageSize commands from the PostScript file and will adjust the
-BoundingBox when the **-A** option is used. Note the original and
-required BoundingBox is limited to integer points, hence Adobe added the
-optional HiResBoundingBox to add more precision in sizing. The **-A**
-option calculates both and writes both to the EPS file used in the
-rasterization (and output if **-Te** is set).
-
-Although PDF is also a vector format, the **-E** option has an effect on
-the resolution of pattern fills and fonts that are stored as bitmaps in
-the document. **ps2raster** therefore uses a larger default resolution
-when creating PDF files. In order to obtain high-quality PDF files, the
-*/prepress* options are in effect, allowing only loss-less DEFLATE
-compression of raster images embedded in the PostScript file.
-
-Although **ps2raster** was developed as part of the GMT, it can be
-used to convert PostScript files created by nearly any graphics
-program. However, **-Au** is GMT-specific.
-
-See :ref:`include-gmt-graphics` of the **GMT Technical Reference and Cookbook** for more
-information on how **ps2raster** is used to produce graphics that can be
-inserted into other documents (articles, presentations, posters, etc.).
-
-Examples
---------
-
-To convert the file psfile.ps to PNG using a tight BoundingBox and
-rotating it back to normal orientation in case it was in Landscape mode:
-
- ::
-
- gmt ps2raster psfile.ps -A -P -Tg
-
-To create a 5 cm PNG version at 300 dpi of our example_01.ps file
-
- ::
-
- gmt ps2raster example_01.ps -A+s5c -Tg
-
-To create a 3 pages PDF file from 3 individual PS files
-
- ::
-
- gmt ps2raster -TF -Fabc a.ps b.ps c.ps
-
-To create a simple linear map with pscoast and convert it to tif with a
-.tfw the tight BoundingBox computation.
-
- ::
-
- gmt pscoast -JX12cd -R-10/-4/37/43 -W1 -Di -Bg30m -P -G200 --MAP_FRAME_TYPE=inside > cara.ps
- gmt ps2raster cara.ps -Tt -W
-
-To create a Mercator version of the above example and use GDAL to
-produce a true geotiff file.
-
- ::
-
- gmt pscoast -JM0/12c -R-10/-4/37/43 -W1 -Di -Bg30m -P -G200 --MAP_FRAME_TYPE=inside > cara.ps
- gdalwarp -s_srs +proj=merc cara.tif carageo.tiff
-
-To create a Polar Stereographic geotiff file of Patagonia
-
- ::
-
- gmt pscoast -JS-55/-60/15c -R-77/-55/-57.5/-48r -Di -Gred -P -Bg2 \
- --MAP_FRAME_TYPE=inside > patagonia.ps
- gmt ps2raster patagonia.ps -Tt -W+g -V
-
-To create a simple KMZ file for use in Google Earth, try
-
- ::
-
- gmt grdimage lonlatgrid.nc -Jx1 -Ccolors.cpt -P -B0g2 --MAP_FRAME_TYPE=inside > tile.ps
- gmt ps2raster tile.ps -Tg -W+k+t"my title"+l256/-1 -V
-
-(These commands assume that GhostScript can be found in your system's path.)
-
-GhostScript Options
--------------------
-
-Most of the conversions done in **ps2raster** are handled by
-GhostScript. On most Unixes this program is available as **gs**; for
-Windows there is a version called **gswin32c**. GhostScript accepts a
-rich selection of command-line options that modify its behavior. Many of
-these are set indirectly by the options available above. However,
-hard-core usage may require some users to add additional options to
-fine-tune the result. Use **-S** to examine the actual command used, and
-add custom options via one or more instances of the **-C** option. For
-instance, to turn on image interpolation for all images, improving image
-quality for scaled images at the expense of speed, use
-**-C**-dDOINTERPOLATE. See www.ghostscript.com for complete
-documentation.
-
-See Also
---------
-
-:doc:`gmt`
diff --git a/doc_release/html/_sources/psbasemap.txt b/doc_release/html/_sources/psbasemap.txt
deleted file mode 100644
index de52dda..0000000
--- a/doc_release/html/_sources/psbasemap.txt
+++ /dev/null
@@ -1,494 +0,0 @@
-.. index:: ! psbasemap
-
-*********
-psbasemap
-*********
-
-.. only:: not man
-
- psbasemap - Plot PostScript base maps
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**psbasemap** **-J**\ *parameters*
-|SYN_OPT-Rz|
-[ |SYN_OPT-B| ]
-[ **-D**\ [*unit*]\ *xmin/xmax/ymin/ymax*\ [**r**]\ \|\ *width*\ [/*height*][**+c**\ *clon/clat*][**+p**\ *pen*][**+g**\ *fill*]]
-[ **-K** ] [ **-Jz**\ \|\ **Z**\ *parameters* ]
-**-L**\ [**f**][**x**]\ *lon0*/*lat0*\ [/*slon*]/\ *slat*/*length*\ [**e**\ \|\ **f**\ \|\ **k**\ \|\ **M**\ \|\ **n**\ \|\ **u**][\ **+l**\ *label*][\ **+j**\ *just*][\ **+p**\ *pen*][\ **+g**\ *fill*][**+u**] ] ]
-[ **-O** ] [ **-P** ]
-[ |SYN_OPT-U| ]
-[ **-T**\ [**f**\ \|\ **m**][**x**\ ]\ *lon0*/*lat0*/*size*\ [/*info*][\ **:**\ *w*,\ *e*,\ *s*,\ *n*\ **:**][\ **+**\ *gint*\ [/*mint*]] ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-X| ]
-[ |SYN_OPT-Y| ]
-[ |SYN_OPT-c| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-p| ]
-[ |SYN_OPT-t| ]
-
-|No-spaces|
-
-Description
------------
-
-**psbasemap** creates PostScript code that will produce a basemap.
-Several map projections are available, and the user may specify separate
-tickmark intervals for boundary annotation, ticking, and [optionally]
-gridlines. A simple map scale or directional rose may also be plotted.
-At least one of the options **-B**,
-**-L**\ [**f**][**x**]\ *lon0*/*lat0*\ [/*slon*]/\ *slat*/*length*\ [**e**\ \|\ **f**\ \|\ **k**\ \|\ **M**\ \|\ **n**\ \|\ **u**][\ **+l**\ *label*][\ **+j**\ *just*][\ **+p**\ *pen*][\ **+g**\ *fill*][**+u**],
-or
-**-T**\ [**f**\ \|\ **m**][**x**]\ *lon0*/*lat0*/*size*\ [/*info*][\ **:**\ *w*,\ *e*,\ *s*,\ *n*\ **:**][\ **+**\ *gint*\ [/*mint*]]
-must be specified.
-
-Required Arguments
-------------------
-
-.. include:: explain_-J.rst_
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-R.rst_
-
-.. |Add_-Rz| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-Rz.rst_
-
-Optional Arguments
-------------------
-
-.. include:: explain_-B.rst_
-
-**-D**\ [*unit*]\ *xmin/xmax/ymin/ymax*\ [**r**]\ \|\ *width*\ [/*height*][**+c**\ *clon/clat*][**+p**\ *pen*][**+g**\ *fill*]
- Draw a simple map insert box on the map. Specify the box in one of three ways:
- (a) Give *west/east/south/north* of geographic rectangle bounded by parallels
- and meridians; append **r** if the coordinates instead are the lower left and
- upper right corners of the desired rectangle. (b) Give **u**\ *xmin/xmax/ymin/ymax*
- of bounding rectangle in projected coordinates (here, **u** is the coordinate unit).
- (c) Give [**u**]\ *width*\ [/*height*] of bounding rectangle and use **+c** to set
- box center. Append any combination of the following modifiers to draw the insert box:
- **+c**\ *lon/lat* to specify box center.
- **+g**\ *fill* to paint a insert [no fill].
- **+p**\ *pen* to draw the insert outline [no outline].
-
-.. include:: explain_-Jz.rst_
-
-.. include:: explain_-K.rst_
-
-.. include:: explain_-L_scale.rst_
-
-.. include:: explain_-O.rst_
-
-.. include:: explain_-P.rst_
-
-.. include:: explain_-T_rose.rst_
-
-.. include:: explain_-U.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. include:: explain_-XY.rst_
-
-.. include:: explain_-c.rst_
-
-.. |Add_-f| replace:: This applies only to the coordinates specified in the **-R** option.
-.. include:: explain_-f.rst_
-
-.. |Add_perspective| unicode:: 0x20 .. just an invisible code
-.. include:: explain_perspective.rst_
-
-.. include:: explain_-t.rst_
-
-.. include:: explain_help.rst_
-
-Examples
---------
-
-The following section illustrates the use of the options by giving some
-examples for the available map projections. Note how scales may be given
-in several different ways depending on the projection. Also note the use
-of upper case letters to specify map width instead of map scale.
-
-Non-geographical Projections
-----------------------------
-
-Linear x-y plot
-~~~~~~~~~~~~~~~
-
-To make a linear x/y frame with all axes, but with only left and bottom
-axes annotated, using xscale = yscale = 1.0, ticking every 1 unit and
-annotating every 2, and using xlabel = "Distance" and ylabel = "No of samples", use
-
- ::
-
- gmt psbasemap -R0/9/0/5 -Jx1 -Bf1a2:Distance:/:"No of samples":WeSn > linear.ps
-
-Log-log plot
-~~~~~~~~~~~~
-
-To make a log-log frame with only the left and bottom axes, where the
-x-axis is 25 cm and annotated every 1-2-5 and the y-axis is 15 cm and
-annotated every power of 10 but has tickmarks every 0.1, run
-
- ::
-
- gmt psbasemap -R1/10000/1e20/1e25 -JX25cl/15cl -B2:Wavelength:/a1pf3:Power:WS > loglog.ps
-
-Power axes
-~~~~~~~~~~
-
-To design an axis system to be used for a depth-sqrt(age) plot with
-depth positive down, ticked and annotated every 500m, and ages annotated
-at 1 my, 4 my, 9 my etc, use
-
- ::
-
- gmt psbasemap -R0/100/0/5000 -Jx1p0.5/-0.001 -B1p:"Crustal age":/500:Depth: > power.ps
-
-Polar (theta,r) plot
-~~~~~~~~~~~~~~~~~~~~
-
-For a base map for use with polar coordinates, where the radius from 0
-to 1000 should correspond to 3 inch and with gridlines and ticks every
-30 degrees and 100 units, use
-
- ::
-
- gmt psbasemap -R0/360/0/1000 -JP6i -B30p/100 > polar.ps
-
-Cylindrical Map Projections
----------------------------
-
-Cassini
-~~~~~~~
-
-A 10-cm-wide basemap using the Cassini projection may be obtained by
-
- ::
-
- gmt psbasemap -R20/50/20/35 -JC35/28/10c -P -B5g5:.Cassini: > cassini.ps
-
-Mercator [conformal]
-~~~~~~~~~~~~~~~~~~~~
-
-A Mercator map with scale 0.025 inch/degree along equator, and showing
-the length of 5000 km along the equator (centered on 1/1 inch), may be
-plotted as
-
- ::
-
- gmt psbasemap -R90/180/-50/50 -Jm0.025i -B30g30:.Mercator: -Lx1i/1i/0/5000 > mercator.ps
-
-Miller
-~~~~~~
-
-A global Miller cylindrical map with scale 1:200,000,000 may be plotted as
-
- ::
-
- gmt psbasemap -Rg -Jj180/1:200000000 -B30g30:.Miller: > miller.ps
-
-Oblique Mercator [conformal]
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-To create a page-size global oblique Mercator basemap for a pole at
-(90,30) with gridlines every 30 degrees, run
-
- ::
-
- gmt psbasemap -R0/360/-70/70 -Joc0/0/90/30/0.064cd -B30g30:."Oblique Mercator": > oblmerc.ps
-
-Transverse Mercator [conformal]
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-A regular Transverse Mercator basemap for some region may look like
-
- ::
-
- gmt psbasemap -R69:30/71:45/-17/-15:15 -Jt70/1:1000000 -B15m:."Survey area": -P > transmerc.ps
-
-Equidistant Cylindrical Projection
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-This projection only needs the central meridian and scale. A 25 cm wide
-global basemap centered on the 130E meridian is made by
-
- ::
-
- gmt psbasemap -R-50/310/-90/90 -JQ130/25c -B30g30:."Equidistant Cylindrical": > cyl\_eqdist.ps
-
-Universal Transverse Mercator [conformal]
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-To use this projection you must know the UTM zone number, which defines
-the central meridian. A UTM basemap for Indo-China can be plotted as
-
- ::
-
- gmt psbasemap -R95/5/108/20r -Ju46/1:10000000 -B3g3:.UTM: > utm.ps
-
-Cylindrical Equal-Area
-~~~~~~~~~~~~~~~~~~~~~~
-
-First select which of the cylindrical equal-area projections you want by
-deciding on the standard parallel. Here we will use 45 degrees which
-gives the Gall-Peters projection. A 9 inch wide global basemap centered
-on the Pacific is made by
-
- ::
-
- gmt psbasemap -Rg -JY180/45/9i -B30g30:.Gall-Peters: > gall-peters.ps
-
-Conic Map Projections
----------------------
-
-Albers [equal-area]
-~~~~~~~~~~~~~~~~~~~
-
-A basemap for middle Europe may be created by
-
- ::
-
- gmt psbasemap -R0/90/25/55 -Jb45/20/32/45/0.25c -B10g10:."Albers Equal-area": > albers.ps
-
-Lambert [conformal]
-~~~~~~~~~~~~~~~~~~~
-
-Another basemap for middle Europe may be created by
-
- ::
-
- gmt psbasemap -R0/90/25/55 -Jl45/20/32/45/0.1i -B10g10:."Lambert Conformal Conic": > lambertc.ps
-
-Equidistant
-~~~~~~~~~~~
-
-Yet another basemap of width 6 inch for middle Europe may be created by
-
- ::
-
- gmt psbasemap -R0/90/25/55 -JD45/20/32/45/6i -B10g10:."Equidistant conic": > econic.ps
-
-Polyconic
-~~~~~~~~~
-
-A basemap for north America may be created by
-
- ::
-
- gmt psbasemap -R-180/-20/0/90 -JPoly/4i -B30g10/10g10:."Polyconic": > polyconic.ps
-
-Azimuthal Map Projections
--------------------------
-
-Lambert [equal-area]
-~~~~~~~~~~~~~~~~~~~~
-
-A 15-cm-wide global view of the world from the vantage point -80/-30
-will give the following basemap:
-
- ::
-
- gmt psbasemap -Rg -JA-80/-30/15c -B30g30/15g15:."Lambert Azimuthal": > lamberta.ps
-
-Follow the instructions for stereographic projection if you want to
-impose rectangular boundaries on the azimuthal equal-area map but
-substitute **-Ja** for **-Js**.
-
-Equidistant
-~~~~~~~~~~~
-
-A 15-cm-wide global map in which distances from the center (here 125/10)
-to any point is true can be obtained by:
-
- ::
-
- gmt psbasemap -Rg -JE125/10/15c -B30g30/15g15:.Equidistant: > equi.ps
-
-Gnomonic
-~~~~~~~~
-
-A view of the world from the vantage point -100/40 out to a horizon of
-60 degrees from the center can be made using the Gnomonic projection:
-
- ::
-
- gmt psbasemap -Rg -JF-100/40/60/6i -B30g30/15g15:.Gnomonic: > gnomonic.ps
-
-Orthographic
-~~~~~~~~~~~~
-
-A global perspective (from infinite distance) view of the world from the
-vantage point 125/10 will give the following 6-inch-wide basemap:
-
- ::
-
- gmt psbasemap -Rg -JG125/10/6i -B30g30/15g15:.Orthographic: > ortho.ps
-
-General Perspective
-~~~~~~~~~~~~~~~~~~~
-
-The **-JG** option can be used in a more generalized form, specifying
-altitude above the surface, width and height of the view point, and
-twist and tilt. A view from 160 km above -74/41.5 with a tilt of 55 and
-azimuth of 210 degrees, and limiting the viewpoint to 30 degrees width
-and height will product a 6-inch-wide basemap:
-
- ::
-
- gmt psbasemap -Rg -JG-74/41.5/160/210/55/30/30/6i -B5g1/5g1:."General Perspective": > genper.ps
-
-Stereographic [conformal]
-~~~~~~~~~~~~~~~~~~~~~~~~~
-
-To make a polar stereographic projection basemap with radius = 12 cm to
--60 degree latitude, with plot title "Salinity measurements", using 5
-degrees annotation/tick interval and 1 degree gridlines, run
-
- ::
-
- gmt psbasemap -R-45/45/-90/-60 -Js0/-90/12c/-60 -B5g5:."Salinity measurements": > stereo1.ps
-
-To make a 12-cm-wide stereographic basemap for Australia from an
-arbitrary view point (not the poles), and use a rectangular boundary, we
-must give the pole for the new projection and use the **-R** option to
-indicate the lower left and upper right corners (in lon/lat) that will
-define our rectangle. We choose a pole at 130/-30 and use 100/-45 and
-160/-5 as our corners. The command becomes
-
- ::
-
- gmt psbasemap -R100/-45/160/-5r -JS130/-30/12c -B30g30/15g15:."General Stereographic View": > stereo2.ps
-
-`Miscellaneous Map Projections <#toc33>`_
------------------------------------------
-
-Hammer [equal-area]
-~~~~~~~~~~~~~~~~~~~
-
-The Hammer projection is mostly used for global maps and thus the
-spherical form is used. To get a world map centered on Greenwich at a
-scale of 1:200000000, use
-
- ::
-
- gmt psbasemap -Rd -Jh0/1:200000000 -B30g30/15g15:.Hammer: > hammer.ps
-
-Sinusoidal [equal-area]
-~~~~~~~~~~~~~~~~~~~~~~~
-
-To make a sinusoidal world map centered on Greenwich, with a scale along
-the equator of 0.02 inch/degree, use
-
- ::
-
- gmt psbasemap -Rd -Ji0/0.02i -B30g30/15g15:.Sinusoidal: > sinus1.ps
-
-To make an interrupted sinusoidal world map with breaks at 160W, 20W,
-and 60E, with a scale along the equator of 0.02 inch/degree, run the
-following sequence of commands:
-
- ::
-
- gmt psbasemap -R-160/-20/-90/90 -Ji-90/0.02i -B30g30/15g15Wesn -K > sinus_i.ps
- gmt psbasemap -R-20/60/-90/90 -Ji20/0.02i -B30g30/15g15wesn -O -K -X2.8i >> sinus_i.ps
- gmt psbasemap -R60/200/-90/90 -Ji130/0.02i -B30g30/15g15wEsn -O -X1.6i >> sinus_i.ps
-
-Eckert IV [equal-area]
-~~~~~~~~~~~~~~~~~~~~~~
-
-Pseudo-cylindrical projection typically used for global maps only. Set
-the central longitude and scale, e.g.,
-
- ::
-
- gmt psbasemap -Rg -Jkf180/0.064c -B30g30/15g15:."Eckert IV": > eckert4.ps
-
-Eckert VI [equal-area]
-~~~~~~~~~~~~~~~~~~~~~~
-
-Another pseudo-cylindrical projection typically used for global maps
-only. Set the central longitude and scale, e.g.,
-
- ::
-
- gmt psbasemap -Rg -Jks180/0.064c -B30g30/15g15:."Eckert VI": > eckert6.ps
-
-Robinson
-~~~~~~~~
-
-Projection designed to make global maps "look right". Set the central
-longitude and width, e.g.,
-
- ::
-
- gmt psbasemap -Rd -JN0/8i -B30g30/15g15:.Robinson: > robinson.ps
-
-Winkel Tripel
-~~~~~~~~~~~~~
-
-Yet another projection typically used for global maps only. You can set
-the central longitude, e.g.,
-
- ::
-
- gmt psbasemap -R90/450/-90/90 -JR270/25c -B30g30/15g15:."Winkel Tripel": > winkel.ps
-
-Mollweide [equal-area]
-~~~~~~~~~~~~~~~~~~~~~~
-
-The Mollweide projection is also mostly used for global maps and thus
-the spherical form is used. To get a 25-cm-wide world map centered on
-the Dateline:
-
- ::
-
- psbasemap -Rg -JW180/25c -B30g30/15g15:.Mollweide: > mollweide.ps
-
-Van der Grinten
-~~~~~~~~~~~~~~~
-
-The Van der Grinten projection is also mostly used for global maps and
-thus the spherical form is used. To get a 7-inch-wide world map centered on the Dateline:
-
- ::
-
- gmt psbasemap -Rg -JV180/7i -B30g30/15g15:."Van der Grinten": > grinten.ps
-
-CUSTOM lABELS OR INTERVALS
---------------------------
-
-The **-B** option sets up a regular annotation interval and the
-annotations derive from the corresponding *x*, *y*, or *z* coordinates.
-However, some applications requires special control on which annotations
-to plot and even replace the annotation with other labels. This is
-achieved by using **c**\ *intfile* in the **-B** option, where *intfile*
-contains all the information about annotations, ticks, and even
-gridlines. Each record is of the form *coord* *type* [*label*\ ], where
-*coord* is the coordinate for this annotation (or tick or gridline),
-*type* is one or more letters from **a** (annotation), **i** interval
-annotation, **f** tickamrk, and **g** gridline. Note that **a** and
-**i** are mutually exclusive and cannot both appear in the same
-*intfile*. Both **a** and **i** requires you to supply a *label* which
-is used as the plot annotation. If not given then a regular formatted
-annotation based on the coordinate will occur.
-
-Restrictions
-------------
-
-For some projections, a spherical earth is implicitly assumed. A warning
-will notify the user if **-V** is set.
-
-Bugs
-----
-
-The **-B** option is somewhat complicated to explain and comprehend.
-However, it is fairly simple for most applications (see examples).
-
-See Also
---------
-
-:doc:`gmt`, :doc:`gmt.conf`, :doc:`gmtcolors`
diff --git a/doc_release/html/_sources/psclip.txt b/doc_release/html/_sources/psclip.txt
deleted file mode 100644
index 9dc38b5..0000000
--- a/doc_release/html/_sources/psclip.txt
+++ /dev/null
@@ -1,163 +0,0 @@
-.. index:: ! psclip
-
-******
-psclip
-******
-
-.. only:: not man
-
- psclip - Initialize or terminate polygonal clip paths
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**psclip** [ *table* ] **-J**\ *parameters*
-|SYN_OPT-Rz|
-[ **-A**\ [**m**\ \|\ **p**] ]
-[ |SYN_OPT-B| ]
-**-Jz**\ \|\ **Z**\ *parameters* ] [ **-K** ] [ **-N** ] [ **-O** ]
-[ **-P** ] [ **-T** ]
-[ |SYN_OPT-U| ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-X| ]
-[ |SYN_OPT-Y| ]
-[ |SYN_OPT-bi| ]
-[ |SYN_OPT-c| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-g| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-p| ]
-[ |SYN_OPT-t| ]
-[ |SYN_OPT-:| ]
-
-**psclip** **-C**\ [\ *n*] [ **-K** ] [ **-O** ]
-
-|No-spaces|
-
-Description
------------
-
-**psclip** reads (x,y) file(s) [or standard input] and draws polygons
-that are activated as clipping paths. Several files may be read to
-create complex paths consisting of several non-connecting segments. Only
-marks that are subsequently drawn inside the clipping path will be
-shown. To determine what is inside or outside the clipping path,
-**psclip** uses the even-odd rule. When a ray drawn from any point,
-regardless of direction, crosses the clipping path segments an odd
-number of times, the point is inside the clipping path. If the number is
-even, the point is outside. The **-N** option, reverses the sense of
-what is the inside and outside of the paths by plotting a clipping path
-along the map boundary. After subsequent plotting, which will be clipped
-against these paths, the clipping may be deactivated by running
-**psclip** a second time with the **-C** option only.
-
-Required Arguments
-------------------
-
-**-C**\ [\|\ *n*]
- Mark end of existing clip path(s). No input file will be processed.
- No projection information is needed unless **-B** has been selected
- as well. With no arguments we terminate all active clipping paths.
- Experts may restrict the termination to just *n* of the active
- clipping path by passing that as the argument.
- Remember to supply
- **-X** and **-Y** settings if you have moved since the clip started.
-
-.. include:: explain_-J.rst_
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-R.rst_
-
-.. |Add_-Rz| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-Rz.rst_
-
-Optional Arguments
-------------------
-
-.. |Add_intables| unicode:: 0x20 .. just an invisible code
-.. include:: explain_intables.rst_
-
-**-A**\ [**m**\ \|\ **p**]
- By default line segments are connected as great circle arcs. To connect them as
- straight lines, use the **-A** flag. Alternatively, add **m** to connect
- the line by first following a meridian, then a parallel. Or append **p**
- to start following a parallel, then a meridian. (This can be practical
- to connect lines along parallels, for example).
-
-.. include:: explain_-B.rst_
-
-.. include:: explain_-Jz.rst_
-
-.. include:: explain_-K.rst_
-
-**-N**
- Invert the sense of what is inside and outside. For example, when
- using a single path, this means that only points outside that path
- will be shown. Cannot be used together with **-B**.
-
-.. include:: explain_-O.rst_
-
-.. include:: explain_-P.rst_
-
-**-T**
- Rather than read any input files, simply turn on clipping for the
- current map region. Basically, **-T** is a convenient way to run
- **psclip** with the arguments **-N** /dev/null (or, under Windows,
- **-N** NUL). Cannot be used together with **-B**.
-
-.. include:: explain_-U.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. include:: explain_-XY.rst_
-
-.. |Add_-bi| replace:: [Default is 2 input columns].
-.. include:: explain_-bi.rst_
-
-.. include:: explain_-c.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-g| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-g.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. |Add_perspective| unicode:: 0x20 .. just an invisible code
-.. include:: explain_perspective.rst_
-
-.. include:: explain_-t.rst_
-
-.. include:: explain_colon.rst_
-
-.. include:: explain_help.rst_
-
-Examples
---------
-
-To make an overlay PostScript file that will set up a complex clip
-area to which subsequent plotting will be confined, run:
-
- ::
-
- gmt psclip my_region.xy -R0/40/0/40 -Jm0.3i -O -K > clip_mask_on.ps
-
-To deactivate the clipping in an existing plotfile, run:
-
- ::
-
- gmt psclip -C -O >> complex_plot.ps
-
-See Also
---------
-
-:doc:`gmt`, :doc:`grdmask`,
-:doc:`psbasemap`, :doc:`psmask`
diff --git a/doc_release/html/_sources/pscoast.txt b/doc_release/html/_sources/pscoast.txt
deleted file mode 100644
index bbe39ee..0000000
--- a/doc_release/html/_sources/pscoast.txt
+++ /dev/null
@@ -1,318 +0,0 @@
-.. index:: ! pscoast
-
-*******
-pscoast
-*******
-
-.. only:: not man
-
- pscoast - Plot continents, shorelines, rivers, and borders on maps
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**pscoast** **-J**\ *parameters*
-|SYN_OPT-R|
-[ **-A**\ *min\_area*\ [/*min\_level*/*max\_level*][\ **+as**\ ][\ **+r**\ \|\ **l**][\ **p**\ *percent*] ]
-[ |SYN_OPT-B| ]
-[ **-C**\ [**l**\ \|\ **r**/]\ *fill* ]
-[ **-D**\ *resolution*\ [**+**] ]
-[ **-F**\ *code1,code2,...*\ [**+l**\|\ **L**][**+g**\ *fill*][**+p**\ *pen*][**+r**\|\ **R**\ [*incs*]]]
-[ **-G**\ *fill*\ \|\ **c** ] [ **-I**\ *river*\ [/\ *pen*] ]
-[ **-Jz**\ \|\ **Z**\ *parameters* ] [ **-K** ]
-[ **-L**\ [**f**\ ][**x**\ ]\ *lon0*/*lat0*\ [/*slon*]/\ *slat*/*length*\ [**e**\ \|\ **f**\ \|\ **k**\ \|\ **M**\ \|\ **n**\ \|\ **u**][\ **+l**\ *label*][\ **+j**\ *just*][\ **+p**\ *pen*][\ **+g**\ *fill*][**+u**] ] ]
-[ **-M** ] [ **-N**\ *border*\ [/*pen*] ] [ **-O** ] [ **-P** ]
-[ **-Q** ] [ **-S**\ *fill*\ \|\ **c** ]
-[ **-T**\ [**f**\ \|\ **m**][**x**\ ]\ *lon0*/*lat0*/*size*\ [/*info*][\ **:**\ *w*,\ *e*,\ *s*,\ *n*\ **:**][\ **+**\ *gint*\ [/*mint*]] ]
-[ |SYN_OPT-U| ]
-[ |SYN_OPT-V| ]
-[ **-W**\ [*level*/]\ *pen* ]
-[ |SYN_OPT-X| ]
-[ |SYN_OPT-Y| ]
-[ |SYN_OPT-bo| ]
-[ |SYN_OPT-c| ]
-[ |SYN_OPT-p| ]
-[ |SYN_OPT-t| ]
-
-|No-spaces|
-
-Description
------------
-
-**pscoast** plots grayshaded, colored, or textured land-masses [or
-water-masses] on maps and [optionally] draws coastlines, rivers, and
-political boundaries. Alternatively, it can (1) issue clip
-paths that will contain all land or all water areas, or
-(2) dump the data to an ASCII table. The data files come
-in 5 different resolutions: (**f**)ull, (**h**)igh, (**i**)ntermediate,
-(**l**)ow, and (**c**)rude. The full resolution files amount to more
-than 55 Mb of data and provide great detail; for maps of larger
-geographical extent it is more economical to use one of the other
-resolutions. If the user selects to paint the land-areas and does not
-specify fill of water-areas then the latter will be transparent (i.e.,
-earlier graphics drawn in those areas will not be overwritten).
-Likewise, if the water-areas are painted and no land fill is set then
-the land-areas will be transparent. A map projection must be supplied.
-The PostScript code is written to standard output.
-
-Required Arguments
-------------------
-
-.. include:: explain_-J.rst_
-
-.. |Add_-Rgeo| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-Rgeo.rst_
-
-.. |Add_-Rz| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-Rz.rst_
-
-Optional Arguments
-------------------
-
-.. |Add_-A| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-A.rst_
-
-.. include:: explain_-B.rst_
-
-**-C**\ [**l**\ \|\ **r**/]\ *fill*
- Set the shade, color, or pattern for lakes and river-lakes [Default
- is the fill chosen for "wet" areas (**-S**)]. Optionally, specify
- separate fills by prepending **l/** for lakes and **r/** for
- river-lakes, repeating the **-C** option as needed.
-
-**-D**\ *resolution*\ [**+**]
- Selects the resolution of the data set to use ((**f**)ull,
- (**h**)igh, (**i**)ntermediate, (**l**)ow, and (**c**)rude). The
- resolution drops off by 80% between data sets [Default is **l**].
- Append **+** to automatically select a lower resolution should the one
- requested not be available [abort if not found].
-
-**-F**\ *code1,code2,...*\ [**+l**\|\ **L**][**+g**\ *fill*][**+p**\ *pen*][**+r**\|\ **R**\ [*incs*]]
- Select painting or dumping country polygons from the Digital Chart of the World.
- This is another dataset independent of GSHHG and hence the **-A** and **-D** options do not apply.
- Append one or more comma-separated countries using the 2-character
- ISO 3166-1 alpha-2 convention. To select a state of a country
- (if available), append .state, e.g, US.TX for Texas. To specify a
- whole continent, prepend = to any of the continent codes AF (Africa),
- AN (Antarctica), AS (Asia), EU (Europe), OC (Oceania),
- NA (North America), or SA (South America). Append **+l** to
- just list the countries and their codes [no data extraction or plotting takes place].
- Use **+L** to see states/territories for Argentina, Australia, Brazil, Canada, and the US.
- Use **+r** to obtain the bounding box coordinates from the polygon(s).
- Append *inc*, *xinc*/*yinc*, or *winc*/*einc*/*sinc*/*ninc* to adjust the
- region to be a multiple of these steps [no adjustment]. Use **+R** to extend the region
- outward by adding these increments instead [no extension].
- Append **+p**\ *pen* to draw polygon outlines [no outline] and
- **+g**\ *fill* to fill them [no fill]. One of **+p**\|\ **g** must be
- specified unless **+r**, **+R**, or **-M** is in effect, and only one **-F** option can be given.
- To plot multiple countries in different colors, call pscoast multiple times.
- If modifiers **+r** or **+R** are used and neither **-J** nor **-M** is set then
- we just print the **-R**\ *wesn* string.
-
-**-G**\ *fill*\ \|\ **c**
- Select filling or clipping of "dry" areas. Append the shade, color,
- or pattern; or use **-Gc** for clipping [Default is no fill].
-
-**-I**\ *river*\ [/*pen*]
- Draw rivers. Specify the type of rivers and [optionally] append pen
- attributes [Default pen: width = default, color = black, style =
- solid].
-
- Choose from the list of river types below; repeat option **-I** as
- often as necessary.
-
- 0 = Double-lined rivers (river-lakes)
-
- 1 = Permanent major rivers
-
- 2 = Additional major rivers
-
- 3 = Additional rivers
-
- 4 = Minor rivers
-
- 5 = Intermittent rivers - major
-
- 6 = Intermittent rivers - additional
-
- 7 = Intermittent rivers - minor
-
- 8 = Major canals
-
- 9 = Minor canals
-
- 10 = Irrigation canals
-
- You can also choose from several preconfigured river groups:
-
- a = All rivers and canals (0-10)
-
- A = All rivers and canals except river-lakes (1-10)
-
- r = All permanent rivers (0-4)
-
- R = All permanent rivers except river-lakes (1-4)
-
- i = All intermittent rivers (5-7)
-
- c = All canals (8-10)
-
-.. include:: explain_-Jz.rst_
-
-.. include:: explain_-K.rst_
-
-.. include:: explain_-L_scale.rst_
-
-**-M**
- Dumps a single multisegment ASCII (or binary, see
- **-bo**) file to standard output. No plotting
- occurs. Specify one of **-F**, **-I**, **-N** or **-W**.
- Note: if **-M** is used with **-F** then **-R** or the **+r** modifier
- to **-F** are not required as we automatically determine the region
- given the selected geographic entities.
-
-**-N**\ *border*\ [/*pen*]
- Draw political boundaries. Specify the type of boundary and
- [optionally] append pen attributes [Default pen: width = default,
- color = black, style = solid].
-
- Choose from the list of boundaries below. Repeat option **-N** as
- often as necessary.
-
- 1 = National boundaries
-
- 2 = State boundaries within the Americas
-
- 3 = Marine boundaries
-
- a = All boundaries (1-3)
-
-.. include:: explain_-O.rst_
-
-.. include:: explain_-P.rst_
-
-**-Q**
- Mark end of existing clip path. No projection information is needed.
- Also supply **-X** and **-Y** settings if you have moved since the
- clip started.
-**-S**\ *fill*\ \|\ **c**
- Select filling or clipping of "wet" areas. Append the shade, color,
- or pattern; or use **-Sc** for clipping [Default is no fill].
-
-.. include:: explain_-T_rose.rst_
-
-.. include:: explain_-U.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-W**\ [*level*/]\ *pen* :ref:`(more ...) <set-pens>`
- Draw shorelines [Default is no shorelines]. Append pen attributes
- [Defaults: width = default, color = black, style = solid] which
- apply to all four levels. To set the pen for each level differently,
- prepend *level*/, where *level* is 1-4 and represent coastline,
- lakeshore, island-in-lake shore, and lake-in-island-in-lake shore.
- Repeat **-W** as needed. When specific level pens are set, those not
- listed will not be drawn [Default draws all levels; but see **-A**].
-
-.. include:: explain_-XY.rst_
-
-.. |Add_-bo| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-bo.rst_
-
-.. include:: explain_-c.rst_
-
-.. |Add_perspective| unicode:: 0x20 .. just an invisible code
-.. include:: explain_perspective.rst_
-
-.. include:: explain_-t.rst_
-
-.. include:: explain_help.rst_
-
-Examples
---------
-
-To plot a green Africa with white outline on blue background, with
-permanent major rivers in thick blue pen, additional major rivers in
-thin blue pen, and national borders as dashed lines on a Mercator map at
-scale 0.1 inch/degree, use
-
- ::
-
- gmt pscoast -R-30/30/-40/40 -Jm0.1i -B5 -I1/1p,blue -N1/0.25p,- \
- -I2/0.25p,blue -W0.25p,white -Ggreen -Sblue -P > africa.ps
-
-To plot Iceland using the lava pattern (# 28) at 100 dots per inch, on a
-Mercator map at scale 1 cm/degree, run
-
- ::
-
- gmt pscoast -R-30/-10/60/65 -Jm1c -B5 -Gp100/28 > iceland.ps
-
-To initiate a clip path for Africa so that the subsequent colorimage of
-gridded topography is only seen over land, using a Mercator map at scale
-0.1 inch/degree, use
-
- ::
-
- gmt pscoast -R-30/30/-40/40 -Jm0.1i -B5 -Gc -P -K > africa.ps
- gmt grdimage -Jm0.1i etopo5.nc -Ccolors.cpt -O -K >> africa.ps
- gmt pscoast -Q -O >> africa.ps
-
-**pscoast** will first look for coastline files in directory
-**$GMT_SHAREDIR**/coast If the desired file is not found, it will look
-for the file **$GMT_SHAREDIR**/coastline.conf. This file may contain
-any number of records that each holds the full pathname of an
-alternative directory. Comment lines (#) and blank lines are allowed.
-The desired file is then sought for in the alternate directories.
-
-.. include:: explain_gshhs.rst_
-
-Bugs
-----
-
-The options to fill (**-C** **-G** **-S**) may not always work if the
-Azimuthal equidistant projection is chosen (**-Je**\ \|\ **E**). If the
-antipole of the projection is in the oceans it will most likely work. If
-not, try to avoid using projection center coordinates that are even
-multiples of the coastline bin size (1, 2, 5, 10, and 20 degrees for
-**f**, **h**, **i**, **l**, **c**, respectively). This projection is not
-supported for clipping.
-
-The political borders are for the most part 1970s-style but have been
-updated to reflect more recent border rearrangements in Europe and
-elsewhere. Let us know if you find something out of date.
-
-The full-resolution coastlines are also from a digitizing effort in the
-1970-80s and it is difficult to assess the accuracy. Users who zoom in
-close enough may find that the GSHHG coastline is not matching other
-data, e.g., satellite images, more recent coastline data, etc. We are
-aware of such mismatches but cannot undertake band-aid solutions each
-time this occurs.
-
-Some users of **pscoast** will not be satisfied with what they find for
-the Antarctic shoreline. In Antarctica, the boundary between ice and
-ocean varies seasonally and inter-annually. There are some areas of
-permanent sea ice. In addition to these time-varying ice-ocean
-boundaries, there are also ice grounding lines where ice goes from
-floating on the sea to sitting on land, and lines delimiting areas of
-rock outcrop. For consistency's sake, we have used the World Vector
-Shoreline throughout the world in pscoast, as described in the GMT
-Cookbook Appendix K. Users who need specific boundaries in Antarctica
-should get the Antarctic Digital Database, prepared by the British
-Antarctic Survey, Scott Polar Research Institute, World Conservation
-Monitoring Centre, under the auspices of the Scientific Committee on
-Antarctic Research. This data base contains various kinds of limiting
-lines for Antarctica and is available on CD-ROM. It is published by the
-Scientific Committee on Antarctic Research, Scott Polar Research
-Institute, Lensfield Road, Cambridge CB2 1ER, United Kingdom.
-
-See Also
---------
-
-:doc:`gmt`, :doc:`gmt.conf`,
-:doc:`gmtcolors`,
-:doc:`grdlandmask`,
-:doc:`psbasemap`
diff --git a/doc_release/html/_sources/pscontour.txt b/doc_release/html/_sources/pscontour.txt
deleted file mode 100644
index c2ad576..0000000
--- a/doc_release/html/_sources/pscontour.txt
+++ /dev/null
@@ -1,250 +0,0 @@
-.. index:: ! pscontour
-
-*********
-pscontour
-*********
-
-.. only:: not man
-
- pscontour - Contour table data by direct triangulation [method]
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**pscontour** [ *table* ] **-C**\ [+]\ *cptfile* **-J**\ *parameters*
-|SYN_OPT-Rz|
-[ **-A**\ [**-**\ \|\ [+]\ *annot\_int*][*labelinfo*] ]
-[ |SYN_OPT-B| ]
-[ **-D**\ [*template*] ]
-[ **-G**\ [**d**\ \|\ **f**\ \|\ **n**\ \|\ **l**\ \|\ **L**\ \|\ **x**\ \|\ **X**]\ *params* ]
-[ **-I** ] [ **-Jz**\ \|\ **Z**\ *parameters* ] [ **-K** ]
-[ **-L**\ *pen* ] [ **-N** ] [ **-O** ] [ **-P** ] [ **-Q**\ *indexfile* ]
-[ **-S**\ [\ *p*\ \|\ *t*] ]
-[ **-T**\ [\ **+\|-**][\ *gap/length*][\ **:**\ [\ *labels*]] ]
-[ |SYN_OPT-U| ]
-[ |SYN_OPT-V| ] [ **-W**\ [**+**]\ *pen* ]
-[ |SYN_OPT-X| ]
-[ |SYN_OPT-Y| ]
-[ |SYN_OPT-b| ]
-[ |SYN_OPT-c| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-p| ]
-[ |SYN_OPT-t| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**pscontour** reads an ASCII [or binary] xyz-file and produces a raw
-contour plot by triangulation. By default, the optimal Delaunay
-triangulation is performed (using either Shewchuk's [1996] or Watson's
-[1982] method as selected during GMT installation; type **pscontour
--** to see which method is selected), but the user may optionally
-provide a second file with network information, such as a triangular
-mesh used for finite element modeling. In addition to contours, the area
-between contours may be painted according to the color palette file.
-Alternatively, the x/y/z positions of the contour lines may be saved to
-one or more output files (or stdout) and no plot is produced.
-
-Required Arguments
-------------------
-
-**-C**\ [+]\ *cont\_int*
- The contours to be drawn may be specified in one of three possible ways:
-
- (1) If *cont_int* has the suffix ".cpt" and can be opened as a
- file, it is assumed to be a color palette table. The color
- boundaries are then used as contour levels. If the cpt-file has
- annotation flags in the last column then those contours will be
- annotated. By default all contours are labeled; use **-A-** to
- disable all annotations.
-
- (2) If *cont_int* is a file but not a cpt-file, it is expected to
- contain contour levels in column 1 and a
- C(ontour) OR A(nnotate) in
- col 2. The levels marked C (or c) are contoured, the levels marked A
- (or a) are contoured and annotated. Optionally, a third column may
- be present and contain the fixed annotation angle for this contour
- level.
-
- (3) If no file is found, then *cont_int* is interpreted as a
- constant contour interval. However, if prepended with the + sign the
- *cont_int* is taken as meaning draw that single contour. The **-A**
- option offers the same possibility so they may be used together to
- plot only one annotated and one non-annotated contour.
- If **-A** is set and **-C** is not, then the contour interval is set
- equal to the specified annotation interval.
-
- If a file is given and **-T** is set, then only contours marked with
- upper case C or A will have tickmarks. In all cases the contour
- values have the same units as the file.
-
-.. include:: explain_-J.rst_
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-R.rst_
-
-.. |Add_-Rz| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-Rz.rst_
-
-Optional Arguments
-------------------
-
-.. |Add_intables| unicode:: 0x20 .. just an invisible code
-.. include:: explain_intables.rst_
-
-**-A**\ [**-**\ \|\ [+]\ *annot\_int*][*labelinfo*]
- *annot_int* is annotation interval in data units; it is ignored if
- contour levels are given in a file. [Default is no annotations]. Append
- **-** to disable all annotations implied by **-C**. Alternatively prepend
- + to the annotation interval to plot that as a single contour. The optional
- *labelinfo* controls the specifics of the label formatting and consists
- of a concatenated string made up of any of the following control arguments:
-
-.. include:: explain_clabelinfo.rst_
-
-.. include:: explain_-B.rst_
-
-**-D**\ [*template*\ ]
-
-.. include:: explain_contdump.rst_
-
-**-G**
-
-.. include:: explain_contlabel.rst_
-
-**-I**
- Color the triangles using the color palette table.
-
-.. include:: explain_-Jz.rst_
-
-.. include:: explain_-K.rst_
-
-**-L**\ *pen* :ref:`(more ...) <set-pens>`
- Draw the underlying triangular mesh using the specified pen
- attributes [Default is no mesh].
-**-N**
- Do NOT clip contours or image at the boundaries [Default will clip
- to fit inside region **-R**].
-
-.. include:: explain_-O.rst_
-
-.. include:: explain_-P.rst_
-
-**-Q**\ *indexfile*
- Give name of file with network information. Each record must contain
- triplets of node numbers for a triangle [Default computes these
- using Delaunay triangulation (see **triangulate**)].
-
-**-S**\ [\ *p*\ \|\ *t*]
- Skip all input *xyz* points that fall outside the region [Default
- uses all the data in the triangulation]. Alternatively, use **-St**
- to skip triangles whose three vertices are all outside the region.
- **-S** with no modifier is interpreted as **-Sp**.
-
-**-T**\ [**+\|-**][*gap/length*][\ **:**\ [*labels*]]
- Will draw tickmarks pointing in the downward direction every *gap*
- along the innermost closed contours. Append *gap* and tickmark
- length (append units as **c**, **i**, or **p**) or use defaults
- [15\ **p**/3\ **p**]. User may choose to tick only local highs or local
- lows by specifying **-T+** or **-T-**, respectively. Append
- **:**\ *labels* to annotate the centers of closed innermost contours
- (i.e, the local lows and highs). If no *labels* is appended we use -
- and + as the labels. Appending two characters, **:LH**, will plot
- the two characters (here, L and H) as labels. For more elaborate
- labels, separate the two label strings by a comma (e.g.,
- **:**\ *lo*,\ *hi*). If a file is given by **-C** and **-T** is set,
- then only contours marked with upper case C or A will have tickmarks
- [and annotation].
-
-.. include:: explain_-U.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-W**\ [**+**\ ]\ *pen* :ref:`(more ...) <set-pens>`
- Select contouring and set contour pen attributes. If the **+** flag
- is prepended then the color of the contour lines are taken from the
- cpt file (see **-C**). If the **-** flag is prepended then the color
- from the cpt file is applied both to the contours and the contour
- annotations.
-
-.. include:: explain_-XY.rst_
-
-.. |Add_-bi| replace:: [Default is 3 input columns]. Use 4-byte integer triplets for node ids (**-Q**).
-.. include:: explain_-bi.rst_
-
-.. |Add_-bo| replace:: [Default is 3 output columns].
-.. include:: explain_-bo.rst_
-
-.. include:: explain_-c.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. include:: explain_colon.rst_
-
-.. |Add_perspective| unicode:: 0x20 .. just an invisible code
-.. include:: explain_perspective.rst_
-
-.. include:: explain_-t.rst_
-
-.. include:: explain_help.rst_
-
-Examples
---------
-
-To make a raw contour plot from the file topo.xyz and drawing the
-contours (pen = 2) given in the color palette file topo.cpt on a Lambert
-map at 0.5 inch/degree along the standard parallels 18 and 24, use
-
- ::
-
- gmt pscontour topo.xyz -R320/330/20/30 -Jl18/24/0.5i -Ctopo.cpt -W0.5p > topo.ps
-
-To create a color PostScript plot of the numerical temperature
-solution obtained on a triangular mesh whose node coordinates and
-temperatures are stored in temp.xyz and mesh arrangement is given by the
-file mesh.ijk, using the colors in temp.cpt, run
-
- ::
-
- gmt pscontour temp.xyz -R0/150/0/100 -Jx0.1i -Ctemp.cpt -G -W0.25p > temp.ps
-
-To save the triangulated 100-m contour lines in topo.txt and separate
-them into multisegment files (one for each contour level), try
-
- ::
-
- gmt pscontour topo.txt -C100 -Dcontours_%.0f.txt
-
-See Also
---------
-
-:doc:`gmt`, :doc:`gmt.conf`,
-:doc:`gmtcolors`,
-:doc:`grdcontour`,
-:doc:`grdimage`,
-:doc:`nearneighbor`,
-:doc:`psbasemap`, :doc:`psscale`,
-:doc:`surface`,
-:doc:`triangulate`
-
-References
-----------
-
-Watson, D. F., 1982, Acord: Automatic contouring of raw data, *Comp. &
-Geosci.*, **8**, 97-101.
-
-Shewchuk, J. R., 1996, Triangle: Engineering a 2D Quality Mesh Generator
-and Delaunay Triangulator, First Workshop on Applied Computational
-Geometry (Philadelphia, PA), 124-133, ACM, May 1996.
-
-http://www.cs.cmu.edu/~quake/triangle.html
diff --git a/doc_release/html/_sources/pshistogram.txt b/doc_release/html/_sources/pshistogram.txt
deleted file mode 100644
index e9efcc4..0000000
--- a/doc_release/html/_sources/pshistogram.txt
+++ /dev/null
@@ -1,196 +0,0 @@
-.. index:: ! pshistogram
-
-***********
-pshistogram
-***********
-
-.. only:: not man
-
- pshistogram - Calculate and plot histograms
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**pshistogram** [ *table* ] **-Jx**\ \|\ **X**\ *parameters*
-**-W**\ *bin_width* [ **-A** ]
-[ |SYN_OPT-B| ]
-[ **-C**\ *cptfile* ] [ **-D**\ [**+b**][**+f**\ *font*][**+o**\ *off*][**+r**] ]
-[ **-F** ] [ **-G**\ *fill* ] [ **-Jz**\ \|\ **Z**\ *parameters* ]
-[ **-I**\ [**o**\ \|\ **O**] ] [ **-K** ] [ **-L**\ *pen* ]
-[ **-N**\ [*mode*][**+p**\ *pen*] ] [ **-O** ] [**-P** ] [ **-Q** ]
-[ |SYN_OPT-R| ]
-[ **-S** ]
-[ |SYN_OPT-U| ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-X| ]
-[ |SYN_OPT-Y| ]
-[ **-Z**\ *type* ]
-[ |SYN_OPT-bi| ]
-[ |SYN_OPT-c| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-p| ]
-[ |SYN_OPT-t| ]
-
-|No-spaces|
-
-Description
------------
-
-**pshistogram** reads *file* [or standard input] and examines the first
-data column (or use **-i**) to calculate histogram parameters based on
-the bin-width provided. Using these parameters, scaling, and optional
-range parameters it will generate PostScript code that plots a
-histogram. A cumulative histogram may also be specified.
-
-Required Arguments
-------------------
-
-**-Jx**
- *xscale[/yscale]* (Linear scale(s) in distance unit/data unit).
-**-W**\ *bin_width*
- Sets the bin width used for histogram calculations.
-
-Optional Arguments
-------------------
-
-.. |Add_intables| unicode:: 0x20 .. just an invisible code
-.. include:: explain_intables.rst_
-
-**-A**
- Plot the histogram horizontally from x = 0 [Default is vertically
- from y = 0].
-
-.. include:: explain_-B.rst_
-
-**-C**\ *cptfile*
- Give a color palette file. The mid x-value for each bar is used to
- look-up the bar color.
-**-D**\ [**+b**][**+f**\ *font*][**+o**\ *off*][**+r**]
- Annotate each bar with the count it represents. Append any of the
- following modifiers: Use **+b** to place the labels beneath the bars
- instead of above; use **+f** to change to another font than the default
- annotation font; use **+o** to change the offset between bar and label [6p];
- use **+r** to rotate the labels from horizontal to vertical.
-**-F**
- Center bin on each value. [Default is left edge].
-**-G**\ *fill*
- Select filling of bars [Default is no fill].
-**-I**\ [**o**\ \|\ **O**]
- Inquire about min/max x and y after binning. The *xmin xmax ymin
- ymax* is output; no plotting is done. Append **o** to output an
- ASCII table of the resulting x,y data instead. Upper case **O** will
- output all x,y bin data even when y == 0.
-
-.. include:: explain_-Jz.rst_
-
-.. include:: explain_-K.rst_
-
-**-L**\ *pen*
- Draw bar outline using the specified pen thickness. [Default is no outline].
-
-**-N**\ [*mode*][**+p**\ *pen*]
- Draw the equivalent normal distribution; append desired pen [0.5p,black].
- The *mode* selects which central location and scale to use:
-
- * 0 = mean and standard deviation [Default];
- * 1 = median and L1 scale;
- * 2 = LMS mode and scale.
-
- The **-N** option may be repeated to draw several of these curves.
-
-.. include:: explain_-O.rst_
-
-.. include:: explain_-P.rst_
-
-**-Q**
- Draw a cumulative histogram.
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-R.rst_
-
-.. |Add_-Rz| replace:: If not given, **pshistogram** will automatically find reasonable values for the region.
-.. include:: explain_-Rz.rst_
-
-**-S**
- Draws a stairs-step diagram which does not include the internal bars
- of the default histogram.
-
-.. include:: explain_-U.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. include:: explain_-XY.rst_
-
-**-Z**\ *type*
- Choose between 6 types of histograms:
-
- * 0 = counts [Default]
- * 1 = frequency_percent
- * 2 = log (1.0 + count)
- * 3 = log (1.0 + frequency_percent)
- * 4 = log10 (1.0 + count)
- * 5 = log10 (1.0 + frequency_percent).
-
-.. |Add_-bi| replace:: [Default is 2 input columns].
-.. include:: explain_-bi.rst_
-
-.. include:: explain_-c.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. |Add_perspective| unicode:: 0x20 .. just an invisible code
-.. include:: explain_perspective.rst_
-
-.. include:: explain_-t.rst_
-
-.. include:: explain_help.rst_
-
-Examples
---------
-
-To draw a histogram of the data v3206.t containing seafloor depths,
-using a 250 meter bin width, center bars, and draw bar outline, use:
-
- ::
-
- gmt pshistogram v3206.t -JXh -W250 -F -LP0.5p -V > plot.ps
-
-If you know the distribution of your data, you may explicitly specify
-range and scales. E.g., to plot a histogram of the y-values (2nd column)
-in the file errors.xy using a 1 meter bin width, plot from -10 to +10
-meters @ 0.75 cm/m, annotate every 2 m and 100 counts, and use black
-bars, run:
-
- ::
-
- gmt pshistogram errors.xy -W1 -R-10/10/0/0 -Jxc/0.01c \
- -B2:Error:/100:Counts: -Gblack -i1 -V > plot.ps
-
-Since no y-range was specified, pshistogram will calculate ymax in even
-increments of 100.
-
-Bugs
-----
-
-The **-W** option does not yet work properly with time series data
-(e.g., **-f**\ 0T). Thus, such variable intervals as months and years
-are not calculated. Instead, specify your interval in the same units as
-the current setting of **TIME_UNIT**.
-
-See Also
---------
-
-:doc:`gmt`, :doc:`gmtcolors`,
-:doc:`psbasemap`, :doc:`psrose`,
-:doc:`psxy`
diff --git a/doc_release/html/_sources/psimage.txt b/doc_release/html/_sources/psimage.txt
deleted file mode 100644
index a06690e..0000000
--- a/doc_release/html/_sources/psimage.txt
+++ /dev/null
@@ -1,185 +0,0 @@
-.. index:: ! psimage
-
-*******
-psimage
-*******
-
-.. only:: not man
-
- psimage - Place images or EPS files on maps
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**psimage** *imagefile* [ **-W**\ [**-**\ ]\ *width*\ [/*height*] \|
-**-E**\ *dpi* ] [ **-C**\ *xpos*/*ypos*\ [/*justify*] ] [ **-F**\ *pen*
-] [ **-G**\ [**b**\ \|\ **f**\ \|\ **t**]\ *color* ] [ **-I** ] [
-**-J**\ *parameters* ] [ **-Jz**\ \|\ **Z**\ *parameters* ] [ **-K** ] [
-**-M** ] [ **-N**\ *nx*\ [/*ny*] ] [ **-O** ] [ **-P** ] [
-**-R**\ *west*/*east*/*south*/*north*\ [/*zmin*/*zmax*][**r**\ ] ] [
-**-U**\ [*just*/*dx*/*dy*/][**c**\ \|\ *label*] ] [ **-V**\ [*level*\ ]
-] [
-**-X**\ [**a**\ \|\ **c**\ \|\ **f**\ \|\ **r**][\ *x-shift*\ [**u**\ ]]
-] [
-**-Y**\ [**a**\ \|\ **c**\ \|\ **f**\ \|\ **r**][\ *y-shift*\ [**u**\ ]]
-] [ **-c**\ *copies* ] [
-**-p**\ [**x**\ \|\ **y**\ \|\ **z**]\ *azim*/*elev*\ [/*zlevel*][\ **+w**\ *lon0*/*lat0*\ [/*z0*]][\ **+v**\ *x0*/*y0*]
-] [ **-t**\ [*transp*\ ] ]
-
-|No-spaces|
-
-Description
------------
-
-**psimage** reads an Encapsulated PostScript file or a raster image
-file and plots it on a map. The image can be scaled arbitrarily, and
-1-bit raster images can be (1) inverted, i.e., black
-pixels (on) becomes white (off) and vice versa, or
-(2) colorized, by assigning different foreground and
-background colors, and (3) made transparent where one of
-back- or foreground is painted only. As an option, the user may choose
-to convert colored raster images to grayscale using TV's
-YIQ-transformation. For raster files, the user can select which color to
-be made transparent. The user may also choose to replicate the image
-which, when preceded by appropriate clip paths, may allow larger
-custom-designed fill patterns to be implemented (the **-Gp** mechanism
-offered in most GMT programs is limited to rasters smaller than 146
-by 146).
-
-Required Arguments
-------------------
-
-*imagefile*
- This must be an Encapsulated PostScript (EPS) file or a raster
- image. An EPS file must contain an appropriate BoundingBox. A raster
- file can have a depth of 1, 8, 24, or 32 bits and is read via GDAL.
- If GDAL was not configured during GMT installation then only
- Sun raster files are supported natively.
-**-E**\ *dpi*
- Sets the dpi of the image in dots per inch, or use **-W**.
-**-W**\ [**-**]\ *width*\ [/*height*]
- Sets the width (and height) of the image in plot coordinates
- (inches, cm, etc.). If *height* is not given, the original aspect
- ratio of the image is maintained. If *width* is negative we use the
- absolute value and interpolate image to the device resolution using
- the PostScript image operator. Alternatively, use **-E**.
-
-Optional Arguments
-------------------
-
-**-C**\ *xpos*/*ypos*\ [/*justify*]
- Sets position of the image in plot coordinates (inches, cm, etc.)
- from the current origin of the plot. By default, this defines the
- position of the lower left corner of the image, but this can be
- changed by specifying justification [0/0/BL].
-**-F**\ *pen*
- Draws a rectangular frame around the image with the given pen [no
- frame].
-
-.. |Add_-J| replace:: (Used only with **-p**)
-.. include:: explain_-J.rst_
-
-.. include:: explain_-Jz.rst_
-
-.. include:: explain_-K.rst_
-
-**-M**
- Convert color image to monochrome grayshades using the (television)
- YIQ-transformation.
-**-N**\ *nx*\ [/*ny*]
- Replicate the image *nx* times horizontally and *ny* times
- vertically. If *ny* is omitted, it will be identical to *nx*
- [Default is 1/1].
-
-.. include:: explain_-O.rst_
-
-.. include:: explain_-P.rst_
-
-.. |Add_-R| replace:: (Used only with **-p**)
-.. include:: explain_-R.rst_
-
-.. |Add_-Rz| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-Rz.rst_
-
-.. include:: explain_-U.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. include:: explain_-XY.rst_
-
-.. include:: explain_-c.rst_
-
-These options are for 1-bit images only. They have no effect when
-plotting other images or PostScript files.
-
-**-G**\ [**b**\ \|\ **f**\ \|\ **t**]\ *color*
- **-Gb**
- Sets background color (replace white pixel) of 1-bit images. Use -
- for transparency (and set **-Gf** to the desired color).
- **-Gf**
- Sets foreground color (replace black pixel) of 1-bit images. Use -
- for transparency (and set **-Gb** to the desired color).
- **-I**
- Invert 1-bit image before plotting. This is what is done when you
- use **-GP** in other GMT programs.
-
-These options are for 8-, 24-, and 32-bit raster images only. They have
-no effect when plotting 1-bit images or PostScript files.
-
-**-Gt**
- Assigns the color that is to be made transparent. Sun Raster files
- do not support transparency, so indicate here which color to be made
- transparent.
-
-.. |Add_perspective| replace:: (Requires **-R** and **-J** for proper functioning).
-.. include:: explain_perspective.rst_
-
-.. include:: explain_-t.rst_
-
-.. include:: explain_help.rst_
-
-Examples
---------
-
-To plot the image contained in the 8-bit raster file scanned_face.ras,
-scaling it to 8 by 10 cm (thereby possibly changing the aspect ratio),
-and making the white color transparent, use
-
- ::
-
- gmt psimage scanned_face.ras -W8c/10c -Gtwhite > image.ps
-
-To plot the image logo.jpg, scaling it be 1 inch wide (height is scaled
-accordingly), and outline with a thin, blue pen, use
-
- ::
-
- gmt psimage logo.jpg -W1i -Fthin,blue > image.ps
-
-To include an Encapsulated PostScript file tiger.eps with its upper
-right corner 2 inch to the right and 1 inch up from the current
-location, and have its width scaled to 3 inches, while keeping the
-aspect ratio, use
-
- ::
-
- gmt psimage tiger.eps -C2i/1i/TR -W3i > image.ps
-
-To replicate the 1-bit raster image template 1_bit.ras, colorize it
-(brown background and red foreground), and setting each of 5 by 5 tiles
-to be 1 cm wide, use
-
- ::
-
- gmt psimage 1_bit.ras -Gbbrown -Gfred -N5 -W1c > image.ps
-
-See Also
---------
-
-:doc:`gmt`,
-:doc:`gmtcolors`,
-:doc:`psxy`,
-:manpage:`convert(1)`
diff --git a/doc_release/html/_sources/pslegend.txt b/doc_release/html/_sources/pslegend.txt
deleted file mode 100644
index cabbf61..0000000
--- a/doc_release/html/_sources/pslegend.txt
+++ /dev/null
@@ -1,304 +0,0 @@
-.. index:: ! pslegend
-
-********
-pslegend
-********
-
-.. only:: not man
-
- pslegend - Plot legends on maps
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**pslegend** [ *textfile* ]
-**-D**\ [**x**\ ]\ *lon*/*lat*/*width*\ [/*height*]/\ *just*\ [/*dx*/*dy*]
-[ **-B**\ [**p**\ \|\ **s**]\ *parameters* ] [ **-C**\ *dx*/*dy* ] [
-**-F**\ [\ **+g**\ *fill*][**+i**\ [[*gap*/]*pen*]][\ **+p**\ [*pen*]][\ **+r**\ [*radius*\ ]][\ **+s**\ [[*dx*/*dy*/][*shade*\ ]]] ] [
-**-J**\ *parameters* ] [ **-K** ] [ **-L**\ *spacing* ] [ **-O** ] [
-**-P** ] [ **-R**\ *west*/*east*/*south*/*north*\ [**r**\ ] ] [
-**-U**\ [*just*/*dx*/*dy*/][**c**\ \|\ *label*] ] [ **-V**\ [*level*\ ]
-] [
-**-X**\ [**a**\ \|\ **c**\ \|\ **f**\ \|\ **r**][\ *x-shift*\ [**u**\ ]]
-] [
-**-Y**\ [**a**\ \|\ **c**\ \|\ **f**\ \|\ **r**][\ *y-shift*\ [**u**\ ]]
-] [ **-c**\ *copies* ] [
-**-p**\ [**x**\ \|\ **y**\ \|\ **z**]\ *azim*/*elev*\ [/*zlevel*][\ **+w**\ *lon0*/*lat0*\ [/*z0*]][\ **+v**\ *x0*/*y0*]
-] [ **-t**\ [*transp*\ ] ]
-
-|No-spaces|
-
-Description
------------
-
-**pslegend** will make legends that can be overlaid on maps. It reads
-specific legend-related information from an input file [or stdin].
-Unless otherwise noted, annotations will be made using the primary
-annotation font and size in effect (i.e., FONT\_ANNOT\_PRIMARY)
-
-`Required Arguments <#toc4>`_
------------------------------
-
-**-D**\ [**x**\ ]\ *lon*/*lat*/*width*\ [/*height*]/\ *just*\ [/*dx*/*dy*]
- Positions the legend and specifies its size. The *just* is a 2-char
- justification string (see :doc:`pstext`) that relates the given
- position to a point on the rectangular legend box. If you want to
- specify the position in map plot units (i.e., inches or cm), use
- **-Dx**; in that case the **-R** and **-J** are optional (provided
- it is an overlay, i.e., we are using **-O**). Use to optional
- *dx*/*dy* to shift the legend by that amount in the direction
- implied by the justification. If *height* is zero or not given then
- we estimate *height* based the expected vertical extent of the items
- to be placed.
-
-`Optional Arguments <#toc5>`_
------------------------------
-
-.. include:: explain_-B.rst_
-
-**-C**\ *dx*/*dy*
- Sets the clearance between the legend frame and the internal items
- [4\ **p**/4\ **p**].
-**-F**\ [\ **+g**\ *fill*][**+i**\ [[*gap*/]*pen*]][\ **+p**\ [*pen*]][\ **+r**\ [*radius*\ ]][\ **+s**\ [[*dx*/*dy*/][*shade*\ ]]]
- Without further options, draws a rectangular border around the legend using
- **MAP\_FRAME\_PEN**; specify a different pen with **+p**\ *pen*.
- Add **+g**\ *fill* to fill the legend box [no fill]
- Append **+i** to draw a secondary, inner border as well. We use a
- *gap* between borders of 2\ **p** and the **MAP\_DEFAULTS\_PEN**
- unless other values are specified. Append **+r** to draw rounded
- rectangular borders instead, with a 6\ **p** corner radius. You can
- override this radius by appending another value. Finally, append
- **+s** to draw an offset background shaded region. Here, *dx*/*dy*
- indicates the shift relative to the foreground frame
- [4\ **p**/-4\ **p**] and *shade* sets the fill style to use for shading.
-
-.. include:: explain_-J.rst_
-
-.. include:: explain_-K.rst_
-
-**-L**\ *spacing*
- Sets the linespacing factor in units of the current annotation font size [1.1].
-
-.. include:: explain_-O.rst_
-
-.. include:: explain_-P.rst_
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-R.rst_
-
-.. include:: explain_-U.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. include:: explain_-XY.rst_
-
-.. include:: explain_-c.rst_
-
-.. |Add_perspective| unicode:: 0x20 .. just an invisible code
-.. include:: explain_perspective.rst_
-
-.. include:: explain_-t.rst_
-
-.. include:: explain_help.rst_
-
-`Pslegend Codes <#toc6>`_
--------------------------
-
-*textfile*
- This file contains instruction for the layout of items in the
- legend. Each legend item is described by a unique record. All
- records begin with a unique character that is common to all records
- of the same kind. The order of the legend items is implied by the
- order of the records. Ten different record types are recognized, and
- the syntax for each of these records are presented below:
-**#** *comment*
- Records starting with # and blank lines are skipped.
-**B** *cptname offset height* [ *optional arguments* ]
- The **B** record will plot a horizontal color bar, **psscale**-style
- in the middle, starting at *offset* from the left edge, and of the
- given *height*. You may add any additional **psscale** options from
- the list: **-A** **-B** **-I** **-L** **-M** **-N** **-S** **-Z**
- and **-p**. See the **psscale** man page for details.
-**C** *textcolor*
- The **C** record specifies the color with which the remaining text
- is to be printed. *textcolor* can be in the form *r/g/b*, *c/m/y/k*,
- or a named color. Use **-** to reset to default color.
-**D** *offset pen*
- The **D** record results in a horizontal line with specified *pen*
- across the legend with one quarter of the line spacing left blank
- above and below the line. Two gaps of *offset* units are left blank
- between the horizontal line and the left and right frame sides. If
- no pen is given we use MAP\_GRID\_PEN\_PRIMARY
-**G** *gap*
- The **G** record specifies a vertical gap of the given length. In
- addition to the standard units (**i**, **c**, **p**) you may use
- **l** for lines. A negative *gap* will move the current line upwards (thus closing a gap).
-**H** *fontsize*\ \|\ **-** *font*\ \|\ **-** header)
- The **H** record plots a centered text string using the specified
- font parameters. Use **-** to default to size and type of **FONT\_TITLE**.
-**I** *imagefile width justification*
- Place an EPS or Sun raster image in the legend justified relative to
- the current point. The image *width* determines the size of the image on the page.
-**L** *fontsize*\ \|\ **-** *font*\ \|\ **-** justification label)
- The **L** record plots a (L)eft, (C)entered, or (R)ight-justified
- text string within a column using the specified font parameters. Use
- **-** to default to the size and type of **FONT\_LABEL**.
-**M** *slon*\ \|\ **-** *slat length* **f**\ \|\ **p** [ **-R**\ *w/e/s/n* **-J**\ *param* ]
- Place a map scale in the legend. Specify *slon slat*, the point on
- the map where the scale applies (*slon* is only meaningful for
- certain oblique projections. If not needed, you must specify **-**
- instead), *length*, the length of the scale in km (for other units
- append **e** (meter), **f** (foot), **M** (mile), **n** (nautical
- mile), or **u** (survey foot)), and **f** or **p** for fancy or
- plain scale. If the **-R** **-J** supplied to **pslegend** is
- different than the projection needed for the scale (or not given at
- all, i.e., with **-Dx**), supply the optional **-R** **-J** settings
- as well. Append **+l** to the *length* to select the default label
- which equals the distance unit (meter, feet, km, miles, nautical
- miles, survey feet) and is justified on top of the scale [t]. Change
- this by giving your own label (append **+l**\ *label*). Change label
- justification with **+j**\ *justification* (choose among l(eft),
- r(ight), t(op) , and b(ottom)).
- Apply **+u** to append the unit to all distance annotations along
- the scale. If you want to place a rectangle behind the scale,
- specify suitable **+p**\ *pen* and/or **+f**\ *fill* parameters. All
- these )+)\ *modifiers* are appended to *length* to make a single
- string.
-**N** *ncolumns*
- Change the number of columns in the legend [1]. This only affects
- the printing of symbols (**S**) and labels (**L**). The number of
- columns stay in effect until **N** is used again.
-**S** *dx1 symbol size fill pen* [ *dx2 text* ]
- Plots the selected symbol with specified diameter, fill, and outline
- (see :doc:`psxy`). The symbol is centered at *dx1* from the left margin
- of the column, with the optional explanatory *text* starting *dx2*
- from the margin, printed with **FONT\_ANNOT\_PRIMARY**. Use **-** if
- no *fill* or outline (*pen*) is required. When plotting just a
- symbol, without text, *dx2* and *text* can be omitted. Three **psxy**
- symbols may take special modifiers: front (**f**), quoted line (**q**) and vector (**v**).
- You can append modifiers to the symbol and affect how the fronts, quoted lines and
- vectors are presented (see :doc:`psxy` man page for modifiers).
- **pslegend** will determine default settings for all modifiers and
- secondary arguments if not provided. A few other symbols (the rectangles,
- ellipse, wedge, mathangle) may take more than a single argument size.
- Note that for a line segment you should use the horizontal dash symbol (**-**).
- If just a single size if given then **pslegend** will provide reasonable
- arguments to plot the symbol (See `Defaults`_).
- Alternatively, combine the required
- arguments into a single, comma-separated string and use that as the
- symbol size (again, see :doc:`psxy` for details on the arguments needed).
-**T** *paragraph-text*
- One or more of these **T** records with *paragraph-text* printed
- with **FONT\_ANNOT\_PRIMARY**. To specify special positioning and
- typesetting arrangements, or to enter a paragraph break, use the
- optional **P** record.
-**V** *offset pen*
- The **V** record draws a vertical line between columns (if more than
- one) using the selected *pen* *offset* is analogous to the offset
- for the **D** records but in the vertical direction.
-**P** *paragraph-mode-header-for-pstext*
- Start a new text paragraph by specifying all the parameters needed
- (see **pstext -M** record description). Note that **pslegend** knows
- what all those values should be, so normally you can leave the
- entire record (after P) blank or leave it out all together. If you
- need to set at least one of the parameters directly, you must
- specify all and set the ones you want to leave at their default
- value to **-**.
-
-
-Defaults
---------
-
-When attributes are not provided, or extended symbol information (for symbols taking more than just an overall size) are
-not given as comma-separated quantities, **pslegend** will provide the following defaults:
-
-Front: Front symbol is left-side (here, that means upper side) box, with dimensions 30% of the given symbol size.
-
-Vector: Head size is 30% of given symbol size.
-
-Ellipse: Minor axis is 65% of major axis (the symbol size), with an azimuth of 0 degrees.
-
-Rectangle: Height is 65% of width (the symbol size).
-
-Rotated rectangle: Same, with a rotation of 30 degrees.
-
-Rounded rectangle: Same as rectangle, but with corner radius of 10% of width.
-
-Mathangle: Angles are -10 and 45 degrees, with arrow head size 30% of symbol size.
-
-Wedge: Angles are -30 and 30 degrees.
-
-Examples
---------
-
-To add an example of a legend to a Mercator plot (map.ps) with the given
-specifications, use
-
- ::
-
- gmt pslegend -R-10/10/-10/10 -JM6i -F+gazure1 -Dx0.5i/0.5i/5i/3.3i/BL \
- -C0.1i/0.1i -L1.2 -B5f1 << EOF >> map.ps
- # Legend test for pslegend
- # G is vertical gap, V is vertical line, N sets # of columns, D draws horizontal line.
- # H is header, L is label, S is symbol, T is paragraph text, M is map scale.
- #
- G -0.1i
- H 24 Times-Roman My Map Legend
- D 0.2i 1p
- N 2
- V 0 1p
- S 0.1i c 0.15i p300/12 0.25p 0.3i This circle is hachured
- S 0.1i e 0.15i yellow 0.25p 0.3i This ellipse is yellow
- S 0.1i w 0.15i green 0.25p 0.3i This wedge is green
- S 0.1i f0.1i+l+t 0.25i blue 0.25p 0.3i This is a fault
- S 0.1i - 0.15i - 0.25p,- 0.3i A dashed contour
- S 0.1i v0.1i+a40+e 0.25i magenta 0.25p 0.3i This is a vector
- S 0.1i i 0.15i cyan 0.25p 0.3i This triangle is boring
- V 0 1p
- D 0.2i 1p
- N 1
- M 5 5 600+u f
- G 0.05i
- I SOEST_logo.ras 3i CT
- G 0.05i
- B colors.cpt 0.2i 0.2i
- G 0.05i L 9 4 R Smith et al., @%5%J. Geophys. Res., 99@%%, 2000
- G 0.1i
- P
- T Let us just try some simple text that can go on a few lines.
- T There is no easy way to predetermine how many lines will be required,
- T so we may have to adjust the box height to get the right size box.
- EOF
-
-Note On Legend Height
----------------------
-
-As **-D** suggests, leaving the *height* off forces a calculation of the
-expected height. This is an exact calculation except in the case of
-legends that place paragraph text. Here we simply do a first-order
-estimate of how many typeset lines might appear. Without access to font
-metrics this estimate will occasionally be off by 1 line. If so, note
-the reported height (with **-V**) and specify a slightly larger or
-smaller height in **-D**.
-
-Windows Remarks
----------------
-
-Note that under Windows, the percent sign (%) is a variable indicator
-(like $ under Unix). To indicate a plain percentage sign in a batch
-script you need to repeat it (%%); hence the font switching mechanism
-(@%*font*\ % and @%%) may require twice the number of percent signs.
-This only applies to text inside a script or that otherwise is processed
-by DOS. Data files that are opened and read by **pslegend** do not need
-such duplication.
-
-See Also
---------
-
-:doc:`gmt`, :doc:`gmt.conf`,
-:doc:`gmtcolors`,
-:doc:`psbasemap`, :doc:`pstext`,
-:doc:`psxy`
diff --git a/doc_release/html/_sources/pslib.txt b/doc_release/html/_sources/pslib.txt
deleted file mode 100644
index 1fbf5bd..0000000
--- a/doc_release/html/_sources/pslib.txt
+++ /dev/null
@@ -1,882 +0,0 @@
-.. index:: ! pslib
-
-*****
-pslib
-*****
-
-.. only:: not man
-
- PSL 5.1 - A PostScript based plotting library
-
-Description
------------
-
-PSL was created to make the generation of PostScript page
-description code easier. PS is a page description language developed by
-the Adobe for specifying how a printer should render a page of text or
-graphics. It uses a reverse Polish notation that puts and gets items
-from a stack to draws lines, text, and images and even performs
-calculations. PSL is a self-contained library that presents a series
-of functions that can be used to create plots. The resulting
-PostScript code is ASCII text (with some exceptions for images if so
-desired) and can thus be edited using any text editor. Thus, it is
-possible to modify a plot file even after it has been created, e.g., to
-change text strings, set new gray shades or colors, experiment with
-various pen widths, etc. Furthermore, various tools exist that can parse
-PostScript and let you make such edits via a graphical user interface
-(e.g., Adobe Illustrator). PSL is written in C but includes FORTRAN
-bindings and can therefore be called from both C and FORTRAN programs.
-To use this library, you must link your plotting program with PSL.
-PSL is used by the GMT graphics programs to generate PS. PSL
-output is freeform PostScript that conforms to the Adobe PostScript
-File Specification Version 3.0.
-
-Before any PSL calls can be issued, the plotting system must be
-initialized. This is done by calling **PSL_beginsession**, which
-initializes a new PSL session; then call **PSL_setdefaults** which
-sets internal variables and default settings, accepts settings for
-measurement units and character encoding, and returns a pointer to a
-struct PSL_CTRL which must be passed as first argument to all other
-PSL functions. The measure unit for sizes and positions can be set
-to be centimeter (c), inch (i), meter (m), or points
-(p). A PSL session is terminated by calling
-**PSL_endsession**. You may create one or more plots within the same
-session. A new plot is started by calling **PSL_beginplot**, which
-defines macros, sets up the plot-coordinate system, scales, and
-[optionally] opens a file where all the PS code will be written.
-Normally, the plot code is written to *stdout*. When all plotting to
-this file is done, you finalize the plot by calling **PSL_endplot**.
-
-A wide variety of output devices that support PostScript exist,
-including many printers and large-format plotters. Many tools exists to
-display PostScript on a computer screen. Open source tools such as
-ghostscript can be used to convert PostScript into PDF or raster
-images (e.g., TIFF, JPEG) at a user-defined resolution (DPI). In
-particular, the GMT tool ps2raster is a front-end to ghostscript and
-pre-selects the optimal options for ghostscript that will render quality
-PDF and images.
-
-The PSL is fully 64-bit compliant. Integer parameters are here
-specified by the type **long** to distinguish them from the 32-bit
-**int**. Note that under standard 32-bit compilation they are
-equivalent. Users of this library under 64-bit mode must make sure they
-pass proper **long** variables (under Unix flavors) or **\_\_int64**
-under Windows 64.
-
-Units
------
-
-PSL can be instructed to use centimeters, inches, meters or points
-as input units for the coordinates and sizes of elements to be plotted.
-Any dimension that takes this setting as a unit is specified as *user
-units* or *plot units* in this manual. Excluded from this are line
-widths and font sizes which are always measured in *points*. The user
-units can be further refined by calling **PSL_beginaxes**, giving the
-user the opportunity to specify any linear coordinate frame. Changing
-the coordinate frame only affects the coordinates of plotted material
-indicated as measured in *plot units*, not the sizes of symbols (which
-remain in *user units*), nor line widths or font sizes (which remain in
-*points*).
-
-Color
------
-
-PSL uses the direct color model where red, green, and blue are given
-separately, each must be in the range from 0-1. If red = -1 then no fill
-operation takes place. If red = -3, then pattern fill will be used, and
-the green value will indicate the pattern to be used. Most plot-items
-can be plotted with or without outlines. If outline is desired (i.e.,
-set to 1), it will be drawn using the current line width and pattern.
-PSL uses highly optimized macro substitutions and scales the
-coordinates depending on the resolution of the hardcopy device so that
-the output file is kept as compact as possible.
-
-Justification
--------------
-
-Text strings, text boxes and images can be "justified" by specifying the
-corner to which the *x* and *y* coordinates of the subroutine call
-apply. Nine different values are possible, as shown schematically in
-this diagram:
-
- 9------------10----------- 11
-
- \| \|
-
- 5 6 7
-
- \| \|
-
- 1------------ 2------------ 3
-
-The box represents the text or image. E.g., to plot a text string with
-its center at (*x*, *y*), you must use *justify* == 6. *justify* == 0
-means "no justification", which generally means (*x*, *y*) is at the
-bottom left. Convenience values PSL_NONE, PSL_BL, PSL_BC, PSL_BL,
-PSL_ML, PSL_MC, PSL_MR, PSL_TL, PSL_TC and PSL_TR are available.
-
-Initialization
---------------
-
-These functions initialize or terminate the PSL system. We use the
-term PSL session to indicate one instance of the PSL system (a
-complicated program could run many PSL sessions concurrently as each
-would operate via its own control structure). During a single session,
-one or more plots may be created. Here are the functions involved in
-initialization:
-
-**struct PS_CTRL \*New_PSL_Ctrl** (**char** *\*session*)
-
- This is the first function that must be called as it creates a new
- PSL session. Specifically, it will allocate a new PSL
- control structure and initialize the session default parameters. The
- pointer that is returned must be passed to all subsequent PSL
- functions.
-
-**long \*PSL_beginsession** (**struct PS_CTRL** *\*PSL*, **long**
-*search*, **char** *\*sharedir*, **char** *\*userdir*)
-
- This is the second function that must be called as it initializes
- the new PSL session. Here, *search* is an integer that is passed
- as 0 in GMT but should be 1 for other users. If so we will search
- for the environmental parameters PSL_SHAREDIR and PSL_USERDIR
- should the corresponding arguments *sharedir* and *userdir* be NULL.
-
-**long PSL_endsession** (**struct PS_CTRL** *\*PSL*)
-
- This function terminates the active PSL session; it is the last
- function you must call in your program. Specifically, this function
- will deallocate memory used and free up resources.
-
-**struct PS_CTRL \*PSL_beginlayer** (**struct PS_CTRL** *\*PSL*,
-**long** *layer*)
-
- Adds a DSC comment by naming this layer; give a unique integer
- value. Terminate layer with PSL_endlayer
-
-**struct PS_CTRL \*PSL_endlayer** (**struct PS_CTRL** *\*PSL*)
-
- Terminate current layer with a DSC comment.
-
-**long PSL_fopen** (**char** *\*file*, **char** *\*mode*)
-
- This function simply opens a file, just like fopen. The reason it is
- replicated here is that under Windows, file pointers must be
- assigned within the same DLL as they are being used. Yes, this is
- retarded but if we do not do so then PSL will not work well under
- Windows. Under non-Windows this functions is just a macro that
- becomes fopen.
-
-**void PSL_free** (**void** *\*ptr*)
-
- This function frees up the memory allocated inside PSL.
- Programmers using C/C++ should now this is a macro and there is no
- need to cast the pointer to *void \** as this will be done by the
- macro. Fortran programmers should instead call
- **PSL_freefunction**.
-
-**void PSL_beginaxes** (**struct PS_CTRL** *\*PSL*, **double** *llx*,
-**double** *lly*, **double** *width*, **double** *height*, **double**
-*x0*, **double** *y0*, **double** *x1*, **double** *y1*)
-
- This function sets up the mapping that takes the users data
- coordinates and converts them to the positions on the plot in
- PostScript units. This should be used when plotting data
- coordinates and is terminated with **PSL_endaxes**, which returns
- PSL to the default measurement units and scaling. Here, *llx*
- and *lly* sets the lower left position of the mapping region, while
- *width* and *height* sets the dimension of the plot area in user
- units. Finally, *x0*, *x1* and *y0*, *y1* indicate the range of the
- users x- and y-coordinates, respectively. Specify a reverse axis
- direction (e.g., to let the y-axis be positive down) by setting *y0*
- larger than *y1*, and similarly for an x-axis that increases to the
- left.
-
-**void PSL_endaxes** (**struct PS_CTRL** *\*PSL*)
-
- Terminates the map scalings initialized by **PSL_beginaxes** and
- returns PSL to standard scaling in measurement units.
-
-**long PSL_beginplot** (**struct PSL_CTRL** *\*P*, **FILE** *\*fp*,
-**long** *orientation*, **long** *overlay*, **long** *color_mode*,
-**char** *origin*\ [], **double** *offset*\ [], **double**
-*page_size*\ [], **char** *\*title*, **long** *font_no*\ [])
-
- Controls the initiation (or continuation) of a particular plot
- within the current session. Pass file pointer *fp* where the
- PostScript code will be written; if NULL then the output is
- written to *stdout*. The Fortran interface always sends to *stdout*.
- The *orientation* may be landscape (PSL_LANDSCAPE or 0) or portrait
- (PSL_PORTRAIT or 1). Set *overlay* to PSL_OVERLAY (0) if the
- following PostScript code should be appended to an existing plot;
- otherwise pass PSL_INIT (1) to start a new plot.
- Let *colormode* be one of PSL_RGB (0), PSL_CMYK
- (1), PSL_HSV (2) or PSL_GRAY (3); this setting controls how colors
- are presented in the PostScript code. The *origin* setting
- determines for x and y separately the origin of the specified
- offsets (next argument). Each of the two characters are either **r**
- for an offset relative to the current origin, **a** for a temporaty
- adjustment of the origin which is undone during BD(PSL_endplot),
- **f** for a placement of the origin relative to the lower left corner
- of the page, **c** for a placement of the origin relative to the
- center of the page. The array *offset* specifies the offset of the
- new origin relative to the position indicated by **origin**.
- *page_size* means the physical width and height of the plotting
- media in points (typically 612 by 792 for Letter or 595 by 842 for
- A4 format). The character string *title* can be used to specify the
- **%%Title:** header in the PostScript file (or use NULL for the
- default). The array *font_no* specifies all fonts used in the plot
- (by number), or use NULL to leave out the
- **%%DocumentNeededResources:** comment in the PostScript file.
-
-**long PSL_endplot** (**struct PSL_CTRL** *\*P*, **long** *last_page*)
-
- Terminates the plotting sequence and closes plot file (if other than
- *stdout*). If *last_page* == PSL_FINALIZE
- (1), then a PostScript *showpage* command
- is issued, which initiates the printing process on hardcopy devices.
- Otherwise, pass PSL_OVERLAY (0).
-
-**long PSL_setorigin** (**struct PSL_CTRL** *\*P*, **double**
-*xorigin*, **double** *yorigin*, **double** *angle*, **long** *mode*)
-
- Changes the coordinate system by translating by
- (*xorigin*,\ *yorigin*) followed by a *angle*-degree rotation
- (*mode*\ =PSL_FWD or 0) or alternatively the rotation followed by
- translation (*mode*\ =PSL_INV or 1).
-
-`Changing Settings <#toc6>`_
-----------------------------
-
-The following functions are used to change various PSL settings and
-affect the current state of parameters such as line and fill attributes.
-
-**long PSL_define_pen** (**struct PSL_CTRL** *\*P*, **char**
-*\*name*, **long** *width*, **char** *\*style*, **double** *offset*,
-**double** *rgb*\ [])
-
- Stores the specified pen characteristics in a PostScript variable
- called *name*. This can be used to place certain pen attributes in
- the PostScript file and then retrieve them later with
- **PSL_load_pen**. This makes the stored pen the current pen.
-
-**long PSL_define_rgb** (**struct PSL_CTRL** *\*P*, **char**
-*\*name*, **double** *rgb*\ [])
-
- Stores the specified color in a PostScript variable called *name*.
- This can be used to place certain color values in the PostScript
- file and then retrieve them later with **PSL_load_rgb**. This
- makes the stored color the current color.
-
-**long PSL_setcolor** (**struct PSL_CTRL** *\*P*, **double**
-*rgb*\ [], **long** *mode*)
-
- Sets the current color for all stroked (mode = PSL_IS_STROKE (0))
- or filled (mode = PSL_IS_FILL (1)) material
- to follow (lines, symbol outlines, text). *rgb* is a triplet of red,
- green and blue values in the range 0.0 through 1.0. Set the red
- color to -3.0 and the green color to the pattern number returned by
- **PSL_setpattern** to select a pattern as current paint color. For
- PDF transparency, set *rgb*\ [3] to a value between 0 (opaque) and 1
- (fully transparent).
-
-**long PSL_setpattern** (**struct PSL_CTRL** *\*P*, **long**
-*image_no*, **char** *\*imagefile*, **long** *dpi*, **double**
-*f_rgb*\ [], **double** *b_rgb*\ [])
-
- Sets up the specified image pattern as the fill to use for polygons
- and symbols. Here, *image_no* is the number of the standard PSL
- fill patterns (1-90; use a negative number when you specify an image
- *filename* instead. The scaling (i.e., resolution in dots per inch)
- of the pattern is controlled by the image *dpi*; if set to 0 it will
- be plotted at the device resolution. The two remaining settings
- apply to 1-bit images only and are otherwise ignored: You may
- replace the foreground color (the set bits) with the *f_rgb* color
- and the background color (the unset bits) with *b_rgb*.
- Alternatively, pass either color with the red component set to -1.0
- and we will instead issue an image mask that is see-through for the
- specified fore- or background component. To subsequently use the
- pattern as a pen or fill color, use **PSL_setcolor** or
- DB(PSL_setfill) with the a color *rgb* code made up of *r* = -3,
- and *b* = the pattern number returned by **PSL_setpattern**.
-
-**long PSL_setdash** (**struct PSL_CTRL** *\*P*, **char** *\*pattern*,
-**double** *offset*)
-
- Changes the current pen style attributes. The character string
- *pattern* contains the desired pattern using a series of lengths in
- points specifying the alternating lengths of dashes and gaps in
- points. E.g., "4 2" and *offset* = 1 will plot like
-
- x ---- ---- ----
-
- where x is starting point of a line (The x is not plotted). That is,
- the line is made up of a repeating pattern of a 4 points long solid
- line and a 2 points long gap, starting 1 point after the x. To reset
- to solid line, specify *pattern* = NULL ("") and *offset* = 0.
-
-**long PSL_setfill** (**struct PSL_CTRL** *\*P*, **double** *rgb*\ [],
-**long** *outline*)
-
- Sets the current fill color and whether or not outline is needed for
- symbols. Special cases are handled by passing the red color as -1.0
- (no fill), -2.0 (do not change the outline setting) or -3.0 (select
- the image pattern indicated by the second (green) element of *rgb*).
- For PDF transparency, set *rgb*\ [3] to a value between 0 (opaque)
- and 1 (fully transparent). Set outline to PSL_OUTLINE
- (1) to draw the outlines of polygons and symbols using the current pen.
-
-**long PSL_setfont** (**struct PSL_CTRL** *\*P*, **long** *fontnr*)
-
- Changes the current font number to *fontnr*. The fonts available
- are: 0 = Helvetica, 1 = H. Bold, 2 = H. Oblique, 3 = H.
- Bold-Oblique, 4 = Times, 5 = T. Bold, 6 = T. Italic, 7 = T. Bold
- Italic, 8 = Courier, 9 = C. Bold, 10 = C Oblique, 11 = C Bold
- Oblique, 12 = Symbol, 13 = AvantGarde-Book, 14 = A.-BookOblique, 15
- = A.-Demi, 16 = A.-DemiOblique, 17 = Bookman-Demi, 18 =
- B.-DemiItalic, 19 = B.-Light, 20 = B.-LightItalic, 21 =
- Helvetica-Narrow, 22 = H-N-Bold, 23 = H-N-Oblique, 24 =
- H-N-BoldOblique, 25 = NewCenturySchlbk-Roman, 26 = N.-Italic, 27 =
- N.-Bold, 28 = N.-BoldItalic, 29 = Palatino-Roman, 30 = P.-Italic, 31
- = P.-Bold, 32 = P.-BoldItalic, 33 = ZapfChancery-MediumItalic, 34 =
- ZapfDingbats, 35 = Ryumin-Light-EUC-H, 36 = Ryumin-Light-EUC-V, 37 =
- GothicBBB-Medium-EUC-H, and 38 = GothicBBB-Medium-EUC-V. If *fontnr*
- is outside this range, it is reset to 0.
-
-**long PSL_setfontdims** (**struct PSL_CTRL** *\*P*, **double** *supsub*,
-**double** *scaps*, **double** *sup*, **double** *sdown*)
-
- Changes the settings for a variety of relative font sizes and shifts
- pertaining to sub-scripts, super-scripts, and small caps. Default
- settings are given in brackets. Here, *supsub* sets the relative size
- of sub- and super-scripts [0.58], *scaps* sets the relative size of
- small caps [0.8], *sup* indicates the upward baseline shift for placement
- of super-scripts [0.33], while *sdown* sets the downward baseline shift
- for sub-scripts [0.33].
-
-**long PSL_setformat** (**struct PSL_CTRL** *\*P*, **long** *n_decimals*)
-
- Sets the number of decimals to be used when writing color or gray
- values. The default setting of 3 gives 1000 choices per red, green,
- and blue value, which is more than the 255 choices offered by most
- 24-bit platforms. Choosing a lower value will make the output file
- smaller at the expense of less color resolution. Still, a value of 2
- gives 100 x 100 x 100 = 1 million colors, more than most eyes can
- distinguish. For a setting of 1, you will have 10 nuances per
- primary color and a total of 1000 unique combinations.
-
-**long PSL_setlinewidth** (**struct PSL_CTRL** *\*P*, **double**
-*linewidth*)
-
- Changes the current line width in points. Specifying 0 gives the
- thinnest line possible, but this is implementation-dependent (seems
- to work fine on most PostScript printers).
-
-**long PSL_setlinecap** (**struct PSL_CTRL** *\*P*, **long** *cap*)
-
- Changes the current line cap, i.e., what happens at the beginning
- and end of a line segment. PSL_BUTT_CAP (0) gives butt line caps
- [Default], PSL_ROUND_CAP (1) selects round
- caps, while PSL_SQUARE_CAP (2) results
- in square caps. THus, the two last options will visually lengthen a
- straight line-segment by half the line width at either end.
-
-**long PSL_setlinejoin** (**struct PSL_CTRL** *\*P*, **long** *join*)
-
- Changes the current linejoin setting, which handles how lines of
- finite thickness are joined together when the meet at different
- angles. PSL_MITER_JOIN (0) gives a mitered joint [Default],
- PSL_ROUND_JOIN (1) makes them round,
- while PSL_BEVEL_JOIN (2) produces bevel joins.
-
-**long PSL_setmiterlimit** (**struct PSL_CTRL** *\*P*, **long** *limit*)
-
- Changes the current miter limit used for mitered joins.
- PSL_MITER_DEFAULT (35) gives the default PS miter; other values
- are interpreted as the cutoff acute angle (in degrees) when mitering
- becomes active.
-
-**long PSL_settransparencymode** (**struct PSL_CTRL** *\*P*, **char**
-*\*mode*)
-
- Changes the current PDF transparency rendering mode [Default is
- Normal]. Choose among Color, ColorBurn, ColorDodge, Darken,
- Difference, Exclusion, HardLight, Hue, Lighten, Luminosity,
- Multiply, Normal, Overlay, Saturation, SoftLight, and Screen.
-
-**long PSL_setdefaults** (**struct PSL_CTRL** *\*P*, **double**
-*xyscales*\ [], **double** *pagergb*\ [], **char** *\*encoding*)
-
- Allows changes to the PSL session settings and should be called
- immediately after **PSL_beginsession**. The *xyscales* array affect
- an overall magnification of your plot [1,1]. This can be useful if
- you design a page-sized plot but would then like to magnify (or
- shrink) it by a given factor. Change the default paper media color
- [white; 1/1/1] by specifying an alternate page color. Passing zero
- (or NULL for *pagergb*) will leave the setting unchanged. Finally,
- pass the name of the character set encoding (if NULL we select
- Standard).
-
-**long PSL_defunits** (**struct PSL_CTRL** *\*P*, **char** *\*name*,
-**double** *value*)
-
- Creates a PostScript variable called *name* and initializes it to
- the equivalent of *value* user units.
-
-**long PSL_defpoints** (**struct PSL_CTRL** *\*P*, **char** *\*name*,
-**double** *fontsize*)
-
- Creates a PostScript variable called *name* and initializes it to
- the value that corresponds to the font size (in points) given by
- *fontsize*.
-
-`Plotting Lines And Polygons <#toc7>`_
---------------------------------------
-
-Here are functions used to plot lines and closed polygons, which may
-optionally be filled. The attributes used for drawing and filling are
-set prior to calling these functions; see CHANGING SETTINGS above.
-
-**long PSL_plotarc** (**struct PSL_CTRL** *\*P*, **double** *x*,
-**double** *y*, **double** *radius*, **double** *angle1*, **double**
-*angle2*, **long** *type*)
-
- Draws a circular arc with its center at plot coordinates (*x*, *y*),
- starting from angle *angle1* and end at *angle2*. Angles must be
- given in decimal degrees. If *angle1* > *angle2*, a negative arc is
- drawn. The *radius* is in user units. The *type* determines how the
- arc is interpreted: PSL_MOVE (1) means set new
- anchor point, PSL_STROKE (2) means stroke
- the arc, PSL_MOVE + PSL_STROKE (3) means
- both, whereas PSL_DRAW (0) justs adds to arc path to the current
- path.
-
-**long PSL_plotline** (**struct PSL_CTRL** *\*P*, **double** *x*,
-**double** *y*, **long** *n*, **long** *type*)
-
- Assemble a continuous line through *n* points whose the plot
- coordinates are in the *x*, *y* arrays. To continue an existing
- line, use *type* = PSL_DRAW (0), or if this is the first segment in
- a multisegment path, set *type* = PSL_MOVE (1).
- To end the segments and draw the lines, add PSL_STROKE
- (2). Thus, for a single segment, *type* must
- be PSL_MOVE + PSL_STROKE (3). The line is
- drawn using the current pen attributes. Add PSL_CLOSE
- (8) to *type* to close the first and last point
- by the PostScript operators; this is done automatically if the
- first and last point are equal.
-
-**long PSL_plotpoint** (**struct PSL_CTRL** *\*P*, **double** *x*,
-**double** *y*, **long** *type*)
-
- Moves the pen from the current to the specified plot coordinates
- (*x*, *y*) and optionally draws and strokes the line, depending on
- *type*. Specify *type* as either a move (PSL_MOVE, 1), or draw
- (PSL_DRAW, 2), or draw and stroke (PSL_DRAW + PSL_STOKE, 3) using
- current pen attributes. It the coordinates are relative to the
- current point add PSL_REL (4) to *type*.
-
-**long PSL_plotbox** (**struct PSL_CTRL** *\*P*, **double** *x0*,
-**double** *y0*, **double** *x1*, **double** *y1*)
-
- Creates a closed box with opposite corners at plot coordinates
- (*x0*,\ *y1*) and (*x1*,\ *y1*). The box may be filled and its
- outline stroked depending on the current settings for fill and pen
- attributes.
-
-**long PSL_plotpolygon** (**struct PSL_CTRL** *\*P*, **double** *x*,
-**double** *y*, **long** *n*)
-
- Creates a closed polygon through *n* points whose plot coordinates
- are in the *x*, *y* arrays. The polygon may be filled and its
- outline stroked depending on the current settings for fill and pen
- attributes.
-
-**long PSL_plotsegment** (**struct PSL_CTRL** *\*P*, **double** *x0*,
-**double** *y0*, **double** *x1*, **double** *y1*)
-
- Draws a line segment between the two points (plot coordinates) using
- the current pen attributes.
-
-`Plotting Symbols <#toc8>`_
----------------------------
-
-Here are functions used to plot various geometric symbols or constructs.
-
-**long PSL_plotaxis** (**struct PSL_CTRL** *\*P*, **double**
-*tickval*, **char** *\*label*, **double** *fontsize*, **long** *side*)
-
- Plots a basic axis with tick marks, annotations, and label. Assumes
- that **PSL_beginaxes** has been called to set up positioning and
- user data ranges. Annotations will be set using the *fontsize* in
- points. *side* can be 0, 1, 2, or 3, which selects lower x-axis,
- right y-axis, upper x-axis, or left y-axis, respectively. The
- *label* font size is set to 1.5 times the *fontsize*.
-
-**long PSL_plotsymbol** (**struct PSL_CTRL** *\*P*, **double** *x*,
-**double** *y*, **double** *size*\ [], **long** *symbol*)
-
- Plots a simple geometric symbol centered on plot coordinates (*x*,
- *y*). The argument *symbol* selects the geometric symbol to use.
- Most symbols are scaled to fit inside a circle of diameter given as
- *size*\ [0], but some symbols take additional parameters. Choose
- from these 1-parameter symbols using the predefined self-explanatory
- integer values PSL_CIRCLE, PSL_DIAMOND, PSL_HEXAGON,
- PSL_INVTRIANGLE, PSL_OCTAGON, PSL_PENTAGON, PSL_SQUARE,
- PSL_STAR, and PSL_TRIANGLE; these may all be filled and stroked if
- **PSL_setfill** has been called first. In addition, you can choose
- several line-only symbols that cannot be filled. They are
- PSL_CROSS, PSL_DOT, PSL_PLUS, PSL_XDASH, and PSL_YDASH.
- Finally, more complicated symbols require more than one parameter to
- be passed via *size*. These are PSL_ELLIPSE (*size* is expected to
- contain the three parameter *angle*, *major*, and *minor* axes,
- which defines an ellipse with its major axis rotated by *angle*
- degrees), PSL_MANGLE (*size* is expected to contain the 8
- parameters *radius*, *angle1*, and *angle2* for the math angle
- specification, followed by *tailwidth*, *headlength*, *headwidth*,
- *shape*, and *status* (see PSL_VECTOR below for explanation),
- PSL_WEDGE (*size* is expected to contain the three parameter
- *radius*, *angle1*, and *angle2* for the sector specification),
- PSL_RECT (*size* is expected to contain the two dimensions *width*
- and *height*), PSL_RNDRECT (*size* is expected to contain the two
- dimensions *width* and *height* and the *radius* of the corners),
- PSL_ROTRECT (*size* is expected to contain the three parameter
- *angle*, *width*, and *height*, with rotation relative to the
- horizontal), and PSL_VECTOR (*size* is expected to contain the 7
- parameters *x_tip*, *y_tip*, *tailwidth*, *headlength*,
- *headwidth*, *shape*, and *status*. Here (*x_tip*,\ *y_tip*) are
- the coordinates to the head of the vector, while (*x*, *y*) are
- those of the tail. *shape* can take on values from 0-1 and specifies
- how far the intersection point between the base of a straight vector
- head and the vector line is moved toward the tip. 0.0 gives a
- triangular head, 1.0 gives an arrow shaped head. The *status* value
- is a bit-flag being the sum of several possible contributions:
- PSL_VEC_RIGHT (2) = only draw right half
- of vector head, PSL_VEC_BEGIN (4) =
- place vector head at beginning of vector,
- PSL_VEC_END (8) = place vector head at end of vector,
- PSL_VEC_JUST_B (0) = align vector beginning at (x,y),
- PSL_VEC_JUST_C (16) = align vector center at (x,y),
- PSL_VEC_JUST_E (32) = align vector end at (x,y),
- PSL_VEC_JUST_S (64) = align vector center at (x,y),
- PSL_VEC_OUTLINE (128) = draw vector head outline using default
- pen, PSL_VEC_FILL (512) = fill vector head using default fill,
- PSL_VEC_MARC90 (2048) = if angles subtend 90, draw straight angle
- symbol (PSL_MANGLE only). The symbol may be filled and its outline
- stroked depending on the current settings for fill and pen
- attributes.
-
-`Plotting Images <#toc9>`_
---------------------------
-
-Here are functions used to read and plot various images.
-
-**long PSL_plotbitimage** (**struct PSL_CTRL** *\*P*, **double** *x*,
-**double** *y*, **double** *xsize*, **double** *ysize*, **int**
-*justify*, **unsigned char** *buffer*, **long** *nx*, **long** *ny*,
-**double** *f_rgb*\ [], **double** *b_rgb*\ [])
-
- Plots a 1-bit image image at plot coordinates (*x*, *y*) justified
- as per the argument *justify* (see **JUSTIFICATION** for details).
- The target size of the image is given by *xsize* and *ysize* in user
- units. If one of these is specified as zero, the corresponding size
- is adjusted to the other such that the aspect ratio of the original
- image is retained. *buffer* is an unsigned character array in
- scanline orientation with 8 pixels per byte. *nx*, *ny* refers to
- the number of pixels in the image. The rowlength of *buffer* must be
- an integral number of 8; pad with zeros. *buffer*\ [0] is upper left
- corner. You may replace the foreground color (the set bits) with the
- *f_rgb* color and the background color (the unset bits) with
- *b_rgb*. Alternatively, pass either color with the red component
- set to -1.0 and we will instead issue an image mask that is
- see-through for the specified fore- or background component. See the
- Adobe Systems PostScript Reference Manual for more details.
-
-**long PSL_plotcolorimage** (**struct PSL_CTRL** *\*P*, **double**
-*x*, **double** *y*, **double** *xsize*, **double** *ysize*, **int**
-*justify*, **unsigned char** *\*buffer*, **long** *nx*, **long** *ny*,
-**long** *depth*)
-
- Plots a 1-, 2-, 4-, 8-, or 24-bit deep image at plot coordinates
- (*x*, *y*) justified as per the argument *justify* (see
- **JUSTIFICATION** for details). The target size of the image is
- given by *xsize* and *ysize* in user units. If one of these is
- specified as zero, the corresponding size is adjusted to the other
- such that the aspect ratio of the original image is retained. This
- functions sets up a call to the PostScript colorimage or image
- operators. The pixel values are stored in *buffer*, an unsigned
- character array in scanline orientation with gray shade or r/g/b
- values (0-255). *buffer*\ [0] is the upper left corner. *depth* is
- number of bits per pixel (24, 8, 4, 2, or 1). *nx*, *ny* refers to
- the number of pixels in image. The rowlength of *buffer* must be an
- integral number of 8/\ *Idepth*. E.g. if *depth* = 4, then
- *buffer*\ [j]/16 gives shade for pixel[2j-1] and *buffer*\ [j%16
- (mod 16) gives shade for pixel[2j]. When *-depth* is passed instead
- then "hardware" interpolation of the image is requested (this is
- implementation dependent). If *-nx* is passed with 8- (or 24-) bit
- images then the first one (or three) bytes of *buffer* holds the
- gray (or r/g/b) color for pixels that are to be masked out using the
- PS Level 3 Color Mask method. See the Adobe Systems PostScript
- Reference Manual for more details.
-
-**long PSL_plotepsimage** (**struct PSL_CTRL** *\*P*, **double** *x*,
-**double** *y*, **double** *xsize*, **double** *ysize*, **int**
-*justify*, **unsigned char** *\*buffer*, **long** *size*, **long** *nx*,
-**long** *ny*, **long** *ox*, **long** *oy*)
-
- Plots an Encapsulated PostScript (EPS) image at plot coordinates
- (*x*, *y*) justified as per the argument *justify* (see
- **JUSTIFICATION** for details). The target size of the image is
- given by *xsize* and *ysize* in user units. If one of these is
- specified as zero, the corresponding size is adjusted to the other
- such that the aspect ratio of the original image is retained. The
- EPS file is stored in *buffer* and has *size* bytes. This function
- simply includes the image in the PostScript output stream within
- an appropriate wrapper. Specify position of lower left corner and
- size of image. *nx*, *ny*, *ox*, *oy* refers to the width, height
- and origin (lower left corner) of the BoundingBox in points.
-
-**long PSL_loadimage** (**struct PSL_CTRL** *\*P*, **FILE** *\*fp*,
-**struct imageinfo** *\*header*, **unsigned char** *\*\*image*)
-
- Reads the image contents of the EPS file or a raster image pointed
- to by the open file pointer *fp*. The routine can handle
- Encapsulated PostScript files or 1-, 8-, 24-, or 32-bit raster
- images in old, standard, run-length encoded, or RGB-style Sun
- format. Non-Sun rasters are automatically reformatted to Sun rasters
- via a system call to GraphicsMagick's or ImageMagick's **convert**, if installed. The
- image is returned via the *image* pointer.
-
-Plotting Text
--------------
-
-Here are functions used to read and plot text strings and paragraphs.
-This can be somewhat complicated since we rely on the PostScript
-interpreter to determine the exact dimensions of text items given the
-font chosen. For perfect alignment you may have to resort to calculate
-offsets explicitly using **long PSL_deftextdim**, **PSL_set_height**
-and others and issue calculations with **PSL_setcommand**.
-
-**long PSL_plottext** (**struct PSL_CTRL** *\*P*, **double** *x*,
-**double** *y*, **double** *fontsize*, **char** *\*text*, **double**
-*angle*, **long** *justify*, **long** *mode*)
-
- The *text* is plotted starting at plot coordinates (*x*, *y*) and
- will make an *angle* with the horizontal. The point (*x*, *y*) maps
- onto different points of the text-string by giving various values
- for *justify* (see **JUSTIFICATION** for details). If *justify* is
- negative, then all leading and trailing blanks are stripped before
- plotting. Certain character sequences (flags) have special meaning
- to **PSL_plottext**. @~ toggles between current font and the
- Mathematical Symbols font. @%\ *no*\ % selects font *no* while @%%
- resets to the previous font. @- turns subscript on/off, @+ turns
- superscript on/off, @# turns small caps on/off, and @\\ will make a
- composite character of the following two character. @;\ *r/g/b*;
- changes the font color while @;; resets it [optionally append
- =\ *transparency* to change the transparency (0--100) of the text
- (the Default is opaque or 0)], @:\ *size*: changes the font size
- (@:: resets it), and @\_ toggles underline on/off. If *text* is NULL
- then we assume **PSL_plottextbox** was called first. Give
- *fontsize* in points. Normally, the text is typed using solid
- characters in the current color (set by **PSL_setcolor**). To draw
- outline characters, set *mode* == 1; the outline will get the
- current color and the text is filled with the current fill color
- (set by **PSL_setfill**). Use *mode* == 2 if the current fill is a
- pattern. If *fontsize* is negative it means that the current point
- has already been set before **PSL_plottext** was called and that
- (*x*, *y*) should be ignored.
-
-**long PSL_plottextbox** (**struct PSL_CTRL** *\*P*, **double** *x*,
-**double** *y*, **double** *fontsize*, **char** *\*text*, **double**
-*angle*, **long** *justify*, **double** *offset*\ [], **long** *mode*)
-
- This function is used in conjugation with **PSL_plottext** when a
- box surrounding the text string is desired. Taking most of the
- arguments of **PSL_plottext**, the user must also specify *mode* to
- indicate whether the box needs rounded (PSL_YES = 1) or straight
- (PSL_NO = 0) corners. The box will be colored with the current fill
- style set by **PSL_setfill**. That means, if an outline is desired,
- and the color of the inside of the box should be set with that
- routine. The outline will be drawn with the current pen color (and
- width). The *offset* array holds the horizontal and vertical
- distance gaps between text and the surrounding text box in distance
- units. The smaller of the two determined the radius of the rounded
- corners (if requested).
-
-**long PSL_deftextdim** (**struct PSL_CTRL** *\*P*, **char**
-*\*prefix*, **double** *fontsize*, **char** *\*text*)
-
- Computes the dimensions (width and height) required by the selected
- *text* given the current font and its *fontsize* (in points). The
- values are stored as PostScript variables called *prefix*\ \_w and
- *prefix*\ \_h, respectively. This function can be used to compute
- dimensions and, via BF(PSL_setcommand), calculate chances to
- position a particular item should be plotted. For instance, if you
- compute a position this way and wish to plot the text there, pass
- the coordinates to **PSL_plottext** as NaNs. If *prefix* is BF(-w),
- BF(-h), BF(-d) or BF(-b), no PostScript variables will be
- assigned, but the values of width, height, depth, or both width and
- height will be left on the PostScript stack.
-
-**long PSL_setparagraph** (**struct PSL_CTRL** *\*P*, **double**
-*line_space*, **double** *par_width*, **long** *par_just*)
-
- Initialize common settings to be used when typesetting paragraphs of
- text with **PSL_plotparagraph**. Specify the line spacing (1 equals
- the font size) and paragraph width (in distance units). Text can be
- aligned left (PSL_BL), centered (PSL_BC), right (PSL_BR), or
- justified (PSL_JUST) and is controlled by *par_just*.
-
-**long PSL_plotparagraphbox** (**struct PSL_CTRL** *\*P*,
-**double** *x*, **double** *y*, **double** *fontsize*, **char**
-*\*text*, **double** *angle*, **long** *justify*, **double**
-*offset*\ [], **long** *mode*)
-
- Computes and plots the text rectangle for a paragraph using the
- specified *fontsize* (in points). Here, *text* is an array of
- the text to be typeset, using the settings initialized by
- **PSL_setparagraph**. The escape sequences described for
- **PSL_plottext** can be used to modify the text. Separate text
- into several paragraphs by appending \\r to the last item in a
- paragraph. The whole text block is positioned at plot
- coordinates *x*, *y*, which is mapped to a point on the block
- specified by *justify* (see **JUSTIFICATION** for details). The
- whole block is then shifted by the amounts *shift*\ []. The box
- will be plotted using the current fill and outline settings. The
- *offset* array holds the horizontal and vertical distance gaps
- between text and the surrounding text box in distance units. Use
- *mode* to indicate whether the box should be straight
- (PSL_RECT_STRAIGHT = 0), rounded (PSL_RECT_ROUNDED = 1),
- convex (PSL_RECT_CONVEX = 2) or concave (PSL_RECT_CONCAVE = 3).
-
-**long PSL_plotparagraph** (**struct PSL_CTRL** *\*P*, **double**
-*x*, **double** *y*, **double** *fontsize*, **char** *\*text*,
-**double** *angle*, **long** *justify*, **long** *mode*)
-
- Typesets paragraphs of text using the specified *fontsize* (in
- points). Here, *text* is an array of the text to be typeset,
- using the settings initialized by **PSL_setparagraph**. The
- escape sequences described for **PSL_plottext** can be used to
- modify the text. Separate text into several paragraphs by
- appending \\r to the last item in a paragraph. The whole text
- block is positioned at plot coordinates *x*, *y*, which is
- mapped to a point on the block specified by *justify* (see
- **JUSTIFICATION** for details). See **PSL_plotparagraphbox**
- for laying down the surrounding text rectangle first.
-
-**long PSL_plottextline** (**struct PSL_CTRL** *\*P*, **double**
-*\*xpath*, **double** *\*ypath*, **long** *\*np*, **long** *nseg*,
-**void** *\*arg1*\, **void** *\*arg2*\, **char** *\*text*\ [],
-**double** *angle*\ [], **long** *n_per_seg*\ [], **double** *fontsize,
-***long** *justify*, **double** *offset*\ [], **long** *mode*)
-
- Please text along one or more path segments. The function does
- different things depending on the bit flags in *mode*. A key
- distinction occurs if the bit flag contains the bit PSL_TXT_CURVED
- (64) which means we wish to typeset the text along a variable and curved
- baseline given by the segments in *xpath, ypath*; otherwise we set
- straight text (possibly at an angle) and the *xpath, ypath* are
- not considered for text placement [If no line drawing is desired
- then these two arrays may be NULL]. We will describe the action
- taken for each bit value. Multiple values may be passed at the
- same time and we processes from low to hight bit.
- PSL_TXT_INIT: When mode contains this bit (1) we will initialize
- all the required variables and store them in the PostScript file.
- PSL_TXT_SHOW: We wish to see the text strings (otherwise they may
- only serve as guides to set up clip paths).
- PSL_TXT_CLIP_ON: Use the text and the paths to set up clip paths.
- PSL_TXT_DRAW: Draw the lines defined by the *xpath, ypath* arrays.
- PSL_TXT_CLIP_OFF: Turn the text path clipping off.
- We pass the text strings via *text*. The locations of text plotting
- depends on whether PSL_TXT_CURVED is selected. If it is then
- you must pass as *arg1* the *node* array indicating at which
- node in the *xpath, ypath* array the text will be plotted; let
- *arg2* be NULL. For
- straight baselines you must instead pass another set of x,y
- coordinates with the locations of the text label placements
- via *arg1, arg2*.
- Each label has its own entry in the
- *angle* array. The *text* is an array of text pointers to the
- individual text items. The
- *offset* array holds the x and y distance gaps between text and
- the surrounding text box in user units (the clip path is the
- combination of all these text boxes). Use *justify* to specify
- how the text string relates to the coordinates (see
- BF(JUSTIFICATION) for details).
- PSL_TXT_FILLBOX (128) will fill the text box (this requires you
- to first define the text box rgb color with **PSL_define_rgb**
- by setting a local PostScript variable that must be called PSL_setboxrgb).
- PSL_TXT_DRAWBOX (256) will draw the text box outlines (this requires
- you to first define the text box pen with **PSL_define_pen** by setting a local
- PostScript variable that must be called PSL_setboxpen). Before
- calling this function you must also initialize a PSL array for
- line pens and text fonts.
-
-Clipping
---------
-
-Here are functions used to activate and deactivate clipping regions.
-
-**long PSL_beginclipping** (**struct PSL_CTRL** *\*P*, **double** *x*,
-**double** *y*, **long** *n*, **double** *rgb*\ [], **long** *flag*)
-
- Sets up a user-definable clip path as a series on *n* points with
- plot coordinates (*x*, *y*). Plotting outside this polygon will be
- clipped until **PSL_endclipping** is called. If *rgb*\ [0] = -1 the
- inside of the path is left empty, otherwise it is filled with the
- specified color. *flag* is used to create complex clip paths
- consisting of several disconnected regions, and takes on values 0-3.
- *flag* = PSL_PEN_MOVE_ABS (1) means
- this is the first path in a multisegment clip path. *flag* =
- PSL_PEN_DRAW_ABS (2) means this is
- the last segment. Thus, for a single path, *flag* =
- PSL_PEN_DRAW_AND_STROKE_ABS (3).
-
-**long PSL_endclipping** (**struct PSL_CTRL** *\*P*, **long** *mode*)
-
- Depending on the *mode* it restores the clip path. The *mode* values
- can be: -*n* will restore *n* levels of text-based clipping, *n*
- will restore *n* levels of polygon clipping, PSL_ALL_CLIP_TXT
- will undo all levels of text-based clipping, and PSL_ALL_CLIP_POL
- will undo all levels of polygon-based clipping.
-
-`Miscellaneous Functions <#toc12>`_
------------------------------------
-
-Here are functions used to issue comments or to pass custom PostScript
-commands directly to the output PostScript file. In C these functions
-are declared as macros and they can accept a variable number of
-arguments. However, from FORTRAN only a single text argument may be
-passed.
-
-**long PSL_setcommand** (**struct PSL_CTRL** *\*P*, **char** *\*text*)
- Writes a raw PostScript command to the PostScript output file,
- e.g., "1 setlinejoin0.
-
-**long PSL_comment** (**struct PSL_CTRL** *\*P*, **char** *\*text*)
- Writes a comment (*text*) to the PostScript output file, e.g.,
- "Start of graph 20. The comment are prefixed with with %% .
-
-Authors
--------
-
-Paul Wessel, School of Ocean and Earth Science and Technology,
-`http://www.soest.hawaii.edu. <http://www.soest.hawaii.edu.>`_
-
-Remko Scharroo, EUMETSAT, Darmstadt, Germany,
-`http://www.eumetsat.int. <http://www.eumetsat.int.>`_
-
-Bugs
-----
-
-Caveat Emptor: The authors are **not** responsible for any disasters,
-suicide attempts, or ulcers caused by correct **or** incorrect use of
-PSL. If you find bugs, please report them to the authors by
-electronic mail. Be sure to provide enough detail so that we can
-recreate the problem.
-
-References
-----------
-
-Adobe Systems Inc., 1990, PostScript language reference manual, 2nd
-edition, Addison-Wesley, (ISBN 0-201-18127-4).
diff --git a/doc_release/html/_sources/psmask.txt b/doc_release/html/_sources/psmask.txt
deleted file mode 100644
index cc6550f..0000000
--- a/doc_release/html/_sources/psmask.txt
+++ /dev/null
@@ -1,179 +0,0 @@
-.. index:: ! psmask
-
-******
-psmask
-******
-
-.. only:: not man
-
- psmask - Use data tables to clip or mask map areas with no coverage
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**psmask** [ *table* ]
-|SYN_OPT-I|
-**-J**\ *parameters*
-|SYN_OPT-R|
-[ |SYN_OPT-B| ]
-[ **-D**\ *dumpfile* ]
-[ **-G**\ *fill* ] [ **-Jz**\ \|\ **Z**\ *parameters* ] [ **-K** ]
-[ **-N** ] [ **-O** ] [ **-P** ] [ **-Q**\ *cut* ]
-[ **-S**\ *search\_radius*\ [*unit*] ] [ **-T** ]
-[ |SYN_OPT-U| ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-X| ]
-[ |SYN_OPT-Y| ]
-[ |SYN_OPT-bi| ]
-[ |SYN_OPT-c| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-p| ]
-[ **-r** ]
-[ |SYN_OPT-t| ]
-[ |SYN_OPT-:| ]
-
-**psmask** **-C** [ **-K** ] [ **-O** ]
-
-|No-spaces|
-
-Description
------------
-
-**psmask** reads a (*x*,\ *y*,\ *z*) file [or standard input] and uses
-this information to find out which grid cells are reliable. Only grid
-cells which have one or more data points are considered reliable. As an
-option, you may specify a radius of influence. Then, all grid cells that
-are within *radius* of a data point are considered reliable.
-Furthermore, an option is provided to reverse the sense of the test.
-Having found the reliable/not reliable points, **psmask** will either
-paint tiles to mask these nodes (with the **-T** switch), or use
-contouring to create polygons that will clip out regions of no interest.
-When clipping is initiated, it will stay in effect until turned off by a
-second call to **psmask** using the **-C** option.
-
-Required
---------
-
-.. include:: explain_-I.rst_
-
-.. include:: explain_-J.rst_
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-R.rst_
-
-.. |Add_-Rz| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-Rz.rst_
-
-Optional Arguments
-------------------
-
-.. |Add_intables| unicode:: 0x20 .. just an invisible code
-.. include:: explain_intables.rst_
-
-.. include:: explain_-B.rst_
-
-**-C**
- Mark end of existing clip path. No input file is needed. Implicitly
- sets **-O**. Also supply **-X** and **-Y** settings if you have
- moved since the clip started.
-**-D**\ *dumpfile*
- Dump the (x,y) coordinates of each clipping polygon to one or more
- output files (or *stdout* if *template* is not given). No plotting
- will take place. If *template* contains the C-format specifier %d
- (including modifications like %05d) then polygons will be written to
- different files; otherwise all polygons are written to the specified
- file (*template*). The files are ASCII unless
- **-bo** is used. See **-Q** to exclude small
- polygons from consideration.
-
-.. |Add_perspective| unicode:: 0x20 .. just an invisible code
-.. include:: explain_perspective.rst_
-
-**-G**\ *fill*
- Paint the clip polygons (or tiles) with a selected fill [Default is no fill].
-
-.. include:: explain_-Jz.rst_
-
-.. include:: explain_-K.rst_
-
-**-N**
- Invert the sense of the test, i.e., clip regions where there is data coverage.
-
-.. include:: explain_-O.rst_
-
-.. include:: explain_-P.rst_
-
-**-Q**
- Do not dump polygons with less than *cut* number of points [Dumps
- all polygons]. Only applicable if **-D** has been specified.
-**-S**\ *search\_radius*\ [*unit*\ ]
- Sets radius of influence. Grid nodes within *radius* of a data point
- are considered reliable. [Default is 0, which means that only grid
- cells with data in them are reliable]. Append the distance unit (see
- UNITS).
-**-T**
- Plot tiles instead of clip polygons. Use **-G** to set tile color or
- pattern. Cannot be used with **-D**.
-
-.. include:: explain_-U.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. include:: explain_-XY.rst_
-
-.. |Add_-bi| replace:: [Default is 2 input columns].
-.. include:: explain_-bi.rst_
-
-.. include:: explain_-c.rst_
-
-.. |Add_-h| replace:: Not used with binary data.
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. include:: explain_perspective.rst_
-
-.. |Add_nodereg| unicode:: 0x20 .. just an invisible code
-.. include:: explain_nodereg.rst_
-
-.. include:: explain_-t.rst_
-
-.. include:: explain_colon.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_distunits.rst_
-
-Examples
---------
-
-To make an overlay PostScript file that will mask out the regions of a
-contour map where there is no control data using clip polygons, use:
-
- ::
-
- gmt psmask africa_grav.xyg -R20/40/20/40 -I5m -JM10i -O -K > mask.ps
-
-We do it again, but this time we wish to save the clipping polygons to
-file all_pols.txt:
-
- ::
-
- gmt psmask africa_grav.xyg -R20/40/20/40 -I5m -Dall_pols.txt
-
-A repeat of the first example but this time we use white tiling:
-
- ::
-
- gmt psmask africa_grav.xyg -R20/40/20/40 -I5m -JM10i -T -O -K -Gwhite > mask.ps
-
-See Also
---------
-
-:doc:`gmt`, :doc:`gmtcolors`,
-:doc:`grdmask`, :doc:`surface`,
-:doc:`psbasemap`, :doc:`psclip`
diff --git a/doc_release/html/_sources/psrose.txt b/doc_release/html/_sources/psrose.txt
deleted file mode 100644
index 91abb77..0000000
--- a/doc_release/html/_sources/psrose.txt
+++ /dev/null
@@ -1,198 +0,0 @@
-.. index:: ! psrose
-
-******
-psrose
-******
-
-.. only:: not man
-
- psrose - Plot a polar histogram (rose, sector, windrose diagrams)
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**psrose** [ *table* ] [ **-A**\ [**r**]*sector\_width* ]
-[ |SYN_OPT-B| ]
-[ **-C**\ [*mode_file*] ]
-[ **-D** ] [ **-I** ] [ **-G**\ *fill* ] [ **-I** ] [ **-K** ]
-[ **-L**\ [*wlabel*/*elabel*/*slabel*/*nlabel*] ] [ **-M**\ *parameters* ]
-[ **-O** ] [ **-P** ]
-[ **-R**\ *r0*/*r1*/*az_0*/*az_1* ]
-[ **-S**\ [**n**]*radial\_scale* ] [ **-T** ]
-[ |SYN_OPT-U| ]
-[ |SYN_OPT-V| ]
-[ **-W**\ [**v**]\ *pen* ]
-[ |SYN_OPT-X| ]
-[ |SYN_OPT-Y| ]
-[ **-Z**\ **u**\ \|\ *scale* ]
-[ |SYN_OPT-bi| ]
-[ |SYN_OPT-c| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-p| ]
-[ |SYN_OPT-t| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**psrose** reads (length,azimuth) pairs from *file* [or standard input]
-and generates PostScript code that will plot a windrose diagram.
-Optionally (with **-A**), polar histograms may be drawn (sector diagram
-or rose diagram). Options include full circle and half circle plots. The
-PostScript code is written to standard output. The outline of the
-windrose is drawn with the same color as **MAP\_DEFAULT\_PEN**.
-
-Required Arguments
-------------------
-
-None.
-
-Optional Arguments
-------------------
-
-.. |Add_intables| replace:: If a file with only
- azimuths are given, use **-i** to indicate the single column with
- azimuths; then all lengths are set to unity (see **-Zu** to set
- actual lengths to unity as well).
-.. include:: explain_intables.rst_
-
-**-A**\ [**r**]*sector\_width*
- Gives the sector width in degrees for sector and rose diagram.
- [Default 0 means windrose diagram]. Use **-Ar** to draw rose
- diagram instead of sector diagram.
-
-.. include:: explain_-B.rst_
-|
-| Remember that "x" here is
-| radial distance and "y" is azimuth. The ylabel may be used to plot a figure caption.
-
-**-C**\ [*mode_file*]
- Plot vectors showing the principal directions given in the *modes*
- file. If no file is given, compute and plot mean direction. See
- **-M** to control vector attributes.
-**-D**
- Shift sectors so that they are centered on the bin interval (e.g.,
- first sector is centered on 0 degrees).
-**-F**
- Do not draw the scale length bar [Default plots scale in lower right
- corner]
-**-G**\ *fill*
- Selects shade, color or pattern for filling the sectors [Default is
- no fill].
-**-I**
- Inquire. Computes statistics needed to specify useful **-R**. No
- plot is generated.
-
-.. include:: explain_-K.rst_
-
-**-L**\ [*wlabel*/*elabel*/*slabel*/*nlabel*]
- Specify labels for the 0, 90, 180, and 270 degree marks. For
- full-circle plot the default is WEST/EAST/SOUTH/NORTH and for
- half-circle the default is 90W/90E/-/0. A - in any entry disables
- that label. Use **-L** with no argument to disable all four labels
-
-**-M**\ *parameters*
- Used with **-C** to modify vector parameters. For vector heads,
- append vector head *size* [Default is 0, i.e., a line]. See VECTOR
- ATTRIBUTES for specifying additional attributes.
-
-.. include:: explain_-O.rst_
-
-.. include:: explain_-P.rst_
-
-**-R**\ *r0*/*r1*/*az\_0*/*az\_1*
- Specifies the 'region' of interest in (r,azimuth) space. r0 is 0, r1
- is max length in units. For azimuth, specify either -90/90 or 0/180
- for half circle plot or 0/360 for full circle.
-
-**-S**\ [**n**]*radial_scale*
- Specifies radius of circle. Use **-Sn** to normalize input radii to
- go from 0 to 1.
-
-**-T**
- Specifies that the input data is orientation data (has a 180 degree
- ambiguity) instead of true 0-360 degree directions [Default].
-
-.. include:: explain_-U.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-W**\ *pen*
- Set pen attributes for sector outline or rose plot. [Default is no
- outline]. Use **-Wv**\ *pen* to change pen used to draw vector
- (requires **-C**) [Default is same as sector outline].
-
-.. include:: explain_-XY.rst_
-
-**-Z**\ *scale*
- Multiply the data radii by *scale*. E.g., use **-Z**\ 0.001 to
- convert your data from m to km. To exclude the radii from
- consideration, set them all to unity with **-Zu** [Default is no
- scaling].
-**-:**
- Input file has (azimuth,radius) pairs rather than the expected
- (radius,azimuth).
-
-.. |Add_-bi| replace:: [Default is 2 input columns].
-.. include:: explain_-bi.rst_
-
-.. include:: explain_-c.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. |Add_perspective| unicode:: 0x20 .. just an invisible code
-.. include:: explain_perspective.rst_
-
-.. include:: explain_-t.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_vectors.rst_
-
-Examples
---------
-
-To plot a half circle rose diagram of the data in the file
-fault_segments.az_r (containing pairs of (azimuth, length in meters),
-using a 10 degree bin sector width, on a circle of radius = 3 inch, grid
-going out to radius = 150 km in steps of 25 km with a 30 degree sector
-interval, radial direction annotated every 50 km, using a light blue
-shading outlined by a solid red pen (width = 0.75 points), draw the mean
-azimuth, and shown in Portrait orientation, use:
-
- ::
-
- gmt psrose fault_segments.az_r -R0/150/-90/90 -B50g25:"Fault
- length":/g30:."Rose diagram":-S3i -Ar10 -Glightblue
- -W0.75p,red -Z0.001 -C -P -T -: > half_rose.ps
-
-To plot a full circle wind rose diagram of the data in the file
-lines.r_az, on a circle of radius = 5 cm, grid going out to radius =
-500 units in steps of 100 with a 45 degree sector interval, using a
-solid pen (width = 0.5 point, and shown in landscape [Default]
-orientation with UNIX timestamp and command line plotted, use:
-
- ::
-
- gmt psrose lines.az_r -R0/500/0/360 -S5c -Bg100/g45:."Windrose diagram": -W0.5p -Uc | lpr
-
-Bugs
-----
-
-No default radial scale and grid settings for polar histograms. User
-must run **psrose** **-I** to find max length in binned data set.
-
-See Also
---------
-
-:doc:`gmt`, :doc:`gmt.conf`,
-:doc:`gmtcolors`, :doc:`pshistogram`
diff --git a/doc_release/html/_sources/psscale.txt b/doc_release/html/_sources/psscale.txt
deleted file mode 100644
index d6e253b..0000000
--- a/doc_release/html/_sources/psscale.txt
+++ /dev/null
@@ -1,214 +0,0 @@
-.. index:: ! psscale
-
-*******
-psscale
-*******
-
-.. only:: not man
-
- psscale - Plot a gray or color scale-bar on maps
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**psscale** **-D**\ *xpos*/*ypos*/*length*/*width*\ [**h**]
-[ **-A**\ [**a**\ \|\ **l**\ \|\ **c**] ]
-[ |SYN_OPT-B| ]
-[ **-C**\ *cpt\_file* ]
-[ **-E**\ [**b**\ \|\ **f**][*length*][\ **+n**\ [*text*]] ]
-[ **-G**\ *zlo*\ /\ *zhi* ]
-[ **-I**\ [*max\_intens*\ \|\ *low\_i*/*high\_i*] ]
-[ **-J**\ *parameters* ]
-[ **-Jz**\ \|\ **Z**\ *parameters* ] [ **-K** ]
-[ **-L**\ [**i**][*gap*] ] [ **-M** ] [ **-N**\ [**p**\ \|\ *dpi* ]] [ **-O** ]
-[ **-P** ] [ **-Q** ]
-[ |SYN_OPT-R| ]
-[ **-S** ]
-[ **-T**\ [**+p**\ *pen*][\ **+g**\ *fill*][\ **+l**\ \|\ **r**\ \|\ **b**\ \|\ **t**\ *off*] ]
-[ |SYN_OPT-U| ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-X| ]
-[ |SYN_OPT-Y| ]
-[ **-Z**\ *zfile* ]
-[ |SYN_OPT-c| ]
-[ |SYN_OPT-p| ]
-[ |SYN_OPT-t| ]
-
-|No-spaces|
-
-Description
------------
-
-**psscale** plots gray scales or color scales on maps. Both horizontal
-and vertical scales are supported. For cpt_files with gradational
-colors (i.e., the lower and upper boundary of an interval have different
-colors) **psscale** will interpolate to give a continuous scale.
-Variations in intensity due to shading/illumination may be displayed by
-setting the option **-I**. Colors may be spaced according to a linear
-scale, all be equal size, or by providing a file with individual tile
-widths. The font used for the annotations along the scale and optional
-units is specified by :ref:`FONT_ANNOT_PRIMARY <FONT_ANNOT_PRIMARY>`. If a label is requested,
-it is plotted with **FONT_LABEL**
-
-Required Arguments
-------------------
-
-**-D**\ *xpos*/*ypos*/*length*/*width*\ [**h**]
- Defines the position of the center/top (for horizontal scale) or
- center/left (for vertical scale) and the dimensions of the scale.
- Give a negative length to reverse the scalebar. Append *h* to get a
- horizontal scale [Default is vertical].
-
-Optional Arguments
-------------------
-
-**-A**\ [**a**\ \|\ **l**\ \|\ **c**]
- Place annotations and labels above (instead of below) horizontal
- scalebars and to the left (instead of the right) of vertical
- scalebars. Append **a** or **l** to move only the annotations or the
- label to the other side. Append **c** if you want to print a
- vertical label as a column of characters (does not work with special characters).
-
-**-B**\ [**p**\ \|\ **s**]\ *parameters*
- Set annotation, tick, and gridline interval for the colorbar. The
- x-axis label will plot beneath a horizontal bar (or vertically to
- the right of a vertical bar), except when using **-A**. As an
- option, use the y-axis label to plot the data unit to the right of a
- horizontal bar (and above a vertical bar). When using **-Ba** or
- **-Baf** annotation and/or minor tick intervals are chosen
- automatically. If **-B** is omitted, or no annotation intervals are
- provided, the default is to annotate every color level based on the
- numerical entries in the cpt file (which may be overridden by ULB
- flags in the cpt file). To specify custom text annotations for
- intervals, you must append ;\ *annotation* to each z-slice in the cpt file.
-
-**-C**\ *cpt_file*
- *cpt\_file* is the color palette file to be used. By default all
- color changes are annotated. To use a subset, add an extra column to
- the cpt-file with a L, U, or B to annotate Lower, Upper, or Both
- color segment boundaries (but see **-B**). If not given, **psscale**
- will read stdin. Like **grdview**, **psscale** can understand
- pattern specifications in the cpt file. For CPT files where the
- *z* range is in meters, it may be useful to change to another unit
- when plotting. To do so, append **+U**\ *unit* to the file name.
- Likewise, if the CPT file uses another unit than meter and you wish
- to plot the CPT versus meters, append **+u**\ *unit*.
-
-**-E**\ [**b**\ \|\ **f**][*length*][\ **+n**\ [*text*]]
- Add sidebar triangles for **b**\ ack- and/or **f**\ oreground
- colors. Add **f** or **b** for only one sidebar triangle [Default
- gives both]. Optionally, append triangle height [Default is half the
- barwidth]. Finally, you can plot a rectangle with the NaN color at
- the start of the bar, labeled with *text* [NaN].
-
-**-G**\ *zlo*\ /\ *zhi*
- Truncate the incoming CPT so that the lowest and highest z-levels
- are to *zlo* and *zhi*. If one of these equal NaN then
- we leave that end of the CPT alone. The truncation takes place
- before the plotting.
-
-**-I**\ [*max\_intens*\ \|\ *low\_i*/*high\_i*]
- Add illumination effects. Optionally, set the range of intensities
- from - to + *max\_intens*. If not specified, 1 is used.
- Alternatively, append *low/high* intensities to specify an
- asymmetric range [Default is no illumination].
-
-.. include:: explain_-J.rst_
-
-.. include:: explain_-Jz.rst_
-
-.. include:: explain_-K.rst_
-
-**-L**\ [**i**][*gap*]
- Gives equal-sized color rectangles. Default scales rectangles
- according to the z-range in the cpt-file (Also see **-Z**). If set,
- any equal interval annotation set with **-B** will be ignored. If
- *gap* is appended and the cpt table is discrete we will center each
- annotation on each rectangle, using the lower boundary z-value for
- the annotation. If **i** is prepended we annotate the interval range
- instead. If **-I** is used then each rectangle will have its
- constant color modified by the specified intensity.
-
-**-M**
- Force a monochrome graybar using the (television) YIQ transformation.
-
-**-N**\ [**p**\ \|\ *dpi*]
- Controls how the color scale is represented by the PostScript language.
- To preferentially draw color rectangles (e.g., for discrete colors), append **p**.
- Otherwise we will preferentially draw images (e.g., for continuous colors).
- Optionally append effective dots-per-inch for rasterization of color scales [600].
-
-.. include:: explain_-O.rst_
-
-.. include:: explain_-P.rst_
-
-**-Q**
- Select logarithmic scale and power of ten annotations. All z-values
- in the cpt file will be converted to p = log10(z) and only integer p
- values will be annotated using the 10^p format [Default is linear
- scale].
-
-.. |Add_-Rgeo| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-Rgeo.rst_
-
-.. |Add_-Rz| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-Rz.rst_
-
-**-S**
- Do not separate different color intervals with black grid lines.
-
-**-T**\ [**+p**\ *pen*][\ **+g**\ *fill*][\ **+l**\ \|\ **r**\ \|\ **b**\ \|\ **t**\ *off*]
- Place a rectangle as background to the color scale. You must specify
- either a pen outline (with modifier **+p**\ *pen*) or a fill (with
- modifier **+g**\ *fill*), or both. The size of the rectangle is
- computed from **-D** and the current fontsize and offset parameters.
- You can add (or remove) additional space on any side by appending
- **+s**\ *off*, where **s** is one of **l**\ eft, **r**\ ight,
- **b**\ ottom, or **t**\ op.
-
-.. include:: explain_-U.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. include:: explain_-XY.rst_
-
-**-Z**\ *zfile*
- File with colorbar-width per color entry. By default, width of entry
- is scaled to color range, i.e., z = 0-100 gives twice the width as z
- = 100-150 (Also see **-L**).
-
-.. include:: explain_-c.rst_
-
-.. |Add_perspective| replace:: (Required **-R** and **-J** for proper functioning).
-.. include:: explain_perspective.rst_
-
-.. include:: explain_-t.rst_
-
-.. include:: explain_help.rst_
-
-Examples
---------
-
-To append a vertical color scale (7.5 cm long; 1.25 cm wide) to the
-right of a plot that is 6 inch wide and 4 inch high, using illumination,
-and show back- and foreground colors, and annotating every 5 units, use
-
- ::
-
- gmt psscale -D6.5i/2i/7.5c/1.25c -O -Ccolors.cpt -I -E -B5:BATHYMETRY:/:m: > map.ps
-
-Notes
------
-
-When the cpt file is discrete and no illumination is specified, the
-color bar will be painted using polygons. For all other cases we must
-paint with an image. Some color printers may give slightly different
-colors for the two methods given identical RGB values.
-
-See Also
---------
-
-:doc:`gmt`, :doc:`makecpt`, :doc:`grd2cpt`
diff --git a/doc_release/html/_sources/pstext.txt b/doc_release/html/_sources/pstext.txt
deleted file mode 100644
index 4fd5c86..0000000
--- a/doc_release/html/_sources/pstext.txt
+++ /dev/null
@@ -1,288 +0,0 @@
-.. index:: ! pstext
-
-******
-pstext
-******
-
-.. only:: not man
-
- pstext - Plot or typeset text on maps
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**pstext** [ *textfiles* ] **-J**\ *parameters*
-|SYN_OPT-Rz|
-[ **-A** ]
-|SYN_OPT-B|
-[ **-D**\ [**j**\ \|\ **J**]\ *dx*\ [/*dy*][\ **v**\ [*pen*]] ]
-[ **-F**\ [**+a**\ [*angle*]][\ **+c**\ [*justify*]][\ **+f**\ [*font*]][\ **+h**][\ **+j**\ [*justify*]][\ **+l**] ]
-[ **-G**\ *color* ] [ **-Jz**\ \|\ **Z**\ *parameters* ] [ **-K** ]
-[ **-L** ] [ **-M** ] [ **-N** ] [ **-O** ] [ **-P** ] [
-**-Q**\ **l**\ \|\ **u** ] [
-**-T**\ **o**\ \|\ **O**\ \|\ **c**\ \|\ **C** ] [
-[ **-W**\ *pen* ]
-[ |SYN_OPT-X| ]
-[ |SYN_OPT-Y| ]
-[ |SYN_OPT-U| ]
-[ **-Z** ] [ **-a**\ *col*\ =\ *name*\ [...] ]
-[ |SYN_OPT-c| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-p| ]
-[ |SYN_OPT-t| ]
-[ |SYN_OPT-o| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**pstext** plots text strings of variable size, font type, and
-orientation. Various map projections are provided, with the option to
-draw and annotate the map boundaries. PostScript code is written to
-standard output. Greek characters, subscript, superscript, and small
-caps are supported as follows: The sequence @~ toggles between the
-selected font and Greek (Symbol). @%\ *no*\ % sets the font to *no*; @%%
-resets the font to the starting font, @- toggles subscripts on/off, @+
-toggles superscript on/off, @# toggles small caps on/off, @;\ *color*;
-changes the font color (@;; resets it), @:\ *size*: changes the font
-size (@:: resets it), and @\_ toggles underline on/off. @@ prints the @
-sign. @e, @o, @a, @E, @O, @A give the accented Scandinavian characters.
-Composite characters (overstrike) may be indicated with the
-@!<char1><char2> sequence, which will print the two characters on top of
-each other. To learn the octal codes for symbols not available on the
-keyboard and some accented European characters, see Section 4.16 and
-Appendix F in the GMT Technical Reference and Cookbook. Note that
-:ref:`PS_CHAR_ENCODING <PS_CHAR_ENCODING>` must be set to an extended character set in your
-:doc:`gmt.conf` file in order to use the accented characters. Using the
-**-G** or **-W** options, a rectangle underlying the text may be plotted
-(does not work for strings with sub/super scripts, symbols, or composite
-characters, except in paragraph mode (**-M**)).
-
-Required Arguments
-------------------
-
-.. include:: explain_-J.rst_
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-R.rst_
-
-.. |Add_-Rz| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-Rz.rst_
-
-Optional Arguments
-------------------
-
-*textfiles*
- This is one or more files containing 1 or more records with (*x*,
- *y*\ [, *font*, *angle*, *justify*], *text*). The attributes in
- brackets can alternatively be set directly via **-F**. If no files
- are given, **pstext** will read standard input. *font* is a font
- specification with format [*size*,][\ *font*,][*color*\ ] where
- *size* is text size in points, *font* is the font to use, and
- *color* sets the font color. To draw outline fonts you append
- =\ *pen* to the font specification. The *angle* is measured in degrees
- counter-clockwise from horizontal, and *justify* sets the alignment.
- If *font* is not an integer, then it is taken to be a text string
- with the desired fontname (see **-L** for available fonts). The
- alignment refers to the part of the text string that will be mapped
- onto the (*x*,\ *y*) point. Choose a 2 character combination of L,
- C, R (for left, center, or right) and T, M, B for top, middle, or
- bottom. e.g., BL for lower left.
-**-A**
- Angles are given as azimuths; convert them to directions using the
- current projection.
-
-.. include:: explain_-B.rst_
-
-**-C**\ *dx/dy*
- Sets the clearance between the text and the surrounding box [15%].
- Only used if **-W** or **-G** are specified. Append the unit you
- want (**c**\ m, **i**\ nch, or **p**\ oint; if not given we consult
- :ref:`PROJ_LENGTH_UNIT <PROJ_LENGTH_UNIT>`) or % for a percentage of the font size.
-
-**-D**\ [**j**\ \|\ **J**]\ *dx*\ [/*dy*][\ **v**\ [*pen*\ ]]
- Offsets the text from the projected (*x*,\ *y*) point by *dx*,\ *dy*
- [0/0]. If *dy* is not specified then it is set equal to *dx*. Use
- **-Dj** to offset the text away from the point instead (i.e., the
- text justification will determine the direction of the shift). Using
- **-DJ** will shorten diagonal offsets at corners by
- sqrt(2). Optionally, append **v** which will draw
- a line from the original point to the shifted point; append a *pen*
- to change the attributes for this line.
-
-**-F**\ [**+a**\ [*angle*]][\ **+c**\ [*justify*]][\ **+f**\ [*font*]][\ **+h**][\ **+j**\ [*justify*]][\ **+l**]
- By default, text will be placed horizontally, using the primary
- annotation font attributes (:ref:`FONT_ANNOT_PRIMARY <FONT_ANNOT_PRIMARY>`), and centered
- on the data point. Use this option to override these defaults by
- specifying up to three text attributes (font, angle, and
- justification) directly on the command line. Use **+f** to set the
- font (size,fontname,color); if no font info is given then the input
- file must have this information in one of its columns. Use **+a** to
- set the angle; if no angle is given then the input file must have
- this as a column. Use **+j** to set the justification; if no
- justification is given then the input file must have this as a
- column. Items read from the data file should be in the same order as
- specified with the **-F** option. Example:
- **-F**\ **+f**\ 12p,Helvetica-Bold,red\ **+j+a** selects a 12p red
- Helvetica-Bold font and expects to read the justification and angle
- from the file, in that order, after *x*, *y* and before *text*.
- In addition, the **+c** justification lets us use x,y coordinates extracted from the
- **-R** string instead of providing them in the input file. For example **-F+c**\ TL
- gets the *x_min*, *y_max* from the **-R** string and plots the text
- at the Upper Left corner of the map. Normally, the text to be plotted
- comes from the data record. Instead, use **+h** or **+l** to select the
- text as the most recent segment header or segment label, respectively in
- a multisegment input file.
-
-**-G**\ *color*
- Sets the shade or color used for filling the text box [Default is no
- fill]. Alternatively, use **-Gc** to plot the text and then use the
- text dimensions (and **-C**) to build clip paths and turn clipping on.
- This clipping can then be turned off later with psclip **-C**.
- To **not** plot the text but activate clipping, use **-GC** instead.
-
-.. include:: explain_-Jz.rst_
-
-.. include:: explain_-K.rst_
-
-**-L**
- Lists the font-numbers and font-names available, then exits.
-**-M**
- Paragraph mode. Files must be multiple segment files. Segments are
- separated by a special record whose first character must be *flag*
- [Default is **>**]. Starting in the 3rd column, we expect to find
- information pertaining to the typesetting of a text paragraph (the
- remaining lines until next segment header). The information expected
- is (*x y* [*font angle justify*\ ] *linespace parwidth parjust*),
- where *x y font angle justify* are defined above (*font*, *angle*,
- and *justify* can be set via **-F**), while *linespace* and
- *parwidth* are the linespacing and paragraph width, respectively.
- The justification of the text paragraph is governed by *parjust*
- which may be **l**\ (eft), **c**\ (enter), **r**\ (ight), or
- **j**\ (ustified). The segment header is followed by one or more
- lines with paragraph text. Text may contain the escape sequences
- discussed above. Separate paragraphs with a blank line. Note that
- here, the justification set via **-F+j** applies to the box alignment
- since the text justification is set by *parjust*.
-**-N**
- Do NOT clip text at map boundaries [Default will clip].
-
-.. include:: explain_-O.rst_
-
-.. include:: explain_-P.rst_
-
-**-Q**
- Change all text to either **l**\ ower or **u**\ pper case [Default
- leaves all text as is].
-**-T**
- Specify the shape of the textbox when using **-G** and/or **-W**.
- Choose lower case **o** to get a straight rectangle [Default].
- Choose upper case **O** to get a rounded rectangle. In paragraph
- mode (**-M**) you can also choose lower case **c** to get a concave
- rectangle or upper case **C** to get a convex rectangle.
-
-.. include:: explain_-U.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-W**\ *pen*
- Sets the pen used to draw a rectangle around the text string (see
- **-T**) [Default is width = default, color = black, style = solid].
-
-.. include:: explain_-XY.rst_
-
-**-Z**
- For 3-D projections: expect each item to have its own level given in
- the 3rd column, and **-N** is implicitly set. (Not implemented for
- paragraph mode).
-
-.. include:: explain_-aspatial.rst_
-
-.. include:: explain_-c.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_colon.rst_
-
-.. |Add_perspective| replace:: (Not implemented for paragraph mode).
-.. include:: explain_perspective.rst_
-
-.. include:: explain_-t.rst_
-
-.. include:: explain_help.rst_
-
-Examples
---------
-
-To plot just the red outlines of the (lon at text strings) stored in the
-file text.d on a Mercator plot with the given specifications, use
-
- ::
-
- gmt pstext text.d -R-30/30/-10/20 -Jm0.1i -P -F+f18p,Helvetica,-=0.5p,red -B5 > plot.ps
-
-To plot a text at the upper left corner of a 10 cm map
-
- ::
-
- echo TopLeft | gmt pstext -R1/10/1/10 -JX10 -F+cTL -P > plot.ps
-
-To add a typeset figure caption for a 3-inch wide illustration, use
-
- ::
-
- gmt pstext -R0/3/0/5 -JX3i -O -H -M -N << EOF >> figure.ps
-
-This is an optional header record
-
- ::
-
- > 0 -0.5 12 0 4 LT 13p 3i j
- @%5%Figure 1.@%% This illustration shows nothing useful, but it still needs
- a figure caption. Highlighted in @;255/0/0;red@;; you can see the locations
- of cities where it is @\_impossible@\_ to get any good Thai food; these are to be avoided.
- EOF
-
-Windows Remarks
----------------
-
-Note that under Windows, the percent sign (%) is a variable indicator
-(like $ under Unix). To indicate a plain percentage sign in a batch
-script you need to repeat it (%%); hence the font switching mechanism
-(@%*font*\ % and @%%) may require twice the number of percent signs.
-This only applies to text inside a script or that otherwise is processed
-by DOS. Data files that are opened and read by **pstext** do not need
-such duplication.
-
-Limitations
------------
-
-In paragraph mode, the presence of composite characters and other escape
-sequences may lead to unfortunate word splitting. Also, if a font is
-requested with an outline pen it will not be used in paragraph mode.
-Note if any single word is wider than your chosen paragraph width then
-the paragraph width is automatically enlarged to fit the widest word.
-
-The **-N** option does not adjust the BoundingBox information so you may
-have to post-process the PostScript output with ps2raster to obtain a
-correct BoundingBox.
-
-See Also
---------
-
-:doc:`gmt`, :doc:`gmt.conf`,
-:doc:`gmtcolors`,
-:doc:`ps2raster`,
-:doc:`psbasemap`,
-:doc:`pslegend`, :doc:`psxy`
diff --git a/doc_release/html/_sources/pswiggle.txt b/doc_release/html/_sources/pswiggle.txt
deleted file mode 100644
index 4e1d899..0000000
--- a/doc_release/html/_sources/pswiggle.txt
+++ /dev/null
@@ -1,183 +0,0 @@
-.. index:: ! pswiggle
-
-********
-pswiggle
-********
-
-.. only:: not man
-
- pswiggle - Plot z = f(x,y) anomalies along tracks
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**pswiggle** [ *table* ] **-J**\ *parameters*
-|SYN_OPT-Rz|
-[ **-Z**\ *scale* [ **-A**\ *azimuth* ]
-[ |SYN_OPT-B| ]
-[ **-C**\ *center* ]
-[ **-G**\ [**+**\ \|\ **-**\ \|\ **=**]\ *fill* ]
-[ **-Jz**\ \|\ **Z**\ *parameters* ] [ **-I**\ *fix\_az* ] [ **-K** ]
-[ **-O** ] [ **-P** ]
-[ **-S**\ [**x**\ ]\ *lon0*/*lat0*/*length*\ [/*units*] ] [ **-T**\ *pen* ]
-[ |SYN_OPT-U| ]
-[ |SYN_OPT-V| ]
-[ **-W**\ *pen* ] [
-[ |SYN_OPT-X| ]
-[ |SYN_OPT-Y| ]
-[ |SYN_OPT-bi| ]
-[ |SYN_OPT-c| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-g| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-p| ]
-[ |SYN_OPT-t| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**pswiggle** reads (*x*,\ *y*,\ *z*) triplets from files [or standard
-input] and plots z as a function of distance along track. This means
-that two consecutive (*x*,\ *y*) points define the local distance axis,
-and the local *z* axis is then perpendicular to the distance axis. The
-user may set a preferred positive anomaly plot direction, and if the
-positive normal is outside the plus/minus 90 degree window around the
-preferred direction, then 180 degrees are added to the direction. Either
-the positive or the negative wiggle may be shaded. The resulting
-PostScript code is written to standard output.
-
-Required Arguments
-------------------
-
-.. include:: explain_-J.rst_
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-R.rst_
-
-.. |Add_-Rz| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-Rz.rst_
-
-**-Z**\ *scale*
- Gives anomaly scale in data-units/distance-unit.
-
-Optional Arguments
-------------------
-
-.. |Add_intables| unicode:: 0x20 .. just an invisible code
-.. include:: explain_intables.rst_
-
-**-A**\ *azimuth*
- Sets the preferred positive azimuth. Positive wiggles will
- "gravitate" towards that direction.
-
-.. include:: explain_-B.rst_
-
-**-C**\ *center*
- Subtract *center* from the data set before plotting [0].
-**-G**\ [**+**\ \|\ **-**\ \|\ **=**]\ *fill*
- Set fill shade, color or pattern for positive and/or negative
- wiggles [Default is no fill]. Optionally, prepend **+** to fill
- positive areas (this is the default behavior). Prepend **-** to fill
- negative areas. Prepend **=** to fill both positive and negative
- areas with the same fill.
-**-I**\ *fix\_az*
- Set a fixed azimuth projection for wiggles [Default uses track
- azimuth, but see **-A**].
-
-.. include:: explain_-Jz.rst_
-
-.. include:: explain_-K.rst_
-
-.. include:: explain_-O.rst_
-
-.. include:: explain_-P.rst_
-
-**-S**\ [**x**\ ]\ *lon0*/*lat0*/*length*\ [/*units*]
- Draws a simple vertical scale centered on *lon0/lat0*. Use **-Sx**
- to specify cartesian coordinates instead. *length* is in z units,
- append unit name for labeling. **FONT\_ANNOT\_PRIMARY** is used as
- font.
-**-T**\ *pen*
- Draw track [Default is no track]. Append pen attributes to use
- [Defaults: width = 0.25p, color = black, style = solid].
-
-.. include:: explain_-U.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-W**\ *pen*
-
-.. |Add_-bi| replace:: [Default is 3 input columns].
-.. include:: explain_-bi.rst_
-
-.. include:: explain_-c.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-g| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-g.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. |Add_perspective| unicode:: 0x20 .. just an invisible code
-.. include:: explain_perspective.rst_
-
-.. include:: explain_-t.rst_
-
-.. include:: explain_colon.rst_
-
-.. include:: explain_help.rst_
-
-Examples
---------
-
-To plot the magnetic anomaly stored in the file track.xym along track @
-1000 nTesla/cm (after removing a mean value of 32000 nTesla), using a
-15-cm-wide Polar Stereographic map ticked every 5 degrees in Portrait
-mode, with positive anomalies in red on a blue track of width 0.25
-points, use
-
- ::
-
- gmt pswiggle track.xym -R-20/10/-80/-60 -JS0/90/15c -Z1000 -B5 \
- -C32000 -P -Gred -T0.25p,blue -S1000 -V > track_xym.ps
-
-Bugs
-----
-
-Sometimes the (x,y) coordinates are not printed with enough significant
-digits, so the local perpendicular to the track swings around a lot. To
-see if this is the problem, you should do this:
-
- ::
-
- awk '{ if (NR > 1) print atan2(y-$1, x-$2); y=$1; x=$2; }' yourdata.xyz | more
-
-(note that output is in radians; on some machines you need "nawk" to do
-this). Then if these numbers jump around a lot, you may do this:
-
- ::
-
- awk '{ print NR, $0 }' yourdata.xyz | filter1d -Fb5 -N4/0 \
- --FORMAT_FLOAT_OUT=%.12g > smoothed.xyz
-
-and plot this data set instead.
-
-See Also
---------
-
-:doc:`gmt`, :doc:`gmtcolors`,
-:doc:`filter1d`,
-:doc:`psbasemap`,
-:doc:`splitxyz`
diff --git a/doc_release/html/_sources/psxy.txt b/doc_release/html/_sources/psxy.txt
deleted file mode 100644
index e8a7e5a..0000000
--- a/doc_release/html/_sources/psxy.txt
+++ /dev/null
@@ -1,281 +0,0 @@
-.. index:: ! psxy
-
-****
-psxy
-****
-
-.. only:: not man
-
- psxy - Plot lines, polygons, and symbols on maps
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**psxy** [ *table* ] **-J**\ *parameters*
-|SYN_OPT-Rz|
-[ **-A**\ [**m**\ \|\ **p**] ]
-[ |SYN_OPT-B| ]
-[ **-C**\ *cptfile* ] [ **-D**\ *dx*/*dy* ]
-[ **-E**\ [**x**\ \|\ **y**\ \|\ **X**\ \|\ **Y**][**n**][*cap*][/[\ **-**\ \|\ **+**]\ *pen*] ]
-[ **-G**\ *fill* ] [ **-I**\ *intens* ]
-[ **-Jz**\ \|\ **Z**\ *parameters* ] [ **-K** ] [ **-L** ] [ **-N** ]
-[ **-O** ] [ **-P** ]
-[ **-S**\ [*symbol*][\ *size*\ [**u**] ]
-[ |SYN_OPT-U| ]
-[ |SYN_OPT-V| ]
-[ **-W**\ [**-**\ \|\ **+**][*pen*] ]
-[ |SYN_OPT-X| ]
-[ |SYN_OPT-Y| ]
-[ |SYN_OPT-a| ]
-[ |SYN_OPT-bi| ]
-[ **-c**\ *copies* ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-g| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-p| ]
-[ |SYN_OPT-t| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**psxy** reads (*x*,\ *y*) pairs from *files* [or standard input] and
-generates PostScript code that will plot lines, polygons, or symbols
-at those locations on a map. If a symbol is selected and no symbol size
-given, then **psxy** will interpret the third column of the input data
-as symbol size. Symbols whose *size* is <= 0 are skipped. If no symbols
-are specified then the symbol code (see **-S** below) must be present as
-last column in the input. If **-S** is not used, a line connecting the
-data points will be drawn instead. To explicitly close polygons, use
-**-L**. Select a fill with **-G**. If **-G** is set, **-W** will control
-whether the polygon outline is drawn or not. If a symbol is selected,
-**-G** and **-W** determines the fill and outline/no outline,
-respectively. The PostScript code is written to standard output.
-
-Required Arguments
-------------------
-
-.. include:: explain_-J.rst_
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-R.rst_
-
-.. |Add_-Rz| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-Rz.rst_
-
-Optional Arguments
-------------------
-
-.. |Add_intables| replace:: Use **-T** to ignore all input files, including standard input (see below).
-.. include:: explain_intables.rst_
-
-**-A**\ [**m**\ \|\ **p**]
- By default line segments are drawn as great circle arcs. To draw them as
- straight lines, use the **-A** flag. Alternatively, add **m** to draw
- the line by first following a meridian, then a parallel. Or append **p**
- to start following a parallel, then a meridian. (This can be practical
- to draw a line along parallels, for example).
-
-.. include:: explain_-B.rst_
-
-**-C**\ *cptfile*
- Give a color palette file. If **-S** is set, let symbol fill color be
- determined by the z-value in the third column. Additional fields are
- shifted over by one column (optional size would be 4th rather than 3rd
- field, etc.). If **-S** is not set, then **psxy** expects the user to
- supply a multisegment file where each segment header contains a
- **-Z**\ *val* string. The *val* will control the color of the line or
- polygon (if **-L** is set) via the cpt file.
-
-**-D**\ *dx*/*dy*
- Offset the plot symbol or line locations by the given amounts *dx/dy*
- [Default is no offset]. If *dy* is not given it is set equal to *dx*.
-
-**-E**\ [**x**\ \|\ **y**\ \|\ **X**\ \|\ **Y**][**n**][*cap*][/[\ **-**\ \|\ **+**]\ *pen*]
- Draw error bars. Append **x** and/or **y** to indicate which bars you
- want to draw (Default is both x and y). The x and/or y errors must be
- stored in the columns after the (x,y) pair [or (x,y,size) triplet]. The
- *cap* parameter indicates the length of the end-cap on the error bars
- [7\ **p**]. Pen attributes for error bars may also be set [Defaults: width
- = default, color = black, style = solid]. A leading **+** will use the
- lookup color (via **-C**) for both symbol fill and error pen color,
- while a leading **-** will set error pen color and turn off symbol fill.
- If upper case **X** and/or **Y** is used we will instead draw
- "box-and-whisker" (or "stem-and-leaf") symbols. The x (or y) coordinate
- is then taken as the median value, and 4 more columns are expected to
- contain the minimum (0% quantile), the 25% quantile, the 75% quantile,
- and the maximum (100% quantile) values. The 25-75% box may be filled by
- using **-G**. If **n** is appended to **X** (or **Y**) we draw a notched
- "box-and-whisker" symbol where the notch width reflects the uncertainty
- in the median. Then a 5th extra data column is expected to contain the
- number of points in the distribution.
-
-**-G**\ *fill*
- Select color or pattern for filling of symbols or polygons [Default is no fill].
- Note that **psxy** will search for **-G** and **-W** strings in all the
- segment headers and let any values thus found over-ride the command line settings.
-
-**-I**\ *intens*
- Use the supplied *intens* value (nominally in the -1 to + 1 range) to
- modulate the fill color by simulating illumination [none].
-
-.. include:: explain_-Jz.rst_
-
-.. include:: explain_-K.rst_
-
-**-L**
- Force closed polygons: connect the endpoints of the line-segment(s) and
- draw polygons. Also, in concert with **-C** and any **-Z** settings in
- the headers will use the implied color for polygon fill [Default is
- polygon pen color].
-
-**-N**
- Do NOT skip symbols that fall outside map border [Default plots points
- inside border only]. The option does not apply to lines and polygons
- which are always clipped to the map region.
-
-.. include:: explain_-O.rst_
-
-.. include:: explain_-P.rst_
-
-.. include:: explain_symbols.rst_
-
-**-T**
- Ignore all input files, including standard input. This is the same
- as specifying /dev/null (or NUL for Windows users) as input file.
- Use this to activate only the options that are not related to
- plotting of lines or symbols, such as **psxy** **-R** **-J** **-O**
- **-T** to terminate a sequence of GMT plotting commands without
- producing any plotting output.
-
-.. include:: explain_-U.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-W**\ [**-**\ \|\ **+**][*pen*] :ref:`(more ...) <-Wpen_attrib>`
- Set pen attributes for lines or the outline of symbols [Defaults:
- width = default, color = black, style = solid]. A leading **+** will
- use the lookup color (via **-C**) for both symbol fill and outline
- pen color, while a leading **-** will set outline pen color and turn
- off symbol fill.
-
-.. include:: explain_-XY.rst_
-
-.. |Add_-bi| replace:: [Default is the required number of columns given the chosen settings].
-.. include:: explain_-bi.rst_
-
-.. include:: explain_-aspatial.rst_
-
-.. include:: explain_-c.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-g| replace:: The **-g** option is ignored if **-S** is set.
-.. include:: explain_-g.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. include:: explain_colon.rst_
-
-.. |Add_perspective| unicode:: 0x20 .. just an invisible code
-.. include:: explain_perspective.rst_
-
-.. include:: explain_-t.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_vectors.rst_
-
-Examples
---------
-
-To plot solid red circles (diameter = 0.25 cm) at the positions listed
-in the file DSDP.xy on a Mercator map at 5 cm/degree of the area 150E to
-154E, 18N to 23N, with tickmarks every 1 degree and gridlines every 15
-minutes, use
-
- ::
-
- gmt psxy DSDP.xy R150/154/18/23 -Jm5c -Sc0.25c -Gred -B1g15m > map.ps
-
-To plot the xyz values in the file quakes.xyzm as circles with size
-given by the magnitude in the 4th column and color based on the depth in
-the third using the color palette cpt on a linear map, use
-
- ::
-
- gmt psxy quakes.xyzm -R0/1000/0/1000 -JX6i -Sc -Ccpt -B200 > map.ps
-
-To plot the file trench.xy on a Mercator map, with white triangles with
-sides 0.25 inch on the left side of the line, spaced every 0.8 inch, use
-
- ::
-
- gmt psxy trench.xy -R150/200/20/50 -Jm0.15i -Sf0.8i/0.1i+l+t -Gwhite -W -B10 > map.ps
-
-To plot the data in the file misc.d as symbols determined by the code in
-the last column, and with size given by the magnitude in the 4th column,
-and color based on the third column via the color palette cpt on a
-linear map, use
-
- ::
-
- gmt psxy misc.d -R0/100/-50/100 -JX6i -S -Ccpt -B20 > map.ps
-
-Segment Header Parsing
-----------------------
-
-Segment header records may contain one of more of the following options:
-
-**-G**\ *fill*
- Use the new *fill* and turn filling on
-**-G-**
- Turn filling off
-**-G**
- Revert to default fill (none if not set on command line)
-**-W**\ *pen*
- Use the new *pen* and turn outline on
-**-W**
- Revert to default pen :ref:`MAP_DEFAULT_PEN <MAP_DEFAULT_PEN>`
- (if not set on command line)
-**-W-**
- Turn outline off
-**-Z**\ *zval*
- Obtain fill via cpt lookup using z-value *zval*
-**-Z**\ *NaN*
- Get the NaN color from the cpt file
-
-Custom Symbols
---------------
-
-**psxy** allows users to define and plot their own custom symbols. This
-is done by encoding the symbol using our custom symbol macro code
-described in Appendix N. Put all the macro codes for your new symbol in
-a file whose extension must be .def; you may then address the symbol
-without giving the extension (e.g., the symbol file tsunami.def is used
-by specifying **-Sk**\ *tsunami/size*. The definition file can contain
-any number of plot code records, as well as blank lines and comment
-lines (starting with #). **psxy** will look for the definition files in
-(1) the current directory, (2) the ~/.gmt directory, and
-(3) the **$GMT_SHAREDIR**/custom directory, in that order.
-Freeform polygons (made up of straight line segments and arcs of
-circles) can be designed - these polygons can be painted and filled with
-a pattern. Other standard geometric symbols can also be used. See Appendix
-:ref:`App-custom_symbols` for macro definitions.
-
-See Also
---------
-
-:doc:`gmt`, :doc:`gmt.conf`,
-:doc:`gmtcolors`,
-:doc:`psbasemap`, :doc:`psxyz`
diff --git a/doc_release/html/_sources/psxyz.txt b/doc_release/html/_sources/psxyz.txt
deleted file mode 100644
index d0af388..0000000
--- a/doc_release/html/_sources/psxyz.txt
+++ /dev/null
@@ -1,241 +0,0 @@
-.. index:: ! psxyz
-
-*****
-psxyz
-*****
-
-.. only:: not man
-
- psxyz - Plot lines, polygons, and symbols in 3-D
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**psxyz** [ *table* ] **-J**\ *parameters*
-**-Jz**\ \|\ **Z**\ *parameters*
-|SYN_OPT-Rz|
-[ |SYN_OPT-B| ]
-[ **-D**\ *dx*/*dy*\ [/*dz*] ] [ **-G**\ *fill* ] [ **-I**\ *intens* ]
-[ **-K** ] [ **-L** ] [ **-N** ] [ **-O** ] [ **-P** ] [ **-Q** ]
-[ **-S**\ [*symbol*][\ *size*\ [**unit**]][/*size_y*] ]
-[ |SYN_OPT-U| ]
-[ |SYN_OPT-V| ]
-[ **-W**\ [**-**\ \|\ **+**][*pen*] ]
-[ |SYN_OPT-X| ]
-[ |SYN_OPT-Y| ]
-[ |SYN_OPT-a| ]
-[ |SYN_OPT-bi| ]
-[ |SYN_OPT-c| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-g| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-p| ]
-[ |SYN_OPT-t| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**psxyz** reads (x,y,z) triplets from *files* [or standard input] and
-generates PostScript code that will plot lines, polygons, or symbols
-at those locations in 3-D. If a symbol is selected and no symbol size
-given, then **psxyz** will interpret the fourth column of the input data
-as symbol size. Symbols whose *size* is <= 0 are skipped. If no symbols
-are specified then the symbol code (see **-S** below) must be present as
-last column in the input. If **-S** is not used, a line connecting the
-data points will be drawn instead. To explicitly close polygons, use
-**-L**. Select a fill with **-G**. If **-G** is set, **-W** will control
-whether the polygon outline is drawn or not. If a symbol is selected,
-**-G** and **-W** determines the fill and outline/no outline,
-respectively. The PostScript code is written to standard output.
-
-Required Arguments
-------------------
-
-.. include:: explain_-J.rst_
-
-.. include:: explain_-Jz.rst_
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-R.rst_
-
-.. |Add_-Rz| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-Rz.rst_
-
-Optional Arguments
-------------------
-
-.. |Add_intables| unicode:: 0x20 .. just an invisible code
-.. include:: explain_intables.rst_
-
-.. include:: explain_-B.rst_
-
-**-C**\ *cptfile*
- Give a color palette file. If **-S** is set, let symbol fill color be
- determined by the t-value in the fourth column. Additional fields are
- shifted over by one column (optional size would be in 5th rather than
- 4th field, etc.). If **-S** is not set, then **psxyz** expects the user
- to supply a multisegment file (where each segment header contains a
- **-Z**\ *val* string. The *val* will control the color of the line or
- polygon (if **-L** is set) via the cpt file.
-
-**-D**\ *dx*/*dy*\ [/*dz*]
- Offset the plot symbol or line locations by the given amounts
- *dx/dy*\ [*dz*\ ] [Default is no offset].
-
-**-G**\ *fill*
- Select color or pattern for filling of symbols or polygons [Default is no fill].
- Note that **psxyz** will search for **-G** and **-W** strings in all the
- segment headers and let any values thus found over-ride the command line settings.
-
-**-I**\ *intens*
- Use the supplied *intens* value (nominally in the -1 to + 1 range) to
- modulate the fill color by simulating illumination [none].
-
-.. include:: explain_-K.rst_
-
-**-L**
- Force closed polygons: connect the endpoints of the line-segment(s) and
- draw polygons. Also, in concert with **-C** and any **-Z** settings in
- the headers will use the implied color for polygon fill [Default is
- polygon pen color]. **-N** Do NOT skip symbols that fall outside map
- border [Default plots points inside border only].
-
-.. include:: explain_-O.rst_
-
-.. include:: explain_-P.rst_
-
-**-Q**
- Turn off the automatic sorting of items based on their distance from the
- viewer. The default is to sort the items so that items in the foreground
- are plotted after items in the background.
-
-.. include:: explain_symbols2.rst_
-
-.. include:: explain_-U.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-W**\ [**-**\ \|\ **+**][*pen*] :ref:`(more ...) <-Wpen_attrib>`
- Set pen attributes for lines or the outline of symbols [Defaults:
- width = default, color = black, style = solid]. A leading **+** will
- use the lookup color (via **-C**) for both symbol fill and outline
- pen color, while a leading **-** will set outline pen color and turn
- off symbol fill.
-
-.. include:: explain_-XY.rst_
-
-.. include:: explain_-aspatial.rst_
-
-.. |Add_-bi| replace:: [Default is the required number of columns given the chosen settings].
-.. include:: explain_-bi.rst_
-
-.. include:: explain_-c.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-g| replace:: The **-g** option is ignored if **-S** is set.
-.. include:: explain_-g.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-**-p**\ [**x**\ \|\ **y**\ \|\ **z**]\ *azim*/*elev*\ [/*zlevel*][\ **+w**\ *lon0*/*lat0*\ [/*z0*]][\ **+v**\ *x0*/*y0*] (\*)
- Select perspective view.
-
-.. include:: explain_-t.rst_
-
-.. include:: explain_colon.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_vectors.rst_
-
-Examples
---------
-
-To plot blue columns (width = 1.25 cm) at the positions listed in the
-file heights.xyz on a 3-D projection of the space (0-10), (0-10),
-(0-100), with tickmarks every 2, 2, and 10, viewing it from the
-southeast at 30 degree elevation, use:
-
- ::
-
- gmt psxyz heights.xyz -R0/10/0/10/0/100 -Jx1.25c -Jz0.125c -So1.25c \
- -Gblue -B2:XLABEL:/2:YLABEL:/10:ZLABEL::."3-D PLOT":15 -p135/30 \
- -Uc -W -P > heights.ps
-
-Segment Header Parsing
-----------------------
-
-Segment header records may contain one of more of the following options:
-
-**-G**\ *fill*
- Use the new *fill* and turn filling on
-**-G-**
- Turn filling off
-**-G**
- Revert to default fill (none if not set on command line)
-**-W**\ *pen*
- Use the new *pen* and turn outline on
-**-W**
- Revert to default pen :ref:`MAP_DEFAULT_PEN <MAP_DEFAULT_PEN>`
- (if not set on command line)
-**-W-**
- Turn outline off
-**-Z**\ *zval*
- Obtain fill via cpt lookup using z-value *zval*
-**-Z**\ *NaN*
- Get the NaN color from the cpt file
-
-Custom Symbols
---------------
-
-**psxyz** allows users to define and plot their own custom symbols. This
-is done by encoding the symbol using our custom symbol macro code
-described in Appendix N. Put all the macro codes for your new symbol in
-a file whose extension must be .def; you may then address the symbol
-without giving the extension (e.g., the symbol file tsunami.def is used
-by specifying **-Sk**\ *tsunami/size*. The definition file can contain
-any number of plot code records, as well as blank lines and comment
-lines (starting with #). **psxyz** will look for the definition files
-in (1) the current directory, (2) the ~/.gmt directory,
-and (3) the **$GMT\_SHAREDIR**/custom directory, in that
-order. Freeform polygons (made up of straight line segments and arcs of
-circles) can be designed - these polygons can be painted and filled with
-a pattern. Other standard geometric symbols can also be used. See Appendix
-:ref:`App-custom_symbols` for macro definitions.
-
-Bugs
-----
-
-No hidden line removal is employed for polygons and lines. Symbols,
-however, are first sorted according to their distance from the viewpoint
-so that nearby symbols will overprint more distant ones should they
-project to the same x,y position.
-
-**psxyz** cannot handle filling of polygons that contain the south or
-north pole. For such a polygon, make a copy and split it into two and
-make each explicitly contain the polar point. The two polygons will
-combine to give the desired effect when filled; to draw outline use the
-original polygon.
-
-The **-N** option does not adjust the BoundingBox information so you may
-have to post-process the PostScript output with :doc:`ps2raster` **-A**
-to obtain the correct BoundingBox.
-
-See Also
---------
-
-:doc:`gmt`, :doc:`gmt.conf`,
-:doc:`gmtcolors`,
-:doc:`psbasemap`, :doc:`psxy`
diff --git a/doc_release/html/_sources/sample1d.txt b/doc_release/html/_sources/sample1d.txt
deleted file mode 100644
index 1c57af6..0000000
--- a/doc_release/html/_sources/sample1d.txt
+++ /dev/null
@@ -1,176 +0,0 @@
-.. index:: ! sample1d
-
-********
-sample1d
-********
-
-.. only:: not man
-
- sample1d - Resample 1-D table data using splines
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**sample1d** [ *table* ]
-[ **-A**\ **f**\ \|\ **p**\ \|\ **m**\ \|\ **r**\ \|\ **R**\ [**+l**] ]
-[ **-Fl**\ \|\ **a**\ \|\ **c**\ \|\ **n** ] [ **-I**\ *inc*\ [*unit*] ]
-[ **-N**\ *knotfile* ] [ **-S**\ *start*\ [/*stop*] ] [ **-T**\ *col* ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-b| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-g| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-o| ]
-
-|No-spaces|
-
-Description
------------
-
-**sample1d** reads a multi-column ASCII [or binary] data set from file
-[or standard input] and interpolates the timeseries/profile at locations
-where the user needs the values. The user must provide the column number
-of the independent (monotonically increasing **or** decreasing)
-variable. Equidistant or arbitrary sampling can be selected. All columns
-are resampled based on the new sampling interval. Several interpolation
-schemes are available. Extrapolation outside the range of the input data
-is not supported.
-
-Required Arguments
-------------------
-
-None.
-
-Optional Arguments
-------------------
-
-*table*
- This is one or more ASCII [of binary, see
- **-bi**] files with one column containing the
- independent variable (which must be monotonically in/de-creasing)
- and the remaining columns holding other data values. If no file is
- provided, **sample1d** reads from standard input.
-**-A**\ **f**\ \|\ **p**\ \|\ **m**\ \|\ **r**\ \|\ **R**
- For track resampling (if **-T**...\ *unit* is set) we can select how
- this is to be performed. Append **f** to keep original points, but
- add intermediate points if needed; note this selection does not
- necessarily yield equidistant points [Default], **m** as **f**, but
- first follow meridian (along y) then parallel (along x), **p** as
- **f**, but first follow parallel (along y) then meridian (along x),
- **r** to resample at equidistant locations; input points are not
- necessarily included in the output, and **R** as **r**, but adjust
- given spacing to fit the track length exactly. Finally, append
- **+l** if distances should be measured along rhumb lines (loxodromes).
-**-Fl**\ \|\ **a**\ \|\ **c**\ \|\ **n**
- Choose from **l** (Linear), **a** (Akima spline), **c** (natural
- cubic spline), and **n** (no interpolation: nearest point) [Default
- is **-Fa**]. You may change the default interpolant; see
- :ref:`GMT_INTERPOLANT <GMT_INTERPOLANT>` in your :doc:`gmt.conf` file.
-**-I**\ *inc*\ [*unit*]
- *inc* defines the sampling interval [Default is the separation
- between the first and second abscissa point in the *infile*]. Append
- a distance unit (see UNITS) to indicate that the first two columns
- contain longitude, latitude and you wish to resample this path with
- a spacing of *inc* in the chosen units. For sampling of (x, y)
- Cartesian tracks, specify the unit as c. Use **-A** to control how
- path resampling is performed.
-**-N**\ *knotfile*
- *knotfile* is an optional ASCII file with the x locations where the
- data set will be resampled in the first column. Note: If **-H** is
- selected it applies to both *infile* and *knotfile*. Also note that
- **-i** never applies to *knotfile* since we always consider the
- first column only.
-**-S**\ *start*\ [*stop*]
- For equidistant sampling, *start* indicates the location of the
- first output value. [Default is the smallest even multiple of *inc*
- inside the range of *infile*]. Optionally, append /*stop* to
- indicate the location of the last output value [Default is the
- largest even multiple of *inc* inside the range of *infile*].
-**-T**\ *col*
- Sets the column number of the independent variable [Default is 0
- (first)].
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. |Add_-bi| replace:: [Default is 2 (or at least the number of columns implied by **-T**)].
-.. include:: explain_-bi.rst_
-
-.. |Add_-bo| replace:: [Default is same as input].
-.. include:: explain_-bo.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-g| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-g.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. include:: explain_-ocols.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_distunits.rst_
-
-.. include:: explain_precision.rst_
-
-Calendar Time Sampling
-----------------------
-
-If the abscissa are calendar times then you must use the **-f** option
-to indicate this. Furthermore, **-I** then expects an increment in the
-current :ref:`TIME_UNIT <TIME_UNIT>` units. There is not yet support for variable
-intervals such as months.
-
-Examples
---------
-
-To resample the file profiles.tdgmb, which contains
-(time,distance,gravity,magnetics,bathymetry) records, at 1km equidistant
-intervals using Akima's spline, use
-
- ::
-
- gmt sample1d profiles.tdgmb -I1 -Fa -T1 > profiles_equi_d.tdgmb
-
-To resample the file depths.dt at positions listed in the file
-grav_pos.dg, using a cubic spline for the interpolation, use
-
- ::
-
- gmt sample1d depths.dt -Ngrav_pos.dg -Fc > new_depths.dt
-
-To resample the file track.txt which contains lon, lat, depth every 2
-nautical miles, use
-
- ::
-
- gmt sample1d track.txt -I2n -AR > new_track.dt
-
-To do approximately the same, but make sure the original points are
-included, use
-
- ::
-
- gmt sample1d track.txt -I2n -Af > new_track.dt
-
-To obtain a rhumb line (loxodrome) sampled every 5 km instead, use
-
- ::
-
- gmt sample1d track.txt -I5k -AR+l > new_track.dt
-
-See Also
---------
-
-:doc:`gmt`,
-:doc:`gmt.conf`,
-:doc:`greenspline`,
-:doc:`filter1d`
diff --git a/doc_release/html/_sources/spectrum1d.txt b/doc_release/html/_sources/spectrum1d.txt
deleted file mode 100644
index 547a946..0000000
--- a/doc_release/html/_sources/spectrum1d.txt
+++ /dev/null
@@ -1,260 +0,0 @@
-.. index:: ! spectrum1d
-
-**********
-spectrum1d
-**********
-
-.. only:: not man
-
- spectrum1d - Compute auto- [and cross- ] spectra from one [or two] time-series
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**spectrum1d** [ *table* ] **-S**\ *segment\_size*] [
-**-C**\ [**xycnpago**\ ] ] [ **-D**\ *dt* ] [ **-L**\ [**h**\ \|\ **m**]
-] [ **-N**\ [**+**\ ]\ *name\_stem* ] [ |SYN_OPT-b| ] [ **-W** ]
-[ |SYN_OPT-b| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-g| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-
-|No-spaces|
-
-Description
------------
-
-**spectrum1d** reads X [and Y] values from the first [and second]
-columns on standard input [or *x[y]file*]. These values are treated as
-timeseries X(t) [Y(t)] sampled at equal intervals spaced *dt* units
-apart. There may be any number of lines of input. **spectrum1d** will
-create file[s] containing auto- [and cross- ] spectral density estimates
-by Welch's method of ensemble averaging of multiple overlapped windows,
-using standard error estimates from Bendat and Piersol.
-
-The output files have 3 columns: f or w, p, and e. f or w is the
-frequency or wavelength, p is the spectral density estimate, and e is
-the one standard deviation error bar size. These files are named based
-on *name\_stem*. If the **-C** option is used, up to eight files are
-created; otherwise only one (xpower) is written. The files (which are
-ASCII unless **-bo** is set) are as follows:
-
-*name\_stem*.xpower
- Power spectral density of X(t). Units of X \* X \* *dt*.
-*name\_stem*.ypower
- Power spectral density of Y(t). Units of Y \* Y \* *dt*.
-*name\_stem*.cpower
- Power spectral density of the coherent output. Units same as ypower.
-*name\_stem*.npower
- Power spectral density of the noise output. Units same as ypower.
-*name\_stem*.gain
- Gain spectrum, or modulus of the transfer function. Units of (Y /
- X).
-*name\_stem*.phase
- Phase spectrum, or phase of the transfer function. Units are
- radians.
-*name\_stem*.admit
- Admittance spectrum, or real part of the transfer function. Units of
- (Y / X).
-*name\_stem*.coh
- (Squared) coherency spectrum, or linear correlation coefficient as a
- function of frequency. Dimensionless number in [0, 1]. The
- Signal-to-Noise-Ratio (SNR) is coh / (1 - coh). SNR = 1 when coh = 0.5.
-
-Required Arguments
-------------------
-
-**-S**\ *segment\_size*]
- *segment\_size* is a radix-2 number of samples per window for
- ensemble averaging. The smallest frequency estimated is
- 1.0/(\ *segment\_size* \* *dt*), while the largest is 1.0/(2 \*
- *dt*). One standard error in power spectral density is approximately
- 1.0 / sqrt(\ *n\_data* / *segment\_size*), so if *segment\_size* =
- 256, you need 25,600 data to get a one standard error bar of 10%.
- Cross-spectral error bars are larger and more complicated, being a
- function also of the coherency.
-
-Optional Arguments
-------------------
-
-*table*
- One or more ASCII (or binary, see **-bi**)
- files holding X(t) [Y(t)] samples in the first 1 [or 2] columns. If
- no files are specified, **spectrum1d** will read from standard input.
-
-**-C**\ [**xycnpago**\ ]
- Read the first two columns of input as samples of two time-series,
- X(t) and Y(t). Consider Y(t) to be the output and X(t) the input in
- a linear system with noise. Estimate the optimum frequency response
- function by least squares, such that the noise output is minimized
- and the coherent output and the noise output are uncorrelated.
- Optionally specify up to 8 letters from the set { **x y c n p a g
- o** } in any order to create only those output files instead of the
- default [all]. **x** = xpower, **y** = ypower, **c** = cpower, **n**
- = npower, **p** = phase, **a** = admit, **g** = gain, **o** = coh.
-
-**-D**\ *dt*
- *dt* Set the spacing between samples in the time-series [Default = 1].
-
-**-L**
- Leave trend alone. By default, a linear trend will be removed prior
- to the transform. Alternatively, append **m** to just remove the
- mean value or **h** to remove the mid-value.
-
-**-N**\ [**+**]\ *name\_stem*
- *name\_stem* Supply the name stem to be used for output files
- [Default = "spectrum"]. To place all the computed output columns in
- a single table, use **-N+**.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-W**
- Write Wavelength rather than frequency in column 1 of the output
- file[s] [Default = frequency, (cycles / *dt*)].
-
-.. |Add_-bi| replace:: [Default is 2 input columns].
-.. include:: explain_-bi.rst_
-
-.. |Add_-bo| replace:: [Default is 2 output columns].
-.. include:: explain_-bo.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-g| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-g.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_precision.rst_
-
-Examples
---------
-
-Suppose data.g is gravity data in mGal, sampled every 1.5 km. To write
-its power spectrum, in mGal\*\*2-km, to the file data.xpower, use
-
- ::
-
- gmt spectrum1d data.g -S256 -D1.5 -Ndata
-
-Suppose in addition to data.g you have data.t, which is topography in
-meters sampled at the same points as data.g. To estimate various
-features of the transfer function, considering data.t as input and
-data.g as output, use
-
- ::
-
- paste data.t data.g | gmt spectrum1d -S256 -D1.5 -Ndata -C
-
-Tutorial
---------
-
-The output of spectrum1d is in units of power spectral density, and so to get units
-of data-squared you must divide by delta_t, where delta_t is the sample spacing.
-(There may be a factor of 2 pi somewhere, also. If you want to be sure of the
-normalization, you can determine a scale factor from Parseval's theorem: the sum of
-the squares of your input data should equal the sum of the squares of the outputs
-from spectrum1d, if you are simply trying to get a periodogram. [See below.])
-
-Suppose we simply take a data set, x(t), and compute the discrete Fourier transform
-(DFT) of the entire data set in one go. Call this X(f). Then suppose we form X(f)
-times the complex conjugate of X(f).
-
-P_raw(f) = X(f) * X'(f), where the ' indicates complex conjugation.
-
-P_raw is called the periodogram. The sum of the samples of the periodogram equals the
-sum of the samples of the squares of x(t), by Parseval's theorem. (If you use a DFT
-subroutine on a computer, usually the sum of P_raw equals the sum of x-squared, times M,
-where M is the number of samples in x(t).)
-
-Each estimate of X(f) is now formed by a weighted linear combination of all of the
-x(t) values. (The weights are sometimes called "twiddle factors" in the DFT literature.)
-So, no matter what the probability distribution for the x(t) values is, the probability
-distribution for the X(f) values approaches [complex] Gaussian, by the Central Limit
-Theorem. This means that the probability distribution for P_raw(f) approaches chi-squared
-with two degrees of freedom. That reduces to an exponential distribution, and the
-variance of the estimate of P_raw is proportional to the square of the mean, that is,
-the expected value of P_raw.
-
-In practice if we form P_raw, the estimates are hopelessly noisy. Thus P_raw is not useful,
-and we need to do some kind of smoothing or averaging to get a useful estimate, P_useful(f).
-
-There are several different ways to do this in the literature. One is to form P_raw and
-then smooth it. Another is to form the auto-covariance function of x(t), smooth, taper and
-shape it, and then take the Fourier transform of the smoothed, tapered and shaped auto-covariance.
-Another is to form a parametric model for the auto-correlation structure in x(t), then compute
-the spectrum of that model. This last approach is what is done in what is called the
-"maximum entropy" or "Berg" or "Box-Jenkins" or "ARMA" or "ARIMA" methods.
-
-Welch's method is a tried-and-true method. In his method, you choose a segment length,
-**-S**\ *N*, so that estimates will be made from segments of length *N*. The frequency samples
-(in cycles per delta_t unit) of your P_useful will then be at *k* /(*N* \* *delta_t*),
-where *k* is an integer, and you will get *N* samples (since the spectrum is an even
-function of *f*, only *N*/2 of them are really useful). If the length of your entire
-data set, x(t), is *M* samples long, then the variance in your P_useful will decrease
-in proportion to *N/M*. Thus you need to choose *N* << *M* to get very low noise and
-high confidence in P_useful. There is a trade-off here; see below.
-
-There is an additional reduction in variance in that Welch's method uses a Von Hann
-spectral window on each sample of length *N*. This reduces side lobe leakage and has
-the effect of smoothing the (*N* segment) periodogram as if the X(f) had been
-convolved with [1/4, 1/2, 1/4] prior to forming P_useful. But this slightly widens
-the spectral bandwidth of each estimate, because the estimate at frequency sample *k*
-is now a little correlated with the estimate at frequency sample k+1. (Of course this
-would also happen if you simply formed P_raw and then smoothed it.)
-
-Finally, Welch's method also uses overlapped processing. Since the Von Hann window is
-large in the middle and tapers to near zero at the ends, only the middle of the segment
-of length *N* contributes much to its estimate. Therefore in taking the next segment
-of data, we move ahead in the x(t) sequence only *N*/2 points. In this way, the next
-segment gets large weight where the segments on either side of it will get little weight,
-and vice versa. This doubles the smoothing effect and ensures that (if *N* << *M*)
-nearly every point in x(t) contributes with nearly equal weight in the final answer.
-
-Welch's method of spectral estimation has been widely used and widely studied. It is very
-reliable and its statistical properties are well understood. It is highly recommended in
-such textbooks as "Random Data: Analysis and Measurement Procedures" by Bendat and Piersol.
-
-In all problems of estimating parameters from data, there is a classic trade-off between
-resolution and variance. If you want to try to squeeze more resolution out of your data
-set, then you have to be willing to accept more noise in the estimates. The same trade-off
-is evident here in Welch's method. If you want to have very low noise in the spectral
-estimates, then you have to choose *N* << *M*, and this means that you get only *N*
-samples of the spectrum, and the longest period that you can resolve is only *N* \* *delta_t*.
-So you see that reducing the noise lowers the number of spectral samples and lowers the
-longest period. Conversely, if you choose *N* approaching *M*, then you approach the
-periodogram with its very bad statistical properties, but you get lots of samples and
-a large fundamental period.
-
-The other spectral estimation methods also can do a good job. Welch's method was selected
-because the way it works, how one can code it, and its effects on statistical distributions,
-resolution, side-lobe leakage, bias, variance, etc. are all easily understood. Some of the
-other methods (e.g. Maximum Entropy) tend to hide where some of these trade-offs are
-happening inside a "black box".
-
-
-See Also
---------
-
-:doc:`gmt`, :doc:`grdfft`
-
-References
-----------
-
-Bendat, J. S., and A. G. Piersol, 1986, Random Data, 2nd revised ed.,
-John Wiley & Sons.
-
-Welch, P. D., 1967, The use of Fast Fourier Transform for the estimation
-of power spectra: a method based on time averaging over short, modified
-periodograms, IEEE Transactions on Audio and Electroacoustics, Vol
-AU-15, No 2.
diff --git a/doc_release/html/_sources/sph2grd.txt b/doc_release/html/_sources/sph2grd.txt
deleted file mode 100644
index bb32953..0000000
--- a/doc_release/html/_sources/sph2grd.txt
+++ /dev/null
@@ -1,120 +0,0 @@
-.. index:: ! sph2grd
-
-*******
-sph2grd
-*******
-
-.. only:: not man
-
- sph2grd - Compute grid from spherical harmonic coefficients
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**sph2grd** [ *table* ] **-G**\ *grdfile*
-|SYN_OPT-I|
-|SYN_OPT-R|
-[ **-D**\ [**g**\ \|\ **n**] ]
-[ **-E** ] [ **-F**\ [**k**]\ *filter* ] [ **-N**\ [*norm*] ] [ **-Q** ] [ |SYN_OPT-V| ]
-[ |SYN_OPT-bi| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ **-r** ]
-
-|No-spaces|
-
-Description
------------
-
-**sph2grd** reads a spherical harmonics coefficient table with records of
-L, M, C[L,M], S[L,M] and evaluates the spherical harmonic model on the specified grid.
-
-Required Arguments
-------------------
-
-**-G**\ *grdfile*
- *grdfile* is the name of the binary output grid file. (See GRID FILE FORMAT below.)
-
-.. include:: explain_-I.rst_
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-R.rst_
-
-Optional Arguments
-------------------
-
-*table*
- One or more ASCII [or binary, see **-bi**]
- files holding the spherical harmonic coefficients. We expect the
- first four columns to hold the degree L, the order M, followed by
- the cosine and sine coefficients.
-**-D**\ [**g**\ \|\ **n**]
- Will evaluate a derived field from a geopotential model. Choose
- between **Dg** which will compute the gravitational field or **Dn**
- to compute the geoid [Add **-E** for anomalies on the ellipsoid].
-**-E**
- Evaluate expansion on the current ellipsoid [Default is sphere].
-**-F**\ [**d**]\ *filter*
- Filter coefficients according to one of two kinds of filter
- specifications:. Select **-Fk** if values are given in km
- [Default is coefficient harmonic degree L]. a) Cosine band-pass: Append
- four wavelengths *lc/lp/hp/hc*. Coefficients outside *lc/hc* are
- cut; those inside *lp/hp* are passed, while the rest are tapered.
- Replace wavelength by - to skip, e.g., **-F**-/-/50/75 is a
- low-pass filter. b) Gaussian band-pass: Append two wavelengths
- *lo/hi* where filter amplitudes = 0.5. Replace wavelength by -
- to skip, e.g., **-F**\ 70/- is a high-pass Gaussian filter.
-**-N**\ [*norm*]
- Normalization used for coefficients. Choose among **m**: Mathematical
- normalization - inner products summed over surface equal 1 [Default].
- **g** Geodesy normalization - inner products summed over surface
- equal 4pi. **s**: Schmidt normalization - as used in geomagnetism.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. |Add_-bi| replace:: [Default is 4 input columns].
-.. include:: explain_-bi.rst_
-
-.. |Add_-h| replace:: Not used with binary data.
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. |Add_nodereg| unicode:: 0x20 .. just an invisible code
-.. include:: explain_nodereg.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_float.rst_
-
-.. include:: explain_grd_output.rst_
-
-.. include:: explain_grd_coord.rst_
-
-Examples
---------
-
-To create a 1 x 1 degree global grid file from the ASCII
-coefficients in EGM96_to_360.txt, use
-
- ::
-
- gmt sph2grd EGM96_to_360.txt -GEGM96_to_360.nc -Rg -I1 -V
-
-Reference
----------
-
-Holmes, S. A., and Featherstone, W. E., 2002, A unified approach to
-the Clenshaw summation and the recursive computation of very high
-degree and order normalized associated Legendre functions:
-*J. Geodesy, v. 76, p. 279–299*.
-
-See Also
---------
-
-:doc:`gmt`,
-:doc:`grdfft`,
-:doc:`grdmath`
diff --git a/doc_release/html/_sources/sphdistance.txt b/doc_release/html/_sources/sphdistance.txt
deleted file mode 100644
index 882d781..0000000
--- a/doc_release/html/_sources/sphdistance.txt
+++ /dev/null
@@ -1,138 +0,0 @@
-.. index:: ! sphdistance
-
-***********
-sphdistance
-***********
-
-.. only:: not man
-
- sphdistance - Make grid of distances to nearest points on a sphere
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**sphdistance** [ *table* ] **-G**\ *grdfile* [ **-C** ] [ **-E** ]
-[ |SYN_OPT-I| ]
-[ **-L**\ *unit* ] [ **-Q**\ *voronoi.txt* ]
-[ |SYN_OPT-R| ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-b| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ **-r** ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**sphdistance** reads one or more ASCII [or binary] files (or standard
-input) containing lon, lat and performs the construction of Voronoi
-polygons. These polygons are then processed to calculate the nearest
-distance to each node of the lattice and written to the specified grid.
-The Voronoi algorithm used is STRIPACK. As an option, you may provide
-pre-calculated Voronoi polygon file in the format written by
-:doc:`sphtriangulate`, thus bypassing the memory- and time-consuming
-triangularization.
-
-Required Arguments
-------------------
-
-**-G**\ *grdfile*
- Name of the output grid to hold the computed distances.
-
-Optional Arguments
-------------------
-
-.. |Add_intables| unicode:: 0x20 .. just an invisible code
-.. include:: explain_intables.rst_
-
-**-C**
- For large data sets you can save some memory (at the expense of more
- processing) by only storing one form of location coordinates
- (geographic or Cartesian 3-D vectors) at any given time, translating
- from one form to the other when necessary [Default keeps both arrays
- in memory]. Not applicable with **-Q**.
-**-E**
- Instead of computing distances, return the ID numbers of the Voronoi
- polygons that each grid node is inside [Default computes distances].
-
-.. include:: explain_-I.rst_
-
-**-L**\ *unit*
- Specify the unit used for distance calculations. Choose among **d**
- (spherical degree), **e** (m), **f** (feet), **k** (km), **M**
- (mile), **n** (nautical mile) or **u** survey foot. A spherical
- approximation is used unless :ref:`PROJ_ELLIPSOID <Projection Parameters>` is set to an actual
- ellipsoid.
-
-**-N**
- Read the information pertaining to each Voronoi
- polygon (the unique node lon, lat and polygon area) from a separate
- file [Default acquires this information from the ASCII segment
- headers of the output file]. Required if binary input via **-Q** is used.
-
-**-Q**\ *voronoi.txt*
- Append the name of a file with pre-calculated Voronoi polygons
- [Default performs the Voronoi construction on input data]. For
- binary data **-bi** you must specify the node
- information separately (via **-N**).
-
-.. |Add_-Rgeo| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-Rgeo.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. |Add_-bi| replace:: [Default is 2 input columns].
-.. include:: explain_-bi.rst_
-
-.. |Add_-bo| replace:: [Default is same as input].
-.. include:: explain_-bo.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. |Add_nodereg| unicode:: 0x20 .. just an invisible code
-.. include:: explain_nodereg.rst_
-
-.. include:: explain_colon.rst_
-.. include:: explain_help.rst_
-.. include:: explain_precision.rst_
-.. include:: explain_float.rst_
-
-Examples
---------
-
-To construct Voronoi polygons from the points in the file testdata.txt
-and then calculate distances from the data to a global 1x1 degree grid, use
-
- ::
-
- gmt sphdistance testdata.txt -Rg -I1 -Gglobedist.nc
-
-To generate the same grid in two steps using **sphtriangulate** separately, try
-
- ::
-
- gmt sphtriangulate testdata.txt -Qv > voronoi.txt
- gmt sphdistance -Qvoronoi.txt -Rg -I1 -Gglobedist.nc
-
-See Also
---------
-
-:doc:`gmt`,
-:doc:`sphtriangulate`,
-:doc:`triangulate`
-
-References
-----------
-
-Renka, R, J., 1997, Algorithm 772: STRIPACK: Delaunay Triangulation and
-Voronoi Diagram on the Surface of a Sphere, *AMC Trans. Math. Software*,
-**23**\ (3), 416-434.
diff --git a/doc_release/html/_sources/sphinterpolate.txt b/doc_release/html/_sources/sphinterpolate.txt
deleted file mode 100644
index 1f9e297..0000000
--- a/doc_release/html/_sources/sphinterpolate.txt
+++ /dev/null
@@ -1,135 +0,0 @@
-.. index:: ! sphinterpolate
-
-**************
-sphinterpolate
-**************
-
-.. only:: not man
-
- sphinterpolate - Spherical gridding in tension of data on a sphere
-
-`Synopsis <#toc1>`_
--------------------
-
-.. include:: common_SYN_OPTs.rst_
-
-**sphinterpolate** [ *table* ] **-G**\ *grdfile*
-[ |SYN_OPT-I| ]
-[ **-Q**\ *mode*\ [/*options*] ]
-[ |SYN_OPT-R| ]
-[ |SYN_OPT-V| ]
-[ **-Z** ]
-[ |SYN_OPT-b| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ **-r** ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**sphinterpolate** reads one or more ASCII [or binary] files (or
-standard input) containing lon, lat, f and performs a Delaunay
-triangulation to set up a spherical interpolation in tension. The final
-grid is saved to the specified file. Several options may be used to
-affect the outcome, such as choosing local versus global gradient
-estimation or optimize the tension selection to satisfy one of four
-criteria.
-
-Required Arguments
-------------------
-
-**-G**\ *grdfile*
- Name of the output grid to hold the interpolation.
-
-Optional Arguments
-------------------
-
-.. |Add_intables| unicode:: 0x20 .. just an invisible code
-.. include:: explain_intables.rst_
-
-.. include:: explain_-I.rst_
-
-**-Q**\ *mode*\ [/*options*]
- Specify one of four ways to calculate tension factors to preserve
- local shape properties or satisfy arc constraints [Default is no
- tension].
-**-Q**\ 0
- Piecewise linear interpolation; no tension is applied.
-**-Q**\ 1
- Smooth interpolation with local gradient estimates.
-**-Q**\ 2
- Smooth interpolation with global gradient estimates. You may
- optionally append /*N*/*M*/*U*, where *N* is the number of
- iterations used to converge at solutions for gradients when variable
- tensions are selected (e.g., **-T** only) [3], *M* is the number of
- Gauss-Seidel iterations used when determining the global gradients
- [10], and *U* is the maximum change in a gradient at the last
- iteration [0.01].
-**-Q**\ 3
- Smoothing. Optionally append */E/U* [/0/0], where *E* is Expected
- squared error in a typical (scaled) data value, and *U* is Upper
- bound on weighted sum of squares of deviations from data.
-
-.. |Add_-Rgeo| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-Rgeo.rst_
-
-**-T**
- Use variable tension (ignored with **-Q**\ 0 [constant]
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-Z**
- Before interpolation, scale data by the maximum data range [no
- scaling].
-
-.. |Add_-bi| replace:: [Default is 3 input columns].
-.. include:: explain_-bi.rst_
-
-.. |Add_-bo| replace:: [Default is same as input].
-.. include:: explain_-bo.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_colon.rst_
-
-.. |Add_nodereg| unicode:: 0x20 .. just an invisible code
-.. include:: explain_nodereg.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_precision.rst_
-
-Examples
---------
-
-To interpolate the points in the file testdata.txt on a global 1x1
-degree grid with no tension, use
-
- sphinterpolate testdata.txt -Rg -I1 -Gsolution.nc
-
-See Also
---------
-
-:doc:`gmt`,
-:doc:`greenspline`,
-:doc:`nearneighbor`,
-:doc:`sphdistance`,
-:doc:`sphtriangulate`,
-:doc:`surface`,
-:doc:`triangulate`
-
-`References <#toc10>`_
-----------------------
-
-Renka, R, J., 1997, Algorithm 772: STRIPACK: Delaunay Triangulation and
-Voronoi Diagram on the Surface of a Sphere, *AMC Trans. Math. Software*,
-**23**\ (3), 416-434.
-
-Renka, R, J,, 1997, Algorithm 773: SSRFPACK: Interpolation of scattered
-data on the Surface of a Sphere with a surface under tension, *AMC
-Trans. Math. Software*, **23**\ (3), 435-442.
diff --git a/doc_release/html/_sources/sphtriangulate.txt b/doc_release/html/_sources/sphtriangulate.txt
deleted file mode 100644
index 036c21b..0000000
--- a/doc_release/html/_sources/sphtriangulate.txt
+++ /dev/null
@@ -1,141 +0,0 @@
-.. index:: ! sphtriangulate
-
-**************
-sphtriangulate
-**************
-
-.. only:: not man
-
- sphtriangulate - Delaunay or Voronoi construction of spherical lon,lat data
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**sphtriangulate** [ *table* ] [ **-A** ] [ **-C** ] [ **-D** ]
-[ **-L**\ *unit* ] [ **-N**\ *nfile* ] [ **-Q**\ **d**\ \|\ **v** ]
-[ **-T** ] [ |SYN_OPT-V| ]
-[ |SYN_OPT-b| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**sphtriangulate** reads one or more ASCII [or binary] files (or
-standard input) containing lon, lat and performs a spherical Delaunay
-triangulation, i.e., it find how the points should be connected to give
-the most equilateral triangulation possible on the sphere. Optionally,
-you may choose **-Qv** which will do further processing to obtain the
-Voronoi polygons. Normally, either set of polygons will be written as
-fillable segment output; use **-T** to write unique arcs instead. As an
-option, compute the area of each triangle or polygon. The algorithm used
-is STRIPACK.
-
-Required Arguments
-------------------
-
-None.
-
-Optional Arguments
-------------------
-
-.. |Add_intables| unicode:: 0x20 .. just an invisible code
-.. include:: explain_intables.rst_
-
-**-A**
- Compute the area of the spherical triangles (**-Qd**) or polygons
- (**-Qv**) and write the areas (in chosen units; see **-L**) in the
- output segment headers [no areas calculated].
-
-**-C**
- For large data set you can save some memory (at the expense of more
- processing) by only storing one form of location coordinates
- (geographic or Cartesian 3-D vectors) at any given time, translating
- from one form to the other when necessary [Default keeps both arrays in memory].
-
-**-D**
- Used with **-m** to skip the last (repeated) input vertex at the end
- of a closed segment if it equals the first point in the segment.
- Requires **-m** [Default uses all points].
-
-**-L**\ *unit*
- Specify the unit used for distance and area calculations. Choose
- among **e** (m), **f** (foot), **k** (km), **m** (mile), **n**
- (nautical mile), **u** (survey foot), or **d** (spherical degree). A
- spherical approximation is used unless :ref:`PROJ_ELLIPSOID <PROJ_ELLIPSOID>` is set to
- an actual ellipsoid, in which case we convert latitudes to authalic
- latitudes before calculating areas. When degree is selected the
- areas are given in steradians.
-
-**-N**\ *nfile*
- Write the information pertaining to each polygon (for Delaunay: the
- three node number and the triangle area (if **-A** was set); for
- Voronoi the unique node lon, lat and polygon area (if **-A** was
- set)) to a separate file. This information is also encoded in the
- segment headers of ASCII output files]. Required if binary output is needed.
-
-**d**\ \|\ **v**
- Select between **d**\ elaunay or **v**\ oronoi mode [Delaunay].
-
-**-T**
- Write the unique arcs of the construction [Default writes fillable
- triangles or polygons]. When used with **-A** we store arc lenght in
- the segment header in chosen unit (see **-L**).
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. |Add_-bi| replace:: [Default is 2 input columns].
-.. include:: explain_-bi.rst_
-
-.. |Add_-bo| replace:: [Default is same as input].
-.. include:: explain_-bo.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_colon.rst_
-
-.. |Add_nodereg| unicode:: 0x20 .. just an invisible code
-.. include:: explain_nodereg.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_precision.rst_
-
-Examples
---------
-
-To triangulate the points in the file testdata.txt, and make a Voronoi
-diagram via :doc:`psxy`, use
-
- ::
-
- gmt sphtriangulate testdata.txt -Qv | psxy -Rg -JG30/30/6i -L -P -W1p -B0g30 | gv -
-
-To compute the optimal Delaunay triangulation network based on the
-multiple segment file globalnodes.d and save the area of each triangle
-in the header record, try
-
- ::
-
- gmt sphtriangulate globalnodes.d -Qd -A > global_tri.d
-
-See Also
---------
-
-:doc:`gmt`,
-:doc:`triangulate`,
-:doc:`sphdistance`
-
-References
-----------
-
-Renka, R, J., 1997, Algorithm 772: STRIPACK: Delaunay Triangulation and
-Voronoi Diagram on the Surface of a Sphere, *AMC Trans. Math. Software*,
-**23**\ (3), 416-434.
diff --git a/doc_release/html/_sources/splitxyz.txt b/doc_release/html/_sources/splitxyz.txt
deleted file mode 100644
index 948645f..0000000
--- a/doc_release/html/_sources/splitxyz.txt
+++ /dev/null
@@ -1,177 +0,0 @@
-.. index:: ! splitxyz
-
-********
-splitxyz
-********
-
-.. only:: not man
-
- splitxyz - Split xyz[dh] data tables into individual segments
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**splitxyz** [ *table* ]
-[ **-A**\ *azimuth*/*tolerance* ] [**-C**\ *course_change*] [ **-D**\ *minimum_distance* ]
-[ **-F**\ *xy\_filter*/*z\_filter* ] [ **-N**\ *template* ]
-[ **-Q**\ *flags* ] [ **-S** ] [ |SYN_OPT-V| ]
-[ |SYN_OPT-b| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-g| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**splitxyz** reads a series of (x,y[,z]) records [or optionally
-(x,y,z,d,h); see **-S** option] from standard input [or *xyz[dh]file*]
-and splits this into separate lists of (x,y[,z]) series, such that each
-series has a nearly constant azimuth through the x,y plane. There are
-options to choose only those series which have a certain orientation, to
-set a minimum length for series, and to high- or low-pass filter the z
-values and/or the x,y values. **splitxyz** is a useful filter between
-data extraction and :doc:`pswiggle` plotting, and can also be used to
-divide a large x,y[,z] dataset into segments.
-
-Required Arguments
-------------------
-
-none.
-
-Optional Arguments
-------------------
-
-*table*
- One or more ASCII [or binary, see **-bi**]
- files with 2, 3, or 5 columns holding (x,y,[z[,d,h]])
- data values. To use (x,y,z,d,h) input, sorted so that d is
- non-decreasing, specify the **-S** option; default expects (x,y,z)
- only. If no files are specified, **splitxyz** will read from
- standard input.
-**-A**\ *azimuth*/*tolerance*
- Write out only those segments which are within +/- *tolerance*
- degrees of *azimuth* in heading, measured clockwise from North, [0 -
- 360]. [Default writes all acceptable segments, regardless of
- orientation].
-**-C**\ *course\_change*
- Terminate a segment when a course change exceeding *course\_change*
- degrees of heading is detected [ignore course changes].
-**-D**\ *minimum\_distance*
- Do not write a segment out unless it is at least *minimum\_distance*
- units long [0]
-**-F**\ *xy\_filter*/*z\_filter*
- Filter the z values and/or the x,y values, assuming these are
- functions of d coordinate. *xy\_filter* and *z\_filter* are filter
- widths in distance units. If a filter width is zero, the filtering
- is not performed. The absolute value of the width is the full width
- of a cosine-arch low-pass filter. If the width is positive, the data
- are low-pass filtered; if negative, the data are high-pass filtered
- by subtracting the low-pass value from the observed value. If
- *z\_filter* is non-zero, the entire series of input z values is
- filtered before any segmentation is performed, so that the only edge
- effects in the filtering will happen at the beginning and end of the
- complete data stream. If *xy\_filter* is non-zero, the data is first
- divided into segments and then the x,y values of each segment are
- filtered separately. This may introduce edge effects at the ends of
- each segment, but prevents a low-pass x,y filter from rounding off
- the corners of track segments. [Default = no filtering].
-**-N**\ *template*
- Write each segment to a separate output file [Default writes a
- multiple segment file to stdout]. Append a format template for the
- individual file names; this template **must** contain a C format
- specifier that can format an integer argument (the running segment
- number across all tables); this is usually %d but could be %08d
- which gives leading zeros, etc. [Default is
- splitxyz\_segment\_%d.{txt\|bin}, depending on
- **-bo**]. Alternatively, give a template with
- two C format specifiers and we will supply the table number and the
- segment number within the table to build the file name.
-**-Q**\ *flags*
- Specify your desired output using any combination of *xyzdh*, in any
- order. Do not space between the letters. Use lower case. The output
- will be ASCII (or binary, see **-bo**)
- columns of values corresponding to *xyzdh* [Default is
- **-Q**\ *xyzdh* (**-Q**\ *xydh* if only 2 input columns)].
-**-S**
- Both d and h are supplied. In this case, input contains x,y,z,d,h.
- [Default expects (x,y,z) input, and d,h are computed from delta x,
- delta y. Use **-fg** to indicate map data; then x,y are assumed to
- be in degrees of longitude, latitude, distances are considered to be
- in kilometers, and angles are actually azimuths. Otherwise,
- distances are Cartesian in same units as x,y and angles are
- counter-clockwise from horizontal].
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-.. |Add_-bi| replace:: [Default is 2, 3, or 5 input columns as set by **-S**].
-.. include:: explain_-bi.rst_
-
-.. |Add_-bo| replace:: [Default is 1-5 output columns as set by **-Q**].
-.. include:: explain_-bo.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-g| replace:: Do not let a segment have a gap exceeding *gap*; instead, split it into two segments. [Default ignores gaps].
-.. include:: explain_-g.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. include:: explain_colon.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_precision.rst_
-
-Distance Calculations
----------------------
-
-The type of input data is dictated by the **-f** option. If **-fg** is
-given then x,y are in degrees of longitude, latitude, distances are in
-kilometers, and angles are azimuths. Otherwise, distances are Cartesian
-in same units as x,y and angles are counter-clockwise from horizontal.
-
-Examples
---------
-
-Suppose you want to make a wiggle plot of magnetic anomalies on segments
-oriented approximately east-west from a NGDC-supplied cruise called JA020015 in the
-region **-R**\ 300/315/12/20. You want to use a 100 km low-pass filter to
-smooth the tracks and a 500km high-pass filter to detrend the magnetic
-anomalies. Try this:
-
- ::
-
- gmt mgd77list JA020015 -R300/315/12/20 -Flon,lat,mag,dist,azim | gmt splitxyz -A90/15 -F100/-500 \
- -D100 -S -V -fg | gmt pswiggle -R300/315/12/20 -Jm0.6i -Baf -B+tJA020015 -T1 \
- -W0.75p -Ggray -Z200 > JA020015_wiggles.ps
-
-MGD-77 users: For this application we recommend that you extract dist,azim
-from :doc:`mgd77list <supplements/mgd77/mgd77list>` rather than have
-**splitxyz** compute them separately.
-
-Suppose you have been given a binary, double-precision file containing
-lat, lon, gravity values from a survey, and you want to split it into
-profiles named *survey*\ \_\ *###.txt* (when gap exceeds 100 km). Try this:
-
- ::
-
- gmt splitxyz survey.bin -Nsurvey_%03d.txt -V -gd100k -D100 -: -fg -bi3d
-
-See Also
---------
-
-:doc:`gmt`,
-:doc:`filter1d`,
-:doc:`mgd77list <supplements/mgd77/mgd77list>`,
-:doc:`pswiggle`
diff --git a/doc_release/html/_sources/supplements/gshhg/gshhg.txt b/doc_release/html/_sources/supplements/gshhg/gshhg.txt
deleted file mode 100644
index 1d92fee..0000000
--- a/doc_release/html/_sources/supplements/gshhg/gshhg.txt
+++ /dev/null
@@ -1,179 +0,0 @@
-.. index:: ! gshhg
-
-*****
-gshhg
-*****
-
-.. only:: not man
-
- gshhg - Extract data tables from binary GSHHG or WDBII data files
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**gshhg** *binaryfile.b* [ **-A**\ *min* ] [ **-G** ] [ **-I**\ *id* ]
-[ **-L** ] [ **-N**\ *level* ] [ **-Qe**\ \|\ **i** ]
-[ |SYN_OPT-bo| ]
-[ |SYN_OPT-o| ] > *asciifile.txt*
-
-|No-spaces|
-
-Description
------------
-
-**gshhg** reads the binary coastline (GSHHG) or political boundary or
-river (WDBII) files and extracts an ASCII listing. It automatically
-handles byte-swabbing between different architectures. Optionally, only
-segment header info can be displayed. The header info has the format *ID
-npoints hierarchical-level source area f\_area west east south north
-container ancestor*, where hierarchical levels for coastline polygons go
-from 1 (shoreline) to 4 (lake inside island inside lake inside land).
-Source is either W (World Vector Shoreline) or C (CIA World Data Bank
-II); lower case is used if a lake is a river-lake. The *west east south
-north* is the enclosing rectangle, *area* is the polygon area in km^2
-while *f\_area* is the actual area of the ancestor polygon, *container*
-is the ID of the polygon that contains this polygon (-1 if none), and
-*ancestor* is the ID of the polygon in the full resolution set that was
-reduced to yield this polygon (-1 if full resolution since there is no
-ancestor). For line data the header is simply *ID npoints
-hierarchical-level source west east south north*. For more information
-about the file formats, see TECHNICAL INFORMATION below.
-
-Required Arguments
-------------------
-
-*binaryfile.b*
- GSHHG or WDBII binary data file as distributed with the GSHHG data
- supplement. Any of the 5 standard resolutions (full, high,
- intermediate, low, crude) can be used.
-
-Optional Arguments
-------------------
-
-**-A**\ *min*
- Only output information for the polygon if its area equals or
- exceeds *min* [Default outputs all polygons].
-**-G**
- Write output that can be imported into GNU Octave or Matlab by
- ending segments with a NaN-record.
-**-I**\ *id*
- Only output information for the polygon that matches *id*. Use
- **-Ic** to get all the continents only [Default outputs all
- polygons].
-**-L**
- Only output a listing of polygon or line segment headers [Default
- outputs headers and data records].
-**-N**
- Only output features whose level matches the given *level* [Default
- will output all levels].
-**-Qe**\ \|\ **i**
- Control what to do with river-lakes (river sections large enough to
- be stored as closed polygons). Use **-Qe** to exclude them and
- **-Qi** to exclude everything else instead [Default outputs all
- polygons].
-
-.. |Add_-bo| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-bo.rst_
-
-.. include:: ../../explain_-ocols.rst_
-
-Examples
---------
-
-To convert the entire intermediate GSHHG binary data to ASCII files for
-Octave/Mathlab, run
-
- ::
-
- gmt gshhg gshhs_i.b --IO_SEGMENT_MARKER=N > gshhs_i.txt
-
-To only get a listing of the headers for the river data set at full
-resolution, try
-
- ::
-
- gmt gshhg wdb_rivers_f.b -L > riverlisting.txt
-
-To only extract lakes, excluding river-lakes, from the high resolution
-file, try
-
- ::
-
- gmt gshhg gshhs_h.b -Ee -N2 > all_lakes.txt
-
-Technical Information
----------------------
-
-Users who wish to access the GSHHG or WDBII data directly from their
-custom programs should consult the gshhg.c and gshhg.h source code and
-familiarize themselves with the data format and how various information
-flags are packed into a single 4-byte integer. While we do not maintain
-any Octave/Matlab code to read these files we are aware that both
-Mathworks and IDL have made such tools available to their users.
-However, they tend not to update their code and our file structure has
-evolved considerably over time, breaking their code. Here, some general
-technical comments on the binary data files are given.
-**GSHHG**: These files contain completely closed polygons of continents
-and islands (level 1), lakes (level 2), islands-in-lakes (level 3) and
-ponds-in-islands-in-lakes (level 4); a particular level can be extracted
-using the **-N** option. Continents are identified as the first 6
-polygons and can be extracted via the **-Ic** option. The IDs for the
-continents are Eurasia (0), Africa (1), North America
-(2), South America (3), Antarctica (4), and Australia
-(5). Files are sorted on area from large to small.
-There are two sub-groups for level 2: Regular lakes and the so-called
-"river-lakes", the latter being sections of a river that are so wide to
-warrant a polygon representation. These river-lakes are flagged in the
-header (also see **-Q**). All five resolutions are free of
-self-intersections. Areas of all features have been computed using a
-Lambert azimuthal equal-area projection centered on the polygon
-centroids, using WGS-84 as the ellipsoid. GMT use the GSHHG as a
-starting point but then partition the polygons into pieces using a
-resolution-dependent binning system; parts of the world are then rebuilt
-into closed polygons on the fly as needed. For more information on GSHHG
-processing, see Wessel and Smith (1996).
-**WDBII**. These files contain sets of line segments not necessarily in
-any particular order. Thus, it is not possible to extract information
-pertaining to just one river or one country. Furthermore, the 4 lower
-resolutions derive directly from the full resolution by application of
-the Douglas-Peucker algorithm (see gshhg\_dp), hence self-intersections
-are increasingly likely as the resolution is degraded. Note that the
-river-lakes included in GSHHG are also duplicated in the WDBII river
-files so that each data set can be a stand-alone representation. Users
-who wish to access both data sets can recognize the river-lakes features
-by examining the header structure (see the source code for details);
-they are also the only closed polygons in the WDBII river file. There
-are many levels (classes) in the river file: River-lakes (0), Permanent
-major rivers (1), Additional major rivers
-(2), Additional rivers (3), Minor rivers (4), Intermittent rivers -- major
-(6), Intermittent rivers -- additional (7), Intermittent rivers -- minor
-(8), Major canals (10), Canals of lesser importance
-(11), and Canals -- irrigation type (12). For the border file there are
-three levels: National boundaries (1), Internal
-domestic boundaries (2), and international
-maritime boundaries (3). Individual levels or
-classes may be extracted via **-N**.
-
-References
-----------
-
-Douglas, D. H., and T. K. Peucker, 1973, Algorithms for the reduction of
-the number of points required to represent a digitized line of its
-caricature, *Can. Cartogr., 10*, 112-122.
-
-Gorny, A. J., 1977, *World Data Bank II General User GuideRep. PB
-271869*, 10pp, Central Intelligence Agency, Washington, DC.
-
-Soluri, E. A., and V. A. Woodson, 1990, World Vector Shoreline, *Int.
-Hydrograph. Rev., LXVII(1), 27-35.*
-
-Wessel, P., and W. H. F. Smith, 1996, A global, self-consistent,
-hierarchical, high-resolution shoreline database, *J. Geophys. Res.,
-101(B4)*, 8741-8743.*
-
-See Also
---------
-
-:doc:`gmt </gmt>`
diff --git a/doc_release/html/_sources/supplements/img/img2google.txt b/doc_release/html/_sources/supplements/img/img2google.txt
deleted file mode 100644
index 9ee6266..0000000
--- a/doc_release/html/_sources/supplements/img/img2google.txt
+++ /dev/null
@@ -1,136 +0,0 @@
-.. index:: ! img2google
-
-**********
-img2google
-**********
-
-.. only:: not man
-
-img2google - Create Google Earth KML overlay tiles from bathymetry
-Mercator img grid
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**img2google**
-|SYN_OPT-R|
-[ *imgfile* ]
-[ **-A**\ *mode*\ [*altitude*] ] [ **-C** ]
-[ **-F**\ *fademin/fademax* ] [ **-G**\ *prefix* ]
-[ **-L**\ *LODmin/LODmax* ] [ **-N**\ *layername* ] [ **-T**\ *doctitle* ]
-[ **-U**\ *URL* ]
-[ |SYN_OPT-V| ]
-[ **-Z** ]
-
-Description
------------
-
-**img2google** is a shell script that reads a 1x1 minute Mercator surface relief img file and
-creates a Google Earth overlay KML file and associated PNG tile for the
-specified region. If no input file is given we use topo.11.1.img.
-
-.. |Add_-Rgeo| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-Rgeo.rst_
-
-Options
--------
-
-*imgfile*
- An img format bathymetry/topography file such as those created by
- Sandwell and Smith. If this files does not exist in the current
- directory and the user has set the environment variable
- **$GMT_DATADIR**, then :doc:`img2grd` will try
- to find *imgfile* in **$GMT_DATADIR**.
-
-**-A**
- Selects one of 5 altitude modes recognized by Google Earth that
- determines the altitude (in m) of the image: **G** clamped to the
- ground, **g** append altitude relative to ground, **a** append absolute
- altitude, **s** append altitude relative to seafloor, and **S** clamp it
- to the seafloor [Default].
-
-**-C**
- Turn on clipping so that only portions below sea level will be visible
- in the image [no clipping].
-
-**-F**
- Sets the distance over which the geometry fades, from fully opaque to
- fully transparent. These ramp values, expressed in screen pixels, are
- applied at the minimum and maximum end of the LOD (visibility) limits,
- respectively. [no fading (0/0)].
-
-**-G**
- Specify the prefix for the output image file (the extensions are set
- automatically). Default uses the naming
- topoN\|S\ *<north>*\ E\|W<*west*\ >.
-
-**-L**
- Measurement in screen pixels that represents the minimum limit of the
- visibility range for a given Region Google Earth calculates the size of
- the Region when projected onto screen space. Then it computes the square
- root of the Region's area (if, for example, the Region is square and the
- viewpoint is directly above the Region, and the Region is not tilted,
- this measurement is equal to the width of the projected Region). If this
- measurement falls within the limits defined by *LODmin* and *LODmax*
- (and if the region is in view), the Region is active. If this limit is
- not reached, the associated geometry is considered to be too far from
- the user's viewpoint to be drawn. *LODmax* represents the maximum limit
- of the visibility range for a given Region. A value of â1, the default,
- indicates "active to infinite size." [always active].
-
-**-N**
- Append the layername of the image (use quotes if strings contain spaces)
- [topoN\|S<*north*>\ E\|W<*west*>].
-
-**-T**
- Append the document title (use quotes if strings contain spaces)
- ["Predicted bathymetry"].
-
-**-U**
- By default, images are referenced locally relative to the KML file.
- Specify an URL to prepend a server address to the image name reference
- [local].
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-**-Z**
- Uses zip (which must be installed) to create a \*.kmz file for easy
- distribution; append **+** to delete the KML and PNG file after zipping
- [No zipping].
-
-Examples
---------
-
-To create a 10x10 degree Google Earth KML tile for the region
-**-R**\ 170/180/20/30 using the default *topo.11.1.img* and output
-naming convention, try
-
- ::
-
- img2google -R170/180/20/30
-
-To make the same tile with the previous *topo.10.1.img*, run in verbose
-mode, clip so only oceanic areas are visible, name the output oldimage,
-specify the KML metadata directly (including setting the image altitude
-to 10 km), and make a single \*.kmz file, try
-
- ::
-
- img2google topo.10.1.img -R170/180/20/30 -Aa10000 -C -Goldimage \
- -N"My KML title" -T"My KML title" -Uhttp://my.server.com/images -V -Z
-
-DATA SETS
----------
-
-For topo.11.1.img and other Sandwell/Smith altimetry-derived Mercator
-grids, visit http://topex.ucsd.edu.
-
-SEE ALSO
---------
-
-:doc:`gmt </gmt>`
-:doc:`img2grd`,
-:doc:`ps2raster </ps2raster>`
diff --git a/doc_release/html/_sources/supplements/img/img2grd.txt b/doc_release/html/_sources/supplements/img/img2grd.txt
deleted file mode 100644
index f6af56c..0000000
--- a/doc_release/html/_sources/supplements/img/img2grd.txt
+++ /dev/null
@@ -1,254 +0,0 @@
-.. index:: ! img2grd
-
-*******
-img2grd
-*******
-
-.. only:: not man
-
- img2grd - Extract subset of img file in Mercator or Geographic format
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**img2grd** *imgfile* **-G**\ *grdfile*
-|SYN_OPT-R|
-**-T**\ *type* [ **-C** ]
-[ **-D**\ [*minlat/maxlat*] ] [ **-E** ] [ **-I**\ *minutes* ]
-[ **-M** ] [ **-N**\ *navg* ] [ **-S**\ [*scale*] ]
-[ |SYN_OPT-V| ]
-[ **-W**\ *maxlon* ]
-[ |SYN_OPT-n| ]
-
-|No-spaces|
-
-Description
------------
-
-**img2grd** reads an img format file, extracts a subset, and writes it
-to a grid file. The **-M** option dictates whether or not the Spherical
-Mercator projection of the img file is preserved or if a Geographic grid
-should be written by undoing the Mercator projection. If geographic grid
-is selected you can also request a resampling onto the exact **-R** given.
-
-Required Arguments
-------------------
-
-*imgfile*
- A Mercator img format file such as the marine gravity or seafloor
- topography fields estimated from satellite altimeter data by
- Sandwell and Smith. If the user has set an environment variable
- **$GMT_DATADIR**, then **img2grd** will try to find *imgfile* in
- **$GMT_DATADIR**; else it will try to open *imgfile* directly.
-**-G**\ *grdfile*
- *grdfile* is the name of the output grid file.
-
-.. |Add_-Rgeo| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-Rgeo.rst_
-
-Optional Arguments
-------------------
-
-**-C**
- Set the x and y Mercator coordinates relative to projection center
- [Default is relative to lower left corner of grid]. Requires **-M**.
-**-D**\ [*minlat/maxlat*\ ]
- Use the extended latitude range -80.738/+80.738. Alternatively,
- append *minlat/maxlat* as the latitude extent of the input img file.
- [Default is -72.006/72.006]. Not usually required since we can
- determine the extent from inspection of the file size.
-**-E**
- Can be used when **-M** is not set to force the final grid to have
- the exact same region as requested with **-R**. By default, the
- final region is a direct projection of the original Mercator region
- and will typically extend slightly beyond the requested latitude
- range, and furthermore the grid increment in latitude does not match
- the longitude increment. However, the extra resampling introduces
- small interpolation errors and should only be used if the output
- grid must match the requested region and have x_inc = y_inc. In
- this case the region set by **-R** must be given in multiples of the
- increment (.e.g, **-R**\ 0/45/45/72).
-**-I**
- Indicate *minutes* as the width of an input img pixel in minutes of
- longitude. [Default is 2.0]. Not usually required since we can
- determine the pixel size from inspection of the size.
-**-M**
- Output a Spherical Mercator grid [Default is a geographic lon/lat
- grid]. The Spherical Mercator projection of the img file is
- preserved, so that the region **-R** set by the user is modified
- slightly; the modified region corresponds to the edges of pixels [or
- groups of *navg* pixels]. The grid file header is set so that the x
- and y axis lengths represent distance from the west and south edges
- of the image, measured in user default units, with **-Jm**\ 1 and
- the adjusted **-R**. By setting the default **PROJ_ ELLIPSOID** =
- Sphere, the user can make overlays with the adjusted **-R** so that
- they match. See **EXAMPLES** below. The adjusted **-R** is also
- written in the grdheader remark, so it can be found later. See
- **-C** to set coordinates relative to projection center.
-**-N**\ *navg*
- Average the values in the input img pixels into *navg* by *navg*
- squares, and create one output pixel for each such square. If used
- with **-T**\ *3* it will report an average constraint between 0 and
- 1. If used with **-T**\ *2* the output will be average data value or
- NaN according to whether average constraint is > 0.5. *navg* must
- evenly divide into the dimensions of the imgfile in pixels. [Default
- *1* does no averaging].
-**-S**\ [*scale*\ ]
- Multiply the img file values by *scale* before storing in grid file.
- [Default is 1.0]. For recent img files: img topo files are stored in
- (corrected) meters [**-S**\ 1]; free-air gravity files in mGal\*10
- [**-S**\ 0.1 to get mGal]; vertical deflection files in
- microradians\*10 [**-S**\ 0.1 to get microradians], vertical gravity
- gradient files in Eotvos\*50 [**-S**\ 0.02 to get Eotvos, or
- **-S**\ 0.002 to get mGal/km]). If no *scale* is given we try to
- determine the scale by examining the file name for clues.
-**-T**\ *type*
- *type* handles the encoding of constraint information. *type* = 0
- indicates that no such information is encoded in the img file (used
- for pre-1995 versions of the gravity data) and gets all data. *type*
- > 0 indicates that constraint information is encoded (1995 and later
- (current) versions of the img files) so that one may produce a grid
- file as follows: **-T**\ *1* gets data values at all points,
- **-T**\ *2* gets data values at constrained points and NaN at
- interpolated points; **-T**\ *3* gets 1 at constrained points and 0
- at interpolated points [Default is 1].
-
-.. |Add_-V| replace:: Particularly recommended here, as it is
- helpful to see how the coordinates are adjusted.
-.. include:: ../../explain_-V.rst_
-
-**-W**\ *maxlon*
- Indicate *maxlon* as the maximum longitude extent of the input img
- file. Versions since 1995 have had *maxlon* = 360.0, while some
- earlier files had *maxlon* = 390.0. [Default is 360.0].
-
-.. include:: ../../explain_help.rst_
-
-Geographic Examples
--------------------
-
-The **-M** option should be excluded if you need the output grid to be
-in geographic coordinates. To extract data in the region
-**-R**-40/40/-70/-30 from *world_grav.img.7.2* and reproject to yield
-geographic coordinates, you can try
-
- ::
-
- img2grd world_grav.img.16.1 -Gmerc_grav.nc -R-40/40/-70/-30 -V
-
-Because the latitude spacing in the img file is equidistant in Mercator
-units, the resulting grid will not match the specified **-R** exactly,
-and the latitude spacing will not equal the longitude spacing. If you
-need an exact match with your **-R** and the same spacing in longitude
-and latitude, use the **-E** option:
-
- ::
-
- img2grd world_grav.img.16.1 -Gmerc_grav.nc -R-40/40/-70/-30 -E -V
-
-Mercator Examples
------------------
-
-Since the img files are in a Mercator projection, you should NOT extract
-a geographic grid if your plan is to make a Mercator map. If you did
-that you end of projecting and reprojection the grid, loosing
-short-wavelength detail. Better to use **-M** and plot the grid using a
-linear projection with the same scale as the desired Mercator projection
-(see GMT Example 29).
-To extract data in the region **-R**-40/40/-70/-30 from
-*world_grav.img.7.2*, run
-
- ::
-
- gmt img2grd -M world_grav.img.7.2 -Gmerc_grav.nc -R-40/40/-70/-30 -V
-
-Note that the **-V** option tells us that the range was adjusted to
-**-R**-40/40/-70.0004681551/-29.9945810754. We can also use :doc:`grdinfo </grdinfo>`
-to find that the grid file header shows its region to be
-**-R**\ 0/80/0/67.9666667 This is the range of x,y we will get from a
-Spherical Mercator projection using
-**-R**-40/40/-70.0004681551/-29.9945810754 and **-Jm**\ 1. Thus, to take
-ship.lonlatgrav and use it to sample the merc_grav.nc, we can do this:
-
- ::
-
- gmt set PROJ_ELLIPSOID Sphere
-
- gmt mapproject -R-40/40/-70.0004681551/-29.9945810754 -Jm1i ship.lonlatgrav | \
- gmt grdtrack -Gmerc_grav.nc | gmt mapproject \
- -R-40/40/-70.0004681551/-29.9945810754 -Jm1i -I > ship.lonlatgravsat
-
-It is recommended to use the above method of projecting and unprojecting
-the data in such an application, because then there is only one
-interpolation step (in :doc:`grdtrack </grdtrack>`). If one first tries to convert the
-grid file to lon,lat and then sample it, there are two interpolation
-steps (in conversion and in sampling).
-
-To make a lon,lat grid from the above grid we can use
-
- ::
-
- gmt grdproject merc_grav.nc -R-40/40/-70.0004681551/-29.9945810754 -Jm1i -I -D2m -Ggrav.nc
-
-In some cases this will not be easy as the **-R** in the two coordinate
-systems may not align well. When this happens, we can also use (in fact,
-it may be always better to use)
-
- ::
-
- gmt grd2xyz merc_grav.nc | gmt mapproject \
- -R-40/40/-70.0004681551/-29.994581075 -Jm1i -I | \
- gmt surface -R-40/40/-70/70 -I2m -Ggrav.nc
-
-To make a Mercator map of the above region, suppose our gmt.conf value
-for :ref:`PROJ_LENGTH_UNIT <PROJ_LENGTH_UNIT>` is inch. Then since the above merc_grav.nc
-file is projected with **-Jm**\ 1i it is 80 inches wide. We can make a
-map 8 inches wide by using **-Jx**\ 0.1i on any map programs applied to
-this grid (e.g., :doc:`grdcontour </grdcontour>`,
-:doc:`grdimage </grdimage>`, :doc:`grdview </grdview>`), and then
-for overlays which work in lon,lat (e.g., :doc:`psxy </psxy>`, :doc:`pscoast </pscoast>`) we can
-use the above adjusted **-R** and **-Jm**\ 0.1 to get the two systems to
-match up.
-
-However, we can be smarter than this. Realizing that the input img file
-had pixels 2.0 minutes wide (or checking the nx and ny with grdinfo
-merc_grav.nc) we realize that merc_grav.nc used the full resolution of
-the img file and it has 2400 by 2039 pixels, and at 8 inches wide this
-is 300 pixels per inch. We decide we do not need that many and we will be
-satisfied with 100 pixels per inch, so we want to average the data into
-3 by 3 squares. (If we want a contour plot we will probably choose to
-average the data much more (e.g., 6 by 6) to get smooth contours.) Since
-2039 isn't divisible by 3 we will get a different adjusted **-R** this time:
-
- ::
-
- gmt img2grd -M world_grav.img.7.2 -Gmerc_grav_2.nc -R-40/40/-70/-30 -N3 -V
-
-This time we find the adjusted region is
-**-R**-40/40/-70.023256525/-29.9368261101 and the output is 800 by 601
-pixels, a better size for us. Now we can create an artificial
-illumination file for this using :doc:`grdgradient </grdgradient>`:
-
- ::
-
- gmt grdgradient merc_grav_2.nc -Gillum.nc -A0/270 -Ne0.6
-
-and if we also have a cpt file called "grav.cpt" we can create a color
-shaded relief map like this:
-
- ::
-
- gmt grdimage merc_grav_2.nc -Iillum.nc -Cgrav.cpt -Jx0.1i -K > map.ps
- gmt psbasemap -R-40/40/-70.023256525/-29.9368261101 -Jm0.1i -Ba10 -O >> map.ps
-
-Suppose you want to obtain only the constrained data values from an img
-file, in lat/lon coordinates. Then run **img2grd** with the **-T**\ 2
-option, use :doc:`grd2xyz </grd2xyz>` to dump the values, pipe through grep -v NaN to
-eliminate NaNs, and pipe through :doc:`mapproject </mapproject>` with the inverse projection as above.
-
-See Also
---------
-
-:doc:`gmt </gmt>`
diff --git a/doc_release/html/_sources/supplements/meca/pscoupe.txt b/doc_release/html/_sources/supplements/meca/pscoupe.txt
deleted file mode 100644
index e37d2ef..0000000
--- a/doc_release/html/_sources/supplements/meca/pscoupe.txt
+++ /dev/null
@@ -1,374 +0,0 @@
-.. index:: ! pscoupe
-
-*******
-pscoupe
-*******
-
-.. only:: not man
-
- pscoupe - Plot cross-sections of focal mechanisms
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**pscoupe** [ *files* ] **-J**\ *parameters*
-|SYN_OPT-R| **-A**\ *parameters*
-[ |SYN_OPT-B| ] [ **-E**\ *fill* ]
-[ **-F**\ *mode*\ [*args*] ]
-[ **-G**\ *fill* ] [ **-K** ] [ **-L**\ *[pen]* ] [ **-M** ] [ **-N** ]
-[ **-O** ] [ **-Q** ]
-[ **-S**\ *<symbol><scale>*\ [/**d**] ]
-[ **-T**\ *n* ]
-[ |SYN_OPT-U| ] [ |SYN_OPT-V| ]
-[ **-W**\ *pen* ]
-[ |SYN_OPT-X| ]
-[ |SYN_OPT-Y| ]
-[ **-Z**\ *cpt* ] [ |SYN_OPT-c| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-`Description <#toc2>`_
-----------------------
-
-**pscoupe** reads data values from *files* [or standard input] and
-generates PostScript code that will plot symbols, lines or polygons on
-a cross-section. Focal mechanisms may be specified and require
-additional columns of data. The PostScript code is written to standard
-output.
-
-Unless **-Q** is used, new file is created with the new coordinates
-(**x**, **y**) and the mechanism (from lower focal half-sphere for
-horizontal plane, to half-sphere behind a vertical plane). When the
-plane is not horizontal,
-- north direction becomes upwards steepest descent direction of the plane (u)
-- east direction becomes strike direction of the plane (s)
-- down direction (= north^east) becomes u^s
-Axis angles are defined in the same way as in horizontal plane in the new system.
-Moment tensor (initially in r, t, f system that is up, south, east) is
-defined in (-u^s, -u, s) system.
-
-`Required Arguments <#toc4>`_
------------------------------
-
-.. |Add_intables| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_intables.rst_
-
-.. include:: ../../explain_-J.rst_
-
-.. |Add_-Rgeo| replace:: If frame is defined from cross-section parameters
- (see **-A** this option is not taken into account, but must be present.
-.. include:: ../../explain_-Rgeo.rst_
-
-**-A**
- selects the cross-section.
-
-**-Aa**\ *lon1/lat1/lon2/lat2/dip/p\_width/dmin/dmax*\ [**f**]
- *lon* and *lat* are the longitude and latitude of points 1 and 2
- limiting the length of the cross-section. *dip* is the dip of the plane
- on which the cross-section is made. *p\_width* is the width of the
- cross-section on each side of a vertical plane or above and under an
- oblique plane. *dmin* and *dmax* are the distances min and max from
- horizontal plane, along steepest descent direction. Add **f** to get the
- frame from the cross-section parameters.
-
-**-Ab**\ *lon1/lat1/strike/p\_length/dip/p\_width/dmin/dmax*\ [**f**\ ]
- *lon1* and *lat1* are the longitude and latitude of the beginning of the
- cross-section. *strike* is the azimuth of the direction of the
- cross-section. *p\_length* is the length along which the cross-section
- is made. The other parameters are the same as for **-Aa** option.
-
-**-Ac**\ *x1/y1/x2/y2/dip/p\_width/dmin/dmax*\ [**f**\ ]
- The same as **-Aa** option with *x* and *y* cartesian coordinates.
-
-**-Ad**\ *x1/y1/strike/p\_length/dip/p\_width/dmin/dmax*\ [**f**\ ]
- The same as **-Ab** option with *x* and *y* cartesian coordinates.
-
-**-S**
- selects the meaning of the columns in the data file and the figure to be plotted.
-
-**-Sa**\ *scale[/fontsize[/offset*\ [**u**\ ]]]
- Focal mechanisms in Aki and Richards convention. *scale* adjusts the
- scaling of the radius of the "beach ball", which will be proportional to
- the magnitude. The *scale* is the size for magnitude = 5 in
- **PROJ_LENGTH_UNIT** (unless **c**, **i**, **m**, or **p** is appended
- to indicate that the size information is in units of cm, inches, meters,
- or points, respectively). Use the **-T** option to render the beach ball
- transparent by drawing only the nodal planes and the circumference. The
- color or shade of the compressive quadrants can be specified with the
- **-G** option. The color or shade of the extensive quadrants can be
- specified with the **-E** option. Parameters are expected to be in the
- following columns:
-
- **1**,\ **2**:
- longitude, latitude of event (**-:** option interchanges order)
- **3**:
- depth of event in kilometers
- **4**,\ **5**,\ **6**:
- strike, dip and rake
- **7**:
- magnitude
- **8**,\ **9**:
- not used; can be 0 0; allows use of the psmeca file format
- **10**:
- text string to appear above the beach ball (default) or under (add **u**).
-
-**-Sc**\ *scale*
- Focal mechanisms in Harvard CMT convention. *scale* adjusts the scaling
- of the radius of the "beach ball", which will be proportional to the
- magnitude. The *scale* is the size for magnitude = 5 (that is M0 = 4E+23
- dynes-cm.) in **PROJ_LENGTH_UNIT** (unless **c**, **i**, **m**, or
- **p** is appended to indicate that the size information is in units of
- cm, inches, meters, or points, respectively). Use the **-T** option to
- render the beach ball transparent by drawing only the nodal planes and
- the circumference. The color or shade of the compressive quadrants can
- be specified with the **-G** option. The color or shade of the extensive
- quadrants can be specified with the **-E** option. Parameters are
- expected to be in the following columns:
-
- **1**,\ **2**:
- longitude, latitude of event (**-:** option interchanges order)
- **3**:
- depth of event in kilometers
- **4**,\ **5**,\ **6**:
- strike, dip, and slip of plane 1
- **7**,\ **8**,\ **9**:
- strike, dip, and slip of plane 2
- **10**,\ **11**:
- mantissa and exponent of moment in dyne-cm (if magnitude is uses
- instead of scalar moment, magnitude is in column 10 and 0 must be in column 11)
- **12**,\ **13**:
- not used; can be 0 0; allows use of the psmeca file format
- **14**:
- text string to appear above the beach ball (default) or under (add **u**).
-
-**-Sp**\ *scale[/fontsize[/offset*\ [**u**]]]
- Focal mechanisms given with partial data on both planes. *scale* adjusts
- the scaling of the radius of the "beach ball", which will be
- proportional to the magnitude. The *scale* is the size for magnitude = 5
- in **PROJ_LENGTH_UNIT** (unless **c**, **i**, **m**, or **p** is
- appended to indicate that the size information is in units of cm,
- inches, meters, or points, respectively). The color or shade of the
- compressive quadrants can be specified with the **-G** option. The color
- or shade of the extensive quadrants can be specified with the **-E**
- option. Parameters are expected to be in the following columns:
-
- **1**,\ **2**:
- longitude, latitude of event (**-:** option interchanges order)
- **3**:
- depth
- **4**,\ **5**:
- strike, dip of plane 1
- **6**:
- strike of plane 2
- **7**:
- must be -1/+1 for a normal/inverse fault
- **8**:
- magnitude
- **9**,\ **10**:
- not used; can be 0 0; allows use of the psmeca file format
- **11**:
- text string to appear above the beach ball (default) or under (add **u**).
-
-**-Sm\|d\|z**\ *scale[/fontsize[/offset*\ [**u**]]]
- Seismic moment tensor (Harvard CMT, with zero trace). *scale* adjusts
- the scaling of the radius of the "beach ball", which will be
- proportional to the magnitude. The *scale* is the size for magnitude = 5
- (that is seismic scalar moment = 4E+23 dynes-cm) in
- **PROJ_LENGTH_UNIT** (unless **c**, **i**, **m**, or **p** is appended
- to indicate that the size information is in units of cm, inches, meters,
- or points, respectively). (**-T**\ *0* option overlays best double
- couple transparently.)
-**-Sd**\ *scale[/fontsize[/offset*\ [**u**]]]
- to plot the only double couple part of moment tensor.
-**-Sz**\ *scale[/fontsize[/offset*\ [**u**]]]
- to plot anisotropic part
- of moment tensor (zero trace). The color or shade of the compressive
- quadrants can be specified with the **-G** option. The color or shade of
- the extensive quadrants can be specified with the **-E** option.
- Parameters are expected to be in the following columns:
-
- **1**,\ **2**:
- longitude, latitude of event (**-:** option interchanges order)
- **3**:
- depth of event in kilometers
- **4**,\ **5**,\ **6**,\ **7**,\ **8**,\ **9**:
- mrr, mtt, mff, mrt, mrf, mtf in 10\*exponent dynes-cm
- **10**:
- exponent
- **11**,\ **12**:
- Not used; can be 0 0; allows use of the psmeca file format
- **13**:
- Text string to appear above the beach ball (default) or under (add **u**).
-
-**-Sx**\ *scale[/fontsize[/offset*\ [**u**]]]
- Principal axis. *scale* adjusts the scaling of the radius of the "beach
- ball", which will be proportional to the magnitude. The *scale* is the
- size for magnitude = 5 (that is seismic scalar moment = 4\*10e+23
- dynes-cm) in **PROJ\_LENGTH\_UNIT** (unless **c**, **i**, **m**, or
- **p** is appended to indicate that the size information is in units of
- cm, inches, meters, or points, respectively). (**-T0** option overlays
- best double couple transparently.)
-**-Sy**\ *scale[/fontsize[/offset*\ [**u**]]]
- to plot the only double couple part of moment tensor.
-**-St**\ *scale[/fontsize[/offset*\ [**u**]]]
- to plot anisotropic part
- of moment tensor (zero trace). The color or shade of the compressive
- quadrants can be specified with the **-G** option. The color or shade of
- the extensive quadrants can be specified with the **-E** option.
- Parameters are expected to be in the following columns:
-
- **1**,\ **2**:
- longitude, latitude of event (**-:** option interchanges order)
- **3**:
- depth of event in kilometers
- **4**,\ **5**,\ **6**,\ **7**,\ **8**,\ **9**,\ **10**,\ **11**,\ **12**:
- value (in 10\*exponent dynes-cm), azimuth, plunge of the T, N, and P axes.
- **13**:
- exponent
- **14**,\ **15**:
- longitude, latitude at which to place beach ball. Entries in these
- columns are necessary with the **-C** option. Using 0,0 in columns 9
- and 10 will plot the beach ball at the longitude, latitude given in
- columns 1 and 2. The **-:** option will interchange the order of
- columns (1,2) and (9,10).
- **16**:
- Text string to appear above the beach ball (optional).
-
-Optional Arguments
-------------------
-
-.. include:: ../../explain_-B.rst_
-
-**-E**\ *fill*
- Sets color or fill pattern for extensive quadrants [Default is white].
-
-**-F**\ *mode*\ [*args*]
- Sets one or more attributes; repeatable. The various combinations are
-
-**-Fs**\ *symbol[size[/fontsize[/offset*\ [**u**]]]
- selects a symbol instead of mechanism. Choose from the following:
- (**c**) circle, (**d**) diamond, (**i**) itriangle, (**s**) square,
- (**t**) triangle, (**x**) cross. *size* is the symbol size in
- **PROJ_LENGTH_UNIT** (unless **c**, **i**, **m**, or **p** is appended
- to indicate that the size information is in units of cm, inches, meters,
- or points, respectively). If *size* must be read, it must be in column 4
- and the text string will start in column 5. Parameters are expected to
- be in the following columns:
-
- **1**,\ **2**:
- longitude, latitude of event (**-:** option interchanges order)
- **3**:
- depth of event in kilometers
- **4**:
- Text string to appear above the beach ball (default) or under (add **u**).
-
-**-Fa**\ [*size*][/\ *P\_symbol*\ [/\ *T\_symbol*]]
- Computes and plots P and T axes with symbols. Optionally specify
- *size* and (separate) P and T axis symbols from the following:
- (**c**) circle, (**d**) diamond, (**h**) hexagon, (**i**) inverse
- triangle, (**p**) point, (**s**) square, (**t**) triangle, (**x**)
- cross. [Default: 6\ **p**/**cc**]
-
-**-Fe**\ *fill*
- Sets the color or fill pattern for the T axis symbol. [Default as set by **-E**]
-
-**-Fg**\ *fill*
- Sets the color or fill pattern for the P axis symbol. [Default as set by **-G**]
-
-**-Fp**\ [*pen*]
- Draws the P axis outline using current pen (see **-W**), or sets pen attributes.
-
-**-Fr**\ [*fill*]
- Draw a box behind the label (if any). [Default fill is white]
-
-**-Ft**\ [*pen*]
- Draws the T axis outline using current pen (see **-W**), or sets pen attributes.
-
-**-G**\ *fill*
- Sets color or fill pattern for compressional quadrants [Default is black].
-
-.. include:: ../../explain_-K.rst_
-
-**-L**\ [*pen*]
- Draws the "beach ball" outline using current pen (see **-W**) or
- sets pen attributes.
-**-M**
- Same size for any magnitude.
-**-N**
- Does **not** skip symbols that fall outside map border [Default
- plots points inside border only].
-
-.. include:: ../../explain_-O.rst_
-.. include:: ../../explain_-P.rst_
-
-**-Q**
- Suppress the production of files with cross-section and mechanism information.
-
-**-T**\ [*num_of_planes*]
- Plots the nodal planes and outlines the bubble which is transparent.
- If *num_of_planes* is
- *0*: both nodal planes are plotted;
- *1*: only the first nodal plane is plotted;
- *2*: only the second nodal plane is plotted
- [Default: 0].
-
-.. include:: ../../explain_-U.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-**-W**
- set pen attributes for text string or default pen attributes for
- fault plane edges. [Defaults: width = default, color = black, style = solid].
-
-.. include:: ../../explain_-XY.rst_
-
-**-Z**\ cptfile
- Give a color palette file and let compressive part color be
- determined by the z-value in the third column.
-
-.. include:: ../../explain_-c.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-h.rst_
-
-.. include:: ../../explain_-icols.rst_
-.. include:: ../../explain_colon.rst_
-
-.. include:: ../../explain_help.rst_
-
-See Also
---------
-
-:doc:`gmt </gmt>`, :doc:`psbasemap </psbasemap>`,
-:doc:`psmeca`, :doc:`psxy </psxy>`
-
-References
-----------
-
-Bomford, G., Geodesy, 4th ed., Oxford University Press, 1980.
-
-Aki, K. and P. Richards, Quantitative Seismology, Freeman, 1980.
-
-F. A. Dahlen and Jeroen Tromp, Theoretical Seismology, Princeton, 1998,
-p.167. Definition of scalar moment.
-
-Cliff Frohlich, Cliff's Nodes Concerning Plotting Nodal Lines for P, Sh and Sv
-
-Seismological Research Letters, Volume 67, Number 1, January-February, 1996
-
-Thorne Lay, Terry C. Wallace, Modern Global Seismology, Academic Press, 1995, p.384.
-
-W.H. Press, S.A. Teukolsky, W.T. Vetterling, B.P. Flannery, Numerical
-Recipes in C, Cambridge University press (routine jacobi)
-
-Author
-------
-
-Genevieve Patau, `Laboratory of Seismogenesis <http://www.ipgp.fr/rech/sismogenese/>`,
-Institut de Physique du Globe de Paris, Departement de Sismologie, Paris, France
diff --git a/doc_release/html/_sources/supplements/meca/psmeca.txt b/doc_release/html/_sources/supplements/meca/psmeca.txt
deleted file mode 100644
index 38cffa2..0000000
--- a/doc_release/html/_sources/supplements/meca/psmeca.txt
+++ /dev/null
@@ -1,370 +0,0 @@
-.. index:: ! psmeca
-
-******
-psmeca
-******
-
-.. only:: not man
-
- psmeca - Plot focal mechanisms on maps
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-psmeca [ *table* ] **-J**\ *parameters*
-|SYN_OPT-R|
-[ |SYN_OPT-B| ]
-[ **-C**\ [*pen*\ ][\ **P**\ *pointsize*] ] [ **-D**\ *depmin*/*depmax* ]
-[ **-E**\ *fill*] [ **-F**\ *mode*\ [*args*] ] [ **-G**\ *fill*] [ **-K** ] [ **-L**\ [*pen*\ ] ]
-[ **-M** ] [ **-N** ] [ **-O** ] [ **-P** ]
-[ **-S**\ *<format><scale>*\ [/**d**]]
-[ **-T**\ *num\_of\_plane*\ [*pen*\ ] ]
-[ |SYN_OPT-U| ]
-[ |SYN_OPT-V| ]
-[ **-W**\ *pen* ]
-[ |SYN_OPT-X| ]
-[ |SYN_OPT-Y| ]
-[ **-Z**\ *cptfile*]
-[ |SYN_OPT-c| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**psmeca** reads data values from *files* [or standard input] and
-generates PostScript code that will plot focal mechanisms on a map.
-Most options are the same as for **psxy**. The PostScript code is
-written to standard output.
-
-Required Arguments
-------------------
-
-.. |Add_intables| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_intables.rst_
-
-.. include:: ../../explain_-J.rst_
-
-.. |Add_-Rgeo| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-Rgeo.rst_
-
-**-S**\ *<format><scale>*\ [/**d**]
-
-Selects the meaning of the columns in the data file . In order to use
-the same file to plot cross-sections, depth is in third column.
-Nevertheless, it is possible to use "old style" **psvelomeca** input
-files without depth in third column using the **-o** option.
-
-**-Sa**\ *scale[/fontsize[/offset*\ [**u**\ ]]]
-
-Focal mechanisms in Aki and Richards convention. *scale* adjusts the
-scaling of the radius of the "beach ball", which will be proportional to
-the magnitude. Scale is the size for magnitude = 5 in inch (unless
-**c**, **i**, **m**, or **p** is appended). Use the **-T** option to
-render the beach ball transparent by drawing only the nodal planes and
-the circumference. The color or shade of the compressive quadrants can
-be specified with the **-G** option. The color or shade of the extensive
-quadrants can be specified with the **-E** option. Append **u** to have
-the text appear below the beach ball (default is above). Parameters are
-expected to be in the following columns:
-
- **1**,\ **2**:
- longitude, latitude of event (**-:** option interchanges order)
- **3**:
- depth of event in kilometers
- **4**,\ **5**,\ **6**:
- strike, dip and rake in degrees
- **7**:
- magnitude
- **8**,\ **9**:
- longitude, latitude at which to place beach ball. Entries in these
- columns are necessary with the **-C** option. Using 0,0 in columns 8
- and 9 will plot the beach ball at the longitude, latitude given in
- columns 1 and 2. The **-:** option will interchange the order of
- columns (1,2) and (8,9).
- **10**:
- Text string to appear above or below the beach ball (optional).
-
-**-Sc**\ *scale[/fontsize[/offset*\ [**u**\ ]]]
-
-Focal mechanisms in Harvard CMT convention. *scale* adjusts the scaling
-of the radius of the "beach ball", which will be proportional to the
-magnitude. Scale is the size for magnitude = 5 (that is M0 = 4.0E23
-dynes-cm) in inch (unless **c**, **i**, **m**, or **p** is appended).
-Use the **-T** option to render the beach ball transparent by drawing
-only the nodal planes and the circumference. The color or shade of the
-compressive quadrants can be specified with the **-G** option. The color
-or shade of the extensive quadrants can be specified with the **-E**
-option. Append **u** to have the text appear below the beach ball
-(default is above). Parameters are expected to be in the following
-columns:
-
- **1**,\ **2**:
- longitude, latitude of event (**-:** option interchanges order)
- **3**:
- depth of event in kilometers
- **4**,\ **5**,\ **6**:
- strike, dip, and rake of plane 1
- **7**,\ **8**,\ **9**:
- strike, dip, and rake of plane 2
- **10**,\ **11**:
- mantissa and exponent of moment in dyne-cm
- **12**,\ **13**:
- longitude, latitude at which to place beach ball. Entries in these
- columns are necessary with the **-C** option. Using (0,0) in columns
- 12 and 13 will plot the beach ball at the longitude, latitude given
- in columns 1 and 2. The **-:** option will interchange the order of
- columns (1,2) and (12,13).
- **14**:
- Text string to appear above or below the beach ball (optional).
-
-**-Sm\|d\|z**\ *scale[/fontsize[/offset*\ [**u**\ ]]]
-
-Seismic moment tensor (Harvard CMT, with zero trace). *scale* adjusts
-the scaling of the radius of the "beach ball", which will be
-proportional to the magnitude. Scale is the size for magnitude = 5 (that
-is scalar seismic moment = 4.0E23 dynes-cm) in inch (unless **c**,
-**i**, **m**, or **p** is appended). (**-T**\ *0* option overlays best
-double couple transparently.) Use **-Sm** to plot the Harvard CMT
-seismic moment tensor with zero trace. Use **-Sd** to plot only the
-double couple part of moment tensor. Use **-Sz** to plot the anisotropic
-part of moment tensor (zero trace). The color or shade of the
-compressive quadrants can be specified with the **-G** option. The color
-or shade of the extensive quadrants can be specified with the **-E**
-option. Append **u** to have the text appear below the beach ball
-(default is above). Parameters are expected to be in the following
-columns:
-
- **1**,\ **2**:
- longitude, latitude of event (**-:** option interchanges order)
- **3**:
- depth of event in kilometers
- **4**,\ **5**,\ **6**,\ **7**,\ **8**,\ **9**:
- mrr, mtt, mff, mrt, mrf, mtf in 10\*exponent dynes-cm
- **10**:
- exponent
- **11**,\ **12**:
- longitude, latitude at which to place beach ball. Entries in these
- columns are necessary with the **-C** option. Using (0,0) in columns
- 11 and 12 will plot the beach ball at the longitude, latitude given
- in columns 1 and 2. The **-:** option will interchange the order of
- columns (1,2) and (11,12).
- **13**:
- Text string to appear above or below the beach ball (optional).
-
-**-Sp**\ *scale[/fontsize[/offset*\ [**u**\ ]]]
-
-Focal mechanisms given with partial data on both planes. *scale* adjusts
-the scaling of the radius of the "beach ball", which will be
-proportional to the magnitude. Scale is the size for magnitude = 5 in
-inch (unless **c**, **i**, **m**, or **p** is appended). The color or
-shade of the compressive quadrants can be specified with the **-G**
-option. The color or shade of the extensive quadrants can be specified
-with the **-E** option. Append **u** to have the text appear below the
-beach ball (default is above). Parameters are expected to be in the
-following columns:
-
- **1**,\ **2**:
- longitude, latitude of event (**-:** option interchanges order)
- **3**:
- depth of event in kilometers
- **4**,\ **5**:
- strike, dip of plane 1
- **6**:
- strike of plane 2
- **7**:
- must be -1/+1 for a normal/inverse fault
- **8**:
- magnitude
- **9**,\ **10**:
- longitude, latitude at which to place beach ball. Entries in these
- columns are necessary with the **-C** option. Using (0,0) in columns
- 9 and 10 will plot the beach ball at the longitude, latitude given
- in columns 1 and 2. The **-:** option will interchange the order of
- columns (1,2) and (9,10).
- **11**:
- Text string to appear above or below the beach ball (optional).
-
-**-Sx\|y\|t**\ *scale[/fontsize[/offset*\ [**u**\ ]]]
-
-Principal axis. *scale* adjusts the scaling of the radius of the "beach
-ball", which will be proportional to the magnitude. Scale is the size
-for magnitude = 5 (that is seismic scalar moment = 4\*10e+23 dynes-cm)
-in inch (unless **c**, **i**, **m**, or **p** is appended). (**-T**\ *0*
-option overlays best double couple transparently.) Use **-Sx** to plot
-standard Harvard CMT. Use **-Sy** to plot only the double couple part of
-moment tensor. Use **-St** to plot zero trace moment tensor. The color
-or shade of the compressive quadrants can be specified with the **-G**
-option. The color or shade of the extensive quadrants can be specified
-with the **-E** option. Append **u** to have the text appear below the
-beach ball (default is above). Parameters are expected to be in the
-following columns:
-
- **1**,\ **2**:
- longitude, latitude of event (**-:** option interchanges order)
- **3**:
- depth of event in kilometers
- **4**,\ **5**,\ **6**,\ **7**,\ **8**,\ **9**,\ **10**,\ **11**,\ **12**:
- value (in 10\*exponent dynes-cm), azimuth, plunge of T, N, P axis.
- **13**:
- exponent
- **14**,\ **15**:
- longitude, latitude at which to place beach ball. Entries in these
- columns are necessary with the **-C** option. Using (0,0) in columns
- 14 and 15 will plot the beach ball at the longitude, latitude given
- in columns 1 and 2. The **-:** option will interchange the order of
- columns (1,2) and (14,15).
- **16**:
- Text string to appear above or below the beach ball (optional).
-
-`Optional Arguments <#toc5>`_
------------------------------
-
-.. include:: ../../explain_-B.rst_
-
-**-C**\ [*pen*\ ][\ **P**\ *pointsize*]
- Offsets focal mechanisms to the longitude, latitude specified in the
- last two columns of the input file before the (optional) text
- string. A small circle is plotted at the initial location and a line
- connects the beachball to the circle. Specify *pen* and/or
- *pointsize* to change the line style and/or size of the circle.
- [Defaults: *pen* as given by **-W**; *pointsize* 0].
-**-D**\ *depmin/depmax*
- Plots events between depmin and depmax.
-**-E**\ *fill*
- Selects filling of extensive quadrants. Usually white. Set the color
- [Default is white].
-**-F**\ *mode*\ [*args*]
- Sets one or more attributes; repeatable. The various combinations are
-
-**-Fa**\ [*size*\ ][/\ *P\_axis\_symbol*\ [*T\_axis\_symbol*\ ]]
- Computes and plots P and T axes with symbols. Optionally specify
- *size* and (separate) P and T axis symbols from the following:
- (**c**) circle, (**d**) diamond, (**h**) hexagon, (**i**) inverse
- triangle, (**p**) point, (**s**) square, (**t**) triangle, (**x**)
- cross. [Default: 6\ **p**/**cc**]
-**-Fe**\ *fill*
- Sets the color or fill pattern for the T axis symbol. [Default as
- set by **-E**]
-**-Fg**\ *fill*
- Sets the color or fill pattern for the P axis symbol. [Default as
- set by **-G**]
-**-Fo**
- Use the **psvelomeca** input format without depth in the third column.
-**-Fp**\ [*pen*\ ]
- Draws the P axis outline using default pen (see **-W**), or sets pen attributes.
-**-Fr**\ [*fill*\ ]
- Draw a box behind the label (if any). [Default fill is white]
-**-Ft**\ [*pen*\ ]
- Draws the T axis outline using default pen (see **-W**), or sets pen
- attributes.
-**-Fz**\ [*pen*\ ]
- Overlay zero trace moment tensor using default pen (see **-W**), or
- sets pen attributes.
-
-**-G**\ *fill*
- Selects filling of focal mechanisms. By convention, the
- compressional quadrants of the focal mechanism beach balls are
- shaded. Set the color [Default is black].
-
-.. include:: ../../explain_-K.rst_
-
-**-L**\ *pen*
- Draws the "beach ball" outline with *pen* attributes instead of with
- the default pen set by **-W**.
-**-M**
- Use the same size for any magnitude. Size is given with **-S**.
-**-N**
- Does **not** skip symbols that fall outside frame boundary specified
- by **-R** [Default plots symbols inside frame only].
-
-.. include:: ../../explain_-O.rst_
-.. include:: ../../explain_-P.rst_
-
-**-T**\ [*num\_of\_planes*\ ][\ **/**\ *pen*]
- Plots the nodal planes and outlines the bubble which is transparent.
- If *num\_of\_planes* is
-
- *0*: both nodal planes are plotted;
-
- *1*: only the first nodal plane is plotted;
-
- *2*: only the second nodal plane is plotted.
-
- Append **/**\ *pen* to set the pen attributes for this feature.
- Default pen is as set by **-W**.
-
-.. include:: ../../explain_-U.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-**-W**\ *pen*
- Set pen attributes for all lines and the outline of symbols
- [Defaults: width = default, color = black, style = solid]. This
- setting applies to **-C**, **-L**, **-T**, **-p**, **-t**, and
- **-z**, unless overruled by options to those arguments.
-
-.. include:: ../../explain_-XY.rst_
-
-**-Z**\ *cptfile*
- Give a color palette file and let compressive part color be
- determined by the z-value in the third column.
-
-.. include:: ../../explain_-c.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-h.rst_
-.. include:: ../../explain_-icols.rst_
-.. include:: ../../explain_colon.rst_
-.. include:: ../../explain_help.rst_
-
-Examples
---------
-
-The following file should give a normal-faulting CMT mechanism:
-
- ::
-
- gmt psmeca -R239/240/34/35.2 -Jm4c -Sc0.4 -h1 << END > test.ps
- lon lat depth str dip slip st dip slip mant exp plon plat
- 239.384 34.556 12. 180 18 -88 0 72 -90 5.5 0 0 0
- END
-
-See Also
---------
-
-:doc:`gmt </gmt>`, :doc:`psbasemap </psbasemap>`, :doc:`psxy </psxy>`
-
-`References <#toc8>`_
----------------------
-
-Bomford, G., Geodesy, 4th ed., Oxford University Press, 1980.
-
-Aki, K. and P. Richards, Quantitative Seismology, Freeman, 1980.
-
-F. A. Dahlen and Jeroen Tromp, Theoretical Seismology, Princeton, 1998,
-p.167.
-
-Cliff Frohlich, Cliff's Nodes Concerning Plotting Nodal Lines for P, Sh
-and Sv
-
-Seismological Research Letters, Volume 67, Number 1, January-February,
-1996
-
-Thorne Lay, Terry C. Wallace, Modern Global Seismology, Academic Press,
-1995, p.384.
-
-W.H. Press, S.A. Teukolsky, W.T. Vetterling, B.P. Flannery, Numerical
-Recipes in C, Cambridge University press (routine jacobi)
-
-`Authors <#toc9>`_
-------------------
-
-Genevieve Patau, `Laboratory of Seismogenesis <http://www.ipgp.fr/rech/sismogenese/>`,
-Institut de Physique du Globe de Paris, Departement de Sismologie, Paris, France
diff --git a/doc_release/html/_sources/supplements/meca/pspolar.txt b/doc_release/html/_sources/supplements/meca/pspolar.txt
deleted file mode 100644
index 4e02c31..0000000
--- a/doc_release/html/_sources/supplements/meca/pspolar.txt
+++ /dev/null
@@ -1,199 +0,0 @@
-.. index:: ! pspolar
-
-*******
-pspolar
-*******
-
-.. only:: not man
-
- pspolar - Plot polarities on the inferior focal half-sphere on maps
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-pspolar [ *table* ] **-J**\ *parameters*
-|SYN_OPT-R|
-**-M**\ *size* **-S**\ *<symbol><size>*
-[ |SYN_OPT-B| ]
-[ **-C**\ *lon*/*lat*\ [/*dash\_width*/*pointsize*] ] [ **-F**\ *color* ]
-[ **-G**\ *fill* ] [ **-K** ] [ **-L** ] [ **-N** ]
-[ **-O** ] [ **-Q**\ *mode*\ [*args*] ]
-[ **-T**\ *angle*/*form*/*justify*/*fontsize* ]
-[ |SYN_OPT-U| ]
-[ |SYN_OPT-V| ]
-[ **-W**\ *pen* ]
-[ |SYN_OPT-X| ]
-[ |SYN_OPT-Y| ]
-[ |SYN_OPT-c| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**pspolar** reads data values from *files* [or standard input] and
-generates PostScript code that will plot stations on focal mechanisms
-on a map. The PostScript code is written to standard output.
-
-Parameters are expected to be in the following columns:
-
- **1**,\ **2**,\ **3**:
- station\_code, azimuth, take-off angle
- **4**:
- polarity:
-
- - compression can be c,C,u,U,+
-
- - rarefaction can be d,D,r,R,-
-
- - not defined is anything else
-
-Required Arguments
-------------------
-
-.. |Add_intables| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_intables.rst_
-
-.. include:: ../../explain_-J.rst_
-
-.. |Add_-Rgeo| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-Rgeo.rst_
-
-
-**-D**\ longitude/latitude)
- Maps the bubble at given longitude and latitude point.
-
-**-M**\ size)
- Sets the size of the beach ball to plot polarities in. *Size* is in
- inch (unless **c**, **i**, **m**, or **p** is appended).
-
-**-S**\ <symbol\_type><size>)
- Selects *symbol\_type* and symbol *size*. Size is in inch (unless
- **c**, **i**, **m**, or **p** is appended). Choose symbol type from
- st(\ *a*)r, (*c*)ircle, (*d*)iamond, (*h*)exagon, (*i*)nverted
- triangle, (*p*)oint, (*s*)quare, (*t*)riangle, (*x*)cross.
-
-Optional Arguments
-------------------
-
-.. include:: ../../explain_-B.rst_
-
-**-C**
- Offsets focal mechanisms to the latitude and longitude specified in
- the last two columns of the input file.
-
-**-E**\ fill)
- Selects filling of symbols for stations in extensive quadrants. Set
- the color [Default is 250]. If **-E**\ *fill* is the same as
- **-F**\ *fill*, use **-e** to outline.
-
-**-F**\ *fill*
- Sets background color of the beach ball. Default is no fill.
-
-**-G**\ *fill*
- Selects filling of symbols for stations in compressional quadrants.
- Set the color [Default is black].
-
-.. include:: ../../explain_-K.rst_
-
-**-N**
- Does **not** skip symbols that fall outside map border [Default
- plots points inside border only].
-
-.. include:: ../../explain_-O.rst_
-.. include:: ../../explain_-P.rst_
-
-**-Q**\ *mode*\ [*args*]
- Sets one or more attributes; repeatable. The various combinations are
-
-**-Qe**\ [pen])
- Outline symbols in extensive quadrants using *pen* or the default
- pen (see **-W**).
-
-**-Qf**\ [pen])
- Outline the beach ball using *pen* or the default pen (see **-W**).
-
-**-Qg**\ [pen])
- Outline symbols in compressional quadrants using *pen* or the
- default pen (see **-W**).
-
-**-Qh**
- Use special format derived from HYPO71 output
-
-**-Qs**\ *half-size*/[**V**\ [*v\_width/h\_length/h\_width/shape*\ ]][\ **G**\ *color*][**L**\ ]
- Plots S polarity azimuth. S polarity is in last column. It may be a
- vector (**V** option) or a segment. Give
- half-size,v\_width,h\_length,h\_width in inch (unless **c**, **i**,
- **m**, or **p** is appended). [**L**\ ] option is for outline.
-
-**-Qt**\ *pen*
- Set pen color to write station code. Default uses the default pen
- (see **-W**).
-
-
-**-T**\ *angle/form/justify/fontsize in points*
- To write station code. [Default is 0.0/0/5/12].
-
-.. include:: ../../explain_-U.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-**-W**\ *pen*
- Set current pen attributes [Defaults: width = default, color = black, style = solid].
-
-.. include:: ../../explain_-XY.rst_
-.. include:: ../../explain_-c.rst_
-.. include:: ../../explain_-icols.rst_
-.. include:: ../../explain_colon.rst_
-.. include:: ../../explain_help.rst_
-
-Examples
---------
-
- ::
-
- gmt pspolar -R239/240/34/35.2 -JM8c -N -Sc0.4 -h1 -D39.5/34.5 -M5 << END > test.ps
- #stat azim ih pol
- 0481 11 147 c
- 6185 247 120 d
- 0485 288 114 +
- 0490 223 112 -
- 0487 212 109 .
- END
-
-or
-
- ::
-
- gmt pspolar -R239/240/34/35.2 -JM8c -N -Sc0.4 -h1 -D239.5/34.5 -M5 <<END > test.ps
- #Date Or. time stat azim ih
- 910223 1 22 0481 11 147 ipu0
- 910223 1 22 6185 247 120 ipd0
- 910223 1 22 0485 288 114 epu0
- 910223 1 22 0490 223 112 epd0
- 910223 1 22 0487 212 109 epu0
- END
-
-See Also
---------
-
-:doc:`gmt </gmt>`, :doc:`psbasemap </psbasemap>`, :doc:`psxy </psxy>`
-
-References
-----------
-
-Bomford, G., Geodesy, 4th ed., Oxford University Press, 1980.
-
-Aki, K. and P. Richards, Quantitative Seismology, Freeman, 1980.
-
-Authors
--------
-
-Genevieve Patau, `Laboratory of Seismogenesis <http://www.ipgp.fr/rech/sismogenese/>`,
-Institut de Physique du Globe de Paris, Departement de Sismologie, Paris, France
diff --git a/doc_release/html/_sources/supplements/meca/psvelo.txt b/doc_release/html/_sources/supplements/meca/psvelo.txt
deleted file mode 100644
index 9a4cfbe..0000000
--- a/doc_release/html/_sources/supplements/meca/psvelo.txt
+++ /dev/null
@@ -1,274 +0,0 @@
-.. index:: ! psvelo
-
-******
-psvelo
-******
-
-.. only:: not man
-
- psvelo - Plot velocity vectors, crosses, and wedges on maps
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**psvelo** [ *table* ] **-J**\ *parameters*
-|SYN_OPT-R|
-[ **-A**\ *parameters* ]
-[ |SYN_OPT-B| ]
-[ **-F**\ *color* ] [ **-E**\ *color* ] [ **-G**\ *fill* ] [ **-K** ]
-[ **-L** ] [ **-N** ] [ **-O** ] [ **-P** ]
-[ **-S**\ *symbol*/*scale*/*conf*/*font\_size* ] [
-[ |SYN_OPT-U| ]
-[ |SYN_OPT-V| ]
-[ **-W**\ *pen* ]
-[ |SYN_OPT-X| ]
-[ |SYN_OPT-Y| ]
-[ |SYN_OPT-c| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**psvelo** reads data values from *files* [or standard input] and
-generates PostScript code that will plot velocity arrows on a map.
-Most options are the same as for :doc:`psxy </psxy>`, except **-S**. The
-PostScript code is written to standard output. The previous version
-(**psvelomeca**) is now obsolete. It has been replaced by **psvelo** and
-:doc:`psmeca`.
-
-Required Arguments
-------------------
-
-.. |Add_intables| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_intables.rst_
-
-.. include:: ../../explain_-J.rst_
-
-.. |Add_-Rgeo| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-Rgeo.rst_
-
-**-S**
-
-Selects the meaning of the columns in the data file and the figure to be
-plotted.
-
-**-Se**\ *velscale/confidence/fontsize*.
-
-Velocity ellipses in (N,E) convention. *Vscale* sets the scaling of the
-velocity arrows. This scaling gives inches (unless **c**, **i**, **m**,
-or **p** is appended). *Confidence* sets the 2-dimensional confidence
-limit for the ellipse, e.g., 0.95 for 95% confidence ellipse. *Fontsize*
-sets the size of the text in points. The ellipse will be filled with the
-color or shade specified by the **-G** option [default transparent]. The
-arrow and the circumference of the ellipse will be drawn with the pen
-attributes specified by the **-W** option. Parameters are expected to be
-in the following columns:
-
- **1**,\ **2**:
- longitude, latitude of station (**-:** option interchanges order)
- **3**,\ **4**:
- eastward, northward velocity (**-:** option interchanges order)
- **5**,\ **6**:
- uncertainty of eastward, northward velocities (1-sigma) (**-:**
- option interchanges order)
- **7**:
- correlation between eastward and northward components
- **8**:
- name of station (optional).
-
-**-Sn**\ *barscale.*
-
-Anisotropy bars. *Barscale* sets the scaling of the bars This scaling
-gives inches (unless **c**, **i**, **m**, or **p** is appended).
-Parameters are expected to be in the following columns:
-
- **1**,\ **2**:
- longitude, latitude of station (**-:** option interchanges order)
- **3**,\ **4**:
- eastward, northward components of anisotropy vector (**-:** option
- interchanges order)
-
-**-Sr**\ *velscale/confidence/fontsize*
-
-Velocity ellipses in rotated convention. *Vscale* sets the scaling of
-the velocity arrows. This scaling gives inches (unless **c**, **i**,
-**m**, or **p** is appended). *Confidence* sets the 2-dimensional
-confidence limit for the ellipse, e.g., 0.95 for 95% confidence ellipse.
-*Fontsize* sets the size of the text in points. The ellipse will be
-filled with the color or shade specified by the **-G** option [default
-transparent]. The arrow and the circumference of the ellipse will be
-drawn with the pen attributes specified by the **-W** option. Parameters
-are expected to be in the following columns:
-
- **1**,\ **2**:
- longitude, latitude, of station (**-:** option interchanges order)
- **3**,\ **4**:
- eastward, northward velocity (**-:** option interchanges order)
- **5**,\ **6**:
- semi-major, semi-minor axes
- **7**:
- counter-clockwise angle, in degrees, from horizontal axis to major
- axis of ellipse.
- **8**:
- name of station (optional)
-
-**-Sw**\ *wedge\_scale/wedge\_mag*.
-
-Rotational wedges. *Wedge\_scale* sets the size of the wedges in inches
-(unless **c**, **i**, **m**, or **p** is appended). Values are
-multiplied by *Wedge\_mag* before plotting. For example, setting
-*Wedge\_mag* to 1.e7 works well for rotations of the order of 100
-nanoradians/yr. Use **-G** to set the fill color or shade for the wedge,
-and **-E** to set the color or shade for the uncertainty. Parameters are
-expected to be in the following columns:
-
- **1**,\ **2**:
- longitude, latitude, of station (**-:** option interchanges order)
- **3**:
- rotation in radians
- **4**:
- rotation uncertainty in radians
-
-**-Sx**\ *cross\_scale*
-
-gives Strain crosses. *Cross\_scale* sets the size of the cross in
-inches (unless **c**, **i**, **m**, or **p** is appended). Parameters
-are expected to be in the following columns:
-
- **1**,\ **2**:
- longitude, latitude, of station (**-:** option interchanges order)
- **3**:
- eps1, the most extensional eigenvalue of strain tensor, with
- extension taken positive.
- **4**:
- eps2, the most compressional eigenvalue of strain tensor, with
- extension taken positive.
- **5**:
- azimuth of eps2 in degrees CW from North.
-
-Optional Arguments
-------------------
-
-**-A**\ *parameters*
- Modify vector parameters. For vector heads, append vector head
- *size* [Default is 9p]. See VECTOR ATTRIBUTES for specifying
- additional attributes.
-
-.. include:: ../../explain_-B.rst_
-
-**-D**\ *Sigma\_scale*
- can be used to rescale the uncertainties of velocities (**-Se** and
- **-Sr**) and rotations (**-Sw**). Can be combined with the *confidence* variable.
-
-**-F**\ *fill*
- Sets the color or shade used for frame and annotation. [Default is black]
-
-**-E**\ *fill*
- Sets the color or shade used for filling uncertainty wedges
- (**-Sw**) or velocity error ellipses (**-Se** or **-Sr**). [If
- **-E** is not specified, the uncertainty regions will be transparent.]
-
-**-G**\ *fill*
- Specify color (for symbols/polygons) or pattern (for polygons)
- [Default is black]. Optionally, specify
- **-Gp**\ *icon\_size/pattern*, where *pattern* gives the number of
- the image pattern (1-90) OR the name of a icon-format file.
- *icon\_size* sets the unit size in inches. To invert black and white
- pixels, use **-GP** instead of **-Gp**. See **pspatterns** for
- information on individual patterns.
-
-.. include:: ../../explain_-K.rst_
-
-**-L**
- Draw lines. Ellipses and fault planes will have their outlines drawn
- using current pen (see **-W**).
-**-N**
- Do **NOT** skip symbols that fall outside the frame boundary
- specified by **-R**. [Default plots symbols inside frame only].
-
-.. include:: ../../explain_-O.rst_
-.. include:: ../../explain_-P.rst_
-.. include:: ../../explain_-U.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-**-W**
- Set pen attributes for velocity arrows, ellipse circumference and
- fault plane edges. [Defaults: width = default, color = black, style = solid].
-
-.. include:: ../../explain_-XY.rst_
-.. include:: ../../explain_-c.rst_
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-h.rst_
-
-.. include:: ../../explain_-icols.rst_
-.. include:: ../../explain_colon.rst_
-.. include:: ../../explain_help.rst_
-
-.. include:: ../../explain_vectors.rst_
-
-Examples
---------
-
-The following should make big red arrows with green ellipses, outlined
-in red. Note that the 39% confidence scaling will give an ellipse which
-fits inside a rectangle of dimension Esig by Nsig.
-
- ::
-
- gmt psvelo << END -h2 -R-10/10/-10/10 -W0.25p,red -Ggreen -L -Se0.2/0.39/18 \
- -B1g1 -Jx0.4/0.4 -A0.3p -P -V > test.ps
- #Long. Lat. Evel Nvel Esig Nsig CorEN SITE
- #(deg) (deg) (mm/yr) (mm/yr)
- 0. -8. 0.0 0.0 4.0 6.0 0.500 4x6
- -8. 5. 3.0 3.0 0.0 0.0 0.500 3x3
- 0. 0. 4.0 6.0 4.0 6.0 0.500
- -5. -5. 6.0 4.0 6.0 4.0 0.500 6x4
- 5. 0. -6.0 4.0 6.0 4.0 -0.500 -6x4
- 0. -5. 6.0 -4.0 6.0 4.0 -0.500 6x-4
- END
-
-This example should plot some residual rates of rotation in the Western
-Transverse Ranges, California. The wedges will be dark gray, with light
-gray wedges to represent the 2-sigma uncertainties.
-
- ::
-
- gmt psvelo << END -Sw0.4/1.e7 -W0.75p -Gdarkgray -Elightgray -h1 -D2 -Jm2.2 \
- -R240./243./32.5/34.75 -Bf10ma60m/WeSn -P > test.ps
- #lon lat spin(rad/yr) spin_sigma (rad/yr)
- 241.4806 34.2073 5.65E-08 1.17E-08
- 241.6024 34.4468 -4.85E-08 1.85E-08
- 241.0952 34.4079 4.46E-09 3.07E-08
- 241.2542 34.2581 1.28E-07 1.59E-08
- 242.0593 34.0773 -6.62E-08 1.74E-08
- 241.0553 34.5369 -2.38E-07 4.27E-08
- 241.1993 33.1894 -2.99E-10 7.64E-09
- 241.1084 34.2565 2.17E-08 3.53E-08
- END
-
-See Also
---------
-
-:doc:`gmt </gmt>`, :doc:`psbasemap </psbasemap>`, :doc:`psxy </psxy>`
-
-References
-----------
-
-Bomford, G., Geodesy, 4th ed., Oxford University Press, 1980.
-
-Authors
--------
-
-`Kurt L. Feigl <http://www.geology.wisc.edu/~feigl/>`_, Department of Geology and
-Geophysics at University of Wisconsin-Madison, Madison, Wisconsin, USA
-
-Genevieve Patau, `Laboratory of Seismogenesis <http://www.ipgp.fr/rech/sismogenese/>`_,
-Institut de Physique du Globe de Paris, Departement de Sismologie, Paris, France
diff --git a/doc_release/html/_sources/supplements/mgd77/mgd77convert.txt b/doc_release/html/_sources/supplements/mgd77/mgd77convert.txt
deleted file mode 100644
index f00e439..0000000
--- a/doc_release/html/_sources/supplements/mgd77/mgd77convert.txt
+++ /dev/null
@@ -1,158 +0,0 @@
-.. index:: ! mgd77convert
-
-**************
-mgd77convert
-**************
-
-.. only:: not man
-
- mgd77convert - Convert MGD77 data to other file formats
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**mgd77convert** *NGDC-ids* **-Fa**\ \|\ **c**\ \|\ **m** \|\ **t**
-**-T**\ [**+**\ ]\ **a**\ \|\ **c**\ \|\ **m**\ \|\ **t**
-[ **-C** ]
-[ **-D** ]
-[ **-L**\ [**w**][**e**][**+**] ]
-[ |SYN_OPT-V| ]
-
-|No-spaces|
-
-Description
------------
-
-**mgd77convert** reads versions of MGD77 files and writes the same data
-in (probably) another format to a new file in the current directory.
-Both pre- and post-Y2K MGD77 formats can be processed.
-
-Required Arguments
-------------------
-
-.. include:: explain_ncid.rst_
-
-**-Fa**\ \|\ **c**\ \|\ **m** \|\ **t**
- Specifies the format of the input (From) files. Choose from **a**
- for standard MGD77 ASCII table (with extension .mgd77), **c** for
- the new MGD77+ netCDF format (with extension .nc), **m** for the
- new MGD77 t format (extension .m77t) and **t** for a
- plain ASCII tab-separated table dump (with extension .dat). Use
- **-FC** to recover the original MGD77 setting from the MGD77+ file
- [Default will apply any E77 corrections encoded in the file].
-**-T**\ [**+**\ ]\ **a**\ \|\ **c**\ \|\ **m** \|\ **t**
- Specifies the format of the output (To) files. Choose from **a** for
- standard MGD77 ASCII table (with extension .mgd77), **c** for the
- new MGD77+ netCDF format (with extension .nc), **m** for the
- new MGD77 t format (extension .m77t) and **t** for a plain
- ASCII tab-separated table dump (with extension .dat). We will refuse
- to create the file(s) if they already exist in the current
- directory. Prepend **+** to override this policy.
-
-Optional Arguments
-------------------
-
-**-C**
- Convert from NGDC two-file data sets \*.h77, \*.a77 to single file
- \*.mgd77. No other options (except **-V**) are allowed. Give one or
- more names of \*.h77 files, \*.a77 files, or just the file prefixes.
-**-D**
- By default, the storage types used in a MGD77+ netCDF file greatly
- exceed the precision imposed by the ASCII MGD77 format. However, for
- the five items **faa**, **eot**, **mag**, **diur** and **msd** we
- use 2-byte integers with implied precisions of 0.1 mGal, 0.1 nTesla,
- and 1 m as in the MGD77 format. It is possible that at some point
- these items will need to be stored as 4-byte ints which would allow
- precisions of 10 fTesla, 1 nGal, and 0.01 mm, respectively. This
- option activates such storage [Default uses 2-byte integers].
-**-L**\ [**w**\ ][**e**\ ][**+**\ ]
- Set the level of verification reporting [none] and where to send
- such reports [stderr]. Append a combination of **w** for warnings,
- **e** for errors, and **+** to send such log information to stdout.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-.. include:: ../../explain_help.rst_
-
-Examples
---------
-
-To convert a large set of a77,h77 pairs to proper mgd77 files, try
-
- ::
-
- gmt mgd77convert -C *.h77
-
-To convert 01010047.mgd77 and 01010008.mgd77 to new netCDF .nc files,
-and capture all verification messages, try
-
- ::
-
- gmt mgd77convert 01010047 01010008 -Fa -Tc -V -Lew+ > log.lis
-
-To convert 01010047.nc back to MGD77 ASCII and make sure it is identical
-to the original file, try (Bourne shell syntax)
-
- ::
-
- orig=`gmt mgd77path 01010047 -Ic`
- gmt mgd77convert 01010047 -Fc -Ta -V
- diff $orig 01010047.mgd77
-
-To convert 01010047.nc to a plain ASCII table for manual editing,
-overwriting any existing table, try
-
- ::
-
- gmt mgd77convert 01010047 -Fc -T+t -V
-
-To recover the original NGDC MGD77 version of 01020051.nc and ignore any
-E77 corrections, use
-
- ::
-
- gmt mgd77convert 01020051 -FC -Ta -V
-
-File Formats
-------------
-
-**mgd77convert** handles three different formats. (1) The MGD77 ASCII
-tables are the established standard for distribution of underway
-geophysical data to and from the NGDC data center. Normally, only the
-ship-operations people and the cruise PI might be involved in *making*
-an MGD77 ASCII file for transmission to NGDC; users are more interested
-in *reading* such files. (2) The MGD77+ netCDF format was developed to
-fascilitate the use of MGD77 data by scientists. It contains all the
-information of the original MGD77 file and if you convert back and forth
-you end up with the original. However, file sizes are typically ~30% of
-the original ASCII format and is much faster to operate on. (3) The
-plain ASCII tab-separated dump is available for users who need to
-manually edit the content of a MGD77 file. This is usually easier to do
-when the columns are tab-separated than when they are all crunched
-together in the MGD77 punch-card format.
-
-Other Tools
------------
-
-The MGD77+ netCDF files are CF-1.0 and COARDS compliant and can be
-examined with general-purpose tools such as ncBrowse and ncView.
-
-See Also
---------
-
-:doc:`mgd77manage`,
-:doc:`mgd77list`,
-:doc:`mgd77info`,
-:doc:`mgd77track`
-:doc:`x2sys_init <../x2sys/x2sys_init>`
-
-References
-----------
-
-ncBrowse, see `<http://www.epic.noaa.gov/java/ncBrowse/>`_
-ncView, see `<http://meteora.ucsd.edu/~pierce/ncview_home_page/>`_
-The Marine Geophysical Data Exchange Format - "MGD77", see
-`<http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt>`_
diff --git a/doc_release/html/_sources/supplements/mgd77/mgd77info.txt b/doc_release/html/_sources/supplements/mgd77/mgd77info.txt
deleted file mode 100644
index d22ea41..0000000
--- a/doc_release/html/_sources/supplements/mgd77/mgd77info.txt
+++ /dev/null
@@ -1,155 +0,0 @@
-.. index:: ! mgd77info
-
-*********
-mgd77info
-*********
-
-.. only:: not man
-
- mgd77info - Extract information about MGD77 files
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**mgd77info** *NGDC-ids*
-[ **-C**\ [**m**\ \|\ **e**] ]
-[ **-E**\ [**m**\ \|\ **e**] ] [ **-I**\ *ignore* ]
-[ **-Mf**\ [*item*]\|\ **r**\ \|\ **e**\ \|\ **h** ]
-[ **-L**\ [**v**\ ] ]
-[ |SYN_OPT-V| ]
-
-|No-spaces|
-
-Description
------------
-
-**mgd77info** reads <legid>.[mgd77\|nc] files and produces a single
-record of information about each cruise specified. The information
-includes beginning and end times, total track distances in km, longitude
-and latitude range, and the total number of geophysical observations.
-Optionally, choose instead to see the original MGD77 header meta-data
-section or its individual members.
-
-If you need to know which tracks are crossing through a given region and
-what kinds of geophysical observations are available, consider using the
-x2sys tools to set up a tracks index data base (see **x2sys\_init** for
-more information).
-
-Required Arguments
-------------------
-
-.. include:: explain_ncid.rst_
-
-Optional Arguments
-------------------
-
-**-C**\ [**m**\ \|\ **e**]
- List abbreviations for all columns present in the MGD77[+] files.
- Append **m** or **e** to limit the display to the MGD77 standard or
- MGD77+ extended set only.
-
-**-E**\ [**m**\ \|\ **e**]
- Give a one-line summary for each cruise listed.
-
-**-Mf**\ [*item*]\|\ **r**\ \|\ **e**\ \|\ **h**
- List the meta-data (header) and (if present) the MGD77+ history for
- each cruise. Append **f** for a formatted display. This will list
- individual parameters and their values, one entry per output line,
- in a format that can be searched using standard UNIX text tools.
- Alternatively, append the name of a particular parameter (you only
- need to give enough characters - starting at the beginning - to
- uniquely identify the item). Give - to display the list of all
- parameter names. You may also specify the number of a parameter. For
- the raw, punchcard-formatted MGD77 original header block, append
- **r** instead. For the MGD77+ E77 status, append **e** instead.
- Finally, for the MGD77+ history, append **h** instead.
-
-**-I**\ *ignore*
- Ignore certain data file formats from consideration. Append
- **a\|c\|t** to ignore MGD77 ASCII, MGD77+ netCDF, or plain
- tab-separated ASCII table files, respectively. The option may be
- repeated to ignore more than one format. [Default ignores none].
-
-**-L**\ [**v**\ ]
- No cruise information is listed. Instead, we just display a list of
- the GEODAS institution 2-character codes and their names.
- Optionally, append **v** to also display the vessels and their
- 4-character codes for each institution. The following is the list of
- institutions:
- (01) LAMONT (LDEO), (02) WOODS HOLE O.I., (03) NOAA, (04) US ARMY,
- (05) NEW ZEALAND, (06) US GEOL. SURVEY, (07) OREGON ST. UNIV, (08)
- U.HAWAII SOEST, (09) US NAVY, (10) UNIV OF TEXAS, (11) RICE UNIV.,
- (12) CANADA, (13) UNIV OF CONN., (14) U.MIAMI (RSMAS), (15) SCRIPPS
- INST.OC, (16) CHINA, (17) U RHODE ISLAND, (18) DUKE UNIVERSITY, (19)
- UNITED KINGDOM, (20) U.WASHINGTON, (22) WESTERN GEOPHY., (23) TEXAS
- A&M UNIV., (24) AUSTRALIA, (25) MONACO, (29) RUSSIA, (30) SPAIN,
- (35) NIMA, (58) NETHERLANDS, (60) MIN MGMT SVC, (63) ISRAEL, (67)
- FRANCE, (71) SOUTH AFRICA, (75) US COAST GUARD, (76) BRAZIL, (77)
- INT. GRAV. BUR, (83) GERMANY, (84) ORSTOM NEW CAL, (86) CUBA, (87)
- ARGENTINA, (88) US NSF, (89) INDIA, (90) PORTUGAL, (92) FINLAND,
- (93) CHILE, (J1) HYDR DEPT JAPAN, (J2) GEOL SRVY JAPAN, (J4) UNIV
- TOKYO, (J5) KOBE UNIV, (J7) UNIV OF RYUKYUS, (J8) J.O.D.C. JAPAN,
- (J9) CHIBA UNIV, (JA) INST.POLAR RES., (ZZ) INST NOT CODED.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-.. include:: ../../explain_help.rst_
-
-Examples
---------
-
-To get one-line summary information about the cruises 01010047.mgd77 and
-01010008.mgd77, try
-
- ::
-
- gmt mgd77info 01010047 01010008 -E > listing.lis
-
-To see the original raw MGD77 header meta-data for cruise 01010047.mgd77, run
-
- ::
-
- gmt mgd77info 01010047 -Mr
-
-To determine all the parameters related to Gravity during cruise 01010047.mgd77, run
-
- ::
-
- gmt mgd77info 01010047 -Mf | grep Gravity
-
-To determine the Magnetic sampling rate used during cruise 01010047.mgd77, run
-
- ::
-
- gmt mgd77info 01010047 -MfMagnetics_Sampling_Rate
-
-To see all the columns that the MGD77+ cruise 01010047.nc contains, run
-
- ::
-
- gmt mgd77info 01010047 -C
-
-To see the E77 status of all MGD77+ cruises collected by the University
-of Hawaii (institution 08), run
-
- ::
-
- gmt mgd77info 08 -Ia -Me
-
-See Also
---------
-
-:doc:`mgd77list`,
-:doc:`mgd77manage`,
-:doc:`mgd77path`,
-:doc:`mgd77track`,
-:doc:`x2sys_init <../x2sys/x2sys_init>`
-
-References
-----------
-
-The Marine Geophysical Data Exchange Format - MGD77, see
-`http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt. <http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt.>`_
diff --git a/doc_release/html/_sources/supplements/mgd77/mgd77list.txt b/doc_release/html/_sources/supplements/mgd77/mgd77list.txt
deleted file mode 100644
index 0331901..0000000
--- a/doc_release/html/_sources/supplements/mgd77/mgd77list.txt
+++ /dev/null
@@ -1,586 +0,0 @@
-.. index:: ! mgd77list
-
-*********
-mgd77list
-*********
-
-.. only:: not man
-
- mgd77list - Extract data from MGD77 files
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**mgd77list** *NGDC-ids* **-F**\ *columns*\ [,\ *logic*][:\ *bittests*]
-[ **-A**\ [**+**\ ]\ **c**\ \|\ **d**\ \|\ **f**\ \|\ **m**\ \|\ **t**\ *code* ]
-[ **-C**\ **f**\ \|\ **g**\ \|\ **e** ]
-[ **-D**\ **A**\ \|\ **a**\ *startdate* ]
-[ **-D**\ **B**\ \|\ **b**\ *stopdate* ] [ **-E** ] [ **-Ga**\ *startrec* ]
-[ **-Gb**\ *stoprec* ] [ **-I**\ *ignore* ] [ **-L**\ [*corrtable*] ]
-[ **-Nd**\ \|\ **s**\ *unit* ]
-[ **-Q**\ **a**\ \|\ **c**\ \|\ **v**\ *min*/*max* ]
-[ |SYN_OPT-R| ]
-[ **-Sa**\ *startdist*\ [unit] ] [ **-Sb**\ *stopdist*\ [unit] ]
-[ **-T**\ [**m**\ \|\ **e**] ]
-[ |SYN_OPT-V| ]
-[ **-W**\ *weight* ]
-[ **-Z**\ *+*\ \|\ **-** ]
-[ |SYN_OPT-bo| ]
-[ |SYN_OPT-h| ]
-
-|No-spaces|
-
-Description
------------
-
-**mgd77list** reads <NGDC-id>.[mgd77\|nc] files and produces an ASCII
-[or binary] table. The <NGDC-id>.[mgd77\|nc] files contain track
-information such as leg-id, time and position, geophysical observables
-such as gravity, magnetics, and bathymetry, and control codes and
-corrections such as Eotvos and diurnal corrections. The MGD77+ extended
-netCDF files may also contain additional user columns (for a listing of
-available columns, use :doc:`mgd77info` **-C**, and to learn how to add
-your own custom columns, see :doc:`mgd77manage`). The user may extract any
-combination of these parameters, any of 8 computed quantities (distance,
-heading, course-change, velocity, Carter correction, Eotvos correction
-and gravity and magnetic global reference fields), calendar sub-units of
-time (year, month, day, hour, min, sec), the NGDC id, and finally a
-preset weight (see **-W**). A sub-section can be specified by passing
-time- or distance-intervals along track or by selecting a geographical
-region. Finally, each output record may be required to pass any number
-of logical tests involving data values or bit flags. If multiple cruises
-are requested then they are separated by segment headers.
-
-Required Arguments
-------------------
-
-.. include:: explain_ncid.rst_
-
-
-**-F**\ *columns*\ [,\ *logic*][:\ *bittests*]
- The required *columns* string must be a comma-separated list of
- parameter abbreviations given in the desired output order. Any
- parameters given in UPPER case must not be NaN in a record for
- output to occur. Unless specified separately, the output format (if
- ASCII) is controlled by the GMT parameter :ref:`FORMAT_FLOAT_OUT <FORMAT_FLOAT_OUT>`.
- The available column abbreviations for information stored in the
- files (some columns may be NaN) are:
-
- **recno**
- The record number counter.
- **drt**
- The digital record type, usually 3 or 5 (for Y2K-compliant cruises).
- **id**
- The survey ID string (leg name).
- **ngdcid**
- The 8-character NGDC cruise ID string (usually the file prefix).
- **time**
- Choose between Absolute calendar time (**atime**, the default) in
- the format dictated by the GMT parameters :ref:`FORMAT_DATE_OUT <FORMAT_DATE_OUT>` and
- :ref:`FORMAT_CLOCK_OUT <FORMAT_CLOCK_OUT>`, Relative time (**rtime**) in the format
- dictated by the GMT parameters :ref:`FORMAT_FLOAT_OUT <FORMAT_FLOAT_OUT>` and
- :ref:`TIME_SYSTEM <TIME_SYSTEM>` (or :ref:`TIME_EPOCH <TIME_EPOCH>` and :ref:`TIME_UNIT <TIME_UNIT>`)), or
- Fractional year (**ytime**) in the format dictated by
- :ref:`FORMAT_FLOAT_OUT <FORMAT_FLOAT_OUT>`.
- **lon**
- Longitude in the format dictated by the GMT parameter
- :ref:`FORMAT_GEO_OUT <FORMAT_GEO_OUT>`.
- **lat**
- Longitude in the format dictated by the GMT parameter
- :ref:`FORMAT_GEO_OUT <FORMAT_GEO_OUT>`.
- **twt**
- Two-Way Travel time (in s).
- **depth**
- Corrected bathymetry (in m, positive below sealevel).
- **mtf1**
- Magnetic Total Field intensity from sensor 1 (in nTesla).
- **mtf2**
- Magnetic Total Field intensity from sensor 2 (in nTesla).
- **mag**
- Residual magnetic anomaly (in nTesla).
- **gobs**
- Observed gravity (in mGal).
- **faa**
- Free-air gravity anomaly (in mGal).
- **ptc**
- Position Type Code (1 = fix, 3 = interpolated, 9 = unspecified).
- **bcc**
- Bathymetric Correction Code, indicating the procedure used to
- convert travel time to depth. (01-55 = Matthews' zone used to
- correct the depth, 59 = Matthews' corrections used but the zones is
- unspecified in the data record, 60 = S. Kuwahara formula for T-S, 61
- = Wilson formula for T-S, 62 = Del Grosso formula for T-S, 63 =
- Carter's tables, 88 = Other, described in header sections, 99 =
- unspecified).
- **btc**
- Bathymetric Type Code, indicating how the bathymetry value was
- obtained (1 = observed, 3 = interpolated, 9 = unspecified).
- **msens**
- Magnetic sensor for used to evaluate the residual field (1 = 1st or
- leading sensor, 2 = 2nd or trailing sensor, 9 = unspecified).
- **msd**
- Depth (or altitude) of the magnetic sensor (in m, positive below
- sealevel).
- **diur**
- Magnetic diurnal correction (in nTesla).
- **eot**
- Eotvos correction (in mGal).
- **sln**
- Seismic Line Number string.
- **sspn**
- Seismic Shot Point Number string.
- **nqc**
- Navigation Quality Code (5 = suspected, by source institution, 6 =
- suspected, by NGDC, 9 = no problems identified).
-
- In addition, the following derived navigational quantities can be requested:
-
- **year**
- The year of each record.
- **month**
- The month of each record.
- **day**
- The day of the month of each record.
- **hour**
- The hour of each record.
- **min**
- The minutes of each record.
- **sec**
- The decimal seconds of each record.
- **dist**
- Along-track distance from start of leg. For method of calculation,
- see **-C** [spherical great circle distances], and for distance
- units, see **-N** [km].
- **az**
- Ship azimuth (heading) measured clockwise from north (in degrees).
- **cc**
- Ship course change (change in heading) measured clockwise from north
- (in degrees).
- **vel**
- Ship speed; see **-N** for units [m/s].
-
- Finally, the following computed quantities can be requested:
-
- **weight**
- Weight assigned to this data set (see **-W**).
- **carter**
- Carter depth correction, if **twt** is present in file (in m). Sign:
- Correction is to be added to uncorrected depths to yield a corrected
- depth.
- **igrf**
- International geomagnetic reference field (total field) (in nTesla).
- **ngrav**
- International Gravity reference Field ("normal gravity") (in mGal).
- Field is selected based on the parameter Gravity Theoretical Formula
- Code in the cruise's MGD77 header. If this is not set or is invalid
- we default to the IGF 1980. Alternatively, specify the field
- directly using **-Af** (see that option for more details).
- **ceot**
- Calculated Eotvos correction from navigation, using E =
- 7.5038 \* V \* cos(lat) \* sin(az) + 0.004154 \* V^2
- (in mGal). Sign: Correction is to be added to uncorrected faa to
- yield a corrected faa.
-
- The following short-hand flags are also recognized:
-
- **mgd77**
- This results in all 27 MGD77 fields being written out in the offical MGD77 order.
- **mgd77t**
- The full set of all 26 columns in the MGD77T specification.
- **geo**
- This limits the output to 10 fields (**time**, **lon**, **lat** plus
- the seven geophysical observations **twt**, **depth**, **mtf1**,
- **mtf2**, **mag**, **gobs**, and **faa**). By appending **+** to
- either of these set we will also append **dist**, **azim**, **cc**,
- **vel**, and **weight** as listed above.
- **all**
- This returns all data columns in the file.
- **allt**
- As mgd77t but with time items written as a date-time string.
-
- As an option, logical tests may be added for any of the observations
- by appending ,\ *logic*, which is itself composed of one or more
- comma-separated instructions of the form *par*\ **OP**\ *value*,
- where *par* is one of the parameters listed above, **OP** is a
- logical operator (<, <=, =, !=, >=, >, \|), and *value* is a
- constant used in the comparison. Floating point parameters are
- compared numerically; character parameters are compared lexically
- (after leading and trailing blanks have been removed). The bit
- comparison (\|) means that at least one of the bits in *value* must
- be turned on in *par*. At least one of the tests must be true for
- the record to be output, except for tests using UPPER case
- parameters which all must be true for output to occur. Note that
- specifying a test does not imply that the corresponding column will
- be included in the output stream; it must be present in *columns*
- for that to occur. Note: some of the operators are special UNIX
- characters and you are advised to place quotes around the entire
- argument to **-F**.
-
- Finally, for MGD77+ files you may optionally append :*bittests*
- which is : (a colon) followed by one or more comma-separated +-*col*
- terms. This compares specific bitflags only for each listed column.
- Here, + means the chosen bit must be 1 (ON) whereas - means it must
- be 0 (OFF). All bit tests given must be passed. By default, MGD77+
- files that have the special **MGD77_flags** column present will use
- those flags, and observations associated with ON-bits (meaning they
- are flagged as bad) will be set to NaN; append : with no trailing
- information to turn this behavior off (i.e., no bit flags will be
- consulted).
-
-Optional Arguments
-------------------
-
-**-A**\ [**+**\ ]\ **c**\ \|\ **d**\ \|\ **f**\ \|\ **m**\ \|\ **t**\ *code*
- By default, corrected depth (**depth**), magnetic residual anomaly
- (**mag**), free-air gravity anomaly (**faa**), and the derived
- quantity Carter depth correction (**carter**) are all output as is
- (if selected in **-F**); this option adjusts that behavior. For each
- of these columns there are 2-4 ways to adjust the data. Append
- **c**\ (arter), **d**\ (epth), **f**\ (aa), or **m**\ (ag) and
- select the *code* for the procedure you want applied. You may select
- more than one procedure for a data column by summing their numerical
- *code*\ s (1, 2, 4, and 8). E.g., **-Ac**\ 3 will first try method
- **-Ac**\ 1 to estimate a Carter correction but if **depth** is NaN
- we will next try **-Ac**\ 2 which only uses **twt**. In all cases,
- if any of the values required by an adjustment procedure is NaN then
- the result will be NaN. This is also true if the original anomaly is
- NaN. Specify **-A+** to recalculate anomalies even if the anomaly in
- the file is NaN. Additionally, you can use **-At** to create fake
- times for cruises that has no time; these are based on distances and
- cruise duration.
-**-Ac**
- Determines how the **carter** correction term is calculated. Below,
- C(\ **twt**) stands for the Carter-corrected depth (it also depends
- on **lon**, **lat**), U(\ **twt**, *v*) is the uncorrected depth (=
- **twt** \* *v* / 2) using as *v* the "Assumed Sound Velocity"
- parameter in the MGD77 header (if it is a valid velocity, otherwise
- we default to 1500 m/s); alternatively, append your preferred
- velocity *v* in m/s, TU(\ **depth**, *v*) is the 2-way travel time
- estimated from the (presumably) uncorrected **depth**, and
- TC(\ **depth**) is the 2-way travel time obtained by inverting the
- (presumably) corrected **depth** using the Carter correction
- formula. Select from
-
- **-Ac1**\ [,\ *v*] returns difference between U(\ **twt**, *v*) and **depth** [Default].
-
- **-Ac2**\ [,\ *v*] returns difference between U(\ **twt**, *v*) and Carter (**twt**).
-
- **-Ac4**\ [,\ *v*] returns difference between (assumed uncorrected) **depth** and Carter (TU(**depth**)).
-
- **-Ac8**\ [,\ *v*] returns difference between U(TC(\ **depth**), *v*) and **depth**.
-
-**-Ad**
- Determines how the **depth** column output is obtained:
-
- **-Ad1** returns **depth** as stored in the data set [Default].
-
- **-Ad2**\ [,\ *v*] returns calculated uncorrected depth U(\ **twt**, *v*).
-
- **-Ad4** returns calculated corrected depth C(\ **twt**).
-
-**-Af**
- Determines how the **faa** column output is obtained. If **ngrav**
- (i.e., the International Gravity reference Field (IGF), or "normal
- gravity") is required it is selected based on the MGD77 header
- parameter "Theoretical Gravity Formula Code"; if this code is not
- present or is invalid we default to 4. Alternatively, append the
- preferred *field* (1-4) to select 1 (Heiskanen 1924), 2 (IGF 1930),
- 3 (IGF 1967) or 4 (IGF 1980). Select from
-
- **-Af1**\ [,\ *field*] returns **faa** as stored in the data set
- [Default]. Optionally, sets the IGF *field* to use if you also have
- requested **ngrav** as an output column in **-F**.
-
- **-Af2**\ [,\ *field*] returns the difference between **gobs** and
- **ngrav** (with optional *field* directive).
-
- **-Af4**\ [,\ *field*] returns the combination of **gobs** + **eot** -
- **ngrav** (with optional *field* directive).
-
- **-Af8**\ [,\ *field*] returns the combination of **gobs** +
- **pred_eot** - **ngrav** (with optional *field* directive).
-
-**-Am**
- Determines how the **mag** column output is obtained. There may be
- one or two total field measurements in the file (**mtf1** and
- **mtf2**), and the column **msens** may state which one is the
- leading sensor (1 or 2; it may also be undefined). Select from
-
- **-Am1** returns **mag** as stored in the data set [Default].
-
- **-Am2** returns the difference between **mgfx** and **igrf**, where
- **x** is the leading sensor (**1** or **2**) indicated by the
- **msens** data field (defaults to **1** if unspecified).
-
- **-Am4** returns the difference between **mgfx** and **igrf**, where
- **x** is the sensor (**2** or **1**) *not* indicated by the
- **msens** data field (defaults to **2** if unspecified).
-
- **-Amc<offset>[unit]** Apply a correction that tries to compensate
- the fact that the magnetic field was not acquired at the same
- position as the navigation refer (ship's position). This is
- accomplished by reinterpolating the total magnetic field to what it
- would have had if it was measured at the ship's position (remember,
- it probably was measured <offset> meters behind). Due to this
- interpolation step, bad navigation, namely too many repeated points,
- may cause troubles. Measures are taken to minimize this effect but
- they aren't 100% full prof. The interpolation method is controlled
- by the gmtdefaults GMT_INTERPOLANT. Append **e** for meter, **f**
- for feet, **k** for km, **m** for miles, **n** for nautical miles,
- or **u** for survey feet [Default is e (meters)].
-
-**-C**\ **f**\ \|\ **g**\ \|\ **e**
- Append a one-letter code to select the procedure for along-track
- distance calculation (see **-N** for selecting units):
-
- **f** Flat Earth distances.
-
- **g** Great circle distances [Default].
-
- **e** Geodesic distances on current GMT ellipsoid.
-
-**-Da**\ *startdate*
- Do not list data collected before *startdate*
- (yyyy-mm-ddBD(T)[hh:mm:ss]) [Default is start of cruise]. Use
- **-DA** to exclude records whose time is undefined (i.e., NaN).
- [Default reports those records].
-**-Db**\ *stopdate*
- Do not list data collected on or after *stopdate*
- (yyyy-mm-ddBD(T)[hh:mm:ss]). [Default is end of cruise]. Use **-DB**
- to exclude records whose time is undefined (i.e., NaN). [Default
- reports those records].
-**-E**
- Exact match: Only output records that match all the requested
- geophysical columns [Default outputs records that matches at least
- one of the observed columns].
-**-Ga**\ *startrec*
- Do not list records before *startrec* [Default is 0, the first
- record].
-**-Gb**\ *stoprec*
- Do not list data after *stoprec*. [Default is the last record].
-**-I**\ *ignore*
- Ignore certain data file formats from consideration. Append
- **a\|c\|t** to ignore MGD77 ASCII, MGD77+ netCDF, or plain
- tab-separated ASCII table files, respectively. The option may be
- repeated to ignore more than one format. [Default ignores none].
-**-L**\ [*corrtable*\ ]
- Apply optimal corrections to columns where such corrections are
- available. Append the correction table to use [Default uses the
- correction table mgd77_corrections.txt in the **$MGD77_HOME**
- directory]. For the format of this file, see CORRECTIONS below.
-**-n**
- Issue a segment header record with cruise ID for each cruise.
-**-Nd**\ \|\ **s**\ *unit*
- Append **d** for distance or **s** for speed, then give the desired
- *unit* as **e** (meter or m/s), **f** (feet or feet/s), **k** (km or
- km/hr), **m** (miles or miles/hr), **n** (nautical miles or knots),
- or **u** (survey feet or sfeet/s). [Default is **-Ndk** **-Nse** (km
- and m/s)].
-**-Qa**\ *min*/*max*
- Specify an accepted range (*min*/*max*) of azimuths. Records whose
- track azimuth falls outside this range are ignored [0/360].
-**-Qc**\ *min*/*max*
- Specify an accepted range (*min*/*max*) of course changes. Records
- whose track course change falls outside this range are ignored
- [-360/+360]. Use **-QC** to take the absolute value of the course
- change before the test [Default uses signed course changes].
-**-Qv**\ *min*/*max*
- Specify an accepted range (*min*/*max*; or just *min* if there is no
- upper limit) of velocities. Records whose track speed falls outside
- this range are ignored [0/infinity].
-
-.. |Add_-Rgeo| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-Rgeo.rst_
-
-**-Sa**\ *startdist*\ [unit]
- Do not list data that are less than *startdist* meter along track
- from port of departure. Append **e** for meter, **f** for feet,
- **k** for km, **m** for miles, **n** for nautical miles, or **u**
- for survey feet [Default is 0e (meters)].
-**-Sb**\ *stopdist*\ [unit]
- Do not list data that are *stopdist* or more meters along track from
- port of departure. Append **e** for meter, **f** for feet, **k** for
- km, **m** for miles, **n** for nautical miles, or **u** for survey
- feet [Default is end of track].
-**-T**\ [**m**\ \|\ **e**]
- Turns OFF the otherwise automatic adjustment of values based on
- correction terms that are stored in the MGD77+ file and used to
- counteract such things as wrong units used by the source institution
- when creating the original MGD77 file from which the MGD77+ file
- derives (the option has no effect on plain MGD77 ASCII files).
- Append **m** or **e** to limit the option to the MGD77 or extended
- columns set only [Default applies to both].
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-**-W**\ *weight*
- Set the weight for these data. Weight output option must be set in
- **-F**. This is useful if the data are to be processed with the
- weighted averaging techniques offered by **blockmean**,
- **blockmedian**, and **blockmode** [1].
-**-Z**\ *+*\ \|\ **-**
- Append the sign you want for **depth**, **carter**, and **msd**
- values below sea level (**-Z-** gives negative bathymetry) [Default
- is positive down].
-
-.. |Add_-bo| replace:: ignored if **-bo** is selected. Likewise,
- string-fields cannot be selected. Note that if time is one of the
- binary output columns it will be stored as Unix-time (seconds since
- 1970). To read this information in GMT to obtain absolute calendar
- time will require you to use **-**\ **-TIME_SYSTEM=1**.
-.. include:: ../../explain_-bo.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-h.rst_
-
-.. include:: ../../explain_help.rst_
-
-Examples
---------
-
-To get a (distance, heading, gravity, bathymetry) listing from
-01010047.mgd77, starting at June 3 1971 20:45 and ending at distance =
-5000 km, use the following command:
-
- ::
-
- gmt mgd77list 01010047 -Da1971-06-03T20:45 -Sb5000 -Fdist,azim,faa,depth > myfile.d
-
-To make input for **blockmean** and **surface** using free-air anomalies
-from all the cruises listed in the file cruises.lis, but only the data
-that are inside the specified area, and make the output binary:
-
- ::
-
- gmt mgd77list `cat cruises.lis` -Flon,lat,faa -R-40/-30/25/35 -bo > allgrav.b
-
-To extract the locations of depths exceeding 9000 meter that were not
-interpolated (**btc** != 1) from all the cruises listed in the file
-cruises.lis:
-
- ::
-
- gmt mgd77list ‘cat cruises.lis‘ -F"depth,DEPTH>9000,BTC!=1" > really_deep.d
-
-To extract dist, faa, and grav12_2 from records whose depths are
-shallower than 3 km and where none of the requested fields are NaN, from
-all the MGD77+ netCDF files whose cruise ids are listed in the file
-cruises.lis, we try
-
- ::
-
- gmt mgd77list ‘cat cruises.lis‘ -E -Ia -F"dist,faa,grav12_2,depth<3000" > \
- shallow_grav.d
-
-To extract dist, faa, and grav12_2 from all the MGD77+ netCDF files
-whose cruise ids are listed in the file cruises.lis, but only retrieve
-records whose bitflag for faa indicates BAD values, we try
-
- ::
-
- gmt mgd77list ‘cat cruises.lis‘ -E -Ia -F"dist,faa,grav12_2:+faa" > bad_grav.d
-
-To output lon, lat, mag, and faa from all the cruises listed in the file
-cruises.lis, but recalculate the two residuals based on the latest
-reference fields, try:
-
- ::
-
- gmt mgd77list ‘cat cruises.lis‘ -Flon,lat,mag,faa -Af2,4 -Am2 > data.d
-
-Recalculated Anomalies
-----------------------
-
-When recalculated anomalies are requested (either explicitly via the
-**-A** option or implicitly via E77 metadata in the MGD77+ file) we only
-do so for the records whose original anomaly was not a NaN. This
-restriction is implemented since many anomaly columns contains
-corrections, usually in the form of hand-edited changes, that cannot be
-duplicated from the corresponding observation.
-
-Igrf
-----
-
-The IGRF calculations are based on a Fortran program written by Susan
-Macmillan, British Geological Survey, translated to C via f2c by Joaquim
-Luis, U Algarve, and adapted to GMT-style by Paul Wessel.
-
-Igf
----
-
-The equations used are reproduced here using coefficients extracted
-directly from the source code (let us know if you find errors):
-
-(1) g = 978052.0 \* [1 + 0.005285 \* sin^2(lat) - 7e-6 \* sin^2(2\*lat)
-+ 27e-6 \* cos^2(lat) \* cos^2(lon-18)]
-
-(2) g = 978049.0 \* [1 + 0.0052884 \* sin^2(lat) - 0.0000059 \*
-sin^2(2\*lat)]
-
-(3) g = 978031.846 \* [1 + 0.0053024 \* sin^2(lat) - 0.0000058 \*
-sin^2(2\*lat)]
-
-(4) g = 978032.67714 \* [(1 + 0.00193185138639 \* sin^2(lat)) / sqrt (1
-- 0.00669437999013 \* sin^2(lat))]
-
-Corrections
------------
-
-The correction table is an ASCII file with coefficients and parameters
-needed to carry out corrections. Comment records beginning with # are
-allowed. All correction records are of the form
-
-*cruiseID observation correction*
-
-where *cruiseID* is a NGDC prefix, *observation* is one of the
-abbreviations for geophysical observations listed under **-F** above,
-and *correction* consists of one or more *term*\ s that will be summed
-up and then **subtracted** from the observation before output. Each
-*term* must have this exact syntax:
-
-*factor*\ [\*[*function*]([*scale*](\ *abbrev*\ [-*origin*]))[^\ *power*]]
-
-where terms in brackets are optional (the brackets themselves are not
-used but regular parentheses must be used as indicated). No spaces are
-allowed except between *term*\ s. The *factor* is the amplitude of the
-basis function, while the optional *function* can be one of sin, cos, or
-exp. The optional *scale* and *origin* can be used to translate the
-argument (before giving it to the optional function). The argument
-*abbrev* is one of the abbreviations for observations listed above. If
-*origin* is given as **T** it means that we should replace it with the
-value of *abbrev* for the very first record in the file (this is usually
-only done for *time*). If the first record entry is NaN we revert
-*origin* to zero. Optionally, raise the entire expression to the given
-*power*, before multiplying by the amplitude. The following is an
-example of fictitious corrections to the cruise 99999999, implying the
-**depth** should have the Carter correction removed, **faa** should have
-a linear trend removed, the magnetic anomaly (**mag**) should be
-corrected by a strange dependency on ship heading and latitude, and
-**gob**\ s needs to have 10 mGal added (hence given as -10):
-
-99999999 depth 1.0\*((carter))
-
-99999999 faa 14.1 1e-5\*((time-T))
-
-99999999 mag 0.5\*cos(0.5\*(azim-19))^2 1.0\*exp(-1e-3(lat))^1.5
-
-99999999 gobs -10
-
-See Also
---------
-
-:doc:`mgd77convert`,
-:doc:`mgd77info`,
-:doc:`mgd77manage`,
-:doc:`mgd77track`
-
-References
-----------
-
-The Marine Geophysical Data Exchange Format - MGD77, see
-`<http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt>`_
-
-IGRF, see `<http://www.ngdc.noaa.gov/IAGA/vmod/igrf/>`_
diff --git a/doc_release/html/_sources/supplements/mgd77/mgd77magref.txt b/doc_release/html/_sources/supplements/mgd77/mgd77magref.txt
deleted file mode 100644
index 6d1ccdc..0000000
--- a/doc_release/html/_sources/supplements/mgd77/mgd77magref.txt
+++ /dev/null
@@ -1,238 +0,0 @@
-.. index:: ! mgd77magref
-
-***********
-mgd77magref
-***********
-
-.. only:: not man
-
- mgd77magref - Evaluate the IGRF or CM4 magnetic field models
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**mgd77magref** [ *inputfile* ]
-[ **-A**\ [**+a**\ *alt*\ **+t**\ *date*\ **+y**] ] [ **-C**\ *cm4file* ]
-[ **-D**\ *Dstfile* ] [ **-E**\ *f107file* ] [ **-F**\ *flags* ]
-[ **-G** ] [ **-Sc**\ \|\ **l**\ *low/high* ] [ |SYN_OPT-V| ]
-[ |SYN_OPT-b| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**mgd77magref** will evaluate the IGRF or the CM4 geomagnetic models at
-the specified locations and times.
-
-Required Arguments
-------------------
-
-None.
-
-Optional Arguments
-------------------
-
-*inputfile*
- Contains the moments in space-time where we want to evaluate the
- magnetic reference field. The first two columns must contain
- longitude and latitude (however, see **-:** for latitude and
- longitude instead). Normally, the third and fourth columns must
- contain altitude (in km) and time, respectively, but if one or both
- of these are constant for all records they can be supplied via the
- **-A** option instead and are thus not expected in the input file.
- If no input file is given we read *stdin*. |br|
- A note about the CM4
- validity domain. The core field of CM4 is valid from 1960-2002.5 but
- the ionospheric and magnetospheric fields are computed after the
- *Dst* and *F10.7* coefficient files. We extended here those
- coefficient files up to 2006, which means that one can compute
- external contributions up until 2006 but the Secular Variation will
- be biased (non reliable). New indices files may be retrieved from
- from:ftp://ftp.ngdc.noaa.gov/STP/GEOMAGNETIC_DATA/INDICES/DST/ (the
- *Dst* coefficients) and
- http://umbra.nascom.nasa.gov/sdb/yohkoh/ys_dbase/indices_flux_raw/Penticton_Absolute/monthly/MONTHPLT.ABS
- (The *F10.7* index file is a MONTHPLT.ABS). NOTE: since the *Dst* files
- in the .../DST/ directory are still only up to 2006, for GMT4.5.3 and after
- we extended the *Dst* until August 2009 by reformatting the data in the
- preliminary file Est_Ist_index_0_mean.pli, which is at
- ftp://ftp.ngdc.noaa.gov/STP/GEOMAGNETIC_DATA/INDICES/EST_IST/. But since
- this site is now also outdated, we now get the DST indices from
- http://wdc.kugi.kyoto-u.ac.jp/dstae/index.html However, for the most recent
- dates those indices are "Quick Look" (the best are the "Definitive" type).
- Because the *F10.7* from the MONTHPLT.ABS file mentioned above are apparently
- no being updated, we found another place where they are, which is:
- ftp://ftp.ngdc.noaa.gov/STP/space-weather/solar-data/solar-features/
- solar-radio/noontime-flux/penticton/penticton_absolute/listings/
- listing_drao_noontime-flux-absolute_monthly.txt
-
-**-A**\ [**+a**\ *alt*\ **+t**\ *date*\ **+y**]
- Adjusts how the input record is interpreted. Append **+a** to set a
- fixed *altitude* (in km) that should apply to all data records
- [Default expects *altitude* to be in the 3rd column of all records].
- Append **+t** to set a fixed *time* that should apply to all data
- records [Default expects *time* to be in the 4th column of all
- records]. Finally, append **+y** to indicate that all times are
- specified as decimal years [Default is ISO *date*\ T\ *colck* format, see
- :ref:`TIME_EPOCH <TIME_EPOCH>`].
-
-**-C**\ *cm4file*
- Specify an alternate CM4 coefficient file [umdl.CM4].
-
-**-D**\ *Dstfile*
- Specify an alternate file with hourly means of the Dst index for CM4
- [Dst_all.wdc]. Alternatively, simply specify a single index to
- apply for all records.
-
-**-E**\ *f107file*
- Specify an alternate file with monthly means of absolute F10.7 solar
- radio flux for CM4 [F107_mon.plt]. Alternatively, simply specify a
- single flux to apply for all records.
-
-**-F**\ *flags*
- Selects output items; *flags* is a string made up of one or more of
- these characters:
-
- **r** means output all input columns before adding the items below
-
- **t** means list total field (nT).
-
- **h** means list horizontal field (nT).
-
- **x** means list X component (nT, positive north).
-
- **y** means list Y component (nT, positive east).
-
- **z** means list Z component (nT, positive down).
-
- **d** means list declination (deg, clockwise from north).
-
- **i** means list inclination (deg, positive down).
-
- Append one or more number to indicate the requested field contribution(s):
-
- **0** means IGRF field (no combinations allowed)
-
- **1** means CM4 Core field
-
- **2** means CM4 Lithospheric field
-
- **3** means CM4 Primary Magnetospheric field
-
- **4** means CM4 Induced Magnetospheric field
-
- **5** means CM4 Primary ionospheric field
-
- **6** means CM4 Induced ionospheric field
-
- **7** means CM4 Toroidal field
-
- **9** means Core field from IGRF and other contributions from CM4.
- DO NOT USE BOTH 0 AND 9.
-
- Appending several numbers (1-7) will add up the different
- contributions. For example **-Ft**/**12** computes the total field
- due to Core and Lithospheric sources. Two special cases are allowed,
- which mix which Core field from IGRF and other sources from CM4.
- **-Ft**/**934** computes Core field due to IGRF plus terms 3 and 4
- from CM4 (but you can add others). **-Ft**/**934** the same as above
- but output the field components. The data is written out in the
- order they appear in *flags* [Default is **-Frthxyzdi**/**1**].
-
-**-G**
- Specifies that coordinates are geocentric [geodetic].
-
-**-L**
- Computes J field vectors from certain external sources.
-
- **r** means output all input columns before adding the items below (all in Ampers/m).
-
- **t** means list magnitude field.
-
- **x** means list X component.
-
- **y** means list Y component.
-
- **z** means list Z or current function Psi.
-
- Append a number to indicate the requested J contribution:
-
- **1** means Induced Magnetospheric field.
-
- **2** means Primary ionospheric field.
-
- **3** means Induced ionospheric field.
-
- **4** means Poloidal field.
-
-**-Sc**\ *low/high*
- Limits the wavelengths of the core field contribution to the band
- indicated by the low and high spherical harmonic order [1/13].
-
-**-Sl**\ *low/high*
- Limits the wavelengths of the lithosphere field contribution to the
- band indicated by the low and high spherical harmonic order [14/65].
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-.. |Add_-bi| replace:: [Default is 4 input columns unless **-A** is used].
-.. include:: ../../explain_-bi.rst_
-
-.. |Add_-bo| replace:: [Default is reflected by **-F**].
-.. include:: ../../explain_-bo.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-h.rst_
-
-.. include:: ../../explain_colon.rst_
-
-.. include:: ../../explain_help.rst_
-
-Time Settings
--------------
-
-If binary input files are used then absolute time are stored as time
-relative to the selected epoch. However, since the epoch used is not
-stored in the data files there can be problems decoding the correct
-time. The mgd77 supplement uses the Unix time system as its default;
-thus you should make sure that binary data files with time uses the same
-system (see the GMT default TIME_SYSTEM).
-
-Examples
---------
-
-To get the CM4 Total field, Declination and Inclination due to all but
-lithospheric and toroidal field at a one point location and decimal time
-2000.0, try
-
- ::
-
- echo -28 38 0 2000.0 | gmt mgd77magref -A+y -Ftdi/13456
-
-To do the same as above but at noon (Universal Time) of first May 2001, try
-
- ::
-
- echo -28 38 0 2001-05-01T12:00:00 | gmt mgd77magref -Ftdi/13456
-
-See Also
---------
-
-:doc:`gmt </gmt>`, :doc:`mgd77info`,
-:doc:`mgd77list`, :doc:`mgd77manage`,
-:doc:`mgd77track`, :doc:`gmt.conf </gmt.conf>`
-
-References
-----------
-
-Comprehensive Modeling of the Geomagnetic Field, see
-`http://denali.gsfc.nasa.gov/cm/ <http://denali.gsfc.nasa.gov/cm/>`_
-
-The International Geomagnetic Reference Field (IGRF), see
-`http://www.iugg.org/IAGA/iaga\_pages/pubs\_prods/igrf.htm <http://www.iugg.org/IAGA/iaga_pages/pubs_prods/igrf.htm>`_
diff --git a/doc_release/html/_sources/supplements/mgd77/mgd77manage.txt b/doc_release/html/_sources/supplements/mgd77/mgd77manage.txt
deleted file mode 100644
index 3c997be..0000000
--- a/doc_release/html/_sources/supplements/mgd77/mgd77manage.txt
+++ /dev/null
@@ -1,386 +0,0 @@
-.. index:: ! mgd77manage
-
-***********
-mgd77manage
-***********
-
-.. only:: not man
-
- mgd77manage - Manage the content of MGD77+ files
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**mgd77manage** *NGDC-ids*
-[ **-A**\ [**+**]\ **a**\ \|\ **c**\ \|\ **d**\ \|\ **D**\ \|\ **e**\ \|\ **E**\ \|\ **g**\ \|\ **i**\ \|\ **n**\ \|\ **t**\ \|\ **T**\ *fileinfo* ]
-[ **-C**\ **f**\ \|\ **g**\ \|\ **e** ]
-[ **-D**\ *abbrev1*,\ *abbrev2*,...) ] [ **-E**\ *empty* ] [ **-F** ]
-[ **-I**\ *abbrev*/*name*/*unit*/**t**/*scale*/*offset*/*comment* ]
-[ **-N**\ *unit* ]
-[ |SYN_OPT-R| ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-bi| ]
-[ |SYN_OPT-n| ]
-
-|No-spaces|
-
-Description
------------
-
-**mgd77manage** deals with maintaining extra custom columns in MGD77+
-netCDF files. You can either delete one or more columns, add a new
-column, update an existing column with new data, or supply error
-correction information (\*.e77 files). New data may come from a table
-(ASCII unless **-bi** is used), be based on
-existing columns and certain theoretical expressions, or they may be
-obtained by sampling a grid (choose between GMT grid or a Sandwell/Smith
-Mercator \*.img grid) along track. The new data will be appended to the
-MGD77+ file in the form of an extra data column of specified type. The
-data file will be modified; no new file will be created. For the big
-issues, see the DISCUSSION section below.
-
-Required Arguments
-------------------
-
-.. include:: explain_ncid.rst_
-
-
-Optional Arguments
-------------------
-
-**-A**\ [**+**\ ]\ **a**\ \|\ **c**\ \|\ **d**\ \|\ **D**\ \|\ **e**\ \|\ **E**\ \|\ **g**\ \|\ **i**\ \|\ **n**\ \|\ **t**\ \|\ **T**\ *fileinfo*
- Add a new data column. If an existing column with the same
- abbreviation already exists in the file we will cowardly refuse to
- update the file. Specifying **-A+** overcomes this reluctance
- (However, sometimes an existing column cannot be upgraded without
- first deleting it; if so you will be warned). Select a column source
- code among **a**, **c**, **d**, **D**, **e**, **g**, **i**, **n**,
- **t**, or **T**; detailed descriptions for each choice follow:
-
- **a** Append filename of a single column table to add. File must
- have the same number of rows as the MGD77+ file. If no file is given
- we read from stdin instead.
-
- **c** Create a new column that derives from existing data or
- formulas for corrections and reference fields. Append **c** for the
- Carter corrections subtracted from uncorrected depths, **g** for the
- IGF gravity reference field (a.k.a "normal gravity"), **m** for the
- IGRF total field magnetic reference field, and **r** for recomputed
- magnetic anomaly (append 1 or 2 to specify which total field column
- to use [1]). For gravity we choose the reference field based on the
- parameter Gravity Theoretical Formula Code in the cruise's MGD77
- header. If this is not set or is invalid we default to the IGF 1980.
- You can override this behaviour by appending the desired code: 1 =
- Heiskanen 1924, 2 = International 1930, 3 = IGF1967, or 4 = IGF1980.
-
- **d** Append filename of a two-column table with the first column
- holding distances along track and the second column holding data
- values. If no file is given we read from stdin instead. Records with
- matching distances in the MGD77+ file will be assigned the new
- values; at other distances we set them to NaN. Alternatively, give
- upper case **D** instead and we will interpolate the column at all
- record distances. See **-N** for choosing distance units and **-C**
- for choosing how distances are calculated.
-
- **e** Expects to find an e77 error/correction log from
- **mgd77sniffer** with the name *NGDC_ID*.e77 in the current
- directory or in $MGD77_HOME/E77; this file will examined and used
- to make modifications to the header values, specify a systematic
- correction for certain columns (such as scale and offset), specify
- that a certain anomaly should be recalculated from the observations
- (e.g., recalculate mag from mtf1 and the latest IGRF), and add or
- update the special column **flag** which may hold bitflags (0 =
- GOOD, 1 = BAD) for each data field in the standard MGD77 data set.
- Any fixed correction terms found (such as needing to scale a field
- by 0.1 or 10 because the source agency used incorrect units) will be
- written as attributes to the netCDF MGD77+ file and applied when the
- data are read by **mgd77list**. Ephemeral corrections such as those
- determined by crossover analysis are not kept in the data files but
- reside in correction tables (see **mgd77list** for details). By
- default, the first character of each header line in the e77 file
- (which is ?, Y or N) will be consulted to see if the corresponding
- adjustment should be applied. If any undecided settings are found
- (i.i, ?) we will abort and make no changes. Only records marked Y
- will be processed. You can override this behavior by appending one
- or more modifiers to the **-Ae** command: **h** will ignore all
- header corrections, **f** will ignore all fixed systematic trend
- corrections, **n**, **v**, and **s** will ignore bitflags pertaining
- to navigation, data values, and data slopes, respectively. Use
- **-A+e** to replace any existing E77 corrections in the file with
- the new values. Finally, e77 corrections will not be applied if the
- E77 file has not been verified. Use **-AE** to ignore the
- verification status.
-
- **g** Sample a GMT geographic (lon, lat) grid along the track given
- by the MGD77+ file using bicubic interpolation (however, see
- **-n**). Append name of a GMT grid file.
-
- **i** Sample a Sandwell/Smith Mercator \*.img grid along the track
- given by the MGD77+ file using bicubic interpolation (however, see
- **-n**). Append the img grid filename, followed by the
- comma-separated data scale (typically 1 or 0.1), the IMG file mode
- (0-3), and optionally the img grid max latitude [80.738]. The modes
- stand for the following: (0) Img files with no constraint code,
- returns data at all points, (1) Img file with constraints coded,
- return data at all points, (2) Img file with constraints coded,
- return data only at constrained points and NaN elsewhere, and
- (3) Img file with constraints coded, return 1 at constraints and 0 elsewhere.
-
- **n** Append filename of a two-column table with the first column
- holding the record number (0 to nrows - 1) and the second column
- holding data values. If no file is given we read from stdin instead.
- Records with matching record numbers in the MGD77+ file will be
- assigned the new values; at other records we set them to NaN.
-
- **t** Append filename of a two-column table with the first column
- holding absolute times along track and the second column holding
- data values. If no file is given we read from stdin instead. Records
- with matching times in the MGD77+ file will be assigned the new
- values; at other times we set them to NaN. Alternatively, give upper
- case **T** instead and we will interpolate the column at all record
- times.
-
-**-C**\ **f**\ \|\ **g**\ \|\ **e**
- Append a one-letter code to select the procedure for along-track
- distance calculation when using **-Ad**\ \|\ **D** (see **-N** for
- selecting distance units):
-
- **f** Flat Earth distances.
-
- **g** Great circle distances [Default].
-
- **e** Geodesic distances on current GMT ellipsoid.
-
-**-D**\ *abbrev1*,\ *abbrev2*,...)
- Give a comma-separated list of column abbreviations that you want to
- delete from the MGD77+ files. Do NOT use this option to remove
- columns that you are replacing with new data (use **-A+** instead).
- Because we cannot remove variables from netCDF files we must create
- a new file without the columns to be deleted. Once the file is
- successfully created we temporarily rename the old file, change the
- new filename to the old filename, and finally remove the old,
- renamed file.
-**-E**\ *empty*
- Give a single character that will be repeated to fill empty string
- values, e.g., "9" will yield a string like "99999..." [9].
-**-F**
- Force mode. When this mode is active you are empowered to delete or
- replace even the standard MGD77 set of columns. You better know what
- you are doing!
-**-I**\ *abbrev*/*name*/*unit*/**t**/*scale*/*offset*/*comment*
- In addition to file information we must specify additional
- information about the extra column. Specify a short (16 char or
- less, using lower case letters, digits, or underscores only)
- abbreviation for the selected data, its more descriptive name, the
- data unit, the data type 1-character code (**b**\ yte, **s**\ hort,
- **f**\ loat, **i**\ nt, **d**\ ouble, or **t**\ ext) you want used
- for storage in the netCDF file, any scale and offset we should apply
- to the data to make them fit inside the range implied by the chosen
- storage type, and a general comment (< 128 characters) regarding
- what these data represent. Note: If text data type is selected then
- the terms "values" in the **-A** discussion refer to your text data.
- Furthermore, the discussion on interpolation does not apply and the
- NaN value becomes a "no string" value (see **-E** for what this is).
- Place quotes around terms with more than one word (e.g., "Corrected Depth").
-**-N**\ *unit*
- Append the distance unit (see UNITS). [Default is **-Nk** (km)].
- Only relevant when **-Ag**\ \|\ **i** is selected.
-
-.. |Add_-R| replace:: Only relevant when **-Ag**\ \|\ **i** is selected.
-.. include:: ../../explain_-R.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-.. |Add_-bi| replace::
- This applies to the input 1- or 2-column data files specified under some
- of the **-A** options. The binary input option is only available for
- numerical data columns.
-.. include:: ../../explain_-bi.rst_
-
-.. include:: ../../explain_-n.rst_
-
-.. include:: ../../explain_help.rst_
-
-.. include:: ../../explain_distunits.rst_
-
-.. include:: ../../explain_grdresample2.rst_
-
-Examples
---------
-
-To append Geosat/ERS-1 gravity version 11.2 as an extra data column in
-the cruises 01010047.nc and 01010008.nc, storing the values as mGal\*10
-in a 2-byte short integer, try
-
- ::
-
- gmt mgd77manage 01010047 01010008 -Ai10/1/grav.11.2.img \
- -Isatgrav/"Geosat/ERS-1 gravity"/"mGal"/s/10/0/"Sandwell/Smith version 11.2" -V
-
-To append a filtered version of magnetics as an extra data column of
-type float for the cruise 01010047.nc, and interpolate the filtered data
-at the times given in the MGD77+ file, try
-
- ::
-
- gmt mgd77manage 01010047 -ATmymag.tm -Ifiltmag/"Intermediate-wavelength \
- magnetic residuals"/"nTesla"/f/1/0/"Useful for looking for isochrons" -V
-
-To delete the existing extra columns satfaa, coastdist, and satvgg from
-all MGD77+ files, try
-
- ::
-
- gmt mgd77manage =allmgd77.lis -Dsatfaa,coastdist,satvgg -V
-
-To create a 4-byte float column with the correct IGRF reference field in
-all MGD77+ files, try
-
- ::
-
- gmt mgd77manage =allmgd77.lis -Acm -Iigrf/"IGRF reference \
- field"/"nTesla"/f/1/0/"IGRF version 10 for 1990-2010" -V
-
-Discussion
-----------
-
-**1. Preamble**
-
-The mgd77 supplement is an attempt to (1) improve on the
-limited functionality of the existing mgg supplement, (2) incorporate
-some of the ideas from Scripps' gmt+ supplement by allowing extra data
-columns, and (3) add new capabilities for managing marine
-geophysical trackline data stored in an architecture-independent CF-1.0-
-and COARDS-compliant netCDF file format. Here are some of the underlying
-ideas and steps you need to take to maintain your files.
-
-**2. Introduction**
-
-Our starting point is the MGD77 ASCII data files distributed from NGDC
-on CD-ROMS, DVD-ROMS, and via FTP. Using Geodas to install the files
-locally we choose the "Carter corrected depth" option which will fill in
-the depth column using the two-way traveltimes and the Carter tables if
-twt is present. This step yields ~5000 individual cruise files. Place
-these in one or more sub-directories of your choice, list these
-sub-directories (one per line) in the file mgd77_paths.txt, and place
-that file in the directory pointed to by **$MGD77_HOME**; if not set
-this variable defaults to **$GMT_SHAREDIR**/mgd77.
-
-**3. Conversion**
-
-Convert the ASCII MGD77 files to the new netCDF MGD77+ format using
-**mgd77convert**. Typically, you will make a list of all the cruises to
-be converted (with or without extension), and you then run
-
- mgd77convert =cruises.lis -Fa -Tc -V -Lwe+ > log.txt
-
-The verbose settings will ensure that all problems found during
-conversion will be reported. The new \*.nc files may also be placed in
-one or more separate sub-directories and these should also be listed in
-the mgd77_paths.txt file. We suggest you place the directories with
-\*.nc files ahead of the \*.mgd77 directories. When you later want to
-limit a search to files of a certain extension you should use the **-I**
-option.
-
-**4. Adding new columns**
-
-**mgd77manage** will allow you to add additional data columns to your
-\*.nc files. These can be anything, including text strings, but most
-likely are numerical values sampled along the track from a supplied grid
-or an existing column that have been filtered or manipulated for a
-particular purpose. The format supports up to 32 such extra columns. See
-this man page for how to add columns. You may later decide to remove
-some of these columns or update the data associated with a certain
-column. Data extraction tools such as :doc:`mgd77list` can be used to
-extract a mix of standard MGD77 columns (navigation, time, and the usual
-geophysical observations) and your custom columns.
-
-**5. Error sources**
-
-Before we discuss how to correct errors we will first list the different
-classes of errors associated with MGD77 data: (1) Header record errors
-occur when some of the information fields in the header do not comply
-with the MGD77 specification or required information is missing.
-**mgd77convert** will list these errors when the extended verbose
-setting is selected. These errors typically do not affect the data and
-are instead errors in the *meta-data* (2). Fixed
-systematic errors occur when a particular data column, despite the MGD77
-specification, has been encoded incorrectly. This usually means the data
-will be off by a constant factor such as 10 or 0.1, or in some cases
-even 1.8288 which converts fathoms to meters. (3) Unknown systematic
-errors occur when the instrument that recorded the data or the
-processing that followed introduced signals that appear to be systematic
-functions of time along track, latitude, heading, or some other
-combination of terms that have a physical or logical explanation. These
-terms may sometimes be resolved by data analysis techniques such as
-along-track and across-track investigations, and will result in
-correction terms that when applied to the data will remove these
-unwanted signals in an optimal way. Because these correction terms may
-change when new data are considered in their determination, such
-corrections are considered to be ephemeral. (4) Individual data points
-or sequences of data may violate rules such as being outside of possible
-ranges or in other ways violate sanity. Furthermore, sequences of points
-that may be within valid ranges may give rise to data gradients that are
-unreasonable. The status of every point can therefore be determined and
-this gives rise to bitflags GOOD or BAD. Our policy is that error
-sources 1, 2, and 4 will be corrected by supplying the information as
-meta-data in the relevant \*.nc files, whereas the corrections for error
-source 3 (because they will constantly be improved) will be maintained
-in a separate list of corrections.
-
-**6. Finding errors**
-
-The **mgd77sniffer** is a tool that does a thorough along-track sanity
-check of the original MGD77 ASCII files and produces a corresponding
-\*.e77 error log. All problems found are encoded in the error log, and
-recommended fixed correction terms are given, if needed. An analyst may
-verify that the suggested corrections are indeed valid (we only want to
-correct truly obvious unit errors), edit these error logs and modify
-such correction terms and activate them by changing the relevant code
-key (see **mgd77sniffer** for more details). **mgd77manage** can ingest
-these error logs and (1) correct bad header records given
-the suggestions in the log, (2) insert scale/offset correction terms to
-be used when reading certain columns, and (3) insert any
-bit-flags found. Rerun this step if you later find other problems as all
-E77 settings or flags will be recreated based on the latest E77 log.
-
-**7. Error corrections**
-
-The extraction program :doc:`mgd77list` allows for corrections to be
-applied on-the-fly when data are requested. First, data with BAD
-bitflags are suppressed. Second, data with fixed systematic correction
-terms are corrected accordingly. Third, data with ephemeral correction
-terms will have those corrections applied (if a correction table is
-supplied). All of these steps require the presence of the relevant
-meta-data and all can be overruled by the user. In addition, users may
-add their own bitflags as separate data columns and use
-**mgd77list**'s logical tests to further dictate which data are
-suppressed from output.
-
-Credits
--------
-
-The IGRF calculations are based on a Fortran program written by Susan
-Macmillan, British Geological Survey, translated to C via f2c by Joaquim
-Luis, and adapted to GMT style by Paul Wessel.
-
-See Also
---------
-
-:doc:`mgd77convert`,
-:doc:`mgd77list`,
-:doc:`mgd77info`,
-:doc:`mgd77sniffer`
-:doc:`mgd77track`
-:doc:`x2sys_init <../x2sys/x2sys_init>`
-
-References
-----------
-
-The Marine Geophysical Data Exchange Format - MGD77, see
-`<http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt>`_
-
-IGRF, see `<http://www.ngdc.noaa.gov/IAGA/vmod/igrf.html>`_
diff --git a/doc_release/html/_sources/supplements/mgd77/mgd77path.txt b/doc_release/html/_sources/supplements/mgd77/mgd77path.txt
deleted file mode 100644
index 4998378..0000000
--- a/doc_release/html/_sources/supplements/mgd77/mgd77path.txt
+++ /dev/null
@@ -1,90 +0,0 @@
-.. index:: ! mgd77path
-
-*********
-mgd77path
-*********
-
-.. only:: not man
-
- mgd77path - Return paths to MGD77 cruises and directories
-
-Synopsis
--------------------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**mgd77path** *NGDC-ids* [ **-A**\ [**-**] ] [ **-D** ]
-[ **-I**\ *ignore* ]
-[ |SYN_OPT-V| ]
-
-|No-spaces|
-
-Description
------------
-
-**mgd77path** returns the full pathname to one or more MGD77 files. The
-pathname returned for a given cruise may change with time due to
-reshuffling of disks/subdirectories.
-
-Required Arguments
-------------------
-
-.. include:: explain_ncid.rst_
-
-Optional Arguments
-------------------
-
-**-A**\ [**-**]
- Display the full path to each cruise [Default]. Optionally, append
- **-** which will list just the cruise IDs instead.
-
-**-D**
- Instead of cruise listings, just show the directory paths currently
- used in the search.
-
-**-I**\ *ignore*
- Ignore certain data file formats from consideration. Append
- **a\|c\|t** to ignore MGD77 ASCII, MGD77+ netCDF, or plain
- tab-separated ASCII table files, respectively. The option may be
- repeated to ignore more than one format. [Default ignores none].
-
-.. |Add_-V| replace:: Reports the total number of cruises found.
-.. include:: ../../explain_-V.rst_
-
-.. include:: ../../explain_help.rst_
-
-Examples
---------
-
-To obtain pathnames for cruises 01010008 and 01010007, run
-
- ::
-
- gmt mgd77path 01010008 01010007
-
-To obtain pathnames for cruises 01010008 and 01010007, but only if there
-are MGD77+ version in netCDF, run
-
- ::
-
- gmt mgd77path 01010008 01010007 -Ia -It
-
-To see the list of active directories where MGD77 files might be stored, run
-
- ::
-
- gmt mgd77path -D
-
-See Also
---------
-
-:doc:`gmt </gmt>` :doc:`mgd77info`
-:doc:`mgd77list`
-:doc:`mgd77manage`
-:doc:`mgd77track`
-
-`References <#toc8>`_
----------------------
-
-The Marine Geophysical Data Exchange Format - MGD77, see
-`*http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt*. <http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt.>`_
diff --git a/doc_release/html/_sources/supplements/mgd77/mgd77sniffer.txt b/doc_release/html/_sources/supplements/mgd77/mgd77sniffer.txt
deleted file mode 100644
index e928131..0000000
--- a/doc_release/html/_sources/supplements/mgd77/mgd77sniffer.txt
+++ /dev/null
@@ -1,501 +0,0 @@
-.. index:: ! mgd77sniffer
-
-**************
-mgd77sniffer
-**************
-
-.. only:: not man
-
- mgd77sniffer - Along-track quality control of MGD77 cruises
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**mgd77sniffer** *NGDC-ids* [ **-A**\ *fieldabbrev*,\ *scale*,\ *offset* ]
-[ **-C**\ *maxspd* ]
-[ **-D**\ **d**\ \|\ **e**\ \|\ **E**\ \|\ **f**\ \|\ **l**\ \|\ **m**\ \|\ **s**\ \|\ **v**\ [*r*] ]
-[ **-G**\ *fieldabbrev*,\ *imggrid*,\ *scale*,\ *mode* or
-**-G**\ *fieldabbrev*,\ *grid* ] [ **-H** ]
-[ **-I**\ *fieldabbrev*,\ *rec1*,\ *recN* ] [ **-K** ]
-[ **-L**\ *custom-limits-file* ] [ **-N** ]
-[ |SYN_OPT-R| ]
-[ **-S**\ **d**\ \|\ **s**\ \|\ **t** ] [ **-T**\ *gap* ]
-[ |SYN_OPT-V| ]
-[ **-W**\ **c**\ \|\ **g**\ \|\ **o**\ \|\ **s**\ \|\ **t**\ \|\ **v**\ \|\ **x** ]
-[ |SYN_OPT-bo| ]
-[ |SYN_OPT-n| ]
-
-|No-spaces|
-
-Description
------------
-
-**mgd77sniffer** scans old (pre-Y2K) and new format ASCII MGD77 files
-for errors using point-by-point sanity checking, along-track detection
-of excessive slopes, and optional comparison of cruise data with global
-gravity and predicted bathymetry grids. Detected data problems are
-output by default as verbose descriptions of each detected error, often
-resulting in multiple messages per scanned record. Data problems are
-optionally output (**-De** option) using a computer-parseable format
-(see E77 ERROR FORMAT description below). Default error thresholds are
-derived from histograms of all MGD77 geophysical data collected between
-1952 and January, 2006. Thresholds are adjustable with the **-L**
-option.
-
-Requirements
-------------
-
-The mgd77sniffer links with Generic Mapping Tools 4.0 or later along
-with the supplemental GMT packages x2sys and mgd77. See
-`http://gmt.soest.hawaii.edu <http://gmt.soest.hawaii.edu>`_ for GMT
-details. Grids for comparison with cruise data may be downloaded via the web.
-
-Required Arguments
-------------------
-
-.. include:: explain_ncid.rst_
-
-Optional Arguments
-------------------
-
-**-A**\ *fieldabbrev*,\ *scale*,\ *offset*
- Apply scale factor and DC adjustment to specified data field. Allows
- adjustment of cruise data prior to along-track analysis. CAUTION:
- data must be thoroughly examined before applying these global data
- adjustments. May not be used for multiple cruises.
-
-**-C**\ *maxspd*
- Set maximum ship speed in m/s, or knots with **-N** option. Ship
- speeds exceeding 10 m/s (~20 knots) are flagged as excessive by default.
-
-**-D**\ **d**\ \|\ **e**\ \|\ **E**\ \|\ **f**\ \|\ **l**\ \|\ **m**\ \|\ **s**\ \|\ **v**\ [*r*]
- Suppress default warning output and only dump cruise data row-by-row
- such as values, gradients, grid-cruise differences, E77 error
- summaries for each record, re-created MGD77 records or sniffer
- limits. Append r to include all records (default omits records where
- navigation errors were detected).
-
- **-Dd** output differences between cruise and grid data. Requires
- **-G** option. Output columns include:
-
- *lat lon dist cruiseZ gridZ diff [cruiseZ2 gridZ2 diff2 ...]*
-
- Note: grid values are subtracted from cruise data so a positive
- difference implies cruise > grid. For multiple grid comparison,
- *cruiseZ gridZ diff* are repeated for each grid comparison in
- command line order.
-
- **-De** output E77 error classification format. Error output is
- divided into (1) a header containing information
- globally applicable to the cruise and (2) individual
- error records summarizing all errors encountered in each cruise
- record. mgd77sniffer writes E77 directly to <ngdc\_id.e77> file
- handle. See **E77 ERROR FORMAT** below for additional details.
-
- **-DE** Same as **-De** but no regression tests will be carried out.
-
- **-Df** output delta Z (change in geophysical field) column and
- delta S (change in distance) for each geophysical field. Distance
- between observations often differ for different fields depending on
- instrument sampling rate, so ds is included for each geophysical
- observation. Output columns include:
-
- *d[twt] ds d[depth] ds d[mtf1] ds d[mtf2] ds d[mag] ds d[diur] ds
- d[msd] ds d[gobs] ds d[eot] ds d[faa] ds*
-
- **-Dl** display mgd77sniffer limits. Customize this output to create
- a custom limits file for the **-L** option. No additional arguments
- are required. Output columns include:
-
- *fieldabbrev min max maxSlope maxArea*
-
- **-Dm** output MGD77 format records in Y2K-compliant MGD77 format
-
- **-Dn** output distance to coast for each record. Requires the **-Gnav**
- option. Output columns include:
-
- *lat lon dist distToCoast*
-
- **-Ds** output calculated gradients for speed and geophysical
- fields. Gradients correspond to the gradient type selected in the
- **-S** option (spatial derivatives by default). Output columns include:
-
- *speed d[twt] d[depth] d[mtf1] d[mtf2] d[mag] d[diur] d[msd] d[gobs] d[eot] d[faa]*
-
- See **MGD77 FIELD INFO** below for field and abbreviations descriptions.
-
- **-Dv** display values for the twelve position and geophysical
- fields for each MGD77 data record (in this order):
-
- *lat lon twt depth mtf1 mtf2 mag diur msens gobs eot faa*
-
- See below for **MGD77 FIELD INFO**.
-
-**-G**\ *information*
- Compare cruise data to GMT or IMG grids. Use one of the formats below.
- **-G**\ *fieldabbrev*,\ *imggrid*,\ *scale*,\ *mode*
- Compare cruise data to the specified grid in Sandwell/Smith Mercator
- format. Requires a valid MGD77 field abbreviation (see **MGD77 FIELD
- INFO** below) followed by a comma, the path (if not in current
- directory) and grid filename, a scale to multiply the data (1 or
- 0.1), and mode which stand for the following: (0) Img files with no
- constraint code, returns data at all points, (1) Img file with
- constraints coded, return data at all points, (2) Img file with
- constraints coded, return data only at constrained points and NaN
- elsewhere, and (3) Img file with constraints coded,
- return 1 at constraints and 0 elsewhere.
- **-G**\ *fieldabbrev*,\ *grid*
- Compare cruise data to the specified grid. Requires a valid MGD77
- field abbreviation (see **MGD77 FIELD INFO** below) followed by a
- comma, then the path (if not in current directory) and grid
- filename. Multiple grid comparison is supported by using separate
- **-G** calls for each grid. See **GRID FILE INFO** below.
-
- Grid comparison activates several additional error checks. (1)
- Re-weighted Least Squares Regression of ship versus grid data
- determines slope and DC shift, which when differing from expected 1
- and 0, respectively, may indicate incorrectly scaled ship data,
- including incorrect units or instrument drift as well as erroneous
- gravity tie-in. (2) Accumulated ship grid offsets are computed
- along-track and excessive offsets are flagged according to *maxArea*
- threshold (use **-L** option to adjust *maxArea*). Warning:
- predicted bathymetry grids are constrained by cruise data so grids
- and cruise data are not always independent. Comparison of cruise
- bathymetry with predicted bathymetry grids also activates a
- "navigation crossing over land" check.
-
-**-H**
- (with **-G**\ \|\ **g** only) disable (or force) decimation during
- RLS analysis of ship and gridded data. By default mgd77sniffer
- analyses both the full and decimated data sets then reports RLS
- statistics for the higher correlation regression.
-
- **-Hb** analyze both (default), report better of two.
-
- **-Hd** to disable data decimation (equivalent to -H with no argument).
-
- **-Hf** to force data decimation.
-
-**-I**\ *fieldabbrev*,\ *rec1*,\ *recN*
- Append a field abbreviation and the first and last record in a range
- of records that should be flagged as bad (and set to NaN prior to
- the analysis). Repeat as many times as needed. May not be used for
- multiple cruises.
-
-**-K**
- Reverse navigation quality flags (good to bad and vice versa). May
- be necessary when a majority of navigation fixes are erroneously
- flagged bad, which can happen when a cruise's first navigation fix
- is extremely erroneous. Caution! This will affect sniffer output and
- should only be attempted after careful manual navigation review.
-
-**-L**\ *custom-limits-file*
- Override mgd77sniffer default error detection limits. Supply path
- and filename to the custom limits file. Rows not beginning with a
- valid MGD77 field abbreviation are ignored. Field abbreviations are
- listed below in exact form under MGD77 FIELD INFO. Multiple field
- limits may be modified using one default file, one field per line.
- Field min, max, max slope and max area may be changed for each
- field. Max slope pertains to the gradient type selected using the
- **-S** option. Max area is used by the **-G** option as the
- threshold for flagging excessive offsets from the specified grid.
- Dump defaults **-Dl** to view syntax or to quickly create an
- editable custom limits file.
-
- Example custom default file contents (see below for units):
-
- +--------------+--------+---------+------------+-----------+
- | # abbrev | min | max | maxSlope | maxArea |
- +--------------+--------+---------+------------+-----------+
- | twt | 0 | 15 | 1 | 0 |
- +--------------+--------+---------+------------+-----------+
- | depth | 0 | 11000 | 500 | 5000 |
- +--------------+--------+---------+------------+-----------+
- | mag | -800 | 800 | -- | -- |
- +--------------+--------+---------+------------+-----------+
- | faa | -300 | 300 | 100 | 2500 |
- +--------------+--------+---------+------------+-----------+
-
- Use a dash '-' to retain a default limit. Hint: to test your custom
- limits, try: mgd77sniffer **-Dl** **-L**\ <yourlimitsfile>
-
-**-N**
- Use nautical units.
-
-**-P**
- Flag regression statistics that are outside the specified confidence
- level. (i.e., -P5 flags coefficients m, b, rms, and r that fall
- outside 95%.)
-
-.. |Add_-Rgeo| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-Rgeo.rst_
-
-**-S**\ **d**\ \|\ **s**\ \|\ **t**
- Specify gradient type for along-track excessive slope checking.
- **-Sd** Calculate change in z values along track (dz). Output is
- given in geophysical units, e.g., mGal.
- **-Ss** Calculate spatial gradients (dz/ds). Output is given in
- geophysical units per km along the survey track, e.g., mGal/km.
- **-St** Calculate time gradients (dz/dt) [default]. Output is given
- in geophysical units per second along the survey track, e.g., mGal/sec.
-
-**-T**\ *gap*
- Adjusts mgd77sniffer gap handling. By default, data gaps greater
- than 5 km are skipped. Set to zero to de-activate gap skipping.
-
-**-W**\ **c**\ \|\ **g**\ \|\ **o**\ \|\ **s**\ \|\ **t**\ \|\ **v**\ \|\ **x**
- Print out only certain warning types for verbose error messages.
- Comma delimit any combination of **c\|g\|o\|s\|t\|v\|x**: where
- (**c**) type code warnings, (**g**)radient out of range,
- (**o**)ffsets from grid (requires **-G**\ \|\ **g**), (**s**)peed
- out of range, (**t**)ime warnings, (**v**)alue out of range, (**x**)
- warning summaries. By default ALL warning messages are printed.Not
- compatible with any **-D** options.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-.. |Add_-bo| replace:: Output binary data for **-D**\ d\|f\|s\|v option.
-.. include:: ../../explain_-bo.rst_
-
-.. include:: ../../explain_-n.rst_
-
-.. include:: ../../explain_help.rst_
-
-.. include:: ../../explain_grdresample2.rst_
-
-Mgd77 Field Info
-----------------
-
-+-------------+------------------+-------------+
-| *Field* | *Abbreviation* | *Units* |
-+-------------+------------------+-------------+
-| Two-way | Travel | Time |
-+-------------+------------------+-------------+
-| Corrected | Depth | depth |
-+-------------+------------------+-------------+
-| Mag | Total | Field1 |
-+-------------+------------------+-------------+
-| Mag | Total | Field2 |
-+-------------+------------------+-------------+
-| Residual | Magnetic | mag |
-+-------------+------------------+-------------+
-| Diurnal | Correction | diur |
-+-------------+------------------+-------------+
-| Mag | Sensor | Depth/Alt |
-+-------------+------------------+-------------+
-| Observed | Gravity | gobs |
-+-------------+------------------+-------------+
-| Eotvos | Correction | eot |
-+-------------+------------------+-------------+
-| Free | Air | Anomaly |
-+-------------+------------------+-------------+
-
-Grid File Info
---------------
-
-For **-G** the grids must eitehr be in the format used by Sandwell & Smith,
-which is a spherical Mercator 2-byte grid with no header, or any grid type
-supported by GMT and therefore must
-contain a GMT header. A correctly formatted \*.i2 grid file can be
-generated using grdraster as shown below.
-
-gmtset GRIDFILE_SHORTHAND TRUE
-
-Create/edit .gmt_io file to include the following rows:
-
-# GMT I/O shorthand file
-
-# suffix format_id scale offset NaN
-
-grd 0 - - - -
-
-i2 2 - - 32767
-
- ::
-
- gmt grdraster 1 -R0/359:55/-90/90 -Getopo5_hdr.i2
-
-The new grid, etopo5_hdr.i2 in this example, contains a GMT header and
-can be used in the **-G** option to compare cruise depth with grid values.
-
-E77 Error Format
-----------------
-
-**Header**
- Information pertaining to an entire cruise, such as NGDC and survey
- institution identification codes, cruise examination time, two-way
- travel time corrector information, data precision warnings, as well
- as systematic scales, DC shifts and correlation coefficients from
- global grid comparisons are reported as E77 header information.
-
- **Sample**
-
- # Cruise 08010039 ID 74010908 MGD77 FILE VERSION: 19801230 N_RECS: 3066
-
- # Examined: Wed Oct 3 16:30:13 2007 by mtchandl
-
- # Arguments: -De -Gdepth,/data/GRIDS/etopo5_hdr.i2
-
- N Errata table verification status
-
- # mgd77manage applies corrections if the errata table is verified
- (toggle 'N' above to 'Y' after review)
-
- # For instructions on E77 format and usage, see
- `http://gmt.soest.hawaii.edu/mgd77/errata.php <http://gmt.soest.hawaii.edu/mgd77/errata.php>`_
-
- # Verified by:
-
- # Comments:
-
- # Errata: Header
-
- Y-E-08010039-H13-02: Invalid Magnetics Sampling Rate: (99) [ ]
-
- Y-W-08010039-H13-10: Survey year (1975) outside magnetic reference
- field IGRF 1965 time range (1965-1970)
-
- Y-I-08010039-depth-00: RLS m: 1.00053 b: 0 rms: 127.851 r: 0.973422
- significant: 1 decimation: 0
-
- Y-W-08010039-twt-09: More recent bathymetry correction table available
-
- Y-W-08010039-mtf1-10: Integer precision
-
- Y-W-08010039-mag-10: Integer precision
-
-**Error Record**
- Individual error records have strict format. Included is a time or
- distance column followed by record number, a formatted error code
- string, and finally a verbose description of errors detected in the
- record. Three error classes are encoded into the error code string
- with different alphabetic characters representing unique error
- types. See below for error code format description.
-
- **Format**
- <time/distance> <record number> <error code string> <description>
-
- **Sample**
-
- # Errata: Data
-
- Y 08010039 1975-05-10T22:16:05.88 74 C-0-0 NAV: excessive speed
-
-**Error Code Description**
- Each of the three error classes is separated by a dash **-** and
- described by a combination of alphabetic characters or 0 signifying
- no detected problems.
-
- Error classes: NAV-VAL-GRAD
-
- **Error Class Descriptions**
-
- NAV (navigation):
-
- 0 - fine
-
- A - time out of range
-
- B - time decreasing
-
- C - excessive speed
-
- D - above sea level
-
- E - lat undefined
-
- F - lon undefined
-
- VAL (value):
-
- 0 - fine
-
- K - twt invalid
-
- L - depth invalid
-
- O - mtf1 invalid
-
- etc.
-
- GRAD (gradient):
-
- 0 - fine
-
- K - d[twt] excessive
-
- L - d[depth] excessive
-
- O - d[mtf1] excessive
- etc.
-
- The NAV error class has unique cases while VAL and GRAD classes are
- described by alphabetic characters for each of the 24 numeric fields
- in MGD77 format order.
-
- MGD77 bit-pattern w/ E77 alpha characters
-
- \|-------------------------------------------------\|----------\|
-
- \| X W V U T S R Q P O N M L K J I H G F E D C B A \| E77 Code \|
-
- \| - - - - - - - - - - - - - - - - - - - - - - - - \| - - - - -\|
-
- \| n f e g m d m m m m b b d t p l l m h d m y t d \| F I \|
-
- \| q a o o s i s a t t t c e w t o a i o a o e z r \| i D \|
-
- \| c a t b d u e g f f c c p t c n t n u y n a t \| e \|
-
- \| s r n 2 1 t r t r \| l \|
-
- \| s h h \| d \|
-
- \| - - - - - - - - - - - - - - - - - - - - - - - - \| - - - - -\|
-
- \| 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 \| Bit place\|
-
- \| - G C G C C - G G G - - G G - - - T T T T T - - \| Bit type \|
-
- \|-------------------------------------------------\|----------\|
-
- Bit types: (G)eophysical, (C)orrection, (T)ime
-
-Examples
---------
-
-To scan for excessive values or gradients, try
-
- ::
-
- gmt mgd77sniffer 08010001
-
-To dump cruise gradients, try
-
- ::
-
- gmt mgd77sniffer 08010001 -Ds
-
-To compare cruise depth with ETOPO5 bathymetry and gravity with
-Sandwell/Smith 2 min gravity version 11, try
-
- ::
-
- mgd77sniffer 08010001 -Gdepth,/data/GRIDS/etopo5_hdr.i2 \
- -Gfaa,/data/GRIDS/grav.11.2.img,0.1,1
-
-See Also
---------
-
-:doc:`mgd77list`,
-:doc:`mgd77track`
-:doc:`x2sys_init <../x2sys/x2sys_init>`
-
-References
-----------
-
-The Marine Geophysical Data Exchange Format - MGD77, see
-`<http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt.>`_
diff --git a/doc_release/html/_sources/supplements/mgd77/mgd77track.txt b/doc_release/html/_sources/supplements/mgd77/mgd77track.txt
deleted file mode 100644
index da2604b..0000000
--- a/doc_release/html/_sources/supplements/mgd77/mgd77track.txt
+++ /dev/null
@@ -1,172 +0,0 @@
-.. index:: ! mgd77track
-
-**********
-mgd77track
-**********
-
-.. only:: not man
-
- mgd77track - Plot track-line map of MGD77 cruises
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**mgd77track** *NGDC-ids*
-|SYN_OPT-R|
-**-J**\ *parameters*
-[ **-A**\ [**c**][*size*][,\ *spacing*] ]
-[ |SYN_OPT-B| ]
-[ **-C**\ **f**\ \|\ **g**\ \|\ **e** ] [ **-Da**\ *startdate* ]
-[ **-Db**\ *stopdate* ] [ **-F** ] [ **-G**\ **d**\ \|\ **t**\ *gap* ]
-[ **-I**\ *ignore* ] [ **-K** ] [ **-L**\ *trackticks* ] [ **-O** ]
-[ **-P** ] [ **-Sa**\ *startdist*\ [**u**] ]
-[ **-Sb**\ *stopdist*\ [**u**] ]
-[ **-TT**\ \|\ **t**\ \|\ **d**\ *ms*,\ *mc*,\ *mfs*,\ *mf*,\ *mfc* ]
-[ |SYN_OPT-U| ]
-[ |SYN_OPT-V| ]
-[ **-W**\ [**-**\ \|\ **+**][*pen*] ]
-[ |SYN_OPT-X| ]
-[ |SYN_OPT-Y| ]
-[ |SYN_OPT-c| ]
-[ |SYN_OPT-p| ]
-[ |SYN_OPT-t| ]
-
-|No-spaces|
-
-Description
------------
-
-**mgd77track** reads NGDC MGD77 cruises and creates PostScript code
-that will plot one or more ship tracks on a map using the specified
-projection. The PostScript code is written to standard output.
-
-Required Arguments
-------------------
-
-.. include:: explain_ncid.rst_
-
-.. include:: ../../explain_-J.rst_
-
-.. |Add_-Rgeo| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-Rgeo.rst_
-
-Optional Arguments
-------------------
-
-**-A**\ [**c**][*size*][,\ *spacing*]
- Append **c** to annotate using the MGD77 cruise ID [Default uses the
- filename prefix]. Optional *size* is the font size in points. The
- leg annotation font is controlled by :ref:`FONT_LABEL <FONT_LABEL>`. By default,
- each leg is annotated every time it enters the map region.
- Alternatively, append ,\ *spacing* to place this label every
- *spacing* units apart along the track. Append one of the units **k**
- (km), **n** (nautical mile), **d** (day), or **h** (hour).
-
-.. include:: ../../explain_-B.rst_
-
-**-C**\ **f**\ \|\ **g**\ \|\ **e**
- Select procedure for along-track distance calculation:
- **f** Flat Earth distances.
- **g** Great circle distances [Default].
- **e** Geodesic distances on current GMT ellipsoid.
-**-Da**\ *startdate*
- Do not plot data collected before *startdate*
- (yyyy-mm-ddBD(T)[hh:mm:ss]) [Default is first day].
-**-Db**\ *stopdate*
- Do not plot data collected after *stopdate*
- (yyyy-mm-ddBD(T)[hh:mm:ss]). [Default is last day].
-**-F**
- Do not apply the error bit flags if present in a MGD77+ file
- [Default will apply these flags upon reading the data].
-**-G**\ **d**\ \|\ **t**\ *gap*
- Let successive point separations exceeding **d**\ *gap* (km) or
- **t**\ *gap* (minutes) indicate a break in the track where we should
- not draw a line [no gaps recognized]. Repeat to use both types of
- gap checking.
-**-I**\ *ignore*
- Ignore certain data file formats from consideration. Append
- **a\|c\|t** to ignore MGD77 ASCII, MGD77+ netCDF, or plain table
- files, respectively. The option may be repeated to ignore more than
- one format. [Default ignores none].
-
-.. include:: ../../explain_-K.rst_
-
-**-L**\ *trackticks*
- To put time/distance log-marks on the track. E.g.
- **a**\ 500\ **ka**\ 24\ **ht**\ 6\ **h** means (**a**)nnotate every
- 500 km (**k**) and 24 **h**\ (ours), with
- (**t**)ickmarks every 500 km and 6 hours. Alternatively you may use
- the modifiers **d** (days) and **n** (nautical miles).
-
-.. include:: ../../explain_-O.rst_
-
-.. include:: ../../explain_-P.rst_
-
-**-Sa**\ *startdist*\ [**u**]
- Do not plot data that are less than *startdist* meter along track
- from port of departure. Append **k** for km, **m** for miles, or
- **n** for nautical miles [Default is 0 meters].
-**-Sb**\ *stopdist*\ [**u**]
- Do not plot data that are more than *stopdist* meter along track
- from port of departure. Append **k** for km, **m** for miles, or
- **n** for nautical miles [Default is end of track].
-**-TT**\ \|\ **t**\ \|\ **d**\ *ms*,\ *mc*,\ *mfs*,\ *mf*,\ *mfc*
- Controls the attributes of the three kinds of markers (**T** for the
- first time marker in a new day, **t** for additional time markers in
- the same day, and **d** for distance markers). For each of these you
- can specify the 5 comma-separated attributes *markersize*,
- *markercolor*, *markerfontsize*, *markerfont*, and
- *markerfontcolor*. Repeat the **-T** option for each marker type.
-
-.. include:: ../../explain_-U.rst_
-
-**-W**\ [**-**\ \|\ **+**][*pen*]
- Append *pen* used for the trackline. [Defaults:
- width = default, color = black, style = solid]. A leading **+** will
- use the lookup color (via **-C**) for both symbol fill and outline
- pen color, while a leading **-** will set outline pen color and turn
- off symbol fill.
-
-.. include:: ../../explain_-XY.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-.. include:: ../../explain_-c.rst_
-
-.. |Add_perspective| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_perspective.rst_
-
-.. include:: ../../explain_-t.rst_
-
-.. include:: ../../explain_help.rst_
-
-Examples
---------
-
-To generate a Mercator plot of the track of the cruise 01010007 in the
-area 70W to 20E, 40S to 20N, using a Mercator scale of 0.1inch/degree,
-label the tracks with 10 points characters, annotate the boundaries
-every 10 degrees, draw gridlines every 5 degrees, and mark the track
-every day and 1000 km, with ticks every 6 hours and 250 km, and send the
-plot to the default printer, enter the following command:
-
- ::
-
- gmt mgd77track 01010007 -R70W/20E/40S/20N -Jm0.1 -B10g5 -A10 \
- -La1da1000kf6hf250k \| lpr
-
-See Also
---------
-
-:doc:`mgd77info`,
-:doc:`psbasemap </psbasemap>`,
-:doc:`mgd77list`
-
-References
-----------
-
-The Marine Geophysical Data Exchange Format - MGD77, see
-`<http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt>`_
diff --git a/doc_release/html/_sources/supplements/misc/dimfilter.txt b/doc_release/html/_sources/supplements/misc/dimfilter.txt
deleted file mode 100644
index 0afe336..0000000
--- a/doc_release/html/_sources/supplements/misc/dimfilter.txt
+++ /dev/null
@@ -1,220 +0,0 @@
-.. index:: ! dimfilter
-
-*********
-dimfilter
-*********
-
-.. only:: not man
-
- dimfilter - Directional filtering of 2-D gridded files in the space (or time) domain
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**dimfilter** *input_file.nc* **-D**\ *distance_flag*
-**-F**\ *<filtertype><width>*\ [*mode*] **-G**\ *output_file.nc*
-**-N**\ *<filtertype><n_sectors>* [ **-Q**\ *cols* ]
-[ |SYN_OPT-I| ]
-[ |SYN_OPT-R| ]
-[ **-T** ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-f| ]
-
-|No-spaces|
-
-Description
------------
-
-**dimfilter** will filter a *.nc* file in the space (or time) domain by
-dividing the given filter circle into *n\_sectors*, applying one of the
-selected primary convolution or non-convolution filters to each sector,
-and choosing the final outcome according to the selected secondary
-filter. It computes distances using Cartesian or Spherical geometries.
-The output *.nc* file can optionally be generated as a subregion of the
-input and/or with a new **-I**\ ncrement. In this way, one may have
-"extra space" in the input data so that there will be no edge effects
-for the output grid. If the filter is low-pass, then the output may be
-less frequently sampled than the input. **-Q** is for the error analysis
-mode and only requires the total number of columns in the input file,
-which contains the filtered depths. Finally, one should know that
-**dimfilter** will not produce a smooth output as other spatial filters
-do because it returns a minimum median out of *N* medians of *N*
-sectors. The output can be rought unless the input data is noise-free.
-Thus, an additional filtering (e.g., Gaussian via **grdfilter**) of the
-DiM-filtered data is generally recommended.
-
-Required Arguments
-------------------
-
-*input\_file.nc*
- The data grid to be filtered.
-**-D**\ *distance\_flag*
- Distance *flag* tells how grid (x,y) relates to filter *width*, as follows:
-
- *flag* = 0: grid (x,y) same units as *width*, Cartesian distances.
- *flag* = 1: grid (x,y) in degrees, *width* in kilometers, Cartesian distances.
- *flag* = 2: grid (x,y) in degrees, *width* in km, dx scaled by
- cos(middle y), Cartesian distances.
-
- The above options are fastest because they allow weight matrix to be
- computed only once. The next three options are slower because they
- recompute weights for each latitude.
-
- *flag* = 3: grid (x,y) in degrees, *width* in km, dx scaled by
- cosine(y), Cartesian distance calculation.
-
- *flag* = 4: grid (x,y) in degrees, *width* in km, Spherical distance
- calculation.
-
-**-F**\ *<filtertype><width>*\ [*mode*]
- Sets the primary filter type. Choose among convolution and
- non-convolution filters. Append the filter code followed by the full
- diameter *width*. Available convolution filters are:
-
- (**b**) Boxcar: All weights are equal.
-
- (**c**) Cosine Arch: Weights follow a cosine arch curve.
-
- (**g**) Gaussian: Weights are given by the Gaussian function.
-
- Non-convolution filters are:
-
- (**m**) Median: Returns median value.
-
- (**p**) Maximum likelihood probability (a mode estimator): Return
- modal value. If more than one mode is found we return their average
- value. Append - or + to the filter width if you rather want to
- return the smallest or largest of the modal values.
-
-**-N**\ *<filtertype><n_sectors>*
- Sets the secondary filter type and the number of bow-tie sectors.
- *n\_sectors* must be integer and larger than 0. When *n\_sectors* is
- set to 1, the secondary filter is not effective. Available secondary
- filters are:
-
- (**l**) Lower: Return the minimum of all filtered values.
-
- (**u**) Upper: Return the maximum of all filtered values.
-
- (**a**) Average: Return the mean of all filtered values.
-
- (**m**) Median: Return the median of all filtered values.
-
- (**p**) Mode: Return the mode of all filtered values.
-
-**-G**\ *output\_file.nc*
- *output\_file.nc* is the output of the filter.
-
-Optional Arguments
-------------------
-
-**-I**
- *x\_inc* [and optionally *y\_inc*] is the output Increment. Append
- **m** to indicate minutes, or **c** to indicate seconds. If the new
- *x\_inc*, *y\_inc* are NOT integer multiples of the old ones (in the
- input data), filtering will be considerably slower. [Default: Same
- as input.]
-**-R**
- *west*, *east*, *south*, and *north* defines the Region of the
- output points. [Default: Same as input.]
-**-T**
- Toggle the node registration for the output grid so as to become the
- opposite of the input grid [Default gives the same registration as
- the input grid].
-**-Q**\ *cols*
- *cols* is the total number of columns in the input text table file.
- For this mode, it expects to read depths consisted of several
- columns. Each column represents a filtered grid with a filter width,
- which can be obtained by **grd2xyz -Z**. The outcome will be median,
- MAD, and mean. So, the column with the medians is used to generate
- the regional component and the column with the MADs is used to
- conduct the error analysis.
-
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-f.rst_
-
-.. include:: ../../explain_help.rst_
-.. include:: ../../explain_grd_inout.rst_
-.. include:: ../../explain_grd_coord.rst_
-
-Examples
---------
-
-Suppose that north\_pacific\_dbdb5.nc is a file of 5 minute bathymetry
-from 140E to 260E and 0N to 50N, and you want to find the medians of
-values within a 300km radius (600km full width) of the output points,
-which you choose to be from 150E to 250E and 10N to 40N, and you want
-the output values every 0.5 degree. To prevent the medians from being
-biased by the sloping plane, you want to divide the filter circle into 6
-sectors and to choose the lowest value among 6 medians. Using spherical
-distance calculations, you need:
-
- ::
-
- gmt dimfilter north_pacific_dbdb5.nc -Gfiltered_pacific.nc -Fm600 -D4 \
- -Nl6 -R150/250/10/40 -I0.5 -V
-
-Suppose that cape_verde.nc is a file of 0.5 minute bathymetry from 32W
-to 15W and 8N to 25N, and you want to remove small-length-scale features
-in order to define a swell in an area extending from 27.5W to 20.5W and
-12.5N to 19.5N, and you want the output value every 2 minute. Using
-cartesian distance calculations, you need:
-
- ::
-
- gmt dimfilter cape_verde.nc -Gt.nc -Fm220 -Nl8 -D2 -R-27.5/-20.5/12.5/19.5 -I2m -V
- gmt grdfilter t.nc -Gcape_swell.nc -Fg50 -D2 -V
-
-Suppose that you found a range of filter widths for a given area, and
-you filtered the given bathymetric data using the range of filter widths
-(e.g., *f100.nc f110.nc f120.nc f130.nc*), and you want to define a
-regional trend using the range of filter widths, and you want to obtain
-median absolute deviation (MAD) estimates at each data point. Then, you
-will need to do:
-
- ::
-
- gmt grd2xyz f100.nc -Z > f100.d
- gmt grd2xyz f110.nc -Z > f110.d
- gmt grd2xyz f120.nc -Z > f120.d
- gmt grd2xyz f130.nc -Z > f130.d
- paste f100.d f110.d f120.d f130.d > depths.d
- gmt dimfilter depths.d -Q4 > output.z
-
-Limitations
------------
-
-When working with geographic (lat, lon) grids, all three convolution
-filters (boxcar, cosine arch, and gaussian) will properly normalize the
-filter weights for the variation in gridbox size with latitude, and
-correctly determine which nodes are needed for the convolution when the
-filter "circle" crosses a periodic (0-360) boundary or contains a
-geographic pole. However, the spatial filters, such as median and mode
-filters, do not use weights and thus should only be used on Cartesian
-grids (or at very low latitudes) only. If you want to apply such spatial
-filters you should project your data to an equal-area projection and run
-dimfilter on the resulting Cartesian grid.
-
-Script Template
----------------
-
-The dim.template.sh is a skeleton shell script that can be used to set
-up a complete DiM analysis, including the MAD analysis.
-
-Reference
----------
-
-Kim, S.-S., and Wessel, P. (2008), Directional Median Filtering for
-Regional-Residual Separation of Bathymetry, *Geochem. Geophys.
-Geosyst.*, **9**, Q03005, doi:10.1029/2007GC001850.
-
-See Also
---------
-
-:doc:`gmt </gmt>`, :doc:`grdfilter </grdfilter>`
diff --git a/doc_release/html/_sources/supplements/potential/gmtgravmag3d.txt b/doc_release/html/_sources/supplements/potential/gmtgravmag3d.txt
deleted file mode 100644
index 76d2bcd..0000000
--- a/doc_release/html/_sources/supplements/potential/gmtgravmag3d.txt
+++ /dev/null
@@ -1,138 +0,0 @@
-.. index:: ! gmtgravmag3d
-
-************
-gmtgravmag3d
-************
-
-.. only:: not man
-
- gmtgravmag3d - Compute the gravity/magnetic effect of a body by the method of Okabe
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**gmtgravmag3d** [ **-C**\ *density* ] [ **-D** ] [ **-E**\ *thickness* ]
-[ **-F**\ *xy_file* ]
-[ **-G**\ *outputgrid.nc* ]
-[ **-H**\ *f_dec*/*f_dip*/*m_int*/*m_dec*/*m_dip* ]
-[ **-L**\ *z_observation* ]
-|SYN_OPT-V|
-[ **-S**\ *radius* ]
-[ **-T**\ [[*d*]\ *xyz_file*/*vert_file*\ [*/m*]]\|[*r\|s*]\ *raw_file* ]
-[ **-Z**\ *level* ]
-[ |SYN_OPT-V| ]
-[ **-fg**\ ]
-
-|No-spaces|
-
-Description
------------
-
-**gmtgravmag3d** will compute the gravity or magnetic anomaly of a body
-described by a set of triangles. The output can either be along a given
-set of xy locations or on a grid. This method is not particularly fast
-but allows computing the anomaly of arbitrarily complex shapes.
-
-Required Arguments
-------------------
-
-**-C**\ *density*
- Sets body density in SI. This option is mutually exclusive with **-H**.
-
-**-H**\ *f_dec*/*f_dip*/*m_int*/*m_dec*/*m_dip*
- Sets parameters for computing a magnetic anomally. Use
- *f_dec*/*f_dip* to set the geomagnetic declination/inclination in
- degrees. *m_int*/*m_dec*/*m_dip* are the body magnetic intensity
- declination and inclination.
-
-**-F**\ *xy_file*
- Provide locations where the anomaly will be computed. Note this
- option is mutually exlusive with **-G**.
-
-**-G**\ *outgrid.nc*
- Output the gravity or magnetic anomaly at nodes of this grid file.
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-R.rst_
-
-Optional Arguments
-------------------
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-**-E**\ [*thickness*]
- give layer thickness in m [Default = 0 m]. Use this option only when
- the triangles describe a non-closed surface and you want the anomaly
- of a constant thickness layer.
-
-**-L**\ [*z_observation*]
- sets level of observation [Default = 0]. That is the height (z) at
- which anomalies are computed.
-
-**-S**\ *radius*
- search radius in km. Triangle centroids that are further away than
- *radius* from current output point will not be taken into account.
- Use this option to speed up computation at expenses of a less
- accurate result.
-
-**-T**\ [[*d*]\ *xyz_file*/*vert_file*\ [*/m*]]\|[*r\|s*]\ *raw_file*]
- Give either names of xyz[m] and *vertex* files or of a *raw* or
- *stl* file defining a close surface. In the first case append a *d*
- imediatly after **-T** and optionaly a */m* after the vertex file
- name. In the second case append a *r* or a *s* imediatly after
- **-T** and before the file name. A *vertex* file is a file with N
- rows (one per triangle) and 3 columns with integers defining the
- order by which the points in the *xyz* file are to be connected to
- form a triangle. The output of the program triangulate comes in this
- format. The optional */m* instructs the program that the xyzm file
- has four columns and that the fourth column contains the
- magnetization intensity (plus signal), which needs not to be
- constant. In this case the third argument of the **-H** option is
- ignored. A *raw* format (selected by the **r** flag is a file with N
- rows (one per triangle) and 9 columns corresponding to the x,y,x
- coordinates of each of the three vertex of each triangle.
- Alternatively, the **s** flag indicates that the surface file is in
- the ascii STL (Stereo Lithographic) format. These two type of files
- are used to provide a closed surface.
-
-**-Z**\ [*level*]
- level of reference plane [Default = 0]. Use this option when the
- triangles describe a non-closed surface and the volume is deffined
- from each triangle and this reference level. An example will be the
- whater depth to compute a Bouguer anomaly.
-
-**-fg**
- Geographic grids (dimensions of longitude, latitude) will be converted to
- meters via a "Flat Earth" approximation using the current ellipsoid parameters.
-
-.. include:: ../../explain_help.rst_
-
-Grid Distance Units
--------------------
-
-If the grid does not have meter as the horizontal unit, append **+u**\ *unit* to the input file name to convert from the
-specified unit to meter. If your grid is geographic, convert distances to meters by supplying **-fg** instead.
-
-Examples
---------
-
-Suppose you ...
-
- ::
-
- gmt gmtgravmag3d ...
-
-See Also
---------
-
-:doc:`gmt </gmt>`, :doc:`grdgravmag3d`
-
-Reference
----------
-
-Okabe, M., Analytical expressions for gravity anomalies due to
-polyhedral bodies and translation into magnetic anomalies, *Geophysics*,
-44, (1979), p 730-741.
diff --git a/doc_release/html/_sources/supplements/potential/gravfft.txt b/doc_release/html/_sources/supplements/potential/gravfft.txt
deleted file mode 100644
index 781fda9..0000000
--- a/doc_release/html/_sources/supplements/potential/gravfft.txt
+++ /dev/null
@@ -1,293 +0,0 @@
-.. index:: ! gravfft
-
-*******
-gravfft
-*******
-
-.. only:: not man
-
- gravfft - Compute gravitational attraction of 3-D surfaces in the wavenumber (or frequency) domain
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**gravfft** *ingrid* [ *ingrid2* ] **-G**\ *outfile*
-[ **-C**\ *n/wavelength/mean\_depth/tbw* ] [ **-D**\ *density* ] [ **-E**\ *n_terms* ]
-[ **-F**\ [**f**\ \|\ **g**\ \|\ **v**\ \|\ **n**\ \|\ **e**] ] [ **-I**\ **w**\ \|\ **b**\ \|\ **c**\ \|\ **t** \|\ **k** ]
-**-N**\ [**f**\ \|\ **q**\ \|\ **s**\ \|\ *nx/ny*][**+a**\ \|\ **d**\ \|\ **h** \|\ **l**][**+e**\ \|\ **n**\ \|\ **m**][**+t**\ *width*][**+w**\ [*suffix*]][\ **+z**\ [**p**]]
-[ **-Q** ] [ **-T**\ *te/rl/rm/rw*\ [**+m**] ]
-[ |SYN_OPT-V| ]
-[ **-Z**\ *zm*\ [*zl*] ]
-[ **-fg** ]
-
-|No-spaces|
-
-Description
------------
-
-**gravfft** can be used into two main modes. First one computes the
-gravity/geoid response of a bathymetry file. It will take the 2-D
-forward FFT of a bathymetry grid and compute it's gravity/geoid response
-using full Parker's method applied to the chosen model. The available
-models are the "loading from top", or elastic plate model, and the
-"loading from below" which accounts for the plate's response to a
-sub-surface load (appropriate for hot spot modeling - if you believe
-them). In both cases, the model parameters are set with **-T** and
-**-Z** options. Second mode computes the admittance or coherence between
-two grids. The output is the average in the radial direction.
-Optionally, the model admittance may also be calculated. The horizontal
-dimensions of the grdfiles are assumed to be in meters. Geographical
-grids may be used by specifying the **-fg** option that scales degrees
-to meters. If you have grids with dimensions in km, you could change
-this to meters using :doc:`grdedit </grdedit>` or scale the output with
-:doc:`grdmath </grdmath>`.
-Given the number of choices this program offers, is difficult to state
-what are options and what are required arguments. It depends on what you
-are doing.
-
-Required Arguments
-------------------
-
-*ingrid*
- 2-D binary grid file to be operated on. (See GRID FILE FORMATS below).
- For cross-spectral operations, also give the second grid file *ingrd2*.
-**-G**\ *outfile*
- Specify the name of the output grid file or the 1-D spectrum table
- (see **-E**). (See GRID FILE FORMATS below).
-
-Optional Arguments
-------------------
-
-**-C**\ *n/wavelength/mean\_depth/tbw*
- Compute only the theoretical admittance curves of the selected model
- and exit. *n* and *wavelength* are used to compute (n \* wavelength)
- the total profile length in meters. *mean\_depth* is the mean water
- depth. Append dataflags (one or two) of *tbw* in any order. *t* =
- use "from top" model, *b* = use "from below" model. Optionally
- specify *w* to write wavelength instead of frequency.
-**-D**\ *density*
- Sets density contrast across surface. Used, for example, to compute
- the gravity attraction of the water layer that can later be combined
- with the free-air anomaly to get the Bouguer anomaly. In this case
- do not use **-T**. It also implicitly sets **-N+h**.
-**-E**\ *n_terms*
- Number of terms used in Parker expansion (limit is 10, otherwise
- terms depending on n will blow out the program) [Default = 3]
-**-F**\ [**f**\ \|\ **g**\ \|\ **v**\ \|\ **n**\ \|\ **e**]
- Specify desired geopotential field: compute geoid rather than gravity
-
- **f** = Free-air anomalies (mGal) [Default].
-
- **g** = Geoid anomalies (m).
-
- **v** = Vertical Gravity Gradient (VGG; 1 Eovtos = 0.1 mGal/km).
-
- **e** = East deflections of the vertical (micro-radian).
-
- **n** = North deflections of the vertical (micro-radian).
-
-**-I**\ **w**\ \|\ **b**\ \|\ **c**\ \|\ **t** \|\ **k**
- Use *ingrd2* and *ingrd1* (a grid with topography/bathymetry) to estimate admittance\|coherence and
- write it to stdout (**-G** ignored if set). This grid should contain
- gravity or geoid for the same region of *ingrd1*. Default
- computes admittance. Output contains 3 or 4 columns. Frequency
- (wavelength), admittance (coherence) one sigma error bar and,
- optionally, a theoretical admittance. Append dataflags (one to
- three) from **w**\ \|\ **b**\ \|\ **c**\ \|\ **t**.
- **w** writes wavelength instead of wavenumber, **k**
- selects km for wavelength unit [m], **c** computes coherence instead of
- admittance, **b** writes a forth column with "loading from below"
- theoretical admittance, and **t** writes a forth column with "elastic
- plate" theoretical admittance.
-
-.. include:: ../../explain_fft.rst_
-
-**-Q**
- Writes out a grid with the flexural topography (with z positive up)
- whose average was set by **-Z**\ *zm* and model parameters by **-T**
- (and output by **-G**). That is the "gravimetric Moho". **-Q**
- implicitly sets **-N+h**
-**-S**
- Computes predicted gravity or geoid grid due to a subplate load
- produced by the current bathymetry and the theoretical model. The
- necessary parameters are set within **-T** and **-Z** options. The
- number of powers in Parker expansion is restricted to 1.
- See an example further down.
-**-T**\ *te/rl/rm/rw*\ [**+m**]
- Compute the isostatic compensation from the topography load (input grid file) on
- an elastic plate of thickness *te*. Also append densities for load, mantle, and
- water in SI units. Give average mantle depth via **-Z**. If the elastic thickness
- is > 1e10 it will be interpreted as the flexural rigidity (by default it is
- computed from *te* and Young modulus). Optionally, append *+m* to write a grid
- with the Moho's geopotential effect (see **-F**) from model selected by **-T**.
- If *te* = 0 then the Airy response is returned. **-T+m** implicitly sets **-N+h**
-**-Z**\ *zm*\ [*zl*]
- Moho [and swell] average compensation depths. For the "load from
- top" model you only have to provide *zm*, but for the "loading from
- below" don't forget *zl*.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-**-fg**
- Geographic grids (dimensions of longitude, latitude) will be converted to
- meters via a "Flat Earth" approximation using the current ellipsoid parameters.
-
-.. include:: ../../explain_help.rst_
-
-.. include:: ../../explain_grd_inout.rst_
-
-Grid Distance Units
--------------------
-
-If the grid does not have meter as the horizontal unit, append **+u**\ *unit*
-to the input file name to convert from the specified unit to meter. If your
-grid is geographic, convert distances to meters by supplying **-fg** instead.
-
-Considerations
---------------
-
-netCDF COARDS grids will automatically be recognized as geographic. For
-other grids geographical grids were you want to convert degrees into
-meters, select **-fg**. If the data are close to either pole, you should
-consider projecting the grid file onto a rectangular coordinate system
-using :doc:`grdproject </grdproject>`.
-
-Plate Flexure
--------------
-
-The FFT solution to elastic plate flexure requires the infill density to equal
-the load density. This is typically only true directly beneath the load; beyond the load
-the infill tends to be lower-density sediments or even water (or air). Wessel [2001]
-proposed an approximation that allows for the specification of an infill density
-different from the load density while still allowing for an FFT solution. Basically,
-the plate flexure is solved for using the infill density as the effective load density but
-the amplitudes are adjusted by a factor *A* = sqrt ((rm - ri)/(rm - rl)), which is
-the theoretical difference in amplitude due to a point load using the two different
-load densities. The approximation is very good but breaks down for large
-loads on weak plates, a fairy uncommon situation.
-
-Examples
---------
-
-To compute the effect of the water layer above the bat.grd bathymetry
-using 2700 and 1035 for the densities of crust and water and writing the
-result on water_g.grd (computing up to the fourth power of bathymetry
-in Parker expansion):
-
- ::
-
- gmt gravfft bat.grd -D1665 -Gwater_g.grd -E4
-
-Now subtract it to your free-air anomaly faa.grd and you will get the
-Bouguer anomaly. You may wonder why we are subtracting and not adding.
-After all the Bouger anomaly pretends to correct the mass deficiency
-presented by the water layer, so we should add because water is less
-dense than the rocks below. The answer relyies on the way gravity
-effects are computed by the Parker's method and practical aspects of
-using the FFT.
-
- ::
-
- gmt grdmath faa.grd water_g.grd SUB = bouguer.grd
-
-Want an MBA anomaly? Well compute the crust mantle contribution and add
-it to the sea-bottom anomaly. Assuming a 6 km thick crust of density
-2700 and a mantle with 3300 density we could repeat the command used to
-compute the water layer anomaly, using 600 (3300 - 2700) as the density
-contrast. But we now have a problem because we need to know the mean
-moho depth. That is when the scale/offset that can be appended to the grid's name
-comes in hand. Notice that we didn't need to do that before because mean water
-depth was computed directly from data. (notice also the negative sign of the
-offset due to the fact that *z* is positive up):
-
- ::
-
- gmt gravfft bat.grd=nf/1/-6000 -D600 -Gmoho_g.grd
-
-Now, subtract it to the sea-bottom anomaly to obtain the MBA anomaly. That is:
-
- ::
-
- gmt grdmath water_g.grd moho_g.grd SUB = mba.grd
-
-To compute the Moho gravity effect of an elastic plate bat.grd with Te =
-7 km, density of 2700, over a mantle of density 3300, at an averge depth
-of 9 km
-
- ::
-
- gmt gravfft bat.grd -Gelastic.grd -T7000/2700/3300/1035+m -Z9000
-
-If you add now the sea-bottom and Moho's effects, you will get the full
-gravity response of your isostatic model. We will use here only the
-first term in Parker expansion.
-
- ::
-
- gmt gravfft bat.grd -D1665 -Gwater_g.grd -E1
- gmt gravfft bat.grd -Gelastic.grd -T7000/2700/3300/1035+m -Z9000 -E1
- gmt grdmath water_g.grd elastic.grd ADD = model.grd
-
-The same result can be obtained directly by the next command. However,
-PAY ATTENTION to the following. I don't yet know if it's because of a
-bug or due to some limitation, but the fact is that the following and
-the previous commands only give the same result if **-E**\ 1 is used.
-For higher powers of bathymetry in Parker expansion,
-only the above example seams to give the correct result.
-
- ::
-
- gmt gravfft bat.grd -Gmodel.grd -T7000/2700/3300/1035 -Z9000 -E1
-
-And what would be the geoid anomaly produced by a load at 50 km depth,
-below the a region whose bathymetry is given by bat.grd, a Moho at 9 km
-depth and the same densities as before?
-
- ::
-
- gmt gravfft topo.grd -Gswell_geoid.grd -T7000/2700/3300/1035 -Fg -Z9000/50000 -S -E1
-
-To compute the admittance between the topo.grd bathymetry and faa.grd
-free-air anomaly grid using the elastic plate model of a crust of 6 km
-mean thickness with 10 km efective elastic thickness in a region of 3 km
-mean water depth:
-
- ::
-
- gmt gravfft topo.grd faa.grd -It -T10000/2700/3300/1035 -Z9000
-
-To compute the admittance between the topo.grd bathymetry and geoid.grd
-geoid grid with the "loading from below" (LFB) model with the same as
-above and sub-surface load at 40 km, but assuming now the grids are in
-geographic and we want wavelengths instead of frequency:
-
- ::
-
- gmt gravfft topo.grd geoid.grd -Ibw -T10000/2700/3300/1035 -Z9000/40000 -fg
-
-To compute the gravity theoretical admittance of a LFB along a 2000 km
-long profile using the same parameters as above
-
- ::
-
- gmt gravfft -C400/5000/3000/b -T10000/2700/3300/1035 -Z9000/40000
-
-References
-----------
-
-Luis, J.F. and M.C. Neves. 2006, The isostatic compensation of the
-Azores Plateau: a 3D admittance and coherence analysis. J. Geotermal
-Vulc. Res. Volume 156, Issues 1-2, Pages 10-22,
-`http://dx.doi.org/10.1016/j.jvolgeores.2006.03.010 <http://dx.doi.org/10.1016/j.jvolgeores.2006.03.010>`_
-Wessel. P., 2001, Global distribution of seamounts inferred from gridded Geosat/ERS-1 altimetry,
-J. Geophys. Res., 106(B9), 19,431-19,441,
-`http://dx.doi.org/10.1029/2000JB000083 <http://dx.doi.org/110.1029/2000JB000083>`_
-
-See Also
---------
-
-:doc:`gmt </gmt>`, :doc:`grdfft </grdfft>`,
-:doc:`grdmath </grdmath>`, :doc:`grdproject </grdproject>`
diff --git a/doc_release/html/_sources/supplements/potential/grdgravmag3d.txt b/doc_release/html/_sources/supplements/potential/grdgravmag3d.txt
deleted file mode 100644
index 2057bc4..0000000
--- a/doc_release/html/_sources/supplements/potential/grdgravmag3d.txt
+++ /dev/null
@@ -1,117 +0,0 @@
-.. index:: ! grdgravmag3d
-
-************
-grdgravmag3d
-************
-
-.. only:: not man
-
- grdgravmag3d - Compute the gravity effect of a grid by the method of Okabe
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**grdgravmag3d** *grdfile_top* [*grdfile_bot*] [ **-C**\ *density* ]
-[ **-D** ] [ **-F**\ *xy_file* ]
-[ **-G**\ *outgrid* ]
-[ |SYN_OPT-I| ]
-[ **-L**\ *z_obs* ]
-[ **-Q**\ [\ **n**\ *n_pad*]\ \|\ [*pad_dist*]\ \|\ [<w/e/s/n>] ]
-[ |SYN_OPT-R| ]
-[ |SYN_OPT-V| ]
-[ **-Z**\ *level* ]
-[ **-fg** ]
-
-|No-spaces|
-
-Description
------------
-
-**grdgravmag3d** will compute the gravity anomaly of a body described by
-one or (optionally) two grids The output can either be along a given set
-of xy locations or on a grid. This method is not particularly fast but
-allows computing the anomaly of arbitrarily complex shapes.
-
-Required Arguments
-------------------
-
-*grdfile_top* [*grdfile_bot*]
- Grid file whose gravity efect is going to be computed. If two grids are
- provided then the gravity/magnetic efect of the volume between them is computed.
-
-**-C**\ *density*
- Sets body density in SI.
-
-**-F**\ *xy_file*
- Provide locations where the anomaly will be computed. Note this
- option is mutually exlusive with **-G**.
-
-**-G**\ *outgrid*
- Output the gravity anomaly at nodes of this grid file.
-
-Optional Arguments
-------------------
-
-.. include:: ../../explain_-I.rst_
-
-**-L**\ *z_obs*
- Sets level of observation [Default = 0]. That is the height (z) at
- which anomalies are computed.
-
-**-Q**\ [\ **n**\ *n_pad*]\ \|\ [\ *pad_dist*]\ \|\ [<w/e/s/n>]
- Extend the domain of computation with respect to output **-R** region.
- **-Qn**\ *n_pad* artifficially extends the width of the outer rim of
- cells to have a fake width of *n_pad* * dx[/dy].
-
- **-Q**\ *pad_dist* extend the region by west-pad, east+pad, etc.
-
- **-Q**\ *region* Same sintax as **-R**.
-
-.. |Add_-R| replace:: Note: this overrides the source grid region (Default: use same region as input)
-.. include:: ../../explain_-R.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-**-Z**\ *level*
- level of reference plane [Default = 0]. Use this option when the
- triangles describe a non-closed surface and the volume is deffined
- from each triangle and this reference level. An example will be the
- whater depth to compute a Bouguer anomaly.
-
-**-fg**
- Geographic grids (dimensions of longitude, latitude) will be converted to
- meters via a "Flat Earth" approximation using the current ellipsoid parameters.
-
-.. include:: ../../explain_help.rst_
-
-Grid Distance Units
--------------------
-
-If the grid does not have meter as the horizontal unit, append **+u**\ *unit* to the input file name to convert from the
-specified unit to meter. If your grid is geographic, convert distances to meters by supplying **-fg** instead.
-
-Examples
---------
-
-Suppose you want to compute the gravity effect of the phantom "Sandy
-Island" together with its not phantom seamount
-
-
- ::
-
- gmt grdgravmag3d sandy_bat.grd -C1700 -Z-4300 -M -I1m -Gsandy_okb.grd -V
-
-See Also
---------
-
-:doc:`gmt </gmt>`, :doc:`gmtgravmag3d`
-
-Reference
----------
-
-Okabe, M., Analytical expressions for gravity anomalies due to
-polyhedral bodies and translation into magnetic anomalies, *Geophysics*,
-44, (1979), p 730-741.
diff --git a/doc_release/html/_sources/supplements/potential/grdredpol.txt b/doc_release/html/_sources/supplements/potential/grdredpol.txt
deleted file mode 100644
index 493039c..0000000
--- a/doc_release/html/_sources/supplements/potential/grdredpol.txt
+++ /dev/null
@@ -1,124 +0,0 @@
-.. index:: ! grdredpol
-
-*********
-grdredpol
-*********
-
-.. only:: not man
-
- grdredpol - Compute the Continuous Reduction To the Pole, AKA differential RTP.
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**grdredpol** *anom_grd* **-G**\ *rtp_grd* [**-C**\ *dec/dip*]
-[**-E**\ *dec_grd/dip\grd*] [**-F**\ *<m/n>*] [**-M**\ *m\|r*]
-[**-N** ] [**-W**\ *win_width*]
-[ |SYN_OPT-V| ]
-[ **-T**\ *year* ]
-[ **-Z**\ *filtergrd* ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-n| ]
-
-|No-spaces|
-
-Description
------------
-
-**grdredpol** will take a *.nc* file with a magnetic anomaly and compute
-the reduction to the pole (RTP) anomaly. This anomaly is the one that
-would have been produce if the bodies were magnetized vertically and the
-anomalies were observed at the geomagnetic pole. Standard RTP procedure
-assumes the direction of magnetization to be uniform throughout the
-causative body, and the geomagnetic field to be uniform in direction
-throughout the study region. Although these assumptions are reasonable
-for small areas, they do not hold for large areas.
-
-In the method used here computations are carried out in both the
-frequency and the space domains. The idea is that a large area may be
-decomposed in small size windows where both the ambient field and the
-magnetization vector change by a very small amount. Inside each of those
-windows, or bins, a set of filter coefficients are calculate and
-reconstruct for each individual point the component filter using a first
-order Taylor series expansion.
-
-Required Arguments
-------------------
-
-*anom_grd*
- The anomaly grid to be converted.
-**-G**\ *rtp_grd*
- is the filename for output grdfile with the RTP solution
-
-Optional Arguments
-------------------
-
-**-C**\ *dec/dip*
- Use this (constant) declination and inclination angles for both
- field and magnetization. This option consists in the classical RTP
- procedure.
-
-**-E**\ *dip_grd/dec_grd*
- Get magnetization DIP & DEC from these grids [default: use IGRF].
- Note that these two grids do not need to have the same resolution as
- the anomaly grid. They can be coarser.
-
-**-F**\ *m/n*
- The filter window size in terms of row/columns. The default value is 25x25.
-
-**-M**\ *m\|r*
- Set boundary conditions. m\|r stands for mirror or replicate edges
- (Default is zero padding).
-
-**-N**
- Do NOT use Taylor expansion.
-
-**-R**\ *west*/*east*/*south*/*north*
- defines the Region of the output points. [Default: Same as input.]
-
-**-T**\ *year*
- Decimal year used by the IGRF routine to compute the declination and
- inclination at each point [default: 2000]
-
-**-W**\ *width*
- The size of the moving window in degrees [5].
-
-**-Z**\ *filter_grd*
- Write the filter file to disk.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-.. include:: ../../explain_-n.rst_
-.. include:: ../../explain_grdresample2.rst_
-
-Examples
---------
-
-Suppose that *anom.grd* is a file with the magnetic anomaly reduced to
-the 2010 epoch and that the *dec.grd* and *dip.grd* contain the
-magnetization declination and inclination respectively for an area that
-encloses that of the *anom.grd*, compute the *RTP* using bins of 2
-degrees and a filter of 45 coefficients.
-
-
- ::
-
- gmt grdredpol anom.grd -Grtp.grd -W2 -F45/45 -T2010 -Edec.grd/dip.grd -V
-
-To compute the same *RTP* but now with the field and magnetization
-vectors collinear and computed from IGRF :
-
-
- ::
-
- gmt grdredpol anom.grd -Grtp.grd -W2 -F45/45 -T2010 -V
-
-Reference
----------
-
-Luis, J.L. and Miranda, J.M. (2008), Reevaluation of magnetic chrons in
-the North Atlantic between 35N and 47N: Implications for the formation
-of the Azores Triple Junction and associated plateau. *JGR*, VOL.
-**113**, B10105, doi:10.1029/2007JB005573
diff --git a/doc_release/html/_sources/supplements/potential/grdseamount.txt b/doc_release/html/_sources/supplements/potential/grdseamount.txt
deleted file mode 100644
index ef966bf..0000000
--- a/doc_release/html/_sources/supplements/potential/grdseamount.txt
+++ /dev/null
@@ -1,116 +0,0 @@
-.. index:: ! grdseamount
-
-***********
-grdseamount
-***********
-
-.. only:: not man
-
- grdseamount - Compute synthetic seamount (Gaussian or cone, circular or elliptical) bathymetry
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**grdseamount** [ *intable* ]
-|SYN_OPT-I|
-|SYN_OPT-R|
-[ **-A**\ [*out/in*\ ] ] [ **-C** ] [ **-E** ] [ **-G**\ *grdfile* ] [ **-L**\ [*cut*] ]
-[ **-N**\ *norm* ] [ **-S**\ *scale* ] [ **-T**\ [*flattening*] ] [ **-Z**\ *level* ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-bi| ]
-[ **-fg** ]
-[ |SYN_OPT-i| ]
-[ **-r** ]
-
-|No-spaces|
-
-Description
------------
-
-**grdseamount** will compute the bathymetry for synthetic seamounts given their shape
-parameters. We read a list with seamount locations and sizes and can evaluate either
-Gaussian or conical shapes, which may be circular or elliptical, and optionally truncated.
-Various scaling options are available to modify the result, including an option to add in
-a background depth. The input must contain *lon, lat, radius, height* for each seamount.
-For elliptical features (**-E**) we expect *lon, lat, azimuth, semi-major, semi-minor,
-radius, height* instead. If flattening is specified (**-T**) then a final column with
-flattening is expected.
-
-Required Arguments
-------------------
-
-.. include:: ../../explain_-I.rst_
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-R.rst_
-
-Optional Arguments
-------------------
-
-**-A**\ [*out/in*]
- Build a mask grid, append outside/inside values [1/NaN].
- Here, height is ignored and **-L**, **-N** and **-Z** are disallowed
-
-**-C**
- Cone model [Default is Gaussian].
-
-**-E**
- Elliptical data format [Default is Circular]. Read lon, lat, azimuth,
- major, minor, height (m) for each seamount.
-
-**-G**\ *outgrid*
- Sets name of output gridfile.
-
-**-L**\ [*cut*]
- List area, volume, and mean height for each seamount; NO grid is created.
- Optionally, append the noise-floor cutoff level [0].
-
-**-N**\ *norm*
- Normalize grid so maximum grid height equals *norm*.
-
-**-S**\ *scale*
- Sets optional scale factor for radii [1].
-
-**-T**\ [*flattening*]
- Seamounts are to be truncated. Append *flattening*, otherwise we expect
- it in last input column [no truncation].
-
-**-Z**\ *level*
- Add in background depth [0].
-
-.. |Add_-bi| replace:: [Default is 3 input columns]. This option only applies
- to xyz input files; see **-Z** for z tables.
-.. include:: ../../explain_-bi.rst_
-
-**-fg**
- Geographic grids (dimensions of longitude, latitude) will be converted to
- km via a "Flat Earth" approximation using the current ellipsoid parameters.
-
-.. |Add_-h| replace:: Not used with binary data.
-.. include:: ../../explain_-h.rst_
-
-.. include:: ../../explain_-icols.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-.. |Add_nodereg| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_nodereg.rst_
-
-.. include:: ../../explain_colon.rst_
-
-.. include:: ../../explain_help.rst_
-
-
-Examples
---------
-
-To be added.
-
-See Also
---------
-
-:doc:`gmt.conf </gmt.conf>`, :doc:`gmt </gmt>`,
-:doc:`grdmath </grdmath>`, :doc:`gravfft`
diff --git a/doc_release/html/_sources/supplements/segy/pssegy.txt b/doc_release/html/_sources/supplements/segy/pssegy.txt
deleted file mode 100644
index 022c9a4..0000000
--- a/doc_release/html/_sources/supplements/segy/pssegy.txt
+++ /dev/null
@@ -1,175 +0,0 @@
-.. index:: ! pssegy
-
-******
-pssegy
-******
-
-.. only:: not man
-
- pssegy - Plot a SEGY file on a map
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**pssegy** *SEGYfile* **-J**\ *parameters*
-|SYN_OPT-R|
-**-D**\ *deviation*
-**-F**\ [*rgb*\ \|\ *gray*] **-W**
-[ **-B**\ *bias* ]
-[ **-C**\ *clip* ]
-[ **-E**\ *error* ] [ **-I** ] [ **-K** ] [ **-L**\ *nsamp* ]
-[ **-M**\ *ntrace* ] [ **-N** ] [ **-O** ] [ **-P** ]
-[ **-Q**\ *<mode><value>* ]
-[ **-S**\ *header* ]
-[ **-T**\ *filename* ]
-[ |SYN_OPT-U| ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-X| ]
-[ |SYN_OPT-Y| ]
-[ |SYN_OPT-p| ]
-[ |SYN_OPT-t| ]
-
-|No-spaces|
-
-Description
------------
-
-**pssegy** reads a native (IEEE) format SEGY file and produces a
-PostScript image of the seismic data. The *imagemask* operator is used
-so that the seismic data are plotted as a 1-bit deep bitmap in a single
-(user-specified) color or gray shade, with a transparent background. The
-bitmap resolution is taken from the current GMT defaults. The
-seismic traces may be plotted at their true locations using information
-in the trace headers (in which case order of the traces in the file is
-not significant). Standard GMT geometry routines are used so that in
-principle any map projection may be used, however it is likely that the
-geographic projections will lead to unexpected results. Beware also that
-some parameters have non-standard meanings.
-
-Note that the order of operations before the seismic data are plotted is
-deviation\*[clip]([bias]+[normalize](sample value)). Deviation
-determines how far *in the plot coordinates* a
-[normalized][biased][clipped] sample value of 1 plots from the trace
-location.
-
-The SEGY file should be a disk image of the tape format (ie 3200 byte
-text header, which is ignored, 400 byte binary reel header, and 240 byte
-header for each trace) with samples as native real\*4 (IEEE real on all
-the platforms to which I have access)
-
-Required Arguments
-------------------
-
-*SEGYfile*
- Seismic data set to be imaged
-
-.. include:: ../../explain_-J.rst_
-
-.. |Add_-Rgeo| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-Rgeo.rst_
-
-**-D**\ *deviation*
- gives the deviation in X units of the plot for 1.0 on the scaled
- trace.
-**-F**\ [*rgb*\ \|\ *gray*]
- Fill trace (variable area, defaults to filling positive). rgb or
- gray gives the color with which the imagemask is filled.
-**-W**
- Draw wiggle trace.
-
-You *must* specify at least one of **-W** and **-F**.
-
-Optional Arguments
-------------------
-
-**-A**
- Flip the default byte-swap state (default assumes data have a
- bigendian byte-order).
-**-C**\ *clip*
- Sample value at which to clip data (clipping is applied to both
- positive and negative values).
-**-E**\ *error*
- Allow *error* difference between requested and actual trace
- locations when using **-T** option.
-**-I**
- Fill negative rather than positive excursions.
-
-.. include:: ../../explain_-K.rst_
-
-**-L**
- Override number of samples per trace in reel header (program
- attempts to determine number of samples from each trace header if
- possible to allow for variable length traces).
-**-M**
- Override number of traces specified in reel header. Program detects
- end of file (relatively) gracefully, but this parameter limits
- number of traces that the program attempts to read.
-**-N**
- Normalize trace by dividing by rms amplitude over full trace length.
-
-.. include:: ../../explain_-O.rst_
-.. include:: ../../explain_-P.rst_
-
-**-Q**\ *<mode><value>*
- Can be used to change 4 different settings:
- **-Qb**\ *<bias>* to bias scaled traces (-B-0.1 subtracts 0.1 from values)
-
- **-Qu**\ *<redvel>* to apply reduction velocity (-ve removes reduction already present)
-
- **-Qx**\ *<mult>* to multiply trace locations by *mult*
-
- **-Qy**\ *<dy>* to override sample interval in reel header.
-
-**-S**\ *header*
- Read trace locations from trace headers: header is either c for CDP,
- o for offset, or b<num> to read a long starting at byte <num> in the
- header (first byte corresponds to num=0). Default has location given
- by trace number.
-**-T**\ *filename*
- Plot only traces whose location corresponds to a list given in
- *filename*. Order in which traces are listed is not significant -
- the entire space is checked for each trace.
-**-U**\ *redvel*
- Apply reduction velocity by shifting traces *upwards* by
- redvel/\|offset\|. Negative velocity removes existing reduction.
- Units should be consistent with offset in trace header and sample
- interval.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-.. include:: ../../explain_-XY.rst_
-
-**-Z**
- Do not plot traces with zero rms amplitude.
-
-.. |Add_perspective| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_perspective.rst_
-
-.. include:: ../../explain_-t.rst_
-.. include:: ../../explain_help.rst_
-
-Examples
---------
-
-To plot the SEGY file wa1.segy with normalized traces plotted at true
-offset locations, clipped at +-3 and with wiggle trace and positive
-variable area shading in black, use
-
- ::
-
- gmt pssegy wa1.segy -JX5i/-5i -R0/100/0/10 -D1 -C3 -N -So -W -Fblack > segy.ps
-
-To plot the SEGY file wa1.segy with traces plotted at true cdp\*0.1,
-clipped at +-3, with bias -1 and negative variable area shaded red, use
-
- ::
-
- gmt pssegy wa1.segy -JX5i/-5i -R0/100/0/10 -D1 -C3 -Sc -X0.1 -Fred -B-1 -I > segy.ps
-
-See Also
---------
-
-:doc:`gmt </gmt>`, :doc:`pssegyz`
diff --git a/doc_release/html/_sources/supplements/segy/pssegyz.txt b/doc_release/html/_sources/supplements/segy/pssegyz.txt
deleted file mode 100644
index 3f1b326..0000000
--- a/doc_release/html/_sources/supplements/segy/pssegyz.txt
+++ /dev/null
@@ -1,173 +0,0 @@
-.. index:: ! pssegyz
-
-*******
-pssegyz
-*******
-
-.. only:: not man
-
- pssegyz - Create imagemasked postscript from SEGY file
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**pssegyz** *SEGYfile* **-J**\ *parameters*
-**-Jz**\ \|\ **Z**\ *parameters*
-|SYN_OPT-Rz|
-**-D**\ *deviation* **-F**\ [*rgb*\ \|\ *gray*] **-W**
-[ **-B**\ *bias* ]
-[ **-C**\ *clip* ] [ **-I** ] [ **-K** ] [ **-L**\ *nsamp* ]
-[ **-M**\ *ntrace* ] [ **-N** ] [ **-O** ] [ **-P** ]
-[ **-Q**\ *<mode><value>* ]
-[ **-S**\ *header_x*/*header_y* ]
-[ |SYN_OPT-U| ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-X| ]
-[ |SYN_OPT-Y| ]
-[ **-Z** ]
-[ |SYN_OPT-p| ]
-[ |SYN_OPT-t| ]
-
-|No-spaces|
-
-Description
------------
-
-**pssegyz** reads a native (IEEE) format SEGY file and produces a
-PostScript image of the seismic data. The *imagemask* operator is used
-so that the seismic data are plotted as a 1-bit deep bitmap in a single
-(user-specified) color or gray shade, with a transparent background. The
-bitmap resolution is taken from the current GMT defaults. The
-seismic traces may be plotted at their true locations using information
-in the trace headers (in which case order of the traces in the file is
-not significant). Standard GMT geometry routines are used so that in
-principle any map projection may be used, however it is likely that the
-geographic projections will lead to unexpected results. Beware also that
-some parameters have non-standard meanings, and a couple of the options
-for **pssegy** are not available in **pssegyz**.
-
-Note that the order of operations before the seismic data are plotted is
-deviation\*[clip]([bias]+[normalize](sample value)). Deviation
-determines how far *in the plot coordinates* a
-[normalized][biased][clipped] sample value of 1 plots from the trace
-location.
-
-The SEGY file should be a disk image of the tape format (ie 3200 byte
-text header, which is ignored, 400 byte binary reel header, and 240 byte
-header for each trace) with samples as native real\*4 (IEEE real on all
-the platforms to which I have access)
-
-Required Arguments
-------------------
-
-*SEGYfile*
- Seismic data set to be imaged
-
-.. include:: ../../explain_-J.rst_
-
-.. |Add_-Rgeo| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-Rgeo.rst_
-
-**-D**\ *deviation*
- gives the deviation in X units of the plot for 1.0 on the scaled
- trace, This may be a single number (applied equally in X and Y
- directions) or devX/devY
-**-F**\ [*rgb*\ \|\ *gray*]
- Fill trace (variable area, defaults to filling positive). rgb or
- gray gives the color with which the imagemask is filled.
-**-W**
- Draw wiggle trace.
-
-You *must* specify at least one of **-W** and **-F**.
-
-Optional Arguments
-------------------
-
-**-A**
- Flip the default byte-swap state (default assumes data have a
- bigendian byte-order).
-**-C**\ *clip*
- Sample value at which to clip data (clipping is applied to both
- positive and negative values).
-**-I**
- Fill negative rather than positive excursions.
-
-.. include:: ../../explain_-K.rst_
-
-**-L**\ *nsamp*
- Override number of samples per trace in reel header (program
- attempts to determine number of samples from each trace header if
- possible to allow for variable length traces).
-**-M**\ *ntrace*
- Override number of traces specified in reel header. Program detects
- end of file (relatively) gracefully, but this parameter limits
- number of traces that the program attempts to read.
-**-N**
- Normalize trace by dividing by rms amplitude over full trace length.
-
-.. include:: ../../explain_-O.rst_
-.. include:: ../../explain_-P.rst_
-
-**-Q**\ *<mode><value>*
- Can be used to change 4 different settings:
- **-Qb**\ *<bias>* to bias scaled traces (-B-0.1 subtracts 0.1 from values)
-
- **-Qu**\ *<redvel>* to apply reduction velocity (-ve removes reduction already present)
-
- **-Qx**\ *<mult>* to multiply trace locations by *mult*
-
- **-Qy**\ *<dy>* to override sample interval in reel header.
-
-**-S**\ *header_x*/*header_y*
- Read trace locations from trace headers: header is either c for CDP,
- o for offset, b<num> to read a long starting at byte <num> in the
- header (first byte corresponds to num=0), or a number to fix the
- location. First parameter for x, second for y. Default has X and Y
- given by trace number.
-**-U**\ *redvel*
- Apply reduction velocity by shifting traces *upwards* by
- redvel/\|offset\|. Negative velocity removes existing reduction.
- Units should be consistent with offset in trace header and sample
- interval.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-.. include:: ../../explain_-XY.rst_
-
-**-Z**
- Do not plot traces with zero rms amplitude.
-
-.. |Add_perspective| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_perspective.rst_
-
-.. include:: ../../explain_-t.rst_
-.. include:: ../../explain_help.rst_
-
-Examples
---------
-
-To plot the SEGY file wa1.segy with normalized traces plotted at true
-offset locations, clipped at +-3 and with wiggle trace and positive
-variable area shading in black, use
-
- ::
-
- pssegyz wa1.segy -JX5i/-5i -D1 -Jz0.05i -E180/5 -R0/100/0/10/0/10 \
- -C3 -N -So -W -Fblack > segy.ps
-
-Bugs
-----
-
-Variable area involves filling four-sided figures of distressing
-generality. I *know* that some of the more complex degenerate cases are
-not dealt with correctly or at all; the incidence of such cases
-increases as viewing angles become more oblique, and particularly as the
-viewing elevation increases. Wiggle-trace plotting is not affected.
-
-See Also
---------
-
-:doc:`gmt </gmt>`, :doc:`pssegy`
diff --git a/doc_release/html/_sources/supplements/segy/segy2grd.txt b/doc_release/html/_sources/supplements/segy/segy2grd.txt
deleted file mode 100644
index d112798..0000000
--- a/doc_release/html/_sources/supplements/segy/segy2grd.txt
+++ /dev/null
@@ -1,119 +0,0 @@
-.. index:: ! segy2grd
-
-********
-segy2grd
-********
-
-.. only:: not man
-
- segy2grd - Converting SEGY data to a GMT grid
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**segy2grd** *segyfile* **-G**\ *grdfile*
-|SYN_OPT-I|
-|SYN_OPT-R|
-[ **-A**\ [**n**\ \|\ **z**] ]
-[ **-D**\ *xname*/*yname*/*zname*/*scale*/*offset*/*title*/*remark* ]
-[ **-M**\ [*flags*\ ] ] [ **-N**\ *nodata* ] [ **-S**\ [*zfile*] ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-bi| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**segy2grd** reads an IEEE SEGY file and creates a binary grid file.
-Either a simple mapping (equivalent to xyz2grd -Z) or a more complicated
-averaging where a particular grid cell includes values from more than
-one sample in the SEGY file can be done. **segy2grd** will report if
-some of the nodes are not filled in with data. Such unconstrained nodes
-are set to a value specified by the user [Default is NaN]. Nodes with
-more than one value will be set to the average value.
-
-Required Arguments
-------------------
-
-*segyfile* is an IEEE floating point SEGY file. Traces are all assumed to start at 0 time/depth.
-
-**-G**\ *grdfile*
- *grdfile* is the name of the binary output grid file.
-**-I**
- *x_inc* [and optionally *y_inc*] is the grid spacing. Append **m**
- to indicate minutes or **c** to indicate seconds.
-
-.. |Add_-Rgeo| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-Rgeo.rst_
-
-Optional Arguments
-------------------
-
-**-A**\ [**n**\ \|\ **z**]
- Add up multiple values that belong to the same node (same as
- **-Az**). Append **n** to simply count the number of data points
- that were assigned to each node. [Default (no **-A** option) will
- calculate mean value]. Not used for simple mapping.
-**-D**\ *xname*/*yname*/*zname*/*scale*/*offset*/*title*/*remark*
- Give values for *xname*, *yname*, *zname*, *scale*, *offset*,
- *title*, and *remark*. To leave some of these values untouched,
- specify = as the value.
-**-M**\ [*flags*\ ]
- Fix number of traces to read in. Default tries to read 10000 traces.
- **-M**\ 0 will read number in binary header, **-M**\ *n* will
- attempt to read only *n* traces.
-**-N**\ *nodata*
- No data. Set nodes with no input sample to this value [Default is
- NaN].
-**-S**\ [*zfile*\ ]
- set variable spacing *header* is c for cdp, o for offset, b<number>
- for 4-byte float starting at byte number If -S not set, assumes even
- spacing of samples at the dx, dy supplied with -I
-**-L**
- Override number of samples in each trace
-**-X**
- applies scalar *x-scale* to coordinates in trace header to match the
- coordinates specified in -R
-**-Y**
- Specifies sample interval as *s_int* if incorrect in the SEGY file
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-.. |Add_nodereg| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_nodereg.rst_
-
-.. include:: ../../explain_help.rst_
-
-Examples
---------
-
-To create a grid file from an even spaced SEGY file test.segy, try
-
- ::
-
- gmt segy2grd test.segy -I0.1/0.1 -Gtest.nc -R198/208/18/25 -V
-
-Note that this will read in 18-25s (or km) on each trace, but the
-first trace will be assumed to be at X=198
-
-To create a grid file from the SEGY file test.segy, locating traces
-according to the CDP number, where there are 10 CDPs per km and the
-sample interval is 0.1, try
-
- ::
-
- gmt segy2grd test.segy -Gtest.nc -R0/100/0/10 -I0.5/0.2 -V -X0.1 -Y0.1
-
-Because the grid interval is larger than the SEGY file sampling, the
-individual samples will be averaged in bins
-
-See Also
---------
-
-:doc:`gmt </gmt>`, :doc:`grd2xyz </grd2xyz>`,
-:doc:`grdedit </grdedit>`, :doc:`pssegy`
diff --git a/doc_release/html/_sources/supplements/spotter/backtracker.txt b/doc_release/html/_sources/supplements/spotter/backtracker.txt
deleted file mode 100644
index d55d9e2..0000000
--- a/doc_release/html/_sources/supplements/spotter/backtracker.txt
+++ /dev/null
@@ -1,193 +0,0 @@
-.. index:: ! backtracker
-
-***********
-backtracker
-***********
-
-.. only:: not man
-
- backtracker - Generate forward and backward flowlines and hotspot tracks
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**backtracker** [ *table* ] **-E**\ *rot_file*\|\ *lon*/*lat*/*angle*
-[ **-A**\ [*young*/*old*] ] [
-**-Df**\ \|\ **b** ] [ **-F**\ *drift.txt* ] [
-**-Lf**\ \|\ **b**\ *step* ] [ **-N**\ *upper_age* ] [
-**-Q**\ *fixed_age* ] [ **-S**\ *filestem* ] [ **-T**\ *zero_age* ]
-[ |SYN_OPT-V| ]
-[ **-W**\ [**a**\ \|\ **t**] ]
-[ |SYN_OPT-b| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-o| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**backtracker** reads (longitude, latitude, age) positions from
-*infiles* [or standard input] and computes rotated (x,y,t) coordinates
-using the specified rotation parameters. It can either calculate final
-positions [Default] or create a sampled track (flowline or hotspot
-track) between the initial and final positions. The former mode allows
-additional data fields after the first 3 columns which must have
-(longitude,latitude,age). See option **-:** on how to read
-(latitude,longitude,age) files.
-
-Required Arguments
-------------------
-
-**-E**\ *rotfile*
- Give file with rotation parameters. This file must contain one
- record for each rotation; each record must be of the following
- format:
-
- *lon lat tstart [tstop] angle* [ *khat a b c d e f g df* ]
-
- where *tstart* and *tstop* are in Myr and *lon lat angle* are in
- degrees. *tstart* and *tstop* are the ages of the old and young ends
- of a stage. If *tstop* is not present in the record then a total
- reconstruction rotation is expected and *tstop* is implicitly set to
- 0 and should not be specified for any of the records in the file. If
- a covariance matrix **C** for the rotation is available it must be
- specified in a format using the nine optional terms listed in
- brackets. Here, **C** = (*g*/*khat*)\*[ *a b d; b c e; d e f* ]
- which shows **C** made up of three row vectors. If the degrees of
- freedom (*df*) in fitting the rotation is 0 or not given it is set
- to 10000. Blank lines and records whose first column contains # will
- be ignored. You may prepend a leading + to the filename to indicate
- you wish to invert the rotations.
- Alternative 1: Give the filename composed of two plate IDs
- separated by a hyphen (e.g., PAC-MBL) and we will instead extract
- that rotation from the GPlates rotation database. We return an error
- if the rotation cannot be found.
- Alternative 2: Specify *lon*/*lat*/*angle*, i.e., the longitude,
- latitude, and opening angle (all in degrees and separated by /) for
- a single total reconstruction rotation.
-
-Optional Arguments
-------------------
-
-.. |Add_intables| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_intables.rst_
-
-**-A**\ [*young*/*old*]
- Used in conjunction with **-Lb**\ \|\ **f** to limit the track
- output to those sections whose predicted ages lie between the
- specified *young* and *old* limits. If **-LB**\ \|\ **F** is used
- instead then the limits apply to the stage ids (id 1 is the youngest
- stage). If no limits are specified then individual limits for each
- record are expected in columns 4 and 5 of the input file.
-**-Df**\ \|\ **b**
- Set the direction to go: **-Df** will go backward in time (from
- younger to older positions), while **-Db** will go forward in time
- (from older to younger positions) [Default]. Note: For **-Db** you
- are specifying the age at the given location, whereas for **-Df**
- you are not; instead you specify the age at the reconstructed point.
-**-F**\ *drift.txt*
- Supply a file with lon, lat, age records that describe the history
- of hotspot motion for the current hotspot. The reconstructions will
- only use the 3rd data input column (i.e., the age) to obtain the
- location of the hotspot at that time, via an interpolation of the
- hotspot motion history. This adjusted location is then used to
- reconstruct the point or path [No drift].
-**-Lf**\ \|\ **b**\ *step*
- Specify a sampled path between initial and final position: **-Lf**
- will draw particle flowlines, while **-Lb** will draw backtrack
- (hotspot track) paths. Append sampling interval in km. If *step* < 0
- then only the rotation times will be returned. When **-LF** or
- **-LB** is used, the third output column will contain the stage id
- (1 is youngest) [Default is along-track predicted ages]. You can
- control the direction of the paths by using **-D**.
-**-N**\ *upper_age*
- Set the maximum age to extend the oldest stage rotation back in time
- [Default is no extension].
-**-Q**\ *fixed_age*
- Assign a fixed age to all positions. Only lon, lat input is expected
- [Default expects longitude, latitude, age]. Useful when the input
- are points defining isochrons.
-**-S**\ *filestem*
- When **-L** is set, the tracks are normally written to *stdout* as a
- multisegment file. Specify a *filestem* to have each track written
- to *filestem.#*, where *#* is the track number. The track number is
- also copied to the 4th output column.
-**-T**\ *zero_age*
- Set the current time [Default is 0 Ma].
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-**-W**\ [**a**\ \|\ **t**]
- Rotates the given input (lon,lat,t) and calculates the confidence
- ellipse for the projected point. The input point *must* have a time
- coordinate that exactly matches a particular total reconstruction
- rotation time, otherwise the point will be skipped. Append **t** or
- **a** to output time or angle, respectively, after the projected
- lon, lat. After these 2-3 items, we write azimuth, major, minor (in
- km) for the 95% confidence ellipse. See **-D** for the direction of
- rotation.
-
-.. |Add_-bi| replace:: [Default is 3 input columns].
-.. include:: ../../explain_-bi.rst_
-
-.. |Add_-bo| replace:: [Default is same as input].
-.. include:: ../../explain_-bo.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-h.rst_
-
-.. include:: ../../explain_-icols.rst_
-.. include:: ../../explain_-ocols.rst_
-.. include:: ../../explain_colon.rst_
-.. include:: ../../explain_help.rst_
-
-.. include:: explain_geodetic.rst_
-
-Examples
---------
-
-To backtrack the (x,y,t) points in the file seamounts.d to their origin
-(presumably the hotspot), using the DC85.d Euler poles, run
-
- ::
-
- gmt backtracker seamounts.d -Db -EDC85.d > newpos.d
-
-To project flowlines forward from the (x,y,t) points stored in several
-3-column, binary, double precision files, run
-
- ::
-
- gmt backtracker points.gmt \* -Df -EDC85.d -Lf25 -bo -bi3 > lines.b
-
-This file can then be plotted with **psxy**.
-To compute the predicted Hawaiian hotspot track from 0 to 80 Ma every 1
-Ma, given a history of hotspot motion file (HIdrift.txt) and a set of
-total reconstruction rotations for the plate (PAC_APM.d), try
-
- ::
-
- echo 204 19 80 | gmt backtracker -Df -EPAC_APM.d -Lb1 > path.d
-
-See Also
---------
-
-:doc:`gmt </gmt>` ,
-:doc:`project </project>` ,
-:doc:`grdrotater`,
-:doc:`grdspotter`,
-:doc:`mapproject </mapproject>`,
-:doc:`hotspotter`,
-:doc:`originator`
-
-References
-----------
-
-Wessel, P., 1999, "Hotspotting" tools released, EOS Trans. AGU, 80 (29),
-p. 319.
diff --git a/doc_release/html/_sources/supplements/spotter/grdpmodeler.txt b/doc_release/html/_sources/supplements/spotter/grdpmodeler.txt
deleted file mode 100644
index a95b778..0000000
--- a/doc_release/html/_sources/supplements/spotter/grdpmodeler.txt
+++ /dev/null
@@ -1,148 +0,0 @@
-.. index:: ! grdpmodeler
-
-***********
-grdpmodeler
-***********
-
-.. only:: not man
-
- grdpmodeler - Evaluate a plate model on a geographic grid
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**grdpmodeler** *agegrdfile* **-E**\ *rot_file* **-G**\ *outgrdfile*
-**-S**\ **a**\ \|\ **d**\ \|\ **r**\ \|\ **w**\ \|\ **x**\ \|\ **y**\ \|\ **X**\ \|\ **Y**
-[ **-F**\ *polygonfile* ] [ **-T**\ *age* ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-b| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**grdpmodeler** reads a geographical age grid and a plate motion model
-and evaluates one of several model predictions. Optionally, the user may
-supply a clipping polygon in multiple-segment format; then, only the
-part of the grid inside the polygon is used to determine the model
-prediction; the remainder of the grid is set to NaN.
-
-Required Arguments
-------------------
-
-*ingrdfile*
- Name of a grid file in geographical (lon, lat) coordinates with ages
- in Myr.
-**-E**\ *rotfile*
- Give file with rotation parameters. This file must contain one
- record for each rotation; each record must be of the following
- format:
-
- *lon lat tstart [tstop] angle* [ *khat a b c d e f g df* ]
-
- where *tstart* and *tstop* are in Myr and *lon lat angle* are in
- degrees. *tstart* and *tstop* are the ages of the old and young ends
- of a stage. If *tstop* is not present in the record then a total
- reconstruction rotation is expected and *tstop* is implicitly set to
- 0 and should not be specified for any of the records in the file. If
- a covariance matrix **C** for the rotation is available it must be
- specified in a format using the nine optional terms listed in
- brackets. Here, **C** = (*g*/*khat*)\*[ *a b d; b c e; d e f* ]
- which shows **C** made up of three row vectors. If the degrees of
- freedom (*df*) in fitting the rotation is 0 or not given it is set
- to 10000. Blank lines and records whose first column contains # will
- be ignored. You may prepend a leading + to the filename to indicate
- you wish to invert the rotations.
- Alternatively, give the filename composed of two plate IDs
- separated by a hyphen (e.g., PAC-MBL) and we will instead extract
- that rotation from the GPlates rotation database. We return an error
- if the rotation cannot be found.
-
-**-G**\ *outgrdfile*
- Name of output grid. This is the grid with the model predictions
- given the specified rotations.
-**-S**\ **a**\ \|\ **d**\ \|\ **r**\ \|\ **w**\ \|\ **x**\ \|\ **y**\ \|\ **X**\ \|\ **Y**
- Type of model prediction. Choose from **a** for plate motion
- azimuth, **d** for distance between current locations and their
- origin at the ridge (in km), **r** for plate motion rate (in mm/yr),
- **w** for plate rotation rate (degree/Myr), **x** change in
- longitude relative to location of crust formation, **y** change in
- latitude relative to location of crust formation, **X** longitude of
- crust formation, and **Y** latitude of crust formation.
-
-Optional Arguments
-------------------
-
-**-F**\ *polygonfile*
- Specify a multisegment closed polygon file that describes the inside
- area of the grid where the model should be evaluated; the outside
- will be set to NaN [Default evaluates model on the entire grid].
-**-T**\ *age*
- Use a fixed age for model evaluation (i.e., override the ages in the
- age grid). This lets you evaluate the model at a snapshot in time.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-.. |Add_-bi| replace:: [Default is 2 input columns].
-.. include:: ../../explain_-bi.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-h.rst_
-
-.. include:: ../../explain_-icols.rst_
-.. include:: ../../explain_help.rst_
-
-.. include:: explain_geodetic.rst_
-
-Examples
---------
-
-We will use a grid with Pacific crust ages (pac_age.nc), a plate motion
-model (Pac_APM.d), and a polygon that contains the outline of the
-present Pacific plate (pac_clip_path.d). To evaluate the plate motion
-azimuths at the present time for the Pacific, try
-
- ::
-
- gmt grdpmodeler pac_age.nc -EPac_APM.d -V -Fpac_clip_path.d \
- -Gpac_dir_0.nc -Sa -T0
-
-To determine the changes in latitude since crust formation for the
-entire Pacific, try
-
- ::
-
- gmt grdpmodeler pac_age.nc -EPac_APM.d -V -Fpac_clip_path.d \
- -Gpac_dlat.nc -Sy
-
-To determine the plate motion rates in effect when the Pacific crust was
-formed, try
-
- ::
-
- gmt grdpmodeler pac_age.nc -EPac_APM.d -V -Fpac_clip_path.d \
- -Gpac_vel.nc -Sr
-
-To determine how far the crust has moved since formation, try
-
- ::
-
- gmt grdpmodeler pac_age.nc -EPac_APM.d -V -Fpac_clip_path.d \
- -Gpac_dist.nc -Sd
-
-See Also
---------
-
-:doc:`backtracker`,
-:doc:`grdrotater`,
-:doc:`grdspotter`,
-:doc:`hotspotter`,
-:doc:`originator`,
-:doc:`rotconverter`
diff --git a/doc_release/html/_sources/supplements/spotter/grdrotater.txt b/doc_release/html/_sources/supplements/spotter/grdrotater.txt
deleted file mode 100644
index 086b83a..0000000
--- a/doc_release/html/_sources/supplements/spotter/grdrotater.txt
+++ /dev/null
@@ -1,162 +0,0 @@
-.. index:: ! grdrotater
-
-**********
-grdrotater
-**********
-
-.. only:: not man
-
- grdrotater - Finite rotation reconstruction of geographic grid
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**grdrotate** *ingrdfile* **-E**\ *rot_file*\|\ *lon*/*lat*/*angle*
-**-G**\ *outgrdfile* [ **-F**\ *polygonfile* ]
-[ **-N** ]
-[ |SYN_OPT-R| ]
-[ **-S** ] [ **-T**\ *age* ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-b| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-n| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**grdrotater** reads a geographical grid and reconstructs it given a
-total reconstruction rotation. Optionally, the user may supply a
-clipping polygon in multiple-segment format; then, only the part of the
-grid inside the polygon is used to determine the return grid region. The
-outline of the projected region is returned on stdout provided the
-rotated region is not the entire globe.
-
-Required Arguments
-------------------
-
-*ingrdfile*
- Name of a grid file in geographical (lon, lat) coordinates.
-**-E**\ *rotfile*
- Give file with rotation parameters. This file must contain one
- record for each rotation; each record must be of the following
- format:
-
- *lon lat tstart [tstop] angle* [ *khat a b c d e f g df* ]
-
- where *tstart* and *tstop* are in Myr and *lon lat angle* are in
- degrees. *tstart* and *tstop* are the ages of the old and young ends
- of a stage. If *tstop* is not present in the record then a total
- reconstruction rotation is expected and *tstop* is implicitly set to
- 0 and should not be specified for any of the records in the file. If
- a covariance matrix **C** for the rotation is available it must be
- specified in a format using the nine optional terms listed in
- brackets. Here, **C** = (*g*/*khat*)\*[ *a b d; b c e; d e f* ]
- which shows **C** made up of three row vectors. If the degrees of
- freedom (*df*) in fitting the rotation is 0 or not given it is set
- to 10000. Blank lines and records whose first column contains # will
- be ignored. You may prepend a leading + to the filename to indicate
- you wish to invert the rotations.
- Alternative 1: Give the filename composed of two plate IDs
- separated by a hyphen (e.g., PAC-MBL) and we will instead extract
- that rotation from the GPlates rotation database. We return an error
- if the rotation cannot be found.
- Alternative 2: Specify *lon*/*lat*/*angle*, i.e., the longitude,
- latitude, and opening angle (all in degrees and separated by /) for
- a single total reconstruction rotation.
-
-**-G**\ *outgrdfile*
- Name of output grid. This is the grid with the data reconstructed
- according to the specified rotation.
-
-Optional Arguments
-------------------
-
-**-F**\ *polygonfile*
- Specify a multisegment closed polygon file that describes the inside
- area of the grid that should be projected [Default projects entire
- grid].
-**-N**
- Do Not output the rotated polygon outline [Default will write it to stdout].
-
-.. |Add_-Rgeo| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-Rgeo.rst_
-
-**-S**
- Skip the rotation of the grid, just rotate the polygon outline
- (requires **-F**).
-**-T**\ *age*
- Sets the desired age of reconstruction when **-E** is given.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-.. |Add_-bi| replace:: [Default is 2 input columns].
-.. include:: ../../explain_-bi.rst_
-
-.. |Add_-bo| replace:: [Default is same as input].
-.. include:: ../../explain_-bo.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-h.rst_
-
-.. include:: ../../explain_colon.rst_
-.. include:: ../../explain_-icols.rst_
-.. include:: ../../explain_-n.rst_
-.. include:: ../../explain_help.rst_
-.. include:: ../../explain_grdresample2.rst_
-
-.. include:: explain_geodetic.rst_
-
-Examples
---------
-
-To rotate the data defined by grid topo.nc and the polygon outline
-clip_path.d, using a total reconstruction rotation with pole at (135.5,
--33.0) and a rotation angle of 37.3 degrees and bicubic interpolation, try
-
- ::
-
- gmt grdrotater topo.nc -E135.5/-33/37.3 -V -Fclip_path.d -Grot_topo.nc > rot_clip_path.d
-
-To rotate the entire grid faa.nc back to 32 Ma using the rotation file
-*rotations.txt* and a bilinear interpolation, try
-
- ::
-
- gmt grdrotater faa.nc -Erotations.txt -T32 -V -Grot_faa.nc -nl > rot_faa_path.d
-
-To just see how the outline of the grid large.nc will plot after the
-same rotation, try
-
- ::
-
- gmt grdrotater large.nc -Erotations.txt -T32 -V -S \| psxy -Rg -JH180/6i -B30 -W0.5p \| gv -
-
-Let say you have rotated gridA.nc and gridB.nc, restricting each
-rotation to nodes inside polygons polyA.d and polyB.d, respectively,
-using rotation A = (123W,22S,16,4) and rotation B = (108W, 16S, -14.5),
-yielding rotated grids rot_gridA.nc and rot_gridB.nc. To determine the
-region of overlap between the rotated grids, we use grdmath:
-
- ::
-
- gmt grdmath 1 rot_gridA.nc ISNAN SUB 1 rot_gridB.nc ISNAN SUB 2 EQ = overlap.nc
-
-The grid overlap.nc now has 1s in the regions of overlap and 0
-elsewhere. You can use it as a mask or use grdcontour **-D** to extract
-a polygon (contour).
-
-See Also
---------
-
-:doc:`backtracker`,
-:doc:`grdspotter`,
-:doc:`hotspotter`,
-:doc:`originator`,
-:doc:`rotconverter`
diff --git a/doc_release/html/_sources/supplements/spotter/grdspotter.txt b/doc_release/html/_sources/supplements/spotter/grdspotter.txt
deleted file mode 100644
index 5f9bf9b..0000000
--- a/doc_release/html/_sources/supplements/spotter/grdspotter.txt
+++ /dev/null
@@ -1,183 +0,0 @@
-.. index:: ! grdspotter
-
-**********
-grdspotter
-**********
-
-.. only:: not man
-
- grdspotter - Create CVA image from a gravity or topography grid
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**grdspotter** [*grdfile*] **-E**\ *rotfile* **-G**\ *CVAgrid*
-|SYN_OPT-I|
-|SYN_OPT-R|
-[ **-A**\ *agegrid* ]
-[ **-D**\ *DIgrid* ] [ **-L**\ *IDgrid* ] [ **-M** ]
-[ **-N**\ *upper_age* ] [ **-P**\ *PAgrid* ] [ **-Q**\ *IDinfo* ] [
-**-S** ] [ **-T**\ **t**\ \|\ **u**\ *fixed_val* ] [
-[ |SYN_OPT-V| ]
-[ **-W**\ *n\_try* ]] [ **-Z**\ *z_min*\ [/*z_max*\ [/*z_inc*]] ] [
-**-r** ]
-
-|No-spaces|
-
-Description
------------
-
-**grdspotter** reads a grid file with residual bathymetry or gravity and
-calculates flowlines from each node that exceeds a minimum value using
-the specified rotations file. These flowlines are then convolved with
-the volume of the prism represented by each grid node and added up to
-give a Cumulative Volcano Amplitude grid (CVA).
-
-Required Arguments
-------------------
-
-*grdfile*
- Data grid to be processed, typically residual bathymetry or free-air anomalies.
-
-**-E**\ *rotfile*
- Give file with rotation parameters. This file must contain one
- record for each rotation; each record must be of the following
- format:
-
- *lon lat tstart [tstop] angle* [ *khat a b c d e f g df* ]
-
- where *tstart* and *tstop* are in Myr and *lon lat angle* are in
- degrees. *tstart* and *tstop* are the ages of the old and young ends
- of a stage. If *tstop* is not present in the record then a total
- reconstruction rotation is expected and *tstop* is implicitly set to
- 0 and should not be specified for any of the records in the file. If
- a covariance matrix **C** for the rotation is available it must be
- specified in a format using the nine optional terms listed in
- brackets. Here, **C** = (*g*/*khat*)\*[ *a b d; b c e; d e f* ]
- which shows **C** made up of three row vectors. If the degrees of
- freedom (*df*) in fitting the rotation is 0 or not given it is set
- to 10000. Blank lines and records whose first column contains # will
- be ignored. You may prepend a leading + to the filename to indicate
- you wish to invert the rotations.
- Alternatively, give the filename composed of two plate IDs
- separated by a hyphen (e.g., PAC-MBL) and we will instead extract
- that rotation from the GPlates rotation database. We return an error
- if the rotation cannot be found.
-
-**-G**
- Specify name for output CVA grid file.
-
-.. include:: ../../explain_-I.rst_
-
-.. |Add_-Rgeo| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-Rgeo.rst_
-
-Optional Arguments
-------------------
-
-**-A**\ *agegrid*
- Supply a crustal age grid that is co-registered with the input data
- grid. These ages become the upper ages to use when constructing
- flowlines [Default extend flowlines back to oldest age found in the
- rotation file; but see **-N**].
-
-**-D**\ *DIgrid*
- Use flowlines to determine the maximum CVA encountered along each
- flowline and create a Data Importance (DI) grid with these values at
- the originating nodes.
-
-**-L**\ *IDgrid*
- Supply a co-registered grid with seamount chain IDs for each node.
- This option requires that you also use **-Q**.
-
-**-M**
- Do not attempt to keep all flowlines in memory when using **-D**
- and/or **-P**. Should you run out of memory you can use this option
- to compute flowlines on-the-fly. It will be slower as we no longer
- can reuse the flowlines calculated for the CVA step. Cannot be used
- with **-W** or the multi-slice mode in **-Z**.
-
-**-N**\ *upper_age*
- Set the upper age to assign to nodes whose crustal age is unknown
- (i.e., NaN) [no upper age]. Also see **-A**.
-
-**-P**\ *PAgrid*
- Use flowlines to determine the flowline age at the CVA maximum for
- each node and create a Predicted Age (PA) grid with these values at
- the originating nodes.
-
-**-Q**\ *IDinfo*
- Either give (1) a single ID to use or (2)
- the name of a file with a list of IDs to use
- [Default uses all IDs]. Each line would be TAG ID [w e s n]. The
- *w/e/s/n* zoom box is optional; if specified it means we only trace
- the flowline if inside this region [Default uses region set by
- **-R**]. Requires **-L**.
-
-**-S**
- Normalize the resulting CVA grid to percentages of the CVA maximum.
- This also normalizes the DI grid (if requested).
-
-**-T**\ **t**\ \|\ **u**\ *fixed_val*
- Selects ways to adjust ages; repeatable. Choose from **-Tt** to
- truncate crustal ages given via the **-A** option that exceed the
- upper age set with **-N** [no truncation], or **-Tu**\ *fixed_val*
- which means that after a node passes the test implied by **-Z**, we
- use this *fixed_val* instead in the calculations. [Default uses
- individual node values].
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-**-W**\ *n\_try*
- Get *n\_try* bootstrap estimates of the maximum CVA location; the
- longitude and latitude results are written to stdout [Default is no
- bootstrapping]. Cannot be used with **-M**.
-
-**-Z**\ *z_min*\ [/*z_max*\ [/*z_inc*]]
- Ignore nodes with z-values lower than *z_min* [0] and optionally
- larger than *z_max* [Inf]. Give *z_min/z_max/z_inc* to make
- separate CVA grids for each *z*-slice [Default makes one CVA grid].
- Multi-slicing cannot be used with **-M**.
-
-.. |Add_nodereg| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_nodereg.rst_
-
-.. include:: ../../explain_help.rst_
-
-.. include:: explain_geodetic.rst_
-
-Examples
---------
-
-To create a CVA image from the Pacific topography grid
-Pac_res_topo.nc, using the DC85.d Euler poles, and only output a grid
-for the specified domain, run
-
- ::
-
- gmt grdspotter Pac_res_topo.nc -EDC85.d -GCVA.nc -R190/220/15/25 -I2m -N145 -Tt -V
-
-This file can then be plotted with :doc:`grdimage </grdimage>`.
-
-See Also
---------
-
-:doc:`gmt </gmt>`,
-:doc:`grdimage </grdimage>`,
-:doc:`project </project>`,
-:doc:`mapproject </mapproject>`,
-:doc:`backtracker`,
-:doc:`hotspotter`,
-:doc:`originator`
-
-References
-----------
-
-Wessel, P., 1999, "Hotspotting" tools released, EOS Trans. AGU, 80 (29), p. 319.
-
-Wessel, P., 2008, Hotspotting: Principles and properties of a plate
-tectonic Hough transform, Geochem. Geophys. Geosyst. 9(Q08004):
-doi:10.1029/2008GC002058.
diff --git a/doc_release/html/_sources/supplements/spotter/hotspotter.txt b/doc_release/html/_sources/supplements/spotter/hotspotter.txt
deleted file mode 100644
index e70011b..0000000
--- a/doc_release/html/_sources/supplements/spotter/hotspotter.txt
+++ /dev/null
@@ -1,148 +0,0 @@
-.. index:: ! hotspotter
-
-**********
-hotspotter
-**********
-
-.. only:: not man
-
- hotspotter - Create CVA image from seamount locations
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**hotspotter** [*table*\ ] **-E**\ *rotfile* **-G**\ *CVAgrid*
-|SYN_OPT-I|
-|SYN_OPT-R|
-[ **-N**\ *upper_age* ] [ **-S** ] [ **-T** ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-bi| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-o| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**hotspotter** reads (longitude, latitude, amplitude, radius, age)
-records from *infiles* [or standard input] and calculates flowlines
-using the specified stage or total reconstruction rotations. These
-flowlines are convolved with the shape of the seamount (using a Gaussian
-shape given amplitude and radius = 6 sigma) and added up to give a
-Cumulative Volcano Amplitude grid (CVA). See option **-:** on how to
-read (latitude,longitude,...) files.
-
-Required Arguments
-------------------
-
-.. |Add_intables| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_intables.rst_
-
-**-E**\ *rotfile*
- Give file with rotation parameters. This file must contain one
- record for each rotation; each record must be of the following format:
-
- *lon lat tstart [tstop] angle* [ *khat a b c d e f g df* ]
-
- where *tstart* and *tstop* are in Myr and *lon lat angle* are in
- degrees. *tstart* and *tstop* are the ages of the old and young ends
- of a stage. If *tstop* is not present in the record then a total
- reconstruction rotation is expected and *tstop* is implicitly set to
- 0 and should not be specified for any of the records in the file. If
- a covariance matrix **C** for the rotation is available it must be
- specified in a format using the nine optional terms listed in
- brackets. Here, **C** = (*g*/*khat*)\*[ *a b d; b c e; d e f* ]
- which shows **C** made up of three row vectors. If the degrees of
- freedom (*df*) in fitting the rotation is 0 or not given it is set
- to 10000. Blank lines and records whose first column contains # will
- be ignored. You may prepend a leading + to the filename to indicate
- you wish to invert the rotations.
- Alternatively, give the filename composed of two plate IDs
- separated by a hyphen (e.g., PAC-MBL) and we will instead extract
- that rotation from the GPlates rotation database. We return an error
- if the rotation cannot be found.
-
-**-G**\ *CVAgrid*
- Specify name for output grid file.
-
-.. include:: ../../explain_-I.rst_
-
-.. |Add_-Rgeo| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-Rgeo.rst_
-
-Optional Arguments
-------------------
-
-**-D**\ *factor*
- Modify the sampling interval along flowlines. Default [0.5] gives
- approximately 2 points within each grid box. Smaller factors gives
- higher resolutions at the expense of longer processing time.
-
-**-N**\ *upper_age*
- Set the upper age to assign seamounts whose crustal age is unknown
- (i.e., NaN) [no upper age].
-
-**-S**
- Normalize the resulting CVA grid to percentages of the CVA maximum.
-
-**-T**
- Truncate seamount ages exceeding the upper age set with **-N** [no
- truncation].
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-.. |Add_-bi| replace:: [Default is 5 input columns].
-.. include:: ../../explain_-bi.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-h.rst_../../explain_-V.rst_
-
-.. include:: ../../explain_-icols.rst_
-.. include:: ../../explain_-ocols.rst_
-
-.. |Add_nodereg| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_nodereg.rst_
-
-.. include:: ../../explain_colon.rst_
-.. include:: ../../explain_help.rst_
-
-.. include:: explain_geodetic.rst_
-
-Examples
---------
-
-To create a CVA image from the Pacific (x,y,z,r,t) data in the file
-seamounts.d, using the DC85.d Euler poles, run
-
- ::
-
- gmt hotspotter seamounts.d -EDC85.d -GCVA.nc -R130/260/-66/60 -I10m -N145 -T -V
-
-This file can then be plotted with :doc:`grdimage </grdimage>`.
-
-See Also
---------
-
-:doc:`gmt </gmt>`, :doc:`grdimage </grdimage>`,
-:doc:`grdrotater`,
-:doc:`grdspotter`,
-:doc:`project </project>`,
-:doc:`mapproject </mapproject>`,
-:doc:`backtracker`,
-:doc:`originator`
-
-References
-----------
-
-Wessel, P., 1999, "Hotspotting" tools released, EOS Trans. AGU, 80 (29), p. 319.
-
-Wessel, P., 2008, Hotspotting: Principles and properties of a plate
-tectonic Hough transform, Geochem. Geophys. Geosyst. 9(Q08004):
-doi:10.1029/2008GC002058.
-
diff --git a/doc_release/html/_sources/supplements/spotter/originator.txt b/doc_release/html/_sources/supplements/spotter/originator.txt
deleted file mode 100644
index 8aa6495..0000000
--- a/doc_release/html/_sources/supplements/spotter/originator.txt
+++ /dev/null
@@ -1,201 +0,0 @@
-.. index:: ! originator
-
-**********
-originator
-**********
-
-.. only:: not man
-
- originator - Associate seamounts with nearest hotspot point sources
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**originator** [ *table* ] **-E**\ [**+**]\ *rotfile*
-**-F**\ [**+**]\ *hs_file* [ **-D**\ *d_km* ] [ **-L**\ [*flag*] ]
-[ **-N**\ *upper_age* ] [ **-Q**\ *r/t* ] [ **-S**\ [*n_hs*] ]
-[ **-T** ]
-[ |SYN_OPT-V| ]
-[ **-W**\ *maxdist* ]
-[ **-Z** ]
-[ |SYN_OPT-bi| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**originator** reads (longitude, latitude, height, radius, crustal_age)
-records from *infiles* [or standard input] and uses the given Absolute
-Plate Motion (APM) stage or total reconstruction rotation file and the
-list of hotspot locations to determine the most likely origin (hotspot)
-for each seamount. It does so by calculating flowlines back in time and
-determining the closest approach to all hotspots. The output consists of
-the input records with four additional fields added for each of the
-*n_hs* closest hotspots. The four fields are the hotspot id (e.g.,
-HWI), the stage id of the flowline segment that came closest, the
-pseudo-age of the seamount, and the closest distance to the hotspot (in
-km). See option **-:** on how to read (latitude, longitude,height,
-radius, crustal_age) files.
-
-Required Arguments
-------------------
-
-**-E**\ *rotfile*
- Give file with rotation parameters. This file must contain one
- record for each rotation; each record must be of the following
- format:
-
- *lon lat tstart [tstop] angle* [ *khat a b c d e f g df* ]
-
- where *tstart* and *tstop* are in Myr and *lon lat angle* are in
- degrees. *tstart* and *tstop* are the ages of the old and young ends
- of a stage. If *tstop* is not present in the record then a total
- reconstruction rotation is expected and *tstop* is implicitly set to
- 0 and should not be specified for any of the records in the file. If
- a covariance matrix **C** for the rotation is available it must be
- specified in a format using the nine optional terms listed in
- brackets. Here, **C** = (*g*/*khat*)\*[ *a b d; b c e; d e f* ]
- which shows **C** made up of three row vectors. If the degrees of
- freedom (*df*) in fitting the rotation is 0 or not given it is set
- to 10000. Blank lines and records whose first column contains # will
- be ignored. You may prepend a leading + to the filename to indicate
- you wish to invert the rotations.
- Alternatively, give the filename composed of two plate IDs
- separated by a hyphen (e.g., PAC-MBL) and we will instead extract
- that rotation from the GPlates rotation database. We return an error
- if the rotation cannot be found. Prepend **+** if you want to invert
- the rotations prior to use.
-
-**-F**\ *file*
- Give file with hotspot locations. This file must contain one record
- for each hotspot to be considered; each record must be of the
- following format:
-
- lon lat hs_abbrev hs_id r t_off t_on create fit plot name
-
- E.g., for Hawaii this may look like
-
- 205 20 HWI 1 25 0 90 Y Y Y Hawaii
-
- Most applications only need the first 4 columns which thus
- represents the minimal hotspot information record type. The
- abbreviation may be maximum 3 characters long. The id must be an
- integer from 1-32. The positional uncertainty of the hotspot is
- given by r (in km). The t_off and t_on variables are used to
- indicate the active time-span of the hotspot. The create, fit, and
- plot indicators are either Y or N and are used by some programs to
- indicate if the hotspot is included in the ID-grids used to
- determine rotations, if the hotspot chain will be used to determine
- rotations, and if the hotspot should be included in various plots.
- The name is a 32-character maximum text string with the full hotspot
- name. Blank lines and records whose first column contains # will be
- ignored. Prepend **+** if we should look for hotspot drift tables
- whose name must be *hs_abbrev*\ \_drift.txt. Such files may be
- located in the current directory, the same directory as *hs_file*,
- or in the directories pointed to by GMT_DATADIR. If found then we
- interpolate to get hotspot location as a function of time [fixed].
-
-Optional Arguments
-------------------
-
-.. |Add_intables| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_intables.rst_
-
-**-D**\ *d_km*
- Sets the flowline sampling interval in km. [Default is 5].
-
-**-L**\ [*flag*\ ]
- Output closest approach for nearest hotspot only (ignores **-S**).
- Choose **-Lt** for (*time*, *dist*, *z*) [Default], **-Lw** for
- (*omega*, *dist*, *z*), and **-Ll** for (lon, lat, time, dist, z).
- Normally, *dist* is in km; use upper case modifiers **TWL** to get
- *dist* in spherical degrees.
-
-**-N**\ *upper_age*
- Set the maximum age to extend the oldest stage back in time [no extension].
-
-**-Q**\ *r/t*
- Input files only has (*x*,\ *y*,\ *z*); specify constant values for *r*,\ *t* that
- will be implied for each record.
-
-**-S**\ [*n_hs*\ ]
- Set the number of closest hotspots to report [Default is 1].
-
-**-T**
- Truncate seamount ages exceeding the upper age set with **-N** [no truncation].
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-**-W**\ *maxdist*
- Only report those seamounts whose flowlines came within *maxdist* to
- any hotspot [Default reports all seamounts].
-**-Z**
- Use the hotspot ID number rather than the name tag in output records.
-
-.. |Add_-bi| replace:: [Default is 5 input columns].
-.. include:: ../../explain_-bi.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-h.rst_../../explain_-V.rst_
-
-.. include:: ../../explain_-icols.rst_
-.. include:: ../../explain_colon.rst_
-.. include:: ../../explain_help.rst_
-
-.. include:: explain_geodetic.rst_
-
-Examples
---------
-
-To find the likely (hotspot) origins of the seamounts represented by the
-(x,y,z,r,tc) points in the file seamounts.d, using the DC85.d Euler
-poles and the pac_hs.d list of possible hotspots, and report the 2 most
-likely hotspot candidates for each seamount, run
-
- ::
-
- gmt originator seamounts.d -S2 -EDC85.d -Fpac_hs.d > origins.d
-
-To determine the predicted age of a seamount, distances to the closest
-hotspot, and echo the observed age given its location, observed age, and
-a rotation model, try
-
- ::
-
- echo "1.55 -8.43 52.3" | gmt originator -FONeill_2005_hotspots.txt \
- -EOMS2005_APM_fixed.txt -Q1/120 -Lt
-
-where 52.3 Ma is observed age. The output is 70 -95.486 52.3. To repeat
-the same exercise with a moving hotspot model, try
-
- ::
-
- echo "1.55 -8.43 52.3" | gmt originator -F+ONeill_2005_hotspots.txt \
- -EOMS2005_APM_smooth.txt -Q1/120 -Lt
-
-Now the output is 80 -213.135 52.3. Negative distances means the closest
-approach was east of the hotspot.
-
-See Also
---------
-
-:doc:`gmt </gmt>`,
-:doc:`grdrotater`,
-:doc:`grdspotter`,
-:doc:`project </project>`,
-:doc:`mapproject </mapproject>`,
-:doc:`backtracker`,
-:doc:`hotspotter`
-
-References
-----------
-
-Wessel, P., 1999, "Hotspotting" tools released, EOS Trans. AGU, 80 (29), p. 319.
-
diff --git a/doc_release/html/_sources/supplements/spotter/rotconverter.txt b/doc_release/html/_sources/supplements/spotter/rotconverter.txt
deleted file mode 100644
index bfb960d..0000000
--- a/doc_release/html/_sources/supplements/spotter/rotconverter.txt
+++ /dev/null
@@ -1,151 +0,0 @@
-.. index:: ! rotconverter
-
-**************
-rotconverter
-**************
-
-.. only:: not man
-
- rotconverter - Manipulate total reconstruction and stage rotations
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**rotconverter** [ **+**\ \|\ **-** ] *rotA* [ **+**\ \|\ **-** *rotB* ]
-[ **+**\ \|\ **-** *rotC* ] ... [ **-A** ] [ **-D** ] [
-**-E**\ [*fact*] ] [ **-F**\ *out* ] [ **-G** ] [ **-N** ] [ **-S** ]
-[ **-T** ] [ **-W** ]
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-h| ]
-
-|No-spaces|
-
-Description
------------
-
-**rotconverter** reads one or more plate motion models (stage or total
-reconstruction rotations) stored in the given files. If more than one
-plate motion model is given we will add or subtract them in the order
-they were listed. The minus sign means we should first transpose the
-rotation and then add it to the previous rotation. If a file cannot be
-opened we will attempt to decode the file name as a single rotation
-whose parameters are separated by slashes.
-
-Required Arguments
-------------------
-
-*rotX*
- Name of a file with a plate motion model. Separate several files
- with desired operator (+ or -). The very first file may also have a
- leading minus operator to imply a transpose. We also recognize
- filenames of the form A-B, where both A and B are uppercase plate
- abbreviations as used by GPlates, to indicate we should look up the
- rotation between the two plates in the GPlates rotation file (e.g.,
- PAC-MBL). If any of the specified rotation models cannot be opened
- as a file, we will try to decode the file name as
- *lon/lat/tstart*\ [*/tstop*]/\ *angle* for a single rotation given
- on the command line. The *tstop* argument is required for stage
- poles only. For a single total reconstruction rotation without any
- time information, give *lon/lat/angle* only.
-
-Optional Arguments
-------------------
-
-**-A**
- Indicate that times are actually just opening angles [times in Myr].
-
-**-D**
- Report longitudes use the -180/+180 range [Default is 0/360].
-
-**-E**\ [*fact*]
- Scale opening angles by *fact* on output [0.5].
- Typically used to get half-rates needed for flowlines.
- Requires stage pole output (see **-F**).
-
-**-F**\ *out*
- Specify the output format for rotations. The *out* flag must be
- either **t** or **s** for total reconstruction or stage rotations,
- respectively. [Default is **-Ft** (output contains total
- reconstruction rotations)].
-
-**-G**
- Output final rotations in the Plates4 format used by GPlates [Default is spotter format].
-
-**-N**
- Place all output poles in the northern hemisphere [Default reports positive rotation angles].
-
-**-S**
- Place all output poles in the southern hemisphere [Default reports positive rotation angles].
-
-**-T**
- Transpose the final result, i.e., change the sign of the rotation angles.
-
-**-W**
- Ensure all output rotations have negative opening angles [Default reports positive rotation angles].
-
-
-.. |Add_-V| replace:: Report statistics of extracted rotations.
-.. include:: ../../explain_-V.rst_
-
-.. include:: ../../explain_help.rst_
-
-Limitations
------------
-
-Note that only one of **-N**, **-S**, and **-W** can be used at the same time.
-
-Examples
---------
-
-To convert the total reconstruction rotations in the file
-model_total_reconstruction.APM to stage poles, run
-
- ::
-
- gmt rotconverter model_total_reconstruction.APM -Fs > model_stages.APM
-
-To obtain Nazca motion relative to Pacific hotspots by adding the motion
-of Nazca relative to a fixed Pacific to the Pacific-Hotspot reference
-model DC85_stages.d, and report the result as total reconstruction
-reconstruction poles in the northern hemisphere, try
-
- ::
-
- gmt rotconverter DC85_stages.APM + Pac_Naz_stages.RPM -N -Ft > \
- Naz_HS_total reconstruction.APM
-
-To add the final rotations ROT(150.1, 70.5, -20.3) and ROT (145.0, 40.0, 11.4), try
-
- ::
-
- gmt rotconverter 150.1/70.5/-20.3 + 145/40/11.4
-
-which prints out 157.32, -80.44, 11.97.
-
-To make stage rotations suitable for generating flowlines (fracture
-zones) from a model of relative plate motions PL1-PL2.RPM, assuming
-symmetric spreading, try
-
- ::
-
- gmt rotconverter PL1-PL2.RPM -E -Fs > PL1-PL2_half.RPM
- gmt rotconverter - PL1-PL2.RPM -E -Fs > PL2-PL1_half.RPM
-
-To compute rotations for India relative to a fixed Africa using the
-plate circuit India-Central Indian Basin-Antarctica-Africa, based on the
-GPlates rotations database, try
-
- ::
-
- gmt rotconverter IND-CIB CIB-ANT ANT-AFR > India_AFrica.RPM
-
-See Also
---------
-
-:doc:`backtracker`,
-:doc:`grdrotater`,
-:doc:`grdspotter`,
-:doc:`hotspotter`,
-:doc:`originator`
diff --git a/doc_release/html/_sources/supplements/x2sys/x2sys_binlist.txt b/doc_release/html/_sources/supplements/x2sys/x2sys_binlist.txt
deleted file mode 100644
index d04eee8..0000000
--- a/doc_release/html/_sources/supplements/x2sys/x2sys_binlist.txt
+++ /dev/null
@@ -1,94 +0,0 @@
-.. index:: ! x2sys_binlist
-
-***************
-x2sys_binlist
-***************
-
-.. only:: not man
-
- x2sys_binlist - Create bin index listing from track data files
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**x2sys_binlist** *track(s)* **-T**\ *TAG* [ **-D** ] [ **-E** ]
-[ |SYN_OPT-V| ]
-
-|No-spaces|
-
-Description
------------
-
-**x2sys_binlist** reads one or more track data files and produces a
-multisegment ASCII track bin-index file (tbf) with the track name in the
-header and one data record per bin crossed; these records contain *lon*,
-*lat*, *index*, *flags*\ [, *dist*], where *lon*, *lat* are the
-coordinates of the center of the bin, the *index* is the 1-D number of
-the bin, and *flags* is a bitflag that describes which data fields were
-available in this bin. The optional *dist* requires **-D**. The input
-files can be of any format, which must be described and passed with the
-**-T** option. The bin-index listing is a crude representation of where
-the track goes and is used by the data archivist to build an x2sys track
-data base for miscellaneous track queries, such as when needing to
-determine which tracks should be compared in a crossover analysis. You
-must run **x2sys_init** to initialize the tag before you can run the
-indexing.
-
-Required Arguments
-------------------
-
-.. include:: explain_track.rst_
-.. include:: explain_tag.rst_
-
-Optional Arguments
-------------------
-
-**-D**
- Calculate the length of trackline segments per bin [Default skips
- this step]. The length fragments are given as the 5th output column
- (after the *flags*). The length units are obtained via the TAB
- setting (see **x2sys_init**).
-**-E**
- Convert geographic data to a cylindrical equal-area projection prior
- to binning. Basically, we apply the projection
- **-JY**\ *lon0*/37:04:17.166076/360, where *lon0* is the
- mid-longitude of the region. Requires **-D**, geographical data, and
- a global region (e.g., **-Rg** or **-Rd**). This option is useful
- for statistics related to trackline density but should not be used
- when preparing bin-index files for the x2sys track data bases.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-.. include:: ../../explain_help.rst_
-
-Examples
---------
-
-To create a bin index file from the MGD77 file 01030061.mgd77 using the
-settings associated with the tag MGD77, do
-
- ::
-
- gmt x2sys_binlist 01030061.mgd77 -TMGD77 > 01030061.tbf
-
-To create a track bin index file of all MGD77+ files residing in the
-current directory using the settings associated with the tag MGD77+ and
-calculate track distances, run
-
- ::
-
- gmt x2sys_binlist *.nc -TMGD77+ -D > all.tbf
-
-See Also
---------
-
-:doc:`x2sys_cross`,
-:doc:`x2sys_datalist`,
-:doc:`x2sys_get`,
-:doc:`x2sys_init`,
-:doc:`x2sys_put`,
-:doc:`x2sys_report`,
-:doc:`x2sys_solve`
diff --git a/doc_release/html/_sources/supplements/x2sys/x2sys_cross.txt b/doc_release/html/_sources/supplements/x2sys/x2sys_cross.txt
deleted file mode 100644
index d5cab13..0000000
--- a/doc_release/html/_sources/supplements/x2sys/x2sys_cross.txt
+++ /dev/null
@@ -1,183 +0,0 @@
-.. index:: ! x2sys_cross
-
-***********
-x2sys_cross
-***********
-
-.. only:: not man
-
- x2sys_cross - Calculate crossovers between track data files
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**x2sys_cross** *track(s)* **-T**\ *TAG* [ **-A**\ *combi.lis* ]
-[ **-C**\ [*runtimes*] ] [ **-Il**\ \|\ **a**\ \|\ **c** ]
-[ **-J**\ *parameters* ] [ **-Qe**\ \|\ **i** ]
-[ **-Sl**\ \|\ **u**\ \|\ **h**\ *speed* ]
-[ |SYN_OPT-V| ]
-[ **-W**\ *size* ] [ **-Z** ]
-[ |SYN_OPT-bo| ]
-
-|No-spaces|
-
-Description
------------
-
-**x2sys_cross** is used to determine all intersections between
-("external cross-overs") or within ("internal cross-overs") tracks
-(Cartesian or geographic), and report the time, position, distance along
-track, heading and speed along each track segment, and the crossover
-error (COE) and mean values for all observables. The names of the tracks
-are passed on the command line. By default, **x2sys_cross** will look
-for both external and internal COEs. As an option, you may choose to
-project all data using one of the map-projections prior to calculating
-the COE.
-
-Required Arguments
-------------------
-
-.. include:: explain_track.rst_
-.. include:: explain_tag.rst_
-
-Optional Arguments
-------------------
-
-**-A**\ *combi.lis*
- Only process the pair-combinations found in the file *combi.lis*
- [Default process all possible combinations among the specified
- files]. The file *combi.lis* created by x2sys_get -L option
-**-C**\ [*runtimes*\ ]
- Compute and append the processing run-time for each pair to the
- progress message. Append a filename to save these run-times to file.
- The idea here is to use the knowledge of run-times to split the main
- process in a number of sub-processes that can each be launched in a
- different processor of your multi-core machine. See the MATLAB
- function *split_file4coes.m* that lives in the x2sys supplement
- source code.
-**-Il**\ \|\ **a**\ \|\ **c**
- Sets the interpolation mode for estimating values at the crossover.
- Choose among:
-
- **l** Linear interpolation [Default].
-
- **a** Akima spline interpolation.
-
- **c** Cubic spline interpolation.
-
-.. include:: ../../explain_-J.rst_
-
-**-Qe**\ \|\ **i**
- Append **e** for external COEs only, and **i** for internal COEs
- only [Default is all COEs].
-
-.. |Add_-Rgeo| replace:: For Cartesian
- data just give *xmin/xmax/ymin/ymax*. This option limits the COEs to
- those that fall inside the specified domain.
-.. include:: ../../explain_-Rgeo.rst_
-
-**-Sl**\ \|\ **u**\ \|\ **h**\ *speed*
- Defines window of track speeds. If speeds are outside this window we
- do not calculate a COE. Specify
-
- **-Sl** sets lower speed [Default is 0].
-
- **-Su** sets upper speed [Default is Infinity].
-
- **-Sh** does not limit the speed but sets a lower speed below which headings
- will not be computed (i.e., set to NaN) [Default calculates
- headings regardless of speed].
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-**-W**\ *size*
- Give the maximum number of data points on either side of the
- crossover to use in the spline interpolation [3].
-**-Z**
- Report the values of each track at the crossover [Default reports
- the crossover value and the mean value].
-
-.. |Add_-bo| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-bo.rst_
-
-.. include:: ../../explain_help.rst_
-
-Remarks
--------
-
-The COEs found are printed out to standard output in ASCII format
-(unless **-bo** is set). When ASCII is chosen,
-the output format depends on whether or not old-style XOVER output
-(**-L**) has been selected [See the :manpage:`x_over(1)` man page for more
-details]. If ASCII, then the first record contains the name of the tag
-used, the second records specifies the exact command line used for this
-run, and the third record contains the names of each column. For each
-track pair, there will be a segment header record containing the two
-file names and their start/stop/dist information (start/stop is absolute
-time or NaN if unavailable while dist is the total track length),
-whereas subsequent records have the data for each COE encountered. The
-fields written out are x, y, time along track #1 and #2, distance along
-track #1 and #2, heading along track #1 and #2, velocity along track #1
-and #2, and then pairs of columns for each selected observable. These
-are either pairs of (COE, average value) for each data type (or
-track-values #1 and #2; see **-Z**). It is recommended that the Akima
-spline is used instead of the natural cubic spline, since it is less
-sensitive to outliers that tend to introduce wild oscillations in the
-interpolation.
-
-Sign Convention
----------------
-
-If track_a and track_b are passed on the command line, then the COE
-value is Value (track_a) - Value (track_b).
-
-Precision And Format
---------------------
-
-The output format of individual columns are controlled by
-:ref:`FORMAT_FLOAT_OUT <FORMAT_FLOAT_OUT>` except for geographic coordinates
-(:ref:`FORMAT_GEO_OUT <FORMAT_GEO_OUT>`) and absolute calendar time
-(:ref:`FORMAT_DATE_OUT <FORMAT_DATE_OUT>`, :ref:`FORMAT_CLOCK_OUT <FORMAT_CLOCK_OUT>`).
-Make sure these are setto give you enough significant digits to achieve the desired precision.
-
-Examples
---------
-
-To compute all internal crossovers in the gmt-formatted file c2104.gmt,
-and using the tag GMT, try
-
- ::
-
- gmt x2sys_cross c2104.gmt -TGMT > c2104.d
-
-To find the crossover locations with bathymetry between the two MGD77
-files A13232.mgd77 and A99938.mgd77, using the MGD77 tag, try
-
- ::
-
- gmt x2sys_cross A13232.mgd77 A99938.mgd77 -Qe -TMGD77 > crossovers.d
-
-References
-----------
-
-Wessel, P. (2010), Tools for analyzing intersecting tracks: the x2sys
-package. *Computers and Geosciences*, **36**, 348-354.
-
-Wessel, P. (1989), XOVER: A cross-over error detector for track data,
-*Computers and Geosciences*, **15**\ (3), 333-346.
-
-See Also
---------
-
-:doc:`gmt </gmt>`, :doc:`x2sys_binlist`,
-:doc:`x2sys_init`,
-:doc:`x2sys_datalist`,
-:doc:`x2sys_get`,
-:doc:`x2sys_list`,
-:doc:`x2sys_put`,
-:doc:`x2sys_report`,
-:doc:`x2sys_solve`,
-:manpage:`x_over(1)`
diff --git a/doc_release/html/_sources/supplements/x2sys/x2sys_datalist.txt b/doc_release/html/_sources/supplements/x2sys/x2sys_datalist.txt
deleted file mode 100644
index b104e53..0000000
--- a/doc_release/html/_sources/supplements/x2sys/x2sys_datalist.txt
+++ /dev/null
@@ -1,169 +0,0 @@
-.. index:: ! x2sys_datalist
-
-****************
-x2sys_datalist
-****************
-
-.. only:: not man
-
- x2sys_datalist - Extract content of track data files
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**x2sys_datalist** *track(s)* **-T**\ *TAG* [ **-A** ] [ **-E** ]
-[ **-F**\ *name1*,\ *name2*,...) ] [ **-I**\ [*list*] ]
-[ **-L**\ [*corrtable*] ]
-[ |SYN_OPT-R| ]
-[ **-S** ] [
-[ |SYN_OPT-V| ]
-[ |SYN_OPT-bo| ]
-[ |SYN_OPT-h| ]
-
-|No-spaces|
-
-Description
------------
-
-**x2sys_datalist** reads one or more files and produces a single ASCII
-[or binary] table. The files can be of any format, which must be
-described and passed with the **-T** option. You may limit the output to
-a geographic region, and insist that the output from several files be
-separated by a multiple segment header. Only the named data fields will
-be output [Default selects all columns].
-
-Required Arguments
-------------------
-
-.. include:: explain_track.rst_
-.. include:: explain_tag.rst_
-
-Optional Arguments
-------------------
-
-**-A**
- Eliminate COEs by distributing the COE between the two tracks in
- proportion to track weight. These (dist, adjustment) spline knots
- files for each track and data column are called *track.column*.adj
- and are expected to be in the **$X2SYS_HOME**/*TAG* directory. The
- adjustments are only applied if the corresponding adjust file can be
- found [No residual adjustments]
-**-E**
- Enhance ASCII output by writing GMT segment headers between data
- from each track [no segment headers].
-**-F**\ *name1*,\ *name2*,...)
- Give a comma-separated sub-set list of column names defined in the
- definition file. [Default selects all data columns].
-**-I**\ [*list*\ ]
- Name of ASCII file with a list of track names (one per record) that
- should be excluded from consideration [Default includes all tracks].
-**-L**\ [*corrtable*\ ]
- Apply optimal corrections to columns where such corrections are
- available. Append the correction table to use [Default uses the
- correction table *TAG*\ \_corrections.txt which is expected to
- reside in the **$X2SYS_HOME**/*TAG* directory]. For the format of
- this file, see CORRECTIONS below.
-
-.. |Add_-Rgeo| replace:: For Cartesian
- data just give *xmin/xmax/ymin/ymax*. This option limits the COEs to
- those that fall inside the specified domain.
-.. include:: ../../explain_-Rgeo.rst_
-
-**-S**
- Suppress output records where all the data columns are NaN [Default
- will output all records].
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-.. |Add_-bo| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-bo.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-h.rst_
-
-.. include:: ../../explain_help.rst_
-
-Examples
---------
-
-To extract all data from the old-style MGG supplement file c2104.gmt,
-recognized by the tag GMT:
-
- ::
-
- gmt x2sys_datalist c2104.gmt -TGMT > myfile
-
-To make lon,lat, and depth input for **blockmean** and **surface** using
-all the files listed in the file tracks.lis and define by the tag TRK,
-but only the data that are inside the specified area, and make output
-binary, run
-
- ::
-
- gmt x2sys_datalist =tracks.lis -TTRK -Fon,lat,depth -R40/-30/25/35 -bo > alltopo_bin.xyz
-
-Corrections
------------
-
-The correction table is an ASCII file with coefficients and parameters
-needed to carry out corrections. This table is usually produced by
-**x2sys_solve**. Comment records beginning with # are allowed. All
-correction records are of the form
-
-*trackID observation correction*
-
-where *trackID* is the track name, *observation* is one of the
-abbreviations for an observed field contained in files under this TAG,
-and *correction* consists of one or more white-space-separated *term*\ s
-that will be **subtracted** from the observation before output. Each
-*term* must have this exact syntax:
-
-*factor*\ [\*[*function*\ ]([*scale*\ ](\ *abbrev*\ [-*origin*]))[^\ *power*]]
-
-where terms in brackets are optional (the brackets themselves are not
-used but regular parentheses must be used exactly as indicated). No
-spaces are allowed except between *term*\ s. The *factor* is the
-amplitude of the basis function, while the optional *function* can be
-one of sin, cos, or exp. The optional *scale* and *origin* can be used
-to translate the argument (before giving it to the optional function).
-The argument *abbrev* is one of the abbreviations for columns known to
-this TAG. However, it can also be one of the three auxiliary terms
-**dist** (for along-track distances), **azim** for along-track azimuths,
-and **vel** (for along-track speed); these are all sensitive to the
-**-C** and **-N** settings used when defining the TAB; furthermore,
-**vel** requires **time** to be present in the data. If *origin* is
-given as **T** it means that we should replace it with the value of
-*abbrev* for the very first record in the file (this is usually only
-done for *time*). If the first data record entry is NaN we revert
-*origin* to zero. Optionally, raise the entire expression to the given
-*power*, before multiplying by *factor*. The following is an example of
-fictitious corrections to the track ABC, implying the **z** column
-should have a linear trend removed, the field **obs** should be
-corrected by a strange dependency on latitude, **weight** needs to have
-1 added (hence correction is given as -1), and **fuel** should be
-reduced by a linear distance term:
-
-ABC z 7.1 1e-4\*((time-T))
-
-ABC obs 0.5\*exp(-1e-3(lat))^1.5
-
-ABC weight -1
-
-ABC fuel 0.02\*((dist))
-
-See Also
---------
-
-:doc:`blockmean </blockmean>`,
-:doc:`gmt </gmt>`,
-:doc:`surface </surface>`,
-:doc:`x2sys_init`,
-:doc:`x2sys_datalist`,
-:doc:`x2sys_get`,
-:doc:`x2sys_list`,
-:doc:`x2sys_put`,
-:doc:`x2sys_report`,
-:doc:`x2sys_solve`
diff --git a/doc_release/html/_sources/supplements/x2sys/x2sys_get.txt b/doc_release/html/_sources/supplements/x2sys/x2sys_get.txt
deleted file mode 100644
index 8814b1c..0000000
--- a/doc_release/html/_sources/supplements/x2sys/x2sys_get.txt
+++ /dev/null
@@ -1,121 +0,0 @@
-.. index:: ! x2sys_get
-
-*********
-x2sys_get
-*********
-
-.. only:: not man
-
- x2sys_get - Get track listing from the x2sys track index databases
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**x2sys_get** **-T**\ *TAG* [ **-C** ] [ **-F**\ *flags* ] [ **-G** ]
-[ **-L**\ [**+**\ ][*list*] ] [ **-N**\ *flags* ] [
-[ |SYN_OPT-R| ]
-[ |SYN_OPT-V| ]
-
-|No-spaces|
-
-Description
------------
-
-**x2sys_get** will return the names of the track data files in the
-x2sys data base for this TAG that match the given requirements. You may
-choose a specific region and optionally ask only for tracks that meet
-certain data criteria. Finally, you may select an option to list all
-possible pairs that might generate crossovers.
-
-Required Arguments
-------------------
-
-.. include:: explain_tag.rst_
-
-Optional Arguments
-------------------
-
-**-C**
- Instead of reporting the track names, just output the coordinates of
- the center of each bin that has at least one track with the
- specified data.
-**-D**
- Only report the track names [Default adds the availability of data for each field].
-**-F**\ *flags*
- Give a comma-separated list of column names (as described in the
- definition file) that should be present. [Default selects all data columns].
-**-G**
- Report data flags (Y or N) for the entire track rather than just for
- the portion that is inside the region set by **-R** [Default].
-**-L**\ [**+**\ ][*list*\ ]
- Crossover mode. Return a list of track pairs that should be checked
- for possible crossovers. The list is determined from the bin-index
- data base on the assumption that tracks occupying the same bin are
- very likely to intersect. By default we return all possible pairs in
- the data base. Append the name of a file with a list of tracks if
- you want to limit the output to those pairs that involve at least
- one of the track names in your list. The output is suitable for the
- **-A** option in **x2sys_cross**. By default, only external
- crossover pairs are listed. Use **-L+** to include internal pairs in
- the list.
-**-N**\ *flags*
- Give a comma-separated list of column names (as described in the
- definition file) that must be absent.
-
-.. |Add_-Rgeo| replace:: For Cartesian
- data just give *xmin/xmax/ymin/ymax*. This option limits the tracks
- to those that fall at least partly inside the specified domain.
-.. include:: ../../explain_-Rgeo.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-.. include:: ../../explain_help.rst_
-
-Examples
---------
-
-To find all the tracks associated with the tag MGD77, restricted to
-occupy a certain region in the south Pacific, and have at least free air
-anomalies and bathymetry, try
-
- ::
-
- gmt x2sys_get -V -TMGD77 -R180/240/-60/-30 -Ffaa,depth
-
-To find all the tracks associated with the tag MGD77 that have depth but
-not twt, try
-
- ::
-
- gmt x2sys_get -V -TMGD77 -Fdepth -Nwt
-
-To find all the pairs associated with the tag MGD77 that might intersect
-each other, but only those pairs which involves tracks in your list
-new.lis, try
-
- ::
-
- gmt x2sys_get -V -TMGD77 -Lnew.lis > xpairs.lis
-
-Note
-----
-
-The tracks that are returned all have the requested data (**-F**) within
-the specified region (**-R**). Furthermore, the columns of Y and N for
-other data types also reflect the content of the track portion within
-the selected region, unless **-G** is set.
-
-See Also
---------
-
-:doc:`x2sys_binlist`,
-:doc:`x2sys_cross`
-:doc:`x2sys_datalist`,
-:doc:`x2sys_init`,
-:doc:`x2sys_list`,
-:doc:`x2sys_put`,
-:doc:`x2sys_report`,
-:doc:`x2sys_solve`
diff --git a/doc_release/html/_sources/supplements/x2sys/x2sys_init.txt b/doc_release/html/_sources/supplements/x2sys/x2sys_init.txt
deleted file mode 100644
index 4f58a08..0000000
--- a/doc_release/html/_sources/supplements/x2sys/x2sys_init.txt
+++ /dev/null
@@ -1,354 +0,0 @@
-.. index:: ! x2sys_init
-
-**********
-x2sys_init
-**********
-
-.. only:: not man
-
- x2sys_init - Initialize a new x2sys track database
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**x2sys_init** *TAG* **-D**\ *deffile*
-[ **-Cc**\ \|\ **f**\ \|\ **g**\ \|\ **e** ] [ **-E**\ *suffix* ] [ **-F** ]
-[ **-Gd**\ \|\ **g** ] [ **-I**\ *dx*\ [/*dy*] ]
-[ **-Nd**\ \|\ **s**\ *unit* ]
-[ |SYN_OPT-R| ]
-[ |SYN_OPT-V| ]
-[ **-Wt**\ \|\ **d**\ *gap* ]
-
-|No-spaces|
-
-Description
------------
-
-**x2sys_init** is the starting point for anyone wishing to use x2sys;
-it initializes a set of data bases that are particular to one kind of
-track data. These data, their associated data bases, and key parameters
-are given a short-hand notation called an x2sys TAG. The TAG keeps track
-of settings such as file format, whether the data are geographic or not,
-and the binning resolution for track indices. Running **x2sys_init** is
-a prerequisite to running any of the other x2sys programs, such as
-**x2sys_binlist**, which will create a crude representation of where
-each data track go within the domain and which observations are
-available; this information serves as input to **x2sys_put** which
-updates the track data base. Then, **x2sys_get** can be used to find
-which tracks and data are available inside a given region. With that
-list of tracks you can use **x2sys_cross** to calculate track
-crossovers, use **x2sys_report** to report crossover statistics or
-**x2sys_list** to pull out selected crossover information that
-**x2sys_solve** can use to determine track-specific systematic
-corrections. These corrections may be used with **x2sys_datalist** to
-extract corrected data values for use in subsequent work. Because you
-can run **x2sys_init** you *must* set the environmental parameter
-X2SYS_HOME to a directory where you have write permission, which is
-where x2sys can keep track of your settings.
-
-Required Arguments
-------------------
-
-*TAG*
- The unique name of this data type x2sys TAG.
-**-D**\ *deffile*
- Definition file prefix for this data set [See DEFINITION FILES below
- for more information]. Specify full path if the file is not in the
- current directory.
-
-Optional Arguments
-------------------
-
-**-Cc**\ \|\ **f**\ \|\ **g**\ \|\ **e**
- Select procedure for along-track distance calculation when needed by other programs:
-
- **c** Cartesian distances [Default, unless **-G** is set].
-
- **f** Flat Earth distances.
-
- **g** Great circle distances [Default if **-G** is set].
-
- **e** Geodesic distances on current GMT ellipsoid.
-
-**-E**\ *suffix*
- Specifies the file extension (suffix) for these data files. If not
- given we use the definition file prefix as the suffix (see **-D**).
-
-**-F**
- Force creating new files if old ones are present [Default will abort
- if old TAG files are found].
-
-**-Gd**\ \|\ **g**
- Selects geographical coordinates. Append **d** for discontinuity at
- the Dateline (makes longitude go from -180 to + 180) or **g** for
- discontinuity at Greenwich (makes longitude go from 0 to 360
- [Default]). If not given we assume the data are Cartesian.
-
-**-I**\ *dx*\ [/*dy*]
- *x_inc* [and optionally *y_inc*] is the grid spacing. Append **m**
- to indicate minutes or **c** to indicate seconds for geographic
- data. These spacings refer to the binning used in the track
- bin-index data base.
-
-**-Nd**\ \|\ **s**\ *unit*
- Sets the units used for distance and speed when requested by other
- programs. Append **d** for distance or **s** for speed, then give
- the desired *unit* as **c** (Cartesian userdist or
- userdist/usertime), **e** (meters or m/s), **f** (feet or feet/s),
- **k** (km or kms/hr), **m** (miles or miles/hr), **n** (nautical
- miles or knots) or **u** (survey feet or survey feet/s). [Default is
- **-Ndk** **-Nse** (km and m/s) if **-G** is set and **-Ndc** and
- **-Nsc** otherwise (Cartesian units)].
-
-.. |Add_-Rgeo| replace:: For Cartesian
- data just give *xmin/xmax/ymin/ymax*. This option bases the
- statistics on those COE that fall inside the specified domain.
-.. include:: ../../explain_-Rgeo.rst_
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-**-Wt**\ \|\ **d**\ *gap*
- Give **t** or **d** and append the corresponding maximum time gap
- (in user units; this is typically seconds [Infinity]), or distance
- (for units, see **-N**) gap [Infinity]) allowed between the two data
- points immediately on either side of a crossover. If these limits
- are exceeded then a data gap is assumed and no COE will be determined.
-
-.. include:: ../../explain_help.rst_
-
-Definition Files
-----------------
-
-These \*.def files contain information about the data file format and
-have two sections: (1) header information and (2) column
-information. All header information starts with the character # in the
-first column, immediately followed by an upper-case directive. If the
-directive takes an argument it is separated by white-space. You may
-append a trailing # comments. Five directives are recognized:
-
-**ASCII** states that the data files are in ASCII format.
-
-**BINARY** states that the data files are native binary files.
-
-**NETCDF** states that the data files are COARDS-compliant 1-D netCDF files.
-
-**SKIP** takes an integer argument which is either the number of lines
-to skip (when reading ASCII files) or the number of bytes to skip (when
-reading native binary files). Not used with netCDF files.
-
-**GEO** indicates that these files are geographic data sets, with
-periodicities in the *x*-coordinate (longitudes). Alternatively, use **-G**.
-
-**MULTISEG** means each track consists of multiple segments separated by
-a GMT segment header (alternatively, use **-m** when defining the
-system TAG). Not used with netCDF files.
-
-The column information consists of one line per column in the order the
-columns appear in the data file. For each column you must provide seven
-attributes:
-
-*name type NaN NaN-proxy scale offset oformat*
-
-*name* is the name of the column variable. It is expected that you will
-use the special names *lon* (or *x* if Cartesian) and *lat* (or *y*) for
-the two required coordinate columns, and *time* when optional time data
-are present.
-
-*type* is always **a** for ASCII representations of numbers, whereas for
-binary files you may choose among **c** for signed 1-byte character
-(-127,+128), **u** for unsigned byte (0-255), **h** for signed 2-byte
-integers (-32768,+32767), **i** for signed 4-byte integers
-(-2,147,483,648,+2,147,483,647), **f** for 4-byte floating points and
-**d** for 8-byte double precision floating points. For netCDF, simply
-use **d** as netCDF will automatically handle type-conversions during reading.
-
-*NaN* is Y if certain values (e.g, -9999) are to be replaced by NAN, and N otherwise.
-
-*NaN-proxy* is that special value (e.g., -9999).
-
-*scale* is used to multiply the data after reading.
-
-*offset* is used to add to the scaled data.
-
-*oformat* is a C-style format string used to print values from this column.
-
-If you give - as the *oformat* then GMT's formatting machinery
-will be used instead (i.e., :ref:`FORMAT_FLOAT_OUT <FORMAT_FLOAT_OUT>`,
-:ref:`FORMAT_GEO_MAP <FORMAT_GEO_MAP>`, :ref:`FORMAT_DATE_MAP <FORMAT_DATE_MAP>`,
-:ref:`FORMAT_CLOCK_MAP <FORMAT_CLOCK_MAP>`).
-Some file formats already have definition files premade. These include
-mgd77 (for plain ASCII MGD77 data files), mgd77+ (for enhanced MGD77+
-netCDF files), gmt (for old mgg supplement binary files), xy (for plain
-ASCII x, y tables), xyz (same, with one z-column), geo (for plain ASCII
-longitude, latitude files), and geoz (same, with one z-column).
-
-Examples
---------
-
-If you have a large set of track data files you can organize them using
-the x2sys tools. Here we will outline the steps. Let us assume that your
-track data file format consist of 2 header records with text information
-followed by any number of identically formatted data records with 6
-columns (lat, lon, time, obs1, obs2, obs3) and that files are called
-\*.trk. We will call this the "line" format. First, we create the
-line.def file:
-
-====== ==== === ========= ===== ====== ========
-# Define file for the line format
------------------------------------------------------
-# SKIP 2 # Skip 2 header records
------------------ ----------------------------------
-# GEO # Data are geographic
------------------ ----------------------------------
-#name type NaN NaN-proxy scale offset oformat
-====== ==== === ========= ===== ====== ========
-lat a N 0 1 0 %9.5f
-lon a N 0 1 0 %10.5f
-time a N 0 1 0 %7.1f
-obs1 a N 0 1 0 %7.2f
-obs2 a N 0 1 0 %7.2f
-obs3 a N 0 1 0 %7.2f
-====== ==== === ========= ===== ====== ========
-
-Next we create the TAG and the TAG directory with the databases for
-these line track files. Assuming these contain geographic data and that
-we want to keep track of the data distribution at a 1 x 1 degree
-resolution, with distances in km calculated along geodesics and with
-speeds given in knots, we may run
-
- ::
-
- gmt x2sys_init LINE -V -G -Dline -Rg -Ce -Ndk -NsN -I1/1 -Etrk
-
-where we have selected LINE to be our x2sys tag. When x2sys tools try to
-read your line data files they will first look in the current directory
-and second look in the file *TAG*\ \_paths.txt for a list of additional
-directories to examine. Therefore, create such a file (here
-LINE_paths.txt) and stick the full paths to your data directories
-there. All TAG-related files (definition files, tag files, and track
-data bases created) will be expected to be in the directory pointed to
-by **$X2SYS_HOME**/*TAG* (in our case **$X2SYS_HOME**/LINE). Note that
-the argument to **-D** must contain the full path if the \*.def file is
-not in the current directory. **x2sys_init** will copy this file to the
-**$X2SYS_HOME**/*TAG* directory where all other x2sys tools will expect
-to find it.
-
-**Create tbf file(s):**
- Once the (empty) TAG databases have been initialized we go through a
- two-step process to populate them. First we run **x2sys_binlist**
- on all our track files to create one (or more) multisegment track
- bin-index files (tbf). These contain information on which 1 x 1
- degree bins (or any other blocksize; see **-I**) each track has
- visited and which observations (in your case obs1, obs2, obs3) were
- actually observed (not all tracks may have all three kinds of
- observations everywhere). For instance, if your tracks are listed in
- the file tracks.lis we may run this command:
-
- ::
-
- gmt x2sys_binlist -V -TLINE :tracks.lis > tracks.tbf
-
-**Update index data base:**
- Next, the track bin-index files are fed to **x2sys_put** which will
- insert the information into the TAG databases:
-
- ::
-
- gmt x2sys_put -V -TLINE tracks.tbf
-
-**Search for data:**
- You may now use **x2sys_get** to find all the tracks within a
- certain sub-region, and optionally limit the search to those tracks
- that have a particular combination of observables. E.g., to find all
- the tracks which has both obs1 and obs3 inside the specified region, run
-
- ::
-
- gmt x2sys_get -V -TLINE -R20/40/-40/-20 -Fobs1,obs3 > tracks.tbf
-
-**MGD77[+] or GMT:**
- Definition files already exist for MGD77 files (both standard ASCII
- and enhanced netCDF-based MGD77+ files) and the old \*.gmt files
- manipulated by the mgg supplements; for these data sets the **-C**
- and **-N** will default to great circle distance calculation in km
- and speed in m/s. There are also definition files for plain x,y[,z]
- and lon,lat[,z] tracks. To initiate new track databases to be used
- with MGD77 data from NGDC, try
-
- ::
-
- gmt x2sys_init MGD77 -V -Dmgd77 -Emgd77 -Rd -Gd -Nsn -I1/1 -Wt900 -Wd5
-
- where we have chosen a 15 minute (900 sec) or 5 km threshold to
- indicate a data gap and selected knots as the speed; the other steps
- are similar.
-
-**Binary files:**
- Let us pretend that your line files actually are binary files with a
- 128-byte header structure (to be skipped) followed by the data
- records and where *lon*, *lat*, *time* are double precision numbers
- while the three observations are 2-byte integers which must be
- multiplied by 0.1. Finally, the first two observations may be -32768
- which means there is no data available. All that is needed is a
- different line.def file:
-
- ====== ==== === ========= ===== ====== ========
- # Define file for the binary line format
- -----------------------------------------------------
- # BINARY # File is now binary
- ----------------- ----------------------------------
- # SKIP 128 # Skip 128 bytes
- ----------------- ----------------------------------
- # GEO # Data are geographic
- ----------------- ----------------------------------
- #name type NaN NaN-proxy scale offset oformat
- ====== ==== === ========= ===== ====== ========
- lon d N 0 1 0 %10.5f
- lat d N 0 1 0 %9.5f
- time d N 0 1 0 %7.1f
- obs1 h Y -32768 0.1 0 %6.1f
- obs2 h Y -32768 0.1 0 %6.1f
- obs3 h N 0 0.1 0 %6.1f
- ====== ==== === ========= ===== ====== ========
-
- The rest of the steps are identical.
-
-**COARDS 1-D netCDF files:**
- Finally, suppose that your line files actually are netCDF files that
- conform to the COARDS convention, with data columns named *lon*,
- *lat*, *time*, *obs1*, *obs2*, and *obs3*. All that is needed is a
- different line.def file:
-
- ====== ==== === ========= ===== ====== ========
- # Define file for the netCDF COARDS line format
- -----------------------------------------------------
- # NETCDF # File is now netCDF
- ----------------- ----------------------------------
- # GEO # Data are geographic
- ----------------- ----------------------------------
- #name type NaN NaN-proxy scale offset oformat
- ====== ==== === ========= ===== ====== ========
- lon d N 0 1 0 %10.5f
- lat d N 0 1 0 %9.5f
- time d N 0 1 0 %7.1f
- obs1 d N 0 1 0 %6.1f
- obs2 d N 0 1 0 %6.1f
- obs3 d N 0 1 0 %6.1f
- ====== ==== === ========= ===== ====== ========
-
- Note we use no scaling or NAN proxies since those issues are usually
- handled internally in the netCDF format description.
-
-See Also
---------
-
-:doc:`x2sys_binlist`,
-:doc:`x2sys_datalist`,
-:doc:`x2sys_get`,
-:doc:`x2sys_list`,
-:doc:`x2sys_put`,
-:doc:`x2sys_report`,
-:doc:`x2sys_solve`
diff --git a/doc_release/html/_sources/supplements/x2sys/x2sys_list.txt b/doc_release/html/_sources/supplements/x2sys/x2sys_list.txt
deleted file mode 100644
index 8795958..0000000
--- a/doc_release/html/_sources/supplements/x2sys/x2sys_list.txt
+++ /dev/null
@@ -1,157 +0,0 @@
-.. index:: ! x2sys_list
-
-**********
-x2sys_list
-**********
-
-.. only:: not man
-
- x2sys_list - Extract subset from crossover data base
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**x2sys_list** **-C**\ *column* **-T**\ *TAG* [ *coedbase.txt* ]
-[ **-A**\ *asymm_max* ] [ **-E** ] [ **-F**\ *acdhiInNtTvwxyz* ]
-[ **-I**\ [*list*] ] [ **-L**\ [*corrtable*] ] [ **-N**\ *nx_min* ]
-[ **-Qe**\ \|\ **i** ]
-[ |SYN_OPT-R| ]
-[ **-S**\ *track* ]
-[ |SYN_OPT-V| ]
-[ **-W**\ [*list*] ]
-[ |SYN_OPT-bo| ]
-
-|No-spaces|
-
-Description
------------
-
-**x2sys_list** will read the crossover ASCII data base *coedbase.txt*
-(or *stdin*) and extract a subset of the crossovers based on the other
-arguments. The output may be ASCII or binary.
-
-Required Arguments
-------------------
-
-**-C**\ *column*
- Specify which data column you want to process. Crossovers related to
- this column name must be present in the crossover data base.
-
-.. include:: explain_tag.rst_
-
-Optional Arguments
-------------------
-
-*coedbase.txt*
- The name of the input ASCII crossover error data base as produced by
- **x2sys_cross**. If not given we read standard input instead.
-**-A**\ *asymm_max*
- Specifies maximum asymmetry in the distribution of crossovers
- relative to the mid point in time (or distance, if not time is
- available). Asymmetry is computed as (n_right - n_left)/(n_right
- + n_left), referring the the number of crossovers that falls in the
- left or right half of the range. Symmetric distributions will have
- values close to zero. If specified, we exclude tracks whose
- asymmetry exceeds the specify cutoff in absolute value [1, i.e.,
- include all].
-**-E**
- Enhance ASCII output by writing GMT segment headers with name of the
- two tracks and their total number of cross-overs [no segment
- headers].
-**-F**\ *acdhiInNtTvwxyz*
- Specify your desired output using any combination of
- *acdhiInNtTvwxyz*, in any order. Do not use space between the
- letters, and note your selection is case-sensitive. The output will
- be ASCII (or binary, **-bo**) columns of
- values. Description of codes: **a** is the angle (< 90) defined by
- the crossing tracks, **c** is crossover value of chosen observation
- (see **-C**), **d** is distance along track, **h** is heading along
- track, **i** is the signed time interval between the visit at the
- crossover of the two tracks involved, **I** is same as **i** but is
- unsigned, **n** is the names of the two tracks, **N** is the id
- numbers of the two tracks, **t** is time along track in
- *date*\ **T**\ *clock* format (NaN if not available), **T** is
- elapsed time since start of track along track (NaN if not
- available), **v** is speed along track, **w** is the composite
- weight, **x** is *x*-coordinate (or longitude), **y** is
- *y*-coordinate (or latitude), and **z** is observed value (see
- **-C**) along track. If **-S** is not specified then
- **d**,\ **h**,\ **n**,\ **N**,\ **t**,\ **T**,\ **v** results in two
- output columns each: first for track one and next for track two (in
- lexical order of track names); otherwise, they refer to the
- specified track only (except for **n**,\ **N** which then refers to
- the other track). The sign convention for **c**,\ **i** is track one
- minus track two (lexically sorted). Time intervals will be returned
- according to the **TIME_UNIT** GMT defaults setting.
-**-I**\ [*list*\ ]
- Name of ASCII file with a list of track names (one per record) that
- should be excluded from consideration [Default includes all tracks].
-**-L**\ [*corrtable*\ ]
- Apply optimal corrections to the chosen observable. Append the
- correction table to use [Default uses the correction table
- *TAG*\ \_corrections.txt which is expected to reside in the
- **$X2SYS_HOME**/*TAG* directory]. For the format of this file, see
- **x2sys_solve**.
-**-N**\ *nx_min*
- Only report data from pairs that generated at least *nx_min*
- crossovers between them [use all pairs].
-**-Qe**\ \|\ **i**
- Append **e** for external crossovers or **i** for internal
- crossovers only [Default is all crossovers].
-
-.. |Add_-Rgeo| replace:: For Cartesian
- data just give *xmin/xmax/ymin/ymax*. This option bases the
- statistics on those COE that fall inside the specified domain.
-.. include:: ../../explain_-Rgeo.rst_
-
-**-S**\ *track*
- Name of a single track. If given we restrict output to those
- crossovers involving this track [Default output is crossovers
- involving any track pair].
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-**-W**\ [*list*\ ]
- Name of ASCII file with a list of track names and their relative
- weights (one track per record) that should be used to calculate the
- composite crossover weight (output code **w** above). [Default sets
- weights to 1].
-
-.. |Add_-bo| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-bo.rst_
-
-.. include:: ../../explain_help.rst_
-
-Examples
---------
-
-To find all the magnetic crossovers associated with the tag MGD77 from
-the file COE_data.txt, restricted to occupy a certain region in the
-south Pacific, and return location, time, and crossover value, try
-
- ::
-
- gmt x2sys_list COE_data.txt -V -TMGD77 -R180/240/-60/-30 -Cmag -Fxytz > mag_coe.txt
-
-To find all the faa crossovers globally that involves track 12345678 and
-output time since start of the year, using a binary double precision
-format, try
-
- ::
-
- gmt x2sys_list COE_data.txt -V -TMGD77 -Cfaa -S12345678 -FTz -bod > faa_coe.b
-
-See Also
---------
-
-:doc:`x2sys_binlist`,
-:doc:`x2sys_cross`,
-:doc:`x2sys_datalist`,
-:doc:`x2sys_get`,
-:doc:`x2sys_init`,
-:doc:`x2sys_put`,
-:doc:`x2sys_report`,
-:doc:`x2sys_solve`
diff --git a/doc_release/html/_sources/supplements/x2sys/x2sys_merge.txt b/doc_release/html/_sources/supplements/x2sys/x2sys_merge.txt
deleted file mode 100644
index c85c4b4..0000000
--- a/doc_release/html/_sources/supplements/x2sys/x2sys_merge.txt
+++ /dev/null
@@ -1,65 +0,0 @@
-.. index:: ! x2sys_merge
-
-***********
-x2sys_merge
-***********
-
-.. only:: not man
-
- x2sys_merge - Merge an updated COEs table (smaller) into the main table (bigger)
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**x2sys_merge** **-A**\ *main_COElist.d* **-M**\ *new_COElist.d*
-
-|No-spaces|
-
-Description
------------
-
-**x2sys_merge** will read two crossovers data base and output the
-contents of the main one updated with the COEs in the second one. The
-second file should only contain updated COEs relatively to the first
-one. That is, it MUST NOT contain any new two tracks intersections (This
-point is NOT checked in the code). This program is useful when, for any
-good reason like file editing NAV correction or whatever, one had to
-recompute only the COEs between the edited files and the rest of the
-database.
-
-Required Arguments
-------------------
-
-**-A**\ *main_COElist.d*
- Specify the file *main_COElist.d* with the main crossover error
- data base.
-**-M**\ *new_COElist.d*
- Specify the file *new_COElist.d* with the newly computed crossover
- error data base.
-
-Optional Arguments
-------------------
-
-Examples
---------
-
-To update the main COE_data.txt with the new COEs estimations saved in
-the smaller COE_fresh.txt, try
-
- ::
-
- gmt x2sys_merge -ACOE_data.txt -MCOE_fresh.txt > COE_updated.txt
-
-See Also
---------
-
-:doc:`x2sys_binlist`,
-:doc:`x2sys_cross`,
-:doc:`x2sys_datalist`,
-:doc:`x2sys_get`,
-:doc:`x2sys_init`,
-:doc:`x2sys_list`,
-:doc:`x2sys_put`,
-:doc:`x2sys_report`
diff --git a/doc_release/html/_sources/supplements/x2sys/x2sys_put.txt b/doc_release/html/_sources/supplements/x2sys/x2sys_put.txt
deleted file mode 100644
index 6b0a15c..0000000
--- a/doc_release/html/_sources/supplements/x2sys/x2sys_put.txt
+++ /dev/null
@@ -1,84 +0,0 @@
-.. index:: ! x2sys_put
-
-*********
-x2sys_put
-*********
-
-.. only:: not man
-
- x2sys_put - Update track index database from track bin file
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**x2sys_put** [ *info.tbf* ] **-T**\ *TAG* [ **-D** ] [ **-F** ]
-[ |SYN_OPT-V| ]
-
-|No-spaces|
-
-Description
------------
-
-**x2sys_put** accepts a track bin-index file created by
-**x2sys_binlist** and adds this information about the data tracks to
-the relevant data base. You may chose to overwrite existing data with
-new information for older tracks (**-F**) and even completely remove
-information for certain tracks (**-D**). The x2sys *TAG* must match the
-tag encoded in the *info.tbf* file. To inquire about tracks in the data
-base, use **x2sys_get**.
-
-Required Arguments
-------------------
-
-*info.tbf*
- Name of a single track bin file. If not given, *stdin* will be read.
-
-.. include:: explain_tag.rst_
-
-Optional Arguments
-------------------
-
-**-D**
- Delete all tracks found in the track bin file [Default will try to
- add them as new track entries].
-**-F**
- Replace any existing database information for these tracks with the
- new information in the track bin file [Default refuses to process
- tracks already in the database].
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-.. include:: ../../explain_help.rst_
-
-Examples
---------
-
-To add the information stored in the track bin-index file latest.tbf to
-the track data bases associated with the tag MGD77, and replace any
-exiting information for these tracks, try
-
- ::
-
- gmt x2sys_put latest.tbf -F -V -TMGD77
-
-X2sys Databases
----------------
-
-The **x2sys_put** utility adds new information to the x2sys data bases.
-These consists of two files: The first file contains a listing of all
-the tracks that have been added to the system; it is named
-*TAG*\ \_tracks.d and is in ASCII format. The second file is named
-*TAG*\ \_index.b and is in native binary format. It contains information
-on which tracks cross each of the bins, and what data sets were observed
-while crossing the bin. The bins are defined by the **-R** and **-I**
-options passed to **x2sys_init** when the *TAG* was first initiated.
-Both data base files are stored in the **$X2SYS_HOME**/*TAG* directory.
-Do not attempt to edit these files by hand.
-
-See Also
---------
-
-:doc:`x2sys_binlist`, :doc:`x2sys_get`
diff --git a/doc_release/html/_sources/supplements/x2sys/x2sys_report.txt b/doc_release/html/_sources/supplements/x2sys/x2sys_report.txt
deleted file mode 100644
index 4da88e3..0000000
--- a/doc_release/html/_sources/supplements/x2sys/x2sys_report.txt
+++ /dev/null
@@ -1,121 +0,0 @@
-.. index:: ! x2sys_report
-
-**************
-x2sys_report
-**************
-
-.. only:: not man
-
- x2sys_report - Report statistics from crossover data base
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**x2sys_report** **-C**\ *column* **-T**\ *TAG* [ *coedbase.txt* ]
-[ **-A** ] [ **-I**\ [*list*\ ] ] [ **-L**\ [*corrtable*] ]
-[ **-N**\ *nx_min* ] [ **-Qe**\ \|\ **i** ]
-[ [ |SYN_OPT-R| ]
-[ **-S**\ *track* ]
-[ |SYN_OPT-V| ]
-
-|No-spaces|
-
-Description
------------
-
-**x2sys_report** will read the input crossover ASCII data base
-*coedbase.txt* (or *stdin*) and report on the statistics of crossovers
-(*n*, *mean*, *stdev*, *rms*, *weight*) for each track. Options are
-available to let you exclude tracks and limit the output.
-
-Required Arguments
-------------------
-
-*coedbase.txt*
- The name of the input ASCII crossover error data base as produced by
- **x2sys_cross**. If not given we read standard input instead.
-**-C**\ *column*
- Specify which data column you want to process. Crossovers related to
- this column name must be present in the crossover data base.
-
-.. include:: explain_tag.rst_
-
-Optional Arguments
-------------------
-
-**-A**
- Eliminate COEs by distributing the COE between the two tracks in
- proportion to track weight and producing (dist, adjustment) spline
- knots files for each track (for the selected *column*). Such
- adjustments may be used by **x2sys_datalist**. The adjustment files
- are called *track.column*.adj and are placed in the
- **$X2SYS_HOME**/*TAG* directory. For background information on how
- these adjustments are designed, see *Mittal* [1984].
-**-I**\ [*list*\ ]
- Name of ASCII file with a list of track names (one per record) that
- should be excluded from consideration [Default includes all tracks].
-**-L**\ [*corrtable*\ ]
- Apply optimal corrections to the chosen observable. Append the
- correction table to use [Default uses the correction table
- *TAG*\ \_corrections.txt which is expected to reside in the
- **$X2SYS_HOME**/*TAG* directory]. For the format of this file, see
- **x2sys_solve**.
-**-N**\ *nx_min*
- Only report data from tracks involved in at least *nx_min*
- crossovers [all tracks].
-**-Qe**\ \|\ **i**
- Append **e** for external crossovers or **i** for internal
- crossovers only [Default is external].
-
-.. |Add_-Rgeo| replace:: For Cartesian
- data just give *xmin/xmax/ymin/ymax*. This option bases the
- statistics on those COE that fall inside the specified domain.
-.. include:: ../../explain_-Rgeo.rst_
-
-**-S**\ *track*
- Name of a single track. If given we restrict output to those
- crossovers involving this track [Default output is crossovers
- involving any track pair].
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-.. include:: ../../explain_help.rst_
-
-Examples
---------
-
-To report statistics of all the external magnetic crossovers associated
-with the tag MGD77 from the file COE_data.txt, restricted to occupy a
-certain region in the south Pacific, try
-
- ::
-
- gmt x2sys_report COE_data.txt -V -TMGD77 -R180/240/-60/-30 -Cmag >
- mag_report.txt
-
-To report on the faa crossovers globally that involves track 12345678, try
-
- ::
-
- gmt x2sys_report COE_data.txt -V -TMGD77 -Cfaa -S2345678 > faa_report.txt
-
-References
-----------
-
-Mittal, P. K. (1984), Algorithm for error adjustment of potential field
-data along a survey network, *Geophysics*, **49**\ (4), 467-469.
-
-See Also
---------
-
-:doc:`x2sys_binlist`
-:doc:`x2sys_cross`
-:doc:`x2sys_datalist`
-:doc:`x2sys_get`
-:doc:`x2sys_init`
-:doc:`x2sys_list`
-:doc:`x2sys_put`
-:doc:`x2sys_solve`
diff --git a/doc_release/html/_sources/supplements/x2sys/x2sys_solve.txt b/doc_release/html/_sources/supplements/x2sys/x2sys_solve.txt
deleted file mode 100644
index 07eda0e..0000000
--- a/doc_release/html/_sources/supplements/x2sys/x2sys_solve.txt
+++ /dev/null
@@ -1,153 +0,0 @@
-.. index:: ! x2sys_solve
-
-***********
-x2sys_solve
-***********
-
-.. only:: not man
-
- x2sys_solve - Determine least-squares systematic correction from crossovers
-
-Synopsis
---------
-
-.. include:: ../../common_SYN_OPTs.rst_
-
-**x2sys_solve** **-C**\ *column* **-T**\ *TAG* **-E**\ *mode*
-[ *COE_list.d* ]
-[ |SYN_OPT-V| ]
-[ **-W[u]** ]
-[ |SYN_OPT-bi| ]
-
-|No-spaces|
-
-Description
------------
-
-**x2sys_solve** will use the supplied crossover information to solve
-for systematic corrections that can then be applied per track to improve
-data quality. Several systematic corrections can be solved for using a
-least-squares approach. Note: Only one data column can be processed at
-the time.
-
-Required Arguments
-------------------
-
-*COE_list.d*
- Name of file with the required crossover columns as produced by
- **x2sys_list**. NOTE: If **-bi** is used
- then the first two columns are expected to hold the integer track
- IDs; otherwise we expect those columns to hold the text string names
- of the two tracks. If no file is given we will read from *stdin*.
-
-.. include:: explain_tag.rst_
-
-**-C**\ *column*
- Specify which data column you want to process. Needed for proper
- formatting of the output correction table and must match the same
- option used in **x2sys_list** when preparing the input data.
-**-E**\ *mode*
- The correction type you wish to model. Choose among the following
- functions f(*p*) , where *p* are the *m*
- parameters per track that we will fit simultaneously using a least
- squares approach:
-
- **c** will fit f(*p*) = *a* (a constant offset);
- records must contain cruise ID1, ID2, COE.
-
- **d** will fit f(*p*) = *a* + *b* \* *d* (linear
- drift; *d* is distance; records must contain cruise ID1, ID2, d1,
- d2, COE.
-
- **g** will fit f(*p*) = *a* + *b* sin(y)^2
- (1980-1930 gravity correction); records must contain cruise ID1,
- ID2, latitude y, COE.
-
- **h** will fit f(*p*) = *a* + *b* cos(H) + *c*
- cos(2H) + *d* sin(H) + *e* sin(2H)
- (magnetic heading correction); records must contain cruise ID1, ID2,
- heading H, COE.
-
- **s** will fit f(*p*) = *a* \* z (a unit scale
- correction); records must contain cruise ID1, ID2, z1, z2.
-
- **t** will fit f(*p*) = *a* + *b* \* (*t - t0*)
- (linear drift; *t0* is the start time of the track); records must
- contain cruise ID1, ID2, t1-t0, t2-t0, COE.
-
-Optional Arguments
-------------------
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-V.rst_
-
-**-W**
- Means that each input records has an extra column with the composite
- weight for each crossover record. These are used to obtain a
- weighted least squares solution [no weights]. Append **u** to report
- unweighted mean/std [Default, report weighted stats].
-
-.. |Add_-bi| unicode:: 0x20 .. just an invisible code
-.. include:: ../../explain_-bi.rst_
-
-.. include:: ../../explain_help.rst_
-
-Notes
------
-
-Most of the model corrections in **-E** involve a constant offset.
-Because crossovers are differences between values, any absolute level
-will cancel out and hence the constant offsets we obtain are relative
-to an undetermined absolute level. To obtain a solvable solution we
-add the constraint that the sum of all constant offsets equal zero.
-If the tracks form clusters in which no tracks from one cluster cross
-any track from another cluster then these are two independent data
-sets and require they own constraint equation for their offsets. We
-determine the number of clusters and automatically add the required
-constraint equations. If you need a particular reference track to have
-a particular offset (e.g., 0) then you can subtract the offset you
-found from every track correction and add in the desired offset.
-
-Examples
---------
-
-To fit a simple bias offset to faa for all tracks under the MGD77 tag, try
-
- ::
-
- gmt x2sys_list COE_data.txt -V -TMGD77 -Cfaa -Fnc > faa_coe.txt
- gmt x2sys_solve faa_coe.txt -V -TMGD77 -Cfaa -Ec > coe_table.txt
-
-To fit a faa linear drift with time instead, try
-
- ::
-
- gmt x2sys_list COE_data.txt -V -TMGD77 -Cfaa -FnTc > faa_coe.txt
- gmt x2sys_solve faa_coe.txt -V -TMGD77 -Cfaa -Et > coe_table.txt
-
-To estimate heading corrections based on magnetic crossovers associated
-with the tag MGD77 from the file COE_data.txt, try
-
- ::
-
- gmt x2sys_list COE_data.txt -V -TMGD77 -Cmag -Fnhc > mag_coe.txt
- gmt x2sys_solve mag_coe.txt -V -TMGD77 -Cmag -Eh > coe_table.txt
-
-To estimate unit scale corrections based on bathymetry crossovers, try
-
- ::
-
- gmt x2sys_list COE_data.txt -V -TMGD77 -Cdepth -Fnz > depth_coe.txt
- gmt x2sys_solve depth_coe.txt -V -TMGD77 -Cdepth -Es > coe_table.txt
-
-See Also
---------
-
-:doc:`x2sys_binlist`,
-:doc:`x2sys_cross`,
-:doc:`x2sys_datalist`,
-:doc:`x2sys_get`,
-:doc:`x2sys_init`,
-:doc:`x2sys_list`,
-:doc:`x2sys_put`,
-:doc:`x2sys_report`
diff --git a/doc_release/html/_sources/surface.txt b/doc_release/html/_sources/surface.txt
deleted file mode 100644
index 3eb21aa..0000000
--- a/doc_release/html/_sources/surface.txt
+++ /dev/null
@@ -1,205 +0,0 @@
-.. index:: ! surface
-
-*******
-surface
-*******
-
-.. only:: not man
-
- surface - Grid table data using adjustable tension continuous curvature splines
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**surface** [ *table* ] **-G**\ *outputfile.nc*
-|SYN_OPT-I|
-|SYN_OPT-R|
-[ **-A**\ *aspect_ratio* ] [ **-C**\ *convergence_limit* ]
-[ **-Ll**\ *lower* ] [ **-Lu**\ *upper* ] [ **-N**\ *max_iterations* ]
-[ **-Q** ] [ **-S**\ *search_radius*\ [**m**\ \|\ **s**] ]
-[ **-T**\ [**i**\ \|\ **b**] ]\ *tension_factor* [ **-V**\ [*level*] ]
-[ **-Z**\ *over-relaxation_factor* ]
-[ |SYN_OPT-a| ]
-[ |SYN_OPT-bi| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**surface** reads randomly-spaced (x,y,z) triples from standard input
-[or *table*] and produces a binary grid file of gridded values z(x,y) by
-solving:
-
- (1 - T) \* L (L (z)) + T \* L (z) = 0
-
-where T is a tension factor between 0 and 1, and L indicates the
-Laplacian operator. T = 0 gives the "minimum curvature" solution which
-is equivalent to SuperMISP and the ISM packages. Minimum curvature can
-cause undesired oscillations and false local maxima or minima (See Smith
-and Wessel, 1990), and you may wish to use T > 0 to suppress these
-effects. Experience suggests T ~ 0.25 usually looks good for potential
-field data and T should be larger (T ~ 0.35) for steep topography data.
-T = 1 gives a harmonic surface (no maxima or minima are possible except
-at control data points). It is recommended that the user pre-process the
-data with **blockmean**, **blockmedian**, or **blockmode** to avoid
-spatial aliasing and eliminate redundant data. You may impose lower
-and/or upper bounds on the solution. These may be entered in the form of
-a fixed value, a grid with values, or simply be the minimum/maximum
-input data values. Natural boundary conditions are applied at the edges,
-except for geographic data with 360-degree range where we apply periodic
-boundary conditions in the longitude direction.
-
-`Required Arguments <#toc4>`_
------------------------------
-
-**-G**\ *outputfile.nc*
- Output file name. Output is a binary 2-D *.nc* file. Note that the
- smallest grid dimension must be at least 4.
-
-.. include:: explain_-I.rst_
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-R.rst_
-
-`Optional Arguments <#toc5>`_
------------------------------
-
-.. |Add_intables| unicode:: 0x20 .. just an invisible code
-.. include:: explain_intables.rst_
-
-**-A**\ *aspect\_ratio*
- Aspect ratio. If desired, grid anisotropy can be added to the
- equations. Enter *aspect\_ratio*, where dy = dx / *aspect\_ratio*
- relates the grid dimensions. [Default = 1 assumes isotropic grid.]
-**-C**\ *convergence\_limit*
- Convergence limit. Iteration is assumed to have converged when the
- maximum absolute change in any grid value is less than
- *convergence\_limit*. (Units same as data z units). [Default is
- scaled to 0.1 percent of typical gradient in input data.]
-**-Ll**\ *lower* and **-Lu**\ *upper*
- Impose limits on the output solution. **l**\ *lower* sets the lower
- bound. *lower* can be the name of a grid file with lower bound
- values, a fixed value, **d** to set to minimum input value, or **u**
- for unconstrained [Default]. **u**\ *upper* sets the upper bound and
- can be the name of a grid file with upper bound values, a fixed
- value, **d** to set to maximum input value, or **u** for
- unconstrained [Default]. Grid files used to set the limits may
- contain NaNs. In the presence of NaNs, the limit of a node masked
- with NaN is unconstrained.
-**-N**\ *max\_iterations*
- Number of iterations. Iteration will cease when *convergence\_limit*
- is reached or when number of iterations reaches *max\_iterations*.
- [Default is 250.]
-**-Q**
- Suggest grid dimensions which have a highly composite greatest
- common factor. This allows surface to use several intermediate steps
- in the solution, yielding faster run times and better results. The
- sizes suggested by **-Q** can be achieved by altering **-R** and/or
- **-I**. You can recover the **-R** and **-I** you want later by
- using **grdsample** or **grdcut** on the output of **surface**.
-**-S**\ *search\_radius*\ [**m**\ \|\ **s**]
- Search radius. Enter *search\_radius* in same units as x,y data;
- append **m** to indicate arc minutes or **s** for arc seconds. This
- is used to initialize the grid before the first iteration; it is not
- worth the time unless the grid lattice is prime and cannot have
- regional stages. [Default = 0.0 and no search is made.]
-**-T**\ [**i**\ \|\ **b**] ]\ *tension\_factor*
- Tension factor[s]. These must be between 0 and 1. Tension may be
- used in the interior solution (above equation, where it suppresses
- spurious oscillations) and in the boundary conditions (where it
- tends to flatten the solution approaching the edges). Using zero for
- both values results in a minimum curvature surface with free edges,
- i.e., a natural bicubic spline. Use **-Ti**\ *tension\_factor*
- to set interior tension, and **-Tb**\ *tension\_factor* to set
- boundary tension. If you do not prepend **i** or **b**, both will be
- set to the same value. [Default = 0 for both gives minimum curvature
- solution.]
-
-.. |Add_-V| replace::
- **-V3** will report the convergence after each iteration;
- **-V** will report only after each regional grid is converged.
-.. include:: explain_-V.rst_
-
-**-Z**\ *over-relaxation_factor*
- Over-relaxation factor. This parameter is used to accelerate the
- convergence; it is a number between 1 and 2. A value of 1 iterates
- the equations exactly, and will always assure stable convergence.
- Larger values overestimate the incremental changes during
- convergence, and will reach a solution more rapidly but may become
- unstable. If you use a large value for this factor, it is a good
- idea to monitor each iteration with the **-Vl** option. [Default =
- 1.4 converges quickly and is almost always stable.]
-
-.. include:: explain_-aspatial.rst_
-
-.. |Add_-bi| replace:: [Default is 3 input columns].
-.. include:: explain_-bi.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-h| replace:: Not used with binary data.
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. include:: explain_colon.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_float.rst_
-
-
-Examples
---------
-
-To grid 5 by 5 minute gravity block means from the ASCII data in
-hawaii_5x5.xyg, using a *tension_factor* = 0.25, a
-*convergence_limit* = 0.1 milligal, writing the result to a file called
-hawaii_grd.nc, and monitoring each iteration, try:
-
- ::
-
- gmt surface hawaii_5x5.xyg -R198/208/18/25 -I5m -Ghawaii_grd.nc -T0.25 -C0.1 -Vl
-
-Bugs
-----
-
-**surface** will complain when more than one data point is found for any
-node and suggest that you run **blockmean**, **blockmedian**, or
-:doc:`blockmode` first. If you did run **blockm\*** and still get this
-message it usually means that your grid spacing is so small that you
-need more decimals in the output format used by **blockm\***. You may
-specify more decimal places by editing the parameter
-**FORMAT\_FLOAT\_OUT** in your :doc:`gmt.conf` file prior to running
-**blockm\***, or choose binary input and/or output using single or
-double precision storage.
-
-Note that only gridline registration is possible with **surface**. If
-you need a pixel-registered grid you can resample a gridline registered
-grid using :doc:`grdsample` **-T**.
-
-`See Also <#toc9>`_
--------------------
-
-:doc:`blockmean`,
-:doc:`blockmedian`,
-:doc:`blockmode`,
-:doc:`gmt`,
-:doc:`greenspline`,
-:doc:`nearneighbor`,
-:doc:`triangulate`,
-:doc:`sphtriangulate`
-
-References
-----------
-
-Smith, W. H. F, and P. Wessel, 1990, Gridding with continuous curvature
-splines in tension, *Geophysics*, 55, 293-305.
diff --git a/doc_release/html/_sources/testapi.txt b/doc_release/html/_sources/testapi.txt
deleted file mode 100644
index df3b3c2..0000000
--- a/doc_release/html/_sources/testapi.txt
+++ /dev/null
@@ -1,91 +0,0 @@
-.. index:: ! testapi
-
-*******
-testapi
-*******
-
-.. only:: not man
-
- testapi - Test API i/o methods for any data type
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**testapi**
-**-I**\ **c**\ \|\ **d**\ \|\ **f**\ \|\ **r**\ \|\ **s**\ [/**m**\ \|\ **v**]
-**-T**\ **c**\ \|\ **d**\ \|\ **g**\ \|\ **i**\ \|\ **t**
-**-W**\ **c**\ \|\ **d**\ \|\ **f**\ \|\ **r**\ \|\ **s**\ [/**m**\ \|\ **v**]
-[ **-V**\ [*level*] ]
-
-|No-spaces|
-
-`Description <#toc2>`_
-----------------------
-
-**testapi** will test the API for all i/o combinations. In general, data
-types (DATASET, TEXTSET, CPT, GRID, and IMAGE) can be read from or
-written to 5 different ways (file, stream, file descriptor, copy from
-memory, reference from memory). We use this tool to check the various
-possibilities, for each data type.
-
-Required Arguments
-------------------
-
-**-I**\ **c**\ \|\ **d**\ \|\ **f**\ \|\ **r**\ \|\ **s**\ [/**m**\ \|\ **v**]
- Set input method; choose from **c**\ opy from memory, file
- **d**\ escriptor, **f**\ ile, memory **r**\ eference, or
- **s**\ tream. For methods **c**\ \|\ **r**, optionally append
- /**m**\ \|\ **v**. Then, we obtain the values for the input dataset
- or grid via either a user matrix (**m**) or a set of user vectors
- (**v**). We simulate this internally by filling out a matrix or
- vectors and pass that as the source instead of a data file. **-Td**
- may take either **m**\ \|\ **v** while **-Tg** can only take the
- **m** modifier.
-**-T**\ **c**\ \|\ **d**\ \|\ **g**\ \|\ **i**\ \|\ **t**
- Specify data type; choose from **c**\ pt, **d**\ ataset, **g**\ rid,
- **i**\ mage, or **t**\ extset.
-**-W**\ **c**\ \|\ **d**\ \|\ **f**\ \|\ **r**\ \|\ **s**\ [/**m**\ \|\ **v**]
- Set output method; choose from **c**\ opy to memory, file
- **d**\ escriptor, **f**\ ile, memory **r**\ eference, or
- **s**\ tream. For methods **c**\ \|\ **r**, optionally append
- /**m**\ \|\ **v**. Then, we first write the values of the output
- dataset or grid via either a user matrix (**m**) or a set of user
- vectors (**v**). Finally, the matrix or vectors are written out to
- file. **-Td** may take either **m**\ \|\ **v** while **-Tg** can
- only take the **m** modifier.
-
-Optional Arguments
-------------------
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-Examples
---------
-
-To check if reading and writing the test dataset file yields an identical copy, try
-
- ::
-
- testapi -Td -If -Wf -V
-
-To check if reading the test grid from memory and writing it to file
-yields an identical copy, try
-
- ::
-
- testapi -Tg -Ic -Wf -V
-
-To read the test grid via user matrix memory and writing it via another
-user matrix before saving to a grid file, try
-
- ::
-
- testapi -Tg -Ic/m -Wf/m -V
-
-See Also
---------
-
-:doc:`gmt`
diff --git a/doc_release/html/_sources/trend1d.txt b/doc_release/html/_sources/trend1d.txt
deleted file mode 100644
index aeba48d..0000000
--- a/doc_release/html/_sources/trend1d.txt
+++ /dev/null
@@ -1,180 +0,0 @@
-.. index:: ! trend1d
-
-*******
-trend1d
-*******
-
-.. only:: not man
-
- trend1d - Fit a [weighted] [robust] polynomial [or Fourier] model for y = f(x) to xy[w] data
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**trend1d** [ *table* ] **-F**\ **xymrw\|p**
-**-N**\ [**f**]\ *n\_model*\ [**r**] [ *xy[w]file* ]
-[ **-C**\ *condition\_number* ] [ **-I**\ [*confidence\_level*] ]
-[ |SYN_OPT-V| ] [ **-W** ]
-[ |SYN_OPT-b| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**trend1d** reads x,y [and w] values from the first two [three] columns
-on standard input [or *file*] and fits a regression model y = f(x) + e
-by [weighted] least squares. The functional form of f(x) may be chosen
-as polynomial or Fourier, and the fit may be made robust by iterative
-reweighting of the data. The user may also search for the number of
-terms in f(x) which significantly reduce the variance in y.
-
-Required Arguments
-------------------
-
-**-F**\ **xymrw\|p**
- Specify up to five letters from the set {**x y m r w**\ } in any
- order to create columns of ASCII [or binary] output. **x** = x,
- **y** = y, **m** = model f(x), **r** = residual y - **m**, **w** =
- weight used in fitting. Alternatively choose **-F**\ **p** (i.e., no
- other of the 5 letters) to output only the model coefficients
- (Polynomial).
-**-N**\ [**f**\ ]\ *n\_model*\ [**r**\ ]
- Specify the number of terms in the model, *n\_model*, whether to fit
- a Fourier (**-Nf**) or polynomial [Default] model, and append **r**
- to do a robust fit. E.g., a robust quadratic model is
- **-N**\ *3*\ **r**.
-
-Optional Arguments
-------------------
-
-*table*
- One or more ASCII [or binary, see **-bi**]
- files containing x,y [w] values in the first 2 [3] columns. If no
- files are specified, **trend1d** will read from standard input.
-**-C**\ *condition\_number*
- Set the maximum allowed condition number for the matrix solution.
- **trend1d** fits a damped least squares model, retaining only that
- part of the eigenvalue spectrum such that the ratio of the largest
- eigenvalue to the smallest eigenvalue is *condition\_#*. [Default:
- *condition\_#* = 1.0e06. ].
-**-I**\ [*confidence\_level*\ ]
- Iteratively increase the number of model parameters, starting at
- one, until *n\_model* is reached or the reduction in variance of the
- model is not significant at the *confidence\_level* level. You may
- set **-I** only, without an attached number; in this case the fit
- will be iterative with a default confidence level of 0.51. Or choose
- your own level between 0 and 1. See remarks section.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-W**
- Weights are supplied in input column 3. Do a weighted least squares
- fit [or start with these weights when doing the iterative robust
- fit]. [Default reads only the first 2 columns.]
-
-.. |Add_-bi| replace:: [Default is 2 (or 3 if **-W** is set) columns].
-.. include:: explain_-bi.rst_
-
-.. |Add_-bo| replace:: [Default is 1-5 columns as given by **-F**].
-.. include:: explain_-bo.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. include:: explain_colon.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_precision.rst_
-
-Remarks
--------
-
-If a Fourier model is selected, the domain of x will be shifted and
-scaled to [-pi, pi] and the basis functions used will be 1, cos(x),
-sin(x), cos(2x), sin(2x), ... If a
-polynomial model is selected, the domain of x will be shifted and scaled
-to [-1, 1] and the basis functions will be Chebyshev polynomials. These
-have a numerical advantage in the form of the matrix which must be
-inverted and allow more accurate solutions. The Chebyshev polynomial of
-degree n has n+1 extrema in [-1, 1], at all of which its value is either
--1 or +1. Therefore the magnitude of the polynomial model coefficients
-can be directly compared. NOTE: The stable model coefficients are
-Chebyshev coefficients. The corresponding polynomial coefficients in a +
-bx + cxx + ... are also given in Verbose mode but users must realize
-that they are NOT stable beyond degree 7 or 8. See Numerical Recipes for
-more discussion. For evaluating Chebyshev polynomials, see **gmtmath**.
-
-The **-Nr** (robust) and **-I** (iterative) options evaluate the
-significance of the improvement in model misfit Chi-Squared by an F
-test. The default confidence limit is set at 0.51; it can be changed
-with the **-I** option. The user may be surprised to find that in most
-cases the reduction in variance achieved by increasing the number of
-terms in a model is not significant at a very high degree of confidence.
-For example, with 120 degrees of freedom, Chi-Squared must decrease by
-26% or more to be significant at the 95% confidence level. If you want
-to keep iterating as long as Chi-Squared is decreasing, set
-*confidence_level* to zero.
-
-A low confidence limit (such as the default value of 0.51) is needed to
-make the robust method work. This method iteratively reweights the data
-to reduce the influence of outliers. The weight is based on the Median
-Absolute Deviation and a formula from Huber [1964], and is 95% efficient
-when the model residuals have an outlier-free normal distribution. This
-means that the influence of outliers is reduced only slightly at each
-iteration; consequently the reduction in Chi-Squared is not very
-significant. If the procedure needs a few iterations to successfully
-attenuate their effect, the significance level of the F test must be
-kept low.
-
-Examples
---------
-
-To remove a linear trend from data.xy by ordinary least squares, use:
-
- ::
-
- gmt trend1d data.xy -Fxr -N2 > detrended_data.xy
-
-To make the above linear trend robust with respect to outliers, use:
-
- ::
-
- gmt trend1d data.xy -Fxr -N2r > detrended_data.xy
-
-To find out how many terms (up to 20, say in a robust Fourier
-interpolant are significant in fitting data.xy, use:
-
- ::
-
- gmt trend1d data.xy -Nf20r -I -V
-
-See Also
---------
-
-:doc:`gmt`,
-:doc:`gmtmath`,
-:doc:`grdtrend`,
-:doc:`trend2d`
-
-References
-----------
-
-Huber, P. J., 1964, Robust estimation of a location parameter, *Ann.
-Math. Stat.*, **35**, 73-101.
-
-Menke, W., 1989, Geophysical Data Analysis: Discrete Inverse Theory,
-Revised Edition, Academic Press, San Diego.
diff --git a/doc_release/html/_sources/trend2d.txt b/doc_release/html/_sources/trend2d.txt
deleted file mode 100644
index 10adf20..0000000
--- a/doc_release/html/_sources/trend2d.txt
+++ /dev/null
@@ -1,192 +0,0 @@
-.. index:: ! trend2d
-
-*******
-trend2d
-*******
-
-.. only:: not man
-
- trend2d - Fit a [weighted] [robust] polynomial model for z = f(x,y) to xyz[w] data
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**trend2d** [ *table* ] **-F**\ **xyzmrw** **-N**\ *n\_model*\ [**r**]
-[ *xyz[w]file* ] [ **-C**\ *condition\_number* ]
-[ **-I**\ [*confidence\_level*] ] [ |SYN_OPT-V| ] [ **-W** ] [
-[ |SYN_OPT-b| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**trend2d** reads x,y,z [and w] values from the first three [four]
-columns on standard input [or *xyz[w]file*] and fits a regression model
-z = f(x,y) + e by [weighted] least squares. The fit may be made robust
-by iterative reweighting of the data. The user may also search for the
-number of terms in f(x,y) which significantly reduce the variance in z.
-n\_model may be in [1,10] to fit a model of the following form (similar
-to grdtrend):
-
- m1 + m2\*x + m3\*y + m4\*x\*y + m5\*x\*x + m6\*y\*y + m7\*x\*x\*x +
- m8\*x\*x\*y + m9\*x\*y\*y + m10\*y\*y\*y.
-
-The user must specify **-N**\ *n\_model*, the number of model parameters
-to use; thus, **-N**\ *4* fits a bilinear trend, **-N**\ *6* a quadratic
-surface, and so on. Optionally, append **r** to perform a robust fit. In
-this case, the program will iteratively reweight the data based on a
-robust scale estimate, in order to converge to a solution insensitive to
-outliers. This may be handy when separating a "regional" field from a
-"residual" which should have non-zero mean, such as a local mountain on
-a regional surface.
-
-Required Arguments
-------------------
-
-**-F**\ **xyzmrw**
- Specify up to six letters from the set {**x y z m r w**\ } in any
- order to create columns of ASCII [or binary] output. **x** = x,
- **y** = y, **z** = z, **m** = model f(x,y), **r** = residual z -
- **m**, **w** = weight used in fitting.
-**-N**\ *n\_model*\ [**r**\ ]
- Specify the number of terms in the model, *n\_model*, and append
- **r** to do a robust fit. E.g., a robust bilinear model is
- **-N**\ *4*\ **r**.
-
-Optional Arguments
-------------------
-
-*table*
- One or more ASCII [or binary, see **-bi**]
- files containing x,y,z [w] values in the first 3 [4] columns. If no
- files are specified, **trend2d** will read from standard input.
-**-C**\ *condition\_number*
- Set the maximum allowed condition number for the matrix solution.
- **trend2d** fits a damped least squares model, retaining only that
- part of the eigenvalue spectrum such that the ratio of the largest
- eigenvalue to the smallest eigenvalue is *condition\_#*. [Default:
- *condition\_#* = 1.0e06. ].
-**-I**\ [*confidence\_level*\ ]
- Iteratively increase the number of model parameters, starting at
- one, until *n\_model* is reached or the reduction in variance of the
- model is not significant at the *confidence\_level* level. You may
- set **-I** only, without an attached number; in this case the fit
- will be iterative with a default confidence level of 0.51. Or choose
- your own level between 0 and 1. See remarks section.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-W**
- Weights are supplied in input column 4. Do a weighted least squares
- fit [or start with these weights when doing the iterative robust
- fit]. [Default reads only the first 3 columns.]
-
-.. |Add_-bi| replace:: [Default is 3 (or 4 if **-W** is set) input columns].
-.. include:: explain_-bi.rst_
-
-.. |Add_-bo| replace:: [Default is 1-6 columns as set by **-F**].
-.. include:: explain_-bo.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. include:: explain_colon.rst_
-
-.. include:: explain_help.rst_
-
-Remarks
--------
-
-The domain of x and y will be shifted and scaled to [-1, 1] and the
-basis functions are built from Chebyshev polynomials. These have a
-numerical advantage in the form of the matrix which must be inverted and
-allow more accurate solutions. In many applications of **trend2d** the
-user has data located approximately along a line in the x,y plane which
-makes an angle with the x axis (such as data collected along a road or
-ship track). In this case the accuracy could be improved by a rotation
-of the x,y axes. **trend2d** does not search for such a rotation;
-instead, it may find that the matrix problem has deficient rank.
-However, the solution is computed using the generalized inverse and
-should still work out OK. The user should check the results graphically
-if **trend2d** shows deficient rank. NOTE: The model parameters listed
-with **-V** are Chebyshev coefficients; they are not numerically
-equivalent to the m#s in the equation described above. The description
-above is to allow the user to match **-N** with the order of the
-polynomial surface. For evaluating Chebyshev polynomials, see
-:doc:`grdmath`.
-
-The **-N**\ *n\_model*\ **r** (robust) and **-I** (iterative) options
-evaluate the significance of the improvement in model misfit Chi-Squared
-by an F test. The default confidence limit is set at 0.51; it can be
-changed with the **-I** option. The user may be surprised to find that
-in most cases the reduction in variance achieved by increasing the
-number of terms in a model is not significant at a very high degree of
-confidence. For example, with 120 degrees of freedom, Chi-Squared must
-decrease by 26% or more to be significant at the 95% confidence level.
-If you want to keep iterating as long as Chi-Squared is decreasing, set
-*confidence_level* to zero.
-
-A low confidence limit (such as the default value of 0.51) is needed to
-make the robust method work. This method iteratively reweights the data
-to reduce the influence of outliers. The weight is based on the Median
-Absolute Deviation and a formula from Huber [1964], and is 95% efficient
-when the model residuals have an outlier-free normal distribution. This
-means that the influence of outliers is reduced only slightly at each
-iteration; consequently the reduction in Chi-Squared is not very
-significant. If the procedure needs a few iterations to successfully
-attenuate their effect, the significance level of the F test must be
-kept low.
-
-.. include:: explain_precision.rst_
-
-Examples
---------
-
-To remove a planar trend from data.xyz by ordinary least squares, use:
-
- ::
-
- gmt trend2d data.xyz -Fxyr -N2 > detrended_data.xyz
-
-To make the above planar trend robust with respect to outliers, use:
-
- ::
-
- gmt trend2d data.xzy -Fxyr -N2r > detrended_data.xyz
-
-To find out how many terms (up to 10 in a robust interpolant are
-significant in fitting data.xyz, use:
-
- ::
-
- gmt trend2d data.xyz -N10r -I -V
-
-See Also
---------
-
-:doc:`gmt`,
-:doc:`grdmath`,
-:doc:`grdtrend`,
-:doc:`trend1d`
-
-References
-----------
-
-Huber, P. J., 1964, Robust estimation of a location parameter, *Ann.
-Math. Stat.*, **35**, 73-101.
-
-Menke, W., 1989, Geophysical Data Analysis: Discrete Inverse Theory,
-Revised Edition, Academic Press, San Diego.
diff --git a/doc_release/html/_sources/triangulate.txt b/doc_release/html/_sources/triangulate.txt
deleted file mode 100644
index d1674e2..0000000
--- a/doc_release/html/_sources/triangulate.txt
+++ /dev/null
@@ -1,177 +0,0 @@
-.. index:: ! triangulate
-
-***********
-triangulate
-***********
-
-.. only:: not man
-
- triangulate - Do optimal (Delaunay) triangulation and gridding of Cartesian table data [method]
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**triangulate** [ *table* ] [ **-Dx**\ \|\ **y** ] [ **-E**\ *empty* ]
-[ **-G**\ *grdfile* ]
-[ |SYN_OPT-I| ]
-[ **-J**\ *parameters* ] [ **-M** ] [ **-N** ] [ **-Q** ]
-[ |SYN_OPT-R| ] [ **-S** ]
-[ |SYN_OPT-V| ] [ **-Z** ]
-[ |SYN_OPT-b| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ **-r** ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**triangulate** reads one or more ASCII [or binary] files (or standard
-input) containing x,y[,z] and performs Delaunay triangulation, i.e., it
-find how the points should be connected to give the most equilateral
-triangulation possible. If a map projection (give **-R** and **-J**) is
-chosen then it is applied before the triangulation is calculated. By
-default, the output is triplets of point id numbers that make up each
-triangle and is written to standard output. The id numbers refer to the
-points position (line number, starting at 0 for the first line) in the
-input file. As an option, you may choose to create a multiple segment
-file that can be piped through :doc:`psxy` to draw the triangulation
-network. If **-G** **-I** are set a grid will be calculated based on the
-surface defined by the planar triangles. The actual algorithm used in
-the triangulations is either that of Watson [1982] [Default] or Shewchuk
-[1996] (if installed; type **triangulate -** to see which method is
-selected). This choice is made during the GMT installation.
-
-Required Arguments
-------------------
-
-None.
-
-Optional Arguments
-------------------
-
-.. |Add_intables| unicode:: 0x20 .. just an invisible code
-.. include:: explain_intables.rst_
-
-**-Dx**\ \|\ **y**
- Take either the *x*- or *y*-derivatives of surface represented by
- the planar facets (only used when **-G** is set).
-**-E**\ *empty*
- Set the value assigned to empty nodes when **-G** is set [NaN].
-**-G**\ *grdfile*
- Use triangulation to grid the data onto an even grid (specified with
- **-R** **-I**). Append the name of the output grid file. The
- interpolation is performed in the original coordinates, so if your
- triangles are close to the poles you are better off projecting all
- data to a local coordinate system before using **triangulate** (this
- is true of all gridding routines).
-**-I**
- *x\_inc* [and optionally *y\_inc*] sets the grid size for optional
- grid output (see **-G**). Append **m** to indicate arc minutes or
- **s** to indicate arc seconds.
-
-.. include:: explain_-J.rst_
-
-**-M**
- Output triangulation network as multiple line segments separated by
- a segment header record.
-**-N**
- Used in conjunction with **-G** to also write the triplets of the
- ids of all the Delaunay vertices [Default only writes the grid].
-**-Q**
- Output the edges of the Voronoi cells instead [Default is Delaunay
- triangle edges]. Requires **-R** and is only available if linked
- with the Shewchuk [1996] library. Note that **-Z** is ignored on
- output.
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-R.rst_
-
-**-S**
- Output triangles as polygon segments separated by a segment header
- record. Requires Delaunay triangulation.
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-Z**
- Controls whether we read (x,y) or (x,y,z) data and if z should be
- output when **-M** or **-S** are used [Read (x,y) only].
-
-.. |Add_-bi| replace:: [Default is 2 input columns].
-.. include:: explain_-bi.rst_
-
-.. |Add_-bo| replace:: [Default is same as input]. Node ids are stored as double triplets.
-.. include:: explain_-bo.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-h| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. |Add_nodereg| replace:: (Only valid with **-G**).
-.. include:: explain_nodereg.rst_
-
-.. include:: explain_colon.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_precision.rst_
-
-.. include:: explain_float.rst_
-
-Examples
---------
-
-To triangulate the points in the file samples.xyz, store the triangle
-information in a binary file, and make a grid for the given area and spacing, use
-
- ::
-
- gmt triangulate samples.xyz -bo -R0/30/0/30 -I2 -Gsurf.nc > samples.ijk
-
-To draw the optimal Delaunay triangulation network based on the same
-file using a 15-cm-wide Mercator map, use
-
- ::
-
- gmt triangulate samples.xyz -M -R-100/-90/30/34 -JM15c | gmt psxy \
- -R-100/-90/30/34 -JM15c -W0.5p -B1 > network.ps
-
-To instead plot the Voronoi cell outlines, try
-
- ::
-
- gmt triangulate samples.xyz -M -Q -R-100/-90/30/34 -JM15c | \
- gmt psxy -R-100/-90/30/34 -JM15c -W0.5p -B1 > cells.ps
-
-See Also
---------
-
-:doc:`gmt`,
-:doc:`greenspline`,
-:doc:`nearneighbor`,
-:doc:`pscontour`,
-:doc:`sphinterpolate`,
-:doc:`sphtriangulate`,
-:doc:`surface`
-
-References
-----------
-
-Watson, D. F., 1982, Acord: Automatic contouring of raw data, *Comp. &
-Geosci.*, **8**, 97-101.
-
-Shewchuk, J. R., 1996, Triangle: Engineering a 2D Quality Mesh Generator
-and Delaunay Triangulator, First Workshop on Applied Computational
-Geometry (Philadelphia, PA), 124-133, ACM, May 1996.
-
-`Shewchuk's Homepage <http://www.cs.cmu.edu/~quake/triangle.html>`_
diff --git a/doc_release/html/_sources/xyz2grd.txt b/doc_release/html/_sources/xyz2grd.txt
deleted file mode 100644
index 92b9c03..0000000
--- a/doc_release/html/_sources/xyz2grd.txt
+++ /dev/null
@@ -1,205 +0,0 @@
-.. index:: ! xyz2grd
-
-*******
-xyz2grd
-*******
-
-.. only:: not man
-
- xyz2grd - Convert data table to a grid file
-
-Synopsis
---------
-
-.. include:: common_SYN_OPTs.rst_
-
-**xyz2grd** [ *table* ] **-G**\ *grdfile*
-|SYN_OPT-I|
-|SYN_OPT-R|
-[ **-A**\ [**f**\ \|\ **l**\ \|\ **m**\ \|\ **n**\ \|\ **r**\ \|\ **s**\ \|\ **u**\ \|\ **z**] ]
-[ **-D**\ *xname*/*yname*/*zname*/*scale*/*offset*/*invalid*/*title*/*remark* ]
-[ **-N**\ *nodata* ] [ **-S**\ [*zfile*] ]
-[ |SYN_OPT-V| ]
-[ **-Z**\ [*flags*\ ] ]
-[ |SYN_OPT-bi| ]
-[ |SYN_OPT-f| ]
-[ |SYN_OPT-h| ]
-[ |SYN_OPT-i| ]
-[ **-r** ]
-[ |SYN_OPT-:| ]
-
-|No-spaces|
-
-Description
------------
-
-**xyz2grd** reads one or more z or xyz tables and creates a binary grid
-file. **xyz2grd** will report if some of the nodes are not filled in
-with data. Such unconstrained nodes are set to a value specified by the
-user [Default is NaN]. Nodes with more than one value will be set to the
-mean value. As an option (using **-Z**), a 1-column z-table may be read
-assuming all nodes are present (z-tables can be in organized in a number
-of formats, see **-Z** below.)
-
-Required Arguments
-------------------
-
-**-G**\ *grdfile*
- *grdfile* is the name of the binary output grid file. (See GRID FILE
- FORMAT below.)
-
-.. include:: explain_-I.rst_
-
-.. |Add_-R| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-R.rst_
-
-Optional Arguments
-------------------
-
-*table*
- One or more ASCII [or binary, see **-bi**]
- files holding z or (x,y,z) values. The xyz triplets do not have to
- be sorted. One-column z tables must be sorted and the **-Z** must be
- set.
-**-A**\ [**f**\ \|\ **l**\ \|\ **m**\ \|\ **n**\ \|\ **r**\ \|\ **s**\ \|\ **u**\ \|\ **z**]
- By default we will calculate mean values if multiple entries fall on
- the same node. Use **-A** to change this behavior, except it is
- ignored if **-Z** is given. Append **f** or **s** to simply keep the
- first or last data point that was assigned to each node. Append
- **l** or **u** to find the lowest (minimum) or upper (maximum) value
- at each node, respectively. Append **m** or **r** to compute mean or
- RMS value at each node, respectively. Append **n** to simply count
- the number of data points that were assigned to each node. Append
- **z** to sum multiple values that belong to the same node.
-
-.. include:: explain_-D_cap.rst_
-
-**-N**\ *nodata*
- No data. Set nodes with no input xyz triplet to this value [Default
- is NaN]. For z-tables, this option is used to replace z-values that
- equal *nodata* with NaN.
-**-S**\ [*zfile*]
- Swap the byte-order of the input only. No grid file is produced. You
- must also supply the **-Z** option. The output is written to *zfile*
- (or stdout if not supplied).
-
-.. |Add_-V| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-V.rst_
-
-**-Z**\ [*flags*]
- Read a 1-column ASCII [or binary] table. This assumes that all the
- nodes are present and sorted according to specified ordering
- convention contained in *flags*. If incoming data represents rows,
- make *flags* start with **T**\ (op) if first row is y
- = ymax or **B**\ (ottom) if first row is y = ymin.
- Then, append **L** or **R** to indicate that first element is at
- left or right end of row. Likewise for column formats: start with
- **L** or **R** to position first column, and then append **T** or
- **B** to position first element in a row. Note: These two row/column
- indicators are only required for grids; for other tables they do not
- apply. For gridline registered grids: If data are periodic in x but
- the incoming data do not contain the (redundant) column at x = xmax,
- append **x**. For data periodic in y without redundant row at y =
- ymax, append **y**. Append **s**\ *n* to skip the first *n* number
- of bytes (probably a header). If the byte-order or the words needs
- to be swapped, append **w**. Select one of several data types (all
- binary except **a**):
-
- **A** ASCII representation of one or more floating point values per record
-
- **a** ASCII representation of a single item per record
-
- **c** int8_t, signed 1-byte character
-
- **u** uint8_t, unsigned 1-byte character
-
- **h** int16_t, signed 2-byte integer
-
- **H** uint16_t, unsigned 2-byte integer
-
- **i** int32_t, signed 4-byte integer
-
- **I** uint32_t, unsigned 4-byte integer
-
- **l** int64_t, long (8-byte) integer
-
- **L** uint64_t, unsigned long (8-byte) integer
-
- **f** 4-byte floating point single precision
-
- **d** 8-byte floating point double precision
-
- Default format is scanline orientation of ASCII numbers: **-ZTLa**.
- Note that **-Z** only applies to 1-column input. The difference
- between **A** and **a** is that the latter can decode both
- *date*\ **T**\ *clock* and *ddd:mm:ss[.xx]* formats while the former
- is strictly for regular floating point values.
-
-.. |Add_-bi| replace:: [Default is 3 input columns]. This option only applies
- to xyz input files; see **-Z** for z tables.
-.. include:: explain_-bi.rst_
-
-.. |Add_-f| unicode:: 0x20 .. just an invisible code
-.. include:: explain_-f.rst_
-
-.. |Add_-h| replace:: Not used with binary data.
-.. include:: explain_-h.rst_
-
-.. include:: explain_-icols.rst_
-
-.. |Add_nodereg| unicode:: 0x20 .. just an invisible code
-.. include:: explain_nodereg.rst_
-
-.. include:: explain_colon.rst_
-
-.. include:: explain_help.rst_
-
-.. include:: explain_float.rst_
-
-.. include:: explain_grd_output.rst_
-
-.. include:: explain_grd_coord.rst_
-
-Swapping Limitations
---------------------
-
-All data types can be read, even 64-bit integers, but internally grids
-are stored using floats. Hence, integer values exceeding the float
-type's 23-bit mantissa may not be represented exactly. When **-S** is
-used no grids are implied and we read data into an intermediate double
-container. This means all but 64-bit integers can be represented using
-the double type's 53-bit mantissa.
-
-Examples
---------
-
-To create a grid file from the ASCII data in hawaii\_grv.xyz, use
-
- gmt xyz2grd hawaii_grv.xyz -Ddegree/degree/mGal/1/0//"Hawaiian Gravity"/"GRS-80 Ellipsoid used" \
- -Ghawaii_grv_new.nc -R198/208/18/25 -I5m -V
-
-To create a grid file from the raw binary (3-column, single-precision
-scanline-oriented data raw.b, use
-
- gmt xyz2grd raw.b -Dm/m/m/1/0 -Graw.nc -R0/100/0/100 -I1 -V -Z -bi3f
-
-To make a grid file from the raw binary USGS DEM (short integer
-scanline-oriented data topo30. on the NGDC global relief Data CD-ROM,
-with values of -9999 indicate missing data, one must on some machine
-reverse the byte-order. On such machines (like Sun, use
-
- gmt xyz2grd topo30. -Dm/m/m/1/0 -Gustopo.nc -R234/294/24/50 -I30s -N-9999 -B -ZTLhw
-
-Say you have received a binary file with 4-byte floating points that
-were written on a machine of different byte-order than yours. You can
-swap the byte-order with
-
- gmt xyz2grd floats.bin -Snew_floats.bin -V -Zf
-
-See Also
---------
-
-:doc:`gmt`,
-:doc:`grd2xyz`,
-:doc:`grdedit`,
-:doc:`grdreformat`
diff --git a/doc_release/html/_static/ajax-loader.gif b/doc_release/html/_static/ajax-loader.gif
deleted file mode 100644
index 61faf8c..0000000
Binary files a/doc_release/html/_static/ajax-loader.gif and /dev/null differ
diff --git a/doc_release/html/_static/basic.css b/doc_release/html/_static/basic.css
deleted file mode 100644
index 967e36c..0000000
--- a/doc_release/html/_static/basic.css
+++ /dev/null
@@ -1,537 +0,0 @@
-/*
- * basic.css
- * ~~~~~~~~~
- *
- * Sphinx stylesheet -- basic theme.
- *
- * :copyright: Copyright 2007-2014 by the Sphinx team, see AUTHORS.
- * :license: BSD, see LICENSE for details.
- *
- */
-
-/* -- main layout ----------------------------------------------------------- */
-
-div.clearer {
- clear: both;
-}
-
-/* -- relbar ---------------------------------------------------------------- */
-
-div.related {
- width: 100%;
- font-size: 90%;
-}
-
-div.related h3 {
- display: none;
-}
-
-div.related ul {
- margin: 0;
- padding: 0 0 0 10px;
- list-style: none;
-}
-
-div.related li {
- display: inline;
-}
-
-div.related li.right {
- float: right;
- margin-right: 5px;
-}
-
-/* -- sidebar --------------------------------------------------------------- */
-
-div.sphinxsidebarwrapper {
- padding: 10px 5px 0 10px;
-}
-
-div.sphinxsidebar {
- float: left;
- width: 230px;
- margin-left: -100%;
- font-size: 90%;
-}
-
-div.sphinxsidebar ul {
- list-style: none;
-}
-
-div.sphinxsidebar ul ul,
-div.sphinxsidebar ul.want-points {
- margin-left: 20px;
- list-style: square;
-}
-
-div.sphinxsidebar ul ul {
- margin-top: 0;
- margin-bottom: 0;
-}
-
-div.sphinxsidebar form {
- margin-top: 10px;
-}
-
-div.sphinxsidebar input {
- border: 1px solid #98dbcc;
- font-family: sans-serif;
- font-size: 1em;
-}
-
-div.sphinxsidebar #searchbox input[type="text"] {
- width: 170px;
-}
-
-div.sphinxsidebar #searchbox input[type="submit"] {
- width: 30px;
-}
-
-img {
- border: 0;
- max-width: 100%;
-}
-
-/* -- search page ----------------------------------------------------------- */
-
-ul.search {
- margin: 10px 0 0 20px;
- padding: 0;
-}
-
-ul.search li {
- padding: 5px 0 5px 20px;
- background-image: url(file.png);
- background-repeat: no-repeat;
- background-position: 0 7px;
-}
-
-ul.search li a {
- font-weight: bold;
-}
-
-ul.search li div.context {
- color: #888;
- margin: 2px 0 0 30px;
- text-align: left;
-}
-
-ul.keywordmatches li.goodmatch a {
- font-weight: bold;
-}
-
-/* -- index page ------------------------------------------------------------ */
-
-table.contentstable {
- width: 90%;
-}
-
-table.contentstable p.biglink {
- line-height: 150%;
-}
-
-a.biglink {
- font-size: 1.3em;
-}
-
-span.linkdescr {
- font-style: italic;
- padding-top: 5px;
- font-size: 90%;
-}
-
-/* -- general index --------------------------------------------------------- */
-
-table.indextable {
- width: 100%;
-}
-
-table.indextable td {
- text-align: left;
- vertical-align: top;
-}
-
-table.indextable dl, table.indextable dd {
- margin-top: 0;
- margin-bottom: 0;
-}
-
-table.indextable tr.pcap {
- height: 10px;
-}
-
-table.indextable tr.cap {
- margin-top: 10px;
- background-color: #f2f2f2;
-}
-
-img.toggler {
- margin-right: 3px;
- margin-top: 3px;
- cursor: pointer;
-}
-
-div.modindex-jumpbox {
- border-top: 1px solid #ddd;
- border-bottom: 1px solid #ddd;
- margin: 1em 0 1em 0;
- padding: 0.4em;
-}
-
-div.genindex-jumpbox {
- border-top: 1px solid #ddd;
- border-bottom: 1px solid #ddd;
- margin: 1em 0 1em 0;
- padding: 0.4em;
-}
-
-/* -- general body styles --------------------------------------------------- */
-
-a.headerlink {
- visibility: hidden;
-}
-
-h1:hover > a.headerlink,
-h2:hover > a.headerlink,
-h3:hover > a.headerlink,
-h4:hover > a.headerlink,
-h5:hover > a.headerlink,
-h6:hover > a.headerlink,
-dt:hover > a.headerlink {
- visibility: visible;
-}
-
-div.body p.caption {
- text-align: inherit;
-}
-
-div.body td {
- text-align: left;
-}
-
-.field-list ul {
- padding-left: 1em;
-}
-
-.first {
- margin-top: 0 !important;
-}
-
-p.rubric {
- margin-top: 30px;
- font-weight: bold;
-}
-
-img.align-left, .figure.align-left, object.align-left {
- clear: left;
- float: left;
- margin-right: 1em;
-}
-
-img.align-right, .figure.align-right, object.align-right {
- clear: right;
- float: right;
- margin-left: 1em;
-}
-
-img.align-center, .figure.align-center, object.align-center {
- display: block;
- margin-left: auto;
- margin-right: auto;
-}
-
-.align-left {
- text-align: left;
-}
-
-.align-center {
- text-align: center;
-}
-
-.align-right {
- text-align: right;
-}
-
-/* -- sidebars -------------------------------------------------------------- */
-
-div.sidebar {
- margin: 0 0 0.5em 1em;
- border: 1px solid #ddb;
- padding: 7px 7px 0 7px;
- background-color: #ffe;
- width: 40%;
- float: right;
-}
-
-p.sidebar-title {
- font-weight: bold;
-}
-
-/* -- topics ---------------------------------------------------------------- */
-
-div.topic {
- border: 1px solid #ccc;
- padding: 7px 7px 0 7px;
- margin: 10px 0 10px 0;
-}
-
-p.topic-title {
- font-size: 1.1em;
- font-weight: bold;
- margin-top: 10px;
-}
-
-/* -- admonitions ----------------------------------------------------------- */
-
-div.admonition {
- margin-top: 10px;
- margin-bottom: 10px;
- padding: 7px;
-}
-
-div.admonition dt {
- font-weight: bold;
-}
-
-div.admonition dl {
- margin-bottom: 0;
-}
-
-p.admonition-title {
- margin: 0px 10px 5px 0px;
- font-weight: bold;
-}
-
-div.body p.centered {
- text-align: center;
- margin-top: 25px;
-}
-
-/* -- tables ---------------------------------------------------------------- */
-
-table.docutils {
- border: 0;
- border-collapse: collapse;
-}
-
-table.docutils td, table.docutils th {
- padding: 1px 8px 1px 5px;
- border-top: 0;
- border-left: 0;
- border-right: 0;
- border-bottom: 1px solid #aaa;
-}
-
-table.field-list td, table.field-list th {
- border: 0 !important;
-}
-
-table.footnote td, table.footnote th {
- border: 0 !important;
-}
-
-th {
- text-align: left;
- padding-right: 5px;
-}
-
-table.citation {
- border-left: solid 1px gray;
- margin-left: 1px;
-}
-
-table.citation td {
- border-bottom: none;
-}
-
-/* -- other body styles ----------------------------------------------------- */
-
-ol.arabic {
- list-style: decimal;
-}
-
-ol.loweralpha {
- list-style: lower-alpha;
-}
-
-ol.upperalpha {
- list-style: upper-alpha;
-}
-
-ol.lowerroman {
- list-style: lower-roman;
-}
-
-ol.upperroman {
- list-style: upper-roman;
-}
-
-dl {
- margin-bottom: 15px;
-}
-
-dd p {
- margin-top: 0px;
-}
-
-dd ul, dd table {
- margin-bottom: 10px;
-}
-
-dd {
- margin-top: 3px;
- margin-bottom: 10px;
- margin-left: 30px;
-}
-
-dt:target, .highlighted {
- background-color: #fbe54e;
-}
-
-dl.glossary dt {
- font-weight: bold;
- font-size: 1.1em;
-}
-
-.field-list ul {
- margin: 0;
- padding-left: 1em;
-}
-
-.field-list p {
- margin: 0;
-}
-
-.optional {
- font-size: 1.3em;
-}
-
-.versionmodified {
- font-style: italic;
-}
-
-.system-message {
- background-color: #fda;
- padding: 5px;
- border: 3px solid red;
-}
-
-.footnote:target {
- background-color: #ffa;
-}
-
-.line-block {
- display: block;
- margin-top: 1em;
- margin-bottom: 1em;
-}
-
-.line-block .line-block {
- margin-top: 0;
- margin-bottom: 0;
- margin-left: 1.5em;
-}
-
-.guilabel, .menuselection {
- font-family: sans-serif;
-}
-
-.accelerator {
- text-decoration: underline;
-}
-
-.classifier {
- font-style: oblique;
-}
-
-abbr, acronym {
- border-bottom: dotted 1px;
- cursor: help;
-}
-
-/* -- code displays --------------------------------------------------------- */
-
-pre {
- overflow: auto;
- overflow-y: hidden; /* fixes display issues on Chrome browsers */
-}
-
-td.linenos pre {
- padding: 5px 0px;
- border: 0;
- background-color: transparent;
- color: #aaa;
-}
-
-table.highlighttable {
- margin-left: 0.5em;
-}
-
-table.highlighttable td {
- padding: 0 0.5em 0 0.5em;
-}
-
-tt.descname {
- background-color: transparent;
- font-weight: bold;
- font-size: 1.2em;
-}
-
-tt.descclassname {
- background-color: transparent;
-}
-
-tt.xref, a tt {
- background-color: transparent;
- font-weight: bold;
-}
-
-h1 tt, h2 tt, h3 tt, h4 tt, h5 tt, h6 tt {
- background-color: transparent;
-}
-
-.viewcode-link {
- float: right;
-}
-
-.viewcode-back {
- float: right;
- font-family: sans-serif;
-}
-
-div.viewcode-block:target {
- margin: -1px -10px;
- padding: 0 10px;
-}
-
-/* -- math display ---------------------------------------------------------- */
-
-img.math {
- vertical-align: middle;
-}
-
-div.body div.math p {
- text-align: center;
-}
-
-span.eqno {
- float: right;
-}
-
-/* -- printout stylesheet --------------------------------------------------- */
-
- at media print {
- div.document,
- div.documentwrapper,
- div.bodywrapper {
- margin: 0 !important;
- width: 100%;
- }
-
- div.sphinxsidebar,
- div.related,
- div.footer,
- #top-link {
- display: none;
- }
-}
\ No newline at end of file
diff --git a/doc_release/html/_static/bg-header1.png b/doc_release/html/_static/bg-header1.png
deleted file mode 100644
index 542d69a..0000000
Binary files a/doc_release/html/_static/bg-header1.png and /dev/null differ
diff --git a/doc_release/html/_static/bg-header2.png b/doc_release/html/_static/bg-header2.png
deleted file mode 100644
index ec1dd1c..0000000
Binary files a/doc_release/html/_static/bg-header2.png and /dev/null differ
diff --git a/doc_release/html/_static/comment-bright.png b/doc_release/html/_static/comment-bright.png
deleted file mode 100644
index 551517b..0000000
Binary files a/doc_release/html/_static/comment-bright.png and /dev/null differ
diff --git a/doc_release/html/_static/comment-close.png b/doc_release/html/_static/comment-close.png
deleted file mode 100644
index 09b54be..0000000
Binary files a/doc_release/html/_static/comment-close.png and /dev/null differ
diff --git a/doc_release/html/_static/comment.png b/doc_release/html/_static/comment.png
deleted file mode 100644
index 92feb52..0000000
Binary files a/doc_release/html/_static/comment.png and /dev/null differ
diff --git a/doc_release/html/_static/default.css b/doc_release/html/_static/default.css
deleted file mode 100644
index 5f1399a..0000000
--- a/doc_release/html/_static/default.css
+++ /dev/null
@@ -1,256 +0,0 @@
-/*
- * default.css_t
- * ~~~~~~~~~~~~~
- *
- * Sphinx stylesheet -- default theme.
- *
- * :copyright: Copyright 2007-2014 by the Sphinx team, see AUTHORS.
- * :license: BSD, see LICENSE for details.
- *
- */
-
- at import url("basic.css");
-
-/* -- page layout ----------------------------------------------------------- */
-
-body {
- font-family: sans-serif;
- font-size: 100%;
- background-color: #11303d;
- color: #000;
- margin: 0;
- padding: 0;
-}
-
-div.document {
- background-color: #1c4e63;
-}
-
-div.documentwrapper {
- float: left;
- width: 100%;
-}
-
-div.bodywrapper {
- margin: 0 0 0 230px;
-}
-
-div.body {
- background-color: #ffffff;
- color: #000000;
- padding: 0 20px 30px 20px;
-}
-
-div.footer {
- color: #ffffff;
- width: 100%;
- padding: 9px 0 9px 0;
- text-align: center;
- font-size: 75%;
-}
-
-div.footer a {
- color: #ffffff;
- text-decoration: underline;
-}
-
-div.related {
- background-color: #133f52;
- line-height: 30px;
- color: #ffffff;
-}
-
-div.related a {
- color: #ffffff;
-}
-
-div.sphinxsidebar {
-}
-
-div.sphinxsidebar h3 {
- font-family: 'Trebuchet MS', sans-serif;
- color: #ffffff;
- font-size: 1.4em;
- font-weight: normal;
- margin: 0;
- padding: 0;
-}
-
-div.sphinxsidebar h3 a {
- color: #ffffff;
-}
-
-div.sphinxsidebar h4 {
- font-family: 'Trebuchet MS', sans-serif;
- color: #ffffff;
- font-size: 1.3em;
- font-weight: normal;
- margin: 5px 0 0 0;
- padding: 0;
-}
-
-div.sphinxsidebar p {
- color: #ffffff;
-}
-
-div.sphinxsidebar p.topless {
- margin: 5px 10px 10px 10px;
-}
-
-div.sphinxsidebar ul {
- margin: 10px;
- padding: 0;
- color: #ffffff;
-}
-
-div.sphinxsidebar a {
- color: #98dbcc;
-}
-
-div.sphinxsidebar input {
- border: 1px solid #98dbcc;
- font-family: sans-serif;
- font-size: 1em;
-}
-
-
-
-/* -- hyperlink styles ------------------------------------------------------ */
-
-a {
- color: #355f7c;
- text-decoration: none;
-}
-
-a:visited {
- color: #355f7c;
- text-decoration: none;
-}
-
-a:hover {
- text-decoration: underline;
-}
-
-
-
-/* -- body styles ----------------------------------------------------------- */
-
-div.body h1,
-div.body h2,
-div.body h3,
-div.body h4,
-div.body h5,
-div.body h6 {
- font-family: 'Trebuchet MS', sans-serif;
- background-color: #f2f2f2;
- font-weight: normal;
- color: #20435c;
- border-bottom: 1px solid #ccc;
- margin: 20px -20px 10px -20px;
- padding: 3px 0 3px 10px;
-}
-
-div.body h1 { margin-top: 0; font-size: 200%; }
-div.body h2 { font-size: 160%; }
-div.body h3 { font-size: 140%; }
-div.body h4 { font-size: 120%; }
-div.body h5 { font-size: 110%; }
-div.body h6 { font-size: 100%; }
-
-a.headerlink {
- color: #c60f0f;
- font-size: 0.8em;
- padding: 0 4px 0 4px;
- text-decoration: none;
-}
-
-a.headerlink:hover {
- background-color: #c60f0f;
- color: white;
-}
-
-div.body p, div.body dd, div.body li {
- text-align: justify;
- line-height: 130%;
-}
-
-div.admonition p.admonition-title + p {
- display: inline;
-}
-
-div.admonition p {
- margin-bottom: 5px;
-}
-
-div.admonition pre {
- margin-bottom: 5px;
-}
-
-div.admonition ul, div.admonition ol {
- margin-bottom: 5px;
-}
-
-div.note {
- background-color: #eee;
- border: 1px solid #ccc;
-}
-
-div.seealso {
- background-color: #ffc;
- border: 1px solid #ff6;
-}
-
-div.topic {
- background-color: #eee;
-}
-
-div.warning {
- background-color: #ffe4e4;
- border: 1px solid #f66;
-}
-
-p.admonition-title {
- display: inline;
-}
-
-p.admonition-title:after {
- content: ":";
-}
-
-pre {
- padding: 5px;
- background-color: #eeffcc;
- color: #333333;
- line-height: 120%;
- border: 1px solid #ac9;
- border-left: none;
- border-right: none;
-}
-
-tt {
- background-color: #ecf0f3;
- padding: 0 1px 0 1px;
- font-size: 0.95em;
-}
-
-th {
- background-color: #ede;
-}
-
-.warning tt {
- background: #efc2c2;
-}
-
-.note tt {
- background: #d6d6d6;
-}
-
-.viewcode-back {
- font-family: sans-serif;
-}
-
-div.viewcode-block:target {
- background-color: #f4debf;
- border-top: 1px solid #ac9;
- border-bottom: 1px solid #ac9;
-}
\ No newline at end of file
diff --git a/doc_release/html/_static/doctools.js b/doc_release/html/_static/doctools.js
deleted file mode 100644
index c5455c9..0000000
--- a/doc_release/html/_static/doctools.js
+++ /dev/null
@@ -1,238 +0,0 @@
-/*
- * doctools.js
- * ~~~~~~~~~~~
- *
- * Sphinx JavaScript utilities for all documentation.
- *
- * :copyright: Copyright 2007-2014 by the Sphinx team, see AUTHORS.
- * :license: BSD, see LICENSE for details.
- *
- */
-
-/**
- * select a different prefix for underscore
- */
-$u = _.noConflict();
-
-/**
- * make the code below compatible with browsers without
- * an installed firebug like debugger
-if (!window.console || !console.firebug) {
- var names = ["log", "debug", "info", "warn", "error", "assert", "dir",
- "dirxml", "group", "groupEnd", "time", "timeEnd", "count", "trace",
- "profile", "profileEnd"];
- window.console = {};
- for (var i = 0; i < names.length; ++i)
- window.console[names[i]] = function() {};
-}
- */
-
-/**
- * small helper function to urldecode strings
- */
-jQuery.urldecode = function(x) {
- return decodeURIComponent(x).replace(/\+/g, ' ');
-};
-
-/**
- * small helper function to urlencode strings
- */
-jQuery.urlencode = encodeURIComponent;
-
-/**
- * This function returns the parsed url parameters of the
- * current request. Multiple values per key are supported,
- * it will always return arrays of strings for the value parts.
- */
-jQuery.getQueryParameters = function(s) {
- if (typeof s == 'undefined')
- s = document.location.search;
- var parts = s.substr(s.indexOf('?') + 1).split('&');
- var result = {};
- for (var i = 0; i < parts.length; i++) {
- var tmp = parts[i].split('=', 2);
- var key = jQuery.urldecode(tmp[0]);
- var value = jQuery.urldecode(tmp[1]);
- if (key in result)
- result[key].push(value);
- else
- result[key] = [value];
- }
- return result;
-};
-
-/**
- * highlight a given string on a jquery object by wrapping it in
- * span elements with the given class name.
- */
-jQuery.fn.highlightText = function(text, className) {
- function highlight(node) {
- if (node.nodeType == 3) {
- var val = node.nodeValue;
- var pos = val.toLowerCase().indexOf(text);
- if (pos >= 0 && !jQuery(node.parentNode).hasClass(className)) {
- var span = document.createElement("span");
- span.className = className;
- span.appendChild(document.createTextNode(val.substr(pos, text.length)));
- node.parentNode.insertBefore(span, node.parentNode.insertBefore(
- document.createTextNode(val.substr(pos + text.length)),
- node.nextSibling));
- node.nodeValue = val.substr(0, pos);
- }
- }
- else if (!jQuery(node).is("button, select, textarea")) {
- jQuery.each(node.childNodes, function() {
- highlight(this);
- });
- }
- }
- return this.each(function() {
- highlight(this);
- });
-};
-
-/**
- * Small JavaScript module for the documentation.
- */
-var Documentation = {
-
- init : function() {
- this.fixFirefoxAnchorBug();
- this.highlightSearchWords();
- this.initIndexTable();
- },
-
- /**
- * i18n support
- */
- TRANSLATIONS : {},
- PLURAL_EXPR : function(n) { return n == 1 ? 0 : 1; },
- LOCALE : 'unknown',
-
- // gettext and ngettext don't access this so that the functions
- // can safely bound to a different name (_ = Documentation.gettext)
- gettext : function(string) {
- var translated = Documentation.TRANSLATIONS[string];
- if (typeof translated == 'undefined')
- return string;
- return (typeof translated == 'string') ? translated : translated[0];
- },
-
- ngettext : function(singular, plural, n) {
- var translated = Documentation.TRANSLATIONS[singular];
- if (typeof translated == 'undefined')
- return (n == 1) ? singular : plural;
- return translated[Documentation.PLURALEXPR(n)];
- },
-
- addTranslations : function(catalog) {
- for (var key in catalog.messages)
- this.TRANSLATIONS[key] = catalog.messages[key];
- this.PLURAL_EXPR = new Function('n', 'return +(' + catalog.plural_expr + ')');
- this.LOCALE = catalog.locale;
- },
-
- /**
- * add context elements like header anchor links
- */
- addContextElements : function() {
- $('div[id] > :header:first').each(function() {
- $('<a class="headerlink">\u00B6</a>').
- attr('href', '#' + this.id).
- attr('title', _('Permalink to this headline')).
- appendTo(this);
- });
- $('dt[id]').each(function() {
- $('<a class="headerlink">\u00B6</a>').
- attr('href', '#' + this.id).
- attr('title', _('Permalink to this definition')).
- appendTo(this);
- });
- },
-
- /**
- * workaround a firefox stupidity
- */
- fixFirefoxAnchorBug : function() {
- if (document.location.hash && $.browser.mozilla)
- window.setTimeout(function() {
- document.location.href += '';
- }, 10);
- },
-
- /**
- * highlight the search words provided in the url in the text
- */
- highlightSearchWords : function() {
- var params = $.getQueryParameters();
- var terms = (params.highlight) ? params.highlight[0].split(/\s+/) : [];
- if (terms.length) {
- var body = $('div.body');
- if (!body.length) {
- body = $('body');
- }
- window.setTimeout(function() {
- $.each(terms, function() {
- body.highlightText(this.toLowerCase(), 'highlighted');
- });
- }, 10);
- $('<p class="highlight-link"><a href="javascript:Documentation.' +
- 'hideSearchWords()">' + _('Hide Search Matches') + '</a></p>')
- .appendTo($('#searchbox'));
- }
- },
-
- /**
- * init the domain index toggle buttons
- */
- initIndexTable : function() {
- var togglers = $('img.toggler').click(function() {
- var src = $(this).attr('src');
- var idnum = $(this).attr('id').substr(7);
- $('tr.cg-' + idnum).toggle();
- if (src.substr(-9) == 'minus.png')
- $(this).attr('src', src.substr(0, src.length-9) + 'plus.png');
- else
- $(this).attr('src', src.substr(0, src.length-8) + 'minus.png');
- }).css('display', '');
- if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) {
- togglers.click();
- }
- },
-
- /**
- * helper function to hide the search marks again
- */
- hideSearchWords : function() {
- $('#searchbox .highlight-link').fadeOut(300);
- $('span.highlighted').removeClass('highlighted');
- },
-
- /**
- * make the url absolute
- */
- makeURL : function(relativeURL) {
- return DOCUMENTATION_OPTIONS.URL_ROOT + '/' + relativeURL;
- },
-
- /**
- * get the current relative url
- */
- getCurrentURL : function() {
- var path = document.location.pathname;
- var parts = path.split(/\//);
- $.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\//), function() {
- if (this == '..')
- parts.pop();
- });
- var url = parts.join('/');
- return path.substring(url.lastIndexOf('/') + 1, path.length - 1);
- }
-};
-
-// quick alias for translations
-_ = Documentation.gettext;
-
-$(document).ready(function() {
- Documentation.init();
-});
diff --git a/doc_release/html/_static/down-pressed.png b/doc_release/html/_static/down-pressed.png
deleted file mode 100644
index 6f7ad78..0000000
Binary files a/doc_release/html/_static/down-pressed.png and /dev/null differ
diff --git a/doc_release/html/_static/down.png b/doc_release/html/_static/down.png
deleted file mode 100644
index 3003a88..0000000
Binary files a/doc_release/html/_static/down.png and /dev/null differ
diff --git a/doc_release/html/_static/file.png b/doc_release/html/_static/file.png
deleted file mode 100644
index d18082e..0000000
Binary files a/doc_release/html/_static/file.png and /dev/null differ
diff --git a/doc_release/html/_static/jquery.js b/doc_release/html/_static/jquery.js
deleted file mode 100644
index 83589da..0000000
--- a/doc_release/html/_static/jquery.js
+++ /dev/null
@@ -1,2 +0,0 @@
-/*! jQuery v1.8.3 jquery.com | jquery.org/license */
-(function(e,t){function _(e){var t=M[e]={};return v.each(e.split(y),function(e,n){t[n]=!0}),t}function H(e,n,r){if(r===t&&e.nodeType===1){var i="data-"+n.replace(P,"-$1").toLowerCase();r=e.getAttribute(i);if(typeof r=="string"){try{r=r==="true"?!0:r==="false"?!1:r==="null"?null:+r+""===r?+r:D.test(r)?v.parseJSON(r):r}catch(s){}v.data(e,n,r)}else r=t}return r}function B(e){var t;for(t in e){if(t==="data"&&v.isEmptyObject(e[t]))continue;if(t!=="toJSON")return!1}return!0}function et(){retur [...]
\ No newline at end of file
diff --git a/doc_release/html/_static/minus.png b/doc_release/html/_static/minus.png
deleted file mode 100644
index da1c562..0000000
Binary files a/doc_release/html/_static/minus.png and /dev/null differ
diff --git a/doc_release/html/_static/plus.png b/doc_release/html/_static/plus.png
deleted file mode 100644
index b3cb374..0000000
Binary files a/doc_release/html/_static/plus.png and /dev/null differ
diff --git a/doc_release/html/_static/pygments.css b/doc_release/html/_static/pygments.css
deleted file mode 100644
index 57eadc0..0000000
--- a/doc_release/html/_static/pygments.css
+++ /dev/null
@@ -1,63 +0,0 @@
-.highlight .hll { background-color: #ffffcc }
-.highlight { background: #eeffcc; }
-.highlight .c { color: #408090; font-style: italic } /* Comment */
-.highlight .err { border: 1px solid #FF0000 } /* Error */
-.highlight .k { color: #007020; font-weight: bold } /* Keyword */
-.highlight .o { color: #666666 } /* Operator */
-.highlight .cm { color: #408090; font-style: italic } /* Comment.Multiline */
-.highlight .cp { color: #007020 } /* Comment.Preproc */
-.highlight .c1 { color: #408090; font-style: italic } /* Comment.Single */
-.highlight .cs { color: #408090; background-color: #fff0f0 } /* Comment.Special */
-.highlight .gd { color: #A00000 } /* Generic.Deleted */
-.highlight .ge { font-style: italic } /* Generic.Emph */
-.highlight .gr { color: #FF0000 } /* Generic.Error */
-.highlight .gh { color: #000080; font-weight: bold } /* Generic.Heading */
-.highlight .gi { color: #00A000 } /* Generic.Inserted */
-.highlight .go { color: #333333 } /* Generic.Output */
-.highlight .gp { color: #c65d09; font-weight: bold } /* Generic.Prompt */
-.highlight .gs { font-weight: bold } /* Generic.Strong */
-.highlight .gu { color: #800080; font-weight: bold } /* Generic.Subheading */
-.highlight .gt { color: #0044DD } /* Generic.Traceback */
-.highlight .kc { color: #007020; font-weight: bold } /* Keyword.Constant */
-.highlight .kd { color: #007020; font-weight: bold } /* Keyword.Declaration */
-.highlight .kn { color: #007020; font-weight: bold } /* Keyword.Namespace */
-.highlight .kp { color: #007020 } /* Keyword.Pseudo */
-.highlight .kr { color: #007020; font-weight: bold } /* Keyword.Reserved */
-.highlight .kt { color: #902000 } /* Keyword.Type */
-.highlight .m { color: #208050 } /* Literal.Number */
-.highlight .s { color: #4070a0 } /* Literal.String */
-.highlight .na { color: #4070a0 } /* Name.Attribute */
-.highlight .nb { color: #007020 } /* Name.Builtin */
-.highlight .nc { color: #0e84b5; font-weight: bold } /* Name.Class */
-.highlight .no { color: #60add5 } /* Name.Constant */
-.highlight .nd { color: #555555; font-weight: bold } /* Name.Decorator */
-.highlight .ni { color: #d55537; font-weight: bold } /* Name.Entity */
-.highlight .ne { color: #007020 } /* Name.Exception */
-.highlight .nf { color: #06287e } /* Name.Function */
-.highlight .nl { color: #002070; font-weight: bold } /* Name.Label */
-.highlight .nn { color: #0e84b5; font-weight: bold } /* Name.Namespace */
-.highlight .nt { color: #062873; font-weight: bold } /* Name.Tag */
-.highlight .nv { color: #bb60d5 } /* Name.Variable */
-.highlight .ow { color: #007020; font-weight: bold } /* Operator.Word */
-.highlight .w { color: #bbbbbb } /* Text.Whitespace */
-.highlight .mb { color: #208050 } /* Literal.Number.Bin */
-.highlight .mf { color: #208050 } /* Literal.Number.Float */
-.highlight .mh { color: #208050 } /* Literal.Number.Hex */
-.highlight .mi { color: #208050 } /* Literal.Number.Integer */
-.highlight .mo { color: #208050 } /* Literal.Number.Oct */
-.highlight .sb { color: #4070a0 } /* Literal.String.Backtick */
-.highlight .sc { color: #4070a0 } /* Literal.String.Char */
-.highlight .sd { color: #4070a0; font-style: italic } /* Literal.String.Doc */
-.highlight .s2 { color: #4070a0 } /* Literal.String.Double */
-.highlight .se { color: #4070a0; font-weight: bold } /* Literal.String.Escape */
-.highlight .sh { color: #4070a0 } /* Literal.String.Heredoc */
-.highlight .si { color: #70a0d0; font-style: italic } /* Literal.String.Interpol */
-.highlight .sx { color: #c65d09 } /* Literal.String.Other */
-.highlight .sr { color: #235388 } /* Literal.String.Regex */
-.highlight .s1 { color: #4070a0 } /* Literal.String.Single */
-.highlight .ss { color: #517918 } /* Literal.String.Symbol */
-.highlight .bp { color: #007020 } /* Name.Builtin.Pseudo */
-.highlight .vc { color: #bb60d5 } /* Name.Variable.Class */
-.highlight .vg { color: #bb60d5 } /* Name.Variable.Global */
-.highlight .vi { color: #bb60d5 } /* Name.Variable.Instance */
-.highlight .il { color: #208050 } /* Literal.Number.Integer.Long */
\ No newline at end of file
diff --git a/doc_release/html/_static/rtd-sidebar.js b/doc_release/html/_static/rtd-sidebar.js
deleted file mode 100644
index a54418e..0000000
--- a/doc_release/html/_static/rtd-sidebar.js
+++ /dev/null
@@ -1,174 +0,0 @@
-/*
- * rtd-sidebar.js
- * ~~~~~~~~~~~~~~
- *
- * This script makes the Sphinx sidebar collapsible.
- *
- * .sphinxsidebar contains .sphinxsidebarwrapper. This script adds
- * in .sphixsidebar, after .sphinxsidebarwrapper, the #sidebarbutton
- * used to collapse and expand the sidebar.
- *
- * When the sidebar is collapsed the .sphinxsidebarwrapper is hidden
- * and the width of the sidebar and the margin-left of the document
- * are decreased. When the sidebar is expanded the opposite happens.
- * This script saves a per-browser/per-session cookie used to
- * remember the position of the sidebar among the pages.
- * Once the browser is closed the cookie is deleted and the position
- * reset to the default (expanded).
- *
- * Adapted from sidebar.js to be used with RTD theme.
- * Copyright 2007-2011 by the Sphinx team.
- * License BSD.
- *
- */
-
-$(function() {
- // global elements used by the functions.
- // the 'sidebarbutton' element is defined as global after its
- // creation, in the add_sidebar_button function
- var bodywrapper = $('.bodywrapper');
- var sidebar = $('.sphinxsidebar');
- var sidebarwrapper = $('.sphinxsidebarwrapper');
-
- // for some reason, the document has no sidebar; do not run into errors
- if (!sidebar.length) return;
-
- // original margin-left of the bodywrapper and width of the sidebar
- // with the sidebar expanded
- var bw_margin_expanded = bodywrapper.css('margin-left');
- var ssb_padding_expanded = sidebar.css('padding');
- var ssb_width_expanded = sidebar.width();
-
- // margin-left of the bodywrapper and width of the sidebar
- // with the sidebar collapsed
- var bw_margin_collapsed = '.9em';
- var ssb_width_collapsed = '.7em';
-
- // colors used by the current theme
- var dark_color = $('h3').css('color');
- var light_color = $('.sphinxsidebar').css('background-color');
-
- function sidebar_is_collapsed() {
- return sidebarwrapper.is(':not(:visible)');
- }
-
- function toggle_sidebar() {
- if (sidebar_is_collapsed())
- expand_sidebar();
- else
- collapse_sidebar();
- }
-
- function collapse_sidebar() {
- sidebarwrapper.hide();
- sidebar.css({
- 'width': ssb_width_collapsed,
- 'padding': '0px'
- });
- bodywrapper.css('margin-left', bw_margin_collapsed);
- sidebarbutton.css({
- 'margin-left': '0',
- 'height': bodywrapper.height()
- });
- sidebarbutton.find('span').text('»');
- sidebarbutton.attr('title', _('Expand sidebar'));
- document.cookie = 'sidebar=collapsed';
- }
-
- function expand_sidebar() {
- bodywrapper.css('margin-left', bw_margin_expanded);
- sidebar.css({
- 'padding': ssb_padding_expanded,
- 'width': ssb_width_expanded
- });
- sidebarwrapper.show();
- sidebarbutton.css({
- 'margin-left': ssb_width_expanded,
- 'height': bodywrapper.height()
- });
- sidebarbutton.find('span').text('«');
- sidebarbutton.attr('title', _('Collapse sidebar'));
- document.cookie = 'sidebar=expanded';
- }
-
- function add_sidebar_button() {
- sidebarwrapper.css({
- 'float': 'left',
- 'margin-right': '0',
- 'width': ssb_width_expanded - 3
- });
- // create the button
- sidebar.append(
- '<div id="sidebarbutton"><span>«</span></div>'
- );
- var sidebarbutton = $('#sidebarbutton');
- light_color = sidebarbutton.css('background-color');
- // find the height of the viewport to center the '<<' in the page
- var viewport_height;
- var document_height = $('.document').height();
- if (window.innerHeight)
- viewport_height = window.innerHeight;
- else
- viewport_height = $(window).height();
- if (document_height < viewport_height) // use the smaller one
- viewport_height = document_height;
- sidebarbutton.find('span').css({
- 'display': 'block',
- 'margin-top': (viewport_height - sidebar.position().top - 20) / 2
- });
-
- sidebarbutton.click(toggle_sidebar);
- sidebarbutton.attr('title', _('Collapse sidebar'));
- sidebarbutton.css({
- 'color': '#444444',
- 'border-left': 'solid transparent',
- 'font-size': '1.2em',
- 'cursor': 'pointer',
- 'height': bodywrapper.height(),
- 'padding-top': '1px',
- 'padding-right': ssb_width_collapsed,
- 'margin-left': ssb_width_expanded
- });
-
- sidebarbutton.hover(
- function () {
- $(this).css('background-color', dark_color);
- },
- function () {
- $(this).css('background-color', light_color);
- }
- );
- }
-
- function set_position_from_cookie() {
- if (!document.cookie)
- return sidebar_collapse_on_small_screen();
- var items = document.cookie.split(';');
- for(var k=0; k<items.length; k++) {
- var key_val = items[k].split('=');
- var key = key_val[0];
- if (key == 'sidebar') {
- var value = key_val[1];
- if ((value == 'collapsed') && (!sidebar_is_collapsed()))
- collapse_sidebar();
- else if ((value == 'expanded') && (sidebar_is_collapsed()))
- expand_sidebar();
- }
- }
- }
-
- function sidebar_collapse_on_small_screen() {
- // auto-collapse sidebar on small screens
- var viewport_width;
- if (window.innerWidth)
- viewport_width = window.innerWidth;
- else
- viewport_width = $(window).width();
- if (viewport_width < 700)
- collapse_sidebar();
- }
-
- add_sidebar_button();
- var sidebarbutton = $('#sidebarbutton');
- set_position_from_cookie();
-});
diff --git a/doc_release/html/_static/rtd.css b/doc_release/html/_static/rtd.css
deleted file mode 100644
index cc12414..0000000
--- a/doc_release/html/_static/rtd.css
+++ /dev/null
@@ -1,807 +0,0 @@
-/*
- * rtd.css
- * ~~~~~~~~~~~~~~~
- *
- * Sphinx stylesheet -- sphinxdoc theme. Originally created by
- * Armin Ronacher for Werkzeug.
- *
- * Customized for ReadTheDocs by Eric Pierce & Eric Holscher
- *
- * :copyright: Copyright 2007-2010 by the Sphinx team, see AUTHORS.
- * :license: BSD, see LICENSE for details.
- *
- */
-
-/* RTD colors
- * light blue: #e8ecef
- * medium blue: #8ca1af
- * dark blue: #465158
- * dark grey:
- *
- * medium blue hover: #697983;
- * green highlight: #8ecc4c
- * light blue (project bar): #e8ecef
- */
-
- at import url("basic.css");
-
-/* PAGE LAYOUT -------------------------------------------------------------- */
-
-body {
- font: 100%/1.5 "ff-meta-web-pro-1","ff-meta-web-pro-2",Arial,"Helvetica Neue",sans-serif;
- text-align: center;
- color: black;
- background-color: #252f35;
- padding: 0;
- margin: 0;
-}
-
-div.document {
- text-align: left;
- background-color: #e8ecef;
-}
-
-div.bodywrapper {
- background-color: #ffffff;
- border-left: 1px solid #cccccc;
- border-bottom: 1px solid #cccccc;
- margin: 0 0 0 16em;
-}
-
-div.body {
- margin: 0;
- padding: 0.5em 1.3em;
- max-width: 55em;
- min-width: 20em;
-}
-
-div.related {
- font-size: 1em;
- background-color: #252f35;
- background: url(bg-header1.png) center repeat-x;
- background-size: auto 100%;
-}
-
-div.documentwrapper {
- float: left;
- width: 100%;
- background-color: #e8ecef;
-}
-
-
-/* HEADINGS --------------------------------------------------------------- */
-
-h1 {
- margin: 0;
- padding: 0.7em 0 0.3em 0;
- font-size: 1.5em;
- line-height: 1.15;
- color: #000000;
- clear: both;
-}
-
-h2 {
- margin: 2em 0 0.2em 0;
- font-size: 1.35em;
- padding: 0;
- color: #465158;
-}
-
-h3 {
- margin: 1em 0 -0.3em 0;
- font-size: 1.2em;
- color: #6c818f;
-}
-
-div.body h1 a, div.body h2 a, div.body h3 a, div.body h4 a, div.body h5 a, div.body h6 a {
- color: black;
-}
-
-h1 a.anchor, h2 a.anchor, h3 a.anchor, h4 a.anchor, h5 a.anchor, h6 a.anchor {
- display: none;
- margin: 0 0 0 0.3em;
- padding: 0 0.2em 0 0.2em;
- color: #aaaaaa !important;
-}
-
-h1:hover a.anchor, h2:hover a.anchor, h3:hover a.anchor, h4:hover a.anchor,
-h5:hover a.anchor, h6:hover a.anchor {
- display: inline;
-}
-
-h1 a.anchor:hover, h2 a.anchor:hover, h3 a.anchor:hover, h4 a.anchor:hover,
-h5 a.anchor:hover, h6 a.anchor:hover {
- color: #777777;
- background-color: #eeeeee;
-}
-
-
-/* LINKS ------------------------------------------------------------------ */
-
-/* Normal links get a pseudo-underline */
-a {
- color: #444444;
- text-decoration: none;
- border-bottom: 1px solid #CCCCCC;
-}
-
-/* Links in sidebar, TOC, index trees and tables have no underline */
-.sphinxsidebar a,
-.toctree-wrapper a,
-.indextable a,
-#indices-and-tables a {
- color: #444444;
- text-decoration: none;
- border-bottom: none;
-}
-
-/* Most links get an underline-effect when hovered */
-a:hover,
-div.toctree-wrapper a:hover,
-.indextable a:hover,
-#indices-and-tables a:hover {
- color: #111111;
- text-decoration: none;
- border-bottom: 1px solid #111111;
-}
-
-/* Footer links */
-div.footer a {
- color: #86989b;
- text-decoration: none;
- border: none;
-}
-div.footer a:hover {
- color: #a6b8bb;
- text-decoration: underline;
- border: none;
-}
-
-/* Permalink anchor (subtle grey with a red hover) */
-div.body a.headerlink {
- color: #cccccc;
- font-size: 1em;
- margin-left: 6px;
- padding: 0 4px 0 4px;
- text-decoration: none;
- border: none;
-}
-div.body a.headerlink:hover {
- color: #c60f0f;
- border: none;
-}
-
-
-/* NAVIGATION BAR --------------------------------------------------------- */
-
-div.related ul {
- height: 2.5em;
-}
-
-div.related ul li {
- margin: 0;
- padding: 0.65em 0;
- float: left;
- display: block;
- color: #ffffff; /* For the >> separators */
- font-size: 0.8em;
-}
-
-div.related ul li.right {
- float: right;
- margin-right: 10px;
- color: #ffffff; /* For the text */
-}
-
-div.related ul li.right a.search {
- padding: 2px;
- background-color: transparent; /* for Seach: */
-}
-
-/* "Breadcrumb" links in nav bar */
-div.related ul li a {
- order: none;
- background-color: inherit;
- font-weight: bold;
- margin: 6px 0 6px 4px;
- line-height: 1.75em;
- color: #ffffff;
- text-shadow: 0 1px rgba(0, 0, 0, 0.5);
- padding: 0.4em 0.8em;
- border: none;
- border-radius: 3px;
-}
-/* previous / next / modules / index links look more like buttons */
-div.related ul li.right a {
- margin: 0.375em 0;
- background-color: #697983;
- text-shadow: 0 1px rgba(0, 0, 0, 0.5);
- border-radius: 3px;
- -webkit-border-radius: 3px;
- -moz-border-radius: 3px;
-}
-/* All navbar links light up as buttons when hovered */
-div.related ul li a:hover {
- background-color: #8ca1af;
- color: #ffffff;
- text-decoration: none;
- border-radius: 3px;
- -webkit-border-radius: 3px;
- -moz-border-radius: 3px;
-}
-/* Take extra precautions for tt within links */
-a tt,
-div.related ul li a tt {
- background: inherit !important;
- color: inherit !important;
-}
-
-
-/* SIDEBAR ---------------------------------------------------------------- */
-
-div.sphinxsidebarwrapper {
- padding: 0;
-}
-
-div.sphinxsidebar {
- margin: 0;
- margin-left: -100%;
- float: left;
- top: 3em;
- left: 0;
- padding: 0 1em;
- width: 15.8em;
- font-size: 0.9em;
- text-align: left;
- background-color: #e8ecef;
-}
-
-div.sphinxsidebar img {
- max-width: 12em;
-}
-
-div.sphinxsidebar h3, div.sphinxsidebar h4 {
- margin: 1.2em 0 0.3em 0;
- font-size: 1em;
- padding: 0;
- color: #222222;
- font-family: "ff-meta-web-pro-1", "ff-meta-web-pro-2", "Arial", "Helvetica Neue", sans-serif;
-}
-
-div.sphinxsidebar h3 a {
- color: ;
-}
-
-div.sphinxsidebar ul,
-div.sphinxsidebar p {
- margin-top: 0;
- padding-left: 0;
- line-height: 130%;
- background-color: #e8ecef;
-}
-
-/* No bullets for nested lists, but a little extra indentation */
-div.sphinxsidebar ul ul {
- list-style-type: none;
- margin-left: 1.5em;
- padding: 0;
-}
-
-/* A little top/bottom padding to prevent adjacent links' borders
- * from overlapping each other */
-div.sphinxsidebar ul li {
- padding: 1px 0;
-}
-
-/* A little left-padding to make these align with the ULs */
-div.sphinxsidebar p.topless {
- padding-left: 0 0 0 1em;
-}
-
-/* Make these into hidden one-liners */
-div.sphinxsidebar ul li,
-div.sphinxsidebar p.topless {
- white-space: nowrap;
- overflow: hidden;
-}
-/* ...which become visible when hovered */
-div.sphinxsidebar ul li:hover,
-div.sphinxsidebar p.topless:hover {
- overflow: visible;
-}
-
-/* Search text box and "Go" button */
-#searchbox {
- margin-top: 2em;
- margin-bottom: 1em;
- background: #dddddd;
- padding: 0.5em;
- border-radius: 6px;
- -moz-border-radius: 6px;
- -webkit-border-radius: 6px;
-}
-#searchbox h3 {
- margin-top: 0;
-}
-
-/* Make search box and button abut and have a border */
-input,
-div.sphinxsidebar input {
- border: 1px solid #999999;
- float: left;
-}
-
-/* Search box in related */
-div.related input {
- float: none;
-}
-
-div.related input[type="text"] {
- border-radius: 12px;
- -moz-border-radius: 12px;
- -webkit-border-radius: 12px;
- box-shadow: inset 0px 1px 4px rgba(0, 0, 0, 0.15);
- -moz-box-shadow: inset 0px 1px 4px rgba(0, 0, 0, 0.15);
- -webkit-box-shadow: inset 0px 1px 4px rgba(0, 0, 0, 0.15);
- outline: none;
- padding: 0px 10px !important;
- border: 1px solid #C3C3C3;
-}
-
-/* Search textbox */
-input[type="text"] {
- margin: 0;
- padding: 0 3px;
- height: 20px;
- width: 144px;
- border-top-left-radius: 3px;
- border-bottom-left-radius: 3px;
- -moz-border-radius-topleft: 3px;
- -moz-border-radius-bottomleft: 3px;
- -webkit-border-top-left-radius: 3px;
- -webkit-border-bottom-left-radius: 3px;
-}
-/* Search button */
-input[type="submit"] {
- margin: 0 0 0 -1px; /* -1px prevents a double-border with textbox */
- height: 22px;
- color: #444444;
- background-color: #e8ecef;
- padding: 1px 4px;
- font-weight: bold;
- border-top-right-radius: 3px;
- border-bottom-right-radius: 3px;
- -moz-border-radius-topright: 3px;
- -moz-border-radius-bottomright: 3px;
- -webkit-border-top-right-radius: 3px;
- -webkit-border-bottom-right-radius: 3px;
-}
-input[type="submit"]:hover {
- color: #ffffff;
- background-color: #8ecc4c;
-}
-
-div.sphinxsidebar p.searchtip {
- clear: both;
- padding: 0.5em 0 0 0;
- background: #dddddd;
- color: #666666;
- font-size: 0.9em;
-}
-
-/* Sidebar links are unusual */
-div.sphinxsidebar li a,
-div.sphinxsidebar p a {
- background: #e8ecef; /* In case links overlap main content */
- border-radius: 3px;
- -moz-border-radius: 3px;
- -webkit-border-radius: 3px;
- border: 1px solid transparent; /* To prevent things jumping around on hover */
- padding: 0 5px 0 5px;
-}
-div.sphinxsidebar li a:hover,
-div.sphinxsidebar p a:hover {
- color: #111111;
- text-decoration: none;
- border: 1px solid #888888;
-}
-
-/* Tweak any link appearing in a heading */
-div.sphinxsidebar h3 a {
-}
-
-
-
-
-/* OTHER STUFF ------------------------------------------------------------ */
-
-cite, code, tt {
- font-family: 'Consolas', 'Deja Vu Sans Mono',
- 'Bitstream Vera Sans Mono', monospace;
- font-size: 0.95em;
- letter-spacing: 0.01em;
-}
-
-tt {
- background-color: #eeeeee;
- color: #444444;
-}
-
-tt.descname, tt.descclassname, tt.xref {
- border: 0;
-}
-
-hr {
- border: 1px solid #abc;
- margin: 2em;
-}
-
-pre, #_fontwidthtest {
- font-family: 'Consolas', 'Deja Vu Sans Mono',
- 'Bitstream Vera Sans Mono', monospace;
- margin: 1em 2em;
- font-size: 0.95em;
- letter-spacing: 0.015em;
- line-height: 120%;
- padding: 0.5em;
- border: 1px solid #cccccc;
- background-color: #eeeeee;
- border-radius: 6px;
- -moz-border-radius: 6px;
- -webkit-border-radius: 6px;
-}
-
-pre a {
- color: inherit;
- text-decoration: underline;
-}
-
-td.linenos pre {
- padding: 0.5em 0;
-}
-
-div.quotebar {
- background-color: #f8f8f8;
- max-width: 250px;
- float: right;
- padding: 2px 7px;
- border: 1px solid #cccccc;
-}
-
-div.topic {
- background-color: #f8f8f8;
-}
-
-table {
- border-collapse: collapse;
- margin: 0 -0.5em 0 -0.5em;
-}
-
-table td, table th {
- padding: 0.2em 0.5em 0.2em 0.5em;
-}
-
-
-/* ADMONITIONS AND WARNINGS ------------------------------------------------- */
-
-/* Shared by admonitions, warnings and sidebars */
-div.admonition,
-div.warning,
-div.sidebar {
- font-size: 0.9em;
- margin: 2em;
- padding: 0;
- /*
- border-radius: 6px;
- -moz-border-radius: 6px;
- -webkit-border-radius: 6px;
- */
-}
-div.admonition p,
-div.warning p,
-div.sidebar p {
- margin: 0.5em 1em 0.5em 1em;
- padding: 0;
-}
-div.admonition pre,
-div.warning pre,
-div.sidebar pre {
- margin: 0.4em 1em 0.4em 1em;
-}
-div.admonition p.admonition-title,
-div.warning p.admonition-title,
-div.sidebar p.sidebar-title {
- margin: 0;
- padding: 0.1em 0 0.1em 0.5em;
- color: white;
- font-weight: bold;
- font-size: 1.1em;
- text-shadow: 0 1px rgba(0, 0, 0, 0.5);
-}
-div.admonition ul, div.admonition ol,
-div.warning ul, div.warning ol,
-div.sidebar ul, div.sidebar ol {
- margin: 0.1em 0.5em 0.5em 3em;
- padding: 0;
-}
-
-
-/* Admonitions and sidebars only */
-div.admonition, div.sidebar {
- border: 1px solid #609060;
- background-color: #e9ffe9;
-}
-div.admonition p.admonition-title,
-div.sidebar p.sidebar-title {
- background-color: #70a070;
- border-bottom: 1px solid #609060;
-}
-
-
-/* Warnings only */
-div.warning {
- border: 1px solid #900000;
- background-color: #ffe9e9;
-}
-div.warning p.admonition-title {
- background-color: #b04040;
- border-bottom: 1px solid #900000;
-}
-
-
-/* Sidebars only */
-div.sidebar {
- max-width: 200px;
-}
-
-
-
-div.versioninfo {
- margin: 1em 0 0 0;
- border: 1px solid #cccccc;
- background-color: #DDEAF0;
- padding: 8px;
- line-height: 1.3em;
- font-size: 0.9em;
-}
-
-.viewcode-back {
- font-family: 'Lucida Grande', 'Lucida Sans Unicode', 'Geneva',
- 'Verdana', sans-serif;
-}
-
-div.viewcode-block:target {
- background-color: #f4debf;
- border-top: 1px solid #ac9;
- border-bottom: 1px solid #ac9;
-}
-
-dl {
- margin: 1em 0 2.5em 0;
-}
-
-/* Highlight target when you click an internal link */
-dt:target {
- background: #ffe080;
-}
-/* Don't highlight whole divs */
-div.highlight {
- background: transparent;
-}
-/* But do highlight spans (so search results can be highlighted) */
-span.highlight {
- background: #ffe080;
-}
-
-div.footer {
- background-color: #252f35;
- background: url(bg-header2.png) center repeat-x;
- background-size: auto 100%;
- color: #eeeeee;
- padding: 0 2em 1em 2em;
- clear: both;
- font-size: 0.8em;
- text-align: center;
-}
-
-p {
- margin: 0.8em 0 0.5em 0;
-}
-
-.section p img {
- margin: 1em 2em;
-}
-
-
-/* MOBILE LAYOUT -------------------------------------------------------------- */
-
- at media screen and (max-width: 600px) {
-
- h1, h2, h3, h4, h5 {
- position: relative;
- }
-
- ul {
- padding-left: 1.75em;
- }
-
- div.bodywrapper a.headerlink, #indices-and-tables h1 a {
- color: #e6e6e6;
- font-size: 80%;
- float: right;
- line-height: 1.8;
- position: absolute;
- right: -0.7em;
- visibility: inherit;
- }
-
- div.bodywrapper h1 a.headerlink, #indices-and-tables h1 a {
- line-height: 1.5;
- }
-
- pre {
- font-size: 0.7em;
- overflow: auto;
- word-wrap: break-word;
- white-space: pre-wrap;
- }
-
- div.related ul {
- height: 2.5em;
- padding: 0;
- text-align: left;
- }
-
- div.related ul li {
- clear: both;
- color: #465158;
- padding: 0.2em 0;
- }
-
- div.related ul li:last-child {
- border-bottom: 1px dotted #8ca1af;
- padding-bottom: 0.4em;
- margin-bottom: 1em;
- width: 100%;
- }
-
- div.related ul li a {
- color: #465158;
- padding-right: 0;
- }
-
- div.related ul li a:hover {
- background: inherit;
- color: inherit;
- }
-
- div.related ul li.right {
- clear: none;
- padding: 0.65em 0;
- margin-bottom: 0.5em;
- }
-
- div.related ul li.right a {
- color: #ffffff;
- padding-right: 0.8em;
- }
-
- div.related ul li.right a:hover {
- background-color: #8ca1af;
- }
-
- div.body {
- clear: both;
- min-width: 0;
- word-wrap: break-word;
- }
-
- div.bodywrapper {
- margin: 0 0 0 0;
- }
-
- div.sphinxsidebar {
- float: none;
- margin: 0;
- width: auto;
- }
-
- div.sphinxsidebar input[type="text"] {
- height: 2em;
- line-height: 2em;
- width: 70%;
- }
-
- div.sphinxsidebar input[type="submit"] {
- height: 2em;
- margin-left: 0.5em;
- width: 20%;
- }
-
- div.sphinxsidebar p.searchtip {
- background: inherit;
- margin-bottom: 1em;
- }
-
- div.sphinxsidebar ul li, div.sphinxsidebar p.topless {
- white-space: normal;
- }
-
- .bodywrapper img {
- display: block;
- margin-left: auto;
- margin-right: auto;
- max-width: 100%;
- }
-
- div.documentwrapper {
- float: none;
- }
-
- div.admonition, div.warning, pre, blockquote {
- margin-left: 0em;
- margin-right: 0em;
- }
-
- .body p img {
- margin: 0;
- }
-
- #searchbox {
- background: transparent;
- }
-
- .related:not(:first-child) li {
- display: none;
- }
-
- .related:not(:first-child) li.right {
- display: block;
- }
-
- div.footer {
- padding: 1em;
- }
-
- .rtd_doc_footer .badge {
- float: none;
- margin: 1em auto;
- position: static;
- }
-
- .rtd_doc_footer .badge.revsys-inline {
- margin-right: auto;
- margin-bottom: 2em;
- }
-
- table.indextable {
- display: block;
- width: auto;
- }
-
- .indextable tr {
- display: block;
- }
-
- .indextable td {
- display: block;
- padding: 0;
- width: auto !important;
- }
-
- .indextable td dt {
- margin: 1em 0;
- }
-
- ul.search {
- margin-left: 0.25em;
- }
-
- ul.search li div.context {
- font-size: 90%;
- line-height: 1.1;
- margin-bottom: 1;
- margin-left: 0;
- }
-
-}
\ No newline at end of file
diff --git a/doc_release/html/_static/searchtools.js b/doc_release/html/_static/searchtools.js
deleted file mode 100644
index 6e1f06b..0000000
--- a/doc_release/html/_static/searchtools.js
+++ /dev/null
@@ -1,622 +0,0 @@
-/*
- * searchtools.js_t
- * ~~~~~~~~~~~~~~~~
- *
- * Sphinx JavaScript utilties for the full-text search.
- *
- * :copyright: Copyright 2007-2014 by the Sphinx team, see AUTHORS.
- * :license: BSD, see LICENSE for details.
- *
- */
-
-
-/**
- * Porter Stemmer
- */
-var Stemmer = function() {
-
- var step2list = {
- ational: 'ate',
- tional: 'tion',
- enci: 'ence',
- anci: 'ance',
- izer: 'ize',
- bli: 'ble',
- alli: 'al',
- entli: 'ent',
- eli: 'e',
- ousli: 'ous',
- ization: 'ize',
- ation: 'ate',
- ator: 'ate',
- alism: 'al',
- iveness: 'ive',
- fulness: 'ful',
- ousness: 'ous',
- aliti: 'al',
- iviti: 'ive',
- biliti: 'ble',
- logi: 'log'
- };
-
- var step3list = {
- icate: 'ic',
- ative: '',
- alize: 'al',
- iciti: 'ic',
- ical: 'ic',
- ful: '',
- ness: ''
- };
-
- var c = "[^aeiou]"; // consonant
- var v = "[aeiouy]"; // vowel
- var C = c + "[^aeiouy]*"; // consonant sequence
- var V = v + "[aeiou]*"; // vowel sequence
-
- var mgr0 = "^(" + C + ")?" + V + C; // [C]VC... is m>0
- var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$"; // [C]VC[V] is m=1
- var mgr1 = "^(" + C + ")?" + V + C + V + C; // [C]VCVC... is m>1
- var s_v = "^(" + C + ")?" + v; // vowel in stem
-
- this.stemWord = function (w) {
- var stem;
- var suffix;
- var firstch;
- var origword = w;
-
- if (w.length < 3)
- return w;
-
- var re;
- var re2;
- var re3;
- var re4;
-
- firstch = w.substr(0,1);
- if (firstch == "y")
- w = firstch.toUpperCase() + w.substr(1);
-
- // Step 1a
- re = /^(.+?)(ss|i)es$/;
- re2 = /^(.+?)([^s])s$/;
-
- if (re.test(w))
- w = w.replace(re,"$1$2");
- else if (re2.test(w))
- w = w.replace(re2,"$1$2");
-
- // Step 1b
- re = /^(.+?)eed$/;
- re2 = /^(.+?)(ed|ing)$/;
- if (re.test(w)) {
- var fp = re.exec(w);
- re = new RegExp(mgr0);
- if (re.test(fp[1])) {
- re = /.$/;
- w = w.replace(re,"");
- }
- }
- else if (re2.test(w)) {
- var fp = re2.exec(w);
- stem = fp[1];
- re2 = new RegExp(s_v);
- if (re2.test(stem)) {
- w = stem;
- re2 = /(at|bl|iz)$/;
- re3 = new RegExp("([^aeiouylsz])\\1$");
- re4 = new RegExp("^" + C + v + "[^aeiouwxy]$");
- if (re2.test(w))
- w = w + "e";
- else if (re3.test(w)) {
- re = /.$/;
- w = w.replace(re,"");
- }
- else if (re4.test(w))
- w = w + "e";
- }
- }
-
- // Step 1c
- re = /^(.+?)y$/;
- if (re.test(w)) {
- var fp = re.exec(w);
- stem = fp[1];
- re = new RegExp(s_v);
- if (re.test(stem))
- w = stem + "i";
- }
-
- // Step 2
- re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/;
- if (re.test(w)) {
- var fp = re.exec(w);
- stem = fp[1];
- suffix = fp[2];
- re = new RegExp(mgr0);
- if (re.test(stem))
- w = stem + step2list[suffix];
- }
-
- // Step 3
- re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/;
- if (re.test(w)) {
- var fp = re.exec(w);
- stem = fp[1];
- suffix = fp[2];
- re = new RegExp(mgr0);
- if (re.test(stem))
- w = stem + step3list[suffix];
- }
-
- // Step 4
- re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/;
- re2 = /^(.+?)(s|t)(ion)$/;
- if (re.test(w)) {
- var fp = re.exec(w);
- stem = fp[1];
- re = new RegExp(mgr1);
- if (re.test(stem))
- w = stem;
- }
- else if (re2.test(w)) {
- var fp = re2.exec(w);
- stem = fp[1] + fp[2];
- re2 = new RegExp(mgr1);
- if (re2.test(stem))
- w = stem;
- }
-
- // Step 5
- re = /^(.+?)e$/;
- if (re.test(w)) {
- var fp = re.exec(w);
- stem = fp[1];
- re = new RegExp(mgr1);
- re2 = new RegExp(meq1);
- re3 = new RegExp("^" + C + v + "[^aeiouwxy]$");
- if (re.test(stem) || (re2.test(stem) && !(re3.test(stem))))
- w = stem;
- }
- re = /ll$/;
- re2 = new RegExp(mgr1);
- if (re.test(w) && re2.test(w)) {
- re = /.$/;
- w = w.replace(re,"");
- }
-
- // and turn initial Y back to y
- if (firstch == "y")
- w = firstch.toLowerCase() + w.substr(1);
- return w;
- }
-}
-
-
-
-/**
- * Simple result scoring code.
- */
-var Scorer = {
- // Implement the following function to further tweak the score for each result
- // The function takes a result array [filename, title, anchor, descr, score]
- // and returns the new score.
- /*
- score: function(result) {
- return result[4];
- },
- */
-
- // query matches the full name of an object
- objNameMatch: 11,
- // or matches in the last dotted part of the object name
- objPartialMatch: 6,
- // Additive scores depending on the priority of the object
- objPrio: {0: 15, // used to be importantResults
- 1: 5, // used to be objectResults
- 2: -5}, // used to be unimportantResults
- // Used when the priority is not in the mapping.
- objPrioDefault: 0,
-
- // query found in title
- title: 15,
- // query found in terms
- term: 5
-};
-
-
-/**
- * Search Module
- */
-var Search = {
-
- _index : null,
- _queued_query : null,
- _pulse_status : -1,
-
- init : function() {
- var params = $.getQueryParameters();
- if (params.q) {
- var query = params.q[0];
- $('input[name="q"]')[0].value = query;
- this.performSearch(query);
- }
- },
-
- loadIndex : function(url) {
- $.ajax({type: "GET", url: url, data: null,
- dataType: "script", cache: true,
- complete: function(jqxhr, textstatus) {
- if (textstatus != "success") {
- document.getElementById("searchindexloader").src = url;
- }
- }});
- },
-
- setIndex : function(index) {
- var q;
- this._index = index;
- if ((q = this._queued_query) !== null) {
- this._queued_query = null;
- Search.query(q);
- }
- },
-
- hasIndex : function() {
- return this._index !== null;
- },
-
- deferQuery : function(query) {
- this._queued_query = query;
- },
-
- stopPulse : function() {
- this._pulse_status = 0;
- },
-
- startPulse : function() {
- if (this._pulse_status >= 0)
- return;
- function pulse() {
- var i;
- Search._pulse_status = (Search._pulse_status + 1) % 4;
- var dotString = '';
- for (i = 0; i < Search._pulse_status; i++)
- dotString += '.';
- Search.dots.text(dotString);
- if (Search._pulse_status > -1)
- window.setTimeout(pulse, 500);
- }
- pulse();
- },
-
- /**
- * perform a search for something (or wait until index is loaded)
- */
- performSearch : function(query) {
- // create the required interface elements
- this.out = $('#search-results');
- this.title = $('<h2>' + _('Searching') + '</h2>').appendTo(this.out);
- this.dots = $('<span></span>').appendTo(this.title);
- this.status = $('<p style="display: none"></p>').appendTo(this.out);
- this.output = $('<ul class="search"/>').appendTo(this.out);
-
- $('#search-progress').text(_('Preparing search...'));
- this.startPulse();
-
- // index already loaded, the browser was quick!
- if (this.hasIndex())
- this.query(query);
- else
- this.deferQuery(query);
- },
-
- /**
- * execute search (requires search index to be loaded)
- */
- query : function(query) {
- var i;
- var stopwords = ["a","and","are","as","at","be","but","by","for","if","in","into","is","it","near","no","not","of","on","or","such","that","the","their","then","there","these","they","this","to","was","will","with"];
-
- // stem the searchterms and add them to the correct list
- var stemmer = new Stemmer();
- var searchterms = [];
- var excluded = [];
- var hlterms = [];
- var tmp = query.split(/\s+/);
- var objectterms = [];
- for (i = 0; i < tmp.length; i++) {
- if (tmp[i] !== "") {
- objectterms.push(tmp[i].toLowerCase());
- }
-
- if ($u.indexOf(stopwords, tmp[i].toLowerCase()) != -1 || tmp[i].match(/^\d+$/) ||
- tmp[i] === "") {
- // skip this "word"
- continue;
- }
- // stem the word
- var word = stemmer.stemWord(tmp[i].toLowerCase());
- var toAppend;
- // select the correct list
- if (word[0] == '-') {
- toAppend = excluded;
- word = word.substr(1);
- }
- else {
- toAppend = searchterms;
- hlterms.push(tmp[i].toLowerCase());
- }
- // only add if not already in the list
- if (!$u.contains(toAppend, word))
- toAppend.push(word);
- }
- var highlightstring = '?highlight=' + $.urlencode(hlterms.join(" "));
-
- // console.debug('SEARCH: searching for:');
- // console.info('required: ', searchterms);
- // console.info('excluded: ', excluded);
-
- // prepare search
- var terms = this._index.terms;
- var titleterms = this._index.titleterms;
-
- // array of [filename, title, anchor, descr, score]
- var results = [];
- $('#search-progress').empty();
-
- // lookup as object
- for (i = 0; i < objectterms.length; i++) {
- var others = [].concat(objectterms.slice(0, i),
- objectterms.slice(i+1, objectterms.length));
- results = results.concat(this.performObjectSearch(objectterms[i], others));
- }
-
- // lookup as search terms in fulltext
- results = results.concat(this.performTermsSearch(searchterms, excluded, terms, Scorer.term))
- .concat(this.performTermsSearch(searchterms, excluded, titleterms, Scorer.title));
-
- // let the scorer override scores with a custom scoring function
- if (Scorer.score) {
- for (i = 0; i < results.length; i++)
- results[i][4] = Scorer.score(results[i]);
- }
-
- // now sort the results by score (in opposite order of appearance, since the
- // display function below uses pop() to retrieve items) and then
- // alphabetically
- results.sort(function(a, b) {
- var left = a[4];
- var right = b[4];
- if (left > right) {
- return 1;
- } else if (left < right) {
- return -1;
- } else {
- // same score: sort alphabetically
- left = a[1].toLowerCase();
- right = b[1].toLowerCase();
- return (left > right) ? -1 : ((left < right) ? 1 : 0);
- }
- });
-
- // for debugging
- //Search.lastresults = results.slice(); // a copy
- //console.info('search results:', Search.lastresults);
-
- // print the results
- var resultCount = results.length;
- function displayNextItem() {
- // results left, load the summary and display it
- if (results.length) {
- var item = results.pop();
- var listItem = $('<li style="display:none"></li>');
- if (DOCUMENTATION_OPTIONS.FILE_SUFFIX === '') {
- // dirhtml builder
- var dirname = item[0] + '/';
- if (dirname.match(/\/index\/$/)) {
- dirname = dirname.substring(0, dirname.length-6);
- } else if (dirname == 'index/') {
- dirname = '';
- }
- listItem.append($('<a/>').attr('href',
- DOCUMENTATION_OPTIONS.URL_ROOT + dirname +
- highlightstring + item[2]).html(item[1]));
- } else {
- // normal html builders
- listItem.append($('<a/>').attr('href',
- item[0] + DOCUMENTATION_OPTIONS.FILE_SUFFIX +
- highlightstring + item[2]).html(item[1]));
- }
- if (item[3]) {
- listItem.append($('<span> (' + item[3] + ')</span>'));
- Search.output.append(listItem);
- listItem.slideDown(5, function() {
- displayNextItem();
- });
- } else if (DOCUMENTATION_OPTIONS.HAS_SOURCE) {
- $.ajax({url: DOCUMENTATION_OPTIONS.URL_ROOT + '_sources/' + item[0] + '.txt',
- dataType: "text",
- complete: function(jqxhr, textstatus) {
- var data = jqxhr.responseText;
- if (data !== '') {
- listItem.append(Search.makeSearchSummary(data, searchterms, hlterms));
- }
- Search.output.append(listItem);
- listItem.slideDown(5, function() {
- displayNextItem();
- });
- }});
- } else {
- // no source available, just display title
- Search.output.append(listItem);
- listItem.slideDown(5, function() {
- displayNextItem();
- });
- }
- }
- // search finished, update title and status message
- else {
- Search.stopPulse();
- Search.title.text(_('Search Results'));
- if (!resultCount)
- Search.status.text(_('Your search did not match any documents. Please make sure that all words are spelled correctly and that you\'ve selected enough categories.'));
- else
- Search.status.text(_('Search finished, found %s page(s) matching the search query.').replace('%s', resultCount));
- Search.status.fadeIn(500);
- }
- }
- displayNextItem();
- },
-
- /**
- * search for object names
- */
- performObjectSearch : function(object, otherterms) {
- var filenames = this._index.filenames;
- var objects = this._index.objects;
- var objnames = this._index.objnames;
- var titles = this._index.titles;
-
- var i;
- var results = [];
-
- for (var prefix in objects) {
- for (var name in objects[prefix]) {
- var fullname = (prefix ? prefix + '.' : '') + name;
- if (fullname.toLowerCase().indexOf(object) > -1) {
- var score = 0;
- var parts = fullname.split('.');
- // check for different match types: exact matches of full name or
- // "last name" (i.e. last dotted part)
- if (fullname == object || parts[parts.length - 1] == object) {
- score += Scorer.objNameMatch;
- // matches in last name
- } else if (parts[parts.length - 1].indexOf(object) > -1) {
- score += Scorer.objPartialMatch;
- }
- var match = objects[prefix][name];
- var objname = objnames[match[1]][2];
- var title = titles[match[0]];
- // If more than one term searched for, we require other words to be
- // found in the name/title/description
- if (otherterms.length > 0) {
- var haystack = (prefix + ' ' + name + ' ' +
- objname + ' ' + title).toLowerCase();
- var allfound = true;
- for (i = 0; i < otherterms.length; i++) {
- if (haystack.indexOf(otherterms[i]) == -1) {
- allfound = false;
- break;
- }
- }
- if (!allfound) {
- continue;
- }
- }
- var descr = objname + _(', in ') + title;
-
- var anchor = match[3];
- if (anchor === '')
- anchor = fullname;
- else if (anchor == '-')
- anchor = objnames[match[1]][1] + '-' + fullname;
- // add custom score for some objects according to scorer
- if (Scorer.objPrio.hasOwnProperty(match[2])) {
- score += Scorer.objPrio[match[2]];
- } else {
- score += Scorer.objPrioDefault;
- }
- results.push([filenames[match[0]], fullname, '#'+anchor, descr, score]);
- }
- }
- }
-
- return results;
- },
-
- /**
- * search for full-text terms in the index
- */
- performTermsSearch : function(searchterms, excluded, terms, score) {
- var filenames = this._index.filenames;
- var titles = this._index.titles;
-
- var i, j, file, files;
- var fileMap = {};
- var results = [];
-
- // perform the search on the required terms
- for (i = 0; i < searchterms.length; i++) {
- var word = searchterms[i];
- // no match but word was a required one
- if ((files = terms[word]) === undefined)
- break;
- if (files.length === undefined) {
- files = [files];
- }
- // create the mapping
- for (j = 0; j < files.length; j++) {
- file = files[j];
- if (file in fileMap)
- fileMap[file].push(word);
- else
- fileMap[file] = [word];
- }
- }
-
- // now check if the files don't contain excluded terms
- for (file in fileMap) {
- var valid = true;
-
- // check if all requirements are matched
- if (fileMap[file].length != searchterms.length)
- continue;
-
- // ensure that none of the excluded terms is in the search result
- for (i = 0; i < excluded.length; i++) {
- if (terms[excluded[i]] == file ||
- $u.contains(terms[excluded[i]] || [], file)) {
- valid = false;
- break;
- }
- }
-
- // if we have still a valid result we can add it to the result list
- if (valid) {
- results.push([filenames[file], titles[file], '', null, score]);
- }
- }
- return results;
- },
-
- /**
- * helper function to return a node containing the
- * search summary for a given text. keywords is a list
- * of stemmed words, hlwords is the list of normal, unstemmed
- * words. the first one is used to find the occurance, the
- * latter for highlighting it.
- */
- makeSearchSummary : function(text, keywords, hlwords) {
- var textLower = text.toLowerCase();
- var start = 0;
- $.each(keywords, function() {
- var i = textLower.indexOf(this.toLowerCase());
- if (i > -1)
- start = i;
- });
- start = Math.max(start - 120, 0);
- var excerpt = ((start > 0) ? '...' : '') +
- $.trim(text.substr(start, 240)) +
- ((start + 240 - text.length) ? '...' : '');
- var rv = $('<div class="context"></div>').text(excerpt);
- $.each(hlwords, function() {
- rv = rv.highlightText(this, 'highlighted');
- });
- return rv;
- }
-};
-
-$(document).ready(function() {
- Search.init();
-});
\ No newline at end of file
diff --git a/doc_release/html/_static/sidebar.js b/doc_release/html/_static/sidebar.js
deleted file mode 100644
index 4f09a0d..0000000
--- a/doc_release/html/_static/sidebar.js
+++ /dev/null
@@ -1,159 +0,0 @@
-/*
- * sidebar.js
- * ~~~~~~~~~~
- *
- * This script makes the Sphinx sidebar collapsible.
- *
- * .sphinxsidebar contains .sphinxsidebarwrapper. This script adds
- * in .sphixsidebar, after .sphinxsidebarwrapper, the #sidebarbutton
- * used to collapse and expand the sidebar.
- *
- * When the sidebar is collapsed the .sphinxsidebarwrapper is hidden
- * and the width of the sidebar and the margin-left of the document
- * are decreased. When the sidebar is expanded the opposite happens.
- * This script saves a per-browser/per-session cookie used to
- * remember the position of the sidebar among the pages.
- * Once the browser is closed the cookie is deleted and the position
- * reset to the default (expanded).
- *
- * :copyright: Copyright 2007-2014 by the Sphinx team, see AUTHORS.
- * :license: BSD, see LICENSE for details.
- *
- */
-
-$(function() {
-
-
-
-
-
-
-
-
- // global elements used by the functions.
- // the 'sidebarbutton' element is defined as global after its
- // creation, in the add_sidebar_button function
- var bodywrapper = $('.bodywrapper');
- var sidebar = $('.sphinxsidebar');
- var sidebarwrapper = $('.sphinxsidebarwrapper');
-
- // for some reason, the document has no sidebar; do not run into errors
- if (!sidebar.length) return;
-
- // original margin-left of the bodywrapper and width of the sidebar
- // with the sidebar expanded
- var bw_margin_expanded = bodywrapper.css('margin-left');
- var ssb_width_expanded = sidebar.width();
-
- // margin-left of the bodywrapper and width of the sidebar
- // with the sidebar collapsed
- var bw_margin_collapsed = '.8em';
- var ssb_width_collapsed = '.8em';
-
- // colors used by the current theme
- var dark_color = $('.related').css('background-color');
- var light_color = $('.document').css('background-color');
-
- function sidebar_is_collapsed() {
- return sidebarwrapper.is(':not(:visible)');
- }
-
- function toggle_sidebar() {
- if (sidebar_is_collapsed())
- expand_sidebar();
- else
- collapse_sidebar();
- }
-
- function collapse_sidebar() {
- sidebarwrapper.hide();
- sidebar.css('width', ssb_width_collapsed);
- bodywrapper.css('margin-left', bw_margin_collapsed);
- sidebarbutton.css({
- 'margin-left': '0',
- 'height': bodywrapper.height()
- });
- sidebarbutton.find('span').text('»');
- sidebarbutton.attr('title', _('Expand sidebar'));
- document.cookie = 'sidebar=collapsed';
- }
-
- function expand_sidebar() {
- bodywrapper.css('margin-left', bw_margin_expanded);
- sidebar.css('width', ssb_width_expanded);
- sidebarwrapper.show();
- sidebarbutton.css({
- 'margin-left': ssb_width_expanded-12,
- 'height': bodywrapper.height()
- });
- sidebarbutton.find('span').text('«');
- sidebarbutton.attr('title', _('Collapse sidebar'));
- document.cookie = 'sidebar=expanded';
- }
-
- function add_sidebar_button() {
- sidebarwrapper.css({
- 'float': 'left',
- 'margin-right': '0',
- 'width': ssb_width_expanded - 28
- });
- // create the button
- sidebar.append(
- '<div id="sidebarbutton"><span>«</span></div>'
- );
- var sidebarbutton = $('#sidebarbutton');
- light_color = sidebarbutton.css('background-color');
- // find the height of the viewport to center the '<<' in the page
- var viewport_height;
- if (window.innerHeight)
- viewport_height = window.innerHeight;
- else
- viewport_height = $(window).height();
- sidebarbutton.find('span').css({
- 'display': 'block',
- 'margin-top': (viewport_height - sidebar.position().top - 20) / 2
- });
-
- sidebarbutton.click(toggle_sidebar);
- sidebarbutton.attr('title', _('Collapse sidebar'));
- sidebarbutton.css({
- 'color': '#FFFFFF',
- 'border-left': '1px solid ' + dark_color,
- 'font-size': '1.2em',
- 'cursor': 'pointer',
- 'height': bodywrapper.height(),
- 'padding-top': '1px',
- 'margin-left': ssb_width_expanded - 12
- });
-
- sidebarbutton.hover(
- function () {
- $(this).css('background-color', dark_color);
- },
- function () {
- $(this).css('background-color', light_color);
- }
- );
- }
-
- function set_position_from_cookie() {
- if (!document.cookie)
- return;
- var items = document.cookie.split(';');
- for(var k=0; k<items.length; k++) {
- var key_val = items[k].split('=');
- var key = key_val[0].replace(/ /, ""); // strip leading spaces
- if (key == 'sidebar') {
- var value = key_val[1];
- if ((value == 'collapsed') && (!sidebar_is_collapsed()))
- collapse_sidebar();
- else if ((value == 'expanded') && (sidebar_is_collapsed()))
- expand_sidebar();
- }
- }
- }
-
- add_sidebar_button();
- var sidebarbutton = $('#sidebarbutton');
- set_position_from_cookie();
-});
\ No newline at end of file
diff --git a/doc_release/html/_static/underscore.js b/doc_release/html/_static/underscore.js
deleted file mode 100644
index 5b55f32..0000000
--- a/doc_release/html/_static/underscore.js
+++ /dev/null
@@ -1,31 +0,0 @@
-// Underscore.js 1.3.1
-// (c) 2009-2012 Jeremy Ashkenas, DocumentCloud Inc.
-// Underscore is freely distributable under the MIT license.
-// Portions of Underscore are inspired or borrowed from Prototype,
-// Oliver Steele's Functional, and John Resig's Micro-Templating.
-// For all details and documentation:
-// http://documentcloud.github.com/underscore
-(function(){function q(a,c,d){if(a===c)return a!==0||1/a==1/c;if(a==null||c==null)return a===c;if(a._chain)a=a._wrapped;if(c._chain)c=c._wrapped;if(a.isEqual&&b.isFunction(a.isEqual))return a.isEqual(c);if(c.isEqual&&b.isFunction(c.isEqual))return c.isEqual(a);var e=l.call(a);if(e!=l.call(c))return false;switch(e){case "[object String]":return a==String(c);case "[object Number]":return a!=+a?c!=+c:a==0?1/a==1/c:a==+c;case "[object Date]":case "[object Boolean]":return+a==+c;case "[object [...]
-c.source&&a.global==c.global&&a.multiline==c.multiline&&a.ignoreCase==c.ignoreCase}if(typeof a!="object"||typeof c!="object")return false;for(var f=d.length;f--;)if(d[f]==a)return true;d.push(a);var f=0,g=true;if(e=="[object Array]"){if(f=a.length,g=f==c.length)for(;f--;)if(!(g=f in a==f in c&&q(a[f],c[f],d)))break}else{if("constructor"in a!="constructor"in c||a.constructor!=c.constructor)return false;for(var h in a)if(b.has(a,h)&&(f++,!(g=b.has(c,h)&&q(a[h],c[h],d))))break;if(g){for(h i [...]
-h)&&!f--)break;g=!f}}d.pop();return g}var r=this,G=r._,n={},k=Array.prototype,o=Object.prototype,i=k.slice,H=k.unshift,l=o.toString,I=o.hasOwnProperty,w=k.forEach,x=k.map,y=k.reduce,z=k.reduceRight,A=k.filter,B=k.every,C=k.some,p=k.indexOf,D=k.lastIndexOf,o=Array.isArray,J=Object.keys,s=Function.prototype.bind,b=function(a){return new m(a)};if(typeof exports!=="undefined"){if(typeof module!=="undefined"&&module.exports)exports=module.exports=b;exports._=b}else r._=b;b.VERSION="1.3.1";var [...]
-b.forEach=function(a,c,d){if(a!=null)if(w&&a.forEach===w)a.forEach(c,d);else if(a.length===+a.length)for(var e=0,f=a.length;e<f;e++){if(e in a&&c.call(d,a[e],e,a)===n)break}else for(e in a)if(b.has(a,e)&&c.call(d,a[e],e,a)===n)break};b.map=b.collect=function(a,c,b){var e=[];if(a==null)return e;if(x&&a.map===x)return a.map(c,b);j(a,function(a,g,h){e[e.length]=c.call(b,a,g,h)});if(a.length===+a.length)e.length=a.length;return e};b.reduce=b.foldl=b.inject=function(a,c,d,e){var f=arguments.l [...]
-null&&(a=[]);if(y&&a.reduce===y)return e&&(c=b.bind(c,e)),f?a.reduce(c,d):a.reduce(c);j(a,function(a,b,i){f?d=c.call(e,d,a,b,i):(d=a,f=true)});if(!f)throw new TypeError("Reduce of empty array with no initial value");return d};b.reduceRight=b.foldr=function(a,c,d,e){var f=arguments.length>2;a==null&&(a=[]);if(z&&a.reduceRight===z)return e&&(c=b.bind(c,e)),f?a.reduceRight(c,d):a.reduceRight(c);var g=b.toArray(a).reverse();e&&!f&&(c=b.bind(c,e));return f?b.reduce(g,c,d,e):b.reduce(g,c)};b.f [...]
-function(a,c,b){var e;E(a,function(a,g,h){if(c.call(b,a,g,h))return e=a,true});return e};b.filter=b.select=function(a,c,b){var e=[];if(a==null)return e;if(A&&a.filter===A)return a.filter(c,b);j(a,function(a,g,h){c.call(b,a,g,h)&&(e[e.length]=a)});return e};b.reject=function(a,c,b){var e=[];if(a==null)return e;j(a,function(a,g,h){c.call(b,a,g,h)||(e[e.length]=a)});return e};b.every=b.all=function(a,c,b){var e=true;if(a==null)return e;if(B&&a.every===B)return a.every(c,b);j(a,function(a,g, [...]
-e&&c.call(b,a,g,h)))return n});return e};var E=b.some=b.any=function(a,c,d){c||(c=b.identity);var e=false;if(a==null)return e;if(C&&a.some===C)return a.some(c,d);j(a,function(a,b,h){if(e||(e=c.call(d,a,b,h)))return n});return!!e};b.include=b.contains=function(a,c){var b=false;if(a==null)return b;return p&&a.indexOf===p?a.indexOf(c)!=-1:b=E(a,function(a){return a===c})};b.invoke=function(a,c){var d=i.call(arguments,2);return b.map(a,function(a){return(b.isFunction(c)?c||a:a[c]).apply(a,d) [...]
-function(a,c){return b.map(a,function(a){return a[c]})};b.max=function(a,c,d){if(!c&&b.isArray(a))return Math.max.apply(Math,a);if(!c&&b.isEmpty(a))return-Infinity;var e={computed:-Infinity};j(a,function(a,b,h){b=c?c.call(d,a,b,h):a;b>=e.computed&&(e={value:a,computed:b})});return e.value};b.min=function(a,c,d){if(!c&&b.isArray(a))return Math.min.apply(Math,a);if(!c&&b.isEmpty(a))return Infinity;var e={computed:Infinity};j(a,function(a,b,h){b=c?c.call(d,a,b,h):a;b<e.computed&&(e={value:a [...]
-return e.value};b.shuffle=function(a){var b=[],d;j(a,function(a,f){f==0?b[0]=a:(d=Math.floor(Math.random()*(f+1)),b[f]=b[d],b[d]=a)});return b};b.sortBy=function(a,c,d){return b.pluck(b.map(a,function(a,b,g){return{value:a,criteria:c.call(d,a,b,g)}}).sort(function(a,b){var c=a.criteria,d=b.criteria;return c<d?-1:c>d?1:0}),"value")};b.groupBy=function(a,c){var d={},e=b.isFunction(c)?c:function(a){return a[c]};j(a,function(a,b){var c=e(a,b);(d[c]||(d[c]=[])).push(a)});return d};b.sortedInd [...]
-c,d){d||(d=b.identity);for(var e=0,f=a.length;e<f;){var g=e+f>>1;d(a[g])<d(c)?e=g+1:f=g}return e};b.toArray=function(a){return!a?[]:a.toArray?a.toArray():b.isArray(a)?i.call(a):b.isArguments(a)?i.call(a):b.values(a)};b.size=function(a){return b.toArray(a).length};b.first=b.head=function(a,b,d){return b!=null&&!d?i.call(a,0,b):a[0]};b.initial=function(a,b,d){return i.call(a,0,a.length-(b==null||d?1:b))};b.last=function(a,b,d){return b!=null&&!d?i.call(a,Math.max(a.length-b,0)):a[a.length- [...]
-b.tail=function(a,b,d){return i.call(a,b==null||d?1:b)};b.compact=function(a){return b.filter(a,function(a){return!!a})};b.flatten=function(a,c){return b.reduce(a,function(a,e){if(b.isArray(e))return a.concat(c?e:b.flatten(e));a[a.length]=e;return a},[])};b.without=function(a){return b.difference(a,i.call(arguments,1))};b.uniq=b.unique=function(a,c,d){var d=d?b.map(a,d):a,e=[];b.reduce(d,function(d,g,h){if(0==h||(c===true?b.last(d)!=g:!b.include(d,g)))d[d.length]=g,e[e.length]=a[h];retur [...]
-return e};b.union=function(){return b.uniq(b.flatten(arguments,true))};b.intersection=b.intersect=function(a){var c=i.call(arguments,1);return b.filter(b.uniq(a),function(a){return b.every(c,function(c){return b.indexOf(c,a)>=0})})};b.difference=function(a){var c=b.flatten(i.call(arguments,1));return b.filter(a,function(a){return!b.include(c,a)})};b.zip=function(){for(var a=i.call(arguments),c=b.max(b.pluck(a,"length")),d=Array(c),e=0;e<c;e++)d[e]=b.pluck(a,""+e);return d};b.indexOf=func [...]
-d){if(a==null)return-1;var e;if(d)return d=b.sortedIndex(a,c),a[d]===c?d:-1;if(p&&a.indexOf===p)return a.indexOf(c);for(d=0,e=a.length;d<e;d++)if(d in a&&a[d]===c)return d;return-1};b.lastIndexOf=function(a,b){if(a==null)return-1;if(D&&a.lastIndexOf===D)return a.lastIndexOf(b);for(var d=a.length;d--;)if(d in a&&a[d]===b)return d;return-1};b.range=function(a,b,d){arguments.length<=1&&(b=a||0,a=0);for(var d=arguments[2]||1,e=Math.max(Math.ceil((b-a)/d),0),f=0,g=Array(e);f<e;)g[f++]=a,a+=d; [...]
-var F=function(){};b.bind=function(a,c){var d,e;if(a.bind===s&&s)return s.apply(a,i.call(arguments,1));if(!b.isFunction(a))throw new TypeError;e=i.call(arguments,2);return d=function(){if(!(this instanceof d))return a.apply(c,e.concat(i.call(arguments)));F.prototype=a.prototype;var b=new F,g=a.apply(b,e.concat(i.call(arguments)));return Object(g)===g?g:b}};b.bindAll=function(a){var c=i.call(arguments,1);c.length==0&&(c=b.functions(a));j(c,function(c){a[c]=b.bind(a[c],a)});return a};b.mem [...]
-c){var d={};c||(c=b.identity);return function(){var e=c.apply(this,arguments);return b.has(d,e)?d[e]:d[e]=a.apply(this,arguments)}};b.delay=function(a,b){var d=i.call(arguments,2);return setTimeout(function(){return a.apply(a,d)},b)};b.defer=function(a){return b.delay.apply(b,[a,1].concat(i.call(arguments,1)))};b.throttle=function(a,c){var d,e,f,g,h,i=b.debounce(function(){h=g=false},c);return function(){d=this;e=arguments;var b;f||(f=setTimeout(function(){f=null;h&&a.apply(d,e);i()},c)) [...]
-a.apply(d,e);i();g=true}};b.debounce=function(a,b){var d;return function(){var e=this,f=arguments;clearTimeout(d);d=setTimeout(function(){d=null;a.apply(e,f)},b)}};b.once=function(a){var b=false,d;return function(){if(b)return d;b=true;return d=a.apply(this,arguments)}};b.wrap=function(a,b){return function(){var d=[a].concat(i.call(arguments,0));return b.apply(this,d)}};b.compose=function(){var a=arguments;return function(){for(var b=arguments,d=a.length-1;d>=0;d--)b=[a[d].apply(this,b)] [...]
-b.after=function(a,b){return a<=0?b():function(){if(--a<1)return b.apply(this,arguments)}};b.keys=J||function(a){if(a!==Object(a))throw new TypeError("Invalid object");var c=[],d;for(d in a)b.has(a,d)&&(c[c.length]=d);return c};b.values=function(a){return b.map(a,b.identity)};b.functions=b.methods=function(a){var c=[],d;for(d in a)b.isFunction(a[d])&&c.push(d);return c.sort()};b.extend=function(a){j(i.call(arguments,1),function(b){for(var d in b)a[d]=b[d]});return a};b.defaults=function( [...]
-1),function(b){for(var d in b)a[d]==null&&(a[d]=b[d])});return a};b.clone=function(a){return!b.isObject(a)?a:b.isArray(a)?a.slice():b.extend({},a)};b.tap=function(a,b){b(a);return a};b.isEqual=function(a,b){return q(a,b,[])};b.isEmpty=function(a){if(b.isArray(a)||b.isString(a))return a.length===0;for(var c in a)if(b.has(a,c))return false;return true};b.isElement=function(a){return!!(a&&a.nodeType==1)};b.isArray=o||function(a){return l.call(a)=="[object Array]"};b.isObject=function(a){ret [...]
-b.isArguments=function(a){return l.call(a)=="[object Arguments]"};if(!b.isArguments(arguments))b.isArguments=function(a){return!(!a||!b.has(a,"callee"))};b.isFunction=function(a){return l.call(a)=="[object Function]"};b.isString=function(a){return l.call(a)=="[object String]"};b.isNumber=function(a){return l.call(a)=="[object Number]"};b.isNaN=function(a){return a!==a};b.isBoolean=function(a){return a===true||a===false||l.call(a)=="[object Boolean]"};b.isDate=function(a){return l.call(a) [...]
-b.isRegExp=function(a){return l.call(a)=="[object RegExp]"};b.isNull=function(a){return a===null};b.isUndefined=function(a){return a===void 0};b.has=function(a,b){return I.call(a,b)};b.noConflict=function(){r._=G;return this};b.identity=function(a){return a};b.times=function(a,b,d){for(var e=0;e<a;e++)b.call(d,e)};b.escape=function(a){return(""+a).replace(/&/g,"&").replace(/</g,"<").replace(/>/g,">").replace(/"/g,""").replace(/'/g,"'").replace(/\//g,"/")};b.mixin [...]
-function(c){K(c,b[c]=a[c])})};var L=0;b.uniqueId=function(a){var b=L++;return a?a+b:b};b.templateSettings={evaluate:/<%([\s\S]+?)%>/g,interpolate:/<%=([\s\S]+?)%>/g,escape:/<%-([\s\S]+?)%>/g};var t=/.^/,u=function(a){return a.replace(/\\\\/g,"\\").replace(/\\'/g,"'")};b.template=function(a,c){var d=b.templateSettings,d="var __p=[],print=function(){__p.push.apply(__p,arguments);};with(obj||{}){__p.push('"+a.replace(/\\/g,"\\\\").replace(/'/g,"\\'").replace(d.escape||t,function(a,b){return [...]
-u(b)+"),'"}).replace(d.interpolate||t,function(a,b){return"',"+u(b)+",'"}).replace(d.evaluate||t,function(a,b){return"');"+u(b).replace(/[\r\n\t]/g," ")+";__p.push('"}).replace(/\r/g,"\\r").replace(/\n/g,"\\n").replace(/\t/g,"\\t")+"');}return __p.join('');",e=new Function("obj","_",d);return c?e(c,b):function(a){return e.call(this,a,b)}};b.chain=function(a){return b(a).chain()};var m=function(a){this._wrapped=a};b.prototype=m.prototype;var v=function(a,c){return c?b(a).chain():a},K=func [...]
-function(){var a=i.call(arguments);H.call(a,this._wrapped);return v(c.apply(b,a),this._chain)}};b.mixin(b);j("pop,push,reverse,shift,sort,splice,unshift".split(","),function(a){var b=k[a];m.prototype[a]=function(){var d=this._wrapped;b.apply(d,arguments);var e=d.length;(a=="shift"||a=="splice")&&e===0&&delete d[0];return v(d,this._chain)}});j(["concat","join","slice"],function(a){var b=k[a];m.prototype[a]=function(){return v(b.apply(this._wrapped,arguments),this._chain)}});m.prototype.ch [...]
-true;return this};m.prototype.value=function(){return this._wrapped}}).call(this);
diff --git a/doc_release/html/_static/up-pressed.png b/doc_release/html/_static/up-pressed.png
deleted file mode 100644
index 8bd587a..0000000
Binary files a/doc_release/html/_static/up-pressed.png and /dev/null differ
diff --git a/doc_release/html/_static/up.png b/doc_release/html/_static/up.png
deleted file mode 100644
index b946256..0000000
Binary files a/doc_release/html/_static/up.png and /dev/null differ
diff --git a/doc_release/html/_static/websupport.js b/doc_release/html/_static/websupport.js
deleted file mode 100644
index 71c0a13..0000000
--- a/doc_release/html/_static/websupport.js
+++ /dev/null
@@ -1,808 +0,0 @@
-/*
- * websupport.js
- * ~~~~~~~~~~~~~
- *
- * sphinx.websupport utilties for all documentation.
- *
- * :copyright: Copyright 2007-2014 by the Sphinx team, see AUTHORS.
- * :license: BSD, see LICENSE for details.
- *
- */
-
-(function($) {
- $.fn.autogrow = function() {
- return this.each(function() {
- var textarea = this;
-
- $.fn.autogrow.resize(textarea);
-
- $(textarea)
- .focus(function() {
- textarea.interval = setInterval(function() {
- $.fn.autogrow.resize(textarea);
- }, 500);
- })
- .blur(function() {
- clearInterval(textarea.interval);
- });
- });
- };
-
- $.fn.autogrow.resize = function(textarea) {
- var lineHeight = parseInt($(textarea).css('line-height'), 10);
- var lines = textarea.value.split('\n');
- var columns = textarea.cols;
- var lineCount = 0;
- $.each(lines, function() {
- lineCount += Math.ceil(this.length / columns) || 1;
- });
- var height = lineHeight * (lineCount + 1);
- $(textarea).css('height', height);
- };
-})(jQuery);
-
-(function($) {
- var comp, by;
-
- function init() {
- initEvents();
- initComparator();
- }
-
- function initEvents() {
- $('a.comment-close').live("click", function(event) {
- event.preventDefault();
- hide($(this).attr('id').substring(2));
- });
- $('a.vote').live("click", function(event) {
- event.preventDefault();
- handleVote($(this));
- });
- $('a.reply').live("click", function(event) {
- event.preventDefault();
- openReply($(this).attr('id').substring(2));
- });
- $('a.close-reply').live("click", function(event) {
- event.preventDefault();
- closeReply($(this).attr('id').substring(2));
- });
- $('a.sort-option').live("click", function(event) {
- event.preventDefault();
- handleReSort($(this));
- });
- $('a.show-proposal').live("click", function(event) {
- event.preventDefault();
- showProposal($(this).attr('id').substring(2));
- });
- $('a.hide-proposal').live("click", function(event) {
- event.preventDefault();
- hideProposal($(this).attr('id').substring(2));
- });
- $('a.show-propose-change').live("click", function(event) {
- event.preventDefault();
- showProposeChange($(this).attr('id').substring(2));
- });
- $('a.hide-propose-change').live("click", function(event) {
- event.preventDefault();
- hideProposeChange($(this).attr('id').substring(2));
- });
- $('a.accept-comment').live("click", function(event) {
- event.preventDefault();
- acceptComment($(this).attr('id').substring(2));
- });
- $('a.delete-comment').live("click", function(event) {
- event.preventDefault();
- deleteComment($(this).attr('id').substring(2));
- });
- $('a.comment-markup').live("click", function(event) {
- event.preventDefault();
- toggleCommentMarkupBox($(this).attr('id').substring(2));
- });
- }
-
- /**
- * Set comp, which is a comparator function used for sorting and
- * inserting comments into the list.
- */
- function setComparator() {
- // If the first three letters are "asc", sort in ascending order
- // and remove the prefix.
- if (by.substring(0,3) == 'asc') {
- var i = by.substring(3);
- comp = function(a, b) { return a[i] - b[i]; };
- } else {
- // Otherwise sort in descending order.
- comp = function(a, b) { return b[by] - a[by]; };
- }
-
- // Reset link styles and format the selected sort option.
- $('a.sel').attr('href', '#').removeClass('sel');
- $('a.by' + by).removeAttr('href').addClass('sel');
- }
-
- /**
- * Create a comp function. If the user has preferences stored in
- * the sortBy cookie, use those, otherwise use the default.
- */
- function initComparator() {
- by = 'rating'; // Default to sort by rating.
- // If the sortBy cookie is set, use that instead.
- if (document.cookie.length > 0) {
- var start = document.cookie.indexOf('sortBy=');
- if (start != -1) {
- start = start + 7;
- var end = document.cookie.indexOf(";", start);
- if (end == -1) {
- end = document.cookie.length;
- by = unescape(document.cookie.substring(start, end));
- }
- }
- }
- setComparator();
- }
-
- /**
- * Show a comment div.
- */
- function show(id) {
- $('#ao' + id).hide();
- $('#ah' + id).show();
- var context = $.extend({id: id}, opts);
- var popup = $(renderTemplate(popupTemplate, context)).hide();
- popup.find('textarea[name="proposal"]').hide();
- popup.find('a.by' + by).addClass('sel');
- var form = popup.find('#cf' + id);
- form.submit(function(event) {
- event.preventDefault();
- addComment(form);
- });
- $('#s' + id).after(popup);
- popup.slideDown('fast', function() {
- getComments(id);
- });
- }
-
- /**
- * Hide a comment div.
- */
- function hide(id) {
- $('#ah' + id).hide();
- $('#ao' + id).show();
- var div = $('#sc' + id);
- div.slideUp('fast', function() {
- div.remove();
- });
- }
-
- /**
- * Perform an ajax request to get comments for a node
- * and insert the comments into the comments tree.
- */
- function getComments(id) {
- $.ajax({
- type: 'GET',
- url: opts.getCommentsURL,
- data: {node: id},
- success: function(data, textStatus, request) {
- var ul = $('#cl' + id);
- var speed = 100;
- $('#cf' + id)
- .find('textarea[name="proposal"]')
- .data('source', data.source);
-
- if (data.comments.length === 0) {
- ul.html('<li>No comments yet.</li>');
- ul.data('empty', true);
- } else {
- // If there are comments, sort them and put them in the list.
- var comments = sortComments(data.comments);
- speed = data.comments.length * 100;
- appendComments(comments, ul);
- ul.data('empty', false);
- }
- $('#cn' + id).slideUp(speed + 200);
- ul.slideDown(speed);
- },
- error: function(request, textStatus, error) {
- showError('Oops, there was a problem retrieving the comments.');
- },
- dataType: 'json'
- });
- }
-
- /**
- * Add a comment via ajax and insert the comment into the comment tree.
- */
- function addComment(form) {
- var node_id = form.find('input[name="node"]').val();
- var parent_id = form.find('input[name="parent"]').val();
- var text = form.find('textarea[name="comment"]').val();
- var proposal = form.find('textarea[name="proposal"]').val();
-
- if (text == '') {
- showError('Please enter a comment.');
- return;
- }
-
- // Disable the form that is being submitted.
- form.find('textarea,input').attr('disabled', 'disabled');
-
- // Send the comment to the server.
- $.ajax({
- type: "POST",
- url: opts.addCommentURL,
- dataType: 'json',
- data: {
- node: node_id,
- parent: parent_id,
- text: text,
- proposal: proposal
- },
- success: function(data, textStatus, error) {
- // Reset the form.
- if (node_id) {
- hideProposeChange(node_id);
- }
- form.find('textarea')
- .val('')
- .add(form.find('input'))
- .removeAttr('disabled');
- var ul = $('#cl' + (node_id || parent_id));
- if (ul.data('empty')) {
- $(ul).empty();
- ul.data('empty', false);
- }
- insertComment(data.comment);
- var ao = $('#ao' + node_id);
- ao.find('img').attr({'src': opts.commentBrightImage});
- if (node_id) {
- // if this was a "root" comment, remove the commenting box
- // (the user can get it back by reopening the comment popup)
- $('#ca' + node_id).slideUp();
- }
- },
- error: function(request, textStatus, error) {
- form.find('textarea,input').removeAttr('disabled');
- showError('Oops, there was a problem adding the comment.');
- }
- });
- }
-
- /**
- * Recursively append comments to the main comment list and children
- * lists, creating the comment tree.
- */
- function appendComments(comments, ul) {
- $.each(comments, function() {
- var div = createCommentDiv(this);
- ul.append($(document.createElement('li')).html(div));
- appendComments(this.children, div.find('ul.comment-children'));
- // To avoid stagnating data, don't store the comments children in data.
- this.children = null;
- div.data('comment', this);
- });
- }
-
- /**
- * After adding a new comment, it must be inserted in the correct
- * location in the comment tree.
- */
- function insertComment(comment) {
- var div = createCommentDiv(comment);
-
- // To avoid stagnating data, don't store the comments children in data.
- comment.children = null;
- div.data('comment', comment);
-
- var ul = $('#cl' + (comment.node || comment.parent));
- var siblings = getChildren(ul);
-
- var li = $(document.createElement('li'));
- li.hide();
-
- // Determine where in the parents children list to insert this comment.
- for(i=0; i < siblings.length; i++) {
- if (comp(comment, siblings[i]) <= 0) {
- $('#cd' + siblings[i].id)
- .parent()
- .before(li.html(div));
- li.slideDown('fast');
- return;
- }
- }
-
- // If we get here, this comment rates lower than all the others,
- // or it is the only comment in the list.
- ul.append(li.html(div));
- li.slideDown('fast');
- }
-
- function acceptComment(id) {
- $.ajax({
- type: 'POST',
- url: opts.acceptCommentURL,
- data: {id: id},
- success: function(data, textStatus, request) {
- $('#cm' + id).fadeOut('fast');
- $('#cd' + id).removeClass('moderate');
- },
- error: function(request, textStatus, error) {
- showError('Oops, there was a problem accepting the comment.');
- }
- });
- }
-
- function deleteComment(id) {
- $.ajax({
- type: 'POST',
- url: opts.deleteCommentURL,
- data: {id: id},
- success: function(data, textStatus, request) {
- var div = $('#cd' + id);
- if (data == 'delete') {
- // Moderator mode: remove the comment and all children immediately
- div.slideUp('fast', function() {
- div.remove();
- });
- return;
- }
- // User mode: only mark the comment as deleted
- div
- .find('span.user-id:first')
- .text('[deleted]').end()
- .find('div.comment-text:first')
- .text('[deleted]').end()
- .find('#cm' + id + ', #dc' + id + ', #ac' + id + ', #rc' + id +
- ', #sp' + id + ', #hp' + id + ', #cr' + id + ', #rl' + id)
- .remove();
- var comment = div.data('comment');
- comment.username = '[deleted]';
- comment.text = '[deleted]';
- div.data('comment', comment);
- },
- error: function(request, textStatus, error) {
- showError('Oops, there was a problem deleting the comment.');
- }
- });
- }
-
- function showProposal(id) {
- $('#sp' + id).hide();
- $('#hp' + id).show();
- $('#pr' + id).slideDown('fast');
- }
-
- function hideProposal(id) {
- $('#hp' + id).hide();
- $('#sp' + id).show();
- $('#pr' + id).slideUp('fast');
- }
-
- function showProposeChange(id) {
- $('#pc' + id).hide();
- $('#hc' + id).show();
- var textarea = $('#pt' + id);
- textarea.val(textarea.data('source'));
- $.fn.autogrow.resize(textarea[0]);
- textarea.slideDown('fast');
- }
-
- function hideProposeChange(id) {
- $('#hc' + id).hide();
- $('#pc' + id).show();
- var textarea = $('#pt' + id);
- textarea.val('').removeAttr('disabled');
- textarea.slideUp('fast');
- }
-
- function toggleCommentMarkupBox(id) {
- $('#mb' + id).toggle();
- }
-
- /** Handle when the user clicks on a sort by link. */
- function handleReSort(link) {
- var classes = link.attr('class').split(/\s+/);
- for (var i=0; i<classes.length; i++) {
- if (classes[i] != 'sort-option') {
- by = classes[i].substring(2);
- }
- }
- setComparator();
- // Save/update the sortBy cookie.
- var expiration = new Date();
- expiration.setDate(expiration.getDate() + 365);
- document.cookie= 'sortBy=' + escape(by) +
- ';expires=' + expiration.toUTCString();
- $('ul.comment-ul').each(function(index, ul) {
- var comments = getChildren($(ul), true);
- comments = sortComments(comments);
- appendComments(comments, $(ul).empty());
- });
- }
-
- /**
- * Function to process a vote when a user clicks an arrow.
- */
- function handleVote(link) {
- if (!opts.voting) {
- showError("You'll need to login to vote.");
- return;
- }
-
- var id = link.attr('id');
- if (!id) {
- // Didn't click on one of the voting arrows.
- return;
- }
- // If it is an unvote, the new vote value is 0,
- // Otherwise it's 1 for an upvote, or -1 for a downvote.
- var value = 0;
- if (id.charAt(1) != 'u') {
- value = id.charAt(0) == 'u' ? 1 : -1;
- }
- // The data to be sent to the server.
- var d = {
- comment_id: id.substring(2),
- value: value
- };
-
- // Swap the vote and unvote links.
- link.hide();
- $('#' + id.charAt(0) + (id.charAt(1) == 'u' ? 'v' : 'u') + d.comment_id)
- .show();
-
- // The div the comment is displayed in.
- var div = $('div#cd' + d.comment_id);
- var data = div.data('comment');
-
- // If this is not an unvote, and the other vote arrow has
- // already been pressed, unpress it.
- if ((d.value !== 0) && (data.vote === d.value * -1)) {
- $('#' + (d.value == 1 ? 'd' : 'u') + 'u' + d.comment_id).hide();
- $('#' + (d.value == 1 ? 'd' : 'u') + 'v' + d.comment_id).show();
- }
-
- // Update the comments rating in the local data.
- data.rating += (data.vote === 0) ? d.value : (d.value - data.vote);
- data.vote = d.value;
- div.data('comment', data);
-
- // Change the rating text.
- div.find('.rating:first')
- .text(data.rating + ' point' + (data.rating == 1 ? '' : 's'));
-
- // Send the vote information to the server.
- $.ajax({
- type: "POST",
- url: opts.processVoteURL,
- data: d,
- error: function(request, textStatus, error) {
- showError('Oops, there was a problem casting that vote.');
- }
- });
- }
-
- /**
- * Open a reply form used to reply to an existing comment.
- */
- function openReply(id) {
- // Swap out the reply link for the hide link
- $('#rl' + id).hide();
- $('#cr' + id).show();
-
- // Add the reply li to the children ul.
- var div = $(renderTemplate(replyTemplate, {id: id})).hide();
- $('#cl' + id)
- .prepend(div)
- // Setup the submit handler for the reply form.
- .find('#rf' + id)
- .submit(function(event) {
- event.preventDefault();
- addComment($('#rf' + id));
- closeReply(id);
- })
- .find('input[type=button]')
- .click(function() {
- closeReply(id);
- });
- div.slideDown('fast', function() {
- $('#rf' + id).find('textarea').focus();
- });
- }
-
- /**
- * Close the reply form opened with openReply.
- */
- function closeReply(id) {
- // Remove the reply div from the DOM.
- $('#rd' + id).slideUp('fast', function() {
- $(this).remove();
- });
-
- // Swap out the hide link for the reply link
- $('#cr' + id).hide();
- $('#rl' + id).show();
- }
-
- /**
- * Recursively sort a tree of comments using the comp comparator.
- */
- function sortComments(comments) {
- comments.sort(comp);
- $.each(comments, function() {
- this.children = sortComments(this.children);
- });
- return comments;
- }
-
- /**
- * Get the children comments from a ul. If recursive is true,
- * recursively include childrens' children.
- */
- function getChildren(ul, recursive) {
- var children = [];
- ul.children().children("[id^='cd']")
- .each(function() {
- var comment = $(this).data('comment');
- if (recursive)
- comment.children = getChildren($(this).find('#cl' + comment.id), true);
- children.push(comment);
- });
- return children;
- }
-
- /** Create a div to display a comment in. */
- function createCommentDiv(comment) {
- if (!comment.displayed && !opts.moderator) {
- return $('<div class="moderate">Thank you! Your comment will show up '
- + 'once it is has been approved by a moderator.</div>');
- }
- // Prettify the comment rating.
- comment.pretty_rating = comment.rating + ' point' +
- (comment.rating == 1 ? '' : 's');
- // Make a class (for displaying not yet moderated comments differently)
- comment.css_class = comment.displayed ? '' : ' moderate';
- // Create a div for this comment.
- var context = $.extend({}, opts, comment);
- var div = $(renderTemplate(commentTemplate, context));
-
- // If the user has voted on this comment, highlight the correct arrow.
- if (comment.vote) {
- var direction = (comment.vote == 1) ? 'u' : 'd';
- div.find('#' + direction + 'v' + comment.id).hide();
- div.find('#' + direction + 'u' + comment.id).show();
- }
-
- if (opts.moderator || comment.text != '[deleted]') {
- div.find('a.reply').show();
- if (comment.proposal_diff)
- div.find('#sp' + comment.id).show();
- if (opts.moderator && !comment.displayed)
- div.find('#cm' + comment.id).show();
- if (opts.moderator || (opts.username == comment.username))
- div.find('#dc' + comment.id).show();
- }
- return div;
- }
-
- /**
- * A simple template renderer. Placeholders such as <%id%> are replaced
- * by context['id'] with items being escaped. Placeholders such as <#id#>
- * are not escaped.
- */
- function renderTemplate(template, context) {
- var esc = $(document.createElement('div'));
-
- function handle(ph, escape) {
- var cur = context;
- $.each(ph.split('.'), function() {
- cur = cur[this];
- });
- return escape ? esc.text(cur || "").html() : cur;
- }
-
- return template.replace(/<([%#])([\w\.]*)\1>/g, function() {
- return handle(arguments[2], arguments[1] == '%' ? true : false);
- });
- }
-
- /** Flash an error message briefly. */
- function showError(message) {
- $(document.createElement('div')).attr({'class': 'popup-error'})
- .append($(document.createElement('div'))
- .attr({'class': 'error-message'}).text(message))
- .appendTo('body')
- .fadeIn("slow")
- .delay(2000)
- .fadeOut("slow");
- }
-
- /** Add a link the user uses to open the comments popup. */
- $.fn.comment = function() {
- return this.each(function() {
- var id = $(this).attr('id').substring(1);
- var count = COMMENT_METADATA[id];
- var title = count + ' comment' + (count == 1 ? '' : 's');
- var image = count > 0 ? opts.commentBrightImage : opts.commentImage;
- var addcls = count == 0 ? ' nocomment' : '';
- $(this)
- .append(
- $(document.createElement('a')).attr({
- href: '#',
- 'class': 'sphinx-comment-open' + addcls,
- id: 'ao' + id
- })
- .append($(document.createElement('img')).attr({
- src: image,
- alt: 'comment',
- title: title
- }))
- .click(function(event) {
- event.preventDefault();
- show($(this).attr('id').substring(2));
- })
- )
- .append(
- $(document.createElement('a')).attr({
- href: '#',
- 'class': 'sphinx-comment-close hidden',
- id: 'ah' + id
- })
- .append($(document.createElement('img')).attr({
- src: opts.closeCommentImage,
- alt: 'close',
- title: 'close'
- }))
- .click(function(event) {
- event.preventDefault();
- hide($(this).attr('id').substring(2));
- })
- );
- });
- };
-
- var opts = {
- processVoteURL: '/_process_vote',
- addCommentURL: '/_add_comment',
- getCommentsURL: '/_get_comments',
- acceptCommentURL: '/_accept_comment',
- deleteCommentURL: '/_delete_comment',
- commentImage: '/static/_static/comment.png',
- closeCommentImage: '/static/_static/comment-close.png',
- loadingImage: '/static/_static/ajax-loader.gif',
- commentBrightImage: '/static/_static/comment-bright.png',
- upArrow: '/static/_static/up.png',
- downArrow: '/static/_static/down.png',
- upArrowPressed: '/static/_static/up-pressed.png',
- downArrowPressed: '/static/_static/down-pressed.png',
- voting: false,
- moderator: false
- };
-
- if (typeof COMMENT_OPTIONS != "undefined") {
- opts = jQuery.extend(opts, COMMENT_OPTIONS);
- }
-
- var popupTemplate = '\
- <div class="sphinx-comments" id="sc<%id%>">\
- <p class="sort-options">\
- Sort by:\
- <a href="#" class="sort-option byrating">best rated</a>\
- <a href="#" class="sort-option byascage">newest</a>\
- <a href="#" class="sort-option byage">oldest</a>\
- </p>\
- <div class="comment-header">Comments</div>\
- <div class="comment-loading" id="cn<%id%>">\
- loading comments... <img src="<%loadingImage%>" alt="" /></div>\
- <ul id="cl<%id%>" class="comment-ul"></ul>\
- <div id="ca<%id%>">\
- <p class="add-a-comment">Add a comment\
- (<a href="#" class="comment-markup" id="ab<%id%>">markup</a>):</p>\
- <div class="comment-markup-box" id="mb<%id%>">\
- reStructured text markup: <i>*emph*</i>, <b>**strong**</b>, \
- <tt>``code``</tt>, \
- code blocks: <tt>::</tt> and an indented block after blank line</div>\
- <form method="post" id="cf<%id%>" class="comment-form" action="">\
- <textarea name="comment" cols="80"></textarea>\
- <p class="propose-button">\
- <a href="#" id="pc<%id%>" class="show-propose-change">\
- Propose a change ▹\
- </a>\
- <a href="#" id="hc<%id%>" class="hide-propose-change">\
- Propose a change ▿\
- </a>\
- </p>\
- <textarea name="proposal" id="pt<%id%>" cols="80"\
- spellcheck="false"></textarea>\
- <input type="submit" value="Add comment" />\
- <input type="hidden" name="node" value="<%id%>" />\
- <input type="hidden" name="parent" value="" />\
- </form>\
- </div>\
- </div>';
-
- var commentTemplate = '\
- <div id="cd<%id%>" class="sphinx-comment<%css_class%>">\
- <div class="vote">\
- <div class="arrow">\
- <a href="#" id="uv<%id%>" class="vote" title="vote up">\
- <img src="<%upArrow%>" />\
- </a>\
- <a href="#" id="uu<%id%>" class="un vote" title="vote up">\
- <img src="<%upArrowPressed%>" />\
- </a>\
- </div>\
- <div class="arrow">\
- <a href="#" id="dv<%id%>" class="vote" title="vote down">\
- <img src="<%downArrow%>" id="da<%id%>" />\
- </a>\
- <a href="#" id="du<%id%>" class="un vote" title="vote down">\
- <img src="<%downArrowPressed%>" />\
- </a>\
- </div>\
- </div>\
- <div class="comment-content">\
- <p class="tagline comment">\
- <span class="user-id"><%username%></span>\
- <span class="rating"><%pretty_rating%></span>\
- <span class="delta"><%time.delta%></span>\
- </p>\
- <div class="comment-text comment"><#text#></div>\
- <p class="comment-opts comment">\
- <a href="#" class="reply hidden" id="rl<%id%>">reply ▹</a>\
- <a href="#" class="close-reply" id="cr<%id%>">reply ▿</a>\
- <a href="#" id="sp<%id%>" class="show-proposal">proposal ▹</a>\
- <a href="#" id="hp<%id%>" class="hide-proposal">proposal ▿</a>\
- <a href="#" id="dc<%id%>" class="delete-comment hidden">delete</a>\
- <span id="cm<%id%>" class="moderation hidden">\
- <a href="#" id="ac<%id%>" class="accept-comment">accept</a>\
- </span>\
- </p>\
- <pre class="proposal" id="pr<%id%>">\
-<#proposal_diff#>\
- </pre>\
- <ul class="comment-children" id="cl<%id%>"></ul>\
- </div>\
- <div class="clearleft"></div>\
- </div>\
- </div>';
-
- var replyTemplate = '\
- <li>\
- <div class="reply-div" id="rd<%id%>">\
- <form id="rf<%id%>">\
- <textarea name="comment" cols="80"></textarea>\
- <input type="submit" value="Add reply" />\
- <input type="button" value="Cancel" />\
- <input type="hidden" name="parent" value="<%id%>" />\
- <input type="hidden" name="node" value="" />\
- </form>\
- </div>\
- </li>';
-
- $(document).ready(function() {
- init();
- });
-})(jQuery);
-
-$(document).ready(function() {
- // add comment anchors for all paragraphs that are commentable
- $('.sphinx-has-comment').comment();
-
- // highlight search words in search results
- $("div.context").each(function() {
- var params = $.getQueryParameters();
- var terms = (params.q) ? params.q[0].split(/\s+/) : [];
- var result = $(this);
- $.each(terms, function() {
- result.highlightText(this.toLowerCase(), 'highlighted');
- });
- });
-
- // directly open comment window if requested
- var anchor = document.location.hash;
- if (anchor.substring(0, 9) == '#comment-') {
- $('#ao' + anchor.substring(9)).click();
- document.location.hash = '#s' + anchor.substring(9);
- }
-});
diff --git a/doc_release/html/api.html b/doc_release/html/api.html
deleted file mode 100644
index 970afad..0000000
--- a/doc_release/html/api.html
+++ /dev/null
@@ -1,148 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>GMT_API — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="next" title="1. Introduction" href="GMT_API.html" />
- <link rel="prev" title="1. Acknowledgments" href="GMT_Docs.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="GMT_API.html" title="1. Introduction"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="GMT_Docs.html" title="1. Acknowledgments"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gmt-api">
-<h1>GMT_API<a class="headerlink" href="#gmt-api" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="GMT_API.html">1. Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_API.html#overview-of-the-gmt-c-application-program-interface">2. Overview of the GMT C Application Program Interface</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_API.html#the-gmt-c-application-program-interface">3. The GMT C Application Program Interface</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_API.html#the-gmt-fft-interface">4. The GMT FFT Interface</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_API.html#fortran-interfaces">5. FORTRAN interfaces</a></li>
-</ul>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="GMT_Docs.html"
- title="previous chapter">1. Acknowledgments</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="GMT_API.html"
- title="next chapter">1. Introduction</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/api.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="GMT_API.html" title="1. Introduction"
- >next</a> </li>
- <li class="right" >
- <a href="GMT_Docs.html" title="1. Acknowledgments"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/blockmean.html b/doc_release/html/blockmean.html
deleted file mode 100644
index 68ee063..0000000
--- a/doc_release/html/blockmean.html
+++ /dev/null
@@ -1,336 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>blockmean — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="B" href="B.html" />
- <link rel="next" title="blockmedian" href="blockmedian.html" />
- <link rel="prev" title="B" href="B.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="blockmedian.html" title="blockmedian"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="B.html" title="B"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="B.html" accesskey="U">B</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="blockmean">
-<span id="index-0"></span><h1>blockmean<a class="headerlink" href="#blockmean" title="Permalink to this headline">¶</a></h1>
-<p>blockmean - Block average (<em>x</em>,<em>y</em>,<em>z</em>) data tables by L2 norm</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>blockmean</strong> [ <em>table</em> ]
-<strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]
-<strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>]
-[ <strong>-C</strong> ]
-[ <strong>-E</strong>[<strong>p</strong>] ] [ <strong>-S</strong>[<strong>m</strong>|<strong>n</strong>|<strong>s</strong>|<strong>w</strong>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W</strong>[<strong>i</strong>|<strong>o</strong>] ]
-[ <strong>-b</strong>[<strong>i</strong>|<strong>o</strong>][<em>ncol</em>][<strong>type</strong>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-o</strong><em>cols</em>[,...] ]
-[ <strong>-r</strong> ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>blockmean</strong> reads arbitrarily located (<em>x</em>,<em>y</em>,<em>z</em>) triples [or
-optionally weighted quadruples (<em>x</em>,<em>y</em>,<em>z</em>,<em>w</em>)] from standard
-input [or <em>table</em>] and writes to standard output a mean position and
-value for every non-empty block in a grid region defined by the <strong>-R</strong>
-and <strong>-I</strong> arguments. Either <strong>blockmean</strong>, <a class="reference internal" href="blockmedian.html"><em>blockmedian</em></a>, or
-<a class="reference internal" href="blockmode.html"><em>blockmode</em></a> should be used as a pre-processor before running
-<a class="reference internal" href="surface.html"><em>surface</em></a> to avoid aliasing short wavelengths. These routines are also
-generally useful for decimating or averaging (<em>x</em>,<em>y</em>,<em>z</em>) data. You
-can modify the precision of the output format by editing the
-<a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> parameter in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file, or you may
-choose binary input and/or output to avoid loss of precision.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]</dt>
-<dd><em>x_inc</em> [and optionally <em>y_inc</em>] is the grid spacing. Optionally,
-append a suffix modifier. <strong>Geographical (degrees) coordinates</strong>: Append
-<strong>m</strong> to indicate arc minutes or <strong>s</strong> to indicate arc seconds. If one
-of the units <strong>e</strong>, <strong>f</strong>, <strong>k</strong>, <strong>M</strong>, <strong>n</strong> or <strong>u</strong> is appended
-instead, the increment is assumed to be given in meter, foot, km, Mile,
-nautical mile or US survey foot, respectively, and will be converted to
-the equivalent degrees longitude at the middle latitude of the region
-(the conversion depends on <a class="reference internal" href="gmt.conf.html#projection-parameters"><em>PROJ_ELLIPSOID</em></a>). If /<em>y_inc</em> is given
-but set to 0 it will be reset equal to <em>x_inc</em>; otherwise it will be
-converted to degrees latitude. <strong>All coordinates</strong>: If <strong>=</strong> is appended
-then the corresponding max <em>x</em> (<em>east</em>) or <em>y</em> (<em>north</em>) may be slightly
-adjusted to fit exactly the given increment [by default the increment
-may be adjusted slightly to fit the given domain]. Finally, instead of
-giving an increment you may specify the <em>number of nodes</em> desired by
-appending <strong>+</strong> to the supplied integer argument; the increment is then
-recalculated from the number of nodes and the domain. The resulting
-increment value depends on whether you have selected a
-gridline-registered or pixel-registered grid; see <a class="reference internal" href="GMT_Docs.html#app-file-formats"><em>B. GMT File Formats</em></a> for
-details. Note: if <strong>-R</strong><em>grdfile</em> is used then the grid spacing has
-already been initialized; use <strong>-I</strong> to override the values.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>3 [or 4, see <strong>-W</strong>] column ASCII data table file(s) [or binary, see
-<strong>-bi</strong>] holding (<em>x</em>,<em>y</em>,<em>z</em>[,<em>w</em>])
-data values. [<em>w</em>] is an optional weight for the data. If no file
-is specified, <strong>blockmean</strong> will read from standard input.</dd>
-<dt><strong>-C</strong></dt>
-<dd>Use the center of the block as the output location [Default uses the mean location].</dd>
-<dt><strong>-E</strong>[<strong>p</strong>]</dt>
-<dd>Provide Extended report which includes <strong>s</strong> (the standard deviation
-about the mean), <strong>l</strong>, the lowest value, and <strong>h</strong>, the high value
-for each block. Output order becomes
-<em>x</em>,<em>y</em>,<em>z</em>,<em>s</em>,<em>l</em>,<em>h</em>[,<em>w</em>]. [Default outputs
-<em>x</em>,<em>y</em>,<em>z</em>[,<em>w</em>]. See <strong>-W</strong> for <em>w</em> output.
-If <strong>-Ep</strong> is used we assume weights are 1/(sigma squared) and <em>s</em>
-becomes the propagated error of the mean.</dd>
-<dt><strong>-S</strong>[<strong>m</strong>|<strong>n</strong>|<strong>s</strong>|<strong>w</strong>]</dt>
-<dd>Use <strong>-Sn</strong> to report the number of points inside each block,
-<strong>-Ss</strong> to report the sum of all <em>z</em>-values inside a block, <strong>-Sw</strong>
-to report the sum of weights [Default (or <strong>-Sm</strong> reports mean value].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong>[<strong>i</strong>|<strong>o</strong>]</dt>
-<dd>Weighted modifier[s]. Unweighted input and output has 3 columns
-<em>x</em>,<em>y</em>,<em>z</em>; Weighted i/o has 4 columns <em>x</em>,<em>y</em>,<em>z</em>,<em>w</em>.
-Weights can be used in input to construct weighted mean values in
-blocks. Weight sums can be reported in output for later combining
-several runs, etc. Use <strong>-W</strong> for weighted i/o, <strong>-Wi</strong> for weighted
-input only, <strong>-Wo</strong> for weighted output only. [Default uses
-unweighted i/o].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 3 (or 4 if <strong>-Wi</strong> is set)].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. [Default is 3 (or 4 if <strong>-Wo</strong> is set)]. <strong>-E</strong> adds 3 additional columns.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-o</strong><em>cols</em>[,...] <a class="reference internal" href="gmt.html#ocols-full"><em>(more ...)</em></a></dt>
-<dd>Select output columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-r</strong> <a class="reference internal" href="gmt.html#nodereg-full"><em>(more ...)</em></a></dt>
-<dd>Set pixel node registration [gridline]. Each block is the locus of points nearest the grid value location. For example, with
-<strong>-R</strong>10/15/10/15 and <strong>-I</strong>1: with the <strong>-r</strong> option 10 <=
-(<em>x</em>,<em>y</em>) < 11 is one of 25 blocks; without it 9.5 <= (<em>x</em>,<em>y</em>)
-< 10.5 is one of 36 blocks.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="ascii-format-precision">
-<h2>Ascii Format Precision<a class="headerlink" href="#ascii-format-precision" title="Permalink to this headline">¶</a></h2>
-<p>The ASCII output formats of numerical data are controlled by parameters
-in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file. Longitude and latitude are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>, whereas other values are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>. Be aware that the format in effect
-can lead to loss of precision in the output, which can lead to various
-problems downstream. If you find the output is not written with enough
-precision, consider switching to binary output (<strong>-bo</strong> if available) or
-specify more decimals using the <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> setting.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To find 5 by 5 minute block mean values from the ASCII data in hawaii.xyg, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt blockmean hawaii.xyg -R198/208/18/25 -I5m > hawaii_5x5.xyg
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="blockmedian.html"><em>blockmedian</em></a>,
-<a class="reference internal" href="blockmode.html"><em>blockmode</em></a>,
-<a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>,
-<a class="reference internal" href="greenspline.html"><em>greenspline</em></a>,
-<a class="reference internal" href="nearneighbor.html"><em>nearneighbor</em></a>,
-<a class="reference internal" href="sphtriangulate.html"><em>sphtriangulate</em></a>,
-<a class="reference internal" href="surface.html"><em>surface</em></a>,
-<a class="reference internal" href="triangulate.html"><em>triangulate</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">blockmean</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#ascii-format-precision">Ascii Format Precision</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="B.html"
- title="previous chapter">B</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="blockmedian.html"
- title="next chapter">blockmedian</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/blockmean.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="blockmedian.html" title="blockmedian"
- >next</a> </li>
- <li class="right" >
- <a href="B.html" title="B"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="B.html" >B</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/blockmedian.html b/doc_release/html/blockmedian.html
deleted file mode 100644
index 8f7a2d0..0000000
--- a/doc_release/html/blockmedian.html
+++ /dev/null
@@ -1,362 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>blockmedian — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="B" href="B.html" />
- <link rel="next" title="blockmode" href="blockmode.html" />
- <link rel="prev" title="blockmean" href="blockmean.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="blockmode.html" title="blockmode"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="blockmean.html" title="blockmean"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="B.html" accesskey="U">B</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="blockmedian">
-<span id="index-0"></span><h1>blockmedian<a class="headerlink" href="#blockmedian" title="Permalink to this headline">¶</a></h1>
-<p>blockmedian - Block average (<em>x</em>,<em>y</em>,<em>z</em>) data tables by L1 norm</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>blockmedian</strong> [ <em>table</em> ]
-<strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]
-<strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>]
-[ <strong>-C</strong> ]
-[ <strong>-E</strong>[<strong>b</strong>] ] [ <strong>-E</strong><strong>r</strong>|<strong>s</strong>[<strong>-</strong>] ] [ <strong>-Q</strong> ]
-[ <strong>-T</strong><em>quantile</em> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W</strong>[<strong>i</strong>|<strong>o</strong>] ]
-[ <strong>-b</strong>[<strong>i</strong>|<strong>o</strong>][<em>ncol</em>][<strong>type</strong>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-o</strong><em>cols</em>[,...] ]
-[ <strong>-r</strong> ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>blockmedian</strong> reads arbitrarily located (<em>x</em>,<em>y</em>,<em>z</em>) triples [or
-optionally weighted quadruples (<em>x</em>,<em>y</em>,<em>z</em>,<em>w</em>)] from standard
-input [or <em>table</em>] and writes to standard output a median position and
-value for every non-empty block in a grid region defined by the <strong>-R</strong>
-and <strong>-I</strong> arguments. Either <a class="reference internal" href="blockmean.html"><em>blockmean</em></a>, <strong>blockmedian</strong>, or
-<a class="reference internal" href="blockmode.html"><em>blockmode</em></a> should be used as a pre-processor before running
-<a class="reference internal" href="surface.html"><em>surface</em></a> to avoid aliasing short wavelengths. These routines are also
-generally useful for decimating or averaging (<em>x</em>,<em>y</em>,<em>z</em>) data. You
-can modify the precision of the output format by editing the
-<a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> parameter in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file, or you may
-choose binary input and/or output to avoid loss of precision.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]</dt>
-<dd><em>x_inc</em> [and optionally <em>y_inc</em>] is the grid spacing. Optionally,
-append a suffix modifier. <strong>Geographical (degrees) coordinates</strong>: Append
-<strong>m</strong> to indicate arc minutes or <strong>s</strong> to indicate arc seconds. If one
-of the units <strong>e</strong>, <strong>f</strong>, <strong>k</strong>, <strong>M</strong>, <strong>n</strong> or <strong>u</strong> is appended
-instead, the increment is assumed to be given in meter, foot, km, Mile,
-nautical mile or US survey foot, respectively, and will be converted to
-the equivalent degrees longitude at the middle latitude of the region
-(the conversion depends on <a class="reference internal" href="gmt.conf.html#projection-parameters"><em>PROJ_ELLIPSOID</em></a>). If /<em>y_inc</em> is given
-but set to 0 it will be reset equal to <em>x_inc</em>; otherwise it will be
-converted to degrees latitude. <strong>All coordinates</strong>: If <strong>=</strong> is appended
-then the corresponding max <em>x</em> (<em>east</em>) or <em>y</em> (<em>north</em>) may be slightly
-adjusted to fit exactly the given increment [by default the increment
-may be adjusted slightly to fit the given domain]. Finally, instead of
-giving an increment you may specify the <em>number of nodes</em> desired by
-appending <strong>+</strong> to the supplied integer argument; the increment is then
-recalculated from the number of nodes and the domain. The resulting
-increment value depends on whether you have selected a
-gridline-registered or pixel-registered grid; see <a class="reference internal" href="GMT_Docs.html#app-file-formats"><em>B. GMT File Formats</em></a> for
-details. Note: if <strong>-R</strong><em>grdfile</em> is used then the grid spacing has
-already been initialized; use <strong>-I</strong> to override the values.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>3 [or 4, see <strong>-W</strong>] column ASCII data table] column ASCII file(s)
-[or binary, see <strong>-bi</strong>] holding
-(<em>x</em>,<em>y</em>,<em>z</em>[,<em>w</em>]) data values. [<em>w</em>] is an optional weight
-for the data. If no file is specified, <strong>blockmedian</strong> will read
-from standard input.</dd>
-<dt><strong>-C</strong></dt>
-<dd>Use the center of the block as the output location [Default uses the
-median x and median y as location (but see <strong>-Q</strong>)]..</dd>
-<dt><strong>-E</strong>[<strong>b</strong>]</dt>
-<dd>Provide Extended report which includes <strong>s</strong> (the L1 scale of the
-median), <strong>l</strong>, the lowest value, and <strong>h</strong>, the high value for each
-block. Output order becomes
-<em>x</em>,<em>y</em>,<em>z</em>,<em>s</em>,<em>l</em>,<em>h</em>[,<em>w</em>]. [Default outputs
-<em>x</em>,<em>y</em>,<em>z</em>[,<em>w</em>]. For box-and-whisker calculation, use
-<strong>-Eb</strong> which will output
-<em>x</em>,<em>y</em>,<em>z</em>,<em>l</em>,<em>q25</em>,<em>q75</em>,<em>h</em>[,*w*], where <em>q25</em> and
-<em>q75</em> are the 25% and 75% quantiles, respectively. See <strong>-W</strong> for
-<em>w</em> output.</dd>
-<dt><strong>-E</strong><strong>r</strong>|<strong>s</strong>[<strong>-</strong>]</dt>
-<dd>Provide source id <strong>s</strong> or record number <strong>r</strong> output, i.e., append
-the source id or record number associated with the median value. If
-tied then report the record number of the higher of the two values;
-append <strong>-</strong> to instead report the record number of the lower value.
-Note that both <strong>-E</strong>[<strong>b</strong>] and <strong>-E</strong><strong>r</strong>[<strong>-</strong>] may be
-specified. For <strong>-E</strong><strong>s</strong> we expect input records of the form
-<em>x</em>,<em>y</em>,<em>z</em>[,<em>w</em>],<em>sid</em>, where <em>sid</em> is an unsigned integer
-source id.</dd>
-<dt><strong>-Q</strong></dt>
-<dd>(Quicker) Finds median <em>z</em> and (<em>x</em>,<em>y</em>) at that the median <em>z</em>
-[Default finds median <em>x</em>, median <em>y</em> independent of <em>z</em>]. Also see
-<strong>-C</strong>.</dd>
-<dt><strong>-T</strong><em>quantile</em></dt>
-<dd>Sets the <em>quantile</em> of the distribution to be returned [Default is
-0.5 which returns the median <em>z</em>]. Here, 0 < <em>quantile</em> < 1.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong>[<strong>i</strong>|<strong>o</strong>]</dt>
-<dd>Weighted modifier[s]. Unweighted input and output has 3 columns
-<em>x</em>,<em>y</em>,<em>z</em>; Weighted i/o has 4 columns <em>x</em>,<em>y</em>,<em>z</em>,<em>w</em>.
-Weights can be used in input to construct weighted mean values in
-blocks. Weight sums can be reported in output for later combining
-several runs, etc. Use <strong>-W</strong> for weighted i/o, <strong>-Wi</strong> for weighted
-input only, <strong>-Wo</strong> for weighted output only. [Default uses
-unweighted i/o].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 3 (or 4 if <strong>-Wi</strong> is set)].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. [Default is 3 (or 4 if <strong>-Wo</strong> is set)]. <strong>-E</strong> adds 3 additional columns.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-o</strong><em>cols</em>[,...] <a class="reference internal" href="gmt.html#ocols-full"><em>(more ...)</em></a></dt>
-<dd>Select output columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-r</strong> <a class="reference internal" href="gmt.html#nodereg-full"><em>(more ...)</em></a></dt>
-<dd>Set pixel node registration [gridline]. Each block is the locus of points nearest the grid value location. For example, with
-<strong>-R</strong>10/15/10/15 and <strong>-I</strong>1: with the <strong>-r</strong> option 10 <=
-(<em>x</em>,<em>y</em>) < 11 is one of 25 blocks; without it 9.5 <= (<em>x</em>,<em>y</em>)
-< 10.5 is one of 36 blocks.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="ascii-format-precision">
-<h2>Ascii Format Precision<a class="headerlink" href="#ascii-format-precision" title="Permalink to this headline">¶</a></h2>
-<p>The ASCII output formats of numerical data are controlled by parameters
-in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file. Longitude and latitude are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>, whereas other values are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>. Be aware that the format in effect
-can lead to loss of precision in the output, which can lead to various
-problems downstream. If you find the output is not written with enough
-precision, consider switching to binary output (<strong>-bo</strong> if available) or
-specify more decimals using the <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> setting.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To find 5 by 5 minute block medians from the double precision binary
-data in hawaii_b.xyg and output an ASCII table, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt blockmedian hawaii_b.xyg -R198/208/18/25 -I5m -bi3d > hawaii_5x5.xyg
-</pre></div>
-</div>
-</div></blockquote>
-<p>To compute the shape of a data distribution per bin via a
-box-and-whisker diagram we need the 0%, 25%, 50%, 75%, and 100%
-quantiles. To do so on a global 5 by 5 degree basis from the ASCII table
-depths.xyz and send output to an ASCII table, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt blockmedian depths.xyz -Rg -I5 -Eb -r > depths_5x5.txt
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="blockmean.html"><em>blockmean</em></a>,
-<a class="reference internal" href="blockmode.html"><em>blockmode</em></a>, <a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>,
-<a class="reference internal" href="greenspline.html"><em>greenspline</em></a>,
-<a class="reference internal" href="nearneighbor.html"><em>nearneighbor</em></a>,
-<a class="reference internal" href="surface.html"><em>surface</em></a>,
-<a class="reference internal" href="sphtriangulate.html"><em>sphtriangulate</em></a>,
-<a class="reference internal" href="triangulate.html"><em>triangulate</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">blockmedian</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#ascii-format-precision">Ascii Format Precision</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="blockmean.html"
- title="previous chapter">blockmean</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="blockmode.html"
- title="next chapter">blockmode</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/blockmedian.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="blockmode.html" title="blockmode"
- >next</a> </li>
- <li class="right" >
- <a href="blockmean.html" title="blockmean"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="B.html" >B</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/blockmode.html b/doc_release/html/blockmode.html
deleted file mode 100644
index 661ea9e..0000000
--- a/doc_release/html/blockmode.html
+++ /dev/null
@@ -1,362 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>blockmode — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="B" href="B.html" />
- <link rel="next" title="F" href="F.html" />
- <link rel="prev" title="blockmedian" href="blockmedian.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="F.html" title="F"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="blockmedian.html" title="blockmedian"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="B.html" accesskey="U">B</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="blockmode">
-<span id="index-0"></span><h1>blockmode<a class="headerlink" href="#blockmode" title="Permalink to this headline">¶</a></h1>
-<p>blockmode - Block average (<em>x</em>,<em>y</em>,<em>z</em>) data tables by mode estimation</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>blockmode</strong> [ <em>table</em> ]
-<strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]
-<strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>]
-[ <strong>-C</strong> ]
-[ <strong>-D</strong>[<em>width</em>][<strong>+c</strong>][<strong>+a</strong>|<strong>+l</strong>|<strong>+h</strong> ]
-[ <strong>-E</strong><strong>r</strong>|<strong>s</strong>[<strong>-</strong>] ] [ <strong>-Q</strong> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W</strong>[<strong>i</strong>|<strong>o</strong>] ]
-[ <strong>-b</strong>[<strong>i</strong>|<strong>o</strong>][<em>ncol</em>][<strong>type</strong>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-o</strong><em>cols</em>[,...] ]
-[ <strong>-r</strong> ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>blockmode</strong> reads arbitrarily located (<em>x</em>,<em>y</em>,<em>z</em>) triples [or
-optionally weighted quadruples (<em>x</em>,<em>y</em>,<em>z</em>,<em>w</em>)] from standard
-input [or <em>table</em>] and writes to standard output mode estimates of
-position and value for every non-empty block in a grid region defined by
-the <strong>-R</strong> and <strong>-I</strong> arguments. Either <a class="reference internal" href="blockmean.html"><em>blockmean</em></a>,
-<a class="reference internal" href="blockmedian.html"><em>blockmedian</em></a>,
-or <strong>blockmode</strong> should be used as a pre-processor before running
-<a class="reference internal" href="surface.html"><em>surface</em></a> to avoid aliasing short wavelengths. These routines are also
-generally useful for decimating or averaging (<em>x</em>,<em>y</em>,<em>z</em>) data. You
-can modify the precision of the output format by editing the
-<a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> parameter in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file, or you may
-choose binary input and/or output to avoid loss of precision.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]</dt>
-<dd><em>x_inc</em> [and optionally <em>y_inc</em>] is the grid spacing. Optionally,
-append a suffix modifier. <strong>Geographical (degrees) coordinates</strong>: Append
-<strong>m</strong> to indicate arc minutes or <strong>s</strong> to indicate arc seconds. If one
-of the units <strong>e</strong>, <strong>f</strong>, <strong>k</strong>, <strong>M</strong>, <strong>n</strong> or <strong>u</strong> is appended
-instead, the increment is assumed to be given in meter, foot, km, Mile,
-nautical mile or US survey foot, respectively, and will be converted to
-the equivalent degrees longitude at the middle latitude of the region
-(the conversion depends on <a class="reference internal" href="gmt.conf.html#projection-parameters"><em>PROJ_ELLIPSOID</em></a>). If /<em>y_inc</em> is given
-but set to 0 it will be reset equal to <em>x_inc</em>; otherwise it will be
-converted to degrees latitude. <strong>All coordinates</strong>: If <strong>=</strong> is appended
-then the corresponding max <em>x</em> (<em>east</em>) or <em>y</em> (<em>north</em>) may be slightly
-adjusted to fit exactly the given increment [by default the increment
-may be adjusted slightly to fit the given domain]. Finally, instead of
-giving an increment you may specify the <em>number of nodes</em> desired by
-appending <strong>+</strong> to the supplied integer argument; the increment is then
-recalculated from the number of nodes and the domain. The resulting
-increment value depends on whether you have selected a
-gridline-registered or pixel-registered grid; see <a class="reference internal" href="GMT_Docs.html#app-file-formats"><em>B. GMT File Formats</em></a> for
-details. Note: if <strong>-R</strong><em>grdfile</em> is used then the grid spacing has
-already been initialized; use <strong>-I</strong> to override the values.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>3 [or 4, see <strong>-W</strong>] column ASCII data table file(s) [or binary, see
-<strong>-bi</strong>] holding (<em>x</em>,<em>y</em>,<em>z</em>[,<em>w</em>])
-data values. [<em>w</em>] is an optional weight for the data. If no file
-is specified, <strong>blockmode</strong> will read from standard input.</dd>
-<dt><strong>-C</strong></dt>
-<dd>Use the center of the block as the output location [Default uses the
-modal xy location (but see <strong>-Q</strong>)]. <strong>-C</strong> overrides <strong>-Q</strong>.</dd>
-<dt><strong>-D</strong>[<em>width</em>][<strong>+c</strong>][<strong>+a</strong>|<strong>+l</strong>|<strong>+h</strong> ]</dt>
-<dd>Perform unweighted mode calculation via histogram binning, using the
-specified histogram <em>width</em>. Append <strong>+c</strong> to center bins so that
-their mid point is a multiple of <em>width</em> [uncentered].
-If multiple modes are found for a block we return the average mode [<strong>+a</strong>].
-Append <strong>+l</strong> or <strong>+h</strong> to return the low of high mode instead, respectively.
-If <em>width</em> is not given it will default to 1 provided your data set only
-contains integers. Also, for integer data and integer bin <em>width</em> we
-enforce bin centering (<strong>+c</strong>) and select the lowest mode (<strong>+l</strong>) if
-there are multiples. [Default mode is normally the Least Median of Squares (LMS) statistic].</dd>
-<dt><strong>-E</strong></dt>
-<dd>Provide Extended report which includes <strong>s</strong> (the L1 scale of the
-mode), <strong>l</strong>, the lowest value, and <strong>h</strong>, the high value for each
-block. Output order becomes
-<em>x</em>,<em>y</em>,<em>z</em>,<em>s</em>,<em>l</em>,<em>h</em>[,<em>w</em>]. [Default outputs
-<em>x</em>,<em>y</em>,<em>z</em>[,<em>w</em>]. See <strong>-W</strong> for <em>w</em> output.</dd>
-<dt><strong>-E</strong><strong>r</strong>|<strong>s</strong>[<strong>-</strong>]</dt>
-<dd>Provide source id <strong>s</strong> or record number <strong>r</strong> output, i.e., append
-the source id or record number associated with the modal value. If
-tied then report the record number of the higher of the two values;
-append <strong>-</strong> to instead report the record number of the lower value.
-Note that both <strong>-E</strong> and <strong>-E</strong><strong>r</strong>[<strong>-</strong>] may be specified.
-For <strong>-E</strong><strong>s</strong> we expect input records of the form
-<em>x</em>,<em>y</em>,<em>z</em>[,<em>w</em>],<em>sid</em>, where <em>sid</em> is an unsigned integer
-source id.</dd>
-<dt><strong>-Q</strong></dt>
-<dd>(Quicker) Finds mode <em>z</em> and mean (<em>x</em>,<em>y</em>) [Default finds mode
-<em>x</em>, mode <em>y</em>, mode <em>z</em>].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong>[<strong>i</strong>|<strong>o</strong>]</dt>
-<dd>Weighted modifier[s]. Unweighted input and output has 3 columns
-<em>x</em>,<em>y</em>,<em>z</em>; Weighted i/o has 4 columns <em>x</em>,<em>y</em>,<em>z</em>,<em>w</em>.
-Weights can be used in input to construct weighted mean values in
-blocks. Weight sums can be reported in output for later combining
-several runs, etc. Use <strong>-W</strong> for weighted i/o, <strong>-Wi</strong> for weighted
-input only, <strong>-Wo</strong> for weighted output only. [Default uses
-unweighted i/o].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 3 (or 4 if <strong>-Wi</strong> is set)].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. [Default is 3 (or 4 if <strong>-Wo</strong> is set)]. <strong>-E</strong> adds 3 additional columns.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-o</strong><em>cols</em>[,...] <a class="reference internal" href="gmt.html#ocols-full"><em>(more ...)</em></a></dt>
-<dd>Select output columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-r</strong> <a class="reference internal" href="gmt.html#nodereg-full"><em>(more ...)</em></a></dt>
-<dd>Set pixel node registration [gridline]. Each block is the locus of points nearest the grid value location. For example, with
-<strong>-R</strong>10/15/10/15 and <strong>-I</strong>1: with the <strong>-r</strong> option 10 <=
-(<em>x</em>,<em>y</em>) < 11 is one of 25 blocks; without it 9.5 <= (<em>x</em>,<em>y</em>)
-< 10.5 is one of 36 blocks.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="ascii-format-precision">
-<h2>Ascii Format Precision<a class="headerlink" href="#ascii-format-precision" title="Permalink to this headline">¶</a></h2>
-<p>The ASCII output formats of numerical data are controlled by parameters
-in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file. Longitude and latitude are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>, whereas other values are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>. Be aware that the format in effect
-can lead to loss of precision in the output, which can lead to various
-problems downstream. If you find the output is not written with enough
-precision, consider switching to binary output (<strong>-bo</strong> if available) or
-specify more decimals using the <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> setting.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To find 5 by 5 minute block mode estimates from the double precision
-binary data in hawaii_b.xyg and output an ASCII table, run:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt blockmode hawaii_b.xyg -R198/208/18/25 -I5m -bi3d > hawaii_5x5.xyg
-</pre></div>
-</div>
-</div></blockquote>
-<p>To determine the most frequently occurring values per 5x5 block using histogram binning, with
-data representing integer counts, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt blockmode data.txt -R0/100/0/100 -I5 -r -C -D
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="blockmean.html"><em>blockmean</em></a>,
-<a class="reference internal" href="blockmedian.html"><em>blockmedian</em></a>, <a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>,
-<a class="reference internal" href="greenspline.html"><em>greenspline</em></a>,
-<a class="reference internal" href="nearneighbor.html"><em>nearneighbor</em></a>,
-<a class="reference internal" href="sphtriangulate.html"><em>sphtriangulate</em></a>,
-<a class="reference internal" href="surface.html"><em>surface</em></a>,
-<a class="reference internal" href="triangulate.html"><em>triangulate</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">blockmode</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#ascii-format-precision">Ascii Format Precision</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="blockmedian.html"
- title="previous chapter">blockmedian</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="F.html"
- title="next chapter">F</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/blockmode.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="F.html" title="F"
- >next</a> </li>
- <li class="right" >
- <a href="blockmedian.html" title="blockmedian"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="B.html" >B</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/cookbook.html b/doc_release/html/cookbook.html
deleted file mode 100644
index bd12aa6..0000000
--- a/doc_release/html/cookbook.html
+++ /dev/null
@@ -1,171 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>CookBook — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="next" title="1. Acknowledgments" href="GMT_Docs.html" />
- <link rel="prev" title="A pirate" href="gallery/users_contrib_symbols/pirata.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="GMT_Docs.html" title="1. Acknowledgments"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="gallery/users_contrib_symbols/pirata.html" title="A pirate"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="cookbook">
-<h1>CookBook<a class="headerlink" href="#cookbook" title="Permalink to this headline">¶</a></h1>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="GMT_Docs.html">1. Acknowledgments</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_Docs.html#a-reminder">2. A Reminder</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_Docs.html#copyright-and-caveat-emptor">3. Copyright and Caveat Emptor!</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_Docs.html#preface">4. Preface</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_Docs.html#new-features-in-gmt-5">5. New Features in GMT 5</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_Docs.html#switching-between-different-gmt-versions">6. Switching between different GMT versions</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_Docs.html#introduction">7. Introduction</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_Docs.html#gmt-overview-and-quick-reference">8. GMT Overview and Quick Reference</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_Docs.html#general-features">9. General Features</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_Docs.html#gmt-coordinate-transformations">10. GMT Coordinate Transformations</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_Docs.html#gmt-map-projections">11. GMT Map Projections</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_Docs.html#creating-gmt-graphics">12. Creating GMT Graphics</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_Docs.html#creating-gmt-animations">13. Creating GMT Animations</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_Docs.html#a-gmt-supplemental-packages">14. A. GMT Supplemental Packages</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_Docs.html#b-gmt-file-formats">15. B. GMT File Formats</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_Docs.html#c-including-gmt-graphics-into-your-documents">16. C. Including GMT Graphics into your Documents</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_Docs.html#e-predefined-bit-and-hachure-patterns-in-gmt">17. E. Predefined Bit and Hachure Patterns in GMT</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_Docs.html#f-chart-of-octal-codes-for-characters">18. F. Chart of Octal Codes for Characters</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_Docs.html#g-postscript-fonts-used-by-gmt">19. G. PostScript Fonts Used by GMT</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_Docs.html#h-color-space-the-final-frontier">20. H. Color Space: The Final Frontier</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_Docs.html#i-filtering-of-data-in-gmt">21. I. Filtering of Data in GMT</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_Docs.html#j-the-gmt-high-resolution-coastline-data">22. J. The GMT High-Resolution Coastline Data</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_Docs.html#k-gmt-on-non-unix-platforms">23. K. GMT on non-UNIX Platforms</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_Docs.html#l-of-colors-and-color-legends">24. L. Of Colors and Color Legends</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_Docs.html#m-custom-plot-symbols">25. M. Custom Plot Symbols</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_Docs.html#n-annotation-of-contours-and-quoted-lines">26. N. Annotation of Contours and “Quoted Lines”</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_Docs.html#o-special-operations">27. O. Special Operations</a></li>
-<li class="toctree-l1"><a class="reference internal" href="GMT_Docs.html#p-the-gmt-vector-data-format-for-ogr-compatibility">28. P. The GMT Vector Data Format for OGR Compatibility</a></li>
-</ul>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="gallery/users_contrib_symbols/pirata.html"
- title="previous chapter">A pirate</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="GMT_Docs.html"
- title="next chapter">1. Acknowledgments</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/cookbook.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="GMT_Docs.html" title="1. Acknowledgments"
- >next</a> </li>
- <li class="right" >
- <a href="gallery/users_contrib_symbols/pirata.html" title="A pirate"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/filter1d.html b/doc_release/html/filter1d.html
deleted file mode 100644
index 09ad168..0000000
--- a/doc_release/html/filter1d.html
+++ /dev/null
@@ -1,337 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>filter1d — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="F" href="F.html" />
- <link rel="next" title="fitcircle" href="fitcircle.html" />
- <link rel="prev" title="F" href="F.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="fitcircle.html" title="fitcircle"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="F.html" title="F"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="F.html" accesskey="U">F</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="filter1d">
-<span id="index-0"></span><h1>filter1d<a class="headerlink" href="#filter1d" title="Permalink to this headline">¶</a></h1>
-<p>filter1d - Do time domain filtering of 1-D data tables</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>filter1d</strong> [ <em>table</em> ] <strong>-F</strong><em>type<width></em>[<em>mode</em>]
-[ <strong>-D</strong><em>increment</em> ] [ <strong>-E</strong> ] [ <strong>-I</strong><em>ignore_val</em> ]
-[ <strong>-L</strong><em>lack_width</em> ] [ <strong>-N</strong><em>t_col</em> ] [ <strong>-Q</strong><em>q_factor</em> ]
-[ <strong>-S</strong><em>symmetry_factor</em> ] [ <strong>-T</strong><em>t_min/t_max/t_inc</em>[<strong>+</strong>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-b</strong>[<strong>i</strong>|<strong>o</strong>][<em>ncol</em>][<strong>type</strong>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-o</strong><em>cols</em>[,...] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>filter1d</strong> is a general time domain filter for multiple column time
-series data. The user specifies which column is the time (i.e., the
-independent variable). (See <strong>-N</strong> option below). The fastest operation
-occurs when the input time series are equally spaced and have no gaps or
-outliers and the special options are not needed. <strong>filter1d</strong> has
-options <strong>-L</strong>, <strong>-Q</strong>, and <strong>-S</strong> for unevenly sampled data with gaps.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-F</strong><em>type<width></em>[<em>mode</em>]</dt>
-<dd><p class="first">Sets the filter <em>type</em>. Choose among convolution and non-convolution
-filters. Append the filter code followed by the full filter
-<em><width></em> in same units as time column. Available convolution
-filters are:</p>
-<p>(<strong>b</strong>) Boxcar: All weights are equal.</p>
-<p>(<strong>c</strong>) Cosine Arch: Weights follow a cosine arch curve.</p>
-<p>(<strong>g</strong>) Gaussian: Weights are given by the Gaussian function.</p>
-<p>(<strong>f</strong>) Custom: Instead of <em>width</em> give name of a one-column file
-with your own weight coefficients.</p>
-<p>Non-convolution filters are:</p>
-<p>(<strong>m</strong>) Median: Returns median value.</p>
-<p>(<strong>p</strong>) Maximum likelihood probability (a mode estimator): Return
-modal value. If more than one mode is found we return their average
-value. Append - or + to the filter width if you rather want to
-return the smallest or largest of the modal values.</p>
-<p>(<strong>l</strong>) Lower: Return the minimum of all values.</p>
-<p>(<strong>L</strong>) Lower: Return minimum of all positive values only.</p>
-<p>(<strong>u</strong>) Upper: Return maximum of all values.</p>
-<p>(<strong>U</strong>) Upper: Return maximum or all negative values only.</p>
-<p>Upper case type <strong>B</strong>, <strong>C</strong>, <strong>G</strong>, <strong>M</strong>, <strong>P</strong>, <strong>F</strong> will use
-robust filter versions: i.e., replace outliers (2.5 L1 scale off
-median) with median during filtering.</p>
-<p class="last">In the case of <strong>L</strong>|<strong>U</strong> it is possible that no data passes
-the initial sign test; in that case the filter will return 0.0.</p>
-</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>[<em>ncols</em>][<em>type</em>]) data
-table file(s) holding a number of data columns. If no tables are given
-then we read from standard input. </dd>
-<dt><strong>-D</strong><em>increment</em></dt>
-<dd><em>increment</em> is used when series is NOT equidistantly sampled. Then
-<em>increment</em> will be the abscissae resolution, i.e., all abscissae
-will be rounded off to a multiple of <em>increment</em>. Alternatively,
-resample data with <a class="reference internal" href="sample1d.html"><em>sample1d</em></a>.</dd>
-<dt><strong>-E</strong></dt>
-<dd>Include Ends of time series in output. Default loses half the
-filter-width of data at each end.</dd>
-<dt><strong>-I</strong><em>ignore_val</em></dt>
-<dd>To ignore values; If an input value equals <em>ignore_val</em> it will be set to NaN.</dd>
-<dt><strong>-L</strong><em>lack_width</em></dt>
-<dd>Checks for Lack of data condition. If input data has a gap exceeding
-<em>width</em> then no output will be given at that point [Default does not check Lack].</dd>
-<dt><strong>-N</strong><em>t_col</em></dt>
-<dd>Indicates which column contains the independent variable (time). The
-left-most column is # 0, the right-most is # (<em>n_cols</em> - 1). [Default is 0].</dd>
-<dt><strong>-Q</strong><em>q_factor</em></dt>
-<dd>Assess Quality of output value by checking mean weight in
-convolution. Enter <em>q_factor</em> between 0 and 1. If mean weight <
-<em>q_factor</em>, output is suppressed at this point [Default does not check Quality].</dd>
-<dt><strong>-S</strong><em>symmetry_factor</em></dt>
-<dd>Checks symmetry of data about window center. Enter a factor between
-0 and 1. If ( (abs(n_left - n_right)) / (n_left + n_right) ) >
-<em>factor</em>, then no output will be given at this point [Default does
-not check Symmetry].</dd>
-<dt><strong>-T</strong><em>t_min/t_max/t_inc</em>[<strong>+</strong>]</dt>
-<dd>Make evenly spaced time-steps from <em>t_min</em> to <em>t_max</em> by <em>t_inc</em>
-[Default uses input times]. Append <strong>+</strong> to <em>t_inc</em> if you are
-specifying the number of equidistant points instead.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. [Default is same as input].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] <a class="reference internal" href="gmt.html#g-full"><em>(more ...)</em></a></dt>
-<dd>Determine data gaps and line breaks. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-o</strong><em>cols</em>[,...] <a class="reference internal" href="gmt.html#ocols-full"><em>(more ...)</em></a></dt>
-<dd>Select output columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="ascii-format-precision">
-<h2>Ascii Format Precision<a class="headerlink" href="#ascii-format-precision" title="Permalink to this headline">¶</a></h2>
-<p>The ASCII output formats of numerical data are controlled by parameters
-in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file. Longitude and latitude are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>, whereas other values are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>. Be aware that the format in effect
-can lead to loss of precision in the output, which can lead to various
-problems downstream. If you find the output is not written with enough
-precision, consider switching to binary output (<strong>-bo</strong> if available) or
-specify more decimals using the <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> setting.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To filter the data set in the file cruise.gmtd containing evenly spaced
-gravity, magnetics, topography, and distance (in m) with a 10 km
-Gaussian filter, removing outliers, and output a filtered value every 2
-km between 0 and 100 km:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt filter1d cruise.gmtd -T0/1.0e5/2000 -FG10000 -N3 -V > filtered_cruise.gmtd
-</pre></div>
-</div>
-</div></blockquote>
-<p>Data along track often have uneven sampling and gaps which we do not
-want to interpolate using <a class="reference internal" href="sample1d.html"><em>sample1d</em></a>. To find the median depth in a 50
-km window every 25 km along the track of cruise v3312, stored in
-v3312.dt, checking for gaps of 10km and asymmetry of 0.3:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt filter1d v3312.dt -FM50 -T0/100000/25 -L10 -S0.3 > v3312_filt.dt
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a> , <a class="reference internal" href="sample1d.html"><em>sample1d</em></a> , <a class="reference internal" href="splitxyz.html"><em>splitxyz</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">filter1d</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#ascii-format-precision">Ascii Format Precision</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="F.html"
- title="previous chapter">F</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="fitcircle.html"
- title="next chapter">fitcircle</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/filter1d.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="fitcircle.html" title="fitcircle"
- >next</a> </li>
- <li class="right" >
- <a href="F.html" title="F"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="F.html" >F</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/fitcircle.html b/doc_release/html/fitcircle.html
deleted file mode 100644
index ed42627..0000000
--- a/doc_release/html/fitcircle.html
+++ /dev/null
@@ -1,303 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>fitcircle — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="F" href="F.html" />
- <link rel="next" title="GM" href="GM.html" />
- <link rel="prev" title="filter1d" href="filter1d.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="GM.html" title="GM"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="filter1d.html" title="filter1d"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="F.html" accesskey="U">F</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="fitcircle">
-<span id="index-0"></span><h1>fitcircle<a class="headerlink" href="#fitcircle" title="Permalink to this headline">¶</a></h1>
-<p>fitcircle - find mean position and pole of best-fit great [or small] circle to points on a sphere.</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>fitcircle</strong> [ <em>table</em> ] <strong>-L</strong><em>norm</em> [ <strong>-S</strong>[<em>lat</em>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-bi</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-o</strong><em>cols</em>[,...] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>fitcircle</strong> reads lon,lat [or lat,lon] values from the first two
-columns on standard input [or <em>xyfile</em>]. These are converted to
-Cartesian three-vectors on the unit sphere. Then two locations are
-found: the mean of the input positions, and the pole to the great circle
-which best fits the input positions. The user may choose one or both of
-two possible solutions to this problem. The first is called <strong>-L1</strong> and
-the second is called <strong>-L2</strong>. When the data are closely grouped along a
-great circle both solutions are similar. If the data have large
-dispersion, the pole to the great circle will be less well determined
-than the mean. Compare both solutions as a qualitative check.</p>
-<p>The <strong>-L1</strong> solution is so called because it approximates the
-minimization of the sum of absolute values of cosines of angular
-distances. This solution finds the mean position as the Fisher average
-of the data, and the pole position as the Fisher average of the
-cross-products between the mean and the data. Averaging cross-products
-gives weight to points in proportion to their distance from the mean,
-analogous to the “leverage” of distant points in linear regression in the plane.</p>
-<p>The <strong>-L2</strong> solution is so called because it approximates the
-minimization of the sum of squares of cosines of angular distances. It
-creates a 3 by 3 matrix of sums of squares of components of the data
-vectors. The eigenvectors of this matrix give the mean and pole
-locations. This method may be more subject to roundoff errors when there
-are thousands of data. The pole is given by the eigenvector
-corresponding to the smallest eigenvalue; it is the least-well
-represented factor in the data and is not easily estimated by either method.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-L</strong><em>norm</em></dt>
-<dd>Specify the desired <em>norm</em> as 1 or 2, or use <strong>-L</strong> or <strong>-L3</strong> to
-see both solutions.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII [or binary, see <strong>-bi</strong>] files containing lon,lat [or lat,lon; see
-<strong>-:</strong>[<strong>i</strong>|<strong>o</strong>]] values in the first 2 columns. If no
-file is specified, <strong>fitcircle</strong> will read from standard input.</dd>
-<dt><strong>-S</strong>[<em>lat</em>]</dt>
-<dd>Attempt to fit a small circle instead of a great circle. The pole
-will be constrained to lie on the great circle connecting the pole
-of the best-fit great circle and the mean location of the data.
-Optionally append the desired fixed latitude of the small circle
-[Default will determine the latitude].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 2 input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] <a class="reference internal" href="gmt.html#g-full"><em>(more ...)</em></a></dt>
-<dd>Determine data gaps and line breaks. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-o</strong><em>cols</em>[,...] <a class="reference internal" href="gmt.html#ocols-full"><em>(more ...)</em></a></dt>
-<dd>Select output columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="ascii-format-precision">
-<h2>Ascii Format Precision<a class="headerlink" href="#ascii-format-precision" title="Permalink to this headline">¶</a></h2>
-<p>The ASCII output formats of numerical data are controlled by parameters
-in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file. Longitude and latitude are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>, whereas other values are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>. Be aware that the format in effect
-can lead to loss of precision in the output, which can lead to various
-problems downstream. If you find the output is not written with enough
-precision, consider switching to binary output (<strong>-bo</strong> if available) or
-specify more decimals using the <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> setting.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>Suppose you have lon,lat,grav data along a twisty ship track in the file
-ship.xyg. You want to project this data onto a great circle and resample
-it in distance, in order to filter it or check its spectrum. Do the
-following:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt fitcircle ship.xyg -L2
-gmt project ship.xyg -Cox/oy -Tpx/py -S -Fpz | sample1d -S-100 -I1 > output.pg
-</pre></div>
-</div>
-</div></blockquote>
-<p>Here, <em>ox</em>/<em>oy</em> is the lon/lat of the mean from <strong>fitcircle</strong>, and
-<em>px</em>/<em>py</em> is the lon/lat of the pole. The file output.pg has distance,
-gravity data sampled every 1 km along the great circle which best fits
-ship.xyg</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="gmtvector.html"><em>gmtvector</em></a>,
-<a class="reference internal" href="project.html"><em>project</em></a>,
-<a class="reference internal" href="mapproject.html"><em>mapproject</em></a>,
-<a class="reference internal" href="sample1d.html"><em>sample1d</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">fitcircle</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#ascii-format-precision">Ascii Format Precision</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="filter1d.html"
- title="previous chapter">filter1d</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="GM.html"
- title="next chapter">GM</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/fitcircle.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="GM.html" title="GM"
- >next</a> </li>
- <li class="right" >
- <a href="filter1d.html" title="filter1d"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="F.html" >F</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/anim01.html b/doc_release/html/gallery/anim01.html
deleted file mode 100644
index 922d866..0000000
--- a/doc_release/html/gallery/anim01.html
+++ /dev/null
@@ -1,242 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(1) Animation of the sine function — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(2) Examining DEMs using variable illumination" href="anim02.html" />
- <link rel="prev" title="Introduction" href="anim_introduction.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="anim02.html" title="(2) Examining DEMs using variable illumination"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="anim_introduction.html" title="Introduction"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="animation-of-the-sine-function">
-<span id="anim-01"></span><h1>(1) Animation of the sine function<a class="headerlink" href="#animation-of-the-sine-function" title="Permalink to this headline">¶</a></h1>
-<p>Our first animation is not very ambitious: We wish to plot the sine
-function from 0-360 and take snap shots every 20. To get a smooth curve
-we must sample the function much more frequently; we settle on 10 times
-more frequently than the frame spacing. We place a bright red circle at
-the leading edge of the curve, and as we move forward in time (here,
-angles) we dim the older circles to a dark red color. We add a label
-that indicates the current angle value. Once the 18 frames are completed
-we convert them to a single animated GIF file and write a plain HTML
-wrapper with a simple legend. Opening the HTML page in <tt class="docutils literal"><span class="pre">anim01.html</span></tt>
-the browser will display the animation.</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT ANIMATION 01</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Make web page with simple animated GIF of sine function</span>
-<span class="c"># GMT progs: gmt gmtset, gmt gmtmath, gmt psbasemap, gmt pstext, gmt psxy, gmt ps2raster</span>
-<span class="c"># Unix progs: printf, mkdir, rm, mv, echo, convert, cat</span>
-<span class="c"># Note: Run with any argument to build movie; otherwise 1st frame is plotted only.</span>
-<span class="c">#</span>
-<span class="c"># 1. Initialization</span>
-<span class="c"># 1a) Assign movie parameters</span>
-. gmt_shell_functions.sh
-<span class="nv">width</span><span class="o">=</span>4i
-<span class="nv">height</span><span class="o">=</span>2i
-<span class="nv">dpi</span><span class="o">=</span>125
-<span class="nv">n_frames</span><span class="o">=</span>18
-<span class="nv">name</span><span class="o">=</span>anim_01
-<span class="nv">ps</span><span class="o">=</span><span class="si">${</span><span class="nv">name</span><span class="si">}</span>.ps
-<span class="c"># 1b) Do frame-independent calculations and setup</span>
-<span class="nv">angle_step</span><span class="o">=</span><span class="sb">`</span>gmt gmtmath -Q <span class="m">360</span> <span class="si">${</span><span class="nv">n_frames</span><span class="si">}</span> <span class="nv">DIV</span> <span class="o">=</span><span class="sb">`</span>
-<span class="nv">angle_inc</span><span class="o">=</span><span class="sb">`</span>gmt gmtmath -Q <span class="si">${</span><span class="nv">angle_step</span><span class="si">}</span> <span class="m">10</span> <span class="nv">DIV</span> <span class="o">=</span><span class="sb">`</span>
-gmt psbasemap -R0/360/-1.2/1.6 -JX3.5i/1.65i -P -K -X0.35i -Y0.25i <span class="se">\</span>
- -BWSne+glightgreen -Bxa90g90f30+u<span class="se">\\</span><span class="m">312</span> -Bya0.5f0.1g1 <span class="se">\</span>
- --PS_MEDIA<span class="o">=</span><span class="si">${</span><span class="nv">width</span><span class="si">}</span>x<span class="si">${</span><span class="nv">height</span><span class="si">}</span> --FONT_ANNOT_PRIMARY<span class="o">=</span>9p > <span class="nv">$$</span>.map.ps
-<span class="c"># 2. Main frame loop</span>
-mkdir -p <span class="nv">$$</span>
-<span class="nv">frame</span><span class="o">=</span>0
-<span class="k">while</span> <span class="o">[</span> <span class="si">${</span><span class="nv">frame</span><span class="si">}</span> -le <span class="si">${</span><span class="nv">n_frames</span><span class="si">}</span> <span class="o">]</span><span class="p">;</span> <span class="k">do</span>
- <span class="c"># Create file name using a name_##.tif format</span>
- <span class="nv">file</span><span class="o">=</span><span class="sb">`</span>gmt_set_framename <span class="si">${</span><span class="nv">name</span><span class="si">}</span> <span class="si">${</span><span class="nv">frame</span><span class="si">}</span><span class="sb">`</span>
- cp -f <span class="nv">$$</span>.map.ps <span class="nv">$$</span>.ps
- <span class="nv">angle</span><span class="o">=</span><span class="sb">`</span>gmt gmtmath -Q <span class="si">${</span><span class="nv">frame</span><span class="si">}</span> <span class="si">${</span><span class="nv">angle_step</span><span class="si">}</span> <span class="nv">MUL</span> <span class="o">=</span><span class="sb">`</span>
- <span class="k">if</span> <span class="o">[</span> <span class="si">${</span><span class="nv">frame</span><span class="si">}</span> -gt <span class="m">0</span> <span class="o">]</span><span class="p">;</span> <span class="k">then</span> <span class="c"># First plot has no curves</span>
-<span class="c"># Plot smooth blue curve and dark red dots at all angle steps so far</span>
- gmt gmtmath -T0/<span class="si">${</span><span class="nv">angle</span><span class="si">}</span>/<span class="si">${</span><span class="nv">angle_inc</span><span class="si">}</span> T <span class="nv">SIND</span> <span class="o">=</span> <span class="nv">$$</span>.sin.d
- gmt psxy -R -J -O -K -W1p,blue <span class="nv">$$</span>.sin.d >> <span class="nv">$$</span>.ps
- gmt gmtmath -T0/<span class="si">${</span><span class="nv">angle</span><span class="si">}</span>/<span class="si">${</span><span class="nv">angle_step</span><span class="si">}</span> T <span class="nv">SIND</span> <span class="o">=</span> <span class="nv">$$</span>.sin.d
- gmt psxy -R -J -O -K -Sc0.1i -Gdarkred <span class="nv">$$</span>.sin.d >> <span class="nv">$$</span>.ps
- <span class="k">fi</span>
- <span class="c"># Plot red dot at current angle and annotate</span>
- <span class="nv">sin</span><span class="o">=</span><span class="sb">`</span>gmt gmtmath -Q <span class="si">${</span><span class="nv">angle</span><span class="si">}</span> <span class="nv">SIND</span> <span class="o">=</span><span class="sb">`</span>
- gmt psxy -R -J -O -K -Sc0.1i -Gred >> <span class="nv">$$</span>.ps <span class="o"><<<</span> <span class="s2">"</span><span class="si">${</span><span class="nv">angle</span><span class="si">}</span><span class="s2"> </span><span class="si">${</span><span class="nv">sin</span><span class="si">}</span><span class="s2">"</span>
- <span class="nb">printf</span> <span class="s2">"0 1.6 a = %03d"</span> <span class="si">${</span><span class="nv">angle</span><span class="si">}</span> <span class="p">|</span> gmt pstext -R -J -F+f14p,Helvetica-Bold+jTL -O -K <span class="se">\</span>
- -N -Dj0.1i/0.05i >> <span class="nv">$$</span>.ps
- gmt psxy -R -J -O -T >> <span class="nv">$$</span>.ps
- <span class="o">[[</span> <span class="si">${</span><span class="nv">frame</span><span class="si">}</span> -eq <span class="m">0</span> <span class="o">]]</span> <span class="o">&&</span> cp <span class="nv">$$</span>.ps <span class="si">${</span><span class="nv">ps</span><span class="si">}</span>
- <span class="k">if</span> <span class="o">[</span> <span class="nv">$# </span>-eq <span class="m">0</span> <span class="o">]</span><span class="p">;</span> <span class="k">then</span>
- gmt_cleanup .gmt
- gmt_abort <span class="s2">"</span><span class="si">${</span><span class="nv">0</span><span class="si">}</span><span class="s2">: First frame plotted to </span><span class="si">${</span><span class="nv">name</span><span class="si">}</span><span class="s2">.ps"</span>
- <span class="k">fi</span>
-<span class="c"># RIP to TIFF at specified dpi</span>
- gmt ps2raster -E<span class="si">${</span><span class="nv">dpi</span><span class="si">}</span> -Tt <span class="nv">$$</span>.ps
- mv -f <span class="nv">$$</span>.tif <span class="nv">$$</span>/<span class="si">${</span><span class="nv">file</span><span class="si">}</span>.tif
- <span class="nb">echo</span> <span class="s2">"Frame </span><span class="si">${</span><span class="nv">file</span><span class="si">}</span><span class="s2"> completed"</span>
- <span class="nv">frame</span><span class="o">=</span><span class="sb">`</span>gmt_set_framenext <span class="si">${</span><span class="nv">frame</span><span class="si">}</span><span class="sb">`</span>
-<span class="k">done</span>
-<span class="c"># 3. Create animated GIF file and HTML for web page</span>
-<span class="si">${</span><span class="nv">GRAPHICSMAGICK</span><span class="p">-gm</span><span class="si">}</span> convert -delay <span class="m">20</span> -loop <span class="m">0</span> <span class="nv">$$</span>/<span class="si">${</span><span class="nv">name</span><span class="si">}</span>_*.tif <span class="si">${</span><span class="nv">name</span><span class="si">}</span>.gif
-cat <span class="s"><< END > ${name}.html</span>
-<span class="s"><HTML></span>
-<span class="s"><TITLE>GMT Trigonometry: The sine movie</TITLE></span>
-<span class="s"><BODY bgcolor="#ffffff"></span>
-<span class="s"><CENTER></span>
-<span class="s"><H1>GMT Trigonometry: The sine movie</H1></span>
-<span class="s"><IMG src="${name}.gif"></span>
-<span class="s"></CENTER></span>
-<span class="s"><HR></span>
-<span class="s">We demonstrate how the sine function <I>y = sin(a)</I> varies with <I>a</I> over</span>
-<span class="s">the full 360-degree interval. We plot a bright red circle at each</span>
-<span class="s">new angle, letting previous circles turn dark red. The underlying</span>
-<span class="s">sine curve is sampled at 10 times the frame sampling rate in order to reproduce</span>
-<span class="s">a smooth curve. Our animation uses GraphicsMagick's convert tool to make an animated GIF file</span>
-<span class="s">with a 0.2 second pause between frames, set to repeat forever.</span>
-<span class="s"><HR></span>
-<span class="s"><I>${name}.sh: Created by ${USER} on `date`</I></span>
-<span class="s"></BODY></span>
-<span class="s"></HTML></span>
-<span class="s">END</span>
-<span class="c"># 4. Clean up temporary files</span>
-gmt_cleanup .gmt
-</pre></div>
-</div>
-<p>Make sure you understand the purpose of all the steps in our script. In
-this case we did some trial-and-error to determine the exact values to
-use for the map projection, the region, the spacing around the frame,
-etc. so that the final result gave a reasonable layout. Do this planning
-on a single PostScript plot before running a lengthy animation script.</p>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/anim_01.png"><img alt="../_images/anim_01.png" src="../_images/anim_01.png" style="width: 400px;" /></a>
-<p class="caption">Animation of a simple sine function.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="anim_introduction.html"
- title="previous chapter">Introduction</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="anim02.html"
- title="next chapter">(2) Examining DEMs using variable illumination</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/anim01.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="anim02.html" title="(2) Examining DEMs using variable illumination"
- >next</a> </li>
- <li class="right" >
- <a href="anim_introduction.html" title="Introduction"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/anim02.html b/doc_release/html/gallery/anim02.html
deleted file mode 100644
index ca62eef..0000000
--- a/doc_release/html/gallery/anim02.html
+++ /dev/null
@@ -1,228 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(2) Examining DEMs using variable illumination — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(3) Orbiting a static map" href="anim03.html" />
- <link rel="prev" title="(1) Animation of the sine function" href="anim01.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="anim03.html" title="(3) Orbiting a static map"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="anim01.html" title="(1) Animation of the sine function"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="examining-dems-using-variable-illumination">
-<span id="anim-02"></span><h1>(2) Examining DEMs using variable illumination<a class="headerlink" href="#examining-dems-using-variable-illumination" title="Permalink to this headline">¶</a></h1>
-<p>Our next animation uses a gridded topography for parts of Colorado (US);
-the file is distributed with the tutorial examples. Here, we want to use
-<a class="reference internal" href="../grdimage.html"><em>grdimage</em></a> to generate a shaded-relief
-image sequence in which we sweep the illumination azimuth around the
-entire horizon. The resulting animation illustrates how changing the
-illumination azimuth can bring out subtle features (or artifacts) in the
-gridded data. The red arrow points in the direction of the illumination.</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT ANIMATION 02</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Make web page with simple animated GIF of a DEM grid</span>
-<span class="c"># GMT progs: gmt gmtset, gmt gmtmath, gmt grdgradient, gmt makecpt, gmt grdimage gmt psxy, gmt ps2raster</span>
-<span class="c"># Unix progs: awk, mkdir, rm, mv, echo, convert, cat</span>
-<span class="c"># Note: Run with any argument to build movie; otherwise 1st frame is plotted only.</span>
-<span class="c">#</span>
-<span class="c"># 1. Initialization</span>
-<span class="c"># 1a) Assign movie parameters</span>
-. gmt_shell_functions.sh
-<span class="nv">width</span><span class="o">=</span>3.5i
-<span class="nv">height</span><span class="o">=</span>4.15i
-<span class="nv">dpi</span><span class="o">=</span>72
-<span class="nv">n_frames</span><span class="o">=</span>36
-<span class="nv">name</span><span class="o">=</span>anim_02
-<span class="nv">ps</span><span class="o">=</span><span class="si">${</span><span class="nv">name</span><span class="si">}</span>.ps
-<span class="c"># 1b) setup</span>
-<span class="nv">del_angle</span><span class="o">=</span><span class="sb">`</span>gmt gmtmath -Q <span class="m">360</span> <span class="si">${</span><span class="nv">n_frames</span><span class="si">}</span> <span class="nv">DIV</span> <span class="o">=</span><span class="sb">`</span>
-gmt makecpt -Crainbow -T500/4500/5000 -Z > <span class="nv">$$</span>.cpt
-<span class="c"># 2. Main loop</span>
-mkdir -p <span class="nv">$$</span>
-<span class="nv">frame</span><span class="o">=</span>0
-<span class="k">while</span> <span class="o">[</span> <span class="si">${</span><span class="nv">frame</span><span class="si">}</span> -lt <span class="si">${</span><span class="nv">n_frames</span><span class="si">}</span> <span class="o">]</span><span class="p">;</span> <span class="k">do</span>
- <span class="c"># Create file name using a name_##.tif format</span>
- <span class="nv">file</span><span class="o">=</span><span class="sb">`</span>gmt_set_framename <span class="si">${</span><span class="nv">name</span><span class="si">}</span> <span class="si">${</span><span class="nv">frame</span><span class="si">}</span><span class="sb">`</span>
- <span class="nv">angle</span><span class="o">=</span><span class="sb">`</span>gmt gmtmath -Q <span class="si">${</span><span class="nv">frame</span><span class="si">}</span> <span class="si">${</span><span class="nv">del_angle</span><span class="si">}</span> <span class="nv">MUL</span> <span class="o">=</span><span class="sb">`</span>
- <span class="nv">dir</span><span class="o">=</span><span class="sb">`</span>gmt gmtmath -Q <span class="si">${</span><span class="nv">angle</span><span class="si">}</span> <span class="m">180</span> <span class="nv">ADD</span> <span class="o">=</span><span class="sb">`</span>
- gmt grdgradient us.nc -A<span class="si">${</span><span class="nv">angle</span><span class="si">}</span> -Nt2 -fg -G<span class="nv">$$</span>.us_int.nc
- gmt grdimage us.nc -I<span class="nv">$$</span>.us_int.nc -JM3i -P -K -C<span class="nv">$$</span>.cpt -BWSne -B1 -X0.35i -Y0.3i <span class="se">\</span>
- --PS_MEDIA<span class="o">=</span><span class="si">${</span><span class="nv">width</span><span class="si">}</span>x<span class="si">${</span><span class="nv">height</span><span class="si">}</span> --FONT_ANNOT_PRIMARY<span class="o">=</span>9p > <span class="nv">$$</span>.ps
- gmt psxy -Rus.nc -J -O -K -Sc0.8i -Gwhite -Wthin >> <span class="nv">$$</span>.ps <span class="o"><<<</span> <span class="s2">"256.25 35.6"</span>
- gmt psxy -Rus.nc -J -O -Sv0.1i+e -Gred -Wthick >> <span class="nv">$$</span>.ps <span class="o"><<<</span> <span class="s2">"256.25 35.6 </span><span class="si">${</span><span class="nv">dir</span><span class="si">}</span><span class="s2"> 0.37"</span>
- <span class="o">[[</span> <span class="si">${</span><span class="nv">frame</span><span class="si">}</span> -eq <span class="m">0</span> <span class="o">]]</span> <span class="o">&&</span> cp <span class="nv">$$</span>.ps <span class="si">${</span><span class="nv">ps</span><span class="si">}</span>
- <span class="k">if</span> <span class="o">[</span> <span class="nv">$# </span>-eq <span class="m">0</span> <span class="o">]</span><span class="p">;</span> <span class="k">then</span>
- gmt_cleanup .gmt
- gmt_abort <span class="s2">"</span><span class="si">${</span><span class="nv">0</span><span class="si">}</span><span class="s2">: First frame plotted to </span><span class="si">${</span><span class="nv">name</span><span class="si">}</span><span class="s2">.ps"</span>
- <span class="k">fi</span>
-<span class="c"># RIP to TIFF at specified dpi</span>
- gmt ps2raster -E<span class="si">${</span><span class="nv">dpi</span><span class="si">}</span> -Tt <span class="nv">$$</span>.ps
- mv -f <span class="nv">$$</span>.tif <span class="nv">$$</span>/<span class="si">${</span><span class="nv">file</span><span class="si">}</span>.tif
- <span class="nb">echo</span> <span class="s2">"Frame </span><span class="si">${</span><span class="nv">file</span><span class="si">}</span><span class="s2"> completed"</span>
- <span class="nv">frame</span><span class="o">=</span><span class="sb">`</span>gmt_set_framenext <span class="si">${</span><span class="nv">frame</span><span class="si">}</span><span class="sb">`</span>
-<span class="k">done</span>
-<span class="c"># 3. Create animated GIF file and HTML for web page</span>
-<span class="si">${</span><span class="nv">GRAPHICSMAGICK</span><span class="p">-gm</span><span class="si">}</span> convert -delay <span class="m">10</span> -loop <span class="m">0</span> <span class="nv">$$</span>/<span class="si">${</span><span class="nv">name_</span><span class="si">}</span>*.tif <span class="si">${</span><span class="nv">name</span><span class="si">}</span>.gif
-cat <span class="s"><< END > ${name}.html</span>
-<span class="s"><HTML></span>
-<span class="s"><TITLE>GMT shading: A tool for feature detection</TITLE></span>
-<span class="s"><BODY bgcolor="#ffffff"></span>
-<span class="s"><CENTER></span>
-<span class="s"><H1>GMT shading: A tool for feature detection</H1></span>
-<span class="s"><IMG src="${name}.gif"></span>
-<span class="s"></CENTER></span>
-<span class="s"><HR></span>
-<span class="s">We make illuminated images of topography from a section of Colorado and</span>
-<span class="s">vary the azimuth of the illumination (see arrow). As the light-source sweeps around</span>
-<span class="s">the area over 360 degrees we notice that different features in the data</span>
-<span class="s">become hightlighted. This is because the illumination is based on data</span>
-<span class="s">gradients and such derivatives will high-light short-wavelength signal.</span>
-<span class="s">Again, our animation uses GraphicsMagick's convert tool to make an animated GIF file</span>
-<span class="s">with a 0.1 second pause between the 36 frames.</span>
-<span class="s"><HR></span>
-<span class="s"><I>${name}.sh: Created by ${USER} on `date`</I></span>
-<span class="s"></BODY></span>
-<span class="s"></HTML></span>
-<span class="s">END</span>
-<span class="c"># 4. Clean up temporary files</span>
-gmt_cleanup .gmt
-</pre></div>
-</div>
-<p>As you can see, these sorts of animations are not terribly difficult to
-put together, especially since our vantage point is fixed. In the next
-example we will move the “camera” around and must therefore deal with
-how to frame perspective views.</p>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/anim_02.png"><img alt="../_images/anim_02.png" src="../_images/anim_02.png" style="width: 400px;" /></a>
-<p class="caption">Animation of a DEM using variable illumination.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="anim01.html"
- title="previous chapter">(1) Animation of the sine function</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="anim03.html"
- title="next chapter">(3) Orbiting a static map</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/anim02.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="anim03.html" title="(3) Orbiting a static map"
- >next</a> </li>
- <li class="right" >
- <a href="anim01.html" title="(1) Animation of the sine function"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/anim03.html b/doc_release/html/gallery/anim03.html
deleted file mode 100644
index 46f9718..0000000
--- a/doc_release/html/gallery/anim03.html
+++ /dev/null
@@ -1,217 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(3) Orbiting a static map — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(4) Flying over topography" href="anim04.html" />
- <link rel="prev" title="(2) Examining DEMs using variable illumination" href="anim02.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="anim04.html" title="(4) Flying over topography"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="anim02.html" title="(2) Examining DEMs using variable illumination"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="orbiting-a-static-map">
-<span id="anim-03"></span><h1>(3) Orbiting a static map<a class="headerlink" href="#orbiting-a-static-map" title="Permalink to this headline">¶</a></h1>
-<p>Our third animation keeps a fixed gridded data set but moves the camera
-angle around the full 360. We use
-<a class="reference internal" href="../grdview.html"><em>grdview</em></a> to generate a shaded-relief
-image sequence using the new enhanced <strong>-E</strong> option. No additional
-information is plotted on the image. As before we produce an animated
-GIF image and a simple HTML wrapper for it.</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT ANIMATION 03</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Make web page with simple animated GIF of Iceland topo</span>
-<span class="c"># GMT progs: gmt gmtset, gmt gmtmath, gmt psbasemap, gmt psxy, gmt ps2raster</span>
-<span class="c"># Unix progs: awk, mkdir, rm, mv, echo, convert, cat</span>
-<span class="c"># Note: Run with any argument to build movie; otherwise 1st frame is plotted only.</span>
-<span class="c">#</span>
-<span class="c"># 1. Initialization</span>
-<span class="c"># 1a) Assign movie parameters</span>
-. gmt_shell_functions.sh
-<span class="nv">lon</span><span class="o">=</span>-20
-<span class="nv">lat</span><span class="o">=</span>65
-<span class="nv">dpi</span><span class="o">=</span>100
-<span class="nv">x0</span><span class="o">=</span>1.5
-<span class="nv">y0</span><span class="o">=</span>0.75
-<span class="nv">px</span><span class="o">=</span>4
-<span class="nv">py</span><span class="o">=</span>2.5
-<span class="nv">el</span><span class="o">=</span>35
-<span class="nv">az</span><span class="o">=</span>0
-<span class="nv">name</span><span class="o">=</span>anim_03
-<span class="nv">ps</span><span class="o">=</span><span class="si">${</span><span class="nv">name</span><span class="si">}</span>.ps
-mkdir -p <span class="nv">$$</span>
-<span class="nv">frame</span><span class="o">=</span>0
-gmt grdclip -Sb0/-1 -G<span class="nv">$$</span><span class="o">{</span>_above<span class="o">}</span>.nc Iceland.nc
-gmt grdgradient -fg -A45 -Nt1 <span class="nv">$$</span><span class="o">{</span>_above<span class="o">}</span>.nc -G<span class="nv">$$</span>.nc
-gmt makecpt -Crelief -T-2000/2000/20 > <span class="nv">$$</span>.cpt
-<span class="k">while</span> <span class="o">[</span> <span class="si">${</span><span class="nv">az</span><span class="si">}</span> -lt <span class="m">360</span> <span class="o">]</span><span class="p">;</span> <span class="k">do</span>
- <span class="nv">file</span><span class="o">=</span><span class="sb">`</span>gmt_set_framename <span class="si">${</span><span class="nv">name</span><span class="si">}</span> <span class="si">${</span><span class="nv">frame</span><span class="si">}</span><span class="sb">`</span>
- <span class="k">if</span> <span class="o">[</span> <span class="nv">$# </span>-eq <span class="m">0</span> <span class="o">]</span><span class="p">;</span> <span class="k">then</span> <span class="c"># If a single frame is requested we pick this view</span>
- <span class="nv">az</span><span class="o">=</span>135
- <span class="k">fi</span>
- gmt grdview <span class="nv">$$</span><span class="o">{</span>_above<span class="o">}</span>.nc -R-26/-12/63/67 -JM2.5i -C<span class="nv">$$</span>.cpt -Qi<span class="si">${</span><span class="nv">dpi</span><span class="si">}</span> -Bx5g10 -By5g5 -P -X0.5i -Y0.5i <span class="se">\</span>
- -p<span class="si">${</span><span class="nv">az</span><span class="si">}</span>/<span class="si">${</span><span class="nv">el</span><span class="si">}</span>+w<span class="si">${</span><span class="nv">lon</span><span class="si">}</span>/<span class="si">${</span><span class="nv">lat</span><span class="si">}</span>+v<span class="si">${</span><span class="nv">x0</span><span class="si">}</span>/<span class="si">${</span><span class="nv">y0</span><span class="si">}</span> --PS_MEDIA<span [...]
- <span class="o">[[</span> <span class="si">${</span><span class="nv">az</span><span class="si">}</span> -eq <span class="m">135</span> <span class="o">]]</span> <span class="o">&&</span> cp <span class="nv">$$</span>.ps <span class="si">${</span><span class="nv">ps</span><span class="si">}</span>
- <span class="k">if</span> <span class="o">[</span> <span class="nv">$# </span>-eq <span class="m">0</span> <span class="o">]</span><span class="p">;</span> <span class="k">then</span>
- gmt_cleanup .gmt
- gmt_abort <span class="s2">"</span><span class="si">${</span><span class="nv">0</span><span class="si">}</span><span class="s2">: First frame plotted to </span><span class="si">${</span><span class="nv">name</span><span class="si">}</span><span class="s2">.ps"</span>
- <span class="k">fi</span>
- gmt ps2raster <span class="nv">$$</span>.ps -Tt -E<span class="si">${</span><span class="nv">dpi</span><span class="si">}</span>
- mv <span class="nv">$$</span>.tif <span class="nv">$$</span>/<span class="si">${</span><span class="nv">file</span><span class="si">}</span>.tif
- <span class="nv">az</span><span class="o">=</span><span class="sb">`</span>expr <span class="si">${</span><span class="nv">az</span><span class="si">}</span> + 5<span class="sb">`</span>
- <span class="nb">echo</span> <span class="s2">"Frame </span><span class="si">${</span><span class="nv">file</span><span class="si">}</span><span class="s2"> completed"</span>
- <span class="nv">frame</span><span class="o">=</span><span class="sb">`</span>gmt_set_framenext <span class="si">${</span><span class="nv">frame</span><span class="si">}</span><span class="sb">`</span>
-<span class="k">done</span>
-<span class="si">${</span><span class="nv">GRAPHICSMAGICK</span><span class="p">-gm</span><span class="si">}</span> convert -delay <span class="m">10</span> -loop <span class="m">0</span> +dither <span class="nv">$$</span>/<span class="si">${</span><span class="nv">name_</span><span class="si">}</span>*.tif <span class="si">${</span><span class="nv">name</span><span class="si">}</span>.gif
-cat <span class="s"><< END > ${name}.html</span>
-<span class="s"><HTML></span>
-<span class="s"><TITLE>GMT 3-D perspective of Iceland</TITLE></span>
-<span class="s"><BODY bgcolor="#ffffff"></span>
-<span class="s"><CENTER></span>
-<span class="s"><H1>GMT 3-D perspective of Iceland</H1></span>
-<span class="s"><IMG src="${name}.gif" border=1></span>
-<span class="s"></CENTER></span>
-<span class="s"><HR></span>
-<span class="s">Here we show ETOPO2 topography of Iceland as we move the view</span>
-<span class="s">point around the island.</span>
-<span class="s"><I>${name}.sh: Created by ${USER} on `date`</I></span>
-<span class="s"></BODY> </span>
-<span class="s"></HTML></span>
-<span class="s">END</span>
-<span class="c"># 4. Clean up temporary files</span>
-gmt_cleanup .gmt
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/anim_03.png"><img alt="../_images/anim_03.png" src="../_images/anim_03.png" style="width: 400px;" /></a>
-<p class="caption">Orbiting a static map.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="anim02.html"
- title="previous chapter">(2) Examining DEMs using variable illumination</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="anim04.html"
- title="next chapter">(4) Flying over topography</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/anim03.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="anim04.html" title="(4) Flying over topography"
- >next</a> </li>
- <li class="right" >
- <a href="anim02.html" title="(2) Examining DEMs using variable illumination"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/anim04.html b/doc_release/html/gallery/anim04.html
deleted file mode 100644
index 5aaca41..0000000
--- a/doc_release/html/gallery/anim04.html
+++ /dev/null
@@ -1,251 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(4) Flying over topography — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="Users Script Contributions" href="../Users_contrib_script.html" />
- <link rel="prev" title="(3) Orbiting a static map" href="anim03.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="../Users_contrib_script.html" title="Users Script Contributions"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="anim03.html" title="(3) Orbiting a static map"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="flying-over-topography">
-<span id="anim-04"></span><h1>(4) Flying over topography<a class="headerlink" href="#flying-over-topography" title="Permalink to this headline">¶</a></h1>
-<p>Our next animation simulates what an imaginary satellite might see as it
-passes in a great circle from New York to Miami at an altitude of 160
-km. We use the general perspective view projection with
-<a class="reference internal" href="../grdimage.html"><em>grdimage</em></a> and use
-<a class="reference internal" href="../project.html"><em>project</em></a> to create a great circle path
-between the two cities, sampled every 5 km. The main part of the script
-will make the DVD-quality frames from different view points, draw the
-path on the ground, and add frame numbers to each frame. As this
-animation generates 355 frames we can use 3rd party tools to turn the
-image sequence into a MPEG-4 movie. Note: At the moment,
-<a class="reference internal" href="../grdview.html"><em>grdview</em></a> cannot use general perspective
-view projection to allow “fly-through” animations like Fledermaus; we
-expect to add this functionality in a future version.</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT ANIMATION 04</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Make DVD-res movie of NY to Miami flight</span>
-<span class="c"># GMT progs: gmt gmtset, gmt gmtmath, gmt psbasemap, gmt pstext, gmt psxy, gmt ps2raster</span>
-<span class="c"># Unix progs: awk, mkdir, rm, mv, echo, qt_export, cat</span>
-<span class="c"># Note: Run with any argument to build movie; otherwise 1st frame is plotted only.</span>
-<span class="c">#</span>
-<span class="c"># 1. Initialization</span>
-<span class="c"># 1a) Assign movie parameters</span>
-. gmt_shell_functions.sh
-<span class="nv">REGION</span><span class="o">=</span>-Rg
-<span class="nv">altitude</span><span class="o">=</span>160.0
-<span class="nv">tilt</span><span class="o">=</span>55
-<span class="nv">azimuth</span><span class="o">=</span>210
-<span class="nv">twist</span><span class="o">=</span>0
-<span class="nv">Width</span><span class="o">=</span>36.0
-<span class="nv">Height</span><span class="o">=</span>34.0
-<span class="nv">px</span><span class="o">=</span>7.2
-<span class="nv">py</span><span class="o">=</span>4.8
-<span class="nv">dpi</span><span class="o">=</span>100
-<span class="nv">name</span><span class="o">=</span>anim_04
-<span class="nv">ps</span><span class="o">=</span><span class="si">${</span><span class="nv">name</span><span class="si">}</span>.ps
-
-<span class="c"># Set up flight path</span>
-gmt project -C-73.8333/40.75 -E-80.133/25.75 -G5 -Q > <span class="nv">$$</span>.path.d
-<span class="nv">frame</span><span class="o">=</span>0
-mkdir -p <span class="nv">$$</span>
-gmt grdgradient USEast_Coast.nc -A90 -Nt1 -Gint_<span class="nv">$$</span>.nc
-gmt makecpt -Cglobe -Z > globe_<span class="nv">$$</span>.cpt
-<span class="k">function</span> make_frame <span class="o">()</span> <span class="o">{</span>
- <span class="nb">local </span>frame file ID lon lat dist
- <span class="nv">frame</span><span class="o">=</span><span class="nv">$1</span><span class="p">;</span> <span class="nv">lon</span><span class="o">=</span><span class="nv">$2</span><span class="p">;</span> <span class="nv">lat</span><span class="o">=</span><span class="nv">$3</span><span class="p">;</span> <span class="nv">dist</span><span class="o">=</span><span class="nv">$4</span>
- <span class="nv">file</span><span class="o">=</span><span class="sb">`</span>gmt_set_framename <span class="si">${</span><span class="nv">name</span><span class="si">}</span> <span class="si">${</span><span class="nv">frame</span><span class="si">}</span><span class="sb">`</span>
- <span class="nv">ID</span><span class="o">=</span><span class="sb">`</span><span class="nb">echo</span> <span class="si">${</span><span class="nv">frame</span><span class="si">}</span> <span class="p">|</span> <span class="nv">$AWK</span> <span class="s1">'{printf "%04d\n", $1}'</span><span class="sb">`</span>
- gmt grdimage -JG<span class="si">${</span><span class="nv">lon</span><span class="si">}</span>/<span class="si">${</span><span class="nv">lat</span><span class="si">}</span>/<span class="si">${</span><span class="nv">altitude</span><span class="si">}</span>/<span class="si">${</span><span class="nv">azimuth</span><span class="si">}</span>/<span class="si">${</span><span class="nv">tilt</span><span class="si">}</span>/<span class="si">${</span><span class="nv">twist</span><span class="si [...]
- <span class="si">${</span><span class="nv">REGION</span><span class="si">}</span> -P -Y0.1i -X0.1i USEast_Coast.nc -Iint_<span class="nv">$$</span>.nc -Cglobe_<span class="nv">$$</span>.cpt <span class="se">\</span>
- --PS_MEDIA<span class="o">=</span><span class="si">${</span><span class="nv">px</span><span class="si">}</span>ix<span class="si">${</span><span class="nv">py</span><span class="si">}</span>i -K > <span class="si">${</span><span class="nv">file</span><span class="si">}</span>_<span class="nv">$$</span>.ps
- gmt psxy -JG<span class="si">${</span><span class="nv">lon</span><span class="si">}</span>/<span class="si">${</span><span class="nv">lat</span><span class="si">}</span>/<span class="si">${</span><span class="nv">altitude</span><span class="si">}</span>/<span class="si">${</span><span class="nv">azimuth</span><span class="si">}</span>/<span class="si">${</span><span class="nv">tilt</span><span class="si">}</span>/<span class="si">${</span><span class="nv">twist</span><span class="si">}< [...]
- <span class="si">${</span><span class="nv">REGION</span><span class="si">}</span> -O -K -W1p <span class="nv">$$</span>.path.d >> <span class="si">${</span><span class="nv">file</span><span class="si">}</span>_<span class="nv">$$</span>.ps
- gmt pstext -R0/<span class="si">${</span><span class="nv">px</span><span class="si">}</span>/0/<span class="si">${</span><span class="nv">py</span><span class="si">}</span> -Jx1i -F+f14p,Helvetica-Bold+jTL -O >> <span class="si">${</span><span class="nv">file</span><span class="si">}</span>_<span class="nv">$$</span>.ps <span class="o"><<<</span> <span class="s2">"0 4.6 </span><span class="si">${</span><span class="nv">ID</span><span class="si">}</span><span class="s [...]
- <span class="o">[[</span> <span class="si">${</span><span class="nv">frame</span><span class="si">}</span> -eq <span class="m">0</span> <span class="o">]]</span> <span class="o">&&</span> cp <span class="si">${</span><span class="nv">file</span><span class="si">}</span>_<span class="nv">$$</span>.ps <span class="si">${</span><span class="nv">ps</span><span class="si">}</span>
- <span class="k">if</span> <span class="o">[</span> <span class="nv">$# </span>-eq <span class="m">0</span> <span class="o">]</span><span class="p">;</span> <span class="k">then</span>
- gmt_cleanup .gmt
- gmt_abort <span class="s2">"</span><span class="si">${</span><span class="nv">0</span><span class="si">}</span><span class="s2">: First frame plotted to </span><span class="si">${</span><span class="nv">name</span><span class="si">}</span><span class="s2">.ps"</span>
- <span class="k">fi</span>
- gmt ps2raster <span class="si">${</span><span class="nv">file</span><span class="si">}</span>_<span class="nv">$$</span>.ps -Tt -E<span class="si">${</span><span class="nv">dpi</span><span class="si">}</span>
- mv <span class="si">${</span><span class="nv">file</span><span class="si">}</span>_<span class="nv">$$</span>.tif <span class="nv">$$</span>/<span class="si">${</span><span class="nv">file</span><span class="si">}</span>.tif
- rm -f <span class="si">${</span><span class="nv">file</span><span class="si">}</span>_<span class="nv">$$</span>.ps
- <span class="nb">echo</span> <span class="s2">"Frame </span><span class="si">${</span><span class="nv">file</span><span class="si">}</span><span class="s2"> completed"</span>
-<span class="o">}</span>
-<span class="nv">n_jobs</span><span class="o">=</span>0
-<span class="nv">max_jobs</span><span class="o">=</span><span class="k">$(</span>getconf _NPROCESSORS_ONLN <span class="o">||</span> <span class="nb">echo </span>1<span class="k">)</span>
-<span class="k">while</span> <span class="nb">read </span>lon lat dist<span class="p">;</span> <span class="k">do</span>
- make_frame <span class="si">${</span><span class="nv">frame</span><span class="si">}</span> <span class="si">${</span><span class="nv">lon</span><span class="si">}</span> <span class="si">${</span><span class="nv">lat</span><span class="si">}</span> <span class="si">${</span><span class="nv">dist</span><span class="si">}</span> <span class="p">&</span>
- <span class="o">((</span>++n_jobs<span class="o">))</span>
- <span class="nv">frame</span><span class="o">=</span><span class="sb">`</span>gmt_set_framenext <span class="si">${</span><span class="nv">frame</span><span class="si">}</span><span class="sb">`</span>
- <span class="k">if</span> <span class="o">[</span> <span class="si">${</span><span class="nv">n_jobs</span><span class="si">}</span> -ge <span class="si">${</span><span class="nv">max_jobs</span><span class="si">}</span> <span class="o">]</span><span class="p">;</span> <span class="k">then</span>
- <span class="nb">wait</span>
-<span class="nb"> </span><span class="nv">n_jobs</span><span class="o">=</span>0
- <span class="k">fi</span>
-<span class="k">done</span> < <span class="nv">$$</span>.path.d
-<span class="nb">wait</span>
-
-<span class="nv">file</span><span class="o">=</span><span class="sb">`</span>gmt_set_framename <span class="si">${</span><span class="nv">name</span><span class="si">}</span> 0<span class="sb">`</span>
-
-<span class="nb">echo</span> <span class="s2">"Made </span><span class="si">${</span><span class="nv">frame</span><span class="si">}</span><span class="s2"> frames at 720x480 pixels"</span>
-<span class="c"># GIF animate every 20th frame</span>
-<span class="si">${</span><span class="nv">GRAPHICSMAGICK</span><span class="p">-gm</span><span class="si">}</span> convert -delay <span class="m">40</span> -loop <span class="m">0</span> +dither <span class="nv">$$</span>/<span class="si">${</span><span class="nv">name</span><span class="si">}</span>_*<span class="o">[</span>02468<span class="o">]</span>0.tif <span class="si">${</span><span class="nv">name</span><span class="si">}</span>.gif
-<span class="k">if</span> <span class="nb">type</span> -ft <span class="si">${</span><span class="nv">FFMPEG</span><span class="p">-ffmpeg</span><span class="si">}</span> >/dev/null 2><span class="p">&</span><span class="m">1</span> <span class="p">;</span> <span class="k">then</span>
- <span class="c"># create H.264 video at 25fps</span>
- <span class="nb">echo</span> <span class="s2">"Creating H.264 video"</span>
- <span class="si">${</span><span class="nv">FFMPEG</span><span class="k">:-</span><span class="nv">ffmpeg</span><span class="si">}</span> -loglevel warning -y -f image2 -r <span class="m">25</span> -i <span class="nv">$$</span>/<span class="si">${</span><span class="nv">name</span><span class="si">}</span>_%6d.tif <span class="se">\</span>
- -vcodec libx264 -preset slower -crf <span class="m">25</span> -pix_fmt yuv420p <span class="si">${</span><span class="nv">name</span><span class="si">}</span>.mp4
- <span class="c"># create WebM video</span>
- <span class="nb">echo</span> <span class="s2">"Creating WebM video"</span>
- <span class="si">${</span><span class="nv">FFMPEG</span><span class="k">:-</span><span class="nv">ffmpeg</span><span class="si">}</span> -loglevel warning -y -f image2 -r <span class="m">25</span> -i <span class="nv">$$</span>/<span class="si">${</span><span class="nv">name</span><span class="si">}</span>_%6d.tif <span class="se">\</span>
- -vcodec libvpx -crf <span class="m">10</span> -b:v 1.2M -pix_fmt yuv420p <span class="si">${</span><span class="nv">name</span><span class="si">}</span>.webm
- <span class="c"># create Theora video</span>
- <span class="nb">echo</span> <span class="s2">"Creating Theora video"</span>
- <span class="si">${</span><span class="nv">FFMPEG</span><span class="k">:-</span><span class="nv">ffmpeg</span><span class="si">}</span> -loglevel warning -y -f image2 -r <span class="m">25</span> -i <span class="nv">$$</span>/<span class="si">${</span><span class="nv">name</span><span class="si">}</span>_%6d.tif <span class="se">\</span>
- -vcodec libtheora -q <span class="m">4</span> -pix_fmt yuv420p <span class="si">${</span><span class="nv">name</span><span class="si">}</span>.ogv
-<span class="k">fi</span>
-
-<span class="c"># 4. Clean up temporary files</span>
-gmt_cleanup .gmt
-</pre></div>
-</div>
-<a class="reference internal image-reference" href="../_images/anim_04.png"><img alt="../_images/anim_04.png" src="../_images/anim_04.png" style="width: 0px;" /></a>
-<div class="figure align-center">
- <video width="720" height="480" poster="../_images/anim_04.png" controls>
- <source src="../_static/anim_04.mp4" type="video/mp4">
- <source src="../_static/anim_04.webm" type="video/webm">
- Your browser does not support the video tag.
- </video>
- <p class="caption">Flying over topography.</p>
-</div></div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="anim03.html"
- title="previous chapter">(3) Orbiting a static map</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="../Users_contrib_script.html"
- title="next chapter">Users Script Contributions</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/anim04.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="../Users_contrib_script.html" title="Users Script Contributions"
- >next</a> </li>
- <li class="right" >
- <a href="anim03.html" title="(3) Orbiting a static map"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/anim_introduction.html b/doc_release/html/gallery/anim_introduction.html
deleted file mode 100644
index 4c14fe3..0000000
--- a/doc_release/html/gallery/anim_introduction.html
+++ /dev/null
@@ -1,245 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>Introduction — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(1) Animation of the sine function" href="anim01.html" />
- <link rel="prev" title="(40) Line simplification" href="ex40.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="anim01.html" title="(1) Animation of the sine function"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex40.html" title="(40) Line simplification"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="introduction">
-<h1>Introduction<a class="headerlink" href="#introduction" title="Permalink to this headline">¶</a></h1>
-<p>Here we will explore what is
-involved in creating animations (i.e., movies). Of course, an animation
-is nothing more than a series of individual images played back in an
-orderly fashion. Here, these images will have been created with GMT.
-To ensure a smooth transition from frame to frame we will be following
-some general guidelines when writing our scripts. Since there is no
-“movie” mode in GMT we must take care of all the book-keeping in our
-script. Thus, animations may require a bit of planning and may use more
-advanced scripting than the previous static examples. Note: This is a
-new chapter introduced with the 4.4.0 version and should be considered
-work in progress.</p>
-<p>Most, if not all, animation scripts must deal with several specific
-phases of movie making:</p>
-<ol class="arabic simple">
-<li>Define parameters that determine the dimension of the final movie.</li>
-<li>Pre-calculate all variables, data tables, grids, or background map
-layers that are <em>independent</em> of your time variable.</li>
-<li>Have a frame-number loop where each frame is created as a
-PostScript plot, then rasterized to a TIFF file of chosen
-dimension.</li>
-<li>Convert the individual frames to a single movie of suitable format.</li>
-<li>Clean up temporary files and eventually the individual frames.</li>
-</ol>
-<p>We will discuss these phases in more detail before showing our first
-example.</p>
-<ol class="arabic simple">
-<li>There are several coordinates that you need to consider when planning
-your movie. The first is the coordinates of your data, i.e., the
-<em>user coordinates</em>. As with all GMT plots you will transform those
-to the second set of <em>plot coordinates</em> in inches (or cm) by applying
-a suitable region and map projection. As before, you normally do this
-with a particular paper size in mind. When printed you get a
-high-resolution plot in monochrome or color. However, movies are not
-device-independent and you must finally consider the third set of
-<em>pixel coordinates</em> which specifies the resolution of the final
-movie. We control the frame size by selecting a suitable <em>dpi</em>
-setting that will scale your physical dimensions to the desired frame
-size in pixels. If you decide up front on a particular resolution
-(e.g., 480 by 320 pixels) then you should specify a paper size and
-<em>dpi</em> so that their product yields the desired pixel dimensions. For
-instance, here it might make sense to plan your plotting on a 4.8 by
-3.2 inch “paper” and use 100 <em>dpi</em> to convert it to pixels, but you
-are free to use any combination that multiplies to the desired
-dimensions. After deciding on frame size you need to consider how
-many frames your movie should have. This depends on lots of things
-such as how patient you are, how many frames per second you need and
-the time range of your animation. We recommend you use variables to
-specify the items that go into computing the number of frames so that
-you can easily test your script with a few frames before changing
-settings and running the full Hollywood production overnight.</li>
-<li>Depending on what you want to display, there are usually many
-elements that do not change between frames. Examples include a
-coastline base map for background, an overlay of text legends,
-perhaps some variables that hold information that will be used during
-the movie, and possibly subsets of larger data sets. Since
-movie-making can take a long time if you are ambitious, it is best to
-compute or plot all the elements that can be done outside your main
-frame-loop rather than waste time doing the same thing over and over
-again. You are then ready for the main loop.</li>
-<li>Initialize a frame counter to 0 and have a loop that continues until
-your frame counter equals the desired number of frames. You must use
-your frame counter to create a unique file name for each frame image
-so that the series of images can be lexically arranged. We recommend
-using the GMT shell function <strong>gmt_set_framename</strong> to format
-the frame counter with an adequate number of leading zeros; see our
-examples for details. The bulk of your main loop involves create the
-single PostScript plot for this particular frame (time). This can
-be trivial or a serious scripting exercise depending on what you want
-to show. We will give a few examples with increasing complexity. Once
-the PostScript plot is created you need to rasterize it; we
-recommend you use <a class="reference internal" href="../ps2raster.html"><em>ps2raster</em></a> to
-generate a TIFF image at the agreed-upon resolution. We also
-recommend that you place all frame images in a sub-directory. You may
-increment your frame counter using <strong>gmt_set_framenext</strong>.</li>
-<li>Once you have all your frames you are ready to combine them into an
-animation. There are two general approaches. (a) If your image
-sequence is not too long then you can convert the images into a
-single animated GIF file. This file can be included in PowerPoint
-presentations or placed on a web page and will play back as a movie
-by pausing the specified amount between frames, optionally repeating
-the entire sequence one or more times. (b) For more elaborate
-projects you will need to convert the frames into a proper movie
-format such as Quicktime, AVI, MPEG-2, MPEG-4, etc., etc. There are
-both free and commercial tools that can help with this conversion and
-they tend to be platform-specific. Most movie tools such as iMovie or
-MovieMaker can ingest still images and let you specify the frame
-duration. Under OS X we prefer to use Quicktime 7. <a class="footnote-reference" href="#id2" id="id1">[1]</a> . Another choice is to use the free
-<a class="reference external" href="https://ffmpeg.org/">ffmpeg</a> encoder. You will find yourself
-experimenting with compression settings and movie formats so that the
-final movie has the resolution and portability you require.</li>
-<li>Finally, when all is done you should delete any temporary files
-created. However, since creating the frames may take a lot of time it
-is best to not automatically delete the frame sub directory. That way
-you can redo the frames-to-movie conversion with different settings
-until you are satisfied.</li>
-</ol>
-<table class="docutils footnote" frame="void" id="id2" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id1">[1]</a></td><td>While Quicktime 7 is free you must upgrade to QuickTime Pro (USD 30) to
-use the authoring functions. At some point Apple will discontinue this tool.</td></tr>
-</tbody>
-</table>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex40.html"
- title="previous chapter">(40) Line simplification</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="anim01.html"
- title="next chapter">(1) Animation of the sine function</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/anim_introduction.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="anim01.html" title="(1) Animation of the sine function"
- >next</a> </li>
- <li class="right" >
- <a href="ex40.html" title="(40) Line simplification"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex01.html b/doc_release/html/gallery/ex01.html
deleted file mode 100644
index 17b8d6c..0000000
--- a/doc_release/html/gallery/ex01.html
+++ /dev/null
@@ -1,187 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(1) Contour maps — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(2) Image presentations" href="ex02.html" />
- <link rel="prev" title="The GMT historical collection" href="../Gallery.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex02.html" title="(2) Image presentations"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="../Gallery.html" title="The GMT historical collection"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="contour-maps">
-<span id="example-01"></span><h1>(1) Contour maps<a class="headerlink" href="#contour-maps" title="Permalink to this headline">¶</a></h1>
-<p>We want to create two contour maps of the low order geoid using the
-Hammer equal area projection. Our gridded data file is called <tt class="docutils literal"><span class="pre">osu91a1f_16.nc</span></tt> and
-contains a global 1 by 1 gridded geoid (we will see how to make gridded
-files later). We would like to show one map centered on Greenwich and
-one centered on the dateline. Positive contours should be drawn with a
-solid pen and negative contours with a dashed pen. Annotations should
-occur for every 50 m contour level, and both contour maps should show
-the continents in light brown in the background. Finally, we want a
-rectangular frame surrounding the two maps. This is how it is done:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 01</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Make two contour maps based on the data in the file osu91a1f_16.nc</span>
-<span class="c"># GMT progs: gmtset, grdcontour, psbasemap, pscoast</span>
-<span class="c"># Unix progs: rm</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_01.ps
-gmt gmtset MAP_GRID_CROSS_SIZE_PRIMARY <span class="m">0</span> FONT_ANNOT_PRIMARY 10p
-gmt psbasemap -R0/6.5/0/7.5 -Jx1i -B0 -P -K > <span class="nv">$ps</span>
-gmt pscoast -Rg -JH0/6i -X0.25i -Y0.2i -O -K -Bg30 -Dc -Glightbrown -Slightblue >> <span class="nv">$ps</span>
-gmt grdcontour osu91a1f_16.nc -J -C10 -A50+f7p -Gd4i -L-1000/-1 -Wcthinnest,- -Wathin,- <span class="se">\</span>
- -O -K -T0.1i/0.02i >> <span class="nv">$ps</span>
-gmt grdcontour osu91a1f_16.nc -J -C10 -A50+f7p -Gd4i -L-1/1000 -O -K -T0.1i/0.02i >> <span class="nv">$ps</span>
-gmt pscoast -Rg -JH6i -Y3.4i -O -K -B+t<span class="s2">"Low Order Geoid"</span> -Bg30 -Dc -Glightbrown <span class="se">\</span>
- -Slightblue >> <span class="nv">$ps</span>
-gmt grdcontour osu91a1f_16.nc -J -C10 -A50+f7p -Gd4i -L-1000/-1 -Wcthinnest,- -Wathin,- <span class="se">\</span>
- -O -K -T0.1i/0.02i:-+ >> <span class="nv">$ps</span>
-gmt grdcontour osu91a1f_16.nc -J -C10 -A50+f7p -Gd4i -L-1/1000 -O -T0.1i/0.02i:-+ >> <span class="nv">$ps</span>
-rm -f gmt.conf
-</pre></div>
-</div>
-<p>The first command draws a box surrounding the maps. This is followed by
-two sequences of <a class="reference internal" href="../pscoast.html"><em>pscoast</em></a>, <a class="reference internal" href="../grdcontour.html"><em>grdcontour</em></a>,
-<a class="reference internal" href="../grdcontour.html"><em>grdcontour</em></a>. They differ in that the
-first is centered on Greenwich; the second on the dateline. We use the
-limit option (<strong>-L</strong>) in <a class="reference internal" href="../grdcontour.html"><em>grdcontour</em></a>
-to select negative contours only and plot those with a dashed pen, then
-positive contours only and draw with a solid pen [Default]. The <strong>-T</strong>
-option causes tick marks pointing in the downhill direction to be drawn
-on the innermost, closed contours. For the upper panel we also added -
-and + to the local lows and highs. You can find this illustration as</p>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_01.png"><img alt="../_images/example_01.png" src="../_images/example_01.png" style="width: 500px;" /></a>
-<p class="caption">Contour maps of gridded data.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="../Gallery.html"
- title="previous chapter">The GMT historical collection</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex02.html"
- title="next chapter">(2) Image presentations</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex01.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex02.html" title="(2) Image presentations"
- >next</a> </li>
- <li class="right" >
- <a href="../Gallery.html" title="The GMT historical collection"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex02.html b/doc_release/html/gallery/ex02.html
deleted file mode 100644
index c5fe84f..0000000
--- a/doc_release/html/gallery/ex02.html
+++ /dev/null
@@ -1,209 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(2) Image presentations — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(3) Spectral estimation and xy-plots" href="ex03.html" />
- <link rel="prev" title="(1) Contour maps" href="ex01.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex03.html" title="(3) Spectral estimation and xy-plots"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex01.html" title="(1) Contour maps"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="image-presentations">
-<span id="example-02"></span><h1>(2) Image presentations<a class="headerlink" href="#image-presentations" title="Permalink to this headline">¶</a></h1>
-<p>As our second example we will demonstrate how to make color images from
-gridded data sets (again, we will defer the actual making of grid files
-to later examples). We will use <a class="reference internal" href="../grdraster.html"><em>grdraster</em></a> to extract 2-D grid files
-of bathymetry and Geosat geoid heights and put the two images on the
-same page. The region of interest is the Hawaiian islands, and due to
-the oblique trend of the island chain we prefer to rotate our
-geographical data sets using an oblique Mercator projection defined by
-the hotspot pole at (68W, 69N). We choose the point (190, 25.5) to be
-the center of our projection (e.g., the local origin), and we want to
-image a rectangular region defined by the longitudes and latitudes of
-the lower left and upper right corner of region. In our case we choose
-(160, 20) and (220, 30) as the corners. We use
-<a class="reference internal" href="../grdimage.html"><em>grdimage</em></a> to make the illustration:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 02</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Make two color images based gridded data</span>
-<span class="c"># GMT progs: gmtset, grd2cpt, grdgradient, grdimage, makecpt, psscale, pstext</span>
-<span class="c"># Unix progs: rm</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_02.ps
-gmt gmtset FONT_TITLE 30p MAP_ANNOT_OBLIQUE 0
-gmt makecpt -Crainbow -T-2/14/2 > g.cpt
-gmt grdimage HI_geoid2.nc -R160/20/220/30r -JOc190/25.5/292/69/4.5i -E50 -K -P <span class="se">\</span>
- -B10 -Cg.cpt -X1.5i -Y1.25i > <span class="nv">$ps</span>
-gmt psscale -Cg.cpt -D5.1i/1.35i/2.88i/0.4i -O -K -Ac -Bx2+lGEOID -By+lm -E >> <span class="nv">$ps</span>
-gmt grd2cpt HI_topo2.nc -Crelief -Z > t.cpt
-gmt grdgradient HI_topo2.nc -A0 -Nt -GHI_topo2_int.nc
-gmt grdimage HI_topo2.nc -IHI_topo2_int.nc -R -J -B+t<span class="s2">"H@#awaiian@# T@#opo and @#G@#eoid"</span> <span class="se">\</span>
- -B10 -E50 -O -K -Ct.cpt -Y4.5i --MAP_TITLE_OFFSET<span class="o">=</span>0.5i >> <span class="nv">$ps</span>
-gmt psscale -Ct.cpt -D5.1i/1.35i/2.88i/0.4i -O -K -I0.3 -Ac -Bx2+lTOPO -By+lkm >> <span class="nv">$ps</span>
-gmt pstext -R0/8.5/0/11 -Jx1i -F+f30p,Helvetica-Bold+jCB -O -N -Y-4.5i >> <span class="nv">$ps</span> <span class="s"><< END</span>
-<span class="s">-0.4 7.5 a)</span>
-<span class="s">-0.4 3.0 b)</span>
-<span class="s">END</span>
-rm -f HI_topo2_int.nc ?.cpt gmt.conf
-</pre></div>
-</div>
-<p>The first step extracts the 2-D data sets from the local data base using
-<a class="reference internal" href="../grdraster.html"><em>grdraster</em></a> that may be adapted to reflect
-the nature of your data base format. It automatically figures out the
-required extent of the region given the two corners points and the
-projection. The extreme meridians and parallels enclosing the oblique
-region is <strong>-R</strong>159:50/220:10/3:10/47:35. This is the area extracted
-by <a class="reference internal" href="../grdraster.html"><em>grdraster</em></a>. For your convenience
-we have commented out those lines and provided the two extracted files
-so you do not need <a class="reference internal" href="../grdraster.html"><em>grdraster</em></a> to try
-this example. By using the embedded grid file format mechanism we saved
-the topography using kilometers as the data unit. We now have two grid
-files with bathymetry and geoid heights, respectively. We use
-<a class="reference internal" href="../makecpt.html"><em>makecpt</em></a> to generate a linear color
-palette file <tt class="docutils literal"><span class="pre">geoid.cpt</span></tt> for the geoid and use
-<a class="reference internal" href="../grd2cpt.html"><em>grd2cpt</em></a> to get a histogram-equalized
-cpt file <tt class="docutils literal"><span class="pre">topo.cpt</span></tt> for the topography data. To emphasize the structures in the
-data we calculate the slopes in the north-south direction using
-<a class="reference internal" href="../grdgradient.html"><em>grdgradient</em></a>; these will be used to
-modulate the color image. Next we run
-<a class="reference internal" href="../grdimage.html"><em>grdimage</em></a> to create a color-code image
-of the Geosat geoid heights, and draw a color legend to the right of the
-image with <a class="reference internal" href="../psscale.html"><em>psscale</em></a>. Similarly, we run
-<a class="reference internal" href="../grdimage.html"><em>grdimage</em></a> but specify <strong>-Y</strong>4.5i to
-plot above the previous image. Adding scale and label the two plots a)
-and b) completes the illustration.</p>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_02.png"><img alt="../_images/example_02.png" src="../_images/example_02.png" style="width: 500px;" /></a>
-<p class="caption">Color images from gridded data.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex01.html"
- title="previous chapter">(1) Contour maps</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex03.html"
- title="next chapter">(3) Spectral estimation and xy-plots</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex02.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex03.html" title="(3) Spectral estimation and xy-plots"
- >next</a> </li>
- <li class="right" >
- <a href="ex01.html" title="(1) Contour maps"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex03.html b/doc_release/html/gallery/ex03.html
deleted file mode 100644
index cc0ac54..0000000
--- a/doc_release/html/gallery/ex03.html
+++ /dev/null
@@ -1,383 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(3) Spectral estimation and xy-plots — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(4) A 3-D perspective mesh plot" href="ex04.html" />
- <link rel="prev" title="(2) Image presentations" href="ex02.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex04.html" title="(4) A 3-D perspective mesh plot"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex02.html" title="(2) Image presentations"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="spectral-estimation-and-xy-plots">
-<span id="example-03"></span><h1>(3) Spectral estimation and xy-plots<a class="headerlink" href="#spectral-estimation-and-xy-plots" title="Permalink to this headline">¶</a></h1>
-<p>In this example we will show how to use the GMT programs
-<a class="reference internal" href="../fitcircle.html"><em>fitcircle</em></a>, <a class="reference internal" href="../project.html"><em>project</em></a>,
-<a class="reference internal" href="../sample1d.html"><em>sample1d</em></a>, <a class="reference internal" href="../spectrum1d.html"><em>spectrum1d</em></a>,
-<a class="reference internal" href="../psxy.html"><em>psxy</em></a>, and
-<a class="reference internal" href="../pstext.html"><em>pstext</em></a>. Suppose you have (lon, lat,
-gravity) along a satellite track in a file called <tt class="docutils literal"><span class="pre">sat.xyg</span></tt>, and (lon, lat,
-gravity) along a ship track in a file called <tt class="docutils literal"><span class="pre">ship.xyg</span></tt>. You want to make a
-cross-spectral analysis of these data. First, you will have to get the
-two data sets into equidistantly sampled time-series form. To do this,
-it will be convenient to project these along the great circle that best
-fits the sat track. We must use
-<a class="reference internal" href="../fitcircle.html"><em>fitcircle</em></a> to find this great circle
-and choose the L<sub>2</sub> estimates of best pole. We project the data
-using <a class="reference internal" href="../project.html"><em>project</em></a> to find out what their
-ranges are in the projected coordinate. The
-<a class="reference internal" href="../gmtinfo.html"><em>gmtinfo</em></a> utility will report the minimum
-and maximum values for multi-column ASCII tables. Use this information
-to select the range of the projected distance coordinate they have in
-common. The script prompts you for that information after reporting the
-values. We decide to make a file of equidistant sampling points spaced 1
-km apart from -1167 to +1169, and use the UNIX utility <strong>awk</strong> to
-accomplish this step. We can then resample the projected data, and carry
-out the cross-spectral calculations, assuming that the ship is the input
-and the satellite is the output data. There are several intermediate
-steps that produce helpful plots showing the effect of the various
-processing steps (<tt class="docutils literal"><span class="pre">example_03[a-f].ps</span></tt>), while the final plot <tt class="docutils literal"><span class="pre">example_03.ps</span></tt> shows the ship and sat power
-in one diagram and the coherency on another diagram, both on the same
-page. Note the extended use of <a class="reference internal" href="../pstext.html"><em>pstext</em></a>
-and <a class="reference internal" href="../psxy.html"><em>psxy</em></a> to put labels and legends
-directly on the plots. For that purpose we often use <strong>-Jx</strong>1i and
-specify positions in inches directly. Thus, the complete automated script reads:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 03</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Resample track data, do spectral analysis, and plot</span>
-<span class="c"># GMT progs: filter1d, fitcircle, gmtinfo, project, sample1d</span>
-<span class="c"># GMT progs: spectrum1d, trend1d, pshistogram, psxy, pstext</span>
-<span class="c"># Unix progs: $AWK, cat, echo, head, paste, rm, tail</span>
-<span class="c">#</span>
-<span class="c"># This example begins with data files "ship.xyg" and "sat.xyg" which</span>
-<span class="c"># are measurements of a quantity "g" (a "gravity anomaly" which is an</span>
-<span class="c"># anomalous increase or decrease in the magnitude of the acceleration</span>
-<span class="c"># of gravity at sea level). g is measured at a sequence of points "x,y"</span>
-<span class="c"># which in this case are "longitude,latitude". The "sat.xyg" data were</span>
-<span class="c"># obtained by a satellite and the sequence of points lies almost along</span>
-<span class="c"># a great circle. The "ship.xyg" data were obtained by a ship which</span>
-<span class="c"># tried to follow the satellite's path but deviated from it in places.</span>
-<span class="c"># Thus the two data sets are not measured at the same of points,</span>
-<span class="c"># and we use various GMT tools to facilitate their comparison.</span>
-<span class="c"># The main illustration (example_03.ps) are accompanied with 5 support</span>
-<span class="c"># plots (03a-f) showing data distributions and various intermediate steps.</span>
-<span class="c">#</span>
-<span class="c"># First, we use "gmt fitcircle" to find the parameters of a great circle</span>
-<span class="c"># most closely fitting the x,y points in "sat.xyg":</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_03.ps
-gmt fitcircle sat.xyg -L2 > report
-<span class="nv">cposx</span><span class="o">=</span><span class="sb">`</span>grep <span class="s2">"L2 Average Position"</span> report <span class="p">|</span> cut -f1<span class="sb">`</span>
-<span class="nv">cposy</span><span class="o">=</span><span class="sb">`</span>grep <span class="s2">"L2 Average Position"</span> report <span class="p">|</span> cut -f2<span class="sb">`</span>
-<span class="nv">pposx</span><span class="o">=</span><span class="sb">`</span>grep <span class="s2">"L2 N Hemisphere"</span> report <span class="p">|</span> cut -f1<span class="sb">`</span>
-<span class="nv">pposy</span><span class="o">=</span><span class="sb">`</span>grep <span class="s2">"L2 N Hemisphere"</span> report <span class="p">|</span> cut -f2<span class="sb">`</span>
-<span class="c">#</span>
-<span class="c"># Now we use "gmt project" to gmt project the data in both sat.xyg and ship.xyg</span>
-<span class="c"># into data.pg, where g is the same and p is the oblique longitude around</span>
-<span class="c"># the great circle. We use -Q to get the p distance in kilometers, and -S</span>
-<span class="c"># to sort the output into increasing p values.</span>
-<span class="c">#</span>
-gmt project sat.xyg -C<span class="nv">$cposx</span>/<span class="nv">$cposy</span> -T<span class="nv">$pposx</span>/<span class="nv">$pposy</span> -S -Fpz -Q > sat.pg
-gmt project ship.xyg -C<span class="nv">$cposx</span>/<span class="nv">$cposy</span> -T<span class="nv">$pposx</span>/<span class="nv">$pposy</span> -S -Fpz -Q > ship.pg
-<span class="c">#</span>
-<span class="c"># The gmtinfo utility will report the minimum and maximum values for all columns. </span>
-<span class="c"># We use this information first with a large -I value to find the appropriate -R</span>
-<span class="c"># to use to plot the .pg data. </span>
-<span class="c">#</span>
-<span class="nv">R</span><span class="o">=</span><span class="sb">`</span>cat sat.pg ship.pg <span class="p">|</span> gmt info -I100/25<span class="sb">`</span>
-gmt psxy <span class="nv">$R</span> -UL/-1.75i/-1.25i/<span class="s2">"Example 3a in Cookbook"</span> -BWeSn <span class="se">\</span>
- -Bxa500f100+l<span class="s2">"Distance along great circle"</span> -Bya100f25+l<span class="s2">"Gravity anomaly (mGal)"</span> <span class="se">\</span>
- -JX8i/5i -X2i -Y1.5i -K -Wthick sat.pg > example_03a.ps
-gmt psxy -R -JX -O -Sp0.03i ship.pg >> example_03a.ps
-<span class="c">#</span>
-<span class="c"># From this plot we see that the ship data have some "spikes" and also greatly</span>
-<span class="c"># differ from the satellite data at a point about p ~= +250 km, where both of</span>
-<span class="c"># them show a very large anomaly.</span>
-<span class="c">#</span>
-<span class="c"># To facilitate comparison of the two with a cross-spectral analysis using "gmt spectrum1d",</span>
-<span class="c"># we resample both data sets at intervals of 1 km. First we find out how the data are</span>
-<span class="c"># typically spaced using $AWK to get the delta-p between points and view it with </span>
-<span class="c"># "gmt pshistogram".</span>
-<span class="c">#</span>
-<span class="nv">$AWK</span> <span class="s1">'{ if (NR > 1) print $1 - last1; last1=$1; }'</span> ship.pg <span class="p">|</span> gmt pshistogram -W0.1 -Gblack <span class="se">\</span>
- -JX3i -K -X2i -Y1.5i -B0 -B+t<span class="s2">"Ship"</span> -UL/-1.75i/-1.25i/<span class="s2">"Example 3b in Cookbook"</span> <span class="se">\</span>
- > example_03b.ps
-<span class="nv">$AWK</span> <span class="s1">'{ if (NR > 1) print $1 - last1; last1=$1; }'</span> sat.pg <span class="p">|</span> gmt pshistogram -W0.1 -Gblack <span class="se">\</span>
- -JX3i -O -X5i -B0 -B+t<span class="s2">"Sat"</span> >> example_03b.ps
-<span class="c">#</span>
-<span class="c"># This experience shows that the satellite values are spaced fairly evenly, with</span>
-<span class="c"># delta-p between 3.222 and 3.418. The ship values are spaced quite unevenly, with</span>
-<span class="c"># delta-p between 0.095 and 9.017. This means that when we want 1 km even sampling,</span>
-<span class="c"># we can use "gmt sample1d" to interpolate the sat data, but the same procedure applied</span>
-<span class="c"># to the ship data could alias information at shorter wavelengths. So we have to use</span>
-<span class="c"># "gmt filter1d" to resample the ship data. Also, since we observed spikes in the ship</span>
-<span class="c"># data, we use a median filter to clean up the ship values. We will want to use "paste"</span>
-<span class="c"># to put the two sampled data sets together, so they must start and end at the same</span>
-<span class="c"># point, without NaNs. So we want to get a starting and ending point which works for</span>
-<span class="c"># both of them. This is a job for gmt gmtmath UPPER/LOWER.</span>
-<span class="c">#</span>
-head -1 ship.pg > tmp
-head -1 sat.pg >> tmp
-<span class="nv">sampr1</span><span class="o">=</span><span class="sb">`</span>gmt gmtmath tmp -Ca -Sf -o0 UPPER <span class="nv">CEIL</span> <span class="o">=</span><span class="sb">`</span>
-tail -1 ship.pg > tmp
-tail -1 sat.pg >> tmp
-<span class="nv">sampr2</span><span class="o">=</span><span class="sb">`</span>gmt gmtmath tmp -Ca -Sf -o0 LOWER <span class="nv">FLOOR</span> <span class="o">=</span><span class="sb">`</span>
-<span class="c">#</span>
-<span class="c"># Now we can use sampr1|2 in gmt gmtmath to make a sampling points file for gmt sample1d:</span>
-gmt gmtmath -T<span class="nv">$sampr1</span>/<span class="nv">$sampr2</span>/1 -N1/0 <span class="nv">T</span> <span class="o">=</span> samp.x
-<span class="c">#</span>
-<span class="c"># Now we can resample the gmt projected satellite data:</span>
-<span class="c">#</span>
-gmt sample1d sat.pg -Nsamp.x > samp_sat.pg
-<span class="c">#</span>
-<span class="c"># For reasons above, we use gmt filter1d to pre-treat the ship data. We also need to sample</span>
-<span class="c"># it because of the gaps > 1 km we found. So we use gmt filter1d | gmt sample1d. We also</span>
-<span class="c"># use the -E on gmt filter1d to use the data all the way out to sampr1/sampr2 :</span>
-<span class="c">#</span>
-gmt filter1d ship.pg -Fm1 -T<span class="nv">$sampr1</span>/<span class="nv">$sampr2</span>/1 -E <span class="p">|</span> gmt sample1d -Nsamp.x > samp_ship.pg
-<span class="c">#</span>
-<span class="c"># Now we plot them again to see if we have done the right thing:</span>
-<span class="c">#</span>
-gmt psxy <span class="nv">$R</span> -JX8i/5i -X2i -Y1.5i -K -Wthick samp_sat.pg <span class="se">\</span>
- -Bxa500f100+l<span class="s2">"Distance along great circle"</span> -Bya100f25+l<span class="s2">"Gravity anomaly (mGal)"</span> <span class="se">\</span>
- -BWeSn -UL/-1.75i/-1.25i/<span class="s2">"Example 3c in Cookbook"</span> > example_03c.ps
-gmt psxy -R -JX -O -Sp0.03i samp_ship.pg >> example_03c.ps
-<span class="c">#</span>
-<span class="c"># Now to do the cross-spectra, assuming that the ship is the input and the sat is the output </span>
-<span class="c"># data, we do this:</span>
-<span class="c"># </span>
-gmt gmtconvert -A samp_ship.pg samp_sat.pg -o1,3 <span class="p">|</span> gmt spectrum1d -S256 -D1 -W -C > /dev/null
-<span class="c"># </span>
-<span class="c"># Now we want to plot the spectra. The following commands will plot the ship and sat </span>
-<span class="c"># power in one diagram and the coherency on another diagram, both on the same page. </span>
-<span class="c"># Note the extended use of gmt pstext and gmt psxy to put labels and legends directly on the</span>
-<span class="c"># plots. For that purpose we often use -Jx1i and specify positions in inches directly:</span>
-<span class="c">#</span>
-gmt psxy spectrum.coh -Bxa1f3p+l<span class="s2">"Wavelength (km)"</span> -Bya0.25f0.05+l<span class="s2">"Coherency at +2@+"</span> <span class="se">\</span>
- -BWeSn+g240/255/240 -JX-4il/3.75i -R1/1000/0/1 -P -K -X2.5i -Sc0.07i -Gpurple <span class="se">\</span>
- -Ey/0.5p -Y1.5i > <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"3.85 3.6 Coherency at +2@+"</span> <span class="p">|</span> gmt pstext -R0/4/0/3.75 -Jx1i -F+f18p,Helvetica-Bold+jTR <span class="se">\</span>
- -O -K >> <span class="nv">$ps</span>
-gmt psxy spectrum.xpower -Bxa1f3p -Bya1f3p+l<span class="s2">"Power (mGal at +2@+km)"</span> <span class="se">\</span>
- -BWeSn+t<span class="s2">"Ship and Satellite Gravity"</span>+g240/255/240 <span class="se">\</span>
- -Gred -ST0.07i -O -R1/1000/0.1/10000 -JX-4il/3.75il -Y4.2i -K -Ey/0.5p >> <span class="nv">$ps</span>
-gmt psxy spectrum.ypower -R -JX -O -K -Gblue -Sc0.07i -Ey/0.5p >> <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"3.9 3.6 Input Power"</span> <span class="p">|</span> gmt pstext -R0/4/0/3.75 -Jx -F+f18p,Helvetica-Bold+jTR -O -K >> <span class="nv">$ps</span>
-gmt psxy -R -Jx -O -K -Gwhite -L -Wthicker >> <span class="nv">$ps</span> <span class="s"><< END</span>
-<span class="s">0.25 0.25</span>
-<span class="s">1.4 0.25</span>
-<span class="s">1.4 0.9</span>
-<span class="s">0.25 0.9</span>
-<span class="s">END</span>
-<span class="nb">echo</span> <span class="s2">"0.4 0.7"</span> <span class="p">|</span> gmt psxy -R -Jx -O -K -ST0.07i -Gred >> <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"0.5 0.7 Ship"</span> <span class="p">|</span> gmt pstext -R -Jx -F+f14p,Helvetica-Bold+jLM -O -K >> <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"0.4 0.4"</span> <span class="p">|</span> gmt psxy -R -Jx -O -K -Sc0.07i -Gblue >> <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"0.5 0.4 Satellite"</span> <span class="p">|</span> gmt pstext -R -Jx -F+f14p,Helvetica-Bold+jLM -O >> <span class="nv">$ps</span>
-<span class="c">#</span>
-<span class="c"># Now we wonder if removing that large feature at 250 km would make any difference.</span>
-<span class="c"># We could throw away a section of data with $AWK or sed or head and tail, but we</span>
-<span class="c"># demonstrate the use of "gmt trend1d" to identify outliers instead. We will fit a</span>
-<span class="c"># straight line to the samp_ship.pg data by an iteratively-reweighted method and</span>
-<span class="c"># save the weights on output. Then we will plot the weights and see how things</span>
-<span class="c"># look:</span>
-<span class="c">#</span>
-gmt trend1d -Fxw -N2r samp_ship.pg > samp_ship.xw
-gmt psxy <span class="nv">$R</span> -JX8i/4i -X2i -Y1.5i -K -Sp0.03i <span class="se">\</span>
- -Bxa500f100+l<span class="s2">"Distance along great circle"</span> -Bya100f25+l<span class="s2">"Gravity anomaly (mGal)"</span> <span class="se">\</span>
- -BWeSn -UL/-1.75i/-1.25i/<span class="s2">"Example 3d in Cookbook"</span> samp_ship.pg > example_03d.ps
-<span class="nv">R</span><span class="o">=</span><span class="sb">`</span>gmt info samp_ship.xw -I100/1.1<span class="sb">`</span>
-gmt psxy <span class="nv">$R</span> -JX8i/1.1i -O -Y4.25i -Bxf100 -Bya0.5f0.1+l<span class="s2">"Weight"</span> -BWesn -Sp0.03i <span class="se">\</span>
- samp_ship.xw >> example_03d.ps
-<span class="c">#</span>
-<span class="c"># From this we see that we might want to throw away values where w < 0.6. So we try that,</span>
-<span class="c"># and this time we also use gmt trend1d to return the residual from the model fit (the </span>
-<span class="c"># de-trended data):</span>
-gmt trend1d -Fxrw -N2r samp_ship.pg <span class="p">|</span> <span class="nv">$AWK</span> <span class="s1">'{ if ($3 > 0.6) print $1, $2 }'</span> <span class="se">\</span>
- <span class="p">|</span> gmt sample1d -Nsamp.x > samp2_ship.pg
-gmt trend1d -Fxrw -N2r samp_sat.pg <span class="p">|</span> <span class="nv">$AWK</span> <span class="s1">'{ if ($3 > 0.6) print $1, $2 }'</span> <span class="se">\</span>
- <span class="p">|</span> gmt sample1d -Nsamp.x > samp2_sat.pg
-<span class="c">#</span>
-<span class="c"># We plot these to see how they look:</span>
-<span class="c">#</span>
-<span class="nv">R</span><span class="o">=</span><span class="sb">`</span>cat samp2_sat.pg samp2_ship.pg <span class="p">|</span> gmt info -I100/25<span class="sb">`</span>
-gmt psxy <span class="nv">$R</span> -JX8i/5i -X2i -Y1.5i -K -Wthick <span class="se">\</span>
- -Bxa500f100+l<span class="s2">"Distance along great circle"</span> -Bya50f25+l<span class="s2">"Gravity anomaly (mGal)"</span> <span class="se">\</span>
- -BWeSn -UL/-1.75i/-1.25i/<span class="s2">"Example 3e in Cookbook"</span> samp2_sat.pg > example_03e.ps
-gmt psxy -R -JX -O -Sp0.03i samp2_ship.pg >> example_03e.ps
-<span class="c">#</span>
-<span class="c"># Now we do the cross-spectral analysis again. Comparing this plot (example_03e.ps) with</span>
-<span class="c"># the previous one (example_03d.ps) we see that throwing out the large feature has reduced</span>
-<span class="c"># the power in both data sets and reduced the coherency at wavelengths between 20--60 km.</span>
-<span class="c">#</span>
-gmt gmtconvert -A samp2_ship.pg samp2_sat.pg -o1,3 <span class="p">|</span> gmt spectrum1d -S256 -D1 -W -C > /dev/null
-<span class="c"># </span>
-gmt psxy spectrum.coh -Bxa1f3p+l<span class="s2">"Wavelength (km)"</span> -Bya0.25f0.05+l<span class="s2">"Coherency at +2@+"</span> -BWeSn <span class="se">\</span>
- -JX-4il/3.75i -R1/1000/0/1 -UL/-2.25i/-1.25i/<span class="s2">"Example 3f in Cookbook"</span> -P -K -X2.5i <span class="se">\</span>
- -Sc0.07i -Gblack -Ey/0.5p -Y1.5i > example_03f.ps
-<span class="nb">echo</span> <span class="s2">"3.85 3.6 Coherency at +2@+"</span> <span class="p">|</span> gmt pstext -R0/4/0/3.75 -Jx -F+f18p,Helvetica-Bold+jTR -O <span class="se">\</span>
- -K >> example_03f.ps
-cat > box.d <span class="s"><< END</span>
-<span class="s">2.375 3.75</span>
-<span class="s">2.375 3.25</span>
-<span class="s">4 3.25</span>
-<span class="s">END</span>
-gmt psxy -R -Jx -O -K -Wthicker box.d >> example_03f.ps
-gmt psxy -Bxa1f3p -Bya1f3p+l<span class="s2">"Power (mGal at +2@+km)"</span> -BWeSn+t<span class="s2">"Ship and Satellite Gravity"</span> <span class="se">\</span>
- spectrum.xpower -ST0.07i -O -R1/1000/0.1/10000 -JX-4il/3.75il -Y4.2i -K -Ey/0.5p <span class="se">\</span>
- >> example_03f.ps
-gmt psxy spectrum.ypower -R -JX -O -K -Gblack -Sc0.07i -Ey/0.5p >> example_03f.ps
-<span class="nb">echo</span> <span class="s2">"3.9 3.6 Input Power"</span> <span class="p">|</span> gmt pstext -R0/4/0/3.75 -Jx -F+f18p,Helvetica-Bold+jTR -O <span class="se">\</span>
- -K >> example_03f.ps
-gmt psxy -R -Jx -O -K -Wthicker box.d >> example_03f.ps
-gmt psxy -R -Jx -O -K -Glightgray -L -Wthicker >> example_03f.ps <span class="s"><< END</span>
-<span class="s">0.25 0.25</span>
-<span class="s">1.4 0.25</span>
-<span class="s">1.4 0.9</span>
-<span class="s">0.25 0.9</span>
-<span class="s">END</span>
-<span class="nb">echo</span> <span class="s2">"0.4 0.7"</span> <span class="p">|</span> gmt psxy -R -Jx -O -K -ST0.07i -Gblack >> example_03f.ps
-<span class="nb">echo</span> <span class="s2">"0.5 0.7 Ship"</span> <span class="p">|</span> gmt pstext -R -Jx -F+f14p,Helvetica-Bold+jLM -O -K >> example_03f.ps
-<span class="nb">echo</span> <span class="s2">"0.4 0.4"</span> <span class="p">|</span> gmt psxy -R -Jx -O -K -Sc0.07i -Gblack >> example_03f.ps
-<span class="nb">echo</span> <span class="s2">"0.5 0.4 Satellite"</span> <span class="p">|</span> gmt pstext -R -Jx -F+f14p,Helvetica-Bold+jLM -O >> example_03f.ps
-<span class="c">#</span>
-rm -f box.d report tmp samp* *.pg *.extr spectrum.*
-</pre></div>
-</div>
-<p>The final illustration shows that the
-ship gravity anomalies have more power than altimetry derived gravity
-for short wavelengths and that the coherency between the two signals
-improves dramatically for wavelengths > 20 km.</p>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_03.png"><img alt="../_images/example_03.png" src="../_images/example_03.png" style="width: 500px;" /></a>
-<p class="caption">Spectral estimation and x=y-plots.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex02.html"
- title="previous chapter">(2) Image presentations</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex04.html"
- title="next chapter">(4) A 3-D perspective mesh plot</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex03.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex04.html" title="(4) A 3-D perspective mesh plot"
- >next</a> </li>
- <li class="right" >
- <a href="ex02.html" title="(2) Image presentations"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex04.html b/doc_release/html/gallery/ex04.html
deleted file mode 100644
index 7d7adc5..0000000
--- a/doc_release/html/gallery/ex04.html
+++ /dev/null
@@ -1,215 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(4) A 3-D perspective mesh plot — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(5) A 3-D illuminated surface (in bw)" href="ex05.html" />
- <link rel="prev" title="(3) Spectral estimation and xy-plots" href="ex03.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex05.html" title="(5) A 3-D illuminated surface (in bw)"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex03.html" title="(3) Spectral estimation and xy-plots"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="a-3-d-perspective-mesh-plot">
-<span id="example-04"></span><h1>(4) A 3-D perspective mesh plot<a class="headerlink" href="#a-3-d-perspective-mesh-plot" title="Permalink to this headline">¶</a></h1>
-<p>This example will illustrate how to make a fairly complicated composite
-figure. We need a subset of the ETOPO5 bathymetry <a class="footnote-reference" href="#id2" id="id1">[1]</a> and Geosat geoid
-data sets which we will extract from the local data bases using
-<a class="reference internal" href="../grdraster.html"><em>grdraster</em></a>. We would like to show a
-2-layer perspective plot where layer one shows a contour map of the
-marine geoid with the location of the Hawaiian islands superposed, and a
-second layer showing the 3-D mesh plot of the topography. We also add an
-arrow pointing north and some text. The first part of this script shows
-how to do it:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 04</span>
-<span class="c">#</span>
-<span class="c"># Purpose: 3-D mesh and color plot of Hawaiian topography and geoid</span>
-<span class="c"># GMT progs: grdcontour, grdgradient, grdimage, grdview, psbasemap, pscoast, pstext</span>
-<span class="c"># Unix progs: echo, rm</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_04.ps
-<span class="nb">echo</span> <span class="s1">'-10 255 0 255'</span> > zero.cpt
-<span class="nb">echo</span> <span class="s1">' 0 100 10 100'</span> >> zero.cpt
-gmt grdcontour HI_geoid4.nc -R195/210/18/25 -Jm0.45i -p60/30 -C1 -A5+o -Gd4i -K -P <span class="se">\</span>
- -X1.25i -Y1.25i > <span class="nv">$ps</span>
-gmt pscoast -R -J -p -B2 -BNEsw -Gblack -O -K -T209/19.5/1i >> <span class="nv">$ps</span>
-gmt grdview HI_topo4.nc -R195/210/18/25/-6/4 -J -Jz0.34i -p -Czero.cpt -O -K <span class="se">\</span>
- -N-6+glightgray -Qsm -B2 -Bz2+l<span class="s2">"Topo (km)"</span> -BneswZ -Y2.2i >> <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s1">'3.25 5.75 H@#awaiian@# R@#idge'</span> <span class="p">|</span> gmt pstext -R0/10/0/10 -Jx1i <span class="se">\</span>
- -F+f60p,ZapfChancery-MediumItalic+jCB -O >> <span class="nv">$ps</span>
-rm -f zero.cpt
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_04c.ps
-gmt grdgradient HI_geoid4.nc -A0 -Gg_intens.nc -Nt0.75 -fg
-gmt grdgradient HI_topo4.nc -A0 -Gt_intens.nc -Nt0.75 -fg
-gmt grdimage HI_geoid4.nc -Ig_intens.nc -R195/210/18/25 -JM6.75i -p60/30 -Cgeoid.cpt -E100 <span class="se">\</span>
- -K -P -X1.25i -Y1.25i > <span class="nv">$ps</span>
-gmt pscoast -R -J -p -B2 -BNEsw -Gblack -O -K >> <span class="nv">$ps</span>
-gmt psbasemap -R -J -p -O -K -T209/19.5/1i --COLOR_BACKGROUND<span class="o">=</span>red --FONT<span class="o">=</span>red <span class="se">\</span>
- --MAP_TICK_PEN_PRIMARY<span class="o">=</span>thinner,red >> <span class="nv">$ps</span>
-gmt psscale -R -J -p240/30 -D3.375i/-0.5i/5i/0.3ih -Cgeoid.cpt -I -O -K -Bx2+l<span class="s2">"Geoid (m)"</span> >> <span class="nv">$ps</span>
-gmt grdview HI_topo4.nc -It_intens.nc -R195/210/18/25/-6/4 -J -JZ3.4i -p60/30 -Ctopo.cpt <span class="se">\</span>
- -O -K -N-6+glightgray -Qc100 -B2 -Bz2+l<span class="s2">"Topo (km)"</span> -BneswZ -Y2.2i >> <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s1">'3.25 5.75 H@#awaiian@# R@#idge'</span> <span class="p">|</span> gmt pstext -R0/10/0/10 -Jx1i <span class="se">\</span>
- -F+f60p,ZapfChancery-MediumItalic+jCB -O >> <span class="nv">$ps</span>
-rm -f *_intens.nc
-</pre></div>
-</div>
-<p>The purpose of the color palette file <tt class="docutils literal"><span class="pre">zero.cpt</span></tt> is to have the positive topography
-mesh painted light gray (the remainder is white). The left side of
-Figure shows the complete illustration.</p>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_04.png"><img alt="../_images/example_04.png" src="../_images/example_04.png" style="width: 500px;" /></a>
-<p class="caption">3-D perspective mesh plot (left) and colored version (right).</p>
-</div>
-<p>The second part of the script shows how to make the color version of
-this figure that was printed in our first article in <em>EOS Trans. AGU</em> (8
-October 1991). Using <a class="reference internal" href="../grdview.html"><em>grdview</em></a> one can
-choose to either plot a mesh surface (left) or a color-coded surface
-(right). We have also added artificial illumination from a light-source
-due north, which is simulated by computing the gradient of the surface
-grid in that direction though the
-<a class="reference internal" href="../grdgradient.html"><em>grdgradient</em></a> program. We choose to
-use the <strong>-Qc</strong> option in <a class="reference internal" href="../grdview.html"><em>grdview</em></a> to
-achieve a high degree of smoothness. Here, we select 100 dpi since that
-will be the resolution of our final raster (The EOS raster was 300 dpi).
-Note that the size of the resulting output file is directly dependent on
-the square of the dpi chosen for the scanline conversion and how well
-the resulting image compresses. A higher value for dpi in <strong>-Qc</strong> would
-have resulted in a much larger output file. The CPT files were taken
-from Section [sec:example<sub>0</sub>2].</p>
-<table class="docutils footnote" frame="void" id="id2" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id1">[1]</a></td><td>These data are available on CD-ROM from NGDC (www.ngdc.noaa.gov).</td></tr>
-</tbody>
-</table>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex03.html"
- title="previous chapter">(3) Spectral estimation and xy-plots</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex05.html"
- title="next chapter">(5) A 3-D illuminated surface (in bw)</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex04.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex05.html" title="(5) A 3-D illuminated surface (in bw)"
- >next</a> </li>
- <li class="right" >
- <a href="ex03.html" title="(3) Spectral estimation and xy-plots"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex05.html b/doc_release/html/gallery/ex05.html
deleted file mode 100644
index 6d06b40..0000000
--- a/doc_release/html/gallery/ex05.html
+++ /dev/null
@@ -1,187 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(5) A 3-D illuminated surface (in bw) — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(6) Plotting of histograms" href="ex06.html" />
- <link rel="prev" title="(4) A 3-D perspective mesh plot" href="ex04.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex06.html" title="(6) Plotting of histograms"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex04.html" title="(4) A 3-D perspective mesh plot"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="a-3-d-illuminated-surface-in-bw">
-<span id="example-05"></span><h1>(5) A 3-D illuminated surface (in bw)<a class="headerlink" href="#a-3-d-illuminated-surface-in-bw" title="Permalink to this headline">¶</a></h1>
-<p>Instead of a mesh plot we may choose to show 3-D surfaces using
-artificial illumination. For this example we will use
-<a class="reference internal" href="../grdmath.html"><em>grdmath</em></a> to make a grid file that
-contains the surface given by the function
-<img class="math" src="../_images/math/c53a18c6d4f4b9e4ffcdcb4334fddc185bed5606.png" alt="z(x, y) = \cos (2\pi r/8)\cdot e^{-r/10}"/>, where
-<img class="math" src="../_images/math/0bb1e43191efcfe04a430d80616fa31c38a9ca40.png" alt="r^2 = (x^2 + y^2)"/>. The illumination is obtained by passing two
-grid files to <a class="reference internal" href="../grdview.html"><em>grdview</em></a>: One with the
-<em>z</em>-values (the surface) and another with intensity values (which should
-be in the 1 range). We use
-<a class="reference internal" href="../grdgradient.html"><em>grdgradient</em></a> to compute the
-horizontal gradients in the direction of the artificial light source.
-The <tt class="docutils literal"><span class="pre">gray.cpt</span></tt> file only has one line that states that all <em>z</em> values should have
-the gray level 128. Thus, variations in shade are entirely due to
-variations in gradients, or illuminations. We choose to illuminate from
-the SW and view the surface from SE:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 05</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Generate grid and show monochrome 3-D perspective</span>
-<span class="c"># GMT progs: grdgradient, grdmath, grdview, pstext</span>
-<span class="c"># Unix progs: echo, rm</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_05.ps
-gmt grdmath -R-15/15/-15/15 -I0.3 X Y HYPOT DUP <span class="m">2</span> MUL PI MUL <span class="m">8</span> DIV COS EXCH NEG <span class="m">10</span> DIV <span class="se">\</span>
- EXP <span class="nv">MUL</span> <span class="o">=</span> sombrero.nc
-<span class="nb">echo</span> <span class="s1">'-5 128 5 128'</span> > gray.cpt
-gmt grdgradient sombrero.nc -A225 -Gintensity.nc -Nt0.75
-gmt grdview sombrero.nc -JX6i -JZ2i -B5 -Bz0.5 -BSEwnZ -N-1+gwhite -Qs -Iintensity.nc -X1.5i <span class="se">\</span>
- -Cgray.cpt -R-15/15/-15/15/-1/1 -K -p120/30 > <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"4.1 5.5 z(r) = cos (2@~p@~r/8) @~\327@~e at +-r/10 at +"</span> <span class="p">|</span> gmt pstext -R0/11/0/8.5 -Jx1i <span class="se">\</span>
- -F+f50p,ZapfChancery-MediumItalic+jBC -O >> <span class="nv">$ps</span>
-rm -f gray.cpt sombrero.nc intensity.nc
-</pre></div>
-</div>
-<p>The variations in intensity could be made more dramatic by using
-<a class="reference internal" href="../grdmath.html"><em>grdmath</em></a> to scale the intensity file
-before running <a class="reference internal" href="../grdview.html"><em>grdview</em></a>. For very rough
-data sets one may improve the smoothness of the intensities by passing
-the output of <a class="reference internal" href="../grdgradient.html"><em>grdgradient</em></a> to
-<a class="reference internal" href="../grdhisteq.html"><em>grdhisteq</em></a>. The shell-script above
-will result in a plot like the one in Figure.</p>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_05.png"><img alt="../_images/example_05.png" src="../_images/example_05.png" style="width: 500px;" /></a>
-<p class="caption">3-D illuminated surface.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex04.html"
- title="previous chapter">(4) A 3-D perspective mesh plot</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex06.html"
- title="next chapter">(6) Plotting of histograms</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex05.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex06.html" title="(6) Plotting of histograms"
- >next</a> </li>
- <li class="right" >
- <a href="ex04.html" title="(4) A 3-D perspective mesh plot"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex06.html b/doc_release/html/gallery/ex06.html
deleted file mode 100644
index 5097cc6..0000000
--- a/doc_release/html/gallery/ex06.html
+++ /dev/null
@@ -1,170 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(6) Plotting of histograms — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(7) A simple location map" href="ex07.html" />
- <link rel="prev" title="(5) A 3-D illuminated surface (in bw)" href="ex05.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex07.html" title="(7) A simple location map"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex05.html" title="(5) A 3-D illuminated surface (in bw)"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="plotting-of-histograms">
-<span id="example-06"></span><h1>(6) Plotting of histograms<a class="headerlink" href="#plotting-of-histograms" title="Permalink to this headline">¶</a></h1>
-<p>GMT provides two tools to render histograms:
-<a class="reference internal" href="../pshistogram.html"><em>pshistogram</em></a> and <a class="reference internal" href="../psrose.html"><em>psrose</em></a>. The former takes care of
-regular histograms whereas the latter deals with polar histograms (rose
-diagrams, sector diagrams, and wind rose diagrams). We will show an
-example that involves both programs. The file <tt class="docutils literal"><span class="pre">fractures.yx</span></tt> contains a compilation of
-fracture lengths and directions as digitized from geological maps. The
-file <tt class="docutils literal"><span class="pre">v3206.t</span></tt> contains all the bathymetry measurements from <em>Vema</em> cruise 3206.
-Our complete figure was made running
-this script:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 06</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Make standard and polar histograms</span>
-<span class="c"># GMT progs: pshistogram, psrose</span>
-<span class="c"># Unix progs: rm</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_06.ps
-gmt psrose fractures.d -: -A10r -S1.8in -P -Gorange -R0/1/0/360 -X2.5i -K -Bx0.2g0.2 <span class="se">\</span>
- -By30g30 -B+glightblue -W1p > <span class="nv">$ps</span>
-gmt pshistogram -Bxa2000f1000+l<span class="s2">"Topography (m)"</span> -Bya10f5+l<span class="s2">"Frequency"</span>+u<span class="s2">" %"</span> <span class="se">\</span>
- -BWSne+t<span class="s2">"Histograms"</span>+glightblue v3206.t -R-6000/0/0/30 -JX4.8i/2.4i -Gorange -O <span class="se">\</span>
- -Y5.0i -X-0.5i -L1p -Z1 -W250 >> <span class="nv">$ps</span>
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_06.png"><img alt="../_images/example_06.png" src="../_images/example_06.png" style="width: 500px;" /></a>
-<p class="caption">Two kinds of histograms.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex05.html"
- title="previous chapter">(5) A 3-D illuminated surface (in bw)</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex07.html"
- title="next chapter">(7) A simple location map</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex06.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex07.html" title="(7) A simple location map"
- >next</a> </li>
- <li class="right" >
- <a href="ex05.html" title="(5) A 3-D illuminated surface (in bw)"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex07.html b/doc_release/html/gallery/ex07.html
deleted file mode 100644
index 40a4b80..0000000
--- a/doc_release/html/gallery/ex07.html
+++ /dev/null
@@ -1,203 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(7) A simple location map — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(8) A 3-D histogram" href="ex08.html" />
- <link rel="prev" title="(6) Plotting of histograms" href="ex06.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex08.html" title="(8) A 3-D histogram"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex06.html" title="(6) Plotting of histograms"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="a-simple-location-map">
-<span id="example-07"></span><h1>(7) A simple location map<a class="headerlink" href="#a-simple-location-map" title="Permalink to this headline">¶</a></h1>
-<p>Many scientific papers start out by showing a location map of the region
-of interest. This map will typically also contain certain features and
-labels. This example will present a location map for the equatorial
-Atlantic ocean, where fracture zones and mid-ocean ridge segments have
-been plotted. We also would like to plot earthquake locations and
-available isochrons. We have obtained one file, <tt class="docutils literal"><span class="pre">quakes.xym</span></tt>, which contains the
-position and magnitude of available earthquakes in the region. We choose
-to use magnitude/100 for the symbol-size in inches. The digital fracture
-zone traces (<tt class="docutils literal"><span class="pre">fz.xy</span></tt>) and isochrons (0 isochron as <tt class="docutils literal"><span class="pre">ridge.xy</span></tt>, the rest as <tt class="docutils literal"><span class="pre">isochrons.xy</span></tt>) were
-digitized from available maps <a class="footnote-reference" href="#id2" id="id1">[1]</a>. We create the final location map
-with the following script:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 07</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Make a basemap with earthquakes and isochrons etc</span>
-<span class="c"># GMT progs: pscoast, pstext, psxy</span>
-<span class="c"># Unix progs: echo, rm</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_07.ps
-gmt pscoast -R-50/0/-10/20 -JM9i -K -Slightblue -GP300/26:FtanBdarkbrown -Dl -Wthinnest <span class="se">\</span>
- -B10 --FORMAT_GEO_MAP<span class="o">=</span>dddF > <span class="nv">$ps</span>
-gmt psxy -R -J -O -K fz.xy -Wthinner,- >> <span class="nv">$ps</span>
-gmt psxy quakes.xym -R -J -O -K -h1 -Sci -i0,1,2s0.01 -Gred -Wthinnest >> <span class="nv">$ps</span>
-gmt psxy -R -J -O -K isochron.xy -Wthin,blue >> <span class="nv">$ps</span>
-gmt psxy -R -J -O -K ridge.xy -Wthicker,orange >> <span class="nv">$ps</span>
-gmt psxy -R -J -O -K -Gwhite -Wthick -A >> <span class="nv">$ps</span> <span class="s"><< END</span>
-<span class="s">-14.5 15.2</span>
-<span class="s"> -2 15.2</span>
-<span class="s"> -2 17.8</span>
-<span class="s">-14.5 17.8</span>
-<span class="s">END</span>
-gmt psxy -R -J -O -K -Gwhite -Wthinner -A >> <span class="nv">$ps</span> <span class="s"><< END</span>
-<span class="s">-14.35 15.35</span>
-<span class="s"> -2.15 15.35</span>
-<span class="s"> -2.15 17.65</span>
-<span class="s">-14.35 17.65</span>
-<span class="s">END</span>
-<span class="nb">echo</span> <span class="s2">"-13.5 16.5"</span> <span class="p">|</span> gmt psxy -R -J -O -K -Sc0.08i -Gred -Wthinner >> <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"-12.5 16.5 ISC Earthquakes"</span> <span class="p">|</span> gmt pstext -R -J -F+f18p,Times-Italic+jLM -O -K >> <span class="nv">$ps</span>
-gmt pstext -R -J -O -F+f30,Helvetica-Bold,white<span class="o">=</span>thin >> <span class="nv">$ps</span> <span class="s"><< END</span>
-<span class="s">-43 -5 SOUTH</span>
-<span class="s">-43 -8 AMERICA</span>
-<span class="s"> -7 11 AFRICA</span>
-<span class="s">END</span>
-</pre></div>
-</div>
-<p>The same figure could equally well be made in color, which could be
-rasterized and made into a slide for a meeting presentation. The script
-is similar to the one outlined above, except we would choose a color for
-land and oceans, and select colored symbols and pens rather than black
-and white.</p>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_07.png"><img alt="../_images/example_07.png" src="../_images/example_07.png" style="width: 500px;" /></a>
-<p class="caption">A typical location map.</p>
-</div>
-<table class="docutils footnote" frame="void" id="id2" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id1">[1]</a></td><td>These data are available on CD-ROM from NGDC (www.ngdc.noaa.gov).</td></tr>
-</tbody>
-</table>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex06.html"
- title="previous chapter">(6) Plotting of histograms</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex08.html"
- title="next chapter">(8) A 3-D histogram</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex07.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex08.html" title="(8) A 3-D histogram"
- >next</a> </li>
- <li class="right" >
- <a href="ex06.html" title="(6) Plotting of histograms"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex08.html b/doc_release/html/gallery/ex08.html
deleted file mode 100644
index 2d2c4ab..0000000
--- a/doc_release/html/gallery/ex08.html
+++ /dev/null
@@ -1,168 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(8) A 3-D histogram — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(9) Time-series along tracks" href="ex09.html" />
- <link rel="prev" title="(7) A simple location map" href="ex07.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex09.html" title="(9) Time-series along tracks"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex07.html" title="(7) A simple location map"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="a-3-d-histogram">
-<span id="example-08"></span><h1>(8) A 3-D histogram<a class="headerlink" href="#a-3-d-histogram" title="Permalink to this headline">¶</a></h1>
-<p>The program <a class="reference internal" href="../psxyz.html"><em>psxyz</em></a> allows us to plot
-three-dimensional symbols, including columnar plots. As a simple
-demonstration, we will convert a gridded netCDF of bathymetry into an
-ASCII <em>xyz</em> table and use the height information to draw a 2-D
-histogram in a 3-D perspective view. Our gridded bathymetry file is
-called <tt class="docutils literal"><span class="pre">guinea_bay.nc</span></tt> and covers the region from 0 to 5 E and 0 to 5 N. Depth ranges
-from -5000 meter to sea-level. We produce the Figure by running this script:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 08</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Make a 3-D bar plot</span>
-<span class="c"># GMT progs: grd2xyz, pstext, psxyz</span>
-<span class="c"># Unix progs: echo, rm</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_08.ps
-gmt grd2xyz guinea_bay.nc <span class="p">|</span> gmt psxyz -B1 -Bz1000+l<span class="s2">"Topography (m)"</span> -BWSneZ+b+tETOPO5 <span class="se">\</span>
- -R-0.1/5.1/-0.1/5.1/-5000/0 -JM5i -JZ6i -p200/30 -So0.0833333ub-5000 -P <span class="se">\</span>
- -Wthinnest -Glightgreen -K > <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s1">'0.1 4.9 This is the surface of cube'</span> <span class="p">|</span> gmt pstext -R -J -JZ -Z0 <span class="se">\</span>
- -F+f24p,Helvetica-Bold+jTL -p -O >> <span class="nv">$ps</span>
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_08.png"><img alt="../_images/example_08.png" src="../_images/example_08.png" style="width: 500px;" /></a>
-<p class="caption">A 3-D histogram.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex07.html"
- title="previous chapter">(7) A simple location map</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex09.html"
- title="next chapter">(9) Time-series along tracks</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex08.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex09.html" title="(9) Time-series along tracks"
- >next</a> </li>
- <li class="right" >
- <a href="ex07.html" title="(7) A simple location map"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex09.html b/doc_release/html/gallery/ex09.html
deleted file mode 100644
index d989b3d..0000000
--- a/doc_release/html/gallery/ex09.html
+++ /dev/null
@@ -1,186 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(9) Time-series along tracks — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(10) A geographical bar graph plot" href="ex10.html" />
- <link rel="prev" title="(8) A 3-D histogram" href="ex08.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex10.html" title="(10) A geographical bar graph plot"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex08.html" title="(8) A 3-D histogram"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="time-series-along-tracks">
-<span id="example-09"></span><h1>(9) Time-series along tracks<a class="headerlink" href="#time-series-along-tracks" title="Permalink to this headline">¶</a></h1>
-<p>A common application in many scientific disciplines involves plotting
-one or several time-series as as “wiggles” along tracks. Marine
-geophysicists often display magnetic anomalies in this manner, and
-seismologists use the technique when plotting individual seismic traces.
-In our example we will show how a set of Geosat sea surface slope
-profiles from the south Pacific can be plotted as “wiggles” using the
-<a class="reference internal" href="../pswiggle.html"><em>pswiggle</em></a> program. We will embellish
-the plot with track numbers, the location of the Pacific-Antarctic
-Ridge, recognized fracture zones in the area, and a “wiggle” scale. The
-Geosat tracks are stored in the file <tt class="docutils literal"><span class="pre">tracks.txt</span></tt>, the ridge in <tt class="docutils literal"><span class="pre">ridge.xy</span></tt>, and all the
-fracture zones are stored in the multiple segment file <tt class="docutils literal"><span class="pre">fz.xy</span></tt>. The
-profile id is contained in the segment headers and we wish to use the
-last data point in each of the track segments to construct an input file
-for <a class="reference internal" href="../pstext.html"><em>pstext</em></a> that will label each profile
-with the track number. We know the profiles trend approximately N40E so
-we want the labels to have that same orientation (i.e., the angle with
-the baseline must be 50). We do this by extracting the last record from
-each track and select segment header as textstring when running
-the output through <a class="reference internal" href="../pstext.html"><em>pstext</em></a>. Note we
-offset the positions by -0.05 inch with <strong>-D</strong> in order to have a small
-gap between the profile and the label:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 09</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Make wiggle plot along track from geoid deflections</span>
-<span class="c"># GMT progs: gmtconvert, pswiggle, pstext, psxy</span>
-<span class="c"># Unix progs: </span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_09.ps
-gmt pswiggle tracks.txt -R185/250/-68/-42 -K -Jm0.13i -Ba10f5 -BWSne+g240/255/240 -G+red <span class="se">\</span>
- -G-blue -Z2000 -Wthinnest -S240/-67/500/@~m@~rad --FORMAT_GEO_MAP<span class="o">=</span>dddF > <span class="nv">$ps</span>
-gmt psxy -R -J -O -K ridge.xy -Wthicker >> <span class="nv">$ps</span>
-gmt psxy -R -J -O -K fz.xy -Wthinner,- >> <span class="nv">$ps</span>
-<span class="c"># Take label from segment header and plot near coordinates of last record of each track</span>
-gmt gmtconvert -El tracks.txt <span class="p">|</span> gmt pstext -R -J -F+f10p,Helvetica-Bold+a50+jRM+h <span class="se">\</span>
- -D-0.05i/-0.05i -O >> <span class="nv">$ps</span>
-</pre></div>
-</div>
-<p>The output shows the sea-surface slopes along 42 descending Geosat
-tracks in the Eltanin and Udintsev fracture zone region in a Mercator projection.</p>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_09.png"><img alt="../_images/example_09.png" src="../_images/example_09.png" style="width: 500px;" /></a>
-<p class="caption">Time-series as wiggles along a track.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex08.html"
- title="previous chapter">(8) A 3-D histogram</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex10.html"
- title="next chapter">(10) A geographical bar graph plot</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex09.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex10.html" title="(10) A geographical bar graph plot"
- >next</a> </li>
- <li class="right" >
- <a href="ex08.html" title="(8) A 3-D histogram"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex10.html b/doc_release/html/gallery/ex10.html
deleted file mode 100644
index d143fc3..0000000
--- a/doc_release/html/gallery/ex10.html
+++ /dev/null
@@ -1,186 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(10) A geographical bar graph plot — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(11) A 3-D RGB color cube" href="ex11.html" />
- <link rel="prev" title="(9) Time-series along tracks" href="ex09.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex11.html" title="(11) A 3-D RGB color cube"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex09.html" title="(9) Time-series along tracks"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="a-geographical-bar-graph-plot">
-<span id="example-10"></span><h1>(10) A geographical bar graph plot<a class="headerlink" href="#a-geographical-bar-graph-plot" title="Permalink to this headline">¶</a></h1>
-<p>Our next and perhaps most business-like example presents a
-three-dimensional bar graph plot showing the geographic distribution of
-all the languages of the world. The input data
-was taken from <a class="reference external" href="http://www.ethnologue.com/">Ethnologue</a>. We decide to plot a 3-D column
-centered on each continent with a height that is proportional to the
-languages used. We choose a plain
-linear projection for the basemap and add the columns and text on top.
-Eventually we make it a bit more fancy by splitting the columns up in different colors
-indicating how commonly the languages are used, from institutional languages to
-languages threatened by extinction.
-The script also shows how to effectively use transparency of the boxes around the numbers
-and in the shade surrounding the legend.
-Our script that produces Figure ex_10 reads:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 10</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Make 3-D bar graph on top of perspective map</span>
-<span class="c"># GMT progs: pscoast, pstext, psxyz, pslegend</span>
-<span class="c"># Unix progs: $AWK</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_10.ps
-gmt pscoast -Rd -JX8id/5id -Dc -Sazure2 -Gwheat -Wfaint -A5000 -p200/40 -K > <span class="nv">$ps</span>
-<span class="nv">$AWK</span> <span class="s1">'{print $1, $2, $3+$4+$5+$6+$7}'</span> languages.txt <span class="se">\</span>
- <span class="p">|</span> gmt pstext -R -J -O -K -p -Gwhite at 30 -D-0.25i/0 <span class="se">\</span>
- -F+f30p,Helvetica-Bold,firebrick<span class="o">=</span>thinner+jRM >> <span class="nv">$ps</span>
-gmt psxyz languages.txt -R-180/180/-90/90/0/2500 -J -JZ2.5i -So0.3i -Gpurple -Wthinner <span class="se">\</span>
- --FONT_TITLE<span class="o">=</span>30p,Times-Bold --MAP_TITLE_OFFSET<span class="o">=</span>-0.7i -O -K -p --FORMAT_GEO_MAP<span class="o">=</span>dddF <span class="se">\</span>
- -Bx60 -By30 -Bza500+lLanguages -BWSneZ+t<span class="s2">"World Languages By Continent"</span> >> <span class="nv">$ps</span>
-<span class="nv">$AWK</span> <span class="s1">'{print $1, $2, $3+$4, $3}'</span> languages.txt <span class="se">\</span>
- <span class="p">|</span> gmt psxyz -R -J -JZ -So0.3ib -Gblue -Wthinner -O -K -p >> <span class="nv">$ps</span>
-<span class="nv">$AWK</span> <span class="s1">'{print $1, $2, $3+$4+$5, $3+$4}'</span> languages.txt <span class="se">\</span>
- <span class="p">|</span> gmt psxyz -R -J -JZ -So0.3ib -Gdarkgreen -Wthinner -O -K -p >> <span class="nv">$ps</span>
-<span class="nv">$AWK</span> <span class="s1">'{print $1, $2, $3+$4+$5+$6, $3+$4+$5}'</span> languages.txt <span class="se">\</span>
- <span class="p">|</span> gmt psxyz -R -J -JZ -So0.3ib -Gyellow -Wthinner -O -K -p >> <span class="nv">$ps</span>
-<span class="nv">$AWK</span> <span class="s1">'{print $1, $2, $3+$4+$5+$6+$7, $3+$4+$5+$6}'</span> languages.txt <span class="se">\</span>
- <span class="p">|</span> gmt psxyz -R -J -JZ -So0.3ib -Gred -Wthinner -O -K -p >> <span class="nv">$ps</span>
-gmt pslegend -R -J -JZ -D-170/-80/1.35i/0/BL -O --FONT<span class="o">=</span>Helvetica-Bold <span class="se">\</span>
- -F+glightgrey+pthinner+s-4p/-6p/grey20 at 40 -p legend.txt >> <span class="nv">$ps</span>
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_10.png"><img alt="../_images/example_10.png" src="../_images/example_10.png" style="width: 500px;" /></a>
-<p class="caption">Geographical bar graph.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex09.html"
- title="previous chapter">(9) Time-series along tracks</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex11.html"
- title="next chapter">(11) A 3-D RGB color cube</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex10.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex11.html" title="(11) A 3-D RGB color cube"
- >next</a> </li>
- <li class="right" >
- <a href="ex09.html" title="(9) Time-series along tracks"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex11.html b/doc_release/html/gallery/ex11.html
deleted file mode 100644
index 75a639a..0000000
--- a/doc_release/html/gallery/ex11.html
+++ /dev/null
@@ -1,262 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(11) A 3-D RGB color cube — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(12) Optimal triangulation of data" href="ex12.html" />
- <link rel="prev" title="(10) A geographical bar graph plot" href="ex10.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex12.html" title="(12) Optimal triangulation of data"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex10.html" title="(10) A geographical bar graph plot"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="a-3-d-rgb-color-cube">
-<span id="example-11"></span><h1>(11) A 3-D RGB color cube<a class="headerlink" href="#a-3-d-rgb-color-cube" title="Permalink to this headline">¶</a></h1>
-<p>In this example we generate a series of 6 color images, arranged so that
-they can be cut out and assembled into a 3-D color cube. The six faces
-of the cube represent the outside of the R-G-B color space. On each face
-one of the color components is fixed at either 0 or 255 and the other
-two components vary smoothly across the face from 0 to 255. The cube is
-configured as a right-handed coordinate system with <em>x-y-z</em> mapping
-R-G-B. Hence, the 8 corners of the cube represent the primaries red,
-green, and blue, plus the secondaries cyan, magenta and yellow, plus
-black and white.</p>
-<p>The 6 color faces are generated by feeding
-<a class="reference internal" href="../grdimage.html"><em>grdimage</em></a> three grids, one for each
-color component (R, G, and B). In some cases the X or Y axes of a face
-are reversed by specifying a negative width or height in order to change
-the variation of the color value in that direction from ascending to
-descending, or vice versa.</p>
-<p>A number of rays emanating from the white and black corners indicate the
-Hue value (ranging from 0 to 360). The dashed and dotted lines near the
-white corner reflect saturation levels, running from 0 to 1 (in black
-font). On these 3 faces the brightness is a constant value of 1. On the
-other 3 faces of the cube, around the black corner, the white decimal
-numbers indicate brightnesses between 0 and 1, with saturation fixed at 1.</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 11</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Create a 3-D RGB Cube</span>
-<span class="c"># GMT progs: gmtset, grdimage, grdmath, pstext, psxy</span>
-<span class="c"># Unix progs: rm</span>
-<span class="nv">ps</span><span class="o">=</span>example_11.ps
-
-<span class="c"># Use gmt psxy to plot "cut-along-the-dotted" lines.</span>
-
-gmt gmtset MAP_TICK_LENGTH_PRIMARY 0
-
-gmt psxy cut-here.dat -Wthinnest,. -R-51/306/0/1071 -JX3.5i/10.5i -X2.5i -Y0.5i -P -K > <span class="nv">$ps</span>
-
-<span class="c"># First, create grids of ascending X and Y and constant 0.</span>
-<span class="c"># These are to be used to represent R, G and B values of the darker 3 faces of the cube.</span>
-
-gmt grdmath -I1 -R0/255/0/255 <span class="nv">X</span> <span class="o">=</span> x.nc
-gmt grdmath -I1 -R <span class="nv">Y</span> <span class="o">=</span> y.nc
-gmt grdmath -I1 -R <span class="nv">0</span> <span class="o">=</span> c.nc
-
-gmt gmtset FONT_ANNOT_PRIMARY 12p,Helvetica-Bold
-
-gmt grdimage x.nc y.nc c.nc -JX2.5i/-2.5i -R -K -O -X0.5i >> <span class="nv">$ps</span>
-gmt psxy -Wthinner,white,- rays.dat -J -R -K -O >> <span class="nv">$ps</span>
-gmt pstext --FONT<span class="o">=</span>white -J -R -K -O -F+f+a >> <span class="nv">$ps</span> <span class="s"><< END</span>
-<span class="s">128 128 12p -45 60\217</span>
-<span class="s">102 26 12p -90 0.4</span>
-<span class="s">204 26 12p -90 0.8</span>
-<span class="s">10 140 16p 180 G</span>
-<span class="s">END</span>
-<span class="nb">echo </span><span class="m">0</span> <span class="m">0</span> <span class="m">0</span> <span class="m">128</span> <span class="p">|</span> gmt psxy -N -Sv0.15i+s+e -Gwhite -W2p,white -J -R -K -O >> <span class="nv">$ps</span>
-
-gmt grdimage x.nc c.nc y.nc -JX2.5i/2.5i -R -K -O -Y2.5i >> <span class="nv">$ps</span>
-gmt psxy -Wthinner,white,- rays.dat -J -R -K -O >> <span class="nv">$ps</span>
-gmt pstext --FONT<span class="o">=</span>white -J -R -K -O -F+f+a >> <span class="nv">$ps</span> <span class="s"><< END</span>
-<span class="s">128 128 12p 45 300\217</span>
-<span class="s">26 102 12p 0 0.4</span>
-<span class="s">26 204 12p 0 0.8</span>
-<span class="s">140 10 16p -90 R</span>
-<span class="s">100 100 16p -45 V</span>
-<span class="s">END</span>
-<span class="nb">echo </span><span class="m">0</span> <span class="m">0</span> <span class="m">128</span> <span class="m">0</span> <span class="p">|</span> gmt psxy -N -Sv0.15i+s+e -Gwhite -W2p,white -J -R -K -O >> <span class="nv">$ps</span>
-<span class="nb">echo </span><span class="m">0</span> <span class="m">0</span> <span class="m">90</span> <span class="m">90</span> <span class="p">|</span> gmt psxy -N -Sv0.15i+s+e -Gwhite -W2p,white -J -R -K -O >> <span class="nv">$ps</span>
-
-gmt grdimage c.nc x.nc y.nc -JX-2.5i/2.5i -R -K -O -X-2.5i >> <span class="nv">$ps</span>
-gmt psxy -Wthinner,white,- rays.dat -J -R -K -O >> <span class="nv">$ps</span>
-gmt pstext --FONT<span class="o">=</span>white -J -R -K -O -F+f+a >> <span class="nv">$ps</span> <span class="s"><< END</span>
-<span class="s">128 128 12p 135 180\217</span>
-<span class="s">102 26 12p 90 0.4</span>
-<span class="s">204 26 12p 90 0.8</span>
-<span class="s">10 140 16p 0 B</span>
-<span class="s">END</span>
-<span class="nb">echo </span><span class="m">0</span> <span class="m">0</span> <span class="m">0</span> <span class="m">128</span> <span class="p">|</span> gmt psxy -N -Sv0.15i+s+e -Gwhite -W2p,white -J -R -K -O >> <span class="nv">$ps</span>
-<span class="nb">echo </span><span class="m">0</span> <span class="m">0</span> <span class="m">128</span> <span class="m">0</span> <span class="p">|</span> gmt psxy -N -Sv0.15i+s+e -Gwhite -W2p,white -J -R -K -O >> <span class="nv">$ps</span>
-
-<span class="c"># Second, create grids of descending X and Y and constant 255.</span>
-<span class="c"># These are to be used to represent R, G and B values of the lighter 3 faces of the cube.</span>
-
-gmt grdmath -I1 -R <span class="m">255</span> X <span class="nv">SUB</span> <span class="o">=</span> x.nc
-gmt grdmath -I1 -R <span class="m">255</span> Y <span class="nv">SUB</span> <span class="o">=</span> y.nc
-gmt grdmath -I1 -R <span class="nv">255</span> <span class="o">=</span> c.nc
-
-gmt grdimage x.nc y.nc c.nc -JX-2.5i/-2.5i -R -K -O -X2.5i -Y2.5i >> <span class="nv">$ps</span>
-gmt psxy -Wthinner,black,- rays.dat -J -R -K -O >> <span class="nv">$ps</span>
-gmt pstext -J -R -K -O -F+f+a >> <span class="nv">$ps</span> <span class="s"><< END</span>
-<span class="s">128 128 12p 225 240\217</span>
-<span class="s">102 26 12p 270 0.4</span>
-<span class="s">204 26 12p 270 0.8</span>
-<span class="s">END</span>
-
-gmt grdimage c.nc y.nc x.nc -JX2.5i/-2.5i -R -K -O -X2.5i >> <span class="nv">$ps</span>
-gmt psxy -Wthinner,black,- rays.dat -J -R -K -O >> <span class="nv">$ps</span>
-gmt pstext -J -R -K -O -F+f+a >> <span class="nv">$ps</span> <span class="s"><< END</span>
-<span class="s">128 128 12p -45 0\217</span>
-<span class="s">26 102 12p 0 0.4</span>
-<span class="s">26 204 12p 0 0.8</span>
-<span class="s">100 100 16p 45 S</span>
-<span class="s">204 66 16p 90 H</span>
-<span class="s">END</span>
-<span class="nb">echo </span><span class="m">0</span> <span class="m">0</span> <span class="m">90</span> <span class="m">90</span> <span class="p">|</span> gmt psxy -N -Sv0.15i+s+e -Gblack -W2p -J -R -K -O >> <span class="nv">$ps</span>
-<span class="nb">echo </span><span class="m">204</span> <span class="m">204</span> <span class="m">204</span> <span class="m">76</span> <span class="p">|</span> gmt psxy -N -Sv0.15i+s+e -Gblack -W2p -J -R -K -O >> <span class="nv">$ps</span>
-
-gmt grdimage x.nc c.nc y.nc -JX-2.5i/2.5i -R -K -O -X-2.5i -Y2.5i >> <span class="nv">$ps</span>
-gmt psxy -Wthinner,black,- rays.dat -J -R -K -O >> <span class="nv">$ps</span>
-gmt pstext -J -R -O -F+f+a >> <span class="nv">$ps</span> <span class="s"><< END</span>
-<span class="s">128 128 12p 135 120\217</span>
-<span class="s">26 102 12p 180 0.4</span>
-<span class="s">26 204 12p 180 0.8</span>
-<span class="s">200 200 16p 225 GMT 5</span>
-<span class="s">END</span>
-
-rm -f *.nc gmt.conf
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_11.png"><img alt="../_images/example_11.png" src="../_images/example_11.png" style="width: 500px;" /></a>
-<p class="caption">The RGB color cube.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex10.html"
- title="previous chapter">(10) A geographical bar graph plot</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex12.html"
- title="next chapter">(12) Optimal triangulation of data</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex11.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex12.html" title="(12) Optimal triangulation of data"
- >next</a> </li>
- <li class="right" >
- <a href="ex10.html" title="(10) A geographical bar graph plot"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex12.html b/doc_release/html/gallery/ex12.html
deleted file mode 100644
index 747b87c..0000000
--- a/doc_release/html/gallery/ex12.html
+++ /dev/null
@@ -1,195 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(12) Optimal triangulation of data — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(13) Plotting of vector fields" href="ex13.html" />
- <link rel="prev" title="(11) A 3-D RGB color cube" href="ex11.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex13.html" title="(13) Plotting of vector fields"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex11.html" title="(11) A 3-D RGB color cube"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="optimal-triangulation-of-data">
-<span id="example-12"></span><h1>(12) Optimal triangulation of data<a class="headerlink" href="#optimal-triangulation-of-data" title="Permalink to this headline">¶</a></h1>
-<p>Our next example operates on a data
-set of topographic readings non-uniformly distributed in the plane
-(Table 5.11 in Davis: <em>Statistics and Data Analysis in Geology</em>, J.
-Wiley). We use <a class="reference internal" href="../triangulate.html"><em>triangulate</em></a> to
-perform the optimal Delaunay triangulation, then use the output to draw
-the resulting network. We label the node numbers as well as the node
-values, and call <a class="reference internal" href="../pscontour.html"><em>pscontour</em></a> to make a
-contour map and image directly from the raw data. Thus, in this example
-we do not actually make grid files but still are able to contour and
-image the data. We use a color palette table <tt class="docutils literal"><span class="pre">topo.cpt</span></tt> (created via
-<a class="reference internal" href="../gmtinfo.html"><em>gmtinfo</em></a> and <a class="reference internal" href="../makecpt.html"><em>makecpt</em></a>). The script becomes:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 12</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Illustrates Delaunay triangulation of points, and contouring</span>
-<span class="c"># GMT progs: makecpt, gmtinfo, pscontour, pstext, psxy, triangulate</span>
-<span class="c"># Unix progs: $AWK, echo, rm</span>
-<span class="c">#</span>
-<span class="c"># First draw network and label the nodes</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_12.ps
-gmt triangulate table_5.11 -M > net.xy
-gmt psxy -R0/6.5/-0.2/6.5 -JX3.06i/3.15i -B2f1 -BWSNe net.xy -Wthinner -P -K -X0.9i -Y4.65i > <span class="nv">$ps</span>
-gmt psxy table_5.11 -R -J -O -K -Sc0.12i -Gwhite -Wthinnest >> <span class="nv">$ps</span>
-<span class="nv">$AWK</span> <span class="s1">'{print $1, $2, NR-1}'</span> table_5.11 <span class="p">|</span> gmt pstext -R -J -F+f6p -O -K >> <span class="nv">$ps</span>
-<span class="c">#</span>
-<span class="c"># Then draw network and print the node values</span>
-<span class="c">#</span>
-gmt psxy -R -J -B2f1 -BeSNw net.xy -Wthinner -O -K -X3.25i >> <span class="nv">$ps</span>
-gmt psxy -R -J -O -K table_5.11 -Sc0.03i -Gblack >> <span class="nv">$ps</span>
-gmt pstext table_5.11 -R -J -F+f6p+jLM -O -K -Gwhite -W -C0.01i -D0.08i/0i -N >> <span class="nv">$ps</span>
-<span class="c">#</span>
-<span class="c"># Then contour the data and draw triangles using dashed pen; use "gmt gmtinfo" and "gmt makecpt" to make a</span>
-<span class="c"># color palette (.cpt) file</span>
-<span class="c">#</span>
-<span class="nv">T</span><span class="o">=</span><span class="sb">`</span>gmt info -T25/2 table_5.11<span class="sb">`</span>
-gmt makecpt -Cjet <span class="nv">$T</span> > topo.cpt
-gmt pscontour -R -J table_5.11 -B2f1 -BWSne -Wthin -Ctopo.cpt -Lthinnest,- -Gd1i -X-3.25i -Y-3.65i <span class="se">\</span>
- -O -K >> <span class="nv">$ps</span>
-<span class="c">#</span>
-<span class="c"># Finally color the topography</span>
-<span class="c">#</span>
-gmt pscontour -R -J table_5.11 -B2f1 -BeSnw -Ctopo.cpt -I -X3.25i -O -K >> <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"3.16 8 Delaunay Triangulation"</span> <span class="p">|</span> <span class="se">\</span>
- gmt pstext -R0/8/0/11 -Jx1i -F+f30p,Helvetica-Bold+jCB -O -X-3.25i >> <span class="nv">$ps</span>
-<span class="c">#</span>
-rm -f net.xy topo.cpt
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_12.png"><img alt="../_images/example_12.png" src="../_images/example_12.png" style="width: 500px;" /></a>
-<p class="caption">Optimal triangulation of data.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex11.html"
- title="previous chapter">(11) A 3-D RGB color cube</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex13.html"
- title="next chapter">(13) Plotting of vector fields</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex12.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex13.html" title="(13) Plotting of vector fields"
- >next</a> </li>
- <li class="right" >
- <a href="ex11.html" title="(11) A 3-D RGB color cube"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex13.html b/doc_release/html/gallery/ex13.html
deleted file mode 100644
index 31fef09..0000000
--- a/doc_release/html/gallery/ex13.html
+++ /dev/null
@@ -1,180 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(13) Plotting of vector fields — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(14) Gridding of data and trend surfaces" href="ex14.html" />
- <link rel="prev" title="(12) Optimal triangulation of data" href="ex12.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex14.html" title="(14) Gridding of data and trend surfaces"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex12.html" title="(12) Optimal triangulation of data"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="plotting-of-vector-fields">
-<span id="example-13"></span><h1>(13) Plotting of vector fields<a class="headerlink" href="#plotting-of-vector-fields" title="Permalink to this headline">¶</a></h1>
-<p>In many areas, such as fluid dynamics and elasticity, it is desirable to
-plot vector fields of various kinds. GMT provides a way to illustrate
-2-component vector fields using the
-<a class="reference internal" href="../grdvector.html"><em>grdvector</em></a> utility. The two
-components of the field (Cartesian or polar components) are stored in
-separate grid files. In this example we use
-<a class="reference internal" href="../grdmath.html"><em>grdmath</em></a> to generate a surface
-<img class="math" src="../_images/math/7dc674e394ba36a90b8ddf5fcc87dbe1c092c1a8.png" alt="z(x, y) = x \cdot \exp(-x^2 -y^2)"/> and to calculate
-<img class="math" src="../_images/math/ba965e654c5ec9abe8bf921fd41e7e3b43dde4b0.png" alt="\nabla z"/> by returning the <em>x</em>- and <em>y</em>-derivatives separately.
-We superpose the gradient vector field and the surface <em>z</em> and also plot
-the components of the gradient in separate windows. A
-<a class="reference internal" href="../pstext.html"><em>pstext</em></a> call to place a header finishes the plot</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 13</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Illustrate vectors and contouring</span>
-<span class="c"># GMT progs: grdmath, grdcontour, grdvector, pstext</span>
-<span class="c"># Unix progs: echo, rm</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_13.ps
-gmt grdmath -R-2/2/-2/2 -I0.1 X Y R2 NEG EXP X <span class="nv">MUL</span> <span class="o">=</span> z.nc
-gmt grdmath z.nc <span class="nv">DDX</span> <span class="o">=</span> dzdx.nc
-gmt grdmath z.nc <span class="nv">DDY</span> <span class="o">=</span> dzdy.nc
-gmt grdcontour dzdx.nc -JX3i -B1 -BWSne -C0.1 -A0.5 -K -P -Gd2i -S4 -T0.1i/0.03i > <span class="nv">$ps</span>
-gmt grdcontour dzdy.nc -J -B -C0.05 -A0.2 -O -K -Gd2i -S4 -T0.1i/0.03i -Xa3.45i >> <span class="nv">$ps</span>
-gmt grdcontour z.nc -J -B -C0.05 -A0.1 -O -K -Gd2i -S4 -T0.1i/0.03i -Y3.45i >> <span class="nv">$ps</span>
-gmt grdcontour z.nc -J -B -C0.05 -O -K -Gd2i -S4 -X3.45i >> <span class="nv">$ps</span>
-gmt grdvector dzdx.nc dzdy.nc -I0.2 -J -O -K -Q0.1i+e+n0.25i -Gblack -W1p -S5i <span class="se">\</span>
- --MAP_VECTOR_SHAPE<span class="o">=</span>0.5 >> <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"3.2 3.6 z(x,y) = x@~\327@~exp(-x at +2@+-y at +2@+)"</span> <span class="se">\</span>
- <span class="p">|</span> gmt pstext -R0/6/0/4.5 -Jx1i -F+f40p,Times-Italic+jCB -O -X-3.45i >> <span class="nv">$ps</span>
-rm -f z.nc dzdx.nc dzdy.nc
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_13.png"><img alt="../_images/example_13.png" src="../_images/example_13.png" style="width: 500px;" /></a>
-<p class="caption">Display of vector fields in GMT.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex12.html"
- title="previous chapter">(12) Optimal triangulation of data</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex14.html"
- title="next chapter">(14) Gridding of data and trend surfaces</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex13.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex14.html" title="(14) Gridding of data and trend surfaces"
- >next</a> </li>
- <li class="right" >
- <a href="ex12.html" title="(12) Optimal triangulation of data"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex14.html b/doc_release/html/gallery/ex14.html
deleted file mode 100644
index 6df69a3..0000000
--- a/doc_release/html/gallery/ex14.html
+++ /dev/null
@@ -1,215 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(14) Gridding of data and trend surfaces — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(15) Gridding, contouring, and masking of unconstrained areas" href="ex15.html" />
- <link rel="prev" title="(13) Plotting of vector fields" href="ex13.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex15.html" title="(15) Gridding, contouring, and masking of unconstrained areas"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex13.html" title="(13) Plotting of vector fields"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gridding-of-data-and-trend-surfaces">
-<span id="example-14"></span><h1>(14) Gridding of data and trend surfaces<a class="headerlink" href="#gridding-of-data-and-trend-surfaces" title="Permalink to this headline">¶</a></h1>
-<p>This example shows how one goes from randomly spaced data points to an
-evenly sampled surface. First we plot the distribution and values of our
-raw data set (same as in Section [sec:example<sub>1</sub>2]). We choose an equidistant grid and run
-<a class="reference internal" href="../blockmean.html"><em>blockmean</em></a> which preprocesses the
-data to avoid aliasing. The dashed lines indicate the logical blocks
-used by <a class="reference internal" href="../blockmean.html"><em>blockmean</em></a>; all points inside
-a given bin will be averaged. The logical blocks are drawn from a
-temporary file we make on the fly within the shell script. The processed
-data is then gridded with the <a class="reference internal" href="../surface.html"><em>surface</em></a>
-program and contoured every 25 units. A most important point here is
-that <a class="reference internal" href="../blockmean.html"><em>blockmean</em></a>, <a class="reference internal" href="../blockmedian.html"><em>blockmedian</em></a>, or
-<a class="reference internal" href="../blockmode.html"><em>blockmode</em></a> should always be run prior
-to running <a class="reference internal" href="../surface.html"><em>surface</em></a>, and both of these
-steps must use the same grid interval. We use
-<a class="reference internal" href="../grdtrend.html"><em>grdtrend</em></a> to fit a bicubic trend
-surface to the gridded data, contour it as well, and sample both grid
-files along a diagonal transect using
-<a class="reference internal" href="../grdtrack.html"><em>grdtrack</em></a>. The bottom panel compares
-the gridded (solid line) and bicubic trend (dashed line) along the
-transect using <a class="reference internal" href="../psxy.html"><em>psxy</em></a></p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 14</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Showing simple gridding, contouring, and resampling along tracks</span>
-<span class="c"># GMT progs: blockmean, grdcontour, grdtrack, grdtrend, gmtinfo, project</span>
-<span class="c"># GMT progs: gmtset, pstext, psbasemap, psxy, surface</span>
-<span class="c"># Unix progs: rm</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_14.ps
-
-<span class="c"># First draw network and label the nodes</span>
-
-gmt gmtset MAP_GRID_PEN_PRIMARY thinnest,-
-gmt psxy table_5.11 -R0/7/0/7 -JX3.06i/3.15i -B2f1 -BWSNe -Sc0.05i -Gblack -P -K -Y6.45i > <span class="nv">$ps</span>
-gmt pstext table_5.11 -R -J -D0.1c/0 -F+f6p+jLM -O -K -N >> <span class="nv">$ps</span>
-gmt blockmean table_5.11 -R0/7/0/7 -I1 > mean.xyz
-
-<span class="c"># Then draw gmt blockmean cells</span>
-
-gmt psbasemap -R0.5/7.5/0.5/7.5 -J -O -K -Bg1 -X3.25i >> <span class="nv">$ps</span>
-gmt psxy -R0/7/0/7 -J -B2f1 -BeSNw mean.xyz -Ss0.05i -Gblack -O -K >> <span class="nv">$ps</span>
-<span class="c"># Reformat to one decimal for annotation purposes</span>
-gmt gmtconvert mean.xyz --FORMAT_FLOAT_OUT<span class="o">=</span>%.1f <span class="p">|</span> <span class="se">\</span>
- gmt pstext -R -J -D0.15c/0 -F+f6p+jLM -O -K -Gwhite -W -C0.01i -N >> <span class="nv">$ps</span>
-
-<span class="c"># Then gmt surface and contour the data</span>
-
-gmt surface mean.xyz -R -I1 -Gdata.nc
-gmt grdcontour data.nc -J -B2f1 -BWSne -C25 -A50 -Gd3i -S4 -O -K -X-3.25i -Y-3.55i >> <span class="nv">$ps</span>
-gmt psxy -R -J mean.xyz -Ss0.05i -Gblack -O -K >> <span class="nv">$ps</span>
-
-<span class="c"># Fit bicubic trend to data and compare to gridded gmt surface</span>
-
-gmt grdtrend data.nc -N10 -Ttrend.nc
-gmt project -C0/0 -E7/7 -G0.1 -N > track
-gmt grdcontour trend.nc -J -B2f1 -BwSne -C25 -A50 -Glct/cb -S4 -O -K -X3.25i >> <span class="nv">$ps</span>
-gmt psxy -R -J track -Wthick,. -O -K >> <span class="nv">$ps</span>
-
-<span class="c"># Sample along diagonal</span>
-
-gmt grdtrack track -Gdata.nc -o2,3 > data.d
-gmt grdtrack track -Gtrend.nc -o2,3 > trend.d
-gmt psxy <span class="sb">`</span>gmt info data.d trend.d -I0.5/25<span class="sb">`</span> -JX6.3i/1.4i data.d -Wthick -O -K -X-3.25i -Y-1.9i <span class="se">\</span>
- -Bx1 -By50 -BWSne >> <span class="nv">$ps</span>
-gmt psxy -R -J trend.d -Wthinner,- -O >> <span class="nv">$ps</span>
-
-rm -f mean.xyz track *.nc *.d gmt.conf
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_14.png"><img alt="../_images/example_14.png" src="../_images/example_14.png" style="width: 500px;" /></a>
-<p class="caption">Gridding of data and trend surfaces.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex13.html"
- title="previous chapter">(13) Plotting of vector fields</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex15.html"
- title="next chapter">(15) Gridding, contouring, and masking of unconstrained areas</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex14.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex15.html" title="(15) Gridding, contouring, and masking of unconstrained areas"
- >next</a> </li>
- <li class="right" >
- <a href="ex13.html" title="(13) Plotting of vector fields"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex15.html b/doc_release/html/gallery/ex15.html
deleted file mode 100644
index 3b1d542..0000000
--- a/doc_release/html/gallery/ex15.html
+++ /dev/null
@@ -1,200 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(15) Gridding, contouring, and masking of unconstrained areas — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(16) Gridding of data, continued" href="ex16.html" />
- <link rel="prev" title="(14) Gridding of data and trend surfaces" href="ex14.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex16.html" title="(16) Gridding of data, continued"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex14.html" title="(14) Gridding of data and trend surfaces"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gridding-contouring-and-masking-of-unconstrained-areas">
-<span id="example-15"></span><h1>(15) Gridding, contouring, and masking of unconstrained areas<a class="headerlink" href="#gridding-contouring-and-masking-of-unconstrained-areas" title="Permalink to this headline">¶</a></h1>
-<p>This example demonstrates some off the
-different ways one can use to grid data in GMT, and how to deal with
-unconstrained areas. We first convert a large ASCII file to binary with
-<a class="reference internal" href="../gmtconvert.html"><em>gmtconvert</em></a> since the binary file
-will read and process much faster. Our lower left plot illustrates the
-results of gridding using a nearest neighbor technique
-(<a class="reference internal" href="../nearneighbor.html"><em>nearneighbor</em></a>) which is a local
-method: No output is given where there are no data. Next (lower right),
-we use a minimum curvature technique
-(<a class="reference internal" href="../surface.html"><em>surface</em></a>) which is a global method.
-Hence, the contours cover the entire map although the data are only
-available for portions of the area (indicated by the gray areas plotted
-using <a class="reference internal" href="../psmask.html"><em>psmask</em></a>). The top left scenario
-illustrates how we can create a clip path (using
-<a class="reference internal" href="../psmask.html"><em>psmask</em></a>) based on the data coverage to
-eliminate contours outside the constrained area. Finally (top right) we
-simply employ <a class="reference internal" href="../pscoast.html"><em>pscoast</em></a> to overlay gray
-land masses to cover up the unwanted contours, and end by plotting a
-star at the deepest point on the map with
-<a class="reference internal" href="../psxy.html"><em>psxy</em></a>. This point was extracted from the
-grid files using <a class="reference internal" href="../grdinfo.html"><em>grdinfo</em></a>.</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 15</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Gridding and clipping when data are missing</span>
-<span class="c"># GMT progs: blockmedian, gmtconvert, grdclip, grdcontour, grdinfo, gmtinfo</span>
-<span class="c"># GMT progs: nearneighbor, pscoast, psmask, pstext, surface</span>
-<span class="c"># Unix progs: echo, rm</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_15.ps
-gmt gmtconvert ship.xyz -bo > ship.b
-<span class="c">#</span>
-<span class="nv">region</span><span class="o">=</span><span class="sb">`</span>gmt info ship.b -I1 -bi3d<span class="sb">`</span>
-gmt nearneighbor <span class="nv">$region</span> -I10m -S40k -Gship.nc ship.b -bi
-gmt grdcontour ship.nc -JM3i -P -B2 -BWSne -C250 -A1000 -Gd2i -K > <span class="nv">$ps</span>
-<span class="c">#</span>
-gmt blockmedian <span class="nv">$region</span> -I10m ship.b -b3d > ship_10m.b
-gmt surface <span class="nv">$region</span> -I10m ship_10m.b -Gship.nc -bi
-gmt psmask <span class="nv">$region</span> -I10m ship.b -J -O -K -T -Glightgray -bi3d -X3.6i >> <span class="nv">$ps</span>
-gmt grdcontour ship.nc -J -B -C250 -L-8000/0 -A1000 -Gd2i -O -K >> <span class="nv">$ps</span>
-<span class="c">#</span>
-gmt psmask <span class="nv">$region</span> -I10m ship_10m.b -bi3d -J -B -O -K -X-3.6i -Y3.75i >> <span class="nv">$ps</span>
-gmt grdcontour ship.nc -J -C250 -A1000 -L-8000/0 -Gd2i -O -K >> <span class="nv">$ps</span>
-gmt psmask -C -O -K >> <span class="nv">$ps</span>
-<span class="c">#</span>
-gmt grdclip ship.nc -Sa-1/NaN -Gship_clipped.nc
-gmt grdcontour ship_clipped.nc -J -B -C250 -A1000 -L-8000/0 -Gd2i -O -K -X3.6i >> <span class="nv">$ps</span>
-gmt pscoast <span class="nv">$region</span> -J -O -K -Ggray -Wthinnest >> <span class="nv">$ps</span>
-gmt grdinfo -C -M ship.nc <span class="p">|</span> gmt psxy -R -J -O -K -Sa0.15i -Wthick -i11,12 >> <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"-0.3 3.6 Gridding with missing data"</span> <span class="p">|</span> gmt pstext -R0/3/0/4 -Jx1i <span class="se">\</span>
- -F+f24p,Helvetica-Bold+jCB -O -N >> <span class="nv">$ps</span>
-rm -f ship.b ship_10m.b ship.nc ship_clipped.nc
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_15.png"><img alt="../_images/example_15.png" src="../_images/example_15.png" style="width: 500px;" /></a>
-<p class="caption">Gridding, contouring, and masking of data.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex14.html"
- title="previous chapter">(14) Gridding of data and trend surfaces</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex16.html"
- title="next chapter">(16) Gridding of data, continued</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex15.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex16.html" title="(16) Gridding of data, continued"
- >next</a> </li>
- <li class="right" >
- <a href="ex14.html" title="(14) Gridding of data and trend surfaces"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex16.html b/doc_release/html/gallery/ex16.html
deleted file mode 100644
index db50c54..0000000
--- a/doc_release/html/gallery/ex16.html
+++ /dev/null
@@ -1,229 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(16) Gridding of data, continued — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(17) Images clipped by coastlines" href="ex17.html" />
- <link rel="prev" title="(15) Gridding, contouring, and masking of unconstrained areas" href="ex15.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex17.html" title="(17) Images clipped by coastlines"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex15.html" title="(15) Gridding, contouring, and masking of unconstrained areas"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gridding-of-data-continued">
-<span id="example-16"></span><h1>(16) Gridding of data, continued<a class="headerlink" href="#gridding-of-data-continued" title="Permalink to this headline">¶</a></h1>
-<p><a class="reference internal" href="../pscontour.html"><em>pscontour</em></a> (for contouring) and
-<a class="reference internal" href="../triangulate.html"><em>triangulate</em></a> (for gridding) use the
-simplest method of interpolating data: a Delaunay triangulation (see
-Section [sec:example<sub>1</sub>2]) which forms <em>z(x, y)</em> as a
-union of planar triangular facets. One advantage of this method is that
-it will not extrapolate <em>z(x, y)</em> beyond the convex hull of the
-input (<em>x, y</em>) data. Another is that it will not estimate a <em>z</em> value
-above or below the local bounds on any triangle. A disadvantage is that
-the <em>z(x, y)</em> surface is not differentiable, but has sharp kinks
-at triangle edges and thus also along contours. This may not look
-physically reasonable, but it can be filtered later (last panel below).
-<a class="reference internal" href="../surface.html"><em>surface</em></a> can be used to generate a
-higher-order (smooth and differentiable) interpolation of
-<em>z(x, y)</em> onto a grid, after which the grid may be illustrated
-(<a class="reference internal" href="../grdcontour.html"><em>grdcontour</em></a>, <a class="reference internal" href="../grdimage.html"><em>grdimage</em></a>,
-<a class="reference internal" href="../grdview.html"><em>grdview</em></a>).
-<a class="reference internal" href="../surface.html"><em>surface</em></a> will interpolate to all (<em>x,
-y</em>) points in a rectangular region, and thus will extrapolate beyond the
-convex hull of the data. However, this can be masked out in various ways
-(see Section [sec:example<sub>1</sub>5]).</p>
-<p>A more serious objection is that <a class="reference internal" href="../surface.html"><em>surface</em></a> may estimate <em>z</em> values
-outside the local range of the data (note area near <em>x</em> = 0.8, <em>y</em> =
-5.3). This commonly happens when the default tension value of zero is
-used to create a “minimum curvature” (most smooth) interpolant.
-<a class="reference internal" href="../surface.html"><em>surface</em></a> can be used with non-zero
-tension to partially overcome this problem. The limiting value
-<em>tension = 1</em> should approximate the triangulation, while a value
-between 0 and 1 may yield a good compromise between the above two cases.
-A value of 0.5 is shown here (Figure [fig:example:sub:<cite>1</cite>6]). A side
-effect of the tension is that it tends to make the contours turn near
-the edges of the domain so that they approach the edge from a
-perpendicular direction. A solution is to use
-<a class="reference internal" href="../surface.html"><em>surface</em></a> in a larger area and then use
-<a class="reference internal" href="../grdcut.html"><em>grdcut</em></a> to cut out the desired smaller
-area. Another way to achieve a compromise is to interpolate the data to
-a grid and then filter the grid using <a class="reference internal" href="../grdfft.html"><em>grdfft</em></a> or
-<a class="reference internal" href="../grdfilter.html"><em>grdfilter</em></a>. The latter can handle
-grids containing “NaN” values and it can do median and mode filters as
-well as convolutions. Shown here is <a class="reference internal" href="../triangulate.html"><em>triangulate</em></a> followed by
-<a class="reference internal" href="../grdfilter.html"><em>grdfilter</em></a>. Note that the filter has
-done some extrapolation beyond the convex hull of the original <em>x, y</em>
-values. The “best” smooth approximation of <em>z(x, y)</em> depends on
-the errors in the data and the physical laws obeyed by <em>z</em>. GMT cannot
-always do the “best” thing but it offers great flexibility through its
-combinations of tools. We illustrate all four solutions using a CPT file
-that contains color fills, predefined patterns for interval (900,925)
-and NaN, an image pattern for interval (875,900), and a “skip slice”
-request for interval (700,725).</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 16</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Illustrates interpolation methods using same data as Example 12.</span>
-<span class="c"># GMT progs: gmtset, grdview, grdfilter, pscontour, psscale, pstext, surface, triangulate</span>
-<span class="c"># Unix progs: echo, rm</span>
-<span class="c">#</span>
-<span class="c"># Illustrate various means of contouring, using triangulate and surface.</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_16.ps
-gmt gmtset FONT_ANNOT_PRIMARY 9p
-<span class="c">#</span>
-gmt pscontour -R0/6.5/-0.2/6.5 -Jx0.45i -P -K -Y5.5i -Ba2f1 -BWSne table_5.11 -Cex16.cpt -I > <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"3.25 7 pscontour (triangulate)"</span> <span class="p">|</span> gmt pstext -R -J -O -K -N -F+f18p,Times-Roman+jCB >> <span class="nv">$ps</span>
-<span class="c">#</span>
-gmt surface table_5.11 -R -I0.2 -Graws0.nc
-gmt grdview raws0.nc -R -J -B -Cex16.cpt -Qs -O -K -X3.5i >> <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"3.25 7 surface (tension = 0)"</span> <span class="p">|</span> gmt pstext -R -J -O -K -N -F+f18p,Times-Roman+jCB >> <span class="nv">$ps</span>
-<span class="c">#</span>
-gmt surface table_5.11 -R -I0.2 -Graws5.nc -T0.5
-gmt grdview raws5.nc -R -J -B -Cex16.cpt -Qs -O -K -Y-3.75i -X-3.5i >> <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"3.25 7 surface (tension = 0.5)"</span> <span class="p">|</span> gmt pstext -R -J -O -K -N -F+f18p,Times-Roman+jCB >> <span class="nv">$ps</span>
-<span class="c">#</span>
-gmt triangulate table_5.11 -Grawt.nc -R -I0.2 > /dev/null
-gmt grdfilter rawt.nc -Gfiltered.nc -D0 -Fc1
-gmt grdview filtered.nc -R -J -B -Cex16.cpt -Qs -O -K -X3.5i >> <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"3.25 7 triangulate @~\256@~ grdfilter"</span> <span class="p">|</span> gmt pstext -R -J -O -K -N <span class="se">\</span>
- -F+f18p,Times-Roman+jCB >> <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"3.2125 7.5 Gridding of Data"</span> <span class="p">|</span> gmt pstext -R0/10/0/10 -Jx1i -O -K -N <span class="se">\</span>
- -F+f32p,Times-Roman+jCB -X-3.5i >> <span class="nv">$ps</span>
-gmt psscale -D3.25i/0.35i/5i/0.25ih -Cex16.cpt -O -Y-0.75i >> <span class="nv">$ps</span>
-<span class="c">#</span>
-rm -f *.nc gmt.conf
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_16.png"><img alt="../_images/example_16.png" src="../_images/example_16.png" style="width: 500px;" /></a>
-<p class="caption">More ways to grid data.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex15.html"
- title="previous chapter">(15) Gridding, contouring, and masking of unconstrained areas</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex17.html"
- title="next chapter">(17) Images clipped by coastlines</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex16.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex17.html" title="(17) Images clipped by coastlines"
- >next</a> </li>
- <li class="right" >
- <a href="ex15.html" title="(15) Gridding, contouring, and masking of unconstrained areas"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex17.html b/doc_release/html/gallery/ex17.html
deleted file mode 100644
index 39b18fc..0000000
--- a/doc_release/html/gallery/ex17.html
+++ /dev/null
@@ -1,216 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(17) Images clipped by coastlines — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(18) Volumes and Spatial Selections" href="ex18.html" />
- <link rel="prev" title="(16) Gridding of data, continued" href="ex16.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex18.html" title="(18) Volumes and Spatial Selections"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex16.html" title="(16) Gridding of data, continued"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="images-clipped-by-coastlines">
-<span id="example-17"></span><h1>(17) Images clipped by coastlines<a class="headerlink" href="#images-clipped-by-coastlines" title="Permalink to this headline">¶</a></h1>
-<p>This example demonstrates how <a class="reference internal" href="../pscoast.html"><em>pscoast</em></a>
-can be used to set up clip paths based on coastlines. This approach is
-well suited when different gridded data sets are to be merged on a plot
-using different color palette files. Merging the files themselves may
-not be doable since they may represent different data sets, as we show
-in this example. Here, we lay down a color map of the geoid field near
-India with <a class="reference internal" href="../grdimage.html"><em>grdimage</em></a>, use
-<a class="reference internal" href="../pscoast.html"><em>pscoast</em></a> to set up land clip paths, and
-then overlay topography from the ETOPO5 data set with another call to
-<a class="reference internal" href="../grdimage.html"><em>grdimage</em></a>. We finally undo the
-clippath with a second call to <a class="reference internal" href="../pscoast.html"><em>pscoast</em></a>
-with the option <strong>-Q</strong> (Figure [fig:example:sub:<cite>1</cite>7]):</p>
-<p>We also plot a color legend on top of the land. So here we basically
-have three layers of “paint” stacked on top of each other: the
-underlaying geoid map, the land mask, and finally the color legend. This
-legend makes clear how <a class="reference internal" href="../grd2cpt.html"><em>grd2cpt</em></a>
-distributed the colors over the range: they are not of equal length put
-are associated with equal amounts of area in the plot. Since the high
-amounts (in red) are not very prevalent, that color spans a long range.</p>
-<p>For this image it is appropriate to use the <strong>-I</strong> option in
-<a class="reference internal" href="../psscale.html"><em>psscale</em></a> so the legend gets shaded,
-similar to the geoid grid. See Appendix [app:M] to learn more about
-color palettes and ways to draw color legends.</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 17</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Illustrates clipping of images using coastlines</span>
-<span class="c"># GMT progs: grd2cpt, grdgradient, grdimage, pscoast, pstext</span>
-<span class="c"># Unix progs: rm</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_17.ps
-
-<span class="c"># First generate geoid image w/ shading</span>
-
-gmt grd2cpt india_geoid.nc -Crainbow > geoid.cpt
-gmt grdgradient india_geoid.nc -Nt1 -A45 -Gindia_geoid_i.nc
-gmt grdimage india_geoid.nc -Iindia_geoid_i.nc -JM6.5i -Cgeoid.cpt -P -K > <span class="nv">$ps</span>
-
-<span class="c"># Then use gmt pscoast to initiate clip path for land</span>
-
-gmt pscoast -Rindia_geoid.nc -J -O -K -Dl -Gc >> <span class="nv">$ps</span>
-
-<span class="c"># Now generate topography image w/shading</span>
-
-<span class="nb">echo</span> <span class="s2">"-10000 150 10000 150"</span> > gray.cpt
-gmt grdgradient india_topo.nc -Nt1 -A45 -Gindia_topo_i.nc
-gmt grdimage india_topo.nc -Iindia_topo_i.nc -J -Cgray.cpt -O -K >> <span class="nv">$ps</span>
-
-<span class="c"># Finally undo clipping and overlay basemap</span>
-
-gmt pscoast -R -J -O -K -Q -B10f5 -B+t<span class="s2">"Clipping of Images"</span> >> <span class="nv">$ps</span>
-
-<span class="c"># Put a color legend on top of the land mask</span>
-
-gmt psscale -D4i/7.6i/4i/0.2ih -Cgeoid.cpt -Bx5f1 -By+lm -I -O -K >> <span class="nv">$ps</span>
-
-<span class="c"># Add a text paragraph</span>
-
-gmt pstext -R -J -O -M -Gwhite -Wthinner -TO -D-0.1i/0.1i -F+f12,Times-Roman+jRB >> <span class="nv">$ps</span> <span class="s"><< END</span>
-<span class="s">> 90 -10 12p 3i j</span>
-<span class="s">@_@%5%Example 17.@%%@_ We first plot the color geoid image</span>
-<span class="s">for the entire region, followed by a gray-shaded @#etopo5@#</span>
-<span class="s">image that is clipped so it is only visible inside the coastlines.</span>
-<span class="s">END</span>
-
-<span class="c"># Clean up</span>
-
-rm -f geoid.cpt gray.cpt *_i.nc
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_17.png"><img alt="../_images/example_17.png" src="../_images/example_17.png" style="width: 500px;" /></a>
-<p class="caption">Clipping of images using coastlines.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex16.html"
- title="previous chapter">(16) Gridding of data, continued</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex18.html"
- title="next chapter">(18) Volumes and Spatial Selections</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex17.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex18.html" title="(18) Volumes and Spatial Selections"
- >next</a> </li>
- <li class="right" >
- <a href="ex16.html" title="(16) Gridding of data, continued"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex18.html b/doc_release/html/gallery/ex18.html
deleted file mode 100644
index f08b063..0000000
--- a/doc_release/html/gallery/ex18.html
+++ /dev/null
@@ -1,245 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(18) Volumes and Spatial Selections — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(19) Color patterns on maps" href="ex19.html" />
- <link rel="prev" title="(17) Images clipped by coastlines" href="ex17.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex19.html" title="(19) Color patterns on maps"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex17.html" title="(17) Images clipped by coastlines"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="volumes-and-spatial-selections">
-<span id="example-18"></span><h1>(18) Volumes and Spatial Selections<a class="headerlink" href="#volumes-and-spatial-selections" title="Permalink to this headline">¶</a></h1>
-<p>To demonstrate potential usage of the programs
-<a class="reference internal" href="../gmtspatial.html"><em>gmtspatial</em></a>, <a class="reference internal" href="../grdvolume.html"><em>grdvolume</em></a> and
-<a class="reference internal" href="../gmtselect.html"><em>gmtselect</em></a> we extract a subset of the
-Sandwell & Smith altimetric gravity field <a class="footnote-reference" href="#id2" id="id1">[1]</a> for the northern Pacific
-and decide to isolate all seamounts that (1) exceed 50 mGal in amplitude
-and (2) are within 200 km of the Pratt seamount. We do this by dumping
-the 50 mGal contours to disk, then use gmtspatial that
-returns the mean location of the points making up each closed polygon,
-and then pass these locations to
-<a class="reference internal" href="../gmtselect.html"><em>gmtselect</em></a>, which retains only the
-points within 200 km of Pratt. We then mask out all the data outside
-this radius and use <a class="reference internal" href="../grdvolume.html"><em>grdvolume</em></a> to
-determine the combined area and (gravimetric) volumes of the chosen seamounts. Our
-illustration is presented in Figure.</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 18</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Illustrates volumes of grids inside contours and spatial</span>
-<span class="c"># selection of data</span>
-<span class="c"># GMT progs: gmtset, gmtselect, gmtspatial, grdclip, grdcontour, grdgradient, grdimage</span>
-<span class="c"># GMT progs: grdmath, grdvolume, makecpt, pscoast, psscale, pstext, psxy</span>
-<span class="c"># Unix progs: $AWK, cat, rm</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_18.ps
-
-<span class="c"># Use spherical gmt projection since SS data define on sphere</span>
-gmt gmtset PROJ_ELLIPSOID Sphere FORMAT_FLOAT_OUT %g
-
-<span class="c"># Define location of Pratt seamount and the 400 km diameter</span>
-<span class="nb">echo</span> <span class="s2">"-142.65 56.25 400"</span> > pratt.d
-
-<span class="c"># First generate gravity image w/ shading, label Pratt, and draw a circle</span>
-<span class="c"># of radius = 200 km centered on Pratt.</span>
-
-gmt makecpt -Crainbow -T-60/60/120 -Z > grav.cpt
-gmt grdgradient AK_gulf_grav.nc -Nt1 -A45 -GAK_gulf_grav_i.nc
-gmt grdimage AK_gulf_grav.nc -IAK_gulf_grav_i.nc -JM5.5i -Cgrav.cpt -B2f1 -P -K -X1.5i <span class="se">\</span>
- -Y5.85i > <span class="nv">$ps</span>
-gmt pscoast -RAK_gulf_grav.nc -J -O -K -Di -Ggray -Wthinnest >> <span class="nv">$ps</span>
-gmt psscale -D2.75i/-0.4i/4i/0.15ih -Cgrav.cpt -Bx20f10 -By+l<span class="s2">"mGal"</span> -O -K >> <span class="nv">$ps</span>
-<span class="nv">$AWK</span> <span class="s1">'{print $1, $2, "Pratt"}'</span> pratt.d <span class="p">|</span> gmt pstext -R -J -O -K -D0.1i/0.1i <span class="se">\</span>
- -F+f12p,Helvetica-Bold+jLB >> <span class="nv">$ps</span>
-gmt psxy pratt.d -R -J -O -K -SE- -Wthinnest >> <span class="nv">$ps</span>
-
-<span class="c"># Then draw 10 mGal contours and overlay 50 mGal contour in green</span>
-
-gmt grdcontour AK_gulf_grav.nc -J -C20 -B2f1 -BWSEn -O -K -Y-4.85i >> <span class="nv">$ps</span>
-<span class="c"># Save 50 mGal contours to individual files, then plot them</span>
-gmt grdcontour AK_gulf_grav.nc -C10 -L49/51 -Dsm_%d_%c.txt
-gmt psxy -R -J -O -K -Wthin,green sm_*.txt >> <span class="nv">$ps</span>
-gmt pscoast -R -J -O -K -Di -Ggray -Wthinnest >> <span class="nv">$ps</span>
-gmt psxy pratt.d -R -J -O -K -SE- -Wthinnest >> <span class="nv">$ps</span>
-rm -f sm_*_O.txt <span class="c"># Only consider the closed contours</span>
-
-<span class="c"># Now determine centers of each enclosed seamount > 50 mGal but only plot</span>
-<span class="c"># the ones within 200 km of Pratt seamount.</span>
-
-<span class="c"># First determine mean location of each closed contour and</span>
-<span class="c"># add it to the file centers.d</span>
-
-gmt gmtspatial -Q -fg sm_*_C.txt > centers.d
-
-<span class="c"># Only plot the ones within 200 km</span>
-
-gmt gmtselect -C200k/pratt.d centers.d -fg <span class="p">|</span> gmt psxy -R -J -O -K -SC0.04i -Gred -Wthinnest >> <span class="nv">$ps</span>
-gmt psxy -R -J -O -K -ST0.1i -Gyellow -Wthinnest pratt.d >> <span class="nv">$ps</span>
-
-<span class="c"># Then report the volume and area of these seamounts only</span>
-<span class="c"># by masking out data outside the 200 km-radius circle</span>
-<span class="c"># and then evaluate area/volume for the 50 mGal contour</span>
-
-gmt grdmath -R <span class="sb">`</span><span class="nv">$AWK</span> <span class="s1">'{print $1, $2}'</span> pratt.d<span class="sb">`</span> <span class="nv">SDIST</span> <span class="o">=</span> mask.nc
-gmt grdclip mask.nc -Sa200/NaN -Sb200/1 -Gmask.nc
-gmt grdmath AK_gulf_grav.nc mask.nc <span class="nv">MUL</span> <span class="o">=</span> tmp.nc
-<span class="nv">area</span><span class="o">=</span><span class="sb">`</span>gmt grdvolume tmp.nc -C50 -Sk <span class="p">|</span> cut -f2<span class="sb">`</span>
-<span class="nv">volume</span><span class="o">=</span><span class="sb">`</span>gmt grdvolume tmp.nc -C50 -Sk <span class="p">|</span> cut -f3<span class="sb">`</span>
-
-gmt psxy -R -J -A -O -K -L -Wthin -Gwhite >> <span class="nv">$ps</span> <span class="s"><< END</span>
-<span class="s">-148.5 52.75</span>
-<span class="s">-141 52.75</span>
-<span class="s">-141 53.75</span>
-<span class="s">-148.5 53.75</span>
-<span class="s">END</span>
-gmt pstext -R -J -O -F+f14p,Helvetica-Bold+jLM >> <span class="nv">$ps</span> <span class="s"><< END</span>
-<span class="s">-148 53.08 Areas: $area km at +2@+</span>
-<span class="s">-148 53.42 Volumes: $volume mGal\264km at +2@+</span>
-<span class="s">END</span>
-
-<span class="c"># Clean up</span>
-
-rm -f grav.cpt sm_*.txt *_i.nc tmp.nc mask.nc pratt.d center* gmt.conf
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_18.png"><img alt="../_images/example_18.png" src="../_images/example_18.png" style="width: 500px;" /></a>
-<p class="caption">Volumes and geo-spatial selections.</p>
-</div>
-<table class="docutils footnote" frame="void" id="id2" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id1">[1]</a></td><td>See <a class="reference external" href="http://topex.ucsd.edu/marine_grav/mar_grav.html">http://topex.ucsd.edu/marine_grav/mar_grav.html</a>.</td></tr>
-</tbody>
-</table>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex17.html"
- title="previous chapter">(17) Images clipped by coastlines</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex19.html"
- title="next chapter">(19) Color patterns on maps</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex18.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex19.html" title="(19) Color patterns on maps"
- >next</a> </li>
- <li class="right" >
- <a href="ex17.html" title="(17) Images clipped by coastlines"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex19.html b/doc_release/html/gallery/ex19.html
deleted file mode 100644
index 7822713..0000000
--- a/doc_release/html/gallery/ex19.html
+++ /dev/null
@@ -1,209 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(19) Color patterns on maps — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(20) Custom plot symbols" href="ex20.html" />
- <link rel="prev" title="(18) Volumes and Spatial Selections" href="ex18.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex20.html" title="(20) Custom plot symbols"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex18.html" title="(18) Volumes and Spatial Selections"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="color-patterns-on-maps">
-<span id="example-19"></span><h1>(19) Color patterns on maps<a class="headerlink" href="#color-patterns-on-maps" title="Permalink to this headline">¶</a></h1>
-<p>GMT 3.1 introduced color patterns and this examples give a few cases
-of how to use this new feature. We make a phony poster that advertises
-an international conference on GMT in Honolulu. We use
-<a class="reference internal" href="../grdmath.html"><em>grdmath</em></a>, <a class="reference internal" href="../makecpt.html"><em>makecpt</em></a>, and
-<a class="reference internal" href="../grdimage.html"><em>grdimage</em></a> to draw pleasing color
-backgrounds on maps, and overlay
-<a class="reference internal" href="../pscoast.html"><em>pscoast</em></a> clip paths to have the
-patterns change at the coastlines. The middle panel demonstrates a
-simple <a class="reference internal" href="../pscoast.html"><em>pscoast</em></a> call where the built-in
-pattern # 86 is drawn at 100 dpi but with the black and white pixels
-replaced with color combinations. At the same time the ocean is filled
-with a repeating image of a circuit board (provides in Sun raster
-format). The text GMT in the center is an off-line PostScript file
-that was overlaid using <a class="reference internal" href="../psimage.html"><em>psimage</em></a>. The
-final panel repeats the top panel except that the land and sea images
-have changed places.</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 19</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Illustrates various color pattern effects for maps</span>
-<span class="c"># GMT progs: gmtset, grdimage, grdmath, makecpt, pscoast, pstext, psimage</span>
-<span class="c"># Unix progs: rm</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_19.ps
-
-<span class="c"># First make a worldmap with graded blue oceans and rainbow continents</span>
-
-gmt grdmath -Rd -I1 -r Y COSD <span class="m">2</span> <span class="nv">POW</span> <span class="o">=</span> lat.nc
-gmt grdmath -Rd -I1 -r <span class="nv">X</span> <span class="o">=</span> lon.nc
-<span class="nb">echo</span> <span class="s2">"0 white 1 blue"</span> > lat.cpt
-gmt makecpt -Crainbow -T-180/180/360 -Z > lon.cpt
-gmt grdimage lat.nc -JI0/6.5i -Clat.cpt -P -K -Y7.5i -B0 -nl > <span class="nv">$ps</span>
-gmt pscoast -R -J -O -K -Dc -A5000 -Gc >> <span class="nv">$ps</span>
-gmt grdimage lon.nc -J -Clon.cpt -O -K -nl >> <span class="nv">$ps</span>
-gmt pscoast -R -J -O -K -Q >> <span class="nv">$ps</span>
-gmt pscoast -R -J -O -K -Dc -A5000 -Wthinnest >> <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"0 20 12TH INTERNATIONAL"</span> <span class="p">|</span> gmt pstext -R -J -O -K -F+f32p,Helvetica-Bold,red<span class="o">=</span>thinner >> <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"0 -10 GMT CONFERENCE"</span> <span class="p">|</span> gmt pstext -R -J -O -K -F+f32p,Helvetica-Bold,red<span class="o">=</span>thinner >> <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"0 -30 Honolulu, Hawaii, April 1, 2015"</span> <span class="p">|</span> gmt pstext -R -J -O -K <span class="se">\</span>
- -F+f18p,Helvetica-Bold,green<span class="o">=</span>thinnest >> <span class="nv">$ps</span>
-
-<span class="c"># Then show example of color patterns and placing a PostScript image</span>
-
-gmt pscoast -R -J -O -K -Dc -A5000 -Gp100/86:FredByellow -Sp100/circuit.ras -B0 -Y-3.25i >> <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"0 30 SILLY USES OF"</span> <span class="p">|</span> gmt pstext -R -J -O -K -F+f32p,Helvetica-Bold,lightgreen<span class="o">=</span>thinner >> <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"0 -30 COLOR PATTERNS"</span> <span class="p">|</span> gmt pstext -R -J -O -K -F+f32p,Helvetica-Bold,magenta<span class="o">=</span>thinner >> <span class="nv">$ps</span>
-gmt psimage -C3.25i/1.625i/CM -W3i GMT_covertext.eps -O -K >> <span class="nv">$ps</span>
-
-<span class="c"># Finally repeat 1st plot but exchange the patterns</span>
-
-gmt grdimage lon.nc -J -Clon.cpt -O -K -Y-3.25i -B0 -nl >> <span class="nv">$ps</span>
-gmt pscoast -R -J -O -K -Dc -A5000 -Gc >> <span class="nv">$ps</span>
-gmt grdimage lat.nc -J -Clat.cpt -O -K -nl >> <span class="nv">$ps</span>
-gmt pscoast -R -J -O -K -Q >> <span class="nv">$ps</span>
-gmt pscoast -R -J -O -K -Dc -A5000 -Wthinnest >> <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"0 20 12TH INTERNATIONAL"</span> <span class="p">|</span> gmt pstext -R -J -O -K -F+f32p,Helvetica-Bold,red<span class="o">=</span>thinner >> <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"0 -10 GMT CONFERENCE"</span> <span class="p">|</span> gmt pstext -R -J -O -K -F+f32p,Helvetica-Bold,red<span class="o">=</span>thinner >> <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"0 -30 Honolulu, Hawaii, April 1, 2015"</span> <span class="p">|</span> gmt pstext -R -J -O <span class="se">\</span>
- -F+f18p,Helvetica-Bold,green<span class="o">=</span>thinnest >> <span class="nv">$ps</span>
-
-rm -f l*.nc l*.cpt gmt.conf
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_19.png"><img alt="../_images/example_19.png" src="../_images/example_19.png" style="width: 500px;" /></a>
-<p class="caption">Using color patterns and additional PostScript material in illustrations.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex18.html"
- title="previous chapter">(18) Volumes and Spatial Selections</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex20.html"
- title="next chapter">(20) Custom plot symbols</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex19.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex20.html" title="(20) Custom plot symbols"
- >next</a> </li>
- <li class="right" >
- <a href="ex18.html" title="(18) Volumes and Spatial Selections"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex20.html b/doc_release/html/gallery/ex20.html
deleted file mode 100644
index 6d86ebb..0000000
--- a/doc_release/html/gallery/ex20.html
+++ /dev/null
@@ -1,261 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(20) Custom plot symbols — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(21) Time-series of RedHat stock price" href="ex21.html" />
- <link rel="prev" title="(19) Color patterns on maps" href="ex19.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex21.html" title="(21) Time-series of RedHat stock price"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex19.html" title="(19) Color patterns on maps"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="custom-plot-symbols">
-<span id="example-20"></span><h1>(20) Custom plot symbols<a class="headerlink" href="#custom-plot-symbols" title="Permalink to this headline">¶</a></h1>
-<p>One is often required to make special maps that shows the distribution
-of certain features but one would prefer to use a custom symbol instead
-of the built-in circles, squares, triangles, etc. in the GMT plotting
-programs <a class="reference internal" href="../psxy.html"><em>psxy</em></a> and
-<a class="reference internal" href="../psxyz.html"><em>psxyz</em></a>. Here we demonstrate one approach
-that allows for a fair bit of flexibility in designing ones own symbols.
-The following recipe is used when designing a new symbol.</p>
-<ol class="arabic simple">
-<li>Use <a class="reference internal" href="../psbasemap.html"><em>psbasemap</em></a> (or engineering
-paper!) to set up an empty grid that goes from -0.5 to +0.5 in both
-<em>x</em> and <em>y</em>. Use ruler and compass to draw your new symbol using
-straight lines, arcs of circles, and stand-alone geometrical objects
-(see <a class="reference internal" href="../psxy.html"><em>psxy</em></a> man page for a full
-description of symbol design). In this Section we will create two new
-symbols: a volcano and a bulls eye.</li>
-</ol>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/GMT_volcano.png"><img alt="../_images/GMT_volcano.png" src="../_images/GMT_volcano.png" style="width: 500px;" /></a>
-</div>
-<ol class="arabic">
-<li><p class="first">After designing the symbol we will encode it using a simple set of
-rules. In our case we describe our volcano and bulls eye using these
-three freeform polygon generators:</p>
-<p><img class="math" src="../_images/math/c3c08496f07567285212e468b173bea9ca153fab.png" alt="x_0"/> <img class="math" src="../_images/math/f7e73389b494d356293b5ad9e3601a3a61609e96.png" alt="y_0"/> <em>r</em> <strong>C</strong> [ <strong>-G</strong><em>fill</em> ] [
-<strong>-W</strong><em>pen</em> ] Draw <img class="math" src="../_images/math/c3c08496f07567285212e468b173bea9ca153fab.png" alt="x_0"/> <img class="math" src="../_images/math/f7e73389b494d356293b5ad9e3601a3a61609e96.png" alt="y_0"/> <strong>M</strong> [ <strong>-G</strong><em>fill</em> ]
-[ <strong>-W</strong><em>pen</em> ] Start new element at <img class="math" src="../_images/math/c3c08496f07567285212e468b173bea9ca153fab.png" alt="x_0"/>, <img class="math" src="../_images/math/f7e73389b494d356293b5ad9e3601a3a61609e96.png" alt="y_0"/></p>
-<p><img class="math" src="../_images/math/b31b1ea8e4fe3f618dedfb0e2d8c69a3df7a391d.png" alt="x_1"/> <img class="math" src="../_images/math/f30c7e391f4cef1d7b14050b5916c857c0979cb5.png" alt="y_1"/> <strong>D</strong> Draw straight line from current point
-to <img class="math" src="../_images/math/b31b1ea8e4fe3f618dedfb0e2d8c69a3df7a391d.png" alt="x_1"/>, <img class="math" src="../_images/math/f30c7e391f4cef1d7b14050b5916c857c0979cb5.png" alt="y_1"/> around (<img class="math" src="../_images/math/c3c08496f07567285212e468b173bea9ca153fab.png" alt="x_0"/>, <img class="math" src="../_images/math/f7e73389b494d356293b5ad9e3601a3a61609e96.png" alt="y_0"/>)</p>
-<p><img class="math" src="../_images/math/c3c08496f07567285212e468b173bea9ca153fab.png" alt="x_0"/> <img class="math" src="../_images/math/f7e73389b494d356293b5ad9e3601a3a61609e96.png" alt="y_0"/> <em>r</em> <img class="math" src="../_images/math/d49f1c024407380df81f487799de241fa4e9d29f.png" alt="\alpha_1"/> <img class="math" src="../_images/math/e6c0bd5b79c290b47b422e07545c3757ca182270.png" alt="\alpha_2"/>
-<strong>A</strong> Draw arc segment of radius <em>r</em> from angle
-<img class="math" src="../_images/math/d49f1c024407380df81f487799de241fa4e9d29f.png" alt="\alpha_1"/> to <img class="math" src="../_images/math/e6c0bd5b79c290b47b422e07545c3757ca182270.png" alt="\alpha_2"/></p>
-<p>We also add a few stand-alone circles (for other symbols, see
-<a class="reference internal" href="../psxy.html"><em>psxy</em></a> man page):</p>
-<p><img class="math" src="../_images/math/c3c08496f07567285212e468b173bea9ca153fab.png" alt="x_0"/> <img class="math" src="../_images/math/f7e73389b494d356293b5ad9e3601a3a61609e96.png" alt="y_0"/> <em>r</em> <strong>C</strong> [ <strong>-G</strong><em>fill</em> ] [
-<strong>-W</strong><em>pen</em> ] Draw <img class="math" src="../_images/math/c3c08496f07567285212e468b173bea9ca153fab.png" alt="x_0"/> <img class="math" src="../_images/math/f7e73389b494d356293b5ad9e3601a3a61609e96.png" alt="y_0"/> <em>r</em> <strong>c</strong> [
-<strong>-G</strong><em>fill</em> ] [ <strong>-W</strong><em>pen</em> ] Draw single circle of radius
-<em>r</em> around <img class="math" src="../_images/math/c3c08496f07567285212e468b173bea9ca153fab.png" alt="x_0"/>, <img class="math" src="../_images/math/f7e73389b494d356293b5ad9e3601a3a61609e96.png" alt="y_0"/></p>
-<p>The optional <strong>-G</strong> and <strong>-W</strong> can be used to hardwire the color fill
-and pen for segments (use <strong>-</strong> to disallow fill or line for any
-specific feature). By default the segments are painted based on the
-values of the command line settings.</p>
-<p>Manually applying these rules to our volcano symbol results in a
-definition file <tt class="docutils literal"><span class="pre">volcano.def</span></tt>:</p>
-<p>Without much further discussion we also make a definition file <tt class="docutils literal"><span class="pre">bullseye.def</span></tt> for a
-multi-colored bulls eye symbol. Note that the symbol can be created
-beyond the -0.5 to +0.5 range, as shown by the red lines. There is no
-limit in GMT to the size of the symbols. The center, however, will
-always be at (0,0). This is the point to which the coordinates in
-<a class="reference internal" href="../psxy.html"><em>psxy</em></a> refers.</p>
-<p>The values refer to positions and dimensions illustrated in the
-Figure above.</p>
-</li>
-<li><p class="first">Given proper definition files we may now use them with
-<a class="reference internal" href="../psxy.html"><em>psxy</em></a> or <a class="reference internal" href="../psxyz.html"><em>psxyz</em></a>.</p>
-</li>
-</ol>
-<p>We are now ready to give it a try. Based on the hotspot locations in the
-file <tt class="docutils literal"><span class="pre">hotspots.d</span></tt> (with a 3rd column giving the desired symbol sizes in inches) we
-lay down a world map and overlay red volcano symbols using our
-custom-built volcano symbol and <a class="reference internal" href="../psxy.html"><em>psxy</em></a>. We
-do something similar with the bulls eye symbols. Without the <strong>-G</strong>
-option, however, they get the colors defined in <tt class="docutils literal"><span class="pre">bullseye.def</span></tt>.</p>
-<p>Here is our final map script that produces the Figure:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 20</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Extend GMT to plot custom symbols</span>
-<span class="c"># GMT progs: pscoast, psxy</span>
-<span class="c"># Unix progs: rm</span>
-<span class="c">#</span>
-<span class="c"># Plot a world-map with volcano symbols of different sizes</span>
-<span class="c"># on top given locations and sizes in hotspots.d</span>
-<span class="nv">ps</span><span class="o">=</span>example_20.ps
-
-cat > hotspots.d <span class="s"><< END</span>
-<span class="s">55.5 -21.0 0.25</span>
-<span class="s">63.0 -49.0 0.25</span>
-<span class="s">-12.0 -37.0 0.25</span>
-<span class="s">-28.5 29.34 0.25</span>
-<span class="s">48.4 -53.4 0.25</span>
-<span class="s">155.5 -40.4 0.25</span>
-<span class="s">-155.5 19.6 0.5</span>
-<span class="s">-138.1 -50.9 0.25</span>
-<span class="s">-153.5 -21.0 0.25</span>
-<span class="s">-116.7 -26.3 0.25</span>
-<span class="s">-16.5 64.4 0.25</span>
-<span class="s">END</span>
-
-gmt pscoast -Rg -JR9i -Bx60 -By30 -B+t<span class="s2">"Hotspot Islands and Cities"</span> -Gdarkgreen -Slightblue <span class="se">\</span>
- -Dc -A5000 -K > <span class="nv">$ps</span>
-
-gmt psxy -R -J hotspots.d -Skvolcano -O -K -Wthinnest -Gred >> <span class="nv">$ps</span>
-
-<span class="c"># Overlay a few bullseyes at NY, Cairo, and Perth</span>
-
-cat > cities.d <span class="s"><< END</span>
-<span class="s">286 40.45 0.8</span>
-<span class="s">31.15 30.03 0.8</span>
-<span class="s">115.49 -31.58 0.8</span>
-<span class="s">END</span>
-
-gmt psxy -R -J cities.d -Skbullseye -O >> <span class="nv">$ps</span>
-
-rm -f hotspots.d cities.d
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_20.png"><img alt="../_images/example_20.png" src="../_images/example_20.png" style="width: 500px;" /></a>
-<p class="caption">Using custom symbols in GMT.</p>
-</div>
-<p>Given these guidelines you can easily make your own symbols. Symbols
-with more than one color can be obtained by making several symbol
-components. E.g., to have yellow smoke coming out of red volcanoes we
-would make two symbols: one with just the cone and caldera and the other
-with the bubbles. These would be plotted consecutively using the desired
-colors. Alternatively, like in <tt class="docutils literal"><span class="pre">bullseye.def</span></tt>, we may specify colors directly for the
-various segments. Note that the custom symbols (Appendix [app:N]),
-unlike the built-in symbols in GMT, can be used with the built-in
-patterns (Appendix [app:E]). Other approaches are also possible, of course.</p>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex19.html"
- title="previous chapter">(19) Color patterns on maps</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex21.html"
- title="next chapter">(21) Time-series of RedHat stock price</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex20.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex21.html" title="(21) Time-series of RedHat stock price"
- >next</a> </li>
- <li class="right" >
- <a href="ex19.html" title="(19) Color patterns on maps"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex21.html b/doc_release/html/gallery/ex21.html
deleted file mode 100644
index 34d9d2f..0000000
--- a/doc_release/html/gallery/ex21.html
+++ /dev/null
@@ -1,262 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(21) Time-series of RedHat stock price — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(22) World-wide seismicity the last 7 days" href="ex22.html" />
- <link rel="prev" title="(20) Custom plot symbols" href="ex20.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex22.html" title="(22) World-wide seismicity the last 7 days"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex20.html" title="(20) Custom plot symbols"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="time-series-of-redhat-stock-price">
-<span id="example-21"></span><h1>(21) Time-series of RedHat stock price<a class="headerlink" href="#time-series-of-redhat-stock-price" title="Permalink to this headline">¶</a></h1>
-<p>As discussed in Section [sec:timeaxis], the annotation of time-series is
-generally more complicated due to the extra degrees of freedom afforded
-by the dual annotation system. In this example we will display the trend
-of the stock price of RedHat (RHAT) from their initial public offering
-until late 2006. The data file is a comma-separated table and the
-records look like this:</p>
-<div class="highlight-python"><div class="highlight"><pre>Date,Open,High,Low,Close,Volume,Adj.Close*
-12-Mar-04,17.74,18.49,17.67,18.02,4827500,18.02
-11-Mar-04,17.60,18.90,17.37,18.09,7700400,18.09
-</pre></div>
-</div>
-<p>Hence, we have a single header record and various prices in USD for each
-day of business. We will plot the trend of the opening price as a red
-line superimposed on a yellow envelope representing the low-to-high
-fluctuation during each day. We also indicate when and at what cost Paul
-Wessel bought a few shares, and zoom in on the developments since 2004;
-in the inset we label the time-axis in Finnish in honor of Linus
-Thorvalds. Because the time coordinates are Y2K-challenged and the order
-is backwards (big units of years come <em>after</em> smaller units like days)
-we must change the default input/output formats used by GMT. Finally,
-we want to prefix prices with the $ symbol to indicate the currency.
-Here is how it all comes out:</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 21</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Plot a time-series</span>
-<span class="c"># GMT progs: gmtset, gmtconvert, gmtinfo, psbasemap, psxy </span>
-<span class="c"># Unix progs: cut, echo</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_21.ps
-
-<span class="c"># File has time stored as dd-Mon-yy so set input format to match it</span>
-
-gmt gmtset FORMAT_DATE_IN dd-o-yy FORMAT_DATE_MAP o FONT_ANNOT_PRIMARY +10p
-gmt gmtset FORMAT_TIME_PRIMARY_MAP abbreviated PS_CHAR_ENCODING ISOLatin1+
-
-<span class="c"># Pull out a suitable region string in yyy-mm-dd format</span>
-
-gmt info -fT -I50 -C RHAT_price.csv > RHAT.info
-<span class="nv">w</span><span class="o">=</span><span class="sb">`</span>cut -f1 RHAT.info<span class="sb">`</span>
-<span class="nv">e</span><span class="o">=</span><span class="sb">`</span>cut -f2 RHAT.info<span class="sb">`</span>
-<span class="nv">s</span><span class="o">=</span><span class="sb">`</span>cut -f3 RHAT.info<span class="sb">`</span>
-<span class="nv">n</span><span class="o">=</span><span class="sb">`</span>cut -f4 RHAT.info<span class="sb">`</span>
-<span class="nv">R</span><span class="o">=</span><span class="s2">"-R</span><span class="nv">$w</span><span class="s2">/</span><span class="nv">$e</span><span class="s2">/</span><span class="nv">$s</span><span class="s2">/</span><span class="nv">$n</span><span class="s2">"</span>
-
-<span class="c"># Lay down the basemap:</span>
-
-gmt psbasemap <span class="nv">$R</span> -JX9i/6i -K -Bsx1Y -Bpxa3Of1o -Bpy50+p<span class="s2">"</span><span class="nv">$ </span><span class="s2">"</span> <span class="se">\</span>
- -BWSen+t<span class="s2">"RedHat (RHT) Stock Price Trend since IPO"</span>+glightgreen > <span class="nv">$ps</span>
-
-<span class="c"># Plot main window with open price as red line over yellow envelope of low/highs</span>
-
-gmt gmtset FORMAT_DATE_OUT dd-o-yy
-gmt gmtconvert -o0,2 -f0T RHAT_price.csv > RHAT.env
-gmt gmtconvert -o0,3 -f0T -I -T RHAT_price.csv >> RHAT.env
-gmt psxy -R -J -Gyellow -O -K RHAT.env >> <span class="nv">$ps</span>
-gmt psxy -R -J RHAT_price.csv -Wthin,red -O -K >> <span class="nv">$ps</span>
-
-<span class="c"># Draw P Wessel's purchase price as line and label it. Note we temporary switch</span>
-<span class="c"># back to default yyyy-mm-dd format since that is what gmt info gave us.</span>
-
-<span class="nb">echo</span> <span class="s2">"05-May-00 0"</span> > RHAT.pw
-<span class="nb">echo</span> <span class="s2">"05-May-00 300"</span> >> RHAT.pw
-gmt psxy -R -J RHAT.pw -Wthinner,- -O -K >> <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"01-Jan-99 25"</span> > RHAT.pw
-<span class="nb">echo</span> <span class="s2">"01-Jan-02 25"</span> >> RHAT.pw
-gmt psxy -R -J RHAT.pw -Wthick,- -O -K >> <span class="nv">$ps</span>
-gmt gmtset FORMAT_DATE_IN yyyy-mm-dd
-<span class="nb">echo</span> <span class="s2">"</span><span class="nv">$w</span><span class="s2"> 25 PW buy"</span> <span class="p">|</span> gmt pstext -R -J -O -K -D1.5i/0.05i -N -F+f12p,Bookman-Demi+jLB >> <span class="nv">$ps</span>
-gmt gmtset FORMAT_DATE_IN dd-o-yy
-
-<span class="c"># Draw P Wessel's sales price as line and label it.</span>
-
-<span class="nb">echo</span> <span class="s2">"25-Jun-07 0"</span> > RHAT.pw
-<span class="nb">echo</span> <span class="s2">"25-Jun-07 300"</span> >> RHAT.pw
-gmt psxy -R -J RHAT.pw -Wthinner,- -O -K >> <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"01-Aug-06 23.8852"</span> > RHAT.pw
-<span class="nb">echo</span> <span class="s2">"01-Jan-08 23.8852"</span> >> RHAT.pw
-gmt psxy -R -J RHAT.pw -Wthick,- -O -K >> <span class="nv">$ps</span>
-gmt gmtset FORMAT_DATE_IN yyyy-mm-dd
-<span class="nb">echo</span> <span class="s2">"</span><span class="nv">$e</span><span class="s2"> 23.8852 PW sell"</span> <span class="p">|</span> gmt pstext -R -J -O -K -Dj0.8i/0.05i -N <span class="se">\</span>
- -F+f12p,Bookman-Demi+jRB >> <span class="nv">$ps</span>
-gmt gmtset FORMAT_DATE_IN dd-o-yy
-
-<span class="c"># Get smaller region for insert for trend since 2004</span>
-
-<span class="nv">R</span><span class="o">=</span><span class="s2">"-R2004T/</span><span class="nv">$e</span><span class="s2">/</span><span class="nv">$s</span><span class="s2">/40"</span>
-
-<span class="c"># Lay down the basemap, using Finnish annotations and place the insert in the upper right</span>
-
-gmt psbasemap --TIME_LANGUAGE<span class="o">=</span><span class="k">fi</span> <span class="nv">$R</span> -JX6i/3i -Bpxa3Of3o -Bpy10+p<span class="s2">"</span><span class="nv">$ </span><span class="s2">"</span> -BESw+glightblue -Bsx1Y <span class="se">\</span>
- -O -K -X3i -Y3i >> <span class="nv">$ps</span>
-
-<span class="c"># Again, plot close price as red line over yellow envelope of low/highs</span>
-
-gmt psxy -R -J -Gyellow -O -K RHAT.env >> <span class="nv">$ps</span>
-gmt psxy -R -J RHAT_price.csv -Wthin,red -O -K >> <span class="nv">$ps</span>
-
-<span class="c"># Draw P Wessel's sales price as dashed line</span>
-
-gmt psxy -R -J RHAT.pw -Wthick,- -O -K >> <span class="nv">$ps</span>
-
-<span class="c"># Mark sales date</span>
-
-<span class="nb">echo</span> <span class="s2">"25-Jun-07 0"</span> > RHAT.pw
-<span class="nb">echo</span> <span class="s2">"25-Jun-07 300"</span> >> RHAT.pw
-gmt psxy -R -J RHAT.pw -Wthinner,- -O >> <span class="nv">$ps</span>
-
-<span class="c"># Clean up after ourselves:</span>
-
-rm -f RHAT.* gmt.conf
-</pre></div>
-</div>
-<p>which produces the plot in Figure, suggesting
-Wessel has missed a few trains if he had hoped to cash in on the
-Internet bubble...</p>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_21.png"><img alt="../_images/example_21.png" src="../_images/example_21.png" style="width: 500px;" /></a>
-<p class="caption">Time-series of RedHat stock price since IPO.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex20.html"
- title="previous chapter">(20) Custom plot symbols</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex22.html"
- title="next chapter">(22) World-wide seismicity the last 7 days</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex21.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex22.html" title="(22) World-wide seismicity the last 7 days"
- >next</a> </li>
- <li class="right" >
- <a href="ex20.html" title="(20) Custom plot symbols"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex22.html b/doc_release/html/gallery/ex22.html
deleted file mode 100644
index 63c809f..0000000
--- a/doc_release/html/gallery/ex22.html
+++ /dev/null
@@ -1,266 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(22) World-wide seismicity the last 7 days — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(23) All great-circle paths lead to Rome" href="ex23.html" />
- <link rel="prev" title="(21) Time-series of RedHat stock price" href="ex21.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex23.html" title="(23) All great-circle paths lead to Rome"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex21.html" title="(21) Time-series of RedHat stock price"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="world-wide-seismicity-the-last-7-days">
-<span id="example-22"></span><h1>(22) World-wide seismicity the last 7 days<a class="headerlink" href="#world-wide-seismicity-the-last-7-days" title="Permalink to this headline">¶</a></h1>
-<p>The next example uses the command-line tool <strong>wget</strong> to obtain a data
-file from a specified URL <a class="footnote-reference" href="#id2" id="id1">[1]</a>. In the example script this line is
-commented out so the example will run even if you do not have <strong>wget</strong>
-(we use the supplied <tt class="docutils literal"><span class="pre">neic_quakes.d</span></tt> which normally would be created by <strong>wget</strong>);
-remove the comment to get the actual current seismicity plot using the
-live data. The main purpose of this script is not to show how to plot a
-map background and a few circles, but rather demonstrate how a map
-legend may be composed using the new tool
-<a class="reference internal" href="../pslegend.html"><em>pslegend</em></a>. Some scripting is used to
-pull out information from the data file that is later used in the
-legend. The legend will normally have the email address of the script
-owner; here that command is commented out and the user is hardwired to
-“GMT guru”. The USGS logo, taken from their web page and converted to a
-Sun raster file, is used to spice up the legend.</p>
-<p>The script produces the plot in Figure,
-giving the URL where these and similar data can be obtained.</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 22</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Automatic map of last 7 days of world-wide seismicity</span>
-<span class="c"># GMT progs: gmtset, pscoast, psxy, pslegend</span>
-<span class="c"># Unix progs: cat, sed, awk, wget|curl</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_22.ps
-gmt gmtset FONT_ANNOT_PRIMARY 10p FONT_TITLE 18p FORMAT_GEO_MAP ddd:mm:ssF
-
-<span class="c"># Get the data (-q quietly) from USGS using the wget (comment out in case</span>
-<span class="c"># your system does not have wget or curl)</span>
-
-<span class="c">#wget http://neic.usgs.gov/neis/gis/bulletin.asc -q -O neic_quakes.d</span>
-<span class="c">#curl http://neic.usgs.gov/neis/gis/bulletin.asc -s > neic_quakes.d</span>
-
-<span class="c"># Count the number of events (to be used in title later. one less due to header)</span>
-
-<span class="nv">n</span><span class="o">=</span><span class="sb">`</span>cat neic_quakes.d <span class="p">|</span> wc -l<span class="sb">`</span>
-<span class="nv">n</span><span class="o">=</span><span class="sb">`</span>expr <span class="nv">$n</span> - 1<span class="sb">`</span>
-
-<span class="c"># Pull out the first and last timestamp to use in legend title</span>
-
-<span class="nv">first</span><span class="o">=</span><span class="sb">`</span>sed -n 2p neic_quakes.d <span class="p">|</span> <span class="nv">$AWK</span> -F, <span class="s1">'{printf "%s %s\n", $1, $2}'</span><span class="sb">`</span>
-<span class="nv">last</span><span class="o">=</span><span class="sb">`</span>sed -n <span class="s1">'$p'</span> neic_quakes.d <span class="p">|</span> <span class="nv">$AWK</span> -F, <span class="s1">'{printf "%s %s\n", $1, $2}'</span><span class="sb">`</span>
-
-<span class="c"># Assign a string that contains the current user @ the current computer node.</span>
-<span class="c"># Note that two @@ is needed to print a single @ in gmt pstext:</span>
-
-<span class="c">#set me = "$user@@`hostname`"</span>
-<span class="nv">me</span><span class="o">=</span><span class="s2">"GMT guru @@ GMTbox"</span>
-
-<span class="c"># Create standard seismicity color table</span>
-
-cat > neis.cpt <span class="s"><< END</span>
-<span class="s">0 red 100 red</span>
-<span class="s">100 green 300 green</span>
-<span class="s">300 blue 10000 blue</span>
-<span class="s">END</span>
-
-<span class="c"># Start plotting. First lay down map, then plot quakes with size = magintude/50":</span>
-
-gmt pscoast -Rg -JK180/9i -B45g30 -B+t<span class="s2">"World-wide earthquake activity"</span> -Gbrown -Slightblue <span class="se">\</span>
- -Dc -A1000 -K -Y2.75i > <span class="nv">$ps</span>
-<span class="nv">$AWK</span> -F, <span class="s1">'{ print $4, $3, $6, $5*0.02}'</span> neic_quakes.d <span class="se">\</span>
- <span class="p">|</span> gmt psxy -R -JK -O -K -Cneis.cpt -Sci -Wthin -h >> <span class="nv">$ps</span>
-<span class="c"># Create legend input file for NEIS quake plot</span>
-
-cat > neis.legend <span class="s"><< END</span>
-<span class="s">H 16 1 $n events during $first to $last</span>
-<span class="s">D 0 1p</span>
-<span class="s">N 3</span>
-<span class="s">V 0 1p</span>
-<span class="s">S 0.1i c 0.1i red 0.25p 0.2i Shallow depth (0-100 km)</span>
-<span class="s">S 0.1i c 0.1i green 0.25p 0.2i Intermediate depth (100-300 km)</span>
-<span class="s">S 0.1i c 0.1i blue 0.25p 0.2i Very deep (> 300 km)</span>
-<span class="s">V 0 1p</span>
-<span class="s">D 0 1p</span>
-<span class="s">N 7</span>
-<span class="s">V 0 1p</span>
-<span class="s">S 0.1i c 0.06i - 0.25p 0.3i M 3</span>
-<span class="s">S 0.1i c 0.08i - 0.25p 0.3i M 4</span>
-<span class="s">S 0.1i c 0.10i - 0.25p 0.3i M 5</span>
-<span class="s">S 0.1i c 0.12i - 0.25p 0.3i M 6</span>
-<span class="s">S 0.1i c 0.14i - 0.25p 0.3i M 7</span>
-<span class="s">S 0.1i c 0.16i - 0.25p 0.3i M 8</span>
-<span class="s">S 0.1i c 0.18i - 0.25p 0.3i M 9</span>
-<span class="s">V 0 1p</span>
-<span class="s">D 0 1p</span>
-<span class="s">N 1</span>
-<span class="s">END</span>
-
-<span class="c"># Put together a reasonable legend text, and add logo and user's name:</span>
-
-cat <span class="s"><< END >> neis.legend</span>
-<span class="s">P</span>
-<span class="s">T USGS/NEIS most recent earthquakes for the last seven days. The data were</span>
-<span class="s">T obtained automatically from the USGS Earthquake Hazards Program page at</span>
-<span class="s">T @_http://neic/usgs.gov @_. Interested users may also receive email alerts</span>
-<span class="s">T from the USGS.</span>
-<span class="s">T This script can be called daily to update the latest information.</span>
-<span class="s">G 0.4i</span>
-<span class="s"># Add USGS logo</span>
-<span class="s">I USGS.ras 1i RT</span>
-<span class="s">G -0.3i</span>
-<span class="s">L 12 6 LB $me</span>
-<span class="s">END</span>
-
-<span class="c"># OK, now we can actually run gmt pslegend. We center the legend below the map.</span>
-<span class="c"># Trial and error shows that 1.7i is a good legend height:</span>
-
-gmt pslegend -Dx4.5i/-0.4i/7i/1.7i/TC -O -F+p+glightyellow neis.legend >> <span class="nv">$ps</span>
-
-<span class="c"># Clean up after ourselves:</span>
-
-rm -f neis.* gmt.conf
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_22.png"><img alt="../_images/example_22.png" src="../_images/example_22.png" style="width: 500px;" /></a>
-<p class="caption">World-wide seismicity the last 7 days.</p>
-</div>
-<table class="docutils footnote" frame="void" id="id2" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id1">[1]</a></td><td>You can also use the utility <strong>curl</strong></td></tr>
-</tbody>
-</table>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex21.html"
- title="previous chapter">(21) Time-series of RedHat stock price</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex23.html"
- title="next chapter">(23) All great-circle paths lead to Rome</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex22.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex23.html" title="(23) All great-circle paths lead to Rome"
- >next</a> </li>
- <li class="right" >
- <a href="ex21.html" title="(21) Time-series of RedHat stock price"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex23.html b/doc_release/html/gallery/ex23.html
deleted file mode 100644
index f077253..0000000
--- a/doc_release/html/gallery/ex23.html
+++ /dev/null
@@ -1,230 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(23) All great-circle paths lead to Rome — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(24) Data selection based on geospatial criteria" href="ex24.html" />
- <link rel="prev" title="(22) World-wide seismicity the last 7 days" href="ex22.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex24.html" title="(24) Data selection based on geospatial criteria"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex22.html" title="(22) World-wide seismicity the last 7 days"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="all-great-circle-paths-lead-to-rome">
-<span id="example-23"></span><h1>(23) All great-circle paths lead to Rome<a class="headerlink" href="#all-great-circle-paths-lead-to-rome" title="Permalink to this headline">¶</a></h1>
-<p>While motorists recently have started to question the old saying “all
-roads lead to Rome”, aircraft pilots have known from the start that only
-one great-circle path connects the points of departure and
-arrival <a class="footnote-reference" href="#id2" id="id1">[1]</a>. This provides the inspiration for our next example which
-uses <a class="reference internal" href="../grdmath.html"><em>grdmath</em></a> to calculate distances
-from Rome to anywhere on Earth and
-<a class="reference internal" href="../grdcontour.html"><em>grdcontour</em></a> to contour these
-distances. We pick five cities that we connect to Rome with great circle
-arcs, and label these cities with their names and distances (in km) from
-Rome, all laid down on top of a beautiful world map. Note that we
-specify that contour labels only be placed along the straight map-line
-connecting Rome to its antipode, and request curved labels that follows
-the shape of the contours.</p>
-<p>The script produces the plot in Figure; note
-how interesting the path to Seattle appears in this particular
-projection (Hammer). We also note that Rome’s antipode lies somewhere
-near the Chatham plateau (antipodes will be revisited in
-Section [sec:example<sub>2</sub>5]).</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 23</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Plot distances from Rome and draw shortest paths</span>
-<span class="c"># GMT progs: grdmath, grdcontour, pscoast, psxy, pstext, grdtrack</span>
-<span class="c"># Unix progs: echo, cat, awk</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_23.ps
-
-<span class="c"># Position and name of central point:</span>
-
-<span class="nv">lon</span><span class="o">=</span>12.50
-<span class="nv">lat</span><span class="o">=</span>41.99
-<span class="nv">name</span><span class="o">=</span><span class="s2">"Rome"</span>
-
-<span class="c"># Calculate distances (km) to all points on a global 1x1 grid</span>
-
-gmt grdmath -Rg -I1 <span class="nv">$lon</span> <span class="nv">$lat</span> <span class="nv">SDIST</span> <span class="o">=</span> dist.nc
-
-<span class="c"># Location info for 5 other cities + label justification</span>
-
-cat <span class="s"><< END > cities.d</span>
-<span class="s">105.87 21.02 HANOI LM</span>
-<span class="s">282.95 -12.1 LIMA LM</span>
-<span class="s">178.42 -18.13 SUVA LM</span>
-<span class="s">237.67 47.58 SEATTLE RM</span>
-<span class="s">28.20 -25.75 PRETORIA LM</span>
-<span class="s">END</span>
-
-gmt pscoast -Rg -JH90/9i -Glightgreen -Sblue -A1000 -Dc -Bg30 <span class="se">\</span>
- -B+t<span class="s2">"Distances from </span><span class="nv">$name</span><span class="s2"> to the World"</span> -K -Wthinnest > <span class="nv">$ps</span>
-
-gmt grdcontour dist.nc -A1000+v+u<span class="s2">" km"</span>+fwhite -Glz-/z+ -S8 -C500 -O -K -J <span class="se">\</span>
- -Wathin,white -Wcthinnest,white,- >> <span class="nv">$ps</span>
-
-<span class="c"># For each of the cities, plot great circle arc to Rome with gmt psxy</span>
-
-<span class="k">while</span> <span class="nb">read </span>clon clat city<span class="p">;</span> <span class="k">do</span>
- <span class="o">(</span><span class="nb">echo</span> <span class="nv">$lon</span> <span class="nv">$lat</span><span class="p">;</span> <span class="nb">echo</span> <span class="nv">$clon</span> <span class="nv">$clat</span><span class="o">)</span> <span class="p">|</span> gmt psxy -R -J -O -K -Wthickest,red >> <span class="nv">$ps</span>
-<span class="k">done</span> < cities.d
-
-<span class="c"># Plot red squares at cities and plot names:</span>
-gmt psxy -R -J -O -K -Ss0.2 -Gred -Wthinnest cities.d >> <span class="nv">$ps</span>
-<span class="nv">$AWK</span> <span class="s1">'{print $1, $2, $4, $3}'</span> cities.d <span class="p">|</span> gmt pstext -R -J -O -K -Dj0.15/0 <span class="se">\</span>
- -F+f12p,Courier-Bold,red+j -N >> <span class="nv">$ps</span>
-<span class="c"># Place a yellow star at Rome</span>
-<span class="nb">echo</span> <span class="s2">"</span><span class="nv">$lon</span><span class="s2"> </span><span class="nv">$lat</span><span class="s2">"</span> <span class="p">|</span> gmt psxy -R -J -O -K -Sa0.2i -Gyellow -Wthin >> <span class="nv">$ps</span>
-
-<span class="c"># Sample the distance grid at the cities and use the distance in km for labels</span>
-
-gmt grdtrack -Gdist.nc cities.d <span class="se">\</span>
- <span class="p">|</span> <span class="nv">$AWK</span> <span class="s1">'{printf "%s %s %d\n", $1, $2, int($NF+0.5)}'</span> <span class="se">\</span>
- <span class="p">|</span> gmt pstext -R -J -O -D0/-0.2i -N -Gwhite -W -C0.02i -F+f12p,Helvetica-Bold+jCT >> <span class="nv">$ps</span>
-
-<span class="c"># Clean up after ourselves:</span>
-
-rm -f cities.d dist.nc
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_23.png"><img alt="../_images/example_23.png" src="../_images/example_23.png" style="width: 500px;" /></a>
-<p class="caption">All great-circle paths lead to Rome.</p>
-</div>
-<table class="docutils footnote" frame="void" id="id2" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id1">[1]</a></td><td>Pedants who wish to argue about the “other” arc going the long way
-should consider using it.</td></tr>
-</tbody>
-</table>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex22.html"
- title="previous chapter">(22) World-wide seismicity the last 7 days</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex24.html"
- title="next chapter">(24) Data selection based on geospatial criteria</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex23.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex24.html" title="(24) Data selection based on geospatial criteria"
- >next</a> </li>
- <li class="right" >
- <a href="ex22.html" title="(22) World-wide seismicity the last 7 days"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex24.html b/doc_release/html/gallery/ex24.html
deleted file mode 100644
index 1773245..0000000
--- a/doc_release/html/gallery/ex24.html
+++ /dev/null
@@ -1,196 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(24) Data selection based on geospatial criteria — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(25) Global distribution of antipodes" href="ex25.html" />
- <link rel="prev" title="(23) All great-circle paths lead to Rome" href="ex23.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex25.html" title="(25) Global distribution of antipodes"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex23.html" title="(23) All great-circle paths lead to Rome"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="data-selection-based-on-geospatial-criteria">
-<span id="example-24"></span><h1>(24) Data selection based on geospatial criteria<a class="headerlink" href="#data-selection-based-on-geospatial-criteria" title="Permalink to this headline">¶</a></h1>
-<p>Although we are not seismologists, we have yet another example involving
-seismicity. We use seismicity data for the Australia/New Zealand region
-to demonstrate how we can extract subsets of data using geospatial
-criteria. In particular, we wish to plot the epicenters given in the
-file <tt class="docutils literal"><span class="pre">oz_quakes.d</span></tt> as red or green circles. Green circles should only be used for
-epicenters that satisfy the following three criteria:</p>
-<ol class="arabic simple">
-<li>They are located in the ocean and not on land</li>
-<li>They are within 3000 km of Hobart</li>
-<li>They are more than 1000 km away from the International Dateline</li>
-</ol>
-<p>All remaining earthquakes should be plotted in red. Rather that doing
-the selection process twice we simply plot all quakes as red circles and
-then replot those that pass our criteria. Most of the work here is done
-by <a class="reference internal" href="../gmtselect.html"><em>gmtselect</em></a>; the rest is carried
-out by the usual <a class="reference internal" href="../pscoast.html"><em>pscoast</em></a> and
-<a class="reference internal" href="../psxy.html"><em>psxy</em></a> workhorses. Note for our purposes
-the Dateline is just a line along the 180 meridian.</p>
-<p>The script produces the plot in Figure. Note
-that the horizontal distance from the dateline seems to increase as we
-go south; however that is just the projected distance (Mercator
-distortion) and not the actual distance which remains constant at 1000 km.</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 24</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Extract subsets of data based on geospatial criteria</span>
-<span class="c"># GMT progs: gmtselect, pscoast, psxy, gmtinfo</span>
-<span class="c"># Unix progs: echo, cat, awk</span>
-<span class="c">#</span>
-<span class="c"># Highlight oceanic earthquakes within 3000 km of Hobart and > 1000 km from dateline</span>
-<span class="nv">ps</span><span class="o">=</span>example_24.ps
-<span class="nb">echo</span> <span class="s2">"147:13 -42:48 6000 Hobart"</span> > point.d
-cat <span class="s"><< END > dateline.d</span>
-<span class="s">> Our proxy for the dateline</span>
-<span class="s">180 0</span>
-<span class="s">180 -90</span>
-<span class="s">END</span>
-<span class="nv">R</span><span class="o">=</span><span class="sb">`</span>gmt info -I10 oz_quakes.d<span class="sb">`</span>
-gmt pscoast <span class="nv">$R</span> -JM9i -K -Gtan -Sdarkblue -Wthin,white -Dl -A500 -Ba20f10g10 -BWeSn > <span class="nv">$ps</span>
-gmt psxy -R -J -O -K oz_quakes.d -Sc0.05i -Gred >> <span class="nv">$ps</span>
-gmt gmtselect oz_quakes.d -L1000k/dateline.d -Nk/s -C3000k/point.d -fg -R -Il <span class="se">\</span>
- <span class="p">|</span> gmt psxy -R -JM -O -K -Sc0.05i -Ggreen >> <span class="nv">$ps</span>
-gmt psxy point.d -R -J -O -K -SE- -Wfat,white >> <span class="nv">$ps</span>
-<span class="nv">$AWK</span> <span class="s1">'{print $1, $2, $4}'</span> point.d <span class="p">|</span> gmt pstext -R -J -O -K -F+f14p,Helvetica-Bold,white+jLT <span class="se">\</span>
- -D0.1i/-0.1i >> <span class="nv">$ps</span>
-gmt psxy -R -J -O -K point.d -Wfat,white -S+0.2i >> <span class="nv">$ps</span>
-gmt psxy -R -J -O dateline.d -Wfat,white -A >> <span class="nv">$ps</span>
-rm -f point.d dateline.d
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_24.png"><img alt="../_images/example_24.png" src="../_images/example_24.png" style="width: 500px;" /></a>
-<p class="caption">Data selection based on geospatial criteria.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex23.html"
- title="previous chapter">(23) All great-circle paths lead to Rome</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex25.html"
- title="next chapter">(25) Global distribution of antipodes</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex24.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex25.html" title="(25) Global distribution of antipodes"
- >next</a> </li>
- <li class="right" >
- <a href="ex23.html" title="(23) All great-circle paths lead to Rome"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex25.html b/doc_release/html/gallery/ex25.html
deleted file mode 100644
index 89eda74..0000000
--- a/doc_release/html/gallery/ex25.html
+++ /dev/null
@@ -1,223 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(25) Global distribution of antipodes — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(26) General vertical perspective projection" href="ex26.html" />
- <link rel="prev" title="(24) Data selection based on geospatial criteria" href="ex24.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex26.html" title="(26) General vertical perspective projection"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex24.html" title="(24) Data selection based on geospatial criteria"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="global-distribution-of-antipodes">
-<span id="example-25"></span><h1>(25) Global distribution of antipodes<a class="headerlink" href="#global-distribution-of-antipodes" title="Permalink to this headline">¶</a></h1>
-<p>As promised in Section [sec:example<sub>2</sub>3], we will study
-antipodes. The antipode of a point at <img class="math" src="../_images/math/5b146592a85ad23658360f6f0241129f95e3f9e6.png" alt="(\phi, \lambda)"/> is the
-point at <img class="math" src="../_images/math/4cc59ba75365fde3a7a3a0972826e2602ffb9f74.png" alt="(-\phi, \lambda + 180)"/>. We seek an answer to the
-question that has plagued so many for so long: Given the distribution of
-land and ocean, how often is the antipode of a point on land also on
-land? And what about marine antipodes? We use <a class="reference internal" href="../grdlandmask.html"><em>grdlandmask</em></a> and
-<a class="reference internal" href="../grdmath.html"><em>grdmath</em></a> to map these distributions and
-calculate the area of the Earth (in percent) that goes with each of the
-three possibilities. To make sense of our
-<a class="reference internal" href="../grdmath.html"><em>grdmath</em></a> equations below, note that we
-first calculate a grid that is +1 when a point and its antipode is on
-land, -1 if both are in the ocean, and 0 elsewhere. We then seek to
-calculate the area distribution of dry antipodes by only pulling out the
-nodes that equal +1. As each point represent an area approximated by
-<img class="math" src="../_images/math/2593411df0122575686389de04320006190b7322.png" alt="\Delta \phi \times \Delta \lambda"/> where the
-<img class="math" src="../_images/math/4a6bc0b33fc0ffe9fb5b688659922045cc2e2322.png" alt="\Delta \lambda"/> term’s actual dimension depends on
-<img class="math" src="../_images/math/26c030c66862238374569a6e9f30af876c0c99c8.png" alt="\cos (\phi)"/>, we need to allow for that shrinkage, normalize our
-sum to that of the whole area of the Earth, and finally convert that
-ratio to percent. Since the <img class="math" src="../_images/math/4a6bc0b33fc0ffe9fb5b688659922045cc2e2322.png" alt="\Delta \lambda"/>, <img class="math" src="../_images/math/f71cb1117d2cc55d5b606da6f24200896cbad58b.png" alt="\Delta \phi"/>
-terms appear twice in these expressions they cancel out, leaving the
-somewhat intractable expressions below where the sum of
-<img class="math" src="../_images/math/26c030c66862238374569a6e9f30af876c0c99c8.png" alt="\cos (\phi)"/> for all <img class="math" src="../_images/math/10e009bdb83f96c5f47c58b34d5d4b12ef268d5b.png" alt="\phi"/> is known to equal <img class="math" src="../_images/math/c5dd45762fff5ecd449ce021d8c9d79e7ce0228f.png" alt="2N_y / \pi"/>:</p>
-<p>In the end we obtain a funny-looking map depicting the antipodal
-distribution as well as displaying in legend form the requested
-percentages. Note that the script is
-set to evaluate a global 30 minute grid for expediency (<em>D = 30</em>),
-hence several smaller land masses that do have terrestrial antipodes do
-not show up. If you want a more accurate map you can set the parameter
-<em>D</em> to a smaller increment (try 5 and wait a few minutes).</p>
-<p>The call to <a class="reference internal" href="../grdimage.html"><em>grdimage</em></a> includes the
-<tt class="docutils literal"><span class="pre">-Sn</span></tt> to suspend interpolation and only return the value of the
-nearest neighbor. This option is particularly practical for plotting
-categorical data, like these, that should not be interpolated.</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 25</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Display distribution of antipode types</span>
-<span class="c"># GMT progs: gmtset, grdlandmask, grdmath, grd2xyz, gmtmath, grdimage, pscoast, pslegend</span>
-<span class="c"># Unix progs: cat</span>
-<span class="c">#</span>
-<span class="c"># Create D minutes global grid with -1 over oceans and +1 over land</span>
-<span class="nv">ps</span><span class="o">=</span>example_25.ps
-<span class="nv">D</span><span class="o">=</span>30
-gmt grdlandmask -Rg -I<span class="si">${</span><span class="nv">D</span><span class="si">}</span>m -Dc -A500 -N-1/1/1/1/1 -r -Gwetdry.nc
-<span class="c"># Manipulate so -1 means ocean/ocean antipode, +1 = land/land, and 0 elsewhere</span>
-gmt grdmath -fg wetdry.nc DUP <span class="m">180</span> ROTX FLIPUD ADD <span class="m">2</span> <span class="nv">DIV</span> <span class="o">=</span> key.nc
-<span class="c"># Calculate percentage area of each type of antipode match.</span>
-gmt grdmath -Rg -I<span class="si">${</span><span class="nv">D</span><span class="si">}</span>m -r Y COSD <span class="m">60</span> <span class="nv">$D</span> DIV <span class="m">360</span> MUL DUP MUL PI DIV DIV <span class="m">100</span> <span class="nv">MUL</span> <span class="o">=</span> scale.nc
-gmt grdmath -fg key.nc -1 EQ <span class="m">0</span> NAN scale.nc <span class="nv">MUL</span> <span class="o">=</span> tmp.nc
-gmt grd2xyz tmp.nc -s -ZTLf > key.b
-<span class="nv">ocean</span><span class="o">=</span><span class="sb">`</span>gmt gmtmath -bi1f -Ca -S key.b SUM UPPER <span class="nv">RINT</span> <span class="o">=</span><span class="sb">`</span>
-gmt grdmath -fg key.nc <span class="m">1</span> EQ <span class="m">0</span> NAN scale.nc <span class="nv">MUL</span> <span class="o">=</span> tmp.nc
-gmt grd2xyz tmp.nc -s -ZTLf > key.b
-<span class="nv">land</span><span class="o">=</span><span class="sb">`</span>gmt gmtmath -bi1f -Ca -S key.b SUM UPPER <span class="nv">RINT</span> <span class="o">=</span><span class="sb">`</span>
-gmt grdmath -fg key.nc <span class="m">0</span> EQ <span class="m">0</span> NAN scale.nc <span class="nv">MUL</span> <span class="o">=</span> tmp.nc
-gmt grd2xyz tmp.nc -s -ZTLf > key.b
-<span class="nv">mixed</span><span class="o">=</span><span class="sb">`</span>gmt gmtmath -bi1f -Ca -S key.b SUM UPPER <span class="nv">RINT</span> <span class="o">=</span><span class="sb">`</span>
-<span class="c"># Generate corresponding color table</span>
-cat <span class="s"><< END > key.cpt</span>
-<span class="s">-1.5 blue -0.5 blue</span>
-<span class="s">-0.5 gray 0.5 gray</span>
-<span class="s">0.5 red 1.5 red</span>
-<span class="s">END</span>
-<span class="c"># Create the final plot and overlay coastlines</span>
-gmt gmtset FONT_ANNOT_PRIMARY +10p FORMAT_GEO_MAP dddF
-gmt grdimage key.nc -JKs180/9i -Bx60 -By30 -BWsNE+t<span class="s2">"Antipodal comparisons"</span> -K -Ckey.cpt -Y1.2i -nn > <span class="nv">$ps</span>
-gmt pscoast -R -J -O -K -Wthinnest -Dc -A500 >> <span class="nv">$ps</span>
-<span class="c"># Place an explanatory legend below</span>
-gmt pslegend -R0/9/0/0.5 -Jx1i -O -Dx4.5i/0/6i/TC -Y-0.2i -F+pthick >> <span class="nv">$ps</span> <span class="s"><< END</span>
-<span class="s">N 3</span>
-<span class="s">S 0.15i s 0.2i red 0.25p 0.3i Terrestrial Antipodes [$land %]</span>
-<span class="s">S 0.15i s 0.2i blue 0.25p 0.3i Oceanic Antipodes [$ocean %]</span>
-<span class="s">S 0.15i s 0.2i gray 0.25p 0.3i Mixed Antipodes [$mixed %]</span>
-<span class="s">END</span>
-rm -f *.nc key.* gmt.conf
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_25.png"><img alt="../_images/example_25.png" src="../_images/example_25.png" style="width: 500px;" /></a>
-<p class="caption">Global distribution of antipodes.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex24.html"
- title="previous chapter">(24) Data selection based on geospatial criteria</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex26.html"
- title="next chapter">(26) General vertical perspective projection</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex25.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex26.html" title="(26) General vertical perspective projection"
- >next</a> </li>
- <li class="right" >
- <a href="ex24.html" title="(24) Data selection based on geospatial criteria"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex26.html b/doc_release/html/gallery/ex26.html
deleted file mode 100644
index 0516df0..0000000
--- a/doc_release/html/gallery/ex26.html
+++ /dev/null
@@ -1,200 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(26) General vertical perspective projection — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(27) Plotting Sandwell/Smith Mercator img grids" href="ex27.html" />
- <link rel="prev" title="(25) Global distribution of antipodes" href="ex25.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex27.html" title="(27) Plotting Sandwell/Smith Mercator img grids"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex25.html" title="(25) Global distribution of antipodes"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="general-vertical-perspective-projection">
-<span id="example-26"></span><h1>(26) General vertical perspective projection<a class="headerlink" href="#general-vertical-perspective-projection" title="Permalink to this headline">¶</a></h1>
-<p>Next, we present a recent extension to the <strong>-JG</strong> projection option
-which allows the user to specify a particular altitude (this was always
-at infinity before), as well as several further parameters to limit the
-view from the chosen vantage point. In this example we show a view of
-the eastern continental US from a height of 160 km. Below we add a view
-with a specific tilt of 55 and azimuth 210; here we have chosen a
-boresight twist of 45. We view the land from New York towards
-Washington, D.C.</p>
-<p>At this point the full projection has not been properly optimized and
-the map annotations will need additional work. Also, note that the
-projection is only implemented in
-<a class="reference internal" href="../pscoast.html"><em>pscoast</em></a> and
-<a class="reference internal" href="../grdimage.html"><em>grdimage</em></a>. We hope to refine this
-further and extend the availability of the full projection to all of the
-GMT mapping programs.</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 26</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Demonstrate general vertical perspective projection</span>
-<span class="c"># GMT progs: pscoast</span>
-<span class="c"># Unix progs: rm</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_26.ps
-
-<span class="c"># first do an overhead of the east coast from 160 km altitude point straight down</span>
-
-<span class="nv">latitude</span><span class="o">=</span>41.5
-<span class="nv">longitude</span><span class="o">=</span>-74.0
-<span class="nv">altitude</span><span class="o">=</span>160.0
-<span class="nv">tilt</span><span class="o">=</span>0
-<span class="nv">azimuth</span><span class="o">=</span>0
-<span class="nv">twist</span><span class="o">=</span>0
-<span class="nv">Width</span><span class="o">=</span>0.0
-<span class="nv">Height</span><span class="o">=</span>0.0
-
-<span class="nv">PROJ</span><span class="o">=</span>-JG<span class="si">${</span><span class="nv">longitude</span><span class="si">}</span>/<span class="si">${</span><span class="nv">latitude</span><span class="si">}</span>/<span class="si">${</span><span class="nv">altitude</span><span class="si">}</span>/<span class="si">${</span><span class="nv">azimuth</span><span class="si">}</span>/<span class="si">${</span><span class="nv">tilt</span><span class="si">}</span>/<span class="si">${</ [...]
-
-gmt pscoast -Rg <span class="nv">$PROJ</span> -X1i -B5g5 -Glightbrown -Slightblue -W -Dl -N1/1p,red -N2,0.5p -P -K <span class="se">\</span>
- -Y5i > <span class="nv">$ps</span>
-
-<span class="c"># now point from an altitude of 160 km with a specific tilt and azimuth and with a wider restricted</span>
-<span class="c"># view and a boresight twist of 45 degrees</span>
-
-<span class="nv">tilt</span><span class="o">=</span>55
-<span class="nv">azimuth</span><span class="o">=</span>210
-<span class="nv">twist</span><span class="o">=</span>45
-<span class="nv">Width</span><span class="o">=</span>30.0
-<span class="nv">Height</span><span class="o">=</span>30.0
-
-<span class="nv">PROJ</span><span class="o">=</span>-JG<span class="si">${</span><span class="nv">longitude</span><span class="si">}</span>/<span class="si">${</span><span class="nv">latitude</span><span class="si">}</span>/<span class="si">${</span><span class="nv">altitude</span><span class="si">}</span>/<span class="si">${</span><span class="nv">azimuth</span><span class="si">}</span>/<span class="si">${</span><span class="nv">tilt</span><span class="si">}</span>/<span class="si">${</ [...]
-
-gmt pscoast -R <span class="nv">$PROJ</span> -B5g5 -Glightbrown -Slightblue -W -Ia/blue -Di -Na -O -X1i -Y-4i >> <span class="nv">$ps</span>
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_26.png"><img alt="../_images/example_26.png" src="../_images/example_26.png" style="width: 500px;" /></a>
-<p class="caption">General vertical perspective projection.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex25.html"
- title="previous chapter">(25) Global distribution of antipodes</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex27.html"
- title="next chapter">(27) Plotting Sandwell/Smith Mercator img grids</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex26.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex27.html" title="(27) Plotting Sandwell/Smith Mercator img grids"
- >next</a> </li>
- <li class="right" >
- <a href="ex25.html" title="(25) Global distribution of antipodes"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex27.html b/doc_release/html/gallery/ex27.html
deleted file mode 100644
index 5f4fd1c..0000000
--- a/doc_release/html/gallery/ex27.html
+++ /dev/null
@@ -1,222 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(27) Plotting Sandwell/Smith Mercator img grids — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(28) Mixing UTM and geographic data sets" href="ex28.html" />
- <link rel="prev" title="(26) General vertical perspective projection" href="ex26.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex28.html" title="(28) Mixing UTM and geographic data sets"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex26.html" title="(26) General vertical perspective projection"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="plotting-sandwell-smith-mercator-img-grids">
-<span id="example-27"></span><h1>(27) Plotting Sandwell/Smith Mercator img grids<a class="headerlink" href="#plotting-sandwell-smith-mercator-img-grids" title="Permalink to this headline">¶</a></h1>
-<p>Next, we show how to plot a data grid that is distributed in projected
-form. The gravity and predicted bathymetry grids produced by David
-Sandwell and Walter H. F. Smith are not geographical grids but instead
-given on a spherical Mercator grid. The GMT supplement imgsrc has
-tools to extract subsets of these large grids. If you need to make a
-non-Mercator map then you must extract a geographic grid using
-<a class="reference internal" href="../supplements/img/img2grd.html"><em>img2grd</em></a> and then plot it using your
-desired map projection. However, if you want to make a Mercator map then
-you can save time and preserve data quality by avoiding to re-project
-the data set twice since it is already in a Mercator projection. This
-example shows how this is accomplished. We use the <strong>-M</strong> option in
-<a class="reference internal" href="../supplements/img/img2grd.html"><em>img2grd</em></a> <a class="footnote-reference" href="#id2" id="id1">[1]</a> to pull out the grid
-in Mercator units (i.e., do <em>not</em> invert the Mercator projection) and
-then simply plot the grid using a linear projection with a suitable
-scale (here 0.25 inches per degrees of longitude). To overlay basemaps
-and features that has geographic longitude/latitude coordinates we must
-remember two key issues:</p>
-<ol class="arabic simple">
-<li>This is a <em>spherical</em> Mercator grid so we must use
-–<strong>PROJ_ELLIPSOID</strong>=Sphere with all commands that involve
-projections (or use <a class="reference internal" href="../gmtset.html"><em>gmtset</em></a> to change the setting).</li>
-<li>Select Mercator projection and use the same scale that was used with
-the linear projection.</li>
-</ol>
-<p>This map of the Tasman Sea shows the marine gravity anomalies with land
-painted black. A color scale bar was then added to complete the illustration.</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 27</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Illustrates how to plot Mercator img grids</span>
-<span class="c"># GMT progs: makecpt, mapproject, grdgradient, grdimage, grdinfo, pscoast</span>
-<span class="c"># GMT supplement: img2grd (to read Sandwell/Smith img files)</span>
-<span class="c"># Unix progs: rm, grep, $AWK</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_27.ps
-
-<span class="c"># Gravity in tasman_grav.nc is in 0.1 mGal increments and the grid</span>
-<span class="c"># is already in projected Mercator x/y units.</span>
-<span class="c"># First get gradients.</span>
-
-gmt grdgradient tasman_grav.nc -Nt1 -A45 -Gtasman_grav_i.nc
-
-<span class="c"># Make a suitable cpt file for mGal</span>
-
-gmt makecpt -T-120/120/240 -Z -Crainbow > grav.cpt
-
-<span class="c"># Since this is a Mercator grid we use a linear projection</span>
-
-gmt grdimage tasman_grav.nc<span class="o">=</span>ns/0.1 -Itasman_grav_i.nc -Jx0.25i -Cgrav.cpt -P -K > <span class="nv">$ps</span>
-
-<span class="c"># Then use gmt pscoast to plot land; get original -R from grid remark</span>
-<span class="c"># and use Mercator gmt projection with same scale as above on a spherical Earth</span>
-
-<span class="nv">R</span><span class="o">=</span><span class="sb">`</span>gmt grdinfo tasman_grav.nc <span class="p">|</span> grep Remark <span class="p">|</span> <span class="nv">$AWK</span> <span class="s1">'{print $NF}'</span><span class="sb">`</span>
-
-gmt pscoast <span class="nv">$R</span> -Jm0.25i -Ba10f5 -BWSne -O -K -Gblack --PROJ_ELLIPSOID<span class="o">=</span>Sphere <span class="se">\</span>
- -Cwhite -Dh+ --FORMAT_GEO_MAP<span class="o">=</span>dddF >> <span class="nv">$ps</span>
-
-<span class="c"># Put a color legend on top of the land mask justified with 147E,31S</span>
-
-<span class="nv">pos</span><span class="o">=</span><span class="sb">`</span><span class="nb">echo </span>147E 31S <span class="p">|</span> gmt mapproject -R -J -Di --PROJ_ELLIPSOID<span class="o">=</span>Sphere <span class="p">|</span> <span class="se">\</span>
- <span class="nv">$AWK</span> <span class="s1">'{printf "%si/%si\n", $1, $2}'</span><span class="sb">`</span>
-gmt psscale -D<span class="nv">$pos</span>/2i/0.15i -Cgrav.cpt -Bx50f10 -By+lmGal -I -O -T+gwhite+p1p >> <span class="nv">$ps</span>
-
-<span class="c"># Clean up</span>
-
-rm -f grav.cpt *_i.nc
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_27.png"><img alt="../_images/example_27.png" src="../_images/example_27.png" style="width: 500px;" /></a>
-<p class="caption">Plotting Sandwell/Smith Mercator img grids.</p>
-</div>
-<table class="docutils footnote" frame="void" id="id2" rules="none">
-<colgroup><col class="label" /><col /></colgroup>
-<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id1">[1]</a></td><td>You could also use <a class="reference internal" href="../supplements/img/img2grd.html"><em>img2grd</em></a>
-directly - your only option under DOS</td></tr>
-</tbody>
-</table>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex26.html"
- title="previous chapter">(26) General vertical perspective projection</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex28.html"
- title="next chapter">(28) Mixing UTM and geographic data sets</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex27.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex28.html" title="(28) Mixing UTM and geographic data sets"
- >next</a> </li>
- <li class="right" >
- <a href="ex26.html" title="(26) General vertical perspective projection"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex28.html b/doc_release/html/gallery/ex28.html
deleted file mode 100644
index edf9e0f..0000000
--- a/doc_release/html/gallery/ex28.html
+++ /dev/null
@@ -1,195 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(28) Mixing UTM and geographic data sets — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(29) Gridding spherical surface data using splines" href="ex29.html" />
- <link rel="prev" title="(27) Plotting Sandwell/Smith Mercator img grids" href="ex27.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex29.html" title="(29) Gridding spherical surface data using splines"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex27.html" title="(27) Plotting Sandwell/Smith Mercator img grids"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="mixing-utm-and-geographic-data-sets">
-<span id="example-28"></span><h1>(28) Mixing UTM and geographic data sets<a class="headerlink" href="#mixing-utm-and-geographic-data-sets" title="Permalink to this headline">¶</a></h1>
-<p>Next, we present a similar case: We wish to plot a data set given in UTM
-coordinates (meter) and want it to be properly registered with overlying
-geographic data, such as coastlines or data points. The mistake many
-GMT rookies make is to specify the UTM projection with their UTM data.
-However, that data have already been projected and is now in linear
-meters. The only sensible way to plot such data is with a linear
-projection, yielding a UTM map. In this step one can choose to annotate
-or tick the map in UTM meters as well. To plot geographic (lon/lat) data
-on the same map you simply have to specify the region using the UTM
-meters but supply the actual UTM projection parameters. Make sure you
-use the same scale with both the linear and UTM projection.</p>
-<p>Our script illustrates how we would plot a UTM grid (with coordinates in
-meters) of elevations near Kilauea volcano on the Big Island of Hawaii
-and overlay geographical information (with longitude, latitude
-coordinates). We first lay down the UTM grid using the linear
-projection. Then, given we are in UTM zone 5Q, we use the UTM domain and
-the UTM projection when overlaying the coastline and light blue ocean.
-We do some trickery by converting the UTM domain to km so that we can
-add custom annotations to the map. Finally, we place a scale bar and
-label Kilauea crater to complete the figure.</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 28</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Illustrates how to mix UTM data and UTM gmt projection</span>
-<span class="c"># GMT progs: makecpt, grdgradient, grdimage, grdinfo, grdmath, pscoast, pstext, mapproject</span>
-<span class="c"># Unix progs: rm, echo</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_28.ps
-
-<span class="c"># Get intensity grid and set up a color table</span>
-gmt grdgradient Kilauea.utm.nc -Nt1 -A45 -GKilauea.utm_i.nc
-gmt makecpt -Ccopper -T0/1500/100 -Z > Kilauea.cpt
-<span class="c"># Lay down the UTM topo grid using a 1:16,000 scale</span>
-gmt grdimage Kilauea.utm.nc -IKilauea.utm_i.nc -CKilauea.cpt -Jx1:160000 -P -K <span class="se">\</span>
- --FORMAT_FLOAT_OUT<span class="o">=</span>%.10g --FONT_ANNOT_PRIMARY<span class="o">=</span>9p > <span class="nv">$ps</span>
-<span class="c"># Overlay geographic data and coregister by using correct region and gmt projection with the same scale</span>
-gmt pscoast -RKilauea.utm.nc -Ju5Q/1:160000 -O -K -Df+ -Slightblue -W0.5p -B5mg5m -BNE <span class="se">\</span>
- --FONT_ANNOT_PRIMARY<span class="o">=</span>12p --FORMAT_GEO_MAP<span class="o">=</span>ddd:mmF >> <span class="nv">$ps</span>
-<span class="nb">echo </span>155:16:20W 19:26:20N KILAUEA <span class="p">|</span> gmt pstext -R -J -O -K -F+f12p,Helvetica-Bold+jCB >> <span class="nv">$ps</span>
-gmt psbasemap -R -J -O -K --FONT_ANNOT_PRIMARY<span class="o">=</span>9p -Lf155:07:30W/19:15:40N/19:23N/5k+l1:16,000+u <span class="se">\</span>
- --FONT_LABEL<span class="o">=</span>10p >> <span class="nv">$ps</span>
-<span class="c"># Annotate in km but append ,000m to annotations to get customized meter labels</span>
-gmt psbasemap -RKilauea.utm.nc+Uk -Jx1:160 -B5g5+u<span class="s2">"@:8:000m"</span> -BWSne -O --FONT_ANNOT_PRIMARY<span class="o">=</span>10p <span class="se">\</span>
- --MAP_GRID_CROSS_SIZE_PRIMARY<span class="o">=</span>0.1i --FONT_LABEL<span class="o">=</span>10p >> <span class="nv">$ps</span>
-<span class="c"># Clean up</span>
-rm -f Kilauea.utm_i.nc Kilauea.cpt tmp.txt
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_28.png"><img alt="../_images/example_28.png" src="../_images/example_28.png" style="width: 500px;" /></a>
-<p class="caption">Mixing UTM and geographic data sets requires knowledge of the map region domain in
-both UTM and lon/lat coordinates and consistent use of the same map scale.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex27.html"
- title="previous chapter">(27) Plotting Sandwell/Smith Mercator img grids</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex29.html"
- title="next chapter">(29) Gridding spherical surface data using splines</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex28.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex29.html" title="(29) Gridding spherical surface data using splines"
- >next</a> </li>
- <li class="right" >
- <a href="ex27.html" title="(27) Plotting Sandwell/Smith Mercator img grids"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex29.html b/doc_release/html/gallery/ex29.html
deleted file mode 100644
index 66514d0..0000000
--- a/doc_release/html/gallery/ex29.html
+++ /dev/null
@@ -1,210 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(29) Gridding spherical surface data using splines — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(30) Trigonometric functions plotted in graph mode" href="ex30.html" />
- <link rel="prev" title="(28) Mixing UTM and geographic data sets" href="ex28.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex30.html" title="(30) Trigonometric functions plotted in graph mode"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex28.html" title="(28) Mixing UTM and geographic data sets"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gridding-spherical-surface-data-using-splines">
-<span id="example-29"></span><h1>(29) Gridding spherical surface data using splines<a class="headerlink" href="#gridding-spherical-surface-data-using-splines" title="Permalink to this headline">¶</a></h1>
-<p>Finally, we demonstrate how gridding on a spherical surface can be
-accomplished using Green’s functions of surface splines, with or without
-tension. Global gridding does not work particularly well in Cartesian
-coordinates hence the chosen approach. We use
-<a class="reference internal" href="../greenspline.html"><em>greenspline</em></a> to produce a crude
-topography grid for Mars based on radii estimates from the Mariner 9 and
-Viking Orbiter spacecrafts. This data comes from <em>Smith and Zuber</em>
-[Science, 1996] and is used here as a small (<em>N</em> = 370) data set we can
-use to demonstrate spherical surface gridding. Since
-<a class="reference internal" href="../greenspline.html"><em>greenspline</em></a> must solve a <em>N</em> by
-<em>N</em> matrix system your system memory may impose limits on how large data
-sets you can handle; also note that the spherical surface spline in
-tension is particularly slow to compute.</p>
-<p>Our script must first estimate the ellipsoidal shape of Mars from the
-parameters given by <em>Smith and Zuber</em> so that we can remove this
-reference surface from the gridded radii. We run the gridding twice:
-First with no tension using <em>Parker</em>‘s [1990] method and then with
-tension using the <em>Wessel and Becker</em> [2008] method. The grids are then
-imaged with <a class="reference internal" href="../grdimage.html"><em>grdimage</em></a> and
-<a class="reference internal" href="../grdcontour.html"><em>grdcontour</em></a> and a color scale is placed between them.</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 29</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Illustrates spherical surface gridding with Green's function of splines</span>
-<span class="c"># GMT progs: makecpt, grdcontour, grdgradient, grdimage, grdmath greenspline, psscale, pstext</span>
-<span class="c"># Unix progs: rm, echo</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_29.ps
-
-<span class="c"># This example uses 370 radio occultation data for Mars to grid the topography.</span>
-<span class="c"># Data and information from Smith, D. E., and M. T. Zuber (1996), The shape of</span>
-<span class="c"># Mars and the topographic signature of the hemispheric dichotomy, Science, 271, 184–187.</span>
-
-<span class="c"># Make Mars PROJ_ELLIPSOID given their three best-fitting axes:</span>
-<span class="nv">a</span><span class="o">=</span>3399.472
-<span class="nv">b</span><span class="o">=</span>3394.329
-<span class="nv">c</span><span class="o">=</span>3376.502
-gmt grdmath -Rg -I4 -r X COSD <span class="nv">$a</span> DIV DUP MUL X SIND <span class="nv">$b</span> DIV DUP MUL ADD Y COSD DUP MUL MUL Y <span class="se">\</span>
- SIND <span class="nv">$c</span> DIV DUP MUL ADD SQRT <span class="nv">INV</span> <span class="o">=</span> PROJ_ELLIPSOID.nc
-
-<span class="c"># Do both Parker and Wessel/Becker solutions (tension = 0.9975)</span>
-gmt greenspline -RPROJ_ELLIPSOID.nc mars370.in -D4 -Sp -Gmars.nc
-gmt greenspline -RPROJ_ELLIPSOID.nc mars370.in -D4 -Sq0.9975 -Gmars2.nc
-<span class="c"># Scale to km and remove PROJ_ELLIPSOID</span>
-gmt grdmath mars.nc <span class="m">1000</span> DIV PROJ_ELLIPSOID.nc <span class="nv">SUB</span> <span class="o">=</span> mars.nc
-gmt grdmath mars2.nc <span class="m">1000</span> DIV PROJ_ELLIPSOID.nc <span class="nv">SUB</span> <span class="o">=</span> mars2.nc
-gmt makecpt -Crainbow -T-7/15/22 -Z > mars.cpt
-gmt grdgradient mars2.nc -fg -Ne0.75 -A45 -Gmars2_i.nc
-gmt grdimage mars2.nc -Imars2_i.nc -Cmars.cpt -B30g30 -BWsne -JH0/7i -P -K -E200 <span class="se">\</span>
- --FONT_ANNOT_PRIMARY<span class="o">=</span>12p -X0.75i > <span class="nv">$ps</span>
-gmt grdcontour mars2.nc -J -O -K -C1 -A5 -Glz+/z- >> <span class="nv">$ps</span>
-gmt psxy -Rg -J -O -K -Sc0.045i -Gblack mars370.in >> <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"0 90 b)"</span> <span class="p">|</span> gmt pstext -R -J -O -K -N -D-3.5i/-0.2i -F+f14p,Helvetica-Bold+jLB >> <span class="nv">$ps</span>
-gmt grdgradient mars.nc -fg -Ne0.75 -A45 -Gmars_i.nc
-gmt grdimage mars.nc -Imars_i.nc -Cmars.cpt -B30g30 -BWsne -J -O -K -Y4.2i -E200 <span class="se">\</span>
- --FONT_ANNOT_PRIMARY<span class="o">=</span>12p >> <span class="nv">$ps</span>
-gmt grdcontour mars.nc -J -O -K -C1 -A5 -Glz+/z- >> <span class="nv">$ps</span>
-gmt psxy -Rg -J -O -K -Sc0.045i -Gblack mars370.in >> <span class="nv">$ps</span>
-gmt psscale -Cmars.cpt -O -K -D3.5i/-0.15i/6i/0.1ih -I --FONT_ANNOT_PRIMARY<span class="o">=</span>12p -Bx2f1 -By+lkm >> <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"0 90 a)"</span> <span class="p">|</span> gmt pstext -R -J -O -N -D-3.5i/-0.2i -F+f14p,Helvetica-Bold+jLB >> <span class="nv">$ps</span>
-<span class="c"># Clean up</span>
-rm -f *.nc mars.cpt
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_29.png"><img alt="../_images/example_29.png" src="../_images/example_29.png" style="width: 500px;" /></a>
-<p class="caption">Gridding of spherical surface data using Green’s function splines.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex28.html"
- title="previous chapter">(28) Mixing UTM and geographic data sets</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex30.html"
- title="next chapter">(30) Trigonometric functions plotted in graph mode</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex29.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex30.html" title="(30) Trigonometric functions plotted in graph mode"
- >next</a> </li>
- <li class="right" >
- <a href="ex28.html" title="(28) Mixing UTM and geographic data sets"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex30.html b/doc_release/html/gallery/ex30.html
deleted file mode 100644
index adb4025..0000000
--- a/doc_release/html/gallery/ex30.html
+++ /dev/null
@@ -1,219 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(30) Trigonometric functions plotted in graph mode — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(31) Using non-default fonts in PostScript" href="ex31.html" />
- <link rel="prev" title="(29) Gridding spherical surface data using splines" href="ex29.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex31.html" title="(31) Using non-default fonts in PostScript"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex29.html" title="(29) Gridding spherical surface data using splines"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="trigonometric-functions-plotted-in-graph-mode">
-<span id="example-30"></span><h1>(30) Trigonometric functions plotted in graph mode<a class="headerlink" href="#trigonometric-functions-plotted-in-graph-mode" title="Permalink to this headline">¶</a></h1>
-<p>Finally, we end with a simple mathematical illustration of sine and
-cosine, highlighting the <em>graph</em> mode for linear projections and the new
-curved vectors for angles.</p>
-<p>The script simply draws a graph basemap, computes sine and cosine and
-plots them as lines, then indicates on a circle that these quantities
-are simply the projections of an unit vector on the x- and y-axis, at
-the given angle.</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 30</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Show graph mode and math angles</span>
-<span class="c"># GMT progs: gmtmath, psbasemap, pstext and psxy</span>
-<span class="c"># Unix progs: echo, rm</span>
-<span class="c">#</span>
-<span class="c"># Draw generic x-y axes with arrows</span>
-<span class="nv">ps</span><span class="o">=</span>example_30.ps
-
-gmt psbasemap -R0/360/-1.25/1.75 -JX8i/6i -Bx90f30+u<span class="s2">"\\312"</span> -By1g10 -BWS+t<span class="s2">"Two Trigonometric Functions"</span> <span class="se">\</span>
- -K --MAP_FRAME_TYPE<span class="o">=</span>graph --MAP_VECTOR_SHAPE<span class="o">=</span>0.5 > <span class="nv">$ps</span>
-
-<span class="c"># Draw sine an cosine curves</span>
-
-gmt gmtmath -T0/360/0.1 T <span class="nv">COSD</span> <span class="o">=</span> <span class="p">|</span> gmt psxy -R -J -O -K -W3p >> <span class="nv">$ps</span>
-gmt gmtmath -T0/360/0.1 T <span class="nv">SIND</span> <span class="o">=</span> <span class="p">|</span> gmt psxy -R -J -O -K -W3p,0_6:0 --PS_LINE_CAP<span class="o">=</span>round >> <span class="nv">$ps</span>
-
-<span class="c"># Indicate the x-angle = 120 degrees</span>
-gmt psxy -R -J -O -K -W0.5p,- <span class="s"><< EOF >> $ps</span>
-<span class="s">120 -1.25</span>
-<span class="s">120 1.25</span>
-<span class="s">EOF</span>
-
-gmt pstext -R -J -O -K -Dj0.2c -N -F+f+j <span class="s"><< EOF >> $ps</span>
-<span class="s">360 1 18p,Times-Roman RB x = cos(@%12%a@%%)</span>
-<span class="s">360 0 18p,Times-Roman RB y = sin(@%12%a@%%)</span>
-<span class="s">120 -1.25 14p,Times-Roman LB 120\\312</span>
-<span class="s">370 -1.35 24p,Symbol LT a</span>
-<span class="s">-5 1.85 24p,Times-Roman RT x,y</span>
-<span class="s">EOF</span>
-
-<span class="c"># Draw a circle and indicate the 0-70 degree angle</span>
-
-<span class="nb">echo </span><span class="m">0</span> <span class="m">0</span> <span class="p">|</span> gmt psxy -R-1/1/-1/1 -Jx1.5i -O -K -X3.625i -Y2.75i -Sc2i -W1p -N >> <span class="nv">$ps</span>
-gmt psxy -R -J -O -K -W1p <span class="s"><< EOF >> $ps</span>
-<span class="s">> x-gridline -Wdefault</span>
-<span class="s">-1 0</span>
-<span class="s">1 0</span>
-<span class="s">> y-gridline -Wdefault</span>
-<span class="s">0 -1</span>
-<span class="s">0 1</span>
-<span class="s">> angle = 0</span>
-<span class="s">0 0</span>
-<span class="s">1 0</span>
-<span class="s">> angle = 120</span>
-<span class="s">0 0</span>
-<span class="s">-0.5 0.866025</span>
-<span class="s">> x-gmt projection -W2p</span>
-<span class="s">-0.3333 0</span>
-<span class="s">0 0</span>
-<span class="s">> y-gmt projection -W2p</span>
-<span class="s">-0.3333 0.57735</span>
-<span class="s">-0.3333 0</span>
-<span class="s">EOF</span>
-
-gmt pstext -R -J -O -K -Dj0.05i -F+f+a+j <span class="s"><< EOF >> $ps</span>
-<span class="s">-0.16666 0 12p,Times-Roman 0 CT x</span>
-<span class="s">-0.3333 0.2888675 12p,Times-Roman 0 RM y</span>
-<span class="s">0.22 0.27 12p,Symbol -30 CB a</span>
-<span class="s">-0.33333 0.6 12p,Times-Roman 30 LB 120\\312</span>
-<span class="s">EOF</span>
-
-<span class="nb">echo </span><span class="m">0</span> <span class="m">0</span> 0.5i <span class="m">0</span> <span class="m">120</span> <span class="p">|</span> gmt psxy -R -J -O -Sm0.15i+e -W1p -Gblack >> <span class="nv">$ps</span>
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_30.png"><img alt="../_images/example_30.png" src="../_images/example_30.png" style="width: 500px;" /></a>
-<p class="caption">Trigonometric functions plotted in graph mode.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex29.html"
- title="previous chapter">(29) Gridding spherical surface data using splines</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex31.html"
- title="next chapter">(31) Using non-default fonts in PostScript</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex30.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex31.html" title="(31) Using non-default fonts in PostScript"
- >next</a> </li>
- <li class="right" >
- <a href="ex29.html" title="(29) Gridding spherical surface data using splines"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex31.html b/doc_release/html/gallery/ex31.html
deleted file mode 100644
index 6ce870a..0000000
--- a/doc_release/html/gallery/ex31.html
+++ /dev/null
@@ -1,270 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(31) Using non-default fonts in PostScript — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(32) Draping an image over topography" href="ex32.html" />
- <link rel="prev" title="(30) Trigonometric functions plotted in graph mode" href="ex30.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex32.html" title="(32) Draping an image over topography"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex30.html" title="(30) Trigonometric functions plotted in graph mode"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="using-non-default-fonts-in-postscript">
-<span id="example-31"></span><h1>(31) Using non-default fonts in PostScript<a class="headerlink" href="#using-non-default-fonts-in-postscript" title="Permalink to this headline">¶</a></h1>
-<p>This example illustrates several possibilities to create GMT plots
-with non-default fonts. As these fonts are not part of the standard
-PostScript font collection they have to be embedded in the PS- or
-PDF-file with Ghostscript. See also
-Appendix [sec:non-default-fonts] for further information. The script
-includes the following steps:</p>
-<ul class="simple">
-<li>create a <tt class="docutils literal"><span class="pre">CUSTOM_font_info.d</span></tt> file;</li>
-<li>set the GMT parameters <tt class="docutils literal"><span class="pre">MAP_DEGREE_SYMBOL</span></tt>, <tt class="docutils literal"><span class="pre">PS_CHAR_ENCODING</span></tt>, and <tt class="docutils literal"><span class="pre">FONT</span></tt>;</li>
-<li>replace the default Helvetica font in the GMT-PostScript-File with sed;</li>
-<li>create a PostScript-File with outlined fonts (optional);</li>
-<li>convert GMT’s PostScript output to PDF or any image format (optional).</li>
-</ul>
-<p>The script produces the plot in Figure. All
-standard fonts have been substituted by the free OpenType fonts Linux
-Libertine (title) and Linux Biolinum (annotations). Uncomment the
-appropriate lines in the script to make a PostScript-file with
-outlined fonts or to convert to a PDF-file.</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 31</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Illustrate usage of non-default fonts in PostScript</span>
-<span class="c"># GMT progs: gmtset, pscoast, psxy, pstext, pslegend</span>
-<span class="c"># Unix progs: gs, awk, cat, rm</span>
-<span class="c">#</span>
-<span class="nv">file</span><span class="o">=</span>example_31
-<span class="nv">ps</span><span class="o">=</span><span class="si">${</span><span class="nv">file</span><span class="si">}</span>.ps
-<span class="nv">ps_outlined</span><span class="o">=</span><span class="si">${</span><span class="nv">file</span><span class="si">}</span>_outlined.ps
-<span class="nv">eps_outlined</span><span class="o">=</span><span class="si">${</span><span class="nv">file</span><span class="si">}</span>_outlined.eps
-
-<span class="c"># create file CUSTOM_font_info.d in current working directory</span>
-<span class="c"># and add PostScript font names of Linux Biolinum and Libertine</span>
-<span class="nv">$AWK</span> <span class="s1">'{print $1, 0.700, 0}'</span> <span class="s"><< EOF > CUSTOM_font_info.d</span>
-<span class="s">LinBiolinumO</span>
-<span class="s">LinBiolinumOI</span>
-<span class="s">LinBiolinumOB</span>
-<span class="s">LinLibertineOB</span>
-<span class="s">EOF</span>
-
-<span class="c"># common settings</span>
-gmt gmtset FORMAT_GEO_MAP ddd:mm:ssF <span class="se">\</span>
-MAP_DEGREE_SYMBOL colon <span class="se">\</span>
-MAP_TITLE_OFFSET 20p <span class="se">\</span>
-MAP_GRID_CROSS_SIZE_PRIMARY 0.4c <span class="se">\</span>
-PS_LINE_JOIN round <span class="se">\</span>
-PS_CHAR_ENCODING ISO-8859-5 <span class="se">\</span>
-FONT LinBiolinumO <span class="se">\</span>
-FONT_TITLE 24p,LinLibertineOB <span class="se">\</span>
-MAP_ANNOT_OBLIQUE 42
-
-<span class="c"># map of countries</span>
-gmt pscoast -Dl -R-7/31/64/66/r -JL15/50/40/60/16c -P <span class="se">\</span>
- -Bx10g10 -By5g5 -B+t<span class="s2">"Europe\072 Countries and Capital Cities"</span> -A250 <span class="se">\</span>
- -Slightblue -Glightgreen -W0.25p -N1/1p,white -K > <span class="nv">$ps</span>
-
-<span class="c"># mark capitals</span>
-gmt psxy europe-capitals-ru.csv -R -J -i0,1 <span class="se">\</span>
--Sc0.15c -G196/80/80 -O -K >> <span class="nv">$ps</span>
-
-<span class="c"># small EU cities</span>
-<span class="nv">$AWK</span> <span class="s1">'BEGIN {FS=","} $4 !="" && $4 <= 1000000 {print $1, $2}'</span> europe-capitals-ru.csv <span class="p">|</span> <span class="se">\</span>
-gmt psxy -R -J -Sc0.15c -W0.25p -O -K >> <span class="nv">$ps</span>
-
-<span class="c"># big EU cities</span>
-<span class="nv">$AWK</span> <span class="s1">'BEGIN {FS=","} $4 > 1000000 {print $1, $2}'</span> europe-capitals-ru.csv <span class="p">|</span> <span class="se">\</span>
-gmt psxy -R -J -Sc0.15c -W1.25p -O -K >> <span class="nv">$ps</span>
-
-<span class="c"># label big EU cities</span>
-<span class="nv">$AWK</span> <span class="s1">'BEGIN {FS=","} $4 > 1000000 {print $1, $2, $3}'</span> europe-capitals-ru.csv <span class="p">|</span> <span class="se">\</span>
-gmt pstext -R -J -F+f7p,LinBiolinumOI+jBL -Dj0.1c -Gwhite -C5% -Qu -TO -O -K >> <span class="nv">$ps</span>
-
-<span class="c"># construct legend</span>
-cat <span class="s"><< EOF > legend.txt</span>
-<span class="s">G -0.1c</span>
-<span class="s">H 10 LinBiolinumOB Population of the European Union capital cities</span>
-<span class="s">G 0.15c</span>
-<span class="s">N 2</span>
-<span class="s">S 0.15c c 0.15c 196/80/80 0.25p 0.5c < 1 Million inhabitants</span>
-<span class="s">S 0.15c c 0.15c 196/80/80 1.25p 0.5c > 1 Million inhabitants</span>
-<span class="s">N 1</span>
-<span class="s">G 0.15c</span>
-<span class="s">L 8 LinBiolinumOB L Population in Millions </span>
-<span class="s">N 6</span>
-<span class="s">EOF</span>
-
-<span class="c"># append city names and population to legend</span>
-<span class="nv">$AWK</span> <span class="s1">'BEGIN {FS=","; f="L 8 LinBiolinumO L"}</span>
-<span class="s1"> $4 > 1000000 {printf "%s %s:\n%s %.2f\n", f, $3, f, $4/1e6}'</span> <span class="se">\</span>
- europe-capitals-ru.csv >> legend.txt
-
-<span class="c"># reduce annotation font size for legend</span>
-gmt gmtset FONT_ANNOT_PRIMARY 8p
-
-<span class="c"># plot legend</span>
-gmt pslegend -R -J -Dx7.9c/12.6c/8.0c/BL <span class="se">\</span>
--C0.3c/0.4c -L1.2 -F+p+gwhite -O legend.txt >> <span class="nv">$ps</span>
-
-<span class="c"># make a PostScript and a PDF file with outlined fonts</span>
-<span class="c"># unfortunately gmt ps2raster won't be able to crop that file correctly anymore</span>
-<span class="c"># use Heiko Oberdiek's pdfcrop (http://code.google.com/p/pdfcrop2/) instead</span>
-<span class="c"># or crop with gmt ps2raster -A -Te before</span>
-<span class="c">#</span>
-<span class="c"># a. remove GMT logo and crop EPS:</span>
-<span class="c">#gmt ps2raster -P -Au -Te -C-sFONTPATH="${PWD}/fonts" -Fex31CropNoLogo $ps</span>
-<span class="c"># b. make PS with outlined fonts:</span>
-<span class="c">#gs -q -sPAPERSIZE=a3 -dNOCACHE -dSAFER -dNOPAUSE -dBATCH -dNOPLATFONTS \</span>
-<span class="c"># -sDEVICE=pswrite -sFONTPATH="${PWD}/fonts" -sOutputFile=$ps_outlined ex31CropNoLogo.eps</span>
-<span class="c"># c. make croppepd EPS:</span>
-<span class="c">#gs -q -dNOCACHE -dSAFER -dNOPAUSE -dBATCH -dEPSCrop -sDEVICE=epswrite \</span>
-<span class="c"># -sOutputFile=$eps_outlined $ps_outlined</span>
-<span class="c"># d. make cropped PDF:</span>
-<span class="c">#gmt ps2raster -P -A -Tf $ps_outlined</span>
-<span class="c"># uncomment to do conversation to PDF and PNG</span>
-<span class="c"># you will get a PDF with subsetted TrueType/PostScript fonts embedded</span>
-<span class="c"># which you can still edit with your favorite vector graphics editor</span>
-<span class="c">#export GS_FONTPATH="${PWD}/fonts"</span>
-<span class="c">#gmt ps2raster -P -A -Tf $ps</span>
-<span class="c">#gmt ps2raster -P -A -Tg -E110 $ps</span>
-<span class="c"># clean up</span>
-rm -f gmt.history gmt.conf CUSTOM_font_info.d legend.txt ex31CropNoLogo.eps
-
-<span class="nb">exit </span>0
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_31.png"><img alt="../_images/example_31.png" src="../_images/example_31.png" style="width: 500px;" /></a>
-<p class="caption">Using non-default fonts in PostScript.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex30.html"
- title="previous chapter">(30) Trigonometric functions plotted in graph mode</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex32.html"
- title="next chapter">(32) Draping an image over topography</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex31.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex32.html" title="(32) Draping an image over topography"
- >next</a> </li>
- <li class="right" >
- <a href="ex30.html" title="(30) Trigonometric functions plotted in graph mode"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex32.html b/doc_release/html/gallery/ex32.html
deleted file mode 100644
index 373fbce..0000000
--- a/doc_release/html/gallery/ex32.html
+++ /dev/null
@@ -1,248 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(32) Draping an image over topography — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(33) Stacking automatically generated cross-profiles" href="ex33.html" />
- <link rel="prev" title="(31) Using non-default fonts in PostScript" href="ex31.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex33.html" title="(33) Stacking automatically generated cross-profiles"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex31.html" title="(31) Using non-default fonts in PostScript"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="draping-an-image-over-topography">
-<span id="example-32"></span><h1>(32) Draping an image over topography<a class="headerlink" href="#draping-an-image-over-topography" title="Permalink to this headline">¶</a></h1>
-<p>In some cases, it is nice to “drape” an arbitrary image over a
-topographic map. We have already seen how to use
-<a class="reference internal" href="../psimage.html"><em>psimage</em></a> to plot an image anywhere in
-out plot. But here are aim is different, we want to manipulate an image
-to shade it and plot it in 3-D over topography. This example was
-originally created by Stephan Eickschen for a flyer emphasizing the
-historical economical and cultural bond between Brussels, Maastricht and
-Bonn. Obviously, the flag of the European Union came to mind as a good
-“background”.</p>
-<p>To avoid adding large files to this example, some steps have been
-already done. First we get the EU flag directly from the web and convert
-it to a grid with values ranging from 0 to 255, where the higher values
-will become yellow and the lower values blue. This use of
-<a class="reference internal" href="../grdreformat.html"><em>grdreformat</em></a> requires GDAL support.
-<a class="reference internal" href="../grdedit.html"><em>grdedit</em></a> then adds the right grid dimension.</p>
-<p>The second step is to reformat the GTOPO30 DEM file to a netCDF grid as
-well and then subsample it at the same pixels as the EU flag. We then
-illuminate the topography grid so we can use it later to emphasize the
-topography. The colors that we will use are those of the proper flag.
-Lower values will become blue and the upper values yellow.</p>
-<p>The call the <a class="reference internal" href="../grdview.html"><em>grdview</em></a> plots a
-topography map of northwest continental Europe, with the flagged draped
-over it and with shading to show the little topography there is.
-<a class="reference internal" href="../pscoast.html"><em>pscoast</em></a> is used in conjunction with
-<a class="reference internal" href="../grdtrack.html"><em>grdtrack</em></a> and <a class="reference internal" href="../psxyz.html"><em>psxyz</em></a> to plot
-borders “at altitude”. Something similar is done at the end to plot some
-symbols and names for cities.</p>
-<p>The script produces the plot in Figure [fig:example<sub>3</sub>2]. Note
-that the PNG image of the flag can be downloaded directly in the call
-the <a class="reference internal" href="../grdreformat.html"><em>grdreformat</em></a>, but we have
-commented that out in the example because it requires compilation with
-GDAL support. You will also see the
-<a class="reference internal" href="../grdcut.html"><em>grdcut</em></a> command commented out because we
-did not want to store the 58 MB DEM file, whose location is mentioned in the script.</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 32</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Illustrate draping of an image over topography</span>
-<span class="c"># GMT progs: grdcut, grdedit, grdgradient, grdreformat, grdtrack, grdview</span>
-<span class="c"># GMT progs: pscoast, pstext, psxyz</span>
-<span class="c"># Unix progs: cat, rm</span>
-<span class="c"># Credits: Original by Stephan Eickschen</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_32.ps
-
-<span class="c"># Here we get and convert the flag of Europe directly from the web through grdreformat using</span>
-<span class="c"># GDAL support. We take into account the dimension of the flag (1000x667 pixels)</span>
-<span class="c"># for a ratio of 3x2.</span>
-<span class="c"># Because GDAL support will not be standard for most users, we have stored</span>
-<span class="c"># the result, euflag.nc in this directory.</span>
-
-<span class="nv">Rflag</span><span class="o">=</span>-R3/9/50/54
-<span class="c"># gmt grdreformat \</span>
-<span class="c"># http://upload.wikimedia.org/wikipedia/commons/thumb/b/b7/Flag_of_Europe.svg/1000px-Flag_of_Europe.svg.png=gd \</span>
-<span class="c"># euflag.nc=ns</span>
-<span class="c"># gmt grdedit euflag.nc -fg $Rflag</span>
-
-<span class="c"># Now get the topography for the same area from GTOPO30 and store it as topo.nc.</span>
-<span class="c"># The DEM file comes from http://eros.usgs.gov/#/Find_Data/Products_and_Data_Available/gtopo30/w020n90</span>
-<span class="c"># We make an gradient grid as well, which we will use to "illuminate" the flag.</span>
-
-<span class="c"># gmt grdcut W020N90.DEM $Rflag -Gtopo.nc=ns</span>
-gmt grdgradient topo.nc -A0/270 -Gillum.nc -Ne0.6
-
-<span class="c"># The color map assigns "Reflex Blue" to the lower half of the 0-255 range and</span>
-<span class="c"># "Yellow" to the upper half.</span>
-cat <span class="s"><< EOF > euflag.cpt</span>
-<span class="s">0 0/51/153 127 0/51/153</span>
-<span class="s">127 255/204/0 255 255/204/0</span>
-<span class="s">EOF</span>
-
-<span class="c"># The next step is the plotting of the image.</span>
-<span class="c"># We use gmt grdview to plot the topography, euflag.nc to give the color, and illum.nc to give</span>
-<span class="c"># the shading.</span>
-
-<span class="nv">Rplot</span><span class="o">=</span><span class="nv">$Rflag</span>/-10/790
-gmt grdview topo.nc -JM13c <span class="nv">$Rplot</span> -Ceuflag.cpt -Geuflag.nc -Iillum.nc -Qc -JZ1c -p157.5/30 -P -K > <span class="nv">$ps</span>
-
-<span class="c"># We now add borders. Because we have a 3-D plot, we want them to be plotted "at elevation".</span>
-<span class="c"># So we write out the borders, pipe them through grdtack and then plot them with psxyz.</span>
-
-gmt pscoast <span class="nv">$Rflag</span> -Df -M -N1 <span class="p">|</span> gmt grdtrack -Gtopo.nc -sa <span class="p">|</span> gmt psxyz <span class="nv">$Rplot</span> -J -JZ -p -W1p,white <span class="se">\</span>
- -O -K >> <span class="nv">$ps</span>
-
-<span class="c"># Finally, we add dots and names for three cities.</span>
-<span class="c"># Again, gmt grdtrack is used to put the dots "at elevation".</span>
-
-cat <span class="s"><< EOF > cities.txt</span>
-<span class="s">05:41:27 50:51:05 Maastricht</span>
-<span class="s">04:21:00 50:51:00 Bruxelles</span>
-<span class="s">07:07:03 50:43:09 Bonn</span>
-<span class="s">EOF</span>
-
-gmt grdtrack -Gtopo.nc -sa cities.txt <span class="p">|</span> gmt psxyz -i0,1,3 <span class="nv">$Rplot</span> -J -JZ -p -Sc7p -W1p,white -Gred <span class="se">\</span>
- -K -O >> <span class="nv">$ps</span>
-gmt pstext <span class="nv">$Rplot</span> -J -JZ -p -F+f12p,Helvetica-Bold,red+jRM -Dj0.1i/0.0i -O cities.txt >> <span class="nv">$ps</span>
-
-<span class="c"># cleanup</span>
-
-rm -f gmt.conf euflag.cpt illum.nc cities.txt
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_32.png"><img alt="../_images/example_32.png" src="../_images/example_32.png" style="width: 500px;" /></a>
-<p class="caption">Draping an image over topography.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex31.html"
- title="previous chapter">(31) Using non-default fonts in PostScript</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex33.html"
- title="next chapter">(33) Stacking automatically generated cross-profiles</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex32.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex33.html" title="(33) Stacking automatically generated cross-profiles"
- >next</a> </li>
- <li class="right" >
- <a href="ex31.html" title="(31) Using non-default fonts in PostScript"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex33.html b/doc_release/html/gallery/ex33.html
deleted file mode 100644
index bf0486b..0000000
--- a/doc_release/html/gallery/ex33.html
+++ /dev/null
@@ -1,193 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(33) Stacking automatically generated cross-profiles — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(34) Using country polygons for plotting and shading" href="ex34.html" />
- <link rel="prev" title="(32) Draping an image over topography" href="ex32.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex34.html" title="(34) Using country polygons for plotting and shading"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex32.html" title="(32) Draping an image over topography"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="stacking-automatically-generated-cross-profiles">
-<span id="example-33"></span><h1>(33) Stacking automatically generated cross-profiles<a class="headerlink" href="#stacking-automatically-generated-cross-profiles" title="Permalink to this headline">¶</a></h1>
-<p>The script produces the plot in Figure. Here
-we demonstrate how <a class="reference internal" href="../grdtrack.html"><em>grdtrack</em></a> can be
-used to automatically create a suite of crossing profiles of uniform
-spacing and length and then sample one or more grids along these
-profiles; we also use the median stacking option to create a stacked
-profile, showed above the map, with the gray area representing the
-variations about the stacked median profile.</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 33</span>
-<span class="c"># $Id $</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Illustrate grdtrack's new cross-track and stacking options</span>
-<span class="c"># GMT progs: makecpt, gmtconvert, grdimage, grdgradient, grdtrack, pstext, psxy</span>
-<span class="c"># GMT progs: pscoast, pstext</span>
-<span class="c"># Unix progs: cat, rm</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_33.ps
-
-<span class="c"># Extract a subset of ETOPO1m for the East Pacific Rise</span>
-<span class="c"># gmt grdcut etopo1m_grd.nc -R118W/107W/49S/42S -Gspac.nc</span>
-gmt makecpt -Crainbow -T-5000/-2000/500 -Z > z.cpt
-gmt grdgradient spac.nc -A15 -Ne0.75 -Gspac_int.nc
-gmt grdimage spac.nc -Ispac_int.nc -Cz.cpt -JM6i -P -Baf -K -Xc --FORMAT_GEO_MAP<span class="o">=</span>dddF > <span class="nv">$ps</span>
-<span class="c"># Select two points along the ridge</span>
-cat <span class="s"><< EOF > ridge.txt</span>
-<span class="s">-111.6 -43.0</span>
-<span class="s">-113.3 -47.5</span>
-<span class="s">EOF</span>
-<span class="c"># Plot ridge segment and end points</span>
-gmt psxy -Rspac.nc -J -O -K -W2p,blue ridge.txt >> <span class="nv">$ps</span>
-gmt psxy -R -J -O -K -Sc0.1i -Gblue ridge.txt >> <span class="nv">$ps</span>
-<span class="c"># Generate cross-profiles 400 km long, spaced 10 km, samped every 2km</span>
-<span class="c"># and stack these using the median, write stacked profile</span>
-gmt grdtrack ridge.txt -Gspac.nc -C400k/2k/10k -Sm+sstack.txt > table.txt
-gmt psxy -R -J -O -K -W0.5p table.txt >> <span class="nv">$ps</span>
-<span class="c"># Show upper/lower values encountered as an envelope</span>
-gmt gmtconvert stack.txt -o0,5 > env.txt
-gmt gmtconvert stack.txt -o0,6 -I -T >> env.txt
-gmt psxy -R-200/200/-3500/-2000 -Bxafg1000+l<span class="s2">"Distance from ridge (km)"</span> -Byaf+l<span class="s2">"Depth (m)"</span> -BWSne <span class="se">\</span>
- -JX6i/3i -O -K -Glightgray env.txt -Y6.5i >> <span class="nv">$ps</span>
-gmt psxy -R -J -O -K -W3p stack.txt >> <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"0 -2000 MEDIAN STACKED PROFILE"</span> <span class="p">|</span> gmt pstext -R -J -O -K -Gwhite -F+jTC+f14p -Dj0.1i >> <span class="nv">$ps</span>
-gmt psxy -R -J -O -T >> <span class="nv">$ps</span>
-<span class="c"># cleanup</span>
-rm -f gmt.conf z.cpt spac_int.nc ridge.txt table.txt env.txt stack.txt
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_33.png"><img alt="../_images/example_33.png" src="../_images/example_33.png" style="width: 500px;" /></a>
-<p class="caption">Stacking automatically generated cross-profiles.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex32.html"
- title="previous chapter">(32) Draping an image over topography</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex34.html"
- title="next chapter">(34) Using country polygons for plotting and shading</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex33.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex34.html" title="(34) Using country polygons for plotting and shading"
- >next</a> </li>
- <li class="right" >
- <a href="ex32.html" title="(32) Draping an image over topography"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex34.html b/doc_release/html/gallery/ex34.html
deleted file mode 100644
index 0f58082..0000000
--- a/doc_release/html/gallery/ex34.html
+++ /dev/null
@@ -1,174 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(34) Using country polygons for plotting and shading — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(35) Spherical triangulation and distance calculations" href="ex35.html" />
- <link rel="prev" title="(33) Stacking automatically generated cross-profiles" href="ex33.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex35.html" title="(35) Spherical triangulation and distance calculations"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex33.html" title="(33) Stacking automatically generated cross-profiles"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="using-country-polygons-for-plotting-and-shading">
-<span id="example-34"></span><h1>(34) Using country polygons for plotting and shading<a class="headerlink" href="#using-country-polygons-for-plotting-and-shading" title="Permalink to this headline">¶</a></h1>
-<p>The script produces the plot in Figure. Here
-we demonstrate how <a class="reference internal" href="../pscoast.html"><em>pscoast</em></a> can be used to extract
-and plot country polygons. We show two panels; one in which we do
-a basic basemap and another where we lay down a color topography
-image and then place a transparent layer identifying the future
-Franco-Italian Union whose untimely breakup in 2045 the historians
-will continue to debate for some time.</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 34</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Illustrate pscoast with DCW country polygons</span>
-<span class="c"># GMT progs: pscoast, makecpt, grdimage, grdgradient</span>
-<span class="c"># Unix progs: rm</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_34.ps
-gmt gmtset FORMAT_GEO_MAP dddF
-gmt pscoast -JM4.5i -R-6/20/35/52 -FFR,IT+gP300/8 -Glightgray -Baf -BWSne -P -K -X2i > <span class="nv">$ps</span>
-<span class="c"># Extract a subset of ETOPO2m for this part of Europe</span>
-<span class="c"># gmt grdcut etopo2m_grd.nc -R -GFR+IT.nc=ns</span>
-gmt makecpt -Cglobe -T-5000/5000/500 -Z > z.cpt
-gmt grdgradient FR+IT.nc -A15 -Ne0.75 -GFR+IT_int.nc
-gmt grdimage FR+IT.nc -IFR+IT_int.nc -Cz.cpt -J -O -K -Y4.5i <span class="se">\</span>
- -Baf -BWsnE+t<span class="s2">"Franco-Italian Union, 2042-45"</span> >> <span class="nv">$ps</span>
-gmt pscoast -J -R -FFR,IT+gred at 60 -O >> <span class="nv">$ps</span>
-<span class="c"># cleanup</span>
-rm -f gmt.conf FR+IT_int.nc z.cpt
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_34.png"><img alt="../_images/example_34.png" src="../_images/example_34.png" style="width: 500px;" /></a>
-<p class="caption">Using country polygons for plotting and shading.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex33.html"
- title="previous chapter">(33) Stacking automatically generated cross-profiles</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex35.html"
- title="next chapter">(35) Spherical triangulation and distance calculations</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex34.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex35.html" title="(35) Spherical triangulation and distance calculations"
- >next</a> </li>
- <li class="right" >
- <a href="ex33.html" title="(33) Stacking automatically generated cross-profiles"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex35.html b/doc_release/html/gallery/ex35.html
deleted file mode 100644
index a1487b8..0000000
--- a/doc_release/html/gallery/ex35.html
+++ /dev/null
@@ -1,179 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(35) Spherical triangulation and distance calculations — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(36) Spherical gridding using Renka’s algorithms" href="ex36.html" />
- <link rel="prev" title="(34) Using country polygons for plotting and shading" href="ex34.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex36.html" title="(36) Spherical gridding using Renka’s algorithms"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex34.html" title="(34) Using country polygons for plotting and shading"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="spherical-triangulation-and-distance-calculations">
-<span id="example-35"></span><h1>(35) Spherical triangulation and distance calculations<a class="headerlink" href="#spherical-triangulation-and-distance-calculations" title="Permalink to this headline">¶</a></h1>
-<p>The script produces the plot in Figure. Here
-we demonstrate how <a class="reference internal" href="../sphtriangulate.html"><em>sphtriangulate</em></a> and
-<a class="reference internal" href="../sphdistance.html"><em>sphdistance</em></a> are used to compute the Delauney and
-Voronoi information on a sphere, using a decimated GSHHG crude coastline.
-We show a color image of the distances, highlighted with 500-km contours,
-and overlay the Voronoi polygons in green. Finally, the continents are
-placed on top.</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 35</span>
-<span class="c"># $Id$</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Illustrate sphtriangulate and sphdistance with GSHHG crude data</span>
-<span class="c"># GMT progs: pscoast, psxy, makecpt, grdimage, grdcontour, sphtriangulate, sphdistance</span>
-<span class="c"># Unix progs: rm</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_35.ps
-
-<span class="c"># Get the crude GSHHS data, select GMT format, and decimate to ~20%:</span>
-<span class="c"># gshhs $GMTHOME/src/coast/gshhs/gshhs_c.b | $AWK '{if ($1 == ">" || NR%5 == 0) print $0}' > gshhs_c.txt</span>
-<span class="c"># Get Voronoi polygons</span>
-gmt sphtriangulate gshhs_c.txt -Qv -D > tt.pol
-<span class="c"># Compute distances in km</span>
-gmt sphdistance -Rg -I1 -Qtt.pol -Gtt.nc -Lk
-gmt makecpt -Chot -T0/3500/500 -Z > t.cpt
-<span class="c"># Make a basic image plot and overlay contours, Voronoi polygons and coastlines</span>
-gmt grdimage tt.nc -JG-140/30/7i -P -K -Ct.cpt -X0.75i -Y2i > <span class="nv">$ps</span>
-gmt grdcontour tt.nc -J -O -K -C500 -A1000+f10p,Helvetica,white -L500 -GL0/90/203/-10,175/60/170/-30,-50/30/220/-5 -Wa0.75p,white -Wc0.25p,white >> <span class="nv">$ps</span>
-gmt psxy -R -J -O -K tt.pol -W0.25p,green,. >> <span class="nv">$ps</span>
-gmt pscoast -R -J -O -W1p -Gsteelblue -A0/1/1 -B30g30 -B+t<span class="s2">"Distances from GSHHG crude coastlines"</span> >> <span class="nv">$ps</span>
-<span class="c"># cleanup</span>
-rm -f gmt.conf tt.pol tt.nc t.cpt
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_35.png"><img alt="../_images/example_35.png" src="../_images/example_35.png" style="width: 500px;" /></a>
-<p class="caption">Spherical triangulation and distance calculations</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex34.html"
- title="previous chapter">(34) Using country polygons for plotting and shading</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex36.html"
- title="next chapter">(36) Spherical gridding using Renka’s algorithms</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex35.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex36.html" title="(36) Spherical gridding using Renka’s algorithms"
- >next</a> </li>
- <li class="right" >
- <a href="ex34.html" title="(34) Using country polygons for plotting and shading"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex36.html b/doc_release/html/gallery/ex36.html
deleted file mode 100644
index d998bfd..0000000
--- a/doc_release/html/gallery/ex36.html
+++ /dev/null
@@ -1,179 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(36) Spherical gridding using Renka’s algorithms — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(37) Spectral coherence between gravity and bathymetry grids" href="ex37.html" />
- <link rel="prev" title="(35) Spherical triangulation and distance calculations" href="ex35.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex37.html" title="(37) Spectral coherence between gravity and bathymetry grids"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex35.html" title="(35) Spherical triangulation and distance calculations"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="spherical-gridding-using-renka-s-algorithms">
-<span id="example-36"></span><h1>(36) Spherical gridding using Renka’s algorithms<a class="headerlink" href="#spherical-gridding-using-renka-s-algorithms" title="Permalink to this headline">¶</a></h1>
-<p>The next script produces the plot in Figure. Here
-we demonstrate how <a class="reference internal" href="../sphinterpolate.html"><em>sphinterpolate</em></a> can be used
-to perform spherical gridding. Our example uses early measurements of
-the radius of Mars from Mariner 9 and Viking Orbiter spacecrafts. The
-middle panels shows the data distribution while the top and bottom panel
-are images of the interpolation using a piecewise linear interpolation
-and a smoothed spline interpolation, respectively. For spherical gridding
-with large volumes of data we recommend <a class="reference internal" href="../sphinterpolate.html"><em>sphinterpolate</em></a>
-while for small data sets (such as this one, actually) you have more flexibility
-with <a class="reference internal" href="../greenspline.html"><em>greenspline</em></a>.</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 36</span>
-<span class="c"># $Id$</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Illustrate sphinterpolate with Mars radii data</span>
-<span class="c"># GMT progs: psxy, makecpt, grdimage, sphinterpolate</span>
-<span class="c"># Unix progs: rm</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_36.ps
-<span class="c"># Interpolate data of Mars radius from Mariner9 and Viking Orbiter spacecrafts</span>
-gmt makecpt -Crainbow -T-7000/15000/1000 -Z > tt.cpt
-<span class="c"># Piecewise linear interpolation; no tension</span>
-gmt sphinterpolate mars370.txt -Rg -I1 -Q0 -Gtt.nc
-gmt grdimage tt.nc -JH0/6i -Bag -Ctt.cpt -P -Xc -Y7.25i -K > <span class="nv">$ps</span>
-gmt psxy -Rg -J -O -K mars370.txt -Sc0.05i -G0 -B30g30 -Y-3.25i >> <span class="nv">$ps</span>
-<span class="c"># Smoothing</span>
-gmt sphinterpolate mars370.txt -Rg -I1 -Q3 -Gtt.nc
-gmt grdimage tt.nc -J -Bag -Ctt.cpt -Y-3.25i -O -K >> <span class="nv">$ps</span>
-gmt psxy -Rg -J -O -T >> <span class="nv">$ps</span>
-<span class="c"># cleanup</span>
-rm -f gmt.conf tt.cpt tt.nc
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_36.png"><img alt="../_images/example_36.png" src="../_images/example_36.png" style="width: 500px;" /></a>
-<p class="caption">Spherical gridding using Renka’s algorithms.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex35.html"
- title="previous chapter">(35) Spherical triangulation and distance calculations</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex37.html"
- title="next chapter">(37) Spectral coherence between gravity and bathymetry grids</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex36.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex37.html" title="(37) Spectral coherence between gravity and bathymetry grids"
- >next</a> </li>
- <li class="right" >
- <a href="ex35.html" title="(35) Spherical triangulation and distance calculations"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex37.html b/doc_release/html/gallery/ex37.html
deleted file mode 100644
index 56e5f42..0000000
--- a/doc_release/html/gallery/ex37.html
+++ /dev/null
@@ -1,203 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(37) Spectral coherence between gravity and bathymetry grids — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(38) Histogram equalization of bathymetry grids" href="ex38.html" />
- <link rel="prev" title="(36) Spherical gridding using Renka’s algorithms" href="ex36.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex38.html" title="(38) Histogram equalization of bathymetry grids"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex36.html" title="(36) Spherical gridding using Renka’s algorithms"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="spectral-coherence-between-gravity-and-bathymetry-grids">
-<span id="example-37"></span><h1>(37) Spectral coherence between gravity and bathymetry grids<a class="headerlink" href="#spectral-coherence-between-gravity-and-bathymetry-grids" title="Permalink to this headline">¶</a></h1>
-<p>The next script produces the plot in Figure.
-We demonstrate how <a class="reference internal" href="../grdfft.html"><em>grdfft</em></a> is used to compute the
-spectral coherence between two data sets, here multibeam bathymetry
-and satellite-derived gravity. The grids are detrended and tapered
-before the Fourier transform is computed; the intermediate plots show
-the grids being extended and padded to a suitable dimension.</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 37</span>
-<span class="c"># $Id$</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Illustrate 2-D FFT and coherence between gravity and bathymetry grids</span>
-<span class="c"># GMT progs: psbasemap, psxy, makecpt, grdfft, grdimage, grdinfo, grdgradient</span>
-<span class="c"># Unix progs: rm</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_37.ps
-
-<span class="c"># Testing gmt grdfft coherence calculation with Karen Marks example data</span>
-<span class="c"># Prefix of two .nc files</span>
-
-<span class="nv">G</span><span class="o">=</span>grav.V18.par.surf.1km.sq
-<span class="nv">T</span><span class="o">=</span>mb.par.surf.1km.sq
-gmt gmtset FONT_TITLE 14p
-
-gmt makecpt -Crainbow -T-5000/-3000/100 -Z > z.cpt
-gmt makecpt -Crainbow -T-50/25/5 -Z > g.cpt
-gmt grdinfo <span class="nv">$T</span>.nc -Ib > bbox
-gmt grdgradient <span class="nv">$G</span>.nc -A0 -Nt1 -G<span class="si">${</span><span class="nv">G</span><span class="si">}</span>_int.nc
-gmt grdgradient <span class="nv">$T</span>.nc -A0 -Nt1 -G<span class="si">${</span><span class="nv">T</span><span class="si">}</span>_int.nc
-<span class="nv">scl</span><span class="o">=</span>1.4e-5
-<span class="nv">sclkm</span><span class="o">=</span>1.4e-2
-gmt grdimage <span class="nv">$T</span>.nc -I<span class="si">${</span><span class="nv">T</span><span class="si">}</span>_int.nc -Jx<span class="si">${</span><span class="nv">scl</span><span class="si">}</span>i -Cz.cpt -P -K -X1.474i -Y1i > <span class="nv">$ps</span>
-gmt psbasemap -R-84/75/-78/81 -Jx<span class="si">${</span><span class="nv">sclkm</span><span class="si">}</span>i -O -K -Ba -BWSne+t<span class="s2">"Multibeam bathymetry"</span> >> <span class="nv">$ps</span>
-gmt grdimage <span class="nv">$G</span>.nc -I<span class="si">${</span><span class="nv">G</span><span class="si">}</span>_int.nc -Jx<span class="si">${</span><span class="nv">scl</span><span class="si">}</span>i -Cg.cpt -O -K -X3.25i >> <span class="nv">$ps</span>
-gmt psbasemap -R-84/75/-78/81 -Jx<span class="si">${</span><span class="nv">sclkm</span><span class="si">}</span>i -O -K -Ba -BWSne+t<span class="s2">"Satellite gravity"</span> >> <span class="nv">$ps</span>
-
-gmt grdfft <span class="nv">$T</span>.nc <span class="nv">$G</span>.nc -Ewk -N192/192+d+wtmp > cross.txt
-gmt grdgradient <span class="si">${</span><span class="nv">G</span><span class="si">}</span>_tmp.nc -A0 -Nt1 -G<span class="si">${</span><span class="nv">G</span><span class="si">}</span>_tmp_int.nc
-gmt grdgradient <span class="si">${</span><span class="nv">T</span><span class="si">}</span>_tmp.nc -A0 -Nt1 -G<span class="si">${</span><span class="nv">T</span><span class="si">}</span>_tmp_int.nc
-
-gmt makecpt -Crainbow -T-1500/1500/100 -Z > z.cpt
-gmt makecpt -Crainbow -T-40/40/5 -Z > g.cpt
-
-gmt grdimage <span class="si">${</span><span class="nv">T</span><span class="si">}</span>_tmp.nc -I<span class="si">${</span><span class="nv">T</span><span class="si">}</span>_tmp_int.nc -Jx<span class="si">${</span><span class="nv">scl</span><span class="si">}</span>i -Cz.cpt -O -K -X-3.474i -Y3i >> <span class="nv">$ps</span>
-gmt psxy -R<span class="si">${</span><span class="nv">T</span><span class="si">}</span>_tmp.nc -J bbox -O -K -L -W0.5p,- >> <span class="nv">$ps</span>
-gmt psbasemap -R-100/91/-94/97 -Jx<span class="si">${</span><span class="nv">sclkm</span><span class="si">}</span>i -O -K -Ba -BWSne+t<span class="s2">"Detrended and extended"</span> >> <span class="nv">$ps</span>
-
-gmt grdimage <span class="si">${</span><span class="nv">G</span><span class="si">}</span>_tmp.nc -I<span class="si">${</span><span class="nv">G</span><span class="si">}</span>_tmp_int.nc -Jx<span class="si">${</span><span class="nv">scl</span><span class="si">}</span>i -Cg.cpt -O -K -X3.25i >> <span class="nv">$ps</span>
-gmt psxy -R<span class="si">${</span><span class="nv">G</span><span class="si">}</span>_tmp.nc -J bbox -O -K -L -W0.5p,- >> <span class="nv">$ps</span>
-gmt psbasemap -R-100/91/-94/97 -Jx<span class="si">${</span><span class="nv">sclkm</span><span class="si">}</span>i -O -K -Ba -BWSne+t<span class="s2">"Detrended and extended"</span> >> <span class="nv">$ps</span>
-
-gmt gmtset FONT_TITLE 24p
-gmt psxy -R2/160/0/1 -JX-6il/2.5i -Bxa2f3g3+u<span class="s2">" km"</span> -Byafg0.5+l<span class="s2">"Coherency at +2@+"</span> -BWsNe+t<span class="s2">"Coherency between gravity and bathymetry"</span> -O -K -X-3.25i -Y3.3i cross.txt -i0,15 -W0.5p >> <span class="nv">$ps</span>
-gmt psxy -R -J cross.txt -O -K -i0,15,16 -Sc0.075i -Gred -W0.25p -Ey >> <span class="nv">$ps</span>
-gmt psxy -R -J -O -T >> <span class="nv">$ps</span>
-rm -f cross.txt *_tmp.nc *_int.nc ?.cpt bbox
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_37.png"><img alt="../_images/example_37.png" src="../_images/example_37.png" style="width: 500px;" /></a>
-<p class="caption">Spectral coherence between gravity and bathymetry grids.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex36.html"
- title="previous chapter">(36) Spherical gridding using Renka’s algorithms</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex38.html"
- title="next chapter">(38) Histogram equalization of bathymetry grids</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex37.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex38.html" title="(38) Histogram equalization of bathymetry grids"
- >next</a> </li>
- <li class="right" >
- <a href="ex36.html" title="(36) Spherical gridding using Renka’s algorithms"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex38.html b/doc_release/html/gallery/ex38.html
deleted file mode 100644
index 75cd1fb..0000000
--- a/doc_release/html/gallery/ex38.html
+++ /dev/null
@@ -1,179 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(38) Histogram equalization of bathymetry grids — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(39) Evaluation of spherical harmonics coefficients" href="ex39.html" />
- <link rel="prev" title="(37) Spectral coherence between gravity and bathymetry grids" href="ex37.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex39.html" title="(39) Evaluation of spherical harmonics coefficients"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex37.html" title="(37) Spectral coherence between gravity and bathymetry grids"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="histogram-equalization-of-bathymetry-grids">
-<span id="example-38"></span><h1>(38) Histogram equalization of bathymetry grids<a class="headerlink" href="#histogram-equalization-of-bathymetry-grids" title="Permalink to this headline">¶</a></h1>
-<p>This example shows how to use histogram equalization to enhance various
-ranges of a grid depending on its frequency distribution. The key tool
-used here is <a class="reference internal" href="../grdhisteq.html"><em>grdhisteq</em></a>.</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 38</span>
-<span class="c"># $Id$</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Illustrate histogram equalization on topography grids</span>
-<span class="c"># GMT progs: psscale, pstext, makecpt, grdhisteq, grdimage, grdinfo, grdgradient</span>
-<span class="c"># Unix progs: rm</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_38.ps
-
-gmt makecpt -Crainbow -T0/1700/100 -Z > t.cpt
-gmt makecpt -Crainbow -T0/15/1 > c.cpt
-gmt grdgradient topo.nc -Nt1 -fg -A45 -Gitopo.nc
-gmt grdhisteq topo.nc -Gout.nc -C16
-gmt grdimage topo.nc -Iitopo.nc -Ct.cpt -JM3i -Y5i -K -P -B5 -BWSne > <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"315 -10 Original"</span> <span class="p">|</span> gmt pstext -Rtopo.nc -J -O -K -F+jTR+f14p -T -Gwhite -W1p -Dj0.1i >> <span class="nv">$ps</span>
-gmt grdimage out.nc -Cc.cpt -J -X3.5i -K -O -B5 -BWSne >> <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"315 -10 Equalized"</span> <span class="p">|</span> gmt pstext -R -J -O -K -F+jTR+f14p -T -Gwhite -W1p -Dj0.1i >> <span class="nv">$ps</span>
-gmt psscale -D0i/-0.4i/5i/0.15ih -O -K -Ct.cpt -Ba500 -By+lm -E+n >> <span class="nv">$ps</span>
-gmt grdhisteq topo.nc -Gout.nc -N
-gmt makecpt -Crainbow -T-3/3/0.1 -Z > c.cpt
-gmt grdimage out.nc -Cc.cpt -J -X-3.5i -Y-3.3i -K -O -B5 -BWSne >> <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"315 -10 Normalized"</span> <span class="p">|</span> gmt pstext -R -J -O -K -F+jTR+f14p -T -Gwhite -W1p -Dj0.1i >> <span class="nv">$ps</span>
-gmt grdhisteq topo.nc -Gout.nc -N
-gmt grdimage out.nc -Cc.cpt -J -X3.5i -K -O -B5 -BWSne >> <span class="nv">$ps</span>
-<span class="nb">echo</span> <span class="s2">"315 -10 Quadratic"</span> <span class="p">|</span> gmt pstext -R -J -O -K -F+jTR+f14p -T -Gwhite -W1p -Dj0.1i >> <span class="nv">$ps</span>
-gmt psscale -D0i/-0.4i/5i/0.15ih -O -Cc.cpt -Bx1 -By+lz -E+n >> <span class="nv">$ps</span>
-rm -f itopo.nc out.nc ?.cpt
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_38.png"><img alt="../_images/example_38.png" src="../_images/example_38.png" style="width: 500px;" /></a>
-<p class="caption">Histogram equalization of bathymetry grids.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex37.html"
- title="previous chapter">(37) Spectral coherence between gravity and bathymetry grids</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex39.html"
- title="next chapter">(39) Evaluation of spherical harmonics coefficients</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex38.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex39.html" title="(39) Evaluation of spherical harmonics coefficients"
- >next</a> </li>
- <li class="right" >
- <a href="ex37.html" title="(37) Spectral coherence between gravity and bathymetry grids"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex39.html b/doc_release/html/gallery/ex39.html
deleted file mode 100644
index c540ed7..0000000
--- a/doc_release/html/gallery/ex39.html
+++ /dev/null
@@ -1,189 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(39) Evaluation of spherical harmonics coefficients — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="(40) Line simplification" href="ex40.html" />
- <link rel="prev" title="(38) Histogram equalization of bathymetry grids" href="ex38.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="ex40.html" title="(40) Line simplification"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex38.html" title="(38) Histogram equalization of bathymetry grids"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="evaluation-of-spherical-harmonics-coefficients">
-<span id="example-39"></span><h1>(39) Evaluation of spherical harmonics coefficients<a class="headerlink" href="#evaluation-of-spherical-harmonics-coefficients" title="Permalink to this headline">¶</a></h1>
-<p>We use a spherical harmonic model for the topography of Venus and evaluate
-the resulting global grid for three sets of upper order/degrees, here 30,
-90, and 180; the original file (see below) goes to order and degree 720.
-We use the coefficients to evaluate the grids and make perspective globes
-of the different resolutions. The key tool
-used here is <a class="reference internal" href="../sph2grd.html"><em>sph2grd</em></a>.</p>
-<p>Note that we use a special format in <a class="reference internal" href="../psscale.html"><em>psscale</em></a> so that the
-annotations will include the separators for the thousands.</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 39</span>
-<span class="c"># $Id$</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Illustrate evaluation of spherical harmonic coefficients</span>
-<span class="c"># GMT progs: psscale, pstext, makecpt, grdimage, grdgradient, sph2grd</span>
-<span class="c"># Unix progs: rm</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_39.ps
-
-<span class="c"># Evaluate the first 180, 90, and 30 order/degrees of Venus spherical</span>
-<span class="c"># harmonics topography model, skipping the L = 0 term (radial mean).</span>
-<span class="c"># File truncated from http://www.ipgp.fr/~wieczor/SH/VenusTopo180.txt.zip</span>
-<span class="c"># Wieczorek, M. A., Gravity and topography of the terrestrial planets,</span>
-<span class="c"># Treatise on Geophysics, 10, 165-205, doi:10.1016/B978-044452748-6/00156-5, 2007</span>
-
-gmt sph2grd VenusTopo180.txt -I1 -Rg -Ng -Gv1.nc -F1/1/25/30
-gmt sph2grd VenusTopo180.txt -I1 -Rg -Ng -Gv2.nc -F1/1/85/90
-gmt sph2grd VenusTopo180.txt -I1 -Rg -Ng -Gv3.nc -F1/1/170/180
-gmt grd2cpt v3.nc -Crainbow -E16 -Z > t.cpt
-gmt grdgradient v1.nc -Nt0.75 -A45 -Gvint.nc
-gmt grdimage v1.nc -Ivint.nc -JG90/30/5i -P -K -Bg -Ct.cpt -X3i -Y1.1i > <span class="nv">$ps</span>
-<span class="nb">echo </span><span class="m">4</span> 4.5 <span class="nv">L</span> <span class="o">=</span> <span class="m">30</span> <span class="p">|</span> gmt pstext -R0/6/0/6 -Jx1i -O -K -Dj0.2i -F+f16p+jLM -N >> <span class="nv">$ps</span>
-gmt psscale --FORMAT_FLOAT_MAP<span class="o">=</span><span class="s2">"%'g"</span> -Ct.cpt -O -K -D1.25i/-0.2i/5.5i/0.1ih -Bxaf -By+lm >> <span class="nv">$ps</span>
-gmt grdgradient v2.nc -Nt0.75 -A45 -Gvint.nc
-gmt grdimage v2.nc -Ivint.nc -JG -O -K -Bg -Ct.cpt -X-1.25i -Y1.9i >> <span class="nv">$ps</span>
-<span class="nb">echo </span><span class="m">4</span> 4.5 <span class="nv">L</span> <span class="o">=</span> <span class="m">90</span> <span class="p">|</span> gmt pstext -R0/6/0/6 -Jx1i -O -K -Dj0.2i -F+f16p+jLM -N >> <span class="nv">$ps</span>
-gmt sph2grd VenusTopo180.txt -I1 -Rg -Ng -Gv3.nc -F1/1/170/180
-gmt grdgradient v3.nc -Nt0.75 -A45 -Gvint.nc
-gmt grdimage v3.nc -Ivint.nc -JG -O -K -Bg -Ct.cpt -X-1.25i -Y1.9i >> <span class="nv">$ps</span>
-<span class="nb">echo </span><span class="m">4</span> 4.5 <span class="nv">L</span> <span class="o">=</span> <span class="m">180</span> <span class="p">|</span> gmt pstext -R0/6/0/6 -Jx1i -O -K -Dj0.2i -F+f16p+jLM -N >> <span class="nv">$ps</span>
-<span class="nb">echo </span>3.75 5.4 Venus Spherical Harmonic Model <span class="p">|</span> gmt pstext -R0/6/0/6 -Jx1i -O -F+f24p+jCM -N >> <span class="nv">$ps</span>
-rm -f v*.nc t.cpt
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_39.png"><img alt="../_images/example_39.png" src="../_images/example_39.png" style="width: 500px;" /></a>
-<p class="caption">Evaluation of spherical harmonics coefficients.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex38.html"
- title="previous chapter">(38) Histogram equalization of bathymetry grids</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="ex40.html"
- title="next chapter">(40) Line simplification</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex39.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="ex40.html" title="(40) Line simplification"
- >next</a> </li>
- <li class="right" >
- <a href="ex38.html" title="(38) Histogram equalization of bathymetry grids"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/ex40.html b/doc_release/html/gallery/ex40.html
deleted file mode 100644
index 745f9ba..0000000
--- a/doc_release/html/gallery/ex40.html
+++ /dev/null
@@ -1,186 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>(40) Line simplification — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../_static/jquery.js"></script>
- <script type="text/javascript" src="../_static/underscore.js"></script>
- <script type="text/javascript" src="../_static/doctools.js"></script>
- <script type="text/javascript" src="../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../index.html" />
- <link rel="up" title="The GMT historical collection" href="../Gallery.html" />
- <link rel="next" title="Introduction" href="anim_introduction.html" />
- <link rel="prev" title="(39) Evaluation of spherical harmonics coefficients" href="ex39.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="anim_introduction.html" title="Introduction"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ex39.html" title="(39) Evaluation of spherical harmonics coefficients"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" accesskey="U">The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="line-simplification">
-<span id="example-40"></span><h1>(40) Line simplification<a class="headerlink" href="#line-simplification" title="Permalink to this headline">¶</a></h1>
-<p>This example demonstrate the Douglas-Peucker line simplification algorithm as
-implemented in the tool <a class="reference internal" href="../gmtsimplify.html"><em>gmtsimplify</em></a>. We show the full
-resolution coastline of Australia and two much simplified versions using two
-different thresholds.</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c"># GMT EXAMPLE 40</span>
-<span class="c"># $Id $</span>
-<span class="c">#</span>
-<span class="c"># Purpose: Illustrate line simplification and area calculations</span>
-<span class="c"># GMT progs: psbasemap, pstext, psxy, gmtsimplify, gmtspatial</span>
-<span class="c"># Unix progs: awk, rm</span>
-<span class="c">#</span>
-<span class="nv">ps</span><span class="o">=</span>example_40.ps
-
-gmt gmtspatial GSHHS_h_Australia.txt -fg -Qk > centroid.txt
-gmt psbasemap -R112/154/-40/-10 -JM5.5i -P -K -B20 -BWSne+g240/255/240 -Xc > <span class="nv">$ps</span>
-gmt psxy GSHHS_h_Australia.txt -R -J -O -Wfaint -G240/240/255 -K >> <span class="nv">$ps</span>
-gmt psxy GSHHS_h_Australia.txt -R -J -O -Sc0.01c -Gred -K >> <span class="nv">$ps</span>
-gmt gmtsimplify GSHHS_h_Australia.txt -T500k > T500k.txt
-gmt gmtspatial GSHHS_h_Australia.txt -fg -Qk <span class="p">|</span> awk <span class="s1">'{printf "Full area = %.0f km at +2@+\n", $3}'</span> > area.txt
-gmt gmtspatial T500k.txt -fg -Qk <span class="p">|</span> awk <span class="s1">'{printf "Reduced area = %.0f km at +2@+\n", $3}'</span> > area_T500k.txt
-gmt psxy -R -J -O -K -W1p,blue T500k.txt >> <span class="nv">$ps</span>
-gmt psxy -R -J -O -K -Sx0.3i -W3p centroid.txt >> <span class="nv">$ps</span>
-<span class="nb">echo </span><span class="m">112</span> -10 <span class="nv">T</span> <span class="o">=</span> <span class="m">500</span> km <span class="p">|</span> gmt pstext -R -J -O -K -Dj0.1i/0.1i -F+jTL+f18p >> <span class="nv">$ps</span>
-gmt pstext -R -J -O -K area.txt -F+14p+cCM >> <span class="nv">$ps</span>
-gmt pstext -R -J -O -K area_T500k.txt -F+14p+cLB -Dj0.2i >> <span class="nv">$ps</span>
-gmt psbasemap -R -J -O -K -B20+lightgray -BWsne+g240/255/240 -Y4.7i >> <span class="nv">$ps</span>
-gmt psxy GSHHS_h_Australia.txt -R -J -O -Wfaint -G240/240/255 -K >> <span class="nv">$ps</span>
-gmt psxy GSHHS_h_Australia.txt -R -J -O -Sc0.01c -Gred -K >> <span class="nv">$ps</span>
-gmt gmtsimplify GSHHS_h_Australia.txt -T100k > T100k.txt
-gmt gmtspatial T100k.txt -fg -Qk <span class="p">|</span> awk <span class="s1">'{printf "Reduced area = %.0f km at +2@+\n", $3}'</span> > area_T100k.txt
-gmt psxy -R -J -O -K -W1p,blue T100k.txt >> <span class="nv">$ps</span>
-gmt psxy -R -J -O -K -Sx0.3i -W3p centroid.txt >> <span class="nv">$ps</span>
-<span class="nb">echo </span><span class="m">112</span> -10 <span class="nv">T</span> <span class="o">=</span> <span class="m">100</span> km <span class="p">|</span> gmt pstext -R -J -O -K -Dj0.1i/0.1i -F+jTL+f18p >> <span class="nv">$ps</span>
-gmt pstext -R -J -O -K area.txt -F+14p+cCM >> <span class="nv">$ps</span>
-gmt pstext -R -J -O -K area_T100k.txt -F+14p+cLB -Dj0.2i >> <span class="nv">$ps</span>
-gmt psxy -R -J -O -T >> <span class="nv">$ps</span>
-rm -f centroid.txt area*.txt T*.txt
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../_images/example_40.png"><img alt="../_images/example_40.png" src="../_images/example_40.png" style="width: 500px;" /></a>
-<p class="caption">Illustrate line simplification and area calculations.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="ex39.html"
- title="previous chapter">(39) Evaluation of spherical harmonics coefficients</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="anim_introduction.html"
- title="next chapter">Introduction</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../_sources/gallery/ex40.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="anim_introduction.html" title="Introduction"
- >next</a> </li>
- <li class="right" >
- <a href="ex39.html" title="(39) Evaluation of spherical harmonics coefficients"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../Gallery.html" >The GMT historical collection</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/users_contrib_script/vertical_slice.html b/doc_release/html/gallery/users_contrib_script/vertical_slice.html
deleted file mode 100644
index a1e2eeb..0000000
--- a/doc_release/html/gallery/users_contrib_script/vertical_slice.html
+++ /dev/null
@@ -1,256 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>A Vertical slice — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="Users Script Contributions" href="../../Users_contrib_script.html" />
- <link rel="next" title="Users Symbol Contributions" href="../../Users_contrib_symbols.html" />
- <link rel="prev" title="Users Script Contributions" href="../../Users_contrib_script.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="../../Users_contrib_symbols.html" title="Users Symbol Contributions"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="../../Users_contrib_script.html" title="Users Script Contributions"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../Users_contrib_script.html" accesskey="U">Users Script Contributions</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="a-vertical-slice">
-<span id="vertical-slice"></span><h1>A Vertical slice<a class="headerlink" href="#a-vertical-slice" title="Permalink to this headline">¶</a></h1>
-<p>This is an example of how to graph a function p=f(x, y, z)
-and include in the graph a slice of it using GMT 5.</p>
-<p>In this case, my function is f(latitude, longitude, height) and to make
-the example self-contained I make the grid and the slice in the script.</p>
-<p>To keep the example easy to me, I did the slice in a N-S direction at a
-fixed longitude, so the slice is f(latitude, height). Nothing will prevent
-you from making the slices in other orientations. If you instead of a more
-or less straight line, you have an arbitrary path, you must be careful that
-the track does not have “folds” and if it has them you must break it into parts.</p>
-<p>Due to my slice is f(lat, height) I must dump it, add the column for the fixed
-longitude, and project the coordinates using mappproject and then re-grid it.</p>
-<p>The biggest problem that I found, and it took longer to me was how to locate
-the slice. In a 2D map it is easy to do, transforming (lat, lon) to (x, y) with
-mapproject, and then using J[xX] but in this case it was trial and error for me.
-Maybe someone has the recipe to do it analytically.</p>
-<p>The grid in the horizontal plane is to make sure the slice is located exactly where it should be.</p>
-<p>I also had to re-draw the box, because the slice partially covered it.</p>
-<p>I tried to make the script as clear as possible with comments, but
-yet they can be tricky.</p>
-<p>Regards, Eduardo.-</p>
-<p>–
-Eduardo A. Suarez
-Facultad de Ciencias Astronomicas y Geofisicas - UNLP</p>
-<div class="highlight-bash"><div class="highlight"><pre><span class="c">#!/bin/bash</span>
-<span class="c">#</span>
-gmt gmtset <span class="nv">GMT_COMPATIBILITY</span><span class="o">=</span><span class="m">5</span> <span class="nv">MAP_FRAME_TYPE</span><span class="o">=</span>plain
-<span class="c">#</span>
-<span class="c"># f(x,y,z) = sin(x+y)*e(-(x+y)*(3 - (z/1e4)))</span>
-<span class="c">#</span>
-<span class="c"># create base grid (z = 0)</span>
-<span class="c">#</span>
-gmt grdmath -R-75/-60/-50/-40 -I0.005 X D2R Y D2R ADD STO at xySum SIN @xySum <span class="se">\</span>
- <span class="m">3</span> MUL NEG EXP <span class="nv">MUL</span> <span class="o">=</span> base.nc
-<span class="c">#</span>
-<span class="c"># create slice grid (lon = -67.5) (-47.5 <= lat <= 42.5) (0 <= z <= 999)</span>
-<span class="c">#</span>
-gmt grdmath -R-47.5/-42.5/0/999 -I0.005/0.5 X D2R -67.5 D2R ADD STO at xySum SIN @xySum <span class="se">\</span>
- <span class="m">3</span> Y 1E4 DIV SUB MUL NEG EXP <span class="nv">MUL</span> <span class="o">=</span> slice.nc
-<span class="c">#</span>
-<span class="c"># dump slice grid and reproject X</span>
-<span class="c">#</span>
-gmt grd2xyz slice.nc <span class="p">|</span> awk <span class="s1">'{print -67.5,$0}'</span> <span class="p">|</span> gmt mapproject -R-75/-60/-50/-40 -JM-67.5/-45/16 <span class="p">|</span> <span class="se">\</span>
- awk <span class="s1">'{print $2,$3,$4}'</span>> points.d
-<span class="c">#</span>
-<span class="c"># calculate projected region X-limits</span>
-<span class="c">#</span>
-<span class="nv">lMin</span><span class="o">=</span><span class="sb">`</span><span class="nb">echo</span> <span class="s1">'-67.5 -47.5'</span> <span class="p">|</span> gmt mapproject -R-75/-60/-50/-40 -JM-67.5/-45/16 <span class="p">|</span> awk <span class="s1">'{print $2}'</span><span class="sb">`</span>
-<span class="nv">lMax</span><span class="o">=</span><span class="sb">`</span><span class="nb">echo</span> <span class="s1">'-67.5 -42.5'</span> <span class="p">|</span> gmt mapproject -R-75/-60/-50/-40 -JM-67.5/-45/16 <span class="p">|</span> awk <span class="s1">'{print $2}'</span><span class="sb">`</span>
-<span class="c">#</span>
-<span class="c"># re-grid slice</span>
-<span class="c">#</span>
-gmt surface points.d -Gslice_cut.nc -R<span class="nv">$lMin</span>/<span class="nv">$lMax</span>/0/999 -I1500+/2000+ -C0.1 -T0.25
-<span class="c">#</span>
-<span class="c"># create color palette</span>
-<span class="c">#</span>
-<span class="nv">deltaZ</span><span class="o">=</span><span class="sb">`</span>gmt grdinfo -T10 slice_cut.nc base.nc<span class="sb">`</span>
-gmt makecpt -Cseis -I <span class="nv">$deltaZ</span> -Z > colors.cpt
-<span class="c">#</span>
-<span class="c"># make basemap (this is not necessary but...)</span>
-<span class="c">#</span>
-gmt psbasemap -R-75/-60/-50/-40/0/999 -JM-67.5/-45/16 -JZ8 -Bxa2f1 -Bya1f1 -Bza250f50g250+l<span class="s2">"Km"</span> <span class="se">\</span>
- -B+b -BwESn -pz135/30+v10/5 -K > mag.ps
-<span class="c">#</span>
-<span class="c"># plot base grid (z = 0)</span>
-<span class="c">#</span>
-gmt grdimage base.nc -R -JM -JZ -Bxa2f1 -Bya1f1 -Bza250f50g250+l<span class="s2">"Km"</span> -B+b -BwESn <span class="se">\</span>
- -Ccolors.cpt -p -O -K >> mag.ps
-<span class="c">#</span>
-<span class="c"># plot map (coast, country borders). Grid plotted to check slice location</span>
-<span class="c">#</span>
-gmt pscoast -R -JM -JZ -Bxa2f1g0.5 -Bya1f1g0.5 -Bza250f50g250+l<span class="s2">"Km"</span> -B+b -BwESn -Df -A0/0/1 <span class="se">\</span>
- -N1/0.5p,black,-..- -W0.5p,black -p -O -K >> mag.ps
-<span class="c">#</span>
-<span class="c"># calculate max X projected</span>
-<span class="c">#</span>
-<span class="nv">xMax</span><span class="o">=</span><span class="sb">`</span><span class="nb">echo</span> <span class="s1">'-60 -40'</span> <span class="p">|</span> gmt mapproject -R-75/-60/-50/-40 -JM-67.5/-45/16 <span class="p">|</span> awk <span class="s1">'{print $2}'</span><span class="sb">`</span>
-<span class="c">#</span>
-<span class="c"># plot slice</span>
-<span class="c">#</span>
-gmt grdimage slice_cut.nc -R0/<span class="nv">$xMax</span>/0/999 -JX15.0922064999/8 -Bxa0f0 -Bya250f50+l<span class="s2">"Km"</span> -Ccolors.cpt <span class="se">\</span>
- -px135/30+v12.59/0.96 -O -K --MAP_FRAME_AXES<span class="o">=</span><span class="s1">''</span> >> mag.ps
-<span class="c">#</span>
-<span class="c"># plot slice box</span>
-<span class="c">#</span>
-gmt psxy -R -JX -W1p,black -px135/30+v12.59/0.96 -O -K >> mag.ps <span class="s"><< EOF</span>
-<span class="s">$lMin 0</span>
-<span class="s">$lMin 999</span>
-<span class="s">$lMax 999</span>
-<span class="s">$lMax 0</span>
-<span class="s">$lMin 0</span>
-<span class="s">EOF</span>
-<span class="c">#</span>
-<span class="c"># add missing Z-box lines overwritten by slice plot</span>
-<span class="c">#</span>
-gmt psxyz -R-75/-60/-50/-40/0/999 -JM-67.5/-45/16 -JZ8 -W1p,black -pz135/30+v10/5 -O >> mag.ps <span class="s"><< EOF</span>
-<span class="s"> -75 -50 999</span>
-<span class="s"> -75 -40 999</span>
-<span class="s"> -60 -40 999</span>
-<span class="s"> -60 -50 999</span>
-<span class="s"> -75 -50 999</span>
-<span class="s">></span>
-<span class="s"> -60 -50 0</span>
-<span class="s"> -60 -50 999</span>
-<span class="s">EOF</span>
-<span class="c">#</span>
-gmt ps2raster -Tg -Qt4 -Qg4 -E300 -P mag.ps
-<span class="c">#</span>
-rm -f base.nc points.d slice.nc slice_cut.nc gmt.history gmt.conf
-</pre></div>
-</div>
-<div class="figure align-center">
-<a class="reference internal image-reference" href="../../_images/vertical_slice.png"><img alt="../../_images/vertical_slice.png" src="../../_images/vertical_slice.png" style="width: 500px;" /></a>
-<p class="caption">A vertical slice ...</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="../../Users_contrib_script.html"
- title="previous chapter">Users Script Contributions</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="../../Users_contrib_symbols.html"
- title="next chapter">Users Symbol Contributions</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/gallery/users_contrib_script/vertical_slice.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="../../Users_contrib_symbols.html" title="Users Symbol Contributions"
- >next</a> </li>
- <li class="right" >
- <a href="../../Users_contrib_script.html" title="Users Script Contributions"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../Users_contrib_script.html" >Users Script Contributions</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gallery/users_contrib_symbols/pirata.html b/doc_release/html/gallery/users_contrib_symbols/pirata.html
deleted file mode 100644
index d17b434..0000000
--- a/doc_release/html/gallery/users_contrib_symbols/pirata.html
+++ /dev/null
@@ -1,889 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>A pirate — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="Users Symbol Contributions" href="../../Users_contrib_symbols.html" />
- <link rel="next" title="CookBook" href="../../cookbook.html" />
- <link rel="prev" title="Users Symbol Contributions" href="../../Users_contrib_symbols.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="../../cookbook.html" title="CookBook"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="../../Users_contrib_symbols.html" title="Users Symbol Contributions"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../Users_contrib_symbols.html" accesskey="U">Users Symbol Contributions</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="a-pirate">
-<span id="pirata"></span><h1>A pirate<a class="headerlink" href="#a-pirate" title="Permalink to this headline">¶</a></h1>
-<div class="highlight-python"><div class="highlight"><pre>#
-# Definition File created by Mirone Tech
-#
-0.500000 0.350000 M -G0/0/0 -W0.5p,0/0/0
-0.500000 -0.350000 D
--0.500000 -0.350000 D
--0.500000 0.350000 D
-0.500000 0.350000 D
-
-#
--0.070434 -0.152132 M -G255/255/255 -W0.5p,0/0/0
--0.096651 -0.136686 D
--0.123091 -0.120386 D
--0.149495 -0.103187 D
--0.162603 -0.094237 D
--0.175605 -0.085046 D
--0.188468 -0.075609 D
--0.201161 -0.065919 D
--0.213650 -0.055972 D
--0.225904 -0.045761 D
--0.237889 -0.035282 D
--0.249575 -0.024529 D
--0.260927 -0.013496 D
--0.271915 -0.002178 D
--0.282504 0.009430 D
--0.292664 0.021335 D
--0.302362 0.033541 D
--0.311565 0.046054 D
--0.320241 0.058880 D
--0.328357 0.072024 D
--0.335881 0.085492 D
--0.342781 0.099289 D
--0.349025 0.113420 D
--0.354579 0.127892 D
--0.359412 0.142709 D
--0.363492 0.157877 D
--0.366785 0.173402 D
--0.352229 0.156259 D
--0.337329 0.139314 D
--0.322091 0.122584 D
--0.306518 0.106089 D
--0.290616 0.089848 D
--0.274388 0.073878 D
--0.257839 0.058201 D
--0.240973 0.042833 D
--0.223796 0.027795 D
--0.206311 0.013104 D
--0.188524 -0.001219 D
--0.170438 -0.015156 D
--0.152058 -0.028688 D
--0.133389 -0.041797 D
--0.114435 -0.054463 D
--0.095200 -0.066667 D
--0.075689 -0.078391 D
--0.055907 -0.089615 D
--0.035859 -0.100322 D
--0.015547 -0.110490 D
-0.005022 -0.120103 D
-0.025844 -0.129140 D
-0.046916 -0.137584 D
-0.068232 -0.145414 D
-0.089788 -0.152613 D
-0.111579 -0.159160 D
-0.133601 -0.165039 D
-0.155850 -0.170228 D
-0.178320 -0.174710 D
-0.159911 -0.186319 D
-0.154213 -0.192428 D
-0.151260 -0.197502 D
-0.149610 -0.203059 D
-0.149309 -0.207056 D
-0.149701 -0.211308 D
-0.150832 -0.215828 D
-0.152745 -0.220633 D
-0.155488 -0.225738 D
-0.024939 -0.194235 D
--0.018650 -0.176710 D
--0.030833 -0.170811 D
--0.024920 -0.193345 D
--0.036896 -0.200709 D
--0.069944 -0.212517 D
--0.121526 -0.225667 D
--0.117553 -0.208125 D
--0.120314 -0.191992 D
--0.130931 -0.175703 D
--0.132416 -0.174168 D
--0.128533 -0.172566 D
--0.121344 -0.170617 D
--0.086891 -0.164610 D
--0.079677 -0.162583 D
--0.075772 -0.160911 D
--0.074153 -0.159958 D
--0.072785 -0.158916 D
--0.071688 -0.157778 D
--0.070884 -0.156538 D
--0.070393 -0.155189 D
--0.070236 -0.153722 D
--0.070434 -0.152132 D
-
-#
-0.040998 -0.013629 M -G255/255/255 -W0.5p,0/0/0
--0.007083 -0.023841 D
--0.018209 -0.023601 D
--0.023667 -0.022570 D
--0.029036 -0.020808 D
--0.034303 -0.018223 D
--0.039453 -0.014720 D
--0.039038 -0.011980 D
--0.038939 -0.006392 D
--0.039750 -0.000751 D
--0.041392 0.004839 D
--0.043786 0.010275 D
--0.048614 0.017908 D
--0.054691 0.024605 D
--0.059304 0.028375 D
--0.064276 0.031468 D
--0.069526 0.033779 D
--0.074977 0.035203 D
--0.077753 0.035550 D
--0.080549 0.035637 D
--0.083356 0.035449 D
--0.086164 0.034975 D
--0.088963 0.034201 D
--0.091743 0.033114 D
--0.096384 0.032475 D
--0.104063 0.036346 D
--0.117134 0.051905 D
--0.121327 0.134526 D
--0.121754 0.171753 D
--0.113223 0.190647 D
--0.102118 0.208358 D
--0.088705 0.224487 D
--0.073254 0.238634 D
--0.056031 0.250402 D
--0.041157 0.257834 D
--0.023728 0.260835 D
--0.005624 0.262589 D
-0.006616 0.262933 D
-0.018848 0.262524 D
-0.030949 0.261280 D
-0.036912 0.260321 D
-0.042797 0.259123 D
-0.048588 0.257676 D
-0.054269 0.255971 D
-0.059825 0.253998 D
-0.065241 0.251746 D
-0.070502 0.249205 D
-0.075591 0.246366 D
-0.080494 0.243219 D
-0.085196 0.239752 D
-0.089680 0.235958 D
-0.093933 0.231824 D
-0.097937 0.227342 D
-0.101678 0.222502 D
-0.105141 0.217293 D
-0.108309 0.211705 D
-0.111169 0.205729 D
-0.115599 0.201695 D
-0.119457 0.197537 D
-0.122768 0.193264 D
-0.125560 0.188886 D
-0.127856 0.184412 D
-0.129682 0.179854 D
-0.131065 0.175221 D
-0.132029 0.170523 D
-0.132599 0.165771 D
-0.132803 0.160973 D
-0.132664 0.156141 D
-0.132208 0.151284 D
-0.131461 0.146413 D
-0.129197 0.136667 D
-0.126074 0.126982 D
-0.115851 0.103569 D
-0.104727 0.082301 D
-0.100740 0.074676 D
-0.122686 0.068969 D
-0.120377 0.065322 D
-0.117800 0.061962 D
-0.114982 0.058863 D
-0.111947 0.056000 D
-0.105333 0.050880 D
-0.090642 0.042346 D
-0.064527 0.028625 D
-0.057972 0.023992 D
-0.054973 0.021429 D
-0.052196 0.018667 D
-0.049665 0.015682 D
-0.047405 0.012448 D
-0.045444 0.008938 D
-0.043805 0.005128 D
-0.042516 0.000991 D
-0.041601 -0.003497 D
-0.041087 -0.008362 D
-0.040998 -0.013629 D
-
-#
-0.289840 -0.219325 M -G255/255/255 -W0.5p,0/0/0
-0.284013 -0.218888 D
-0.275016 -0.219693 D
-0.240547 -0.227984 D
-0.231078 -0.228901 D
-0.224825 -0.228566 D
-0.221724 -0.228043 D
-0.221346 -0.224194 D
-0.221332 -0.220606 D
-0.221664 -0.217269 D
-0.222324 -0.214172 D
-0.223293 -0.211308 D
-0.224554 -0.208664 D
-0.226088 -0.206233 D
-0.227877 -0.204004 D
-0.229902 -0.201967 D
-0.232146 -0.200113 D
-0.237215 -0.196913 D
-0.242937 -0.194327 D
-0.252425 -0.191427 D
-0.285958 -0.187079 D
-0.291919 -0.186606 D
-0.333447 -0.183066 D
-0.333866 -0.186905 D
-0.334211 -0.194141 D
-0.332496 -0.216871 D
-0.330474 -0.224572 D
-0.328598 -0.228863 D
-0.327487 -0.230673 D
-0.326253 -0.232224 D
-0.324892 -0.233487 D
-0.323398 -0.234435 D
-0.321766 -0.235041 D
-0.319991 -0.235277 D
-0.318069 -0.235117 D
-0.315993 -0.234531 D
-0.313760 -0.233494 D
-0.311363 -0.231978 D
-0.308799 -0.229955 D
-0.306250 -0.227381 D
-0.303642 -0.225199 D
-0.300980 -0.223384 D
-0.298266 -0.221912 D
-0.295503 -0.220761 D
-0.292693 -0.219906 D
-0.289840 -0.219325 D
-
-#
-0.148074 -0.292592 M -G255/255/255 -W0.5p,0/0/0
-0.144302 -0.291620 D
-0.136817 -0.288904 D
-0.129733 -0.285332 D
-0.126462 -0.283292 D
-0.123437 -0.281118 D
-0.120706 -0.278837 D
-0.118318 -0.276475 D
-0.116321 -0.274059 D
-0.114763 -0.271615 D
-0.113692 -0.269170 D
-0.113159 -0.266750 D
-0.113209 -0.264382 D
-0.113893 -0.262093 D
-0.115259 -0.259909 D
-0.117354 -0.257856 D
-0.120228 -0.255962 D
-0.123929 -0.254253 D
-0.151687 -0.258519 D
-0.155528 -0.257259 D
-0.158833 -0.254696 D
-0.160679 -0.252126 D
-0.162200 -0.248771 D
-0.162827 -0.246774 D
-0.162819 -0.241736 D
-0.163111 -0.236841 D
-0.163687 -0.232081 D
-0.164531 -0.227447 D
-0.165626 -0.222932 D
-0.168505 -0.214226 D
-0.172191 -0.205897 D
-0.178948 -0.193969 D
-0.217579 -0.141188 D
-0.224586 -0.129120 D
-0.226679 -0.128066 D
-0.231156 -0.126679 D
-0.235880 -0.126176 D
-0.240683 -0.126467 D
-0.247668 -0.128195 D
-0.253884 -0.131201 D
-0.257321 -0.133763 D
-0.259996 -0.136667 D
-0.260995 -0.138219 D
-0.261741 -0.139821 D
-0.262212 -0.141464 D
-0.262387 -0.143136 D
-0.262246 -0.144825 D
-0.261768 -0.146520 D
-0.260930 -0.148210 D
-0.259714 -0.149883 D
-0.258096 -0.151528 D
-0.256057 -0.153134 D
-0.253575 -0.154690 D
-0.250629 -0.156183 D
-0.246187 -0.159468 D
-0.242088 -0.162948 D
-0.238307 -0.166612 D
-0.234823 -0.170444 D
-0.231610 -0.174432 D
-0.228647 -0.178562 D
-0.223372 -0.187195 D
-0.216742 -0.200874 D
-0.198136 -0.248409 D
-0.193656 -0.257465 D
-0.188487 -0.266118 D
-0.185585 -0.270261 D
-0.182441 -0.274262 D
-0.179030 -0.278109 D
-0.175330 -0.281788 D
-0.174187 -0.284946 D
-0.172564 -0.287571 D
-0.170508 -0.289690 D
-0.168068 -0.291330 D
-0.165292 -0.292518 D
-0.162229 -0.293278 D
-0.158927 -0.293640 D
-0.155435 -0.293628 D
-0.151802 -0.293270 D
-0.148074 -0.292592 D
-
-#
--0.129117 -0.286912 M -G255/255/255 -W0.5p,0/0/0
--0.132612 -0.285646 D
--0.135982 -0.284094 D
--0.139233 -0.282277 D
--0.145402 -0.277933 D
--0.151167 -0.272780 D
--0.161675 -0.260711 D
--0.182070 -0.231042 D
--0.186382 -0.230648 D
--0.190769 -0.230701 D
--0.195225 -0.231160 D
--0.199741 -0.231982 D
--0.204309 -0.233127 D
--0.213574 -0.236211 D
--0.251184 -0.253004 D
--0.260416 -0.256633 D
--0.264963 -0.258131 D
--0.269454 -0.259361 D
--0.273882 -0.260283 D
--0.278238 -0.260853 D
--0.282515 -0.261030 D
--0.286705 -0.260772 D
--0.290801 -0.260036 D
--0.294794 -0.258781 D
--0.298676 -0.256964 D
--0.302441 -0.254544 D
--0.306080 -0.251478 D
--0.309586 -0.247724 D
--0.310815 -0.244473 D
--0.311722 -0.241366 D
--0.312319 -0.238399 D
--0.312621 -0.235566 D
--0.312643 -0.232863 D
--0.312398 -0.230284 D
--0.311901 -0.227826 D
--0.311167 -0.225483 D
--0.309043 -0.221122 D
--0.306139 -0.217164 D
--0.300572 -0.211896 D
--0.278748 -0.199691 D
--0.266136 -0.194279 D
--0.265281 -0.197271 D
--0.264719 -0.200070 D
--0.264430 -0.202688 D
--0.264394 -0.205139 D
--0.264593 -0.207437 D
--0.265617 -0.211624 D
--0.268428 -0.217080 D
--0.285124 -0.235714 D
--0.287222 -0.239366 D
--0.288712 -0.243456 D
--0.289181 -0.245697 D
--0.289440 -0.248087 D
--0.289470 -0.250639 D
--0.282132 -0.247021 D
--0.275302 -0.242738 D
--0.242255 -0.213740 D
--0.229983 -0.203982 D
--0.223365 -0.199875 D
--0.216291 -0.196474 D
--0.212552 -0.195084 D
--0.208660 -0.193925 D
--0.204603 -0.193015 D
--0.200369 -0.192372 D
--0.195945 -0.192014 D
--0.191319 -0.191959 D
--0.211732 -0.127692 D
--0.205563 -0.127066 D
--0.199751 -0.127097 D
--0.194284 -0.127750 D
--0.189148 -0.128989 D
--0.184332 -0.130780 D
--0.179821 -0.133086 D
--0.175604 -0.135872 D
--0.171667 -0.139104 D
--0.167999 -0.142746 D
--0.164585 -0.146761 D
--0.161413 -0.151116 D
--0.158471 -0.155775 D
--0.155746 -0.160702 D
--0.153224 -0.165862 D
--0.148742 -0.176740 D
--0.143227 -0.193921 D
--0.136409 -0.222503 D
--0.134214 -0.233094 D
--0.133180 -0.238067 D
--0.132170 -0.242778 D
--0.131173 -0.247192 D
--0.126539 -0.247380 D
--0.115374 -0.248526 D
--0.097439 -0.252448 D
--0.092093 -0.254418 D
--0.087458 -0.256751 D
--0.085482 -0.258059 D
--0.083772 -0.259464 D
--0.082360 -0.260970 D
--0.081273 -0.262578 D
--0.080542 -0.264291 D
--0.080197 -0.266110 D
--0.080266 -0.268040 D
--0.080781 -0.270080 D
--0.081770 -0.272235 D
--0.083263 -0.274506 D
--0.085290 -0.276896 D
--0.087881 -0.279407 D
--0.091064 -0.282041 D
--0.095950 -0.284278 D
--0.100658 -0.286043 D
--0.105193 -0.287356 D
--0.109562 -0.288238 D
--0.113770 -0.288710 D
--0.117824 -0.288792 D
--0.121729 -0.288506 D
--0.125491 -0.287873 D
--0.129117 -0.286912 D
-
-#
--0.058391 -0.065139 M -G255/255/255 -W0.5p,0/0/0
--0.063996 -0.057971 D
--0.068948 -0.050302 D
--0.073282 -0.042194 D
--0.078701 -0.029346 D
--0.084094 -0.011266 D
--0.088829 0.016871 D
--0.085205 0.017229 D
--0.081914 0.017204 D
--0.078938 0.016818 D
--0.076254 0.016095 D
--0.073841 0.015055 D
--0.071679 0.013722 D
--0.069748 0.012118 D
--0.068025 0.010266 D
--0.066490 0.008187 D
--0.063902 0.003441 D
--0.060907 -0.004816 D
--0.053045 -0.032135 D
--0.050454 -0.037577 D
--0.048918 -0.040077 D
--0.047194 -0.042401 D
--0.045260 -0.044526 D
--0.043096 -0.046430 D
-0.033982 -0.041737 D
-0.050451 -0.045358 D
-0.053719 -0.046453 D
-0.055850 -0.041709 D
-0.058113 -0.033482 D
-0.063107 -0.003019 D
-0.064655 0.002420 D
-0.066703 0.007263 D
-0.067957 0.009410 D
-0.069388 0.011348 D
-0.071011 0.013056 D
-0.072845 0.014514 D
-0.074906 0.015701 D
-0.077211 0.016598 D
-0.079777 0.017183 D
-0.082621 0.017437 D
-0.085760 0.017340 D
-0.089211 0.016871 D
-0.089546 0.010788 D
-0.089554 0.004569 D
-0.089237 -0.001754 D
-0.088602 -0.008145 D
-0.087651 -0.014572 D
-0.086388 -0.021000 D
-0.084818 -0.027395 D
-0.082945 -0.033723 D
-0.080772 -0.039952 D
-0.078303 -0.046046 D
-0.075544 -0.051971 D
-0.072497 -0.057695 D
-0.069167 -0.063183 D
-0.065558 -0.068401 D
-0.061674 -0.073315 D
-0.057518 -0.077892 D
-0.053096 -0.082098 D
-0.048410 -0.085898 D
-0.043466 -0.089259 D
-0.038266 -0.092147 D
-0.032816 -0.094528 D
-0.027118 -0.096369 D
-0.021178 -0.097635 D
-0.014999 -0.098292 D
-0.008585 -0.098307 D
-0.001941 -0.097646 D
--0.004930 -0.096274 D
--0.012024 -0.094159 D
--0.019337 -0.091265 D
--0.024143 -0.089511 D
--0.028736 -0.087544 D
--0.033123 -0.085374 D
--0.037306 -0.083009 D
--0.041291 -0.080455 D
--0.045082 -0.077721 D
--0.052098 -0.071743 D
--0.058391 -0.065139 D
-
-#
-0.073567 -0.086719 M -G255/255/255 -W0.5p,0/0/0
-0.097659 -0.070760 D
-0.121233 -0.054023 D
-0.144294 -0.036553 D
-0.166846 -0.018394 D
-0.188892 0.000410 D
-0.210437 0.019815 D
-0.231485 0.039777 D
-0.262132 0.070665 D
-0.291682 0.102557 D
-0.320149 0.135303 D
-0.347546 0.168752 D
-0.355796 0.173561 D
-0.353224 0.159286 D
-0.349957 0.145288 D
-0.346023 0.131564 D
-0.341449 0.118111 D
-0.336262 0.104926 D
-0.330490 0.092007 D
-0.324161 0.079351 D
-0.317302 0.066955 D
-0.309940 0.054816 D
-0.302103 0.042932 D
-0.293818 0.031299 D
-0.285112 0.019915 D
-0.276014 0.008777 D
-0.266551 -0.002117 D
-0.256749 -0.012771 D
-0.246637 -0.023188 D
-0.236242 -0.033369 D
-0.225591 -0.043318 D
-0.214712 -0.053038 D
-0.203632 -0.062532 D
-0.192378 -0.071802 D
-0.169462 -0.089681 D
-0.146181 -0.106699 D
-0.122756 -0.122878 D
-0.099406 -0.138240 D
-0.097277 -0.137194 D
-0.092353 -0.135546 D
-0.083686 -0.133932 D
-0.051875 -0.130556 D
-0.046486 -0.129247 D
-0.044076 -0.128405 D
-0.041891 -0.127415 D
-0.039954 -0.126261 D
-0.038292 -0.124925 D
-0.036929 -0.123392 D
-0.035891 -0.121644 D
-0.035202 -0.119665 D
-0.034889 -0.117438 D
-0.034975 -0.114946 D
-0.035488 -0.112173 D
-0.036450 -0.109102 D
-0.048954 -0.101855 D
-0.073567 -0.086719 D
-
-#
-0.088675 -0.187655 M -G0/0/0 -W0.5p,0/0/0
-0.112186 -0.193820 D
-0.123579 -0.193549 D
-0.129699 -0.191998 D
-0.128899 -0.190097 D
-0.126756 -0.186527 D
-0.123959 -0.183276 D
-0.118721 -0.179033 D
-0.110235 -0.174642 D
-0.098158 -0.171365 D
-0.085678 -0.170776 D
-0.076288 -0.172406 D
-0.070034 -0.174936 D
-0.075277 -0.179933 D
-0.088675 -0.187655 D
-
-#
--0.076578 -0.194792 M -G0/0/0 -W0.5p,0/0/0
--0.071194 -0.193256 D
--0.055193 -0.185259 D
--0.048787 -0.179950 D
--0.046564 -0.177159 D
--0.045215 -0.174350 D
--0.044920 -0.172955 D
--0.044907 -0.171577 D
--0.045195 -0.170221 D
--0.045805 -0.168894 D
--0.046759 -0.167604 D
--0.048077 -0.166357 D
--0.049779 -0.165159 D
--0.051887 -0.164019 D
--0.053457 -0.164609 D
--0.055292 -0.165323 D
--0.057358 -0.166151 D
--0.064592 -0.169222 D
--0.085463 -0.179958 D
--0.089554 -0.182791 D
--0.091242 -0.184175 D
--0.092646 -0.185524 D
--0.093732 -0.186828 D
--0.094464 -0.188078 D
--0.094810 -0.189263 D
--0.094735 -0.190374 D
--0.094204 -0.191400 D
--0.093183 -0.192332 D
--0.091638 -0.193159 D
--0.089534 -0.193872 D
--0.086838 -0.194461 D
--0.083515 -0.194915 D
--0.079531 -0.195226 D
--0.076578 -0.194792 D
-
-#
-0.011028 -0.160776 M -G0/0/0 -W0.5p,0/0/0
-0.056817 -0.172166 D
-0.054063 -0.166927 D
-0.050776 -0.162424 D
-0.047010 -0.158584 D
-0.042823 -0.155336 D
-0.033411 -0.150329 D
--0.012372 -0.138945 D
--0.009620 -0.144183 D
--0.006334 -0.148685 D
--0.002569 -0.152524 D
-0.001617 -0.155771 D
-0.011028 -0.160776 D
-
-#
-0.002062 0.083489 M -G0/0/0 -W0.5p,0/0/0
--0.011328 0.042492 D
-0.022015 0.042466 D
-0.022514 0.058581 D
-0.017486 0.072306 D
-0.010463 0.079334 D
-0.002062 0.083489 D
-
-#
-0.027744 0.094494 M -G0/0/0 -W0.5p,0/0/0
-0.047050 0.074325 D
-0.052051 0.073184 D
-0.056641 0.073005 D
-0.060820 0.073705 D
-0.064587 0.075200 D
-0.067941 0.077408 D
-0.070881 0.080245 D
-0.073404 0.083628 D
-0.075512 0.087474 D
-0.077201 0.091699 D
-0.078472 0.096219 D
-0.079324 0.100953 D
-0.079754 0.105816 D
-0.079763 0.110725 D
-0.079348 0.115596 D
-0.078510 0.120348 D
-0.077246 0.124895 D
-0.075556 0.129155 D
-0.073439 0.133045 D
-0.070893 0.136482 D
-0.067918 0.139381 D
-0.064513 0.141660 D
-0.060676 0.143236 D
-0.056406 0.144025 D
-0.051703 0.143944 D
-0.046565 0.142909 D
-0.040991 0.140838 D
-0.034980 0.137646 D
-0.028531 0.133251 D
-0.021643 0.127570 D
-0.021048 0.122935 D
-0.021739 0.109890 D
-0.027744 0.094494 D
-
-#
--0.043960 0.072239 M -G0/0/0 -W0.5p,0/0/0
--0.038665 0.073716 D
--0.033745 0.076066 D
--0.031484 0.077568 D
--0.029387 0.079288 D
--0.027478 0.081225 D
--0.025779 0.083381 D
--0.024315 0.085754 D
--0.023109 0.088345 D
--0.022184 0.091154 D
--0.021564 0.094180 D
--0.019751 0.095920 D
--0.016757 0.099805 D
--0.014580 0.104107 D
--0.013191 0.108683 D
--0.012561 0.113388 D
--0.012659 0.118077 D
--0.013455 0.122605 D
--0.014920 0.126827 D
--0.017025 0.130599 D
--0.019739 0.133776 D
--0.023033 0.136213 D
--0.024888 0.137109 D
--0.026877 0.137766 D
--0.028996 0.138165 D
--0.031241 0.138289 D
--0.033609 0.138119 D
--0.036096 0.137638 D
--0.038698 0.136827 D
--0.041412 0.135668 D
--0.064246 0.124073 D
--0.073753 0.116470 D
--0.076949 0.111753 D
--0.078293 0.108180 D
--0.078901 0.104218 D
--0.078682 0.099828 D
--0.078233 0.097460 D
--0.077543 0.094970 D
--0.077260 0.091882 D
--0.076648 0.089013 D
--0.075730 0.086363 D
--0.074531 0.083933 D
--0.073073 0.081721 D
--0.071380 0.079728 D
--0.069475 0.077954 D
--0.067383 0.076399 D
--0.065126 0.075062 D
--0.060211 0.073046 D
--0.054920 0.071903 D
--0.049441 0.071634 D
--0.043960 0.072239 D
-</pre></div>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h4>Previous topic</h4>
- <p class="topless"><a href="../../Users_contrib_symbols.html"
- title="previous chapter">Users Symbol Contributions</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="../../cookbook.html"
- title="next chapter">CookBook</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/gallery/users_contrib_symbols/pirata.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="../../cookbook.html" title="CookBook"
- >next</a> </li>
- <li class="right" >
- <a href="../../Users_contrib_symbols.html" title="Users Symbol Contributions"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../Users_contrib_symbols.html" >Users Symbol Contributions</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/genindex.html b/doc_release/html/genindex.html
deleted file mode 100644
index 3256fcb..0000000
--- a/doc_release/html/genindex.html
+++ /dev/null
@@ -1,768 +0,0 @@
-
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>Index — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="#" title="General Index"
- accesskey="I">index</a></li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
-
-<h1 id="index">Index</h1>
-
-<div class="genindex-jumpbox">
- <a href="#A"><strong>A</strong></a>
- | <a href="#B"><strong>B</strong></a>
- | <a href="#D"><strong>D</strong></a>
- | <a href="#F"><strong>F</strong></a>
- | <a href="#G"><strong>G</strong></a>
- | <a href="#H"><strong>H</strong></a>
- | <a href="#I"><strong>I</strong></a>
- | <a href="#K"><strong>K</strong></a>
- | <a href="#M"><strong>M</strong></a>
- | <a href="#N"><strong>N</strong></a>
- | <a href="#O"><strong>O</strong></a>
- | <a href="#P"><strong>P</strong></a>
- | <a href="#R"><strong>R</strong></a>
- | <a href="#S"><strong>S</strong></a>
- | <a href="#T"><strong>T</strong></a>
- | <a href="#X"><strong>X</strong></a>
-
-</div>
-<h2 id="A">A</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
- <td style="width: 33%" valign="top"><dl>
-
- <dt><a href="GMT_API.html#index-0"><strong>API</strong></a>
- </dt>
-
- </dl></td>
-</tr></table>
-
-<h2 id="B">B</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
- <td style="width: 33%" valign="top"><dl>
-
- <dt><a href="supplements/spotter/backtracker.html#index-0"><strong>backtracker</strong></a>
- </dt>
-
-
- <dt><a href="blockmean.html#index-0"><strong>blockmean</strong></a>
- </dt>
-
- </dl></td>
- <td style="width: 33%" valign="top"><dl>
-
- <dt><a href="blockmedian.html#index-0"><strong>blockmedian</strong></a>
- </dt>
-
-
- <dt><a href="blockmode.html#index-0"><strong>blockmode</strong></a>
- </dt>
-
- </dl></td>
-</tr></table>
-
-<h2 id="D">D</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
- <td style="width: 33%" valign="top"><dl>
-
- <dt><a href="supplements/misc/dimfilter.html#index-0"><strong>dimfilter</strong></a>
- </dt>
-
- </dl></td>
-</tr></table>
-
-<h2 id="F">F</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
- <td style="width: 33%" valign="top"><dl>
-
- <dt><a href="filter1d.html#index-0"><strong>filter1d</strong></a>
- </dt>
-
- </dl></td>
- <td style="width: 33%" valign="top"><dl>
-
- <dt><a href="fitcircle.html#index-0"><strong>fitcircle</strong></a>
- </dt>
-
- </dl></td>
-</tr></table>
-
-<h2 id="G">G</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
- <td style="width: 33%" valign="top"><dl>
-
- <dt><a href="gmt.html#index-0"><strong>gmt</strong></a>
- </dt>
-
-
- <dt><a href="gmt.conf.html#index-0"><strong>gmt.conf</strong></a>
- </dt>
-
-
- <dt><a href="gmt2kml.html#index-0"><strong>gmt2kml</strong></a>
- </dt>
-
-
- <dt><a href="gmt5syntax.html#index-0"><strong>gmt5syntax</strong></a>
- </dt>
-
-
- <dt><a href="gmt_shell_functions.sh.html#index-0"><strong>gmt_shell_functions.sh</strong></a>
- </dt>
-
-
- <dt><a href="gmtcolors.html#index-0"><strong>gmtcolors</strong></a>
- </dt>
-
-
- <dt><a href="gmtconnect.html#index-0"><strong>gmtconnect</strong></a>
- </dt>
-
-
- <dt><a href="gmtconvert.html#index-0"><strong>gmtconvert</strong></a>
- </dt>
-
-
- <dt><a href="gmtdefaults.html#index-0"><strong>gmtdefaults</strong></a>
- </dt>
-
-
- <dt><a href="gmtget.html#index-0"><strong>gmtget</strong></a>
- </dt>
-
-
- <dt><a href="supplements/potential/gmtgravmag3d.html#index-0"><strong>gmtgravmag3d</strong></a>
- </dt>
-
-
- <dt><a href="gmtinfo.html#index-0"><strong>gmtinfo</strong></a>
- </dt>
-
-
- <dt><a href="gmtlogo.html#index-0"><strong>gmtlogo</strong></a>
- </dt>
-
-
- <dt><a href="gmtmath.html#index-0"><strong>gmtmath</strong></a>
- </dt>
-
-
- <dt><a href="gmtselect.html#index-0"><strong>gmtselect</strong></a>
- </dt>
-
-
- <dt><a href="gmtset.html#index-0"><strong>gmtset</strong></a>
- </dt>
-
-
- <dt><a href="gmtsimplify.html#index-0"><strong>gmtsimplify</strong></a>
- </dt>
-
-
- <dt><a href="gmtspatial.html#index-0"><strong>gmtspatial</strong></a>
- </dt>
-
-
- <dt><a href="gmtswitch.html#index-0"><strong>gmtswitch</strong></a>
- </dt>
-
-
- <dt><a href="gmtvector.html#index-0"><strong>gmtvector</strong></a>
- </dt>
-
-
- <dt><a href="gmtwhich.html#index-0"><strong>gmtwhich</strong></a>
- </dt>
-
-
- <dt><a href="supplements/potential/gravfft.html#index-0"><strong>gravfft</strong></a>
- </dt>
-
-
- <dt><a href="grd2cpt.html#index-0"><strong>grd2cpt</strong></a>
- </dt>
-
-
- <dt><a href="grd2rgb.html#index-0"><strong>grd2rgb</strong></a>
- </dt>
-
-
- <dt><a href="grd2xyz.html#index-0"><strong>grd2xyz</strong></a>
- </dt>
-
-
- <dt><a href="grdblend.html#index-0"><strong>grdblend</strong></a>
- </dt>
-
-
- <dt><a href="grdclip.html#index-0"><strong>grdclip</strong></a>
- </dt>
-
-
- <dt><a href="grdcontour.html#index-0"><strong>grdcontour</strong></a>
- </dt>
-
-
- <dt><a href="grdcut.html#index-0"><strong>grdcut</strong></a>
- </dt>
-
- </dl></td>
- <td style="width: 33%" valign="top"><dl>
-
- <dt><a href="grdedit.html#index-0"><strong>grdedit</strong></a>
- </dt>
-
-
- <dt><a href="grdfft.html#index-0"><strong>grdfft</strong></a>
- </dt>
-
-
- <dt><a href="grdfilter.html#index-0"><strong>grdfilter</strong></a>
- </dt>
-
-
- <dt><a href="grdgradient.html#index-0"><strong>grdgradient</strong></a>
- </dt>
-
-
- <dt><a href="supplements/potential/grdgravmag3d.html#index-0"><strong>grdgravmag3d</strong></a>
- </dt>
-
-
- <dt><a href="grdhisteq.html#index-0"><strong>grdhisteq</strong></a>
- </dt>
-
-
- <dt><a href="grdimage.html#index-0"><strong>grdimage</strong></a>
- </dt>
-
-
- <dt><a href="grdinfo.html#index-0"><strong>grdinfo</strong></a>
- </dt>
-
-
- <dt><a href="grdlandmask.html#index-0"><strong>grdlandmask</strong></a>
- </dt>
-
-
- <dt><a href="grdmask.html#index-0"><strong>grdmask</strong></a>
- </dt>
-
-
- <dt><a href="grdmath.html#index-0"><strong>grdmath</strong></a>
- </dt>
-
-
- <dt><a href="grdpaste.html#index-0"><strong>grdpaste</strong></a>
- </dt>
-
-
- <dt><a href="supplements/spotter/grdpmodeler.html#index-0"><strong>grdpmodeler</strong></a>
- </dt>
-
-
- <dt><a href="grdproject.html#index-0"><strong>grdproject</strong></a>
- </dt>
-
-
- <dt><a href="grdraster.html#index-0"><strong>grdraster</strong></a>
- </dt>
-
-
- <dt><a href="supplements/potential/grdredpol.html#index-0"><strong>grdredpol</strong></a>
- </dt>
-
-
- <dt><a href="grdreformat.html#index-0"><strong>grdreformat</strong></a>
- </dt>
-
-
- <dt><a href="supplements/spotter/grdrotater.html#index-0"><strong>grdrotater</strong></a>
- </dt>
-
-
- <dt><a href="grdsample.html#index-0"><strong>grdsample</strong></a>
- </dt>
-
-
- <dt><a href="supplements/potential/grdseamount.html#index-0"><strong>grdseamount</strong></a>
- </dt>
-
-
- <dt><a href="supplements/spotter/grdspotter.html#index-0"><strong>grdspotter</strong></a>
- </dt>
-
-
- <dt><a href="grdtrack.html#index-0"><strong>grdtrack</strong></a>
- </dt>
-
-
- <dt><a href="grdtrend.html#index-0"><strong>grdtrend</strong></a>
- </dt>
-
-
- <dt><a href="grdvector.html#index-0"><strong>grdvector</strong></a>
- </dt>
-
-
- <dt><a href="grdview.html#index-0"><strong>grdview</strong></a>
- </dt>
-
-
- <dt><a href="grdvolume.html#index-0"><strong>grdvolume</strong></a>
- </dt>
-
-
- <dt><a href="greenspline.html#index-0"><strong>greenspline</strong></a>
- </dt>
-
-
- <dt><a href="supplements/gshhg/gshhg.html#index-0"><strong>gshhg</strong></a>
- </dt>
-
- </dl></td>
-</tr></table>
-
-<h2 id="H">H</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
- <td style="width: 33%" valign="top"><dl>
-
- <dt><a href="supplements/spotter/hotspotter.html#index-0"><strong>hotspotter</strong></a>
- </dt>
-
- </dl></td>
-</tr></table>
-
-<h2 id="I">I</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
- <td style="width: 33%" valign="top"><dl>
-
- <dt><a href="supplements/img/img2google.html#index-0"><strong>img2google</strong></a>
- </dt>
-
-
- <dt><a href="supplements/img/img2grd.html#index-0"><strong>img2grd</strong></a>
- </dt>
-
- </dl></td>
- <td style="width: 33%" valign="top"><dl>
-
- <dt><a href="isogmt.html#index-0"><strong>isogmt</strong></a>
- </dt>
-
- </dl></td>
-</tr></table>
-
-<h2 id="K">K</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
- <td style="width: 33%" valign="top"><dl>
-
- <dt><a href="kml2gmt.html#index-0"><strong>kml2gmt</strong></a>
- </dt>
-
- </dl></td>
-</tr></table>
-
-<h2 id="M">M</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
- <td style="width: 33%" valign="top"><dl>
-
- <dt><a href="makecpt.html#index-0"><strong>makecpt</strong></a>
- </dt>
-
-
- <dt><a href="mapproject.html#index-0"><strong>mapproject</strong></a>
- </dt>
-
-
- <dt><a href="supplements/mgd77/mgd77convert.html#index-0"><strong>mgd77convert</strong></a>
- </dt>
-
-
- <dt><a href="supplements/mgd77/mgd77info.html#index-0"><strong>mgd77info</strong></a>
- </dt>
-
-
- <dt><a href="supplements/mgd77/mgd77list.html#index-0"><strong>mgd77list</strong></a>
- </dt>
-
- </dl></td>
- <td style="width: 33%" valign="top"><dl>
-
- <dt><a href="supplements/mgd77/mgd77magref.html#index-0"><strong>mgd77magref</strong></a>
- </dt>
-
-
- <dt><a href="supplements/mgd77/mgd77manage.html#index-0"><strong>mgd77manage</strong></a>
- </dt>
-
-
- <dt><a href="supplements/mgd77/mgd77path.html#index-0"><strong>mgd77path</strong></a>
- </dt>
-
-
- <dt><a href="supplements/mgd77/mgd77sniffer.html#index-0"><strong>mgd77sniffer</strong></a>
- </dt>
-
-
- <dt><a href="supplements/mgd77/mgd77track.html#index-0"><strong>mgd77track</strong></a>
- </dt>
-
- </dl></td>
-</tr></table>
-
-<h2 id="N">N</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
- <td style="width: 33%" valign="top"><dl>
-
- <dt><a href="nearneighbor.html#index-0"><strong>nearneighbor</strong></a>
- </dt>
-
- </dl></td>
-</tr></table>
-
-<h2 id="O">O</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
- <td style="width: 33%" valign="top"><dl>
-
- <dt><a href="supplements/spotter/originator.html#index-0"><strong>originator</strong></a>
- </dt>
-
- </dl></td>
-</tr></table>
-
-<h2 id="P">P</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
- <td style="width: 33%" valign="top"><dl>
-
- <dt><a href="project.html#index-0"><strong>project</strong></a>
- </dt>
-
-
- <dt><a href="ps2raster.html#index-0"><strong>ps2raster</strong></a>
- </dt>
-
-
- <dt><a href="psbasemap.html#index-0"><strong>psbasemap</strong></a>
- </dt>
-
-
- <dt><a href="psclip.html#index-0"><strong>psclip</strong></a>
- </dt>
-
-
- <dt><a href="pscoast.html#index-0"><strong>pscoast</strong></a>
- </dt>
-
-
- <dt><a href="pscontour.html#index-0"><strong>pscontour</strong></a>
- </dt>
-
-
- <dt><a href="supplements/meca/pscoupe.html#index-0"><strong>pscoupe</strong></a>
- </dt>
-
-
- <dt><a href="pshistogram.html#index-0"><strong>pshistogram</strong></a>
- </dt>
-
-
- <dt><a href="psimage.html#index-0"><strong>psimage</strong></a>
- </dt>
-
-
- <dt><a href="pslegend.html#index-0"><strong>pslegend</strong></a>
- </dt>
-
-
- <dt><a href="pslib.html#index-0"><strong>pslib</strong></a>
- </dt>
-
-
- <dt><a href="psmask.html#index-0"><strong>psmask</strong></a>
- </dt>
-
- </dl></td>
- <td style="width: 33%" valign="top"><dl>
-
- <dt><a href="supplements/meca/psmeca.html#index-0"><strong>psmeca</strong></a>
- </dt>
-
-
- <dt><a href="supplements/meca/pspolar.html#index-0"><strong>pspolar</strong></a>
- </dt>
-
-
- <dt><a href="psrose.html#index-0"><strong>psrose</strong></a>
- </dt>
-
-
- <dt><a href="psscale.html#index-0"><strong>psscale</strong></a>
- </dt>
-
-
- <dt><a href="supplements/segy/pssegy.html#index-0"><strong>pssegy</strong></a>
- </dt>
-
-
- <dt><a href="supplements/segy/pssegyz.html#index-0"><strong>pssegyz</strong></a>
- </dt>
-
-
- <dt><a href="pstext.html#index-0"><strong>pstext</strong></a>
- </dt>
-
-
- <dt><a href="supplements/meca/psvelo.html#index-0"><strong>psvelo</strong></a>
- </dt>
-
-
- <dt><a href="pswiggle.html#index-0"><strong>pswiggle</strong></a>
- </dt>
-
-
- <dt><a href="psxy.html#index-0"><strong>psxy</strong></a>
- </dt>
-
-
- <dt><a href="psxyz.html#index-0"><strong>psxyz</strong></a>
- </dt>
-
- </dl></td>
-</tr></table>
-
-<h2 id="R">R</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
- <td style="width: 33%" valign="top"><dl>
-
- <dt><a href="supplements/spotter/rotconverter.html#index-0"><strong>rotconverter</strong></a>
- </dt>
-
- </dl></td>
-</tr></table>
-
-<h2 id="S">S</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
- <td style="width: 33%" valign="top"><dl>
-
- <dt><a href="sample1d.html#index-0"><strong>sample1d</strong></a>
- </dt>
-
-
- <dt><a href="supplements/segy/segy2grd.html#index-0"><strong>segy2grd</strong></a>
- </dt>
-
-
- <dt><a href="spectrum1d.html#index-0"><strong>spectrum1d</strong></a>
- </dt>
-
-
- <dt><a href="sph2grd.html#index-0"><strong>sph2grd</strong></a>
- </dt>
-
-
- <dt><a href="sphdistance.html#index-0"><strong>sphdistance</strong></a>
- </dt>
-
- </dl></td>
- <td style="width: 33%" valign="top"><dl>
-
- <dt><a href="sphinterpolate.html#index-0"><strong>sphinterpolate</strong></a>
- </dt>
-
-
- <dt><a href="sphtriangulate.html#index-0"><strong>sphtriangulate</strong></a>
- </dt>
-
-
- <dt><a href="splitxyz.html#index-0"><strong>splitxyz</strong></a>
- </dt>
-
-
- <dt><a href="surface.html#index-0"><strong>surface</strong></a>
- </dt>
-
- </dl></td>
-</tr></table>
-
-<h2 id="T">T</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
- <td style="width: 33%" valign="top"><dl>
-
- <dt><a href="testapi.html#index-0"><strong>testapi</strong></a>
- </dt>
-
-
- <dt><a href="trend1d.html#index-0"><strong>trend1d</strong></a>
- </dt>
-
- </dl></td>
- <td style="width: 33%" valign="top"><dl>
-
- <dt><a href="trend2d.html#index-0"><strong>trend2d</strong></a>
- </dt>
-
-
- <dt><a href="triangulate.html#index-0"><strong>triangulate</strong></a>
- </dt>
-
- </dl></td>
-</tr></table>
-
-<h2 id="X">X</h2>
-<table style="width: 100%" class="indextable genindextable"><tr>
- <td style="width: 33%" valign="top"><dl>
-
- <dt><a href="supplements/x2sys/x2sys_binlist.html#index-0"><strong>x2sys_binlist</strong></a>
- </dt>
-
-
- <dt><a href="supplements/x2sys/x2sys_cross.html#index-0"><strong>x2sys_cross</strong></a>
- </dt>
-
-
- <dt><a href="supplements/x2sys/x2sys_datalist.html#index-0"><strong>x2sys_datalist</strong></a>
- </dt>
-
-
- <dt><a href="supplements/x2sys/x2sys_get.html#index-0"><strong>x2sys_get</strong></a>
- </dt>
-
-
- <dt><a href="supplements/x2sys/x2sys_init.html#index-0"><strong>x2sys_init</strong></a>
- </dt>
-
-
- <dt><a href="supplements/x2sys/x2sys_list.html#index-0"><strong>x2sys_list</strong></a>
- </dt>
-
- </dl></td>
- <td style="width: 33%" valign="top"><dl>
-
- <dt><a href="supplements/x2sys/x2sys_merge.html#index-0"><strong>x2sys_merge</strong></a>
- </dt>
-
-
- <dt><a href="supplements/x2sys/x2sys_put.html#index-0"><strong>x2sys_put</strong></a>
- </dt>
-
-
- <dt><a href="supplements/x2sys/x2sys_report.html#index-0"><strong>x2sys_report</strong></a>
- </dt>
-
-
- <dt><a href="supplements/x2sys/x2sys_solve.html#index-0"><strong>x2sys_solve</strong></a>
- </dt>
-
-
- <dt><a href="xyz2grd.html#index-0"><strong>xyz2grd</strong></a>
- </dt>
-
- </dl></td>
-</tr></table>
-
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="#" title="General Index"
- >index</a></li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gmt.conf.html b/doc_release/html/gmt.conf.html
deleted file mode 100644
index 19e0233..0000000
--- a/doc_release/html/gmt.conf.html
+++ /dev/null
@@ -1,1202 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>gmt.conf — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GM" href="GM.html" />
- <link rel="next" title="gmt" href="gmt.html" />
- <link rel="prev" title="GM" href="GM.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="gmt.html" title="gmt"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="GM.html" title="GM"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" accesskey="U">GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gmt-conf">
-<span id="index-0"></span><h1>gmt.conf<a class="headerlink" href="#gmt-conf" title="Permalink to this headline">¶</a></h1>
-<p>gmt.conf - Configuration for GMT</p>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p>The following is a list of the parameters that are user-definable in
-GMT. The parameter names are always given in UPPER CASE. The
-parameter values are case-insensitive unless otherwise noted. The system
-defaults are given in brackets [ for SI (and US) ]. Those marked <strong>*</strong>
-can be set on the command line as well (the corresponding option is
-given in parentheses). Note that default distances and lengths below are
-given in both cm or inch; the chosen default depends on your choice of
-default unit (see <a class="reference internal" href="#proj-length-unit"><em>PROJ_LENGTH_UNIT</em></a>). You can explicitly specify
-the unit used for distances and lengths by appending <strong>c</strong> (cm), <strong>i</strong>
-(inch), or <strong>p</strong> (points). When no unit is indicated the value will be
-assumed to be in the unit set by <a class="reference internal" href="#proj-length-unit"><em>PROJ_LENGTH_UNIT</em></a>. Several
-parameters take only <strong>true</strong> or <strong>false</strong>. Finally, most of these
-parameters can be changed on-the-fly via the <strong>-</strong><strong>-PARAMETER</strong>=<em>VALUE</em>
-option to any GMT program. However, a few are static and are only
-read via the <strong>gmt.conf</strong> file; these are labeled (static).</p>
-</div>
-<div class="section" id="common-specifications">
-<h2>Common Specifications<a class="headerlink" href="#common-specifications" title="Permalink to this headline">¶</a></h2>
-<p>The full explanation for how to specify pens, pattern fills, colors, and
-fonts can be found in the <a class="reference internal" href="gmt.html"><em>gmt</em></a> man page.</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="67%" />
-<col width="33%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head">THEMATIC SUB-SECTIONS</th>
-<th class="head"><em>prefix</em></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td><a class="reference internal" href="#color-parameters">COLOR Parameters</a></td>
-<td><strong>COLOR_</strong></td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="#dir-parameters">DIR Parameters</a></td>
-<td><strong>DIR_</strong></td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="#font-parameters">FONT Parameters</a></td>
-<td><strong>FONT_</strong></td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="#format-parameters">FORMAT Parameters</a></td>
-<td><strong>FORMAT_</strong></td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="#gmt-miscellaneous-parameters">GMT Miscellaneous Parameters</a></td>
-<td><strong>GMT_</strong></td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="#i-o-parameters">I/O Parameters</a></td>
-<td><strong>IO_</strong></td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="#map-parameters">MAP Parameters</a></td>
-<td><strong>MAP_</strong></td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="#projection-parameters">Projection Parameters</a></td>
-<td><strong>PROJ_</strong></td>
-</tr>
-<tr class="row-even"><td><a class="reference internal" href="#postscript-parameters">PostScript Parameters</a></td>
-<td><strong>PS_</strong></td>
-</tr>
-<tr class="row-odd"><td><a class="reference internal" href="#calendar-time-parameters">Calendar/Time Parameters</a></td>
-<td><strong>TIME_</strong></td>
-</tr>
-</tbody>
-</table>
-<dl class="docutils" id="color-background">
-<span id="color-parameters"></span><dt><strong>COLOR_BACKGROUND</strong></dt>
-<dd>Color used for the background of images (i.e., when z < lowest color
-table entry) [black].</dd>
-</dl>
-<dl class="docutils" id="color-foreground">
-<dt><strong>COLOR_FOREGROUND</strong></dt>
-<dd>Color used for the foreground of images (i.e., when z > highest
-color table entry) [white].</dd>
-</dl>
-<dl class="docutils" id="color-hsv-max-s">
-<dt><strong>COLOR_HSV_MAX_S</strong></dt>
-<dd>Maximum saturation (0-1) assigned for most positive intensity value [0.1].</dd>
-</dl>
-<dl class="docutils" id="color-hsv-min-s">
-<dt><strong>COLOR_HSV_MIN_S</strong></dt>
-<dd>Minimum saturation (0-1) assigned for most negative intensity value [1.0].</dd>
-</dl>
-<dl class="docutils" id="color-hsv-max-v">
-<dt><strong>COLOR_HSV_MAX_V</strong></dt>
-<dd>Maximum value (0-1) assigned for most positive intensity value [1.0].</dd>
-</dl>
-<dl class="docutils" id="color-hsv-min-v">
-<dt><strong>COLOR_HSV_MIN_V</strong></dt>
-<dd>Minimum value (0-1) assigned for most negative intensity value [0.3].</dd>
-</dl>
-<dl class="docutils" id="color-model">
-<dt><strong>COLOR_MODEL</strong></dt>
-<dd>Selects in which color space a color palette should be interpolated.
-By default, color interpolation takes place directly on the RGB
-values which can produce some unexpected hues, whereas interpolation
-directly on the HSV values better preserves those hues. The choices
-are: <strong>none</strong> (default: use whatever the COLOR_MODEL setting in the
-color palette file demands), <strong>rgb</strong> (force interpolation in RGB),
-<strong>hsv</strong> (force interpolation in HSV), <strong>cmyk</strong> (assumes colors are
-in CMYK but interpolates in RGB).</dd>
-</dl>
-<dl class="docutils" id="color-nan">
-<dt><strong>COLOR_NAN</strong></dt>
-<dd>Color used for the non-defined areas of images (i.e., where z == NaN) [127.5].</dd>
-</dl>
-<dl class="docutils" id="dir-parameters">
-<dt><strong>DIR_DATA</strong></dt>
-<dd>Session data dir. Overrides the value of the environment variable <strong>$GMT_DATADIR</strong>
-(see <a class="reference internal" href="GMT_Docs.html#directory-parameters"><em>Directory parameters</em></a> in the CookBook).</dd>
-<dt><strong>DIR_DCW</strong></dt>
-<dd>Path to optional Digital Chart of the World polygon files.</dd>
-<dt><strong>DIR_GSHHG</strong></dt>
-<dd>Path to GSHHG files. Defaults to <strong>$GMT_SHAREDIR</strong>/coast if empty.</dd>
-</dl>
-<dl class="docutils" id="font-parameters">
-<dt><strong>FONT</strong></dt>
-<dd>Sets the default for all fonts, except FONT_LOGO. This setting is
-not included in the <strong>gmt.conf</strong> file.</dd>
-</dl>
-<dl class="docutils" id="font-annot-primary">
-<dt><strong>FONT_ANNOT_PRIMARY</strong></dt>
-<dd>Font used for primary annotations, etc. [12p,Helvetica,black]. When
-<strong>+</strong> is prepended, scale fonts, offsets and tick-lengths relative
-to <strong>FONT_ANNOT_PRIMARY</strong>.</dd>
-</dl>
-<dl class="docutils" id="font-annot-secondary">
-<dt><strong>FONT_ANNOT_SECONDARY</strong></dt>
-<dd>Font to use for time axis secondary annotations
-[14p,Helvetica,black].</dd>
-</dl>
-<dl class="docutils" id="font-label">
-<dt><strong>FONT_LABEL</strong></dt>
-<dd>Font to use when plotting labels below axes [16p,Helvetica,black].</dd>
-</dl>
-<dl class="docutils" id="font-logo">
-<dt><strong>FONT_LOGO</strong></dt>
-<dd>Font to use for text plotted as part of the GMT time logo
-[8p,Helvetica,black].</dd>
-</dl>
-<dl class="docutils" id="font-title">
-<dt><strong>FONT_TITLE</strong></dt>
-<dd>Font to use when plotting titles over graphs [24p,Helvetica,black].</dd>
-</dl>
-<dl class="docutils" id="format-clock-in">
-<span id="format-parameters"></span><dt><strong>FORMAT_CLOCK_IN</strong></dt>
-<dd>Formatting template that indicates how an input clock string is
-formatted. This template is then used to guide the reading of clock
-strings in data fields. To properly decode 12-hour clocks, append am
-or pm (or upper case) to match your data records. As examples, try
-hh:mm, hh:mm:ssAM, etc. [hh:mm:ss].</dd>
-</dl>
-<dl class="docutils" id="format-clock-map">
-<dt><strong>FORMAT_CLOCK_MAP</strong></dt>
-<dd>Formatting template that indicates how an output clock string is to
-be plotted. This template is then used to guide the formatting of
-clock strings in plot annotations. See <strong>FORMAT_CLOCK_OUT</strong> for
-details. [hh:mm:ss].</dd>
-</dl>
-<dl class="docutils" id="format-clock-out">
-<dt><strong>FORMAT_CLOCK_OUT</strong></dt>
-<dd>Formatting template that indicates how an output clock string is to
-be formatted. This template is then used to guide the writing of
-clock strings in data fields. To use a floating point format for the
-smallest unit (e.g., seconds), append .xxx, where the number of x
-indicates the desired precision. If no floating point is indicated
-then the smallest specified unit will be rounded off to nearest
-integer. For 12-hour clocks, append am, AM, a.m., or A.M. (GMT
-will replace a|A with p|P for pm). If your template starts with a
-leading hyphen (-) then each integer item (y,m,d) will be printed
-without leading zeros (default uses fixed width formats). As
-examples, try hh:mm, hh.mm.ss, hh:mm:ss.xxxx, hha.m., etc.
-[hh:mm:ss]. If the format is simply - then no clock is output and
-the ISO T divider between date and clock is omitted.</dd>
-</dl>
-<dl class="docutils" id="format-date-in">
-<dt><strong>FORMAT_DATE_IN</strong></dt>
-<dd>Formatting template that indicates how an input date string is
-formatted. This template is then used to guide the reading of date
-strings in data fields. You may specify either Gregorian calendar
-format or ISO week calendar format. Gregorian calendar: Use any
-combination of yyyy (or yy for 2-digit years; if so see
-<strong>TIME_Y2K_OFFSET_YEAR</strong>), mm (or o for abbreviated month name in
-the current time language), and dd, with or without delimiters. For
-day-of-year data, use jjj instead of mm and/or dd. Examples can be
-ddmmyyyy, yy-mm-dd, dd-o-yyyy, yyyy/dd/mm, yyyy-jjj, etc. ISO
-Calendar: Expected template is yyyy[-]W[-]ww[-]d, where ww is ISO
-week and d is ISO week day. Either template must be consistent,
-e.g., you cannot specify months if you do not specify years.
-Examples are yyyyWwwd, yyyy-Www, etc. [yyyy-mm-dd].</dd>
-</dl>
-<dl class="docutils" id="format-date-map">
-<dt><strong>FORMAT_DATE_MAP</strong></dt>
-<dd>Formatting template that indicates how an output date string is to
-be plotted. This template is then used to guide the plotting of date
-strings in data fields. See <strong>FORMAT_DATE_OUT</strong> for details. In
-addition, you may use a single o instead of mm (to plot month name)
-and u instead of W[-]ww to plot “Week ##”. Both of these text
-strings will be affected by the <strong>TIME_LANGUAGE</strong>,
-<strong>FORMAT_TIME_PRIMARY_MAP</strong> and <strong>FORMAT_TIME_SECONDARY_MAP</strong>
-setting. [yyyy-mm-dd].</dd>
-</dl>
-<dl class="docutils" id="format-date-out">
-<dt><strong>FORMAT_DATE_OUT</strong></dt>
-<dd>Formatting template that indicates how an output date string is to
-be formatted. This template is then used to guide the writing of
-date strings in data fields. You may specify either Gregorian
-calendar format or ISO week calendar format. Gregorian calendar: Use
-any combination of yyyy (or yy for 2-digit years; if so see
-<strong>TIME_Y2K_OFFSET_YEAR</strong>), mm (or o for abbreviated month name in
-the current time language), and dd, with or without delimiters. For
-day-of-year data, use jjj instead of mm and/or dd. As examples, try
-yy/mm/dd, yyyy=jjj, dd-o-yyyy, dd-mm-yy, yy-mm, etc. ISO Calendar:
-Expected template is yyyy[-]W[-]ww[-]d, where ww is ISO week and d
-is ISO week day. Either template must be consistent, e.g., you
-cannot specify months if you do not specify years. As examples, try
-yyyyWww, yy-W-ww-d, etc. If your template starts with a leading
-hyphen (-) then each integer item (y,m,d) will be printed without
-leading zeros (default uses fixed width formats) [yyyy-mm-dd]. If
-the format is simply - then no date is output and the ISO T divider
-between date and clock is omitted.</dd>
-</dl>
-<dl class="docutils" id="format-geo-map">
-<dt><strong>FORMAT_GEO_MAP</strong></dt>
-<dd>Formatting template that indicates how an output geographical
-coordinate is to be plotted. This template is then used to guide the
-plotting of geographical coordinates in data fields. See
-<strong>FORMAT_GEO_OUT</strong> for details. In addition, you can append A
-which plots the absolute value of the coordinate. The default is
-ddd:mm:ss. Not all items may be plotted as this depends on the
-annotation interval.</dd>
-</dl>
-<dl class="docutils" id="format-geo-out">
-<dt><strong>FORMAT_GEO_OUT</strong></dt>
-<dd><p class="first">Formatting template that indicates how an output geographical
-coordinate is to be formatted. This template is then used to guide
-the writing of geographical coordinates in data fields. The template
-is in general of the form [+|-]D or [+|-]ddd[:mm[:ss]][.xxx][F].
-By default, longitudes will be reported in the range [-180,180]. The
-various terms have the following purpose:</p>
-<p>+D Output longitude in the range [0,360]</p>
-<p>-D Output longitude in the range [-360,0]</p>
-<p>D Use <strong>FORMAT_FLOAT_OUT</strong> for floating point degrees.</p>
-<p>ddd Fixed format integer degrees</p>
-<p>: delimiter used</p>
-<p>mm Fixed format integer arc minutes</p>
-<p>ss Fixed format integer arc seconds</p>
-<p>.xxx Floating fraction of previous integer field, fixed width.</p>
-<p>F Encode sign using WESN suffix</p>
-<p>G Same as F but with a leading space before suffix</p>
-<p class="last">The default is D.</p>
-</dd>
-</dl>
-<dl class="docutils" id="format-float-map">
-<dt><strong>FORMAT_FLOAT_MAP</strong></dt>
-<dd>Format (C language printf syntax) to be used when plotting double
-precision floating point numbers along plot frames and contours.
-For geographic coordinates, see <strong>FORMAT_GEO_MAP</strong>. [%.12lg].</dd>
-</dl>
-<dl class="docutils" id="format-float-out">
-<dt><strong>FORMAT_FLOAT_OUT</strong></dt>
-<dd>Format (C language printf syntax) to be used when printing double
-precision floating point numbers to output files. For geographic
-coordinates, see <strong>FORMAT_GEO_OUT</strong>. [%.12lg]. To give some
-columns a separate format, supply one or more comma-separated
-<em>cols</em>:<em>format</em> specifications, where <em>cols</em> can be specific columns
-(e.g., 5 for 6th since 0 is the first) or a range of columns (e.g.,
-3-7). The last specification without column information will
-override the format for all other columns.</dd>
-</dl>
-<dl class="docutils" id="format-time-primary-map">
-<dt><strong>FORMAT_TIME_PRIMARY_MAP</strong></dt>
-<dd>Controls how primary month-, week-, and weekday-names are formatted.
-Choose among <strong>full</strong>, <strong>abbreviated</strong>, and <strong>character</strong>. If the
-leading <strong>f</strong>, <strong>a</strong>, or <strong>c</strong> are replaced with <strong>F</strong>, <strong>A</strong>, and
-<strong>C</strong> the entire annotation will be in upper case [full].</dd>
-</dl>
-<dl class="docutils" id="format-time-secondary-map">
-<dt><strong>FORMAT_TIME_SECONDARY_MAP</strong></dt>
-<dd>Controls how secondary month-, week-, and weekday-names are
-formatted. Choose among <strong>full</strong>, <strong>abbreviated</strong>, and
-<strong>character</strong>. If the leading <strong>f</strong>, <strong>a</strong>, or <strong>c</strong> are replaced
-with <strong>F</strong>, <strong>A</strong>, and <strong>C</strong> the entire annotation will be in upper case [full].</dd>
-</dl>
-<dl class="docutils" id="format-time-stamp">
-<dt><strong>FORMAT_TIME_STAMP</strong></dt>
-<dd>Defines the format of the time information in the UNIX time stamp.
-This format is parsed by the C function <strong>strftime</strong>, so that
-virtually any text can be used (even not containing any time
-information) [%Y %b %d %H:%M:%S].</dd>
-</dl>
-<dl class="docutils" id="gmt-compatibility">
-<span id="gmt-miscellaneous-parameters"></span><dt><strong>GMT_COMPATIBILITY</strong></dt>
-<dd>Determines if this GMT version should be able to parse command-line
-options for a prior major release. Specify either 4 or 5. If 4 is
-set we will parse obsolete GMT 4 options and issue warnings; if 5
-is set then parsing GMT 4 only syntax will result in errors [4].</dd>
-</dl>
-<dl class="docutils" id="gmt-extrapolate-val">
-<dt><strong>GMT_EXTRAPOLATE_VAL</strong></dt>
-<dd>Determines what to do if extrapolating beyond the data domain.
-Choose among ‘NaN’, ‘extrap’ or ‘extrapval,val’ (without quotes). In
-the first case return NaN for any element of x that is outside range
-[Default]. Second case lets the selected algorithm compute the
-extrapolation values. Third case sets the extrapolation values to
-the constant value passed in ‘val’ (this value must off course be
-numeric).</dd>
-</dl>
-<dl class="docutils" id="gmt-custom-libs">
-<dt><strong>GMT_CUSTOM_LIBS</strong></dt>
-<dd>Comma-separated list of GMT-compliant shared libraries that extend
-the capability of GMT with additional custom modules [none]. Alternatively,
-provide a directory name, that MUST end with a slash (or back slash),
-to use all shared libraries in that directory. On Windows, if the dir
-name is made up only of a single slash (‘/’) search inside a subdirectory
-called ‘gmt_plugins’ of the directory that contains the ‘gmt’ executable.
-See the API documentation for how to build your own shared modules.</dd>
-</dl>
-<dl class="docutils" id="gmt-fft">
-<dt><strong>GMT_FFT</strong></dt>
-<dd>Determines which Fast Fourier Transform (FFT) should be used among
-those that have been configured during installation. Choose from
-<strong>auto</strong> (pick the most suitable for the task among available
-algorithms), <strong>fftw</strong>[,<em>planner_flag</em>] (The Fastest Fourier
-Transform in the West), <strong>accelerate</strong> (Use the Accelerate Framework
-under OS X; Note, that the number of samples to be processed must be
-a base 2 exponent), <strong>kiss</strong>, (Kiss FFT), <strong>brenner</strong> Brenner Legacy
-FFT [auto].
-FFTW can “learn” how to optimally compute Fourier transforms on the
-current hardware and OS by computing several FFTs and measuring
-their execution time. This so gained “Wisdom” will be stored in and
-reloaded from the file fftw_wisdom_<hostname> in $GMT_USERDIR or, if
-$GMT_USERDIR is not writable, in the current directory. To use this
-feature append <em>planner_flag</em>, which can be one of <em>measure</em>,
-<em>patient</em>, and <em>exhaustive</em>; see FFTW reference for details. The
-default FFTW planner flag is <em>estimate</em>, i.e., pick a (probably
-sub-optimal) plan quickly. Note: if you need a single transform of a
-given size only, the one-time cost of the smart planner becomes
-significant. In that case, stick to the default planner, <em>estimate</em>,
-based on heuristics.</dd>
-</dl>
-<dl class="docutils" id="gmt-history">
-<dt><strong>GMT_HISTORY</strong></dt>
-<dd>Passes the history of past common command options via the
-gmt.history file. The different values for this setting are:
-<strong>true</strong>, <strong>readonly</strong>, <strong>false</strong>, to either read and write to the
-gmt.history file, only read, or not use the file at all [true].</dd>
-</dl>
-<dl class="docutils" id="gmt-interpolant">
-<dt><strong>GMT_INTERPOLANT</strong></dt>
-<dd>Determines if linear (linear), Akima’s spline (akima), natural cubic
-spline (cubic) or no interpolation (none) should be used for 1-D
-interpolations in various programs [akima].</dd>
-</dl>
-<dl class="docutils" id="gmt-triangulate">
-<dt><strong>GMT_TRIANGULATE</strong></dt>
-<dd>Determines if we use the <strong>Watson</strong> [Default] or <strong>Shewchuk</strong>
-algorithm (if configured during installation) for triangulation.
-Note that Shewchuk is required for operations involving Voronoi
-constructions.</dd>
-</dl>
-<dl class="docutils" id="gmt-verbose">
-<dt><strong>GMT_VERBOSE</strong></dt>
-<dd>(<strong>-V</strong>) Determines the level of verbosity used by GMT
-programs. Choose among 6 levels; each level adds to the verbosity of
-the lower levels: <strong>q</strong>uiet, <strong>n</strong>normal (errors and warnings),
-<strong>c</strong>ompatibility warnings, <strong>v</strong>erbose progress reports, <strong>l</strong>ong
-verbose progress reports, <strong>d</strong>ebugging messages [c].</dd>
-</dl>
-<dl class="docutils" id="io-col-separator">
-<span id="i-o-parameters"></span><dt><strong>IO_COL_SEPARATOR</strong></dt>
-<dd>This setting determines what character will separate ASCII output
-data columns written by GMT. Choose from tab, space, comma, and
-none [tab].</dd>
-</dl>
-<dl class="docutils" id="io-gridfile-format">
-<dt><strong>IO_GRIDFILE_FORMAT</strong></dt>
-<dd>Default file format for grids, with optional scale, offset and
-invalid value, written as <em>ff</em>/<em>scale</em>/<em>offset</em>/<em>invalid</em>. The
-2-letter format indicator can be one of
-[<strong>abcegnrs</strong>][<strong>bsifd</strong>]. See
-<a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section 4.20 of the
-GMT Technical Reference and Cookbook for more information. The
-<em>scale</em> and <em>offset</em> modifiers may be left empty to select default
-values (scale = 1, offset = 0), or you may specify <em>a</em> for
-auto-adjusting the scale and/or offset of packed integer grids
-(=<em>id/a</em> is a shorthand for =<em>id/a/a</em>). When <em>invalid</em> is omitted
-the appropriate value for the given format is used (NaN or largest
-negative). [nf].</dd>
-</dl>
-<dl class="docutils" id="io-gridfile-shorthand">
-<dt><strong>IO_GRIDFILE_SHORTHAND</strong></dt>
-<dd>If true, all grid file names are examined to see if they use the
-file extension shorthand discussed in Section 4.17 of the GMT
-Technical Reference and Cookbook. If false, no filename expansion is
-done [false].</dd>
-</dl>
-<dl class="docutils" id="io-header">
-<dt><strong>IO_HEADER</strong></dt>
-<dd>(<strong>-h</strong>) Specifies whether input/output ASCII files have header
-record(s) or not [false].</dd>
-</dl>
-<dl class="docutils" id="io-lonlat-toggle">
-<dt><strong>IO_LONLAT_TOGGLE</strong></dt>
-<dd>(<strong>-:</strong>) Set if the first two columns of input and output files
-contain (latitude,longitude) or (y,x) rather than the expected
-(longitude,latitude) or (x,y). false means we have (x,y) both on
-input and output. true means both input and output should be (y,x).
-IN means only input has (y,x), while OUT means only output should be
-(y,x). [false].</dd>
-</dl>
-<dl class="docutils" id="io-n-header-recs">
-<dt><strong>IO_N_HEADER_RECS</strong></dt>
-<dd>Specifies how many header records to expect if <strong>-h</strong> is used [0].
-Note: This will skip the specified number of records regardless of
-what they are. Since any records starting with # is automatically
-considered a header you will only specify a non-zero number in order
-to skip headers that do not conform to that convention.</dd>
-</dl>
-<dl class="docutils" id="io-nan-records">
-<dt><strong>IO_NAN_RECORDS</strong></dt>
-<dd>Determines what happens when input records containing NaNs for <em>x</em>
-or <em>y</em> (and in some cases <em>z</em>) are read. Choose between <strong>skip</strong>,
-which will simply report how many bad records were skipped, and
-<strong>pass</strong> [Default], which will pass these records on to the calling
-programs. For most programs this will result in output records with
-NaNs as well, but some will interpret these NaN records to indicate
-gaps in a series; programs may then use that information to detect
-segmentation (if applicable).</dd>
-</dl>
-<dl class="docutils" id="io-nc4-chunk-size">
-<dt><strong>IO_NC4_CHUNK_SIZE</strong></dt>
-<dd>Sets the default chunk size for the <strong>lat</strong> and <strong>lon</strong> dimension of
-the <strong>z</strong> variable. Very large chunk sizes and sizes smaller than
-128 should be avoided because they can lead to unexpectedly bad
-performance. Note that a chunk of a single precision floating point
-variable of size 2896x2896 completely fills the chunk cache of
-32MiB. Specify the chunk size for each dimension separated by a
-comma, or <strong>a</strong>uto for optimally chosen chunk sizes in the range
-[128,256). Setting IO_NC4_CHUNK_SIZE will produce netCDF version 4
-files, which can only be read with the netCDF 4 library, unless all
-dimensions are less than 128 or <strong>c</strong>lassic is specified for
-classic netCDF. [auto]</dd>
-</dl>
-<dl class="docutils" id="io-nc4-deflation-level">
-<dt><strong>IO_NC4_DEFLATION_LEVEL</strong></dt>
-<dd>Sets the compression level for netCDF4 files upon output. Values
-allowed are integers from 0 (no compression) to 9 (maximum
-compression). Enabling a low compression level can dramatically
-improve performance and reduce the size of certain data. While
-higher compression levels further reduce the data size, they do so
-at the cost of extra processing time. This parameter does not
-apply to classic netCDF files. [3]</dd>
-</dl>
-<dl class="docutils" id="io-segment-marker">
-<dt><strong>IO_SEGMENT_MARKER</strong></dt>
-<dd>This holds the character we expect to indicate a segment header in
-an incoming ASCII data or text table [>]. If this marker should be
-different for output then append another character for the output
-segment marker. The two characters must be separated by a comma. Two
-marker characters have special meaning: B means “blank line” and
-will treat blank lines as initiating a new segment, whereas N means
-“NaN record” and will treat records with all NaNs as initiating a
-new segment. If you choose B or N for the output marker then the
-normal GMT segment header is replaced by a blank or NaN record,
-respectively, and no segment header information is written. To use B
-or N as regular segment markers you must escape them with a leading
-backslash.</dd>
-</dl>
-<dl class="docutils" id="map-annot-min-angle">
-<span id="map-parameters"></span><dt><strong>MAP_ANNOT_MIN_ANGLE</strong></dt>
-<dd>If the angle between the map boundary and the annotation baseline is
-less than this minimum value (in degrees), the annotation is not
-plotted (this may occur for certain oblique projections.) Give a
-value in the range [0,90]. [20]</dd>
-</dl>
-<dl class="docutils" id="map-annot-min-spacing">
-<dt><strong>MAP_ANNOT_MIN_SPACING</strong></dt>
-<dd>If an annotation would be plotted less than this minimum distance
-from its closest neighbor, the annotation is not plotted (this may
-occur for certain oblique projections.) [0p]</dd>
-</dl>
-<dl class="docutils" id="map-annot-oblique">
-<dt><strong>MAP_ANNOT_OBLIQUE</strong></dt>
-<dd>This integer is a sum of 6 bit flags (most of which only are
-relevant for oblique projections): If bit 1 is set (1),
-annotations will occur wherever a gridline crosses the map
-boundaries, else longitudes will be annotated on the lower and upper
-boundaries only, and latitudes will be annotated on the left and
-right boundaries only. If bit 2 is set (2), then
-longitude annotations will be plotted horizontally. If bit 3 is set
-(4), then latitude annotations will be plotted
-horizontally. If bit 4 is set (8), then oblique
-tick-marks are extended to give a projection equal to the specified
-tick length. If bit 5 is set (16), tick-marks will be drawn normal
-to the border regardless of gridline angle. If bit 6 is set (32),
-then latitude annotations will be plotted parallel to the border. To
-set a combination of these, add up the values in parentheses. [1].</dd>
-</dl>
-<dl class="docutils" id="map-annot-offset-primary">
-<dt><strong>MAP_ANNOT_OFFSET_PRIMARY</strong></dt>
-<dd>Distance from end of tick-mark to start of annotation [5p].</dd>
-</dl>
-<dl class="docutils" id="map-annot-offset-secondary">
-<dt><strong>MAP_ANNOT_OFFSET_SECONDARY</strong></dt>
-<dd>Distance from base of primary annotation to the top of the secondary
-annotation [5p] (Only applies to time axes with both primary and
-secondary annotations).</dd>
-</dl>
-<dl class="docutils" id="map-annot-ortho">
-<dt><strong>MAP_ANNOT_ORTHO</strong></dt>
-<dd>Determines which axes will get their annotations (for linear
-projections) plotted orthogonally to the axes. Combine any <strong>w</strong>,
-<strong>e</strong>, <strong>s</strong>, <strong>n</strong>, <strong>z</strong> (uppercase allowed as well). [we].</dd>
-</dl>
-<dl class="docutils" id="map-default-pen">
-<dt><strong>MAP_DEFAULT_PEN</strong></dt>
-<dd>Sets the default of all pens related to <strong>-W</strong> options. Prepend
-<strong>+</strong> to overrule the color of the parameters
-<strong>MAP_GRID_PEN_PRIMARY</strong>, <strong>MAP_GRID_PEN_SECONDARY</strong>,
-<strong>MAP_FRAME_PEN</strong>, <strong>MAP_TICK_PEN_PRIMARY</strong>, and
-<strong>MAP_TICK_PEN_SECONDARY</strong> by the color of <strong>MAP_DEFAULT_PEN</strong>
-[default,black].</dd>
-</dl>
-<dl class="docutils" id="map-degree-symbol">
-<dt><strong>MAP_DEGREE_SYMBOL</strong></dt>
-<dd>Determines what symbol is used to plot the degree symbol on
-geographic map annotations. Choose between ring, degree, colon, or
-none [ring].</dd>
-</dl>
-<dl class="docutils" id="map-frame-axes">
-<dt><strong>MAP_FRAME_AXES</strong></dt>
-<dd>Sets which axes to draw and annotate. Combine any uppercase <strong>W</strong>,
-<strong>E</strong>, <strong>S</strong>, <strong>N</strong>, <strong>Z</strong> to draw and annotate west, east, south,
-north and/or vertical (perspective view only) axis. Use lower case
-to draw the axis only, but not annotate. Add an optional <strong>+</strong> to
-draw a cube of axes in perspective view. [WESN].</dd>
-</dl>
-<dl class="docutils" id="map-frame-pen">
-<dt><strong>MAP_FRAME_PEN</strong></dt>
-<dd>Pen attributes used to draw plain map frame [thicker,black].</dd>
-</dl>
-<dl class="docutils" id="map-frame-type">
-<dt><strong>MAP_FRAME_TYPE</strong></dt>
-<dd>Choose between <strong>inside</strong>, <strong>plain</strong> and <strong>fancy</strong> (thick boundary,
-alternating black/white frame; append <strong>+</strong> for rounded corners)
-[fancy]. For some map projections (e.g., Oblique Mercator), plain is
-the only option even if fancy is set as default. In general, fancy
-only applies to situations where the projected x and y directions
-parallel the longitude and latitude directions (e.g., rectangular
-projections, polar projections). For situations where all boundary
-ticks and annotations must be inside the maps (e.g., for preparing
-geotiffs), chose <strong>inside</strong>.</dd>
-</dl>
-<dl class="docutils" id="map-frame-width">
-<dt><strong>MAP_FRAME_WIDTH</strong></dt>
-<dd>Width (> 0) of map borders for fancy map frame [5p].</dd>
-</dl>
-<dl class="docutils" id="map-grid-cross-size-primary">
-<dt><strong>MAP_GRID_CROSS_SIZE_PRIMARY</strong></dt>
-<dd>Size (>= 0) of grid cross at lon-lat intersections. 0 means draw
-continuous gridlines instead [0p].</dd>
-</dl>
-<dl class="docutils" id="map-grid-cross-size-secondary">
-<dt><strong>MAP_GRID_CROSS_SIZE_SECONDARY</strong></dt>
-<dd>Size (>= 0) of grid cross at secondary lon-lat intersections. 0
-means draw continuous gridlines instead [0p].</dd>
-</dl>
-<dl class="docutils" id="map-grid-pen-primary">
-<dt><strong>MAP_GRID_PEN_PRIMARY</strong></dt>
-<dd>Pen attributes used to draw primary grid lines in dpi units or
-points (append p) [default,black].</dd>
-</dl>
-<dl class="docutils" id="map-grid-pen-secondary">
-<dt><strong>MAP_GRID_PEN_SECONDARY</strong></dt>
-<dd>Pen attributes used to draw secondary grid lines in dpi units or
-points (append p) [thinner,black].</dd>
-</dl>
-<dl class="docutils" id="map-label-offset">
-<dt><strong>MAP_LABEL_OFFSET</strong></dt>
-<dd>Distance from base of axis annotations to the top of the axis label [8p].</dd>
-</dl>
-<dl class="docutils" id="map-line-step">
-<dt><strong>MAP_LINE_STEP</strong></dt>
-<dd>Determines the maximum length (> 0) of individual straight
-line-segments when drawing arcuate lines [0.75p]</dd>
-</dl>
-<dl class="docutils" id="map-logo">
-<dt><strong>MAP_LOGO</strong></dt>
-<dd>(<strong>-U</strong>) Specifies if a GMT logo with system timestamp should be
-plotted at the lower left corner of the plot [false].</dd>
-</dl>
-<dl class="docutils" id="map-logo-pos">
-<dt><strong>MAP_LOGO_POS</strong></dt>
-<dd>(<strong>-U</strong>) Sets the justification and the position of the
-logo/timestamp box relative to the current plots lower left corner
-of the plot [BL/-54p/-54p].</dd>
-</dl>
-<dl class="docutils" id="map-origin-x">
-<dt><strong>MAP_ORIGIN_X</strong></dt>
-<dd>(<strong>-X</strong>) Sets the x-coordinate of the origin on the paper for a
-new plot [1i]. For an overlay, the default offset is 0.</dd>
-</dl>
-<dl class="docutils" id="map-origin-y">
-<dt><strong>MAP_ORIGIN_Y</strong></dt>
-<dd>(<strong>-Y</strong>) Sets the y-coordinate of the origin on the paper for a
-new plot [1i]. For an overlay, the default offset is 0.</dd>
-</dl>
-<dl class="docutils" id="map-polar-cap">
-<dt><strong>MAP_POLAR_CAP</strong></dt>
-<dd>Controls the appearance of gridlines near the poles for all
-azimuthal projections and a few others in which the geographic poles
-are plotted as points (Lambert Conic, Hammer, Mollweide, Sinusoidal,
-and van der Grinten). Specify either none (in which case there is no
-special handling) or <em>pc_lat</em>/<em>pc_dlon</em>. In that case, normal
-gridlines are only drawn between the latitudes
--<em>pc_lat</em>/+*pc_lat*, and above those latitudes the gridlines are
-spaced at the (presumably coarser) <em>pc_dlon</em> interval; the two
-domains are separated by a small circle drawn at the <em>pc_lat</em>
-latitude [85/90]. Note for r-theta (polar) projection where r = 0 is
-at the center of the plot the meaning of the cap is reversed, i.e.,
-the default 85/90 will draw a r = 5 radius circle at the center of
-the map with less frequent radial lines there.</dd>
-</dl>
-<dl class="docutils" id="map-scale-height">
-<dt><strong>MAP_SCALE_HEIGHT</strong></dt>
-<dd>Sets the height (> 0) on the map of the map scale bars drawn by
-various programs [5p].</dd>
-</dl>
-<dl class="docutils" id="map-tick-length-primary">
-<dt><strong>MAP_TICK_LENGTH_PRIMARY</strong></dt>
-<dd>The length of a primary major/minor tick-marks [5p/2.5p]. If only
-the first value is set, the second is assumed to be 50% of the first.</dd>
-</dl>
-<dl class="docutils" id="map-tick-length-secondary">
-<dt><strong>MAP_TICK_LENGTH_SECONDARY</strong></dt>
-<dd>The length of a secondary major/minor tick-marks [15p/3.75p]. If
-only the first value is set, the second is assumed to be 25% of the first.</dd>
-</dl>
-<dl class="docutils" id="map-tick-pen-primary">
-<dt><strong>MAP_TICK_PEN_PRIMARY</strong></dt>
-<dd>Pen attributes to be used for primary tick-marks in dpi units or
-points (append p) [thinner,black].</dd>
-</dl>
-<dl class="docutils" id="map-tick-pen-secondary">
-<dt><strong>MAP_TICK_PEN_SECONDARY</strong></dt>
-<dd>Pen attributes to be used for secondary tick-marks in dpi units or
-points (append p) [thinner,black].</dd>
-</dl>
-<dl class="docutils" id="map-title-offset">
-<dt><strong>MAP_TITLE_OFFSET</strong></dt>
-<dd>Distance from top of axis annotations (or axis label, if present) to
-base of plot title [14p].</dd>
-</dl>
-<dl class="docutils" id="map-vector-shape">
-<dt><strong>MAP_VECTOR_SHAPE</strong></dt>
-<dd>Determines the shape of the head of a vector. Normally (i.e., for
-vector_shape = 0), the head will be triangular, but can be changed
-to an arrow (1) or an open V (2).
-Intermediate settings give something in between. Negative values (up
-to -2) are allowed as well [0].</dd>
-</dl>
-<dl class="docutils" id="proj-aux-latitude">
-<dt><strong>PROJ_AUX_LATITUDE</strong></dt>
-<dd>Only applies when geodesics are approximated by great circle
-distances on an equivalent sphere. Select from authalic, geocentric,
-conformal, meridional, parametric, or none [authalic]. When not none
-we convert any latitude used in the great circle calculation to the
-chosen auxiliary latitude before doing the distance calculation. See
-also <strong>PROJ_MEAN_RADIUS</strong>.</dd>
-</dl>
-<dl class="docutils" id="proj-ellipsoid">
-<span id="projection-parameters"></span><dt><strong>PROJ_ELLIPSOID</strong></dt>
-<dd>The (case sensitive) name of the ellipsoid used for the map projections [WGS-84]. Choose among:</dd>
-</dl>
-<div class="line-block">
-<div class="line"><br /></div>
-<div class="line-block">
-<div class="line"><em>Airy</em>: Applies to Great Britain (1830)</div>
-<div class="line"><em>Airy-Ireland</em>: Applies to Ireland in 1965 (1830)</div>
-<div class="line"><em>Andrae</em>: Applies to Denmark and Iceland (1876)</div>
-<div class="line"><em>APL4.9</em>: Appl. Physics (1965)</div>
-<div class="line"><em>ATS77</em>: Average Terrestrial System, Canada Maritime provinces (1977)</div>
-<div class="line"><em>Australian</em>: Applies to Australia (1965)</div>
-<div class="line"><em>Bessel</em>: Applies to Central Europe, Chile, Indonesia (1841)</div>
-<div class="line"><em>Bessel-Namibia</em>: Same as Bessel-Schwazeck (1841)</div>
-<div class="line"><em>Bessel-NGO1948</em>: Modified Bessel for NGO 1948 (1841)</div>
-<div class="line"><em>Bessel-Schwazeck</em>: Applies to Namibia (1841)</div>
-<div class="line"><em>Clarke-1858</em>: Clarke’s early ellipsoid (1858)</div>
-<div class="line"><em>Clarke-1866</em>: Applies to North America, the Philippines (1866)</div>
-<div class="line"><em>Clarke-1866-Michigan</em>: Modified Clarke-1866 for Michigan (1866)</div>
-<div class="line"><em>Clarke-1880</em>: Applies to most of Africa, France (1880)</div>
-<div class="line"><em>Clarke-1880-Arc1950</em>: Modified Clarke-1880 for Arc 1950 (1880)</div>
-<div class="line"><em>Clarke-1880-IGN</em>: Modified Clarke-1880 for IGN (1880)</div>
-<div class="line"><em>Clarke-1880-Jamaica</em>: Modified Clarke-1880 for Jamaica (1880)</div>
-<div class="line"><em>Clarke-1880-Merchich</em>: Modified Clarke-1880 for Merchich (1880)</div>
-<div class="line"><em>Clarke-1880-Palestine</em>: Modified Clarke-1880 for Palestine (1880)</div>
-<div class="line"><em>CPM</em>: Comm. des Poids et Mesures, France (1799)</div>
-<div class="line"><em>Delambre</em>: Applies to Belgium (1810)</div>
-<div class="line"><em>Engelis</em>: Goddard Earth Models (1985)</div>
-<div class="line"><em>Everest-1830</em>: India, Burma, Pakistan, Afghanistan, Thailand (1830)</div>
-<div class="line"><em>Everest-1830-Kalianpur</em>: Modified Everest for Kalianpur (1956) (1830)</div>
-<div class="line"><em>Everest-1830-Kertau</em>: Modified Everest for Kertau, Malaysia & Singapore (1830)</div>
-<div class="line"><em>Everest-1830-Pakistan</em>: Modified Everest for Pakistan (1830)</div>
-<div class="line"><em>Everest-1830-Timbalai</em>: Modified Everest for Timbalai, Sabah Sarawak (1830)</div>
-<div class="line"><em>Fischer-1960</em>: Used by NASA for Mercury program (1960)</div>
-<div class="line"><em>Fischer-1960-SouthAsia</em>: Same as Modified-Fischer-1960 (1960)</div>
-<div class="line"><em>Fischer-1968</em>: Used by NASA for Mercury program (1968)</div>
-<div class="line"><em>FlatEarth</em>: As Sphere, but implies fast “Flat Earth” distance calculations (1984)</div>
-<div class="line"><em>GRS-67</em>: International Geodetic Reference System (1967)</div>
-<div class="line"><em>GRS-80</em>: International Geodetic Reference System (1980)</div>
-<div class="line"><em>Hayford-1909</em>: Same as the International 1924 (1909)</div>
-<div class="line"><em>Helmert-1906</em>: Applies to Egypt (1906)</div>
-<div class="line"><em>Hough</em>: Applies to the Marshall Islands (1960)</div>
-<div class="line"><em>Hughes-1980</em>: Hughes Aircraft Company for DMSP SSM/I grid products (1980)</div>
-<div class="line"><em>IAG-75</em>: International Association of Geodesy (1975)</div>
-<div class="line"><em>Indonesian</em>: Applies to Indonesia (1974)</div>
-<div class="line"><em>International-1924</em>: Worldwide use (1924)</div>
-<div class="line"><em>International-1967</em>: Worldwide use (1967)</div>
-<div class="line"><em>Kaula</em>: From satellite tracking (1961)</div>
-<div class="line"><em>Krassovsky</em>: Used in the (now former) Soviet Union (1940)</div>
-<div class="line"><em>Lerch</em>: For geoid modelling (1979)</div>
-<div class="line"><em>Maupertius</em>: Really old ellipsoid used in France (1738)</div>
-<div class="line"><em>Mercury-1960</em>: Same as Fischer-1960 (1960)</div>
-<div class="line"><em>MERIT-83</em>: United States Naval Observatory (1983)</div>
-<div class="line"><em>Modified-Airy</em>: Same as Airy-Ireland (1830)</div>
-<div class="line"><em>Modified-Fischer-1960</em>: Applies to Singapore (1960)</div>
-<div class="line"><em>Modified-Mercury-1968</em>: Same as Fischer-1968 (1968)</div>
-<div class="line"><em>NWL-10D</em>: Naval Weapons Lab (Same as WGS-72) (1972)</div>
-<div class="line"><em>NWL-9D</em>: Naval Weapons Lab (Same as WGS-66) (1966)</div>
-<div class="line"><em>OSU86F</em>: Ohio State University (1986)</div>
-<div class="line"><em>OSU91A</em>: Ohio State University (1991)</div>
-<div class="line"><em>Plessis</em>: Old ellipsoid used in France (1817)</div>
-<div class="line"><em>SGS-85</em>: Soviet Geodetic System (1985)</div>
-<div class="line"><em>South-American</em>: Applies to South America (1969)</div>
-<div class="line"><em>Sphere</em>: The mean radius in WGS-84 (for spherical/plate tectonics applications) (1984)</div>
-<div class="line"><em>Struve</em>: Friedrich Georg Wilhelm Struve (1860)</div>
-<div class="line"><em>TOPEX</em>: Used commonly for altimetry (1990)</div>
-<div class="line"><em>Walbeck</em>: First least squares solution by Finnish astronomer (1819)</div>
-<div class="line"><em>War-Office</em>: Developed by G. T. McCaw (1926)</div>
-<div class="line"><em>WGS-60</em>: World Geodetic System (1960)</div>
-<div class="line"><em>WGS-66</em>: World Geodetic System (1966)</div>
-<div class="line"><em>WGS-72</em>: World Geodetic System (1972)</div>
-<div class="line"><em>WGS-84</em>: World Geodetic System [Default] (1984)</div>
-<div class="line"><em>Moon</em>: Moon (IAU2000) (2000)</div>
-<div class="line"><em>Mercury</em>: Mercury (IAU2000) (2000)</div>
-<div class="line"><em>Venus</em>: Venus (IAU2000) (2000)</div>
-<div class="line"><em>Mars</em>: Mars (IAU2000) (2000)</div>
-<div class="line"><em>Jupiter</em>: Jupiter (IAU2000) (2000)</div>
-<div class="line"><em>Saturn</em>: Saturn (IAU2000) (2000)</div>
-<div class="line"><em>Uranus</em>: Uranus (IAU2000) (2000)</div>
-<div class="line"><em>Neptune</em>: Neptune (IAU2000) (2000)</div>
-<div class="line"><em>Pluto</em>: Pluto (IAU2000) (2000)</div>
-</div>
-</div>
-<blockquote>
-<div><p>Note that for some global projections, GMT may use a spherical
-approximation of the ellipsoid chosen, setting the flattening to
-zero, and using a mean radius. A warning will be given when this
-happens. If a different ellipsoid name than those mentioned here is
-given, GMT will attempt to parse the name to extract the
-semi-major axis (<em>a</em> in m) and the flattening. Formats allowed are:</p>
-<p><em>a</em> implies a zero flattening</p>
-<p><em>a</em>,<em>inv_f</em> where <em>inv_f</em> is the inverse flattening</p>
-<p><em>a</em>,<strong>b=</strong><em>b</em> where <em>b</em> is the semi-minor axis (in m)</p>
-<p><em>a</em>,<strong>f=</strong><em>f</em> where <em>f</em> is the flattening</p>
-<p>This way a custom ellipsoid (e.g., those used for other planets) may
-be used. Further note that coordinate transformations in
-<strong>mapproject</strong> can also specify specific datums; see the
-<a class="reference internal" href="mapproject.html"><em>mapproject</em></a> man page for further details and how to view
-ellipsoid and datum parameters.</p>
-</div></blockquote>
-<dl class="docutils" id="proj-length-unit">
-<dt><strong>PROJ_LENGTH_UNIT</strong></dt>
-<dd>Sets the unit length. Choose between <strong>c</strong>m, <strong>i</strong>nch, or
-<strong>p</strong>oint [c (or i)]. Note that, in GMT, one point is defined
-as 1/72 inch (the PostScript definition), while it is often
-defined as 1/72.27 inch in the typesetting industry. There is no
-universal definition.</dd>
-</dl>
-<dl class="docutils" id="proj-mean-radius">
-<dt><strong>PROJ_MEAN_RADIUS</strong></dt>
-<dd>Applies when geodesics are approximated by great circle distances on
-an equivalent sphere or when surface areas are computed. Select from
-mean (R_1), authalic (R_2), volumetric (R_3), meridional, or
-quadratic [authalic]. See also PROJ_MEAN_RADIUS.</dd>
-</dl>
-<dl class="docutils" id="proj-scale-factor">
-<dt><strong>PROJ_SCALE_FACTOR</strong></dt>
-<dd>Changes the default map scale factor used for the Polar
-Stereographic [0.9996], UTM [0.9996], and Transverse Mercator [1]
-projections in order to minimize areal distortion. Provide a new
-scale-factor or leave as default.</dd>
-</dl>
-<dl class="docutils" id="ps-char-encoding">
-<span id="postscript-parameters"></span><dt><strong>PS_CHAR_ENCODING</strong></dt>
-<dd>(static) Names the eight bit character set being used for text in
-files and in command line parameters. This allows GMT to ensure
-that the PostScript output generates the correct characters on the
-plot.. Choose from Standard, Standard+, ISOLatin1, ISOLatin1+, and
-ISO-8859-x (where x is in the ranges [1,10] or [13,15]). See
-Appendix F for details [ISOLatin1+ (or Standard+)].</dd>
-</dl>
-<dl class="docutils" id="ps-color-model">
-<dt><strong>PS_COLOR_MODEL</strong></dt>
-<dd>Determines whether PostScript output should use RGB, HSV, CMYK, or
-GRAY when specifying color [rgb]. Note if HSV is selected it does
-not apply to images which in that case uses RGB. When selecting
-GRAY, all colors will be converted to gray scale using YIQ
-(television) conversion.</dd>
-</dl>
-<dl class="docutils" id="ps-comments">
-<dt><strong>PS_COMMENTS</strong></dt>
-<dd>(static) If true we will issue comments in the PostScript file
-that explain the logic of operations. These are useful if you need
-to edit the file and make changes; otherwise you can set it to false
-which yields a somewhat slimmer PostScript file [false].</dd>
-</dl>
-<dl class="docutils" id="ps-image-compress">
-<dt><strong>PS_IMAGE_COMPRESS</strong></dt>
-<dd>Determines if PostScript images are compressed using the Run-Length
-Encoding scheme (rle), Lempel-Ziv-Welch compression (lzw), DEFLATE
-compression (deflate[,level]), or not at all (none) [deflate,5]. When
-specifying deflate, the compression level (1–9) may optionally be
-appended.</dd>
-</dl>
-<dl class="docutils" id="ps-line-cap">
-<dt><strong>PS_LINE_CAP</strong></dt>
-<dd>Determines how the ends of a line segment will be drawn. Choose
-among a <em>butt</em> cap (default) where there is no projection beyond the
-end of the path, a <em>round</em> cap where a semicircular arc with
-diameter equal to the line-width is drawn around the end points, and
-<em>square</em> cap where a half square of size equal to the line-width
-extends beyond the end of the path [butt].</dd>
-</dl>
-<dl class="docutils" id="ps-line-join">
-<dt><strong>PS_LINE_JOIN</strong></dt>
-<dd>Determines what happens at kinks in line segments. Choose among a
-<em>miter</em> join where the outer edges of the strokes for the two
-segments are extended until they meet at an angle (as in a picture
-frame; if the angle is too acute, a bevel join is used instead, with
-threshold set by <strong>PS_MITER_LIMIT</strong>), <em>round</em> join where a
-circular arc is used to fill in the cracks at the kinks, and <em>bevel</em>
-join which is a miter join that is cut off so kinks are triangular in shape [miter].</dd>
-</dl>
-<dl class="docutils" id="ps-media">
-<dt><strong>PS_MEDIA</strong></dt>
-<dd><p class="first">Sets the physical format of the current plot paper [a4 (or letter)].
-The following formats (and their widths and heights in points) are
-recognized (Additional site-specific formats may be specified in the
-gmt_custom_media.conf file in <strong>$GMT_SHAREDIR</strong>/conf or ~/.gmt;
-see that file for details):</p>
-<p>Media width height</p>
-<ul class="simple">
-<li>A0 2380 3368</li>
-<li>A1 1684 2380</li>
-<li>A2 1190 1684</li>
-<li>A3 842 1190</li>
-<li>A4 595 842</li>
-<li>A5 421 595</li>
-<li>A6 297 421</li>
-<li>A7 210 297</li>
-<li>A8 148 210</li>
-<li>A9 105 148</li>
-<li>A10 74 105</li>
-<li>B0 2836 4008</li>
-<li>B1 2004 2836</li>
-<li>B2 1418 2004</li>
-<li>B3 1002 1418</li>
-<li>B4 709 1002</li>
-<li>B5 501 709</li>
-<li>archA 648 864</li>
-<li>archB 864 1296</li>
-<li>archC 1296 1728</li>
-<li>archD 1728 2592</li>
-<li>archE 2592 3456</li>
-<li>flsa 612 936</li>
-<li>halfletter 396 612</li>
-<li>statement 396 612</li>
-<li>note 540 720</li>
-<li>letter 612 792</li>
-<li>legal 612 1008</li>
-<li>11x17 792 1224</li>
-<li>tabloid 792 1224</li>
-<li>ledger 1224 792</li>
-</ul>
-<p class="last">For a completely custom format (e.g., for large format plotters) you
-may also specify WxH, where W and H are in points unless you append
-a unit to each dimension (<strong>c</strong>, <strong>i</strong>, <strong>m</strong> or <strong>p</strong> [Default]).</p>
-</dd>
-</dl>
-<dl class="docutils" id="ps-miter-limit">
-<dt><strong>PS_MITER_LIMIT</strong></dt>
-<dd>Sets the threshold angle in degrees (integer in range [0,180]) used
-for mitered joins only. When the angle between joining line segments
-is smaller than the threshold the corner will be bevelled instead of
-mitered. The default threshold is 35 degrees. Setting the threshold
-angle to 0 implies the PostScript default of about 11 degrees.
-Setting the threshold angle to 180 causes all joins to be beveled.</dd>
-</dl>
-<dl class="docutils" id="ps-page-color">
-<dt><strong>PS_PAGE_COLOR</strong></dt>
-<dd>Sets the color of the imaging background, i.e., the paper [white].</dd>
-</dl>
-<dl class="docutils" id="ps-page-orientation">
-<dt><strong>PS_PAGE_ORIENTATION</strong></dt>
-<dd>(<strong>* -P</strong>) Sets the orientation of the page. Choose portrait or
-landscape [landscape].</dd>
-</dl>
-<dl class="docutils" id="ps-scale-x">
-<dt><strong>PS_SCALE_X</strong></dt>
-<dd>Global x-scale (> 0) to apply to plot-coordinates before plotting.
-Normally used to shrink the entire output down to fit a specific
-height/width [1.0].</dd>
-</dl>
-<dl class="docutils" id="ps-scale-y">
-<dt><strong>PS_SCALE_Y</strong></dt>
-<dd>Global y-scale (> 0) to apply to plot-coordinates before plotting.
-Normally used to shrink the entire output down to fit a specific
-height/width [1.0].</dd>
-</dl>
-<dl class="docutils" id="ps-transparency">
-<dt><strong>PS_TRANSPARENCY</strong></dt>
-<dd>Sets the transparency mode to use when preparing PS for rendering to
-PDF. Choose from Color, ColorBurn, ColorDodge, Darken, Difference,
-Exclusion, HardLight, Hue, Lighten, Luminosity, Multiply, Normal,
-Overlay, Saturation, SoftLight, and Screen [Normal].</dd>
-</dl>
-<dl class="docutils" id="time-epoch">
-<span id="calendar-time-parameters"></span><dt><strong>TIME_EPOCH</strong></dt>
-<dd>Specifies the value of the calendar and clock at the origin (zero
-point) of relative time units (see <strong>TIME_UNIT</strong>). It is a string
-of the form yyyy-mm-ddT[hh:mm:ss] (Gregorian) or
-yyyy-Www-ddT[hh:mm:ss] (ISO) Default is 1970-01-01T00:00:00, the
-origin of the UNIX time epoch.</dd>
-</dl>
-<dl class="docutils" id="time-interval-fraction">
-<dt><strong>TIME_INTERVAL_FRACTION</strong></dt>
-<dd>Determines if partial intervals at the start and end of an axis
-should be annotated. If the range of the partial interval exceeds
-the specified fraction of the normal interval stride we will place
-the annotation centered on the partial interval [0.5].</dd>
-</dl>
-<dl class="docutils" id="time-is-interval">
-<dt><strong>TIME_IS_INTERVAL</strong></dt>
-<dd>Used when input calendar data should be truncated and adjusted to
-the middle of the relevant interval. In the following discussion,
-the unit <strong>u</strong> can be one of these time units: (<strong>y</strong> year, <strong>o</strong>
-month, <strong>u</strong> ISO week, <strong>d</strong> day, <strong>h</strong> hour, <strong>m</strong> minute, and
-<strong>s</strong> second). <strong>TIME_IS_INTERVAL</strong> can have any of the following
-three values: (1) OFF [Default]. No adjustment, time is decoded as
-given. (2) +<em>n</em><strong>u</strong>. Activate interval adjustment for input by
-truncate to previous whole number of <em>n</em> units and then center time
-on the following interval. (3) -<em>n</em><strong>u</strong>. Same, but center time on
-the previous interval. For example, with <strong>TIME_IS_INTERVAL</strong> =
-+1o, an input data string like 1999-12 will be interpreted to mean
-1999-12-15T12:00:00.0 (exactly middle of December), while if
-<strong>TIME_IS_INTERVAL</strong> = off then that date is interpreted to mean
-1999-12-01T00:00:00.0 (start of December) [off].</dd>
-</dl>
-<dl class="docutils" id="time-language">
-<dt><strong>TIME_LANGUAGE</strong></dt>
-<dd><p class="first">Language to use when plotting calendar items such as months and
-days. Select from:</p>
-<ul class="simple">
-<li>BR Brazilian Portuguese</li>
-<li>CN1 Simplified Chinese</li>
-<li>CN2 Traditional Chinese</li>
-<li>DE German</li>
-<li>DK Danish</li>
-<li>EH Basque</li>
-<li>ES Spanish</li>
-<li>FI Finnish</li>
-<li>FR French</li>
-<li>GR Greek</li>
-<li>HI Hawaiian</li>
-<li>HU Hungarian</li>
-<li>IE Irish</li>
-<li>IL Hebrew</li>
-<li>IS Icelandic</li>
-<li>IT Italian</li>
-<li>JP Japanese</li>
-<li>NL Dutch</li>
-<li>NO Norwegian</li>
-<li>PL Polish</li>
-<li>PT Portuguese</li>
-<li>RU Russian</li>
-<li>SE Swedish</li>
-<li>SG Scottish Gaelic</li>
-<li>TO Tongan</li>
-<li>TR Turkish</li>
-<li>UK British English</li>
-<li>US US English</li>
-</ul>
-<p class="last">If your language is not supported, please examine the
-<strong>$GMT_SHAREDIR</strong>/time/us.d file and make a similar file. Please
-submit it to the GMT Developers for official inclusion. Custom
-language files can be placed in directories <strong>$GMT_SHAREDIR</strong>/time
-or ~/.gmt. Note: Some of these languages may require you to also
-change the <strong>PS_CHAR_ENCODING</strong> setting.</p>
-</dd>
-</dl>
-<dl class="docutils" id="time-system">
-<dt><strong>TIME_SYSTEM</strong></dt>
-<dd><p class="first">Shorthand for a combination of <strong>TIME_EPOCH</strong> and <strong>TIME_UNIT</strong>,
-specifying which time epoch the relative time refers to and what the
-units are. Choose from one of the preset systems below (epoch and
-units are indicated):</p>
-<p>JD -4713-11-25T12:00:00 d (Julian Date)</p>
-<p>MJD 1858-11-17T00:00:00 d (Modified Julian Date)</p>
-<p>J2000 2000-01-01T12:00:00 d (Astronomical time)</p>
-<p>S1985 1985-01-01T00:00:00 s (Altimetric time)</p>
-<p>UNIX 1970-01-01T00:00:00 s (UNIX time)</p>
-<p>RD0001 0001-01-01T00:00:00 s</p>
-<p>RATA 0000-12-31T00:00:00 d</p>
-<p class="last">This parameter is not stored in the <strong>gmt.conf</strong> file but is
-translated to the respective values of <strong>TIME_EPOCH</strong> and
-<strong>TIME_UNIT</strong>.</p>
-</dd>
-</dl>
-<dl class="docutils" id="time-unit">
-<dt><strong>TIME_UNIT</strong></dt>
-<dd>Specifies the units of relative time data since epoch (see
-<strong>TIME_EPOCH</strong>). Choose y (year - assumes all years are 365.2425
-days), o (month - assumes all months are of equal length y/12), d
-(day), h (hour), m (minute), or s (second) [s].</dd>
-</dl>
-<dl class="docutils" id="time-week-start">
-<dt><strong>TIME_WEEK_START</strong></dt>
-<dd>When weeks are indicated on time axes, this parameter determines the
-first day of the week for Gregorian calendars. (The ISO weekly
-calendar always begins weeks with Monday.) [Monday (or Sunday)].</dd>
-</dl>
-<dl class="docutils" id="time-y2k-offset-year">
-<dt><strong>TIME_Y2K_OFFSET_YEAR</strong></dt>
-<dd>When 2-digit years are used to represent 4-digit years (see various
-<strong>FORMAT_DATE</strong>s), <strong>TIME_Y2K_OFFSET_YEAR</strong> gives the first
-year in a 100-year sequence. For example, if
-<strong>TIME_Y2K_OFFSET_YEAR</strong> is 1729, then numbers 29 through 99
-correspond to 1729 through 1799, while numbers 00 through 28
-correspond to 1800 through 1828. [1950].</dd>
-</dl>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a> , <a class="reference internal" href="gmtdefaults.html"><em>gmtdefaults</em></a> ,
-<a class="reference internal" href="gmtcolors.html"><em>gmtcolors</em></a> , <a class="reference internal" href="gmtget.html"><em>gmtget</em></a> ,
-<a class="reference internal" href="gmtset.html"><em>gmtset</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">gmt.conf</a><ul>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#common-specifications">Common Specifications</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="GM.html"
- title="previous chapter">GM</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="gmt.html"
- title="next chapter">gmt</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/gmt.conf.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="gmt.html" title="gmt"
- >next</a> </li>
- <li class="right" >
- <a href="GM.html" title="GM"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" >GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gmt.html b/doc_release/html/gmt.html
deleted file mode 100644
index 06f8396..0000000
--- a/doc_release/html/gmt.html
+++ /dev/null
@@ -1,1559 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>gmt — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GM" href="GM.html" />
- <link rel="next" title="gmt2kml" href="gmt2kml.html" />
- <link rel="prev" title="gmt.conf" href="gmt.conf.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="gmt2kml.html" title="gmt2kml"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="gmt.conf.html" title="gmt.conf"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" accesskey="U">GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gmt">
-<span id="index-0"></span><h1>gmt<a class="headerlink" href="#gmt" title="Permalink to this headline">¶</a></h1>
-<p>gmt - The Generic Mapping Tools data processing and display software package</p>
-<div class="section" id="introduction">
-<h2>Introduction<a class="headerlink" href="#introduction" title="Permalink to this headline">¶</a></h2>
-<p>GMT is a collection of public-domain Unix tools that allows you to
-manipulate x,y and x,y,z data sets (filtering, trend fitting, gridding,
-projecting, etc.) and produce PostScript illustrations ranging from
-simple x-y plots, via contour maps, to artificially illuminated surfaces
-and 3-D perspective views in black/white or full color. Linear, log10,
-and power scaling is supported in addition to over 30 common map
-projections. The processing and display routines within GMT are
-completely general and will handle any (x,y) or (x,y,z) data as input.</p>
-</div>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmt</strong> is the main program that can start any of the modules:</p>
-<p><strong>gmt</strong> module module-options</p>
-<p>where module is the name of a GMT module and the options are those
-that pertain to that particular module. If no module is given then
-several other options are available:</p>
-<dl class="docutils">
-<dt><strong>-</strong><strong>-help</strong></dt>
-<dd>List and description of GMT modules.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Show data directory and exit.</dd>
-<dt><strong>-</strong><strong>-show-bindir</strong></dt>
-<dd>Show directory of executables and exit.</dd>
-<dt><strong>=</strong></dt>
-<dd>Check if that module exist and if so the
-program will exit with status of 0; otherwise the status of exit will
-be non-zero.</dd>
-</dl>
-</div>
-<div class="section" id="command-line-completion">
-<h2>Command-line completion<a class="headerlink" href="#command-line-completion" title="Permalink to this headline">¶</a></h2>
-<p>GMT provides basic command-line completion (tab completion) for bash.
-The completion rules are either installed in <tt class="docutils literal"><span class="pre">/etc/bash_completion.d/gmt</span></tt>
-or <tt class="docutils literal"><span class="pre"><prefix>/share/tools/gmt_completion.bash</span></tt>. Depending on the
-distribution, you may still need to source the gmt completion file from
-<tt class="docutils literal"><span class="pre">~/.bash_completion</span></tt> or <tt class="docutils literal"><span class="pre">~/.bashrc</span></tt>. For more information see Section
-<a class="reference internal" href="GMT_Docs.html#command-line-completion"><em>Command-line completion</em></a> in the CookBook.</p>
-</div>
-<div class="section" id="gmt-overview">
-<h2>GMT Overview<a class="headerlink" href="#gmt-overview" title="Permalink to this headline">¶</a></h2>
-<p>The following is a summary of all the programs supplied with GMT and
-a very short description of their purpose. Detailed information about
-each program can be found in the separate manual pages.</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="46%" />
-<col width="54%" />
-</colgroup>
-<tbody valign="top">
-<tr class="row-odd"><td><strong>blockmean</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>blockmedian</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>blockmode</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>filter1d</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>fitcircle</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>gmt2kml</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>gmtconnect</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>gmtconvert</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>gmtdefaults</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>gmtget</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>gmtinfo</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>gmtmath</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>gmtselect</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>gmtset</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>gmtspatial</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>gmtsimplify</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>gmtvector</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>gmtwhich</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>grd2cpt</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>grd2rgb</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>grd2xyz</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>grdblend</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>grdclip</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>grdcontour</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>grdcut</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>grdedit</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>grdfft</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>grdfilter</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>grdgradient</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>grdhisteq</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>grdimage</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>grdinfo</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>grdlandmask</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>grdmask</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>grdmath</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>grdpaste</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>grdproject</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>grdreformat</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>grdraster</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>grdsample</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>grdtrack</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>grdtrend</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>grdvector</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>grdview</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>grdvolume</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>greenspline</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>kml2gmt</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>makecpt</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>mapproject</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>nearneighbor</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>project</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>ps2raster</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>psbasemap</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>psclip</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>pscoast</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>pscontour</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>pshistogram</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>psimage</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>pslegend</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>psmask</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>psrose</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>psscale</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>pstext</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>pswiggle</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>psxy</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>psxyz</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>sample1d</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>spectrum1d</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>splitxyz</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>surface</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>trend1d</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>trend2d</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>triangulate</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>xyz2grd</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>Supplement <em>gshhg</em>:</td>
-</tr>
-<tr class="row-even"><td><strong>gshhg</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>Supplement <em>img</em>:</td>
-</tr>
-<tr class="row-even"><td><strong>img2grd</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>Supplement <em>meca</em>:</td>
-</tr>
-<tr class="row-even"><td><strong>pscoupe</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>psmeca</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>pspolar</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>psvelo</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>Supplement <em>mgd77</em>:</td>
-</tr>
-<tr class="row-odd"><td><strong>mgd77convert</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>mgd77info</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>mgd77list</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>mgd77magref</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>mgd77manage</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>mgd77path</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>mgd77sniffer</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>mgd77track</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td> </td>
-<td>Supplement <em>potential</em>:</td>
-</tr>
-<tr class="row-even"><td><strong>gmtgravmag3d</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>gravfft</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>grdgravmag3d</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>redpol</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>Supplement <em>segy</em>:</td>
-</tr>
-<tr class="row-odd"><td><strong>pssegy</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>pssegyz</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>segy2grd</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>Supplement <em>sph</em>:</td>
-</tr>
-<tr class="row-odd"><td><strong>sphdistance</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>sphinterpolate</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>sphtriangulate</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>Supplement <em>spotter</em>:</td>
-</tr>
-<tr class="row-odd"><td><strong>backtracker</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>grdpmodeler</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>grdrotater</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>grdspotter</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>hotspotter</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>originator</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>rotconverter</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td> </td>
-<td>Supplement <em>x2sys</em>:</td>
-</tr>
-<tr class="row-odd"><td><strong>x2sys_binlist</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>x2sys_cross</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>x2sys_datalist</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>x2sys_get</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>x2sys_init</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>x2sys_list</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>x2sys_merge</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>x2sys_put</strong></td>
-<td> </td>
-</tr>
-<tr class="row-odd"><td><strong>x2sys_report</strong></td>
-<td> </td>
-</tr>
-<tr class="row-even"><td><strong>x2sys_solve</strong></td>
-<td> </td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="custom-modules">
-<h2>Custom Modules<a class="headerlink" href="#custom-modules" title="Permalink to this headline">¶</a></h2>
-<p>The <strong>gmt</strong> program can also load custom modules from shared libraries
-built as specified in the GMT API documentation. This way your modules
-can benefit form the GMT infrastructure and extend GMT in specific ways.</p>
-</div>
-<div class="section" id="the-common-gmt-options">
-<h2>The Common GMT Options<a class="headerlink" href="#the-common-gmt-options" title="Permalink to this headline">¶</a></h2>
-<p><strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em>
-<strong>-J</strong><em>parameters</em>
-<strong>-Jz</strong>|<strong>Z</strong><em>parameters</em> <strong>-K</strong> <strong>-O</strong> <strong>-P</strong>
-<strong>-R</strong><em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]
-<strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>]
-<strong>-V</strong>[<em>level</em>]
-<strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]]
-<strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]]
-<strong>-a</strong><em>col</em>=<em>name</em>[<em>...</em>]
-<strong>-b</strong>[<strong>i</strong>|<strong>o</strong>][<em>ncol</em>][<strong>type</strong>][w][<strong>+L</strong>|<strong>+B</strong>]
-<strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em>
-<strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>]
-<strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>]
-<strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...]
-<strong>-o</strong><em>cols</em>[,...]
-<strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>]
-<strong>-r</strong>
-<strong>-s</strong>[<em>cols</em>][<strong>a</strong>|<strong>r</strong>]
-<strong>-t</strong>[<em>transp</em>]
-<strong>-:</strong>[<strong>i</strong>|<strong>o</strong>]</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p>These are all the common GMT options that remain the same for all GMT
-programs. No space between the option flag and the associated arguments.</p>
-<dl class="docutils" id="b-full">
-<dt><strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em></dt>
-<dd><p class="first">Set map Frame and Axes parameters. The Frame parameters are specified by</p>
-<p><strong>-B</strong>[<em>axes</em>][<strong>+b</strong>][<strong>+g</strong><em>fill</em>][<strong>+o</strong><em>lon/lat</em>][<strong>+t</strong><em>title</em>]</p>
-<p>where <em>axes</em> selects which axes to plot. By default, all 4 map boundaries
-(or plot axes) are plotted (named <strong>W</strong>, <strong>E</strong>, <strong>S</strong>, <strong>N</strong>). To customize,
-append the codes for those you want (e.g., <strong>WSn</strong>). Upper case means plot
-and annotate while lower case just plots the specified axes. If a 3-D basemap
-is selected with <strong>-p</strong> and <strong>-Jz</strong>, append <strong>Z</strong> or <strong>z</strong> to control the
-appearance of the vertical axis. By default a single vertical axes will be
-plotted at the most suitable map corner. Override the default by appending
-any combination of corner ids <strong>1234</strong>, where <strong>1</strong> represents the lower left
-corner and the order goes counter-clockwise. Append <strong>+b</strong> to draw the outline of the 3-D
-cube defined by <strong>-R</strong>; this modifier is also needed to display gridlines in
-the x-z, y-z planes. Note that for 3-D views the title, if given, will be
-suppressed. You can paint the interior of the canvas with <strong>+g</strong><em>fill</em>.
-Optionally append <strong>+o</strong><em>plon/plat</em> to draw oblique gridlines about
-specified pole [regular gridlines]. Ignored if gridlines are not
-requested (below) and disallowed for the oblique Mercator projection.
-To add a plot title (<strong>+t</strong><em>title</em>). The Frame setting is optional but
-can be invoked once to override the above defaults.</p>
-<p>The Axes parameters are specified by</p>
-<p><strong>-B</strong>[<strong>p</strong>|<strong>s</strong>][<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>intervals</em>[<strong>+l</strong><em>label</em>][<strong>+p</strong><em>prefix</em>][<strong>+u</strong><em>unit</em>]</p>
-<p class="last">but you may also split this into two separate invocations for clarity, i.e.,</p>
-</dd>
-</dl>
-<ul>
-<li><p class="first"><strong>-B</strong>[<strong>p</strong>|<strong>s</strong>][<strong>x</strong>|<strong>y</strong>|<strong>z</strong>][<strong>+l</strong><em>label</em>][<strong>+p</strong><em>prefix</em>][<strong>+u</strong><em>unit</em>]</p>
-</li>
-<li><p class="first"><strong>-B</strong>[<strong>p</strong>|<strong>s</strong>][<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>intervals</em></p>
-<p>The first optional flag following <strong>-B</strong> selects <strong>p</strong> (rimary) [Default] or
-<strong>s</strong> (econdary) axes information (mostly used for time axes annotations).
-The [<strong>x</strong>|<strong>x</strong>|<strong>z</strong>] flags specify which axes you are providing information for.
-If none are given then we default to <strong>xy</strong>. If you wish to give different annotation intervals
-or labels for the various axes then you must repeat the <strong>B</strong> option for
-each axis (If a 3-D basemap is selected with <strong>-p</strong> and <strong>-Jz</strong>, use <strong>-Bz</strong>
-to give settings for the vertical axis.). To add a label to an axis,
-just append <strong>+l</strong><em>label</em> (Cartesian projections only). If the
-axis annotation should have a leading text prefix (e.g., dollar sign for those
-plots of your net worth) you can append <strong>+p</strong><em>prefix</em>. For geographic maps
-the addition of degree symbols, etc. is automatic (and controlled by the GMT
-default setting <a class="reference internal" href="gmt.conf.html#format-geo-map"><em>FORMAT_GEO_MAP</em></a>). However, for other plots you can add
-specific units by adding <strong>+u</strong><em>unit</em>. If any of these text strings contain
-spaces or special UNIX characters you will need to enclose them in quotes.
-The <em>intervals</em> specification is a concatenated string made up of substrings
-of the form</p>
-<p>[<strong>a</strong>|<strong>f</strong>|<strong>g</strong>]<em>stride</em>[<em>+-phase</em>][<strong>u</strong>].</p>
-<p>The leading <strong>a</strong> is used to specify the annotation and major tick
-spacing [Default], <strong>f</strong> for minor tick spacing, and <strong>g</strong> for
-gridline spacing. <em>stride</em> is the desired stride interval. The
-optional <em>phase</em> shifts the annotation interval by that amount
-(positive or negative). The optional <em>unit</em> indicates the unit of
-the <em>stride</em> and can be any of</p>
-<ul class="simple">
-<li><strong>Y</strong> (year, plot with 4 digits)</li>
-<li><strong>y</strong> (year, plot with 2 digits)</li>
-<li><strong>O</strong> (month, plot using <a class="reference internal" href="gmt.conf.html#format-date-map"><em>FORMAT_DATE_MAP</em></a>)</li>
-<li><strong>o</strong> (month, plot with 2 digits)</li>
-<li><strong>U</strong> (ISO week, plot using <a class="reference internal" href="gmt.conf.html#format-date-map"><em>FORMAT_DATE_MAP</em></a>)</li>
-<li><strong>u</strong> (ISO week, plot using 2 digits)</li>
-<li><strong>r</strong> (Gregorian week, 7-day stride from start of week <a class="reference internal" href="gmt.conf.html#time-week-start"><em>TIME_WEEK_START</em></a>)</li>
-<li><strong>K</strong> (ISO weekday, plot name of day)</li>
-<li><strong>D</strong> (date, plot using <a class="reference internal" href="gmt.conf.html#format-date-map"><em>FORMAT_DATE_MAP</em></a>)</li>
-<li><strong>d</strong> (day, plot day of month 0-31 or year 1-366, via <a class="reference internal" href="gmt.conf.html#format-date-map"><em>FORMAT_DATE_MAP</em></a>)</li>
-<li><strong>R</strong> (day, same as <strong>d</strong>, aligned with <a class="reference internal" href="gmt.conf.html#time-week-start"><em>TIME_WEEK_START</em></a>)</li>
-<li><strong>H</strong> (hour, plot using <a class="reference internal" href="gmt.conf.html#format-clock-map"><em>FORMAT_CLOCK_MAP</em></a>)</li>
-<li><strong>h</strong> (hour, plot with 2 digits)</li>
-<li><strong>M</strong> (minute, plot using <a class="reference internal" href="gmt.conf.html#format-clock-map"><em>FORMAT_CLOCK_MAP</em></a>)</li>
-<li><strong>m</strong> (minute, plot with 2 digits)</li>
-<li><strong>S</strong> (second, plot using <a class="reference internal" href="gmt.conf.html#format-clock-map"><em>FORMAT_CLOCK_MAP</em></a>)</li>
-<li><strong>s</strong> (second, plot with 2 digits).</li>
-</ul>
-<p>Note for geographic axes <strong>m</strong> and <strong>s</strong> instead mean arc minutes and arc seconds.
-All entities that are language-specific are under control
-by <a class="reference internal" href="gmt.conf.html#time-language"><em>TIME_LANGUAGE</em></a>. Alternatively, for linear maps, we can omit <em>stride</em>, thus setting
-<em>xinfo</em>, <em>yinfo</em>, or <em>zinfo</em> to <strong>a</strong> plots annotations at
-automatically determined intervals,</p>
-<ul class="simple">
-<li><strong>ag</strong> plots both annotations and grid lines with the same spacing,</li>
-<li><strong>afg</strong> adds suitable minor tick intervals,</li>
-<li><strong>g</strong> plots grid lines with the same interval as if <strong>-Bf</strong> was used.</li>
-</ul>
-<p>For custom annotations and intervals, let <em>intervals</em> be given as
-<strong>c</strong><em>intfile</em>, where <em>intfile</em> contains any number of
-records with <em>coord</em> <em>type</em> [<em>label</em>]. Here, <em>type</em> is one or more
-letters from <strong>a</strong>|<strong>i</strong>, <strong>f</strong>, and <strong>g</strong>. For
-<strong>a</strong>|<strong>i</strong> you must supply a <em>label</em> that will be plotted at
-the <em>coord</em> location. <br />
-For non-geographical projections: Give negative scale (in <strong>-Jx</strong>)
-or axis length (in <strong>-JX</strong>) to change the direction of increasing
-coordinates (i.e., to make the y-axis positive down). <br />
-For log10 axes: Annotations can be specified in one of three ways:</p>
-<ol class="arabic simple">
-<li><em>stride</em> can be 1, 2, 3, or -<em>n</em>. Annotations will then occur at 1,
-1-2-5, or 1-2-3-4-...-9, respectively; for -<em>n</em> we annotate every
-<em>n</em>‘t magnitude. This option can also be used for the frame and
-grid intervals.</li>
-<li>An <strong>l</strong> is appended to the <em>tickinfo</em> string. Then, log10 of the
-tick value is plotted at every integer log10 value.</li>
-<li>A <strong>p</strong> is appended to the <em>tickinfo</em> string. Then,
-annotations appear as 10 raised to log10 of the tick value.</li>
-</ol>
-<p>For power axes: Annotations can be specified in one of two ways:</p>
-<ol class="arabic simple">
-<li><em>stride</em> sets the regular annotation interval.</li>
-<li>A <strong>p</strong> is appended to the <em>tickinfo</em> string. Then, the annotation interval is
-expected to be in transformed units, but the annotation value will
-be plotted as untransformed units. E.g., if <em>stride</em> = 1 and <em>power</em>
-= 0.5 (i.e., sqrt), then equidistant annotations labeled 1-4-9... will appear.</li>
-</ol>
-<p>These GMT parameters can affect the appearance of the map boundary:
-<a class="reference internal" href="gmt.conf.html#map-annot-min-angle"><em>MAP_ANNOT_MIN_ANGLE</em></a>, <a class="reference internal" href="gmt.conf.html#map-annot-min-spacing"><em>MAP_ANNOT_MIN_SPACING</em></a>,
-<a class="reference internal" href="gmt.conf.html#font-annot-primary"><em>FONT_ANNOT_PRIMARY</em></a>, <a class="reference internal" href="gmt.conf.html#font-annot-secondary"><em>FONT_ANNOT_SECONDARY</em></a>,
-<a class="reference internal" href="gmt.conf.html#map-annot-offset-primary"><em>MAP_ANNOT_OFFSET_PRIMARY</em></a>,
-<a class="reference internal" href="gmt.conf.html#map-annot-offset-secondary"><em>MAP_ANNOT_OFFSET_SECONDARY</em></a>,
-<a class="reference internal" href="gmt.conf.html#map-annot-ortho"><em>MAP_ANNOT_ORTHO</em></a>, <a class="reference internal" href="gmt.conf.html#map-frame-axes"><em>MAP_FRAME_AXES</em></a>, <a class="reference internal" href="gmt.conf.html#map-default-pen"><em>MAP_DEFAULT_PEN</em></a>,
-<a class="reference internal" href="gmt.conf.html#map-frame-type"><em>MAP_FRAME_TYPE</em></a>, <a class="reference internal" href="gmt.conf.html#format-geo-map"><em>FORMAT_GEO_MAP</em></a>, <a class="reference internal" href="gmt.conf.html#map-frame-pen"><em>MAP_FRAME_PEN</em></a>,
-<a class="reference internal" href="gmt.conf.html#map-frame-width"><em>MAP_FRAME_WIDTH</em></a>, <a class="reference internal" href="gmt.conf.html#map-grid-cross-size-primary"><em>MAP_GRID_CROSS_SIZE_PRIMARY</em></a>,
-<a class="reference internal" href="gmt.conf.html#map-grid-pen-primary"><em>MAP_GRID_PEN_PRIMARY</em></a>, <a class="reference internal" href="gmt.conf.html#map-grid-cross-size-secondary"><em>MAP_GRID_CROSS_SIZE_SECONDARY</em></a>,
-<a class="reference internal" href="gmt.conf.html#map-grid-pen-secondary"><em>MAP_GRID_PEN_SECONDARY</em></a>, <a class="reference internal" href="gmt.conf.html#font-title"><em>FONT_TITLE</em></a>, <a class="reference internal" href="gmt.conf.html#font-label"><em>FONT_LABEL</em></a>,
-<a class="reference internal" href="gmt.conf.html#map-line-step"><em>MAP_LINE_STEP</em></a>, <a class="reference internal" href="gmt.conf.html#map-annot-oblique"><em>MAP_ANNOT_OBLIQUE</em></a>,
-<a class="reference internal" href="gmt.conf.html#format-clock-map"><em>FORMAT_CLOCK_MAP</em></a>, <a class="reference internal" href="gmt.conf.html#format-date-map"><em>FORMAT_DATE_MAP</em></a>,
-<a class="reference internal" href="gmt.conf.html#format-time-primary-map"><em>FORMAT_TIME_PRIMARY_MAP</em></a>, <a class="reference internal" href="gmt.conf.html#format-time-secondary-map"><em>FORMAT_TIME_SECONDARY_MAP</em></a>,
-<a class="reference internal" href="gmt.conf.html#time-language"><em>TIME_LANGUAGE</em></a>, <a class="reference internal" href="gmt.conf.html#time-week-start"><em>TIME_WEEK_START</em></a>,
-<a class="reference internal" href="gmt.conf.html#map-tick-length-primary"><em>MAP_TICK_LENGTH_PRIMARY</em></a>,
-and <a class="reference internal" href="gmt.conf.html#map-tick-pen-primary"><em>MAP_TICK_PEN_PRIMARY</em></a>; see the <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> man page for details.</p>
-</li>
-</ul>
-<p id="j-full"><strong>-J</strong><em>parameters</em></p>
-<p>Select map projection. The following character determines the
-projection. If the character is upper case then the argument(s) supplied
-as scale(s) is interpreted to be the map width (or axis lengths), else
-the scale argument(s) is the map scale (see its definition for each
-projection). UNIT is cm, inch, or point, depending on the
-<a class="reference internal" href="gmt.conf.html#proj-length-unit"><em>PROJ_LENGTH_UNIT</em></a> setting in <strong>gmt.conf</strong>, but this can be
-overridden on the command line by appending <strong>c</strong>, <strong>i</strong>, or <strong>p</strong> to
-the <em>scale</em> or <em>width</em> values. Append <strong>h</strong>, <strong>+</strong>, or <strong>-</strong> to the
-given <em>width</em> if you instead want to set map height, the maximum
-dimension, or the minimum dimension, respectively [Default is <strong>w</strong> for width].
-In case the central meridian is an optional parameter and it is being
-omitted, then the center of the longitude range given by the <strong>-R</strong>
-option is used. The default standard parallel is the equator.
-The ellipsoid used in the map projections is user-definable by editing
-the <strong>gmt.conf</strong> file in your home directory. 73 commonly used
-ellipsoids and spheroids are currently supported, and users may also
-specify their own custum ellipsoid parameters [Default is WGS-84].
-Several GMT parameters can affect the projection: <a class="reference internal" href="gmt.conf.html#proj-ellipsoid"><em>PROJ_ELLIPSOID</em></a>,
-<a class="reference internal" href="gmt.conf.html#gmt-interpolant"><em>GMT_INTERPOLANT</em></a>, <a class="reference internal" href="gmt.conf.html#proj-scale-factor"><em>PROJ_SCALE_FACTOR</em></a>, and
-<a class="reference internal" href="gmt.conf.html#proj-length-unit"><em>PROJ_LENGTH_UNIT</em></a>; see the <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> man page for details.
-Choose one of the following projections (The <strong>E</strong> or <strong>C</strong> after
-projection names stands for Equal-Area and Conformal, respectively):</p>
-<blockquote>
-<div><strong>CYLINDRICAL PROJECTIONS:</strong></div></blockquote>
-<blockquote id="jc-full">
-<div><p><strong>-Jc</strong><em>lon0/lat0/scale</em> or <strong>-JC</strong><em>lon0/lat0/width</em> (Cassini).</p>
-<blockquote>
-<div>Give projection center <em>lon0/lat0</em> and <em>scale</em> (<strong>1:</strong><em>xxxx</em> or UNIT/degree).</div></blockquote>
-</div></blockquote>
-<blockquote id="jcyl-stere-full">
-<div><p><strong>-Jcyl_stere</strong>/[<em>lon0/</em>[<em>lat0/</em>]]<em>scale</em> or
-<strong>-JCyl_stere</strong>/[<em>lon0/</em>[<em>lat0/</em>]]<em>width</em> (Cylindrical Stereographic).</p>
-<blockquote>
-<div><p>Give central meridian <em>lon0</em> (optional), standard parallel <em>lat0</em>
-(optional), and <em>scale</em> along parallel (<strong>1:</strong><em>xxxx</em> or
-UNIT/degree). The standard parallel is typically one of these (but
-can be any value):</p>
-<blockquote>
-<div><ul class="simple">
-<li>66.159467 - Miller’s modified Gall</li>
-<li>55 - Kamenetskiy’s First</li>
-<li>45 - Gall’s Stereographic</li>
-<li>30 - Bolshoi Sovietskii Atlas Mira or Kamenetskiy’s Second</li>
-<li>0 - Braun’s Cylindrical</li>
-</ul>
-</div></blockquote>
-</div></blockquote>
-</div></blockquote>
-<blockquote id="jj-full">
-<div><p><strong>-Jj</strong>[<em>lon0/</em>]<em>scale</em> or <strong>-JJ</strong>[<em>lon0/</em>]<em>width</em> (Miller Cylindrical Projection).</p>
-<blockquote>
-<div>Give the central meridian <em>lon0</em> (optional) and <em>scale</em>
-(<strong>1:</strong><em>xxxx</em> or UNIT/degree).</div></blockquote>
-</div></blockquote>
-<blockquote id="jm-full">
-<div><p><strong>-Jm</strong>[<em>lon0/</em>[<em>lat0/</em>]]<em>scale</em> or <strong>-JM</strong>[<em>lon0/</em>[<em>lat0/</em>]]<em>width</em> (Mercator <strong>[C]</strong>)</p>
-<blockquote>
-<div>Give central meridian <em>lon0</em> (optional), standard parallel <em>lat0</em>
-(optional), and <em>scale</em> along parallel (<strong>1:</strong><em>xxxx</em> or UNIT/degree).</div></blockquote>
-</div></blockquote>
-<blockquote id="jo-full">
-<div><p><strong>-Jo</strong><em>parameters</em> (Oblique Mercator <strong>[C]</strong>).</p>
-<blockquote>
-<div><p>Typically used with <strong>-R</strong><em>LLx/LLy/URx/URy</em><strong>r</strong> or with projected coordinates. Specify one of:</p>
-<dl class="docutils">
-<dt><strong>-Jo</strong>[<strong>a</strong>]<em>lon0/lat0/azimuth/scale</em> or <strong>-JO</strong>[<strong>a</strong>]<em>lon0/lat0/azimuth/width</em></dt>
-<dd>Set projection center <em>lon0/lat0</em>, <em>azimuth</em> of oblique equator, and <em>scale</em>.</dd>
-<dt><strong>-Jo</strong>[<strong>b</strong>]<em>lon0/lat0/lon1/lat1/scale</em> or <strong>-JO</strong>[<strong>b</strong>]<em>lon0/lat0/lon1/lat1/scale</em></dt>
-<dd>Set projection center <em>lon0/lat0</em>, another point on the oblique
-equator <em>lon1/lat1</em>, and <em>scale</em>.</dd>
-<dt><strong>-Joc</strong><em>lon0/lat0/lonp/latp/scale</em> or <strong>-JOc</strong><em>lon0/lat0/lonp/latp/scale</em></dt>
-<dd>Set projection center <em>lon0/lat0</em>, pole of oblique projection
-<em>lonp/latp</em>, and <em>scale</em>.
-Give <em>scale</em> along oblique equator (<strong>1:</strong><em>xxxx</em> or UNIT/degree).</dd>
-</dl>
-</div></blockquote>
-</div></blockquote>
-<blockquote id="jq-full">
-<div><p><strong>-Jq</strong>[<em>lon0/</em>[<em>lat0/</em>]]<em>scale</em> or
-<strong>-JQ</strong>[<em>lon0/</em>[<em>lat0/</em>]]<em>width</em> (Cylindrical Equidistant).</p>
-<blockquote>
-<div><p>Give the central meridian <em>lon0</em> (optional), standard parallel
-<em>lat0</em> (optional), and <em>scale</em> (<strong>1:</strong><em>xxxx</em> or UNIT/degree). The
-standard parallel is typically one of these (but can be any value):</p>
-<blockquote>
-<div><ul class="simple">
-<li>61.7 - Grafarend and Niermann, minimum linear distortion</li>
-<li>50.5 - Ronald Miller Equirectangular</li>
-<li>43.5 - Ronald Miller, minimum continental distortion</li>
-<li>42 - Grafarend and Niermann</li>
-<li>37.5 - Ronald Miller, minimum overall distortion</li>
-<li>0 - Plate Carree, Simple Cylindrical, Plain/Plane Chart</li>
-</ul>
-</div></blockquote>
-</div></blockquote>
-</div></blockquote>
-<blockquote id="jt-full">
-<div><p><strong>-Jt</strong><em>lon0/</em>[<em>lat0/</em>]<em>scale</em> or
-<strong>-JT</strong><em>lon0/</em>[<em>lat0/</em>]<em>width</em> (Transverse Mercator <strong>[C]</strong>)</p>
-<blockquote>
-<div>Give the central meridian <em>lon0</em>, central parallel <em>lat0</em>
-(optional), and <em>scale</em> (<strong>1:</strong><em>xxxx</em> or UNIT/degree).</div></blockquote>
-</div></blockquote>
-<blockquote id="ju-full">
-<div><p><strong>-Ju</strong><em>zone/scale</em> or <strong>-JU</strong><em>zone/width</em> (UTM - Universal Transverse Mercator <strong>[C]</strong>).</p>
-<blockquote>
-<div>Give the UTM zone (A,B,1-60[C-X],Y,Z)) and <em>scale</em> (<strong>1:</strong><em>xxxx</em> or UNIT/degree).
-Zones: If C-X not given, prepend - or + to enforce southern or
-northern hemisphere conventions [northern if south > 0].</div></blockquote>
-</div></blockquote>
-<blockquote id="jy-full">
-<div><p><strong>-Jy</strong>[<em>lon0/</em>[<em>lat0/</em>]]<em>scale</em> or <strong>-JY</strong>[<em>lon0/</em>[<em>lat0/</em>]]<em>width</em> (Cylindrical Equal-Area <strong>[E]</strong>).</p>
-<blockquote>
-<div><p>Give the central meridian <em>lon0</em> (optional), standard parallel
-<em>lat0</em> (optional), and <em>scale</em> (<strong>1:</strong><em>xxxx</em> or UNIT/degree). The
-standard parallel is typically one of these (but can be any value):</p>
-<blockquote>
-<div><ul class="simple">
-<li>50 - Balthasart</li>
-<li>45 - Gall-Peters</li>
-<li>37.0666 - Caster</li>
-<li>37.4 - Trystan Edwards</li>
-<li>37.5 - Hobo-Dyer</li>
-<li>30 - Behrman</li>
-<li>0 - Lambert (default)</li>
-</ul>
-</div></blockquote>
-</div></blockquote>
-<p><strong>CONIC PROJECTIONS:</strong></p>
-</div></blockquote>
-<blockquote id="jb-full">
-<div><dl class="docutils">
-<dt><strong>-Jb</strong><em>lon0/lat0/lat1/lat2/scale</em> or <strong>-JB</strong><em>lon0/lat0/lat1/lat2/width</em> (Albers <strong>[E]</strong>).</dt>
-<dd>Give projection center <em>lon0/lat0</em>, two standard parallels
-<em>lat1/lat2</em>, and <em>scale</em> (<strong>1:</strong><em>xxxx</em> or UNIT/degree).</dd>
-</dl>
-</div></blockquote>
-<blockquote id="jd-full">
-<div><dl class="docutils">
-<dt><strong>-Jd</strong><em>lon0/lat0/lat1/lat2/scale</em> or <strong>-JD</strong><em>lon0/lat0/lat1/lat2/width</em> (Conic Equidistant)</dt>
-<dd>Give projection center <em>lon0/lat0</em>, two standard parallels
-<em>lat1/lat2</em>, and <em>scale</em> (<strong>1:</strong><em>xxxx</em> or UNIT/degree).</dd>
-</dl>
-</div></blockquote>
-<blockquote id="jl-full">
-<div><dl class="docutils">
-<dt><strong>-Jl</strong><em>lon0/lat0/lat1/lat2/scale</em> or <strong>-JL</strong><em>lon0/lat0/lat1/lat2/width</em> (Lambert <strong>[C]</strong>)</dt>
-<dd>Give origin <em>lon0/lat0</em>, two standard parallels <em>lat1/lat2</em>, and
-<em>scale</em> along these (<strong>1:</strong><em>xxxx</em> or UNIT/degree).</dd>
-</dl>
-</div></blockquote>
-<blockquote id="jpoly-full">
-<div><dl class="docutils">
-<dt><strong>-Jpoly</strong>/[<em>lon0/</em>[<em>lat0/</em>]]<em>scale</em> or <strong>-JPoly</strong>/[<em>lon0/</em>[<em>lat0/</em>]]<em>width</em> ((American) Polyconic).</dt>
-<dd>Give the central meridian <em>lon0</em> (optional), reference parallel
-<em>lat0</em> (optional, default = equator), and <em>scale</em> along central
-meridian (<strong>1:</strong><em>xxxx</em> or UNIT/degree).</dd>
-</dl>
-<p><strong>AZIMUTHAL PROJECTIONS:</strong></p>
-<p>Except for polar aspects, <strong>-R</strong>w/e/s/n will be reset to <strong>-Rg</strong>.
-Use <strong>-R</strong><...><strong>r</strong> for smaller regions.</p>
-</div></blockquote>
-<blockquote id="ja-full">
-<div><dl class="docutils">
-<dt><strong>-Ja</strong><em>lon0/lat0</em>[<em>/horizon</em>]<em>/scale</em> or <strong>-JA</strong><em>lon0/lat0</em>[<em>/horizon</em>]<em>/width</em> (Lambert <strong>[E]</strong>).</dt>
-<dd><em>lon0/lat0</em> specifies the projection center. <em>horizon</em> specifies
-the max distance from projection center (in degrees, <= 180,
-default 90). Give <em>scale</em> as <strong>1:</strong><em>xxxx</em> or <em>radius/lat</em>,
-where <em>radius</em> is distance in UNIT from origin to the oblique
-latitude <em>lat</em>.</dd>
-</dl>
-</div></blockquote>
-<blockquote id="je-full">
-<div><dl class="docutils">
-<dt><strong>-Je</strong><em>lon0/lat0</em>[<em>/horizon</em>]<em>/scale</em> or <strong>-JE</strong><em>lon0/lat0</em>[<em>/horizon</em>]<em>/width</em> (Azimuthal Equidistant).</dt>
-<dd><em>lon0/lat0</em> specifies the projection center. <em>horizon</em> specifies
-the max distance from projection center (in degrees, <= 180,
-default 180). Give <em>scale</em> as <strong>1:</strong><em>xxxx</em> or <em>radius/lat</em>,
-where <em>radius</em> is distance in UNIT from origin to the oblique
-latitude <em>lat</em>.</dd>
-</dl>
-</div></blockquote>
-<blockquote id="jf-full">
-<div><dl class="docutils">
-<dt><strong>-Jf</strong><em>lon0/lat0</em>[<em>/horizon</em>]<em>/scale</em> or <strong>-JF</strong><em>lon0/lat0</em>[<em>/horizon</em>]<em>/width</em> (Gnomonic).</dt>
-<dd><em>lon0/lat0</em> specifies the projection center. <em>horizon</em> specifies
-the max distance from projection center (in degrees, < 90,
-default 60). Give <em>scale</em> as <strong>1:</strong><em>xxxx</em> or <em>radius/lat</em>,
-where <em>radius</em> is distance in UNIT from origin to the oblique
-latitude <em>lat</em>.</dd>
-</dl>
-</div></blockquote>
-<blockquote id="jg-full">
-<div><dl class="docutils">
-<dt><strong>-Jg</strong><em>lon0/lat0</em>[<em>/horizon</em>]<em>/scale</em> or <strong>-JG</strong><em>lon0/lat0</em>[<em>/horizon</em>]<em>/width</em> (Orthographic).</dt>
-<dd><em>lon0/lat0</em> specifies the projection center. <em>horizon</em> specifies
-the max distance from projection center (in degrees, <= 90,
-default 90). Give <em>scale</em> as <strong>1:</strong><em>xxxx</em> or <em>radius/lat</em>,
-where <em>radius</em> is distance in UNIT from origin to the oblique
-latitude <em>lat</em>.</dd>
-<dt><strong>-Jg</strong><em>lon0/lat0/altitude/azimuth/tilt/twist/Width/Height/scale</em> or <strong>-JG</strong><em>lon0/lat0/altitude/azimuth/tilt/twist/Width/Height/width</em> (General Perspective).</dt>
-<dd><em>lon0/lat0</em> specifies the projection center. <em>altitude</em> is the
-height (in km) of the viewpoint above local sea level. If
-<em>altitude</em> is less than 10, then it is the distance from the
-center of the earth to the viewpoint in earth radii. If
-<em>altitude</em> has a suffix <strong>r</strong> then it is the radius from the
-center of the earth in kilometers. <em>azimuth</em> is measured to the
-east of north of view. <em>tilt</em> is the upward tilt of the plane of
-projection. If <em>tilt</em> is negative, then the viewpoint is
-centered on the horizon. Further, specify the clockwise <em>twist</em>,
-<em>Width</em>, and <em>Height</em> of the viewpoint in degrees. Give <em>scale</em>
-as <strong>1:</strong><em>xxxx</em> or <em>radius/lat</em>, where <em>radius</em> is distance in
-UNIT from origin to the oblique latitude <em>lat</em>.</dd>
-</dl>
-</div></blockquote>
-<blockquote id="js-full">
-<div><dl class="docutils">
-<dt><strong>-Js</strong><em>lon0/lat0</em>[<em>/horizon</em>]<em>/scale</em> or <strong>-JS</strong><em>lon0/lat0</em>[<em>/horizon</em>]<em>/width</em> (General Stereographic <strong>[C]</strong>).</dt>
-<dd><em>lon0/lat0</em> specifies the projection center. <em>horizon</em> specifies
-the max distance from projection center (in degrees, < 180,
-default 90). Give <em>scale</em> as <strong>1:</strong><em>xxxx</em> (true at pole) or
-<em>lat0</em>/<strong>1:</strong><em>xxxx</em> (true at standard parallel <em>lat</em>) or
-<em>radius/lat</em> (<em>radius</em> in UNIT from origin to the oblique
-latitude <em>lat</em>). Note if <strong>1:</strong><em>xxxx</em> is used then to specify
-<em>horizon</em> you must also specify the <em>lat</em> as +-90 to avoid
-ambiguity.</dd>
-</dl>
-<p><strong>MISCELLANEOUS PROJECTIONS:</strong></p>
-</div></blockquote>
-<blockquote id="jh-full">
-<div><dl class="docutils">
-<dt><strong>-Jh</strong>[<em>lon0/</em>]<em>scale</em> or <strong>-JH</strong>[<em>lon0/</em>]<em>width</em> (Hammer <strong>[E]</strong>).</dt>
-<dd>Give the central meridian <em>lon0</em> (optional) and <em>scale</em> along
-equator (<strong>1:</strong><em>xxxx</em> or UNIT/degree).</dd>
-</dl>
-</div></blockquote>
-<blockquote id="ji-full">
-<div><dl class="docutils">
-<dt><strong>-Ji</strong>[<em>lon0/</em>]<em>scale</em> or <strong>-JI</strong>[<em>lon0/</em>]<em>width</em> (Sinusoidal <strong>[E]</strong>).</dt>
-<dd>Give the central meridian <em>lon0</em> (optional) and <em>scale</em> along
-equator (<strong>1:</strong><em>xxxx</em> or UNIT/degree).</dd>
-</dl>
-</div></blockquote>
-<blockquote id="jk-full">
-<div><dl class="docutils">
-<dt><strong>-Jkf</strong>[<em>lon0/</em>]<em>scale</em> or <strong>-JKf</strong>[<em>lon0/</em>]<em>width</em> (Eckert IV) <strong>[E]</strong>).</dt>
-<dd>Give the central meridian <em>lon0</em> (optional) and <em>scale</em> along
-equator (<strong>1:</strong><em>xxxx</em> or UNIT/degree).</dd>
-<dt><strong>-Jk</strong>[<strong>s</strong>][<em>lon0/</em>]<em>scale</em> or <strong>-JK</strong>[<strong>s</strong>][<em>lon0/</em>]<em>width</em> (Eckert VI) <strong>[E]</strong>).</dt>
-<dd>Give the central meridian <em>lon0</em> (optional) and <em>scale</em> along
-equator (<strong>1:</strong><em>xxxx</em> or UNIT/degree).</dd>
-</dl>
-</div></blockquote>
-<blockquote id="jn-full">
-<div><dl class="docutils">
-<dt><strong>-Jn</strong>[<em>lon0/</em>]<em>scale</em> or <strong>-JN</strong>[<em>lon0/</em>]<em>width</em> (Robinson).</dt>
-<dd>Give the central meridian <em>lon0</em> (optional) and <em>scale</em> along
-equator (<strong>1:</strong><em>xxxx</em> or UNIT/degree).</dd>
-</dl>
-</div></blockquote>
-<blockquote id="jr-full">
-<div><dl class="docutils">
-<dt><strong>-Jr</strong>[<em>lon0/</em>]<em>scale</em> <strong>-JR</strong>[<em>lon0/</em>]<em>width</em> (Winkel Tripel).</dt>
-<dd>Give the central meridian <em>lon0</em> (optional) and <em>scale</em> along
-equator (<strong>1:</strong><em>xxxx</em> or UNIT/degree).</dd>
-</dl>
-</div></blockquote>
-<blockquote id="jv-full">
-<div><dl class="docutils">
-<dt><strong>-Jv</strong>[<em>lon0/</em>]<em>scale</em> or <strong>-JV</strong>[<em>lon0/</em>]<em>width</em> (Van der Grinten).</dt>
-<dd>Give the central meridian <em>lon0</em> (optional) and <em>scale</em> along
-equator (<strong>1:</strong><em>xxxx</em> or UNIT/degree).</dd>
-</dl>
-</div></blockquote>
-<blockquote id="jw-full">
-<div><dl class="docutils">
-<dt><strong>-Jw</strong>[<em>lon0/</em>]<em>scale</em> or <strong>-JW</strong>[<em>lon0/</em>]<em>width</em> (Mollweide <strong>[E]</strong>).</dt>
-<dd>Give the central meridian <em>lon0</em> (optional) and <em>scale</em> along
-equator (<strong>1:</strong><em>xxxx</em> or UNIT/degree).</dd>
-</dl>
-<p><strong>NON-GEOGRAPHICAL PROJECTIONS:</strong></p>
-</div></blockquote>
-<blockquote id="jp-full">
-<div><p><strong>-Jp</strong>[<strong>a</strong>]<em>scale</em>[<em>/origin</em>][<strong>r</strong>|<strong>z</strong>] or <strong>-JP</strong>[<strong>a</strong>]<em>width</em>[<em>/origin</em>][<strong>r</strong>|<strong>z</strong>]
-(Polar coordinates (theta,r))</p>
-<p>Optionally insert <strong>a</strong> after <strong>-Jp</strong> [ or <strong>-JP</strong>] for azimuths CW
-from North instead of directions CCW from East [Default]. Optionally
-append /<em>origin</em> in degrees to indicate an angular offset [0]).
-Finally, append <strong>r</strong> if r is elevations in degrees (requires s >= 0
-and n <= 90) or <strong>z</strong> if you want to annotate depth rather than
-radius [Default]. Give <em>scale</em> in UNIT/r-unit.</p>
-</div></blockquote>
-<blockquote id="jx-full">
-<div><p><strong>-Jx</strong><em>x-scale</em>[<em>/y-scale</em>] or <strong>-JX</strong><em>width</em>[<em>/height</em>] (Linear, log, and power scaling)</p>
-<p>Give <em>x-scale</em> (<strong>1:</strong><em>xxxx</em> or UNIT/x-unit) and/or <em>y-scale</em>
-(<strong>1:</strong><em>xxxx</em> or UNIT/y-unit); or specify <em>width</em> and/or <em>height</em>
-in UNIT. <em>y-scale</em>=<em>x-scale</em> if not specified separately and
-using <strong>1:</strong><em>xxxx</em> implies that x-unit and y-unit are in meters.
-Use negative scale(s) to reverse the direction of an axis (e.g., to
-have y be positive down). Set <em>height</em> or <em>width</em> to 0 to have it
-recomputed based on the implied scale of the other axis. Optionally,
-append to <em>x-scale</em>, <em>y-scale</em>, <em>width</em> or <em>height</em> one of the
-following:</p>
-<blockquote>
-<div><dl class="docutils">
-<dt><strong>d</strong></dt>
-<dd>Data are geographical coordinates (in degrees).</dd>
-<dt><strong>l</strong></dt>
-<dd>Take log10 of values before scaling.</dd>
-<dt><strong>p</strong><em>power</em></dt>
-<dd>Raise values to <em>power</em> before scaling.</dd>
-<dt><strong>t</strong></dt>
-<dd>Input coordinates are time relative to <a class="reference internal" href="gmt.conf.html#time-epoch"><em>TIME_EPOCH</em></a>.</dd>
-<dt><strong>T</strong></dt>
-<dd>Input coordinates are absolute time.</dd>
-</dl>
-<p>Default axis lengths (see <strong>gmt.conf</strong>) can be invoked using
-<strong>-JXh</strong> (for landscape); <strong>-JXv</strong> (for portrait) will swap the
-x- and y-axis lengths. The default unit for this installation is
-either cm or inch, as defined in the file <strong>share/gmt.conf</strong>.
-However, you may change this by editing your <strong>gmt.conf</strong> file(s).</p>
-</div></blockquote>
-</div></blockquote>
-<p>When <strong>-J</strong> is used without any further arguments, or just with the
-projection type, the arguments of the last used <strong>-J</strong>, or the last used
-<strong>-J</strong> with that projection type, will be used.</p>
-<dl class="docutils" id="jz-full">
-<dt><strong>-Jz</strong>|<strong>Z</strong><em>parameters</em></dt>
-<dd>Set z-axis scaling; same syntax as <strong>-Jx</strong>.</dd>
-</dl>
-<dl class="docutils" id="k-full">
-<dt><strong>-K</strong></dt>
-<dd>More PostScript code will be appended later [Default terminates
-the plot system]. Required for all but the last plot command when
-building multi-layer plots.</dd>
-</dl>
-<dl class="docutils" id="o-full">
-<dt><strong>-O</strong></dt>
-<dd>Selects Overlay plot mode [Default initializes a new plot system].
-Required for all but the first plot command when building
-multi-layer plots.</dd>
-</dl>
-<dl class="docutils" id="p-full">
-<dt><strong>-P</strong></dt>
-<dd>Select “Portrait” plot orientation [Default is “Landscape”; see
-<strong>gmt.conf</strong> or <strong>gmtset</strong> to change the <strong>PS_PAGE_ORIENTATION</strong>
-parameter, or supply <strong>-</strong><strong>-PS_PAGE_ORIENTATION=</strong><em>orientation</em> on the
-command line].</dd>
-</dl>
-<dl class="docutils" id="r-full">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>]</dt>
-<dd><em>xmin</em>, <em>xmax</em>, <em>ymin</em>, and <em>ymax</em> specify the region of interest.
-For geographic regions, these limits correspond to <em>west</em>, <em>east</em>,
-<em>south</em>, and <em>north</em> and you may specify them in decimal degrees or
-in [<strong>+-</strong>]<em>dd</em><strong>:</strong><em>mm</em>[<strong>:</strong><em>ss.xxx</em>][<strong>W</strong>|<strong>E</strong>|<strong>S</strong>|<strong>N</strong>] format. Append <strong>r</strong> if lower left
-and upper right map coordinates are given instead of <em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>. The
-two shorthands <strong>-Rg</strong> and <strong>-Rd</strong> stand for global domain (0/360
-and -180/+180 in longitude respectively, with -90/+90 in latitude).
-Alternatively, specify the name of an existing grid file and the
-<strong>-R</strong> settings (and grid spacing, if applicable) are copied from
-the grid. When <strong>-R</strong> is used without any further arguments, the
-values from the last use of <strong>-R</strong> in a previous GMT command
-will be used.
-For calendar time coordinates you may either give (a) relative time
-(relative to the selected <a class="reference internal" href="gmt.conf.html#time-epoch"><em>TIME_EPOCH</em></a> and in the selected
-<a class="reference internal" href="gmt.conf.html#time-unit"><em>TIME_UNIT</em></a>; append <strong>t</strong> to <strong>-JX</strong>|<strong>x</strong>), or (b) absolute
-time of the form [<em>date</em>]<strong>T</strong>[<em>clock</em>] (append <strong>T</strong> to
-<strong>-JX</strong>|<strong>x</strong>). At least one of <em>date</em> and <em>clock</em> must be
-present; the <strong>T</strong> is always required. The <em>date</em> string must be of
-the form [<strong>-</strong>]<em>yyyy</em>[<strong>-</strong><em>mm</em>[<strong>-</strong><em>dd</em>]]
-(Gregorian calendar) or <em>yyyy</em>[<strong>-W</strong><em>ww</em>[<strong>-</strong><em>d</em>]]
-(ISO week calendar), while the <em>clock</em> string must be of the form
-<em>hh</em><strong>:</strong><em>mm</em><strong>:</strong><em>ss</em>[<em>.xxx</em>]. The use of delimiters and their type and positions
-must be exactly as indicated (however, input, output and plot
-formats are customizable; see <strong>gmt.conf</strong>).
-You can also use Cartesian projected coordinates compatible with the
-chosen projection. Give them with a leading length <em>unit</em>, (e.g.,
-<strong>-Rk</strong>-200/200/-300/300 for a 400 by 600 km rectangular area centered
-on the projection center (0, 0). These coordinates are internally
-converted to the corresponding geographic (longitude, latitude)
-coordinates for the lower left and upper right corners. This form is
-convenient when you want to specify a region directly in the
-projected units (e.g., UTM meters).</dd>
-</dl>
-<p id="rz-full">In case of perspective view <strong>p</strong>, a z-range (<em>zmin</em>, <em>zmax</em>) can be appended to indicate
-the third dimension. This needs to be done only when using the <strong>Jz</strong> option, not when using
-only the <strong>p</strong> option. In the latter case a perspective view of the plane is plotted, with
-no third dimension.</p>
-<dl class="docutils" id="u-full">
-<dt><strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>]</dt>
-<dd>Draw Unix System time stamp on plot. By adding <em>just/dx/dy/</em>, the
-user may specify the justification of the stamp and where the stamp
-should fall on the page relative to lower left corner of the plot.
-For example, BL/0/0 will align the lower left corner of the time
-stamp with the lower left corner of the plot. Optionally, append a
-<em>label</em>, or <strong>c</strong> (which will plot the command string.). The GMT
-parameters <a class="reference internal" href="gmt.conf.html#map-logo"><em>MAP_LOGO</em></a>, <a class="reference internal" href="gmt.conf.html#map-logo-pos"><em>MAP_LOGO_POS</em></a>, and
-<a class="reference internal" href="gmt.conf.html#format-time-stamp"><em>FORMAT_TIME_STAMP</em></a> can affect the appearance; see the
-<a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> man page for details. The time string will be in the
-locale set by the environment variable <strong>TZ</strong> (generally local
-time).</dd>
-</dl>
-<dl class="docutils" id="v-full">
-<dt><strong>-V</strong>[<em>level</em>]</dt>
-<dd>Select verbose mode, which will send progress reports to <em>stderr</em>.
-Choose among 6 levels of verbosity; each level adds mode messages:
-<strong>q</strong> - Complete silence, not even fatal error messages are produced.
-<strong>n</strong> - Normal verbosity: produce only fatal error messages.
-<strong>c</strong> - Produce also compatibility warnings (same as when <strong>-V</strong> is omitted).
-<strong>v</strong> - Produce also warnings and progress messages (same as <strong>-V</strong> only).
-<strong>l</strong> - Produce also detailed progress messages.
-<strong>d</strong> - Produce also debugging messages.</dd>
-</dl>
-<p id="xy-full"><strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]]</p>
-<dl class="docutils">
-<dt><strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]]</dt>
-<dd>Shift plot origin relative to the current origin by
-(<em>x-shift</em>,<em>y-shift</em>) and optionally append the length unit
-(<strong>c</strong>, <strong>i</strong>, or <strong>p</strong>). You can prepend <strong>a</strong> to shift the origin
-back to the original position after plotting, prepend <strong>c</strong> to
-center the plot on the center of the paper (optionally add shift),
-prepend <strong>f</strong> to shift the origin relative to the fixed lower left
-corner of the page, or prepend <strong>r</strong> [Default] to move the origin
-relative to its current location. If <strong>-O</strong> is used then the default
-(<em>x-shift</em>,<em>y-shift</em>) is (r0), otherwise it is (r1i). When <strong>-X</strong>
-or <strong>-Y</strong> are used without any further arguments, the values from
-the last use of that option in a previous GMT command will be used.</dd>
-</dl>
-<dl class="docutils" id="aspatial-full">
-<dt><strong>-a</strong>[<em>col</em>=]<em>name</em>[<em>...</em>]</dt>
-<dd>Control how aspatial data are handled in GMT during input and output.
-Reading OGR/GMT-formatted files. To assign certain aspatial data
-items to GMT data columns, give one or more comma-separated
-associations <em>col</em>=<em>name</em>, where <em>name</em> is the name of an
-aspatial attribute field in a OGR/GMT file and whose value we wish
-to as data input for column <em>col</em>. In addition, to assign an
-aspatial value to non-column data, you may specify <em>col</em> as <strong>D</strong>
-for <em>distance</em>, <strong>G</strong> for <em>fill</em>, <strong>I</strong> for <em>ID</em>, <strong>L</strong> for <em>label</em>,
-<strong>T</strong> for <em>text</em>, <strong>W</strong> for <em>pen</em>, and <strong>Z</strong> for <em>value</em> [e.g., used
-to look-up color via a CPT]. If you skip the leading “<em>col</em>=” in
-the argument then we supply (and automatically increment) a column
-value starting at 2.
-Write OGR/GMT-formatted files. Give one or more comma-separated
-associations <em>col</em>=<em>name</em>[:<em>type</em>], To write OGR/GMT-formatted
-files, give one or more comma-separated associations
-<em>col</em>=<em>name</em>[:<em>type</em>], with an optional data type from DOUBLE,
-FLOAT, INTEGER, CHAR, STRING, DATETIME, or LOGICAL [DOUBLE]. To
-extract information from GMT multisegment headers encoded in the
-<strong>-D</strong><em>distance</em>, <strong>-G</strong><em>fill</em>, <strong>-I</strong><em>ID</em>, <strong>-L</strong><em>label</em>,
-<strong>-T</strong><em>text</em>, <strong>-W</strong><em>pen</em>, or <strong>-Z</strong><em>value</em> settings, specify
-<em>COL</em> as <strong>D</strong>, <strong>G</strong>, <strong>I</strong>, <strong>L</strong>, <strong>T</strong>, <strong>W</strong> or <strong>Z</strong>,
-respectively; type will be set automatically. Finally, you <em>must</em>
-append <strong>+g</strong><em>geometry</em>, where <em>geometry</em> is either POINT, LINE,
-or POLY. Optionally, prepend <strong>M</strong> for multi-versions of these
-geometries. To force the clipping of features crossing the Dateline,
-use upper-case <strong>+G</strong> instead. See GMT Appendix Q for details of the
-OGR/GMT file format.</dd>
-</dl>
-<dl class="docutils" id="bi-full">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>]</dt>
-<dd>Select binary input. Append one or more comma-separated combinations
-of <em>ncols</em><em>type</em>, where <em>ncols</em> is the actual number of data
-columns and <em>type</em> must be one of <strong>c</strong> (int8_t, aka char), <strong>u</strong>
-(uint8_t, aka unsigned char), <strong>h</strong> (int16_t, 2-byte signed int),
-<strong>H</strong> (uint16_t, 2-byte unsigned int), <strong>i</strong> (int32_t, 4-byte
-signed int), <strong>I</strong> ((capital i) uint32_t, 4-byte unsigned int), <strong>l</strong>
-((lower case el) int64_t, 8-byte signed int), <strong>L</strong> (uint64_t, 8-byte unsigned
-int), <strong>f</strong> (4-byte single-precision float), and <strong>d</strong> (8-byte
-double-precision float). In addition, use <strong>x</strong> to skip <em>ncols</em>
-bytes anywhere in the record. Append <strong>w</strong> to any item to force
-byte-swapping. Alternatively, append <strong>+L</strong>|<strong>B</strong> to indicate
-that the entire data file should be read as little- or big-endian,
-respectively. The total number of <em>ncols</em> may exceed the columns
-actually needed by the program. If no <em>ncols</em> is specified we assume
-that <em>type</em> applies to all columns and that <em>ncols</em> is implied by
-the expectation of the program. If the input file is netCDF, no
-<strong>-b</strong> is needed; simply append <strong>?</strong><em>var1</em><strong>/</strong><em>var2</em><strong>/</strong><em>...</em>
-to the filename to specify the variables to be read.</dd>
-</dl>
-<dl class="docutils" id="bo-full">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>]</dt>
-<dd>Select binary output. Append one or more comma-separated
-combinations of <em>ncols</em>/<em>type</em>, where <em>ncols</em> is the actual number
-of data columns and <em>type</em> must be one of <strong>c</strong>, <strong>u</strong>, <strong>h</strong>,
-<strong>H</strong>, <strong>i</strong>, <strong>I</strong> (capital i), <strong>l</strong> (lower case elle), <strong>L</strong>, <strong>f</strong>, and <strong>d</strong> (see <strong>-bi</strong>).
-Append <strong>w</strong> or <strong>+L</strong>|<strong>B</strong> for byte-swapping. <em>ncols</em> is the
-number of each item in the binary file. If no <em>ncols</em> is specified
-we assume that <em>type</em> applies to all columns and that <em>ncols</em> is
-implied by the default output of the program. NetCDF file output is
-not supported.</dd>
-</dl>
-<dl class="docutils" id="c-full">
-<dt><strong>-c</strong><em>copies</em></dt>
-<dd>Specify number of plot copies. [Default is 1]. When used without
-argument, use the same number of copies and specified in the last
-<strong>-c</strong> in a previous GMT command.</dd>
-</dl>
-<dl class="docutils" id="colon-full">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>]</dt>
-<dd>Swap 1st and 2nd column on input and/or output [Default is no
-swapping]. Append <strong>i</strong> to select input only or <strong>o</strong> to select
-output only. [Default affects both]. This option is typically used
-to handle (latitude, longitude) files; see also
-<strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>].</dd>
-</dl>
-<dl class="docutils" id="f-full">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em></dt>
-<dd>Specify the data types of input and/or output columns (time or
-geographical data). Specify <strong>i</strong> or <strong>o</strong> to make this apply only
-to input or output [Default applies to both]. Give one or more
-columns (or column ranges) separated by commas, or use <strong>-f</strong>
-multiple times. Append <strong>T</strong> (absolute calendar time), <strong>t</strong>
-(relative time in chosen <a class="reference internal" href="gmt.conf.html#time-unit"><em>TIME_UNIT</em></a> since <a class="reference internal" href="gmt.conf.html#time-epoch"><em>TIME_EPOCH</em></a>),
-<strong>x</strong> (longitude), <strong>y</strong> (latitude), <strong>p</strong>[<em>unit</em>] (projected
-x,y map coordinates in given unit [meter]) or <strong>f</strong> (floating point)
-to each column or column range item. Shorthand
-<strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<strong>g</strong> means
-<strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]0<strong>x</strong>,1<strong>y</strong> (geographic
-coordinates).</dd>
-</dl>
-<dl class="docutils" id="g-full">
-<dt><strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>]</dt>
-<dd>Examine the spacing between consecutive data points in order to
-impose breaks in the line. Append <strong>x</strong>|<strong>X</strong> or
-<strong>y</strong>|<strong>Y</strong> to define a gap when there is a large enough change
-in the x or y coordinates, respectively, or <strong>d</strong>|<strong>D</strong> for
-distance gaps; use upper case to calculate gaps from projected
-coordinates. For gap-testing on other columns use [<em>col</em>]<strong>z</strong>;
-if <em>col</em> is not prepended the it defaults to 2 (i.e., 3rd column).
-Append [+|-]<em>gap</em> and optionally a unit <strong>u</strong>. Regarding optional
-signs: -ve means previous minus current column value must exceed
-<em>gap</em> to be a gap, +ve means current minus previous column value
-must exceed <em>gap</em>, and no sign means the absolute value of the
-difference must exceed <em>gap</em>. For geographic data
-(<strong>x</strong>|<strong>y</strong>|<strong>d</strong>), the unit <strong>u</strong> may be arc
-<strong>d</strong>egree, <strong>m</strong>inute, or <strong>s</strong>econd, or m<strong>e</strong>ter
-[Default], <strong>f</strong>oot, <strong>k</strong>ilometer, <strong>M</strong>ile, <strong>n</strong>autical
-mile, or s<strong>u</strong>rvey foot. For projected data
-(<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>), choose from <strong>i</strong>nch,
-<strong>c</strong>entimeter, or <strong>p</strong>oint [Default unit set by
-<a class="reference internal" href="gmt.conf.html#proj-length-unit"><em>PROJ_LENGTH_UNIT</em></a>]. Note: For <strong>x</strong>|<strong>y</strong>|<strong>z</strong> with
-time data the unit is instead controlled by <a class="reference internal" href="gmt.conf.html#time-unit"><em>TIME_UNIT</em></a>. Repeat
-the option to specify multiple criteria, of which any can be met to
-produce a line break. Issue an additional <strong>-ga</strong> to indicate that
-all criteria must be met instead.</dd>
-</dl>
-<dl class="docutils" id="h-full">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+t</strong><em>title</em>]</dt>
-<dd>Input file(s) has header record(s). If used, the default number of
-header records is <a class="reference internal" href="gmt.conf.html#io-n-header-recs"><em>IO_N_HEADER_RECS</em></a> [1]. Use <strong>-hi</strong> if only
-input data should have header records [Default will write out header
-records if the input data have them]. Blank lines and lines starting
-with # are always skipped. For output you may request additional headers
-to be written via the option modifiers, and use <strong>+d</strong> to remove existing
-header records. Append <strong>+c</strong> to issue a header comment with column names to the output [none].
-Append <strong>+r</strong> to add a <em>remark</em> comment to the output [none].
-Append <strong>+t</strong> to add a <em>title</em> comment to the output [none].
-These optional strings may contain n to indicate line-breaks).
-If used with native binary data we interpret <em>n</em> to instead mean the
-number of bytes to skip on input or pad on output.</dd>
-</dl>
-<dl class="docutils" id="icols-full">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>]</dt>
-<dd>Select specific data columns for input, in arbitrary order. Columns
-not listed will be skipped. Give columns (or column ranges)
-separated by commas [Default reads all columns in order, starting
-with the first column (0)]. To each column, optionally add any of
-the following, in this order: <strong>l</strong> takes the <strong>log10</strong> of the input
-values first; <strong>s</strong><em>scale</em>, subsequently multiplies by a given
-scale factor; <strong>o</strong><em>offset</em>, finally adds a given offset.</dd>
-</dl>
-<dl class="docutils" id="n-full">
-<dt><strong>-n</strong>[<strong>b</strong>|<strong>c</strong>|<strong>l</strong>|<strong>n</strong>][<strong>+a</strong>][<strong>+b</strong><em>BC</em>][<strong>+c</strong>][<strong>+t</strong><em>threshold</em>]</dt>
-<dd>Select grid interpolation mode by adding <strong>b</strong> for B-spline
-smoothing, <strong>c</strong> for bicubic interpolation, <strong>l</strong> for bilinear
-interpolation, or <strong>n</strong> for nearest-neighbor value (for example to
-plot categorical data). Optionally, append <strong>+a</strong> to switch off
-antialiasing (where supported). Append <strong>+b</strong><em>BC</em> to override the
-boundary conditions used, adding <strong>g</strong> for geographic, <strong>p</strong> for
-periodic, or <strong>n</strong> for natural boundary conditions. For the latter
-two you may append <strong>x</strong> or <strong>y</strong> to specify just one direction,
-otherwise both are assumed. Append <strong>+c</strong> to clip the interpolated
-grid to input z-min/max [Default may exceed limits]. Add append <strong>+t</strong><em>threshold</em> to
-control how close to nodes with NaNs the interpolation will go. A
-<em>threshold</em> of 1.0 requires all (4 or 16) nodes involved in
-interpolation to be non-NaN. 0.5 will interpolate about half way
-from a non-NaN value; 0.1 will go about 90% of the way, etc.
-[Default is bicubic interpolation with antialiasing and a threshold
-of 0.5, using geographic (if grid is known to be geographic) or
-natural boundary conditions].</dd>
-</dl>
-<dl class="docutils" id="ocols-full">
-<dt><strong>-o</strong><em>cols</em>[,...]</dt>
-<dd>Select specific data columns for output, in arbitrary order. Columns
-not listed will be skipped. Give columns (or column ranges)
-separated by commas [Default writes all columns in order].</dd>
-</dl>
-<dl class="docutils" id="perspective-full">
-<dt><strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>]</dt>
-<dd>Selects perspective view and sets the azimuth and elevation of the
-viewpoint [180/90]. When <strong>-p</strong> is used in consort with <strong>-Jz</strong> or
-<strong>-JZ</strong>, a third value can be appended which indicates at which
-z-level all 2D material, like the plot frame, is plotted (in
-perspective). [Default is at the bottom of the z-axis]. Use <strong>-px</strong>
-or <strong>-py</strong> to plot against the “wall” x = level or y = level
-(default is on the horizontal plane, which is the same as using
-<strong>-pz</strong>). For frames used for animation, you may want to append
-<strong>+</strong> to fix the center of your data domain (or specify a particular
-world coordinate point with <strong>+w</strong><em>lon0</em>/<em>lat</em>[/<em>z</em>]) which will
-project to the center of your page size (or specify the coordinates
-of the projected view point with <strong>+v</strong><em>x0</em>/<em>y0</em>. When <strong>-p</strong> is
-used without any further arguments, the values from the last use of
-<strong>-p</strong> in a previous GMT command will be used.</dd>
-</dl>
-<dl class="docutils" id="nodereg-full">
-<dt><strong>-r</strong></dt>
-<dd>Force pixel node registration [Default is gridline registration].
-(Node registrations are defined in Section <a class="reference internal" href="GMT_Docs.html#grid-registration"><em>Grid registration: The -r option</em></a>
-of the GMT Technical Reference and Cookbook.)</dd>
-</dl>
-<dl class="docutils" id="s-full">
-<dt><strong>-s</strong>[<em>cols</em>][<strong>a</strong>|<strong>r</strong>]</dt>
-<dd>Suppress output for records whose <em>z</em>-value equals NaN [Default
-outputs all records]. Append <strong>a</strong> to skip records where at least
-one field equal NaN. Append <strong>r</strong> to reverse the suppression, i.e.,
-only output the records whose <em>z</em>-value equals NaN. Alternatively,
-indicate a comma-separated list of all columns or column ranges to
-consider for this NaN test.</dd>
-</dl>
-<dl class="docutils" id="t-full">
-<dt><strong>-t</strong>[<em>transp</em>]</dt>
-<dd>Set PDF transparency level for an overlay, in 0-100 percent range. [Default
-is 0, i.e., opaque].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-<div class="section" id="specifying-color">
-<h3><a class="reference internal" href="#specifying-color">Specifying Color</a><a class="headerlink" href="#specifying-color" title="Permalink to this headline">¶</a></h3>
-<dl class="docutils">
-<dt><em>color</em></dt>
-<dd>The <em>color</em> of lines, areas and patterns can be specified by a valid
-color name; by a gray shade (in the range 0-255); by a decimal color
-code (r/g/b, each in range 0-255; h-s-v, ranges 0-360, 0-1, 0-1; or
-c/m/y/k, each in range 0-1); or by a hexadecimal color code
-(#rrggbb, as used in HTML). For PDF transparency, append
-@<em>transparency</em> in the 0-100 percent range [0 or opaque]. See the
-<strong>gmtcolors</strong> manpage for more information and a full list of color
-names. See GMT Cookbook & Technical Reference Chapter 4 for more
-information.</dd>
-</dl>
-</div>
-<div class="section" id="specifying-fill">
-<h3><a class="reference internal" href="#specifying-fill">Specifying Fill</a><a class="headerlink" href="#specifying-fill" title="Permalink to this headline">¶</a></h3>
-<dl class="docutils">
-<dt><em>fill</em></dt>
-<dd>The attribute <em>fill</em> specifies the solid shade or solid <em>color</em> (see
-<a class="reference internal" href="#specifying-color">Specifying Color</a> above) or the pattern used for filling polygons.
-Patterns are specified as <strong>p</strong><em>dpi/pattern</em>, where <em>pattern</em>
-gives the number of the built-in pattern (1-90) <em>or</em> the name of a
-Sun 1-, 8-, or 24-bit raster file. The <em>dpi</em> sets the resolution of
-the image. For 1-bit rasters: use <strong>P</strong><em>dpi/pattern</em> for inverse
-video, or append <strong>:F</strong><em>color</em>[<strong>B</strong>[<em>color</em>]] to specify
-fore- and background colors (use <em>color</em> = - for transparency). See
-GMT Cookbook & Technical Reference Appendix E for information on
-individual patterns.</dd>
-</dl>
-</div>
-<div class="section" id="specifying-fonts">
-<h3><a class="reference internal" href="#specifying-fonts">Specifying Fonts</a><a class="headerlink" href="#specifying-fonts" title="Permalink to this headline">¶</a></h3>
-<dl class="docutils">
-<dt><em>font</em></dt>
-<dd><p class="first">The attributes of text fonts as defined by <em>font</em> is a comma
-delimited list of <em>size</em>, <em>fonttype</em> and <em>fill</em>, each of which is
-optional. <em>size</em> is the font size (usually in points) but <strong>c</strong> or
-<strong>i</strong> can be added to indicate other units. <em>fonttype</em> is the name
-(case sensitive!) of the font or its equivalent numerical ID (e.g.,
-Helvetica-Bold or 1). <em>fill</em> specifies the gray shade, color or
-pattern of the text (see <a class="reference internal" href="#specifying-fill">Specifying Fill</a> above). Optionally, you may
-append <strong>=</strong><em>pen</em> to the <em>fill</em> value in order to draw the text
-outline; if used you may optionally skip the text fill by setting it
-to <strong>-</strong>. If any of the attributes is omitted their default or
-previous setting will be retained.</p>
-<p>The 35 available fonts are:</p>
-<ol class="last arabic simple" start="0">
-<li>Helvetica</li>
-<li>Helvetica-Bold</li>
-<li>Helvetica-Oblique</li>
-<li>Helvetica-BoldOblique</li>
-<li>Times-Roman</li>
-<li>Times-Bold</li>
-<li>Times-Italic</li>
-<li>Times-BoldItalic</li>
-<li>Courier</li>
-<li>Courier-Bold</li>
-<li>Courier-Oblique</li>
-<li>Courier-BoldOblique</li>
-<li>Symbol</li>
-<li>AvantGarde-Book</li>
-<li>AvantGarde-BookOblique</li>
-<li>AvantGarde-Demi</li>
-<li>AvantGarde-DemiOblique</li>
-<li>Bookman-Demi</li>
-<li>Bookman-DemiItalic</li>
-<li>Bookman-Light</li>
-<li>Bookman-LightItalic</li>
-<li>Helvetica-Narrow</li>
-<li>Helvetica-Narrow-Bold</li>
-<li>Helvetica-Narrow-Oblique</li>
-<li>Helvetica-Narrow-BoldOblique</li>
-<li>NewCenturySchlbk-Roman</li>
-<li>NewCenturySchlbk-Italic</li>
-<li>NewCenturySchlbk-Bold</li>
-<li>NewCenturySchlbk-BoldItalic</li>
-<li>Palatino-Roman</li>
-<li>Palatino-Italic</li>
-<li>Palatino-Bold</li>
-<li>Palatino-BoldItalic</li>
-<li>ZapfChancery-MediumItalic</li>
-<li>ZapfDingbats</li>
-</ol>
-</dd>
-</dl>
-</div>
-<div class="section" id="specifying-pens">
-<span id="set-pens"></span><h3>Specifying Pens<a class="headerlink" href="#specifying-pens" title="Permalink to this headline">¶</a></h3>
-<dl class="docutils">
-<dt><em>pen</em></dt>
-<dd>The attributes of lines and symbol outlines as defined by <em>pen</em> is a
-comma-delimited list of <em>width</em>, <em>color</em> and <em>style</em>, each of which
-is optional. <em>width</em> can be indicated as a measure (in <strong>p</strong>oints
-(this is the default), <strong>c</strong>entimeters, or <strong>i</strong>nches) or as
-<strong>faint</strong>, <strong>default</strong>, <strong>thin</strong>[<strong>ner</strong>|<strong>nest</strong>],
-<strong>thick</strong>[<strong>er</strong>|<strong>est</strong>], <strong>fat</strong>[<strong>ter</strong>|<strong>test</strong>],
-or <strong>obese</strong>. <em>color</em> specifies a gray shade or color (see
-<a class="reference internal" href="#specifying-color">Specifying Color</a> above). <em>style</em> is a combination of dashes ‘-‘ and
-dots ‘.’. If any of the attributes is omitted their default or
-previous setting will be retained. See GMT Cookbook & Technical
-Reference Chapter 4 for more information.</dd>
-</dl>
-</div>
-</div>
-<div class="section" id="ascii-format-precision">
-<h2>Ascii Format Precision<a class="headerlink" href="#ascii-format-precision" title="Permalink to this headline">¶</a></h2>
-<p>The ASCII output formats of numerical data are controlled by parameters
-in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file. Longitude and latitude are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>, whereas other values are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>. Be aware that the format in effect
-can lead to loss of precision in the output, which can lead to various
-problems downstream. If you find the output is not written with enough
-precision, consider switching to binary output (<strong>-bo</strong> if available) or
-specify more decimals using the <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> setting.</p>
-</div>
-<div class="section" id="grid-file-formats">
-<h2>Grid File Formats<a class="headerlink" href="#grid-file-formats" title="Permalink to this headline">¶</a></h2>
-<p>By default GMT writes out grid as single precision floats in a
-COARDS-complaint netCDF file format. However, GMT is able to produce
-grid files in many other commonly used grid file formats and also
-facilitates so called “packing” of grids, writing out floating point
-data as 1- or 2-byte integers. To specify the precision, scale and
-offset, the user should add the suffix
-<strong>=</strong><em>id</em>[<strong>/</strong><em>scale</em><strong>/</strong><em>offset</em>[<strong>/</strong><em>nan</em>]], where
-<em>id</em> is a two-letter identifier of the grid type and precision, and
-<em>scale</em> and <em>offset</em> are optional scale factor and offset to be applied
-to all grid values, and <em>nan</em> is the value used to indicate missing
-data. When reading grids, the format is generally automatically
-recognized. If not, the same suffix can be added to input grid file
-names. See <a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section
-<a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a>
-of the GMT Technical Reference and Cookbook for more information.</p>
-<p>When reading a netCDF file that contains multiple grids, GMT will
-read, by default, the first 2-dimensional grid that can find in that
-file. To coax GMT into reading another multi-dimensional variable in
-the grid file, append <strong>?</strong><em>varname</em> to the file name, where <em>varname</em>
-is the name of the variable. Note that you may need to escape the
-special meaning of <strong>?</strong> in your shell program by putting a backslash in
-front of it, or by placing the filename and suffix between quotes or
-double quotes. The <strong>?</strong><em>varname</em> suffix can also be used for output
-grids to specify a variable name different from the default: “z”. See
-<a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section <a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a> of the GMT
-Technical Reference and Cookbook for more information, particularly on
-how to read splices of 3-, 4-, or 5-dimensional grids.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p>Look up the individual man pages for more details and full syntax. Run
-<tt class="docutils literal"><span class="pre">gmt</span> <span class="pre">--help</span></tt> to list all GMT programs and to show all installation
-directories. For an explanation of the various GMT settings in this
-man page (like <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>), see the man page of the GMT
-configuration file <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>. Information is also available on the
-GMT home page <a class="reference external" href="http://gmt.soest.hawaii.edu/">http://gmt.soest.hawaii.edu/</a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">gmt</a><ul>
-<li><a class="reference internal" href="#introduction">Introduction</a></li>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#command-line-completion">Command-line completion</a></li>
-<li><a class="reference internal" href="#gmt-overview">GMT Overview</a></li>
-<li><a class="reference internal" href="#custom-modules">Custom Modules</a></li>
-<li><a class="reference internal" href="#the-common-gmt-options">The Common GMT Options</a></li>
-<li><a class="reference internal" href="#description">Description</a><ul>
-<li><a class="reference internal" href="#specifying-color">Specifying Color</a></li>
-<li><a class="reference internal" href="#specifying-fill">Specifying Fill</a></li>
-<li><a class="reference internal" href="#specifying-fonts">Specifying Fonts</a></li>
-<li><a class="reference internal" href="#specifying-pens">Specifying Pens</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#ascii-format-precision">Ascii Format Precision</a></li>
-<li><a class="reference internal" href="#grid-file-formats">Grid File Formats</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="gmt.conf.html"
- title="previous chapter">gmt.conf</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="gmt2kml.html"
- title="next chapter">gmt2kml</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/gmt.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="gmt2kml.html" title="gmt2kml"
- >next</a> </li>
- <li class="right" >
- <a href="gmt.conf.html" title="gmt.conf"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" >GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gmt2kml.html b/doc_release/html/gmt2kml.html
deleted file mode 100644
index 1be9871..0000000
--- a/doc_release/html/gmt2kml.html
+++ /dev/null
@@ -1,477 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>gmt2kml — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GM" href="GM.html" />
- <link rel="next" title="gmt5syntax" href="gmt5syntax.html" />
- <link rel="prev" title="gmt" href="gmt.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="gmt5syntax.html" title="gmt5syntax"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="gmt.html" title="gmt"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" accesskey="U">GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gmt2kml">
-<span id="index-0"></span><h1>gmt2kml<a class="headerlink" href="#gmt2kml" title="Permalink to this headline">¶</a></h1>
-<p>gmt2kml - Convert GMT data tables to KML files for Google Earth</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmt2kml</strong> [ <em>table</em> ]
-[ <strong>-A</strong><strong>a</strong>|<strong>g</strong>|<strong>s</strong>[<em>alt</em>|<strong>x</strong><em>scale</em>] ]
-[ <strong>-C</strong><em>cpt</em> ] [ <strong>-D</strong><em>descriptfile</em> ] [ <strong>-E</strong>[<em>altitude</em>] ]
-[ <strong>-F</strong><strong>e</strong>|<strong>s</strong>|<strong>t</strong>|<strong>l</strong>|<strong>p</strong> ]
-[ <strong>-G</strong><strong>f|n</strong><strong>-</strong>|<em>fill</em> ] [ <strong>-I</strong><em>icon</em> ] [ <strong>-K</strong>]
-[ <strong>-L</strong><em>col1:name1</em>,<em>col2:name2</em>,... ]
-[ <strong>-N</strong>[+|*name_template*|<em>name</em>] ] [ <strong>-O</strong>]
-[ <strong>-Ra</strong>|<em>w/e/s/n</em> ] [ <strong>-S</strong><strong>c</strong>|<strong>n</strong><em>scale</em>] ]
-[ <strong>-T</strong><em>title</em>[/<em>foldername</em>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W</strong>[<strong>-</strong>|<strong>+</strong>]<em>pen</em> ] [ <strong>-Z</strong><em>args</em> ]
-[ <strong>-bi</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]
-[ > <em>output.kml</em> ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmt2kml</strong> reads one or more GMT table file and converts them to a
-single output file using Google Earth’s KML format. Data may represent
-points, lines, or polygons, and you may specify additional attributes
-such as title, altitude mode, colors, pen widths, transparency, regions,
-and data descriptions. You may also extend the feature down to ground
-level (assuming it is above it) and use custom icons for point symbols.</p>
-<p>The input files should contain the following columns:</p>
-<p><em>lon</em> <em>lat</em> [ <em>alt</em> ] [ <em>timestart</em> [ <em>timestop</em> ] ]</p>
-<p>where <em>lon</em> and <em>lat</em> are required for all features, <em>alt</em> is optional
-for all features (see also <strong>-A</strong> and <strong>-C</strong>), and <em>timestart</em> and
-<em>timestop</em> apply to events and timespan features.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<p>None.</p>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>[<em>ncols</em>][<em>type</em>]) data
-table file(s) holding a number of data columns. If no tables are given
-then we read from standard input. </dd>
-<dt><strong>-A</strong><strong>a</strong>|<strong>g</strong>|<strong>s</strong>[<em>alt</em>|<strong>x</strong><em>scale</em>]</dt>
-<dd>Select one of three altitude modes recognized by Google Earth that
-determines the altitude (in m) of the feature: <strong>a</strong> absolute
-altitude, <strong>g</strong> altitude relative to sea surface or ground, <strong>s</strong>
-altitude relative to seafloor or ground. To plot the features at a
-fixed altitude, append an altitude <em>alt</em> (in m). Use 0 to clamp the
-features to the chosen reference surface. Append <strong>x</strong><em>scale</em> to
-scale the altitude from the input file by that factor. If no value
-is appended, the altitude (in m) is read from the 3rd column of the
-input file. [By default the features are clamped to the sea surface or ground].</dd>
-<dt><strong>-C</strong><em>cpt</em></dt>
-<dd>Use color palette for assigning colors to the symbol, event, or
-timespan icons, based on the value in the 3rd column of the input
-file. For lines or polygons we examine the segment header for
--Z<value> statements and obtain the color via the cpt lookup. Note
-only discrete colors are possible.</dd>
-<dt><strong>-D</strong><em>descriptfile</em></dt>
-<dd>File with HTML snippets that will be included as part of the main
-description content for the KML file [no description]. See SEGMENT
-INFORMATION below for feature-specific descriptions.</dd>
-<dt><strong>-E</strong>[<em>altitude</em>]</dt>
-<dd>Extrude feature down to ground level [no extrusion].</dd>
-<dt><strong>-F</strong><strong>e</strong>|<strong>s</strong>|<strong>t</strong>|<strong>l</strong>|<strong>p</strong></dt>
-<dd>Sets the feature type. Choose from points (<strong>e</strong>vent,
-<strong>s</strong>ymbol, or <strong>t</strong>imespan), <strong>l</strong>ine, or <strong>p</strong>olygon
-[symbol]. The first two columns of the input file should contain
-(<em>lon</em>, <em>lat</em>). When altitude or value is required (i.e., no
-<em>altitude</em> value was given with <strong>-A</strong>, or <strong>-C</strong> is set), the third
-column needs to contain the <em>altitude</em> (in m) or <em>value</em>. The event
-(<strong>-Fe</strong>) is a symbol that should only be active at a particular
-<em>time</em>, given in the next column. Timespan (<strong>-Ft</strong>) is a symbol
-that should only be active during a particular time period indicated
-by the next two columns (<em>timestart</em>, <em>timestop</em>). Use NaN to
-indicate unbounded time limits. If used, times should be in ISO
-format yyyy-mm-ddThh:mm:ss[.xxx] or in GMT relative time format (see <strong>-f</strong>).</dd>
-<dt><strong>-G</strong><strong>f|n</strong><em>fill</em></dt>
-<dd>Set fill color for symbols, extrusions and polygons (<strong>-Gf</strong>)
-[Default is light orange at 75% transparency] or text labels
-(<strong>-Gn</strong>) [Default is white]. Optionally, use <strong>-Gf-</strong> to turn off
-polygon fill, and <strong>-Gn-</strong> to disable labels.</dd>
-<dt><strong>-I</strong><em>icon</em></dt>
-<dd>Specify the URL to an alternative icon that should be used for the
-symbol [Default is a Google Earth circle]. If the URL starts with +
-then we will prepend
-<a class="reference external" href="http://maps.google.com/mapfiles/kml/">http://maps.google.com/mapfiles/kml/</a>
-to the name. To turn off icons entirely (e.g., when just wanting a
-text label), use <strong>-I</strong>-. [Default is a local icon with no directory path].</dd>
-<dt><strong>-K</strong></dt>
-<dd>Allow more KML code to be appended to the output later [finalize the KML file].</dd>
-<dt><strong>-L</strong><em>name1</em>,<em>name2</em>,...</dt>
-<dd>Extended data given. Append one or more column names separated by
-commas. We will expect the listed data columns to exist in the input
-immediately following the data coordinates and they will be encoded
-in the KML file as Extended Data sets, whose attributes will be
-available in the Google Earth balloon when the item is selected.
-This option is not available unless input is an ASCII file.</dd>
-<dt><strong>-N</strong>[-|+|<em>name_template</em>|<em>name</em>]</dt>
-<dd>By default, if segment headers contain a <strong>-L</strong>“label string” then
-we use that for the name of the KML feature (polygon, line segment
-or set of symbols). Default names for these segments are “Line %d”
-and “Point Set %d”, depending on the feature, where %d is a sequence
-number of line segments within a file. Each point within a line
-segment will be named after the line segment plus a sequence number.
-Default is simply “Point %d”.
-Alternatively, select one of these options: (1) append <strong>-</strong> to
-supply individual symbol labels (single word) via the field
-immediately following the data coordinates, (2) append <strong>+</strong> to
-supply individual symbol labels as the rest the end of the data
-record following the data coordinates, (3) append a string that may
-include %d or a similar integer format to assign unique name IDs for
-each feature, with the segment number (for lines and polygons) or
-point number (symbols) appearing where %d is placed, (4) give no
-arguments to turn symbol labeling off; line segments will still be
-named. Note: if <strong>-N-</strong> is used with <strong>-L</strong> then the label must
-appear before the extended data columns. Also note that options
-(1) and (2) are not available unless input is an ASCII file.</dd>
-<dt><strong>-O</strong></dt>
-<dd>Appended KML code to an existing KML file [initialize a new KML file].</dd>
-<dt><strong>-Ra</strong>|<em>w/e/s/n</em></dt>
-<dd>Issue a single Region tag. Append <em>w/e/s/n</em> to set a particular
-region (will ignore points outside the region), or append <strong>a</strong> to
-determine and use the actual domain of the data (single file only)
-[no region tags issued].</dd>
-<dt><strong>-S</strong><strong>c</strong>|<strong>n</strong><em>scale</em>]</dt>
-<dd>Scale icons or labels. Here, <strong>-Sc</strong> sets a scale for the symbol
-icon, whereas <strong>-Sn</strong> sets a scale for the name labels [1 for both].</dd>
-<dt><strong>-T</strong><em>title</em>[/<em>foldername</em>]</dt>
-<dd>Sets the document title [default is unset]. Optionally, append
-/<em>FolderName</em>; this allows you, with <strong>-O</strong>, <strong>-K</strong>, to group
-features into folders within the KML document. [The default folder
-name is “<em>Name</em> Features”, where <em>Name</em> is Point, Event, Timespan,
-Line, or Polygon].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong>[<strong>-</strong>|<strong>+</strong>]<em>pen</em></dt>
-<dd>Set pen attributes for lines or polygon outlines. Append pen
-attributes to use [Defaults: width = default, color = black, style =
-solid]. If <strong>-C</strong> is given you may optionally use <strong>-W-</strong> to apply
-the cpt color to the polygon outline only (fill determined by
-<strong>-G</strong>) or <strong>-W+</strong> to use the cpt color for both polygon fill and
-outline. Note that for KML the pen width is given as integer pixel
-widths so you must specify pen width as <em>n</em><strong>p</strong>, where <em>n</em> is an
-integer.</dd>
-<dt><strong>-Z</strong><em>args</em></dt>
-<dd>Set one or more attributes of the Document and Region tags. Append
-<strong>+a</strong><em>alt_min/alt_max</em> to specify limits on visibility based on
-altitude. Append <strong>+l</strong><em>lod_min/lod_max</em> to specify limits on
-visibility based on Level Of Detail, where <em>lod_max</em> == -1 means it
-is visible to infinite size. Append <strong>+f</strong><em>fade_min/fade_max</em> to
-fade in and out over a ramp [abrupt]. Append <strong>+v</strong> to make a
-feature <em>not</em> visible when loaded [visible]. Append <strong>+o</strong> to open a
-folder or document in the sidebar when loaded [closed].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 2 input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] <a class="reference internal" href="gmt.html#g-full"><em>(more ...)</em></a></dt>
-<dd>Determine data gaps and line breaks. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To convert a file with point locations (lon, lat) into a KML file with
-red circle symbols, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt2kml mypoints.txt -Gfred -Fs > mypoints.kml
-</pre></div>
-</div>
-</div></blockquote>
-<p>To convert a multisegment file with lines (lon, lat) separated by
-segment headers that contain a <strong>-L</strong>labelstring with the feature
-name, selecting a thick white pen, and title the document, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt2kml mylines.txt -Wthick,white -Fl -T"Lines from here to there" > mylines.kml
-</pre></div>
-</div>
-</div></blockquote>
-<p>To convert a multisegment file with polygons (lon, lat) separated by
-segment headers that contain a <strong>-L</strong>labelstring with the feature
-name, selecting a thick black pen and semi-transparent yellow fill,
-giving a title to the document, and prescribing a particular region
-limit, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmt2kml mypolygons.txt -Gfyellow at 50 -Fp -T"My polygons" -R30/90/-20/40 > mypolygons.kml
-</pre></div>
-</div>
-</div></blockquote>
-<p>To convert a file with point locations (lon, lat, time) into a KML file
-with green circle symbols that will go active at the specified time and
-stay active going forward, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>awk '{print $1, $2, $3, "NaN"}' mypoints.txt | gmt gmt2kml -Gfgreen -Ft > mytimepoints.kml
-</pre></div>
-</div>
-</div></blockquote>
-<p>To extract contours and labels every 10 units from the grid temp.nc and
-plot them in KML, using red lines at 75% transparency and red labels (no
-transparency), try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdcontour temp.nc -Jx1id -A10+tlabel.txt -C10 -Dcontours.txt
-gmt gmt2kml contours.txt -Fl -W1p,red at 75 -K > contours.kml
-gmt gmt2kml -O -N+ -Fs -Sn2 -Gnred at 0 label.txt -I- >> contours.kml
-</pre></div>
-</div>
-</div></blockquote>
-<p>To instead plot the contours as lines with colors taken from the cpt
-file contours.cpt, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmt2kml contours.txt -Fl -Ccontours.cpt > contours.kml
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="limitations">
-<h2>Limitations<a class="headerlink" href="#limitations" title="Permalink to this headline">¶</a></h2>
-<p>Google Earth has trouble displaying filled polygons across the Dateline.
-For now you must manually break any polygon crossing the dateline into a
-west and east polygon and plot them separately.</p>
-</div>
-<div class="section" id="making-kmz-files">
-<h2>Making Kmz Files<a class="headerlink" href="#making-kmz-files" title="Permalink to this headline">¶</a></h2>
-<p>Using the KMZ format is preferred as it takes less space. KMZ is simply
-a KML file and any data files, icons, or images referenced by the KML,
-contained in a zip archive. One way to organize large data sets is to
-split them into groups called Folders. A Document can contain any number
-of folders. Using scripts you can create a composite KML file using the
-<strong>-K</strong>, <strong>-O</strong> options just like you do with GMT plots. See <strong>-T</strong> for
-switching between folders and documents.</p>
-</div>
-<div class="section" id="kml-hierarchy">
-<h2>Kml Hierarchy<a class="headerlink" href="#kml-hierarchy" title="Permalink to this headline">¶</a></h2>
-<p>GMT stores the different features in hierarchical folders by feature
-type (when using <strong>-O</strong>, <strong>-K</strong> or <strong>-T/</strong><em>foldername</em>), by input file
-(if not standard input), and by line segment (using the name from the
-segment header, or <strong>-N</strong>). This makes it more easy in Google Earth to
-switch on or off parts of the contents of the Document. The following is
-a crude example:</p>
-<p>[ KML header information; not present if <strong>-O</strong> was used ]</p>
-<p><Document><name>GMT Data Document</name></p>
-<p><Folder><name>Point Features</name></p>
-<p><!–This level of folder is inserted only when using -O, -K></p>
-<p><Folder><name>file1.dat</name></p>
-<p><!–One folder for each input file (not when standard input)></p>
-<p><Folder><name>Point Set 0</name></p>
-<p><!–One folder per line segment></p>
-<p><!–Points from the first line segment in file file1.dat go here></p>
-<p><Folder><name>Point Set 1</name></p>
-<p><!–Points from the second line segment in file file1.dat go here></p>
-<p></Folder></p>
-<p></Folder></p>
-<p><Folder><name>Line Features</name></p>
-<p><Folder><name>file1.dat</name></p>
-<p><!–One folder for each input file (not when standard input)></p>
-<p><Placemark><name>Line 0</name></p>
-<p><!–Here goes the first line segment></p>
-<p></Placemark></p>
-<p><Placemark><name>Line 1</name></p>
-<p><!–Here goes the second line segment></p>
-<p></Placemark></p>
-<p></Folder></p>
-<p><Folder></p>
-<p></Document></p>
-<p>[ KML trailer information; not present if <strong>-K</strong> was used ]</p>
-</div>
-<div class="section" id="segment-information">
-<h2>Segment Information<a class="headerlink" href="#segment-information" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmt2kml</strong> will scan the segment headers for substrings of the form
-<strong>-L</strong>“<em>some label</em>” [also see <strong>-N</strong> discussion] and <strong>-T</strong>“<em>some
-text description</em>”. If present, these are parsed to supply name and
-description tags, respectively, for the current feature.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a> , <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>,
-<a class="reference internal" href="supplements/img/img2google.html"><em>img2google</em></a>,
-<a class="reference internal" href="kml2gmt.html"><em>kml2gmt</em></a> , <a class="reference internal" href="ps2raster.html"><em>ps2raster</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">gmt2kml</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#limitations">Limitations</a></li>
-<li><a class="reference internal" href="#making-kmz-files">Making Kmz Files</a></li>
-<li><a class="reference internal" href="#kml-hierarchy">Kml Hierarchy</a></li>
-<li><a class="reference internal" href="#segment-information">Segment Information</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="gmt.html"
- title="previous chapter">gmt</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="gmt5syntax.html"
- title="next chapter">gmt5syntax</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/gmt2kml.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="gmt5syntax.html" title="gmt5syntax"
- >next</a> </li>
- <li class="right" >
- <a href="gmt.html" title="gmt"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" >GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gmt5syntax.html b/doc_release/html/gmt5syntax.html
deleted file mode 100644
index e53b5d5..0000000
--- a/doc_release/html/gmt5syntax.html
+++ /dev/null
@@ -1,168 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>gmt5syntax — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GM" href="GM.html" />
- <link rel="next" title="gmtcolors" href="gmtcolors.html" />
- <link rel="prev" title="gmt2kml" href="gmt2kml.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="gmtcolors.html" title="gmtcolors"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="gmt2kml.html" title="gmt2kml"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" accesskey="U">GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gmt5syntax">
-<span id="index-0"></span><h1>gmt5syntax<a class="headerlink" href="#gmt5syntax" title="Permalink to this headline">¶</a></h1>
-<p>gmt5syntax - Convert old GMT script to use new ‘gmt <module>’ syntax</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmt5syntax</strong> old_script > new_script</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmt5syntax</strong> is a perl script that converts old-style GMT commands in,
-e.g., shell scripts, to the new <tt class="docutils literal"><span class="pre">gmt</span> <span class="pre"><module></span></tt>-syntax. This utility is located
-in the tools subdirectory of the data directory. <tt class="docutils literal"><span class="pre">gmt</span> <span class="pre">--show-datadir</span></tt> will
-show the path to the latter.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">gmt5syntax</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="gmt2kml.html"
- title="previous chapter">gmt2kml</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="gmtcolors.html"
- title="next chapter">gmtcolors</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/gmt5syntax.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="gmtcolors.html" title="gmtcolors"
- >next</a> </li>
- <li class="right" >
- <a href="gmt2kml.html" title="gmt2kml"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" >GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gmt_shell_functions.sh.html b/doc_release/html/gmt_shell_functions.sh.html
deleted file mode 100644
index af73e91..0000000
--- a/doc_release/html/gmt_shell_functions.sh.html
+++ /dev/null
@@ -1,252 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>gmt_shell_functions.sh — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GM" href="GM.html" />
- <link rel="next" title="gmtsimplify" href="gmtsimplify.html" />
- <link rel="prev" title="gmtset" href="gmtset.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="gmtsimplify.html" title="gmtsimplify"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="gmtset.html" title="gmtset"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" accesskey="U">GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gmt-shell-functions-sh">
-<span id="index-0"></span><h1>gmt_shell_functions.sh<a class="headerlink" href="#gmt-shell-functions-sh" title="Permalink to this headline">¶</a></h1>
-<p>gmt_shell_functions.sh - Practical functions to be used in GMT bourne shell scripts</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmt_init_tmpdir</strong></p>
-<p><strong>gmt_remove_tmpdir</strong></p>
-<p><strong>gmt_clean_up</strong> [<em>prefix</em>]</p>
-<p><strong>gmt_message</strong> <em>message</em></p>
-<p><strong>gmt_abort</strong> <em>message</em></p>
-<p><strong>gmt_get_nrecords</strong> <em>file(s)</em></p>
-<p><strong>gmt_get_ndatarecords</strong> <em>file(s)</em></p>
-<p><strong>gmt_get_nfields</strong> <em>string</em></p>
-<p><strong>gmt_get_field</strong> <em>string</em></p>
-<p><strong>gmt_get_region</strong> <em>file(s)</em> [<em>options</em>]</p>
-<p><strong>gmt_get_gridregion</strong> <em>file</em> [<em>options</em>]</p>
-<p><strong>gmt_get_map_width</strong> <strong>-R</strong> <strong>-J</strong></p>
-<p><strong>gmt_get_map_height</strong> <strong>-R</strong> <strong>-J</strong></p>
-<p><strong>gmt_set_psfile</strong> <em>file</em></p>
-<p><strong>gmt_set_pdffile</strong> <em>file</em></p>
-<p><strong>gmt_set_framename</strong> <em>prefix framenumber</em></p>
-<p><strong>gmt_set_framenext</strong> <em>framenumber</em></p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmt_shell_functions.sh</strong> provides a set of functions to Bourne
-(again) shell scripts in support of GMT. The calling shell script
-should include the following line, before the functions can be used:</p>
-<p><strong>. gmt_shell_functions.sh</strong></p>
-<p>Once included in a shell script, <strong>gmt_shell_functions.sh</strong> allows
-GMT users to do some scripting more easily than otherwise. The
-functions made available are:</p>
-<dl class="docutils">
-<dt><strong>gmt_init_tmpdir</strong></dt>
-<dd>Creates a temporary directory in <strong>/tmp</strong> or (when defined) in the
-directory specified by the environment variable <strong>TMPDIR</strong>. The name
-of the temporary directory is returned as environment variable
-<strong>GMT_TMPDIR</strong>. This function also causes GMT to run in
-‘isolation mode’, i.e., all temporary files will be created in
-<strong>GMT_TMPDIR</strong> and the <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file will not be adjusted.</dd>
-<dt><strong>gmt_remove_tmpdir</strong></dt>
-<dd>Removes the temporary directory and unsets the <strong>GMT_TMPDIR</strong>
-environment variable.</dd>
-<dt><strong>gmt_cleanup</strong></dt>
-<dd>Remove all files and directories in which the current process number
-is part of the file name. If the optional <em>prefix</em> is given then we
-also delete all files and directories that begins with the given prefix.</dd>
-<dt><strong>gmt_message</strong></dt>
-<dd>Send a message to standard error.</dd>
-<dt><strong>gmt_abort</strong></dt>
-<dd>Send a message to standard error and exit the shell.</dd>
-<dt><strong>gmt_get_nrecords</strong></dt>
-<dd>Returns the total number of lines in <em>file(s)</em></dd>
-<dt><strong>gmt_get_ndatarecords</strong></dt>
-<dd>Returns the total number of data records in <em>file(s)</em>, i.e., not counting headers.</dd>
-<dt><strong>gmt_get_nfields</strong></dt>
-<dd>Returns the number of fields or words in <em>string</em></dd>
-<dt><strong>gmt_get_field</strong></dt>
-<dd>Returns the given <em>field</em> in a <em>string</em>. Must pass <em>string</em> between
-double quotes to preserve it as one item.</dd>
-<dt><strong>gmt_get_region</strong></dt>
-<dd>Returns the region in the form w/e/s/n based on the data in table
-<em>file(s)</em>. Optionally add -I*dx*/<em>dy</em> to round off the answer.</dd>
-<dt><strong>gmt_get_gridregion</strong></dt>
-<dd>Returns the region in the form w/e/s/n based on the header of a grid
-<em>file</em>. Optionally add -I*dx*/<em>dy</em> to round off the answer.</dd>
-<dt><strong>gmt_get_map_width</strong></dt>
-<dd>Expects the user to give the desired <strong>-R</strong> <strong>-J</strong> settings and
-returns the map width in the current measurement unit.</dd>
-<dt><strong>gmt_get_map_height</strong></dt>
-<dd>Expects the user to give the desired <strong>-R</strong> <strong>-J</strong> settings and
-returns the map height in the current measurement unit.</dd>
-<dt><strong>gmt_set_psfile</strong></dt>
-<dd>Create the output PostScript file name based on the base name of a
-given file (usually the script name <strong>$0</strong>).</dd>
-<dt><strong>gmt_set_framename</strong></dt>
-<dd>Returns a lexically ordered filename stem (i.e., no extension) given
-the file prefix and the current frame number, using a width of 6 for
-the integer including leading zeros. Useful when creating animations
-and lexically sorted filenames are required.</dd>
-<dt><strong>gmt_set_framenext</strong></dt>
-<dd>Accepts the current frame integer counter and returns the next
-integer counter.</dd>
-</dl>
-</div>
-<div class="section" id="notes">
-<h2>Notes<a class="headerlink" href="#notes" title="Permalink to this headline">¶</a></h2>
-<p>1. These functions only work in the Bourne shell (<strong>sh</strong>) and their
-derivatives (like <strong>ash</strong>, <strong>bash</strong>, <strong>ksh</strong> and <strong>zsh</strong>). These
-functions do not work in the C shell (<strong>csh</strong>) or their derivatives
-(like <strong>tcsh</strong>), and cannot be used in DOS batch scripts either.</p>
-<p>2. <strong>gmt_shell_functions.sh</strong> were first introduced in GMT version
-4.2.2 and have since been regularly expanded with other practical
-scripting short-cuts. If you want to suggest other functions, please do
-so by adding a New Issue request on gmt.soest.hawaii.edu.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a> , <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> ,
-<a class="reference internal" href="gmtinfo.html"><em>gmtinfo</em></a> , <a class="reference internal" href="grdinfo.html"><em>grdinfo</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">gmt_shell_functions.sh</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#notes">Notes</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="gmtset.html"
- title="previous chapter">gmtset</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="gmtsimplify.html"
- title="next chapter">gmtsimplify</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/gmt_shell_functions.sh.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="gmtsimplify.html" title="gmtsimplify"
- >next</a> </li>
- <li class="right" >
- <a href="gmtset.html" title="gmtset"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" >GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gmtcolors.html b/doc_release/html/gmtcolors.html
deleted file mode 100644
index 33ff34d..0000000
--- a/doc_release/html/gmtcolors.html
+++ /dev/null
@@ -1,2741 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>gmtcolors — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GM" href="GM.html" />
- <link rel="next" title="gmtconnect" href="gmtconnect.html" />
- <link rel="prev" title="gmt5syntax" href="gmt5syntax.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="gmtconnect.html" title="gmtconnect"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="gmt5syntax.html" title="gmt5syntax"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" accesskey="U">GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gmtcolors">
-<span id="index-0"></span><h1>gmtcolors<a class="headerlink" href="#gmtcolors" title="Permalink to this headline">¶</a></h1>
-<p>gmtcolors - Explanation of color codes in GMT</p>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p>Colors can be specified in GMT as arguments to commands, generally
-as part of the <strong>-G</strong> or <strong>-W</strong> options to select polygon fill or
-outline pen. Colors are also used in color pallette tables (cpt files)
-that help convert numerical values to colors.</p>
-<p>GMT allows several ways to represent a color:</p>
-<dl class="docutils">
-<dt><strong>Colorname</strong></dt>
-<dd>Specify one of the named colors below. All names are case-insensitive.</dd>
-<dt><strong>R/G/B</strong></dt>
-<dd>Specify <strong>R</strong>ed, <strong>G</strong>reen, and <strong>B</strong>lue levels. Each value is
-separated by a slash and is in the range from 0 (dark) to 255
-(light). This representation is used to color monitors.</dd>
-<dt><strong>#RRGGBB</strong></dt>
-<dd>Specify <strong>R</strong>ed, <strong>G</strong>reen, and <strong>B</strong>lue levels in the way
-that it is done in HTML. Use two characters for each color channel,
-ranging from 00 (dark) to FF (light). Upper and lower case are allowed.</dd>
-<dt><strong>Graylevel</strong></dt>
-<dd>For shades of gray, R = G = B, and only one number needs to be used.
-This representation is popular with black and white printers.</dd>
-<dt><strong>H-S-V</strong></dt>
-<dd>Specify <strong>H</strong>ue in the range 0 to 360 (degrees), <strong>S</strong> saturation
-between 0 (not saturated) and 1 (fully saturated), and value <strong>V</strong>
-between 0 (dark) and 1 (light). Number are separated by hyphens.
-This representation can be helpful when hue varies a lot.</dd>
-<dt><strong>C/M/Y/K</strong></dt>
-<dd>Specify <strong>C</strong>yan, <strong>M</strong>agenta, <strong>Y</strong>ellow, and blacBD(K). Each
-number is in the range from 0 (no paint) to 1 (maximum paint). This
-representation is used by most color printers.</dd>
-</dl>
-</div>
-<div class="section" id="list-of-colors">
-<h2>List Of Colors<a class="headerlink" href="#list-of-colors" title="Permalink to this headline">¶</a></h2>
-<p>The following list contains the named colors that can be used in GMT
-and their equivalent color codes.</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="14%" />
-<col width="14%" />
-<col width="14%" />
-<col width="59%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head"><em>R</em></th>
-<th class="head"><em>G</em></th>
-<th class="head"><em>B</em></th>
-<th class="head"><em>Name</em></th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>255</td>
-<td>250</td>
-<td>250</td>
-<td>snow</td>
-</tr>
-<tr class="row-odd"><td>248</td>
-<td>248</td>
-<td>255</td>
-<td>ghostwite</td>
-</tr>
-<tr class="row-even"><td>255</td>
-<td>250</td>
-<td>240</td>
-<td>floralwhite</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>245</td>
-<td>238</td>
-<td>seashell</td>
-</tr>
-<tr class="row-even"><td>253</td>
-<td>245</td>
-<td>230</td>
-<td>oldlace</td>
-</tr>
-<tr class="row-odd"><td>250</td>
-<td>240</td>
-<td>230</td>
-<td>linen</td>
-</tr>
-<tr class="row-even"><td>250</td>
-<td>235</td>
-<td>215</td>
-<td>antiquewhite</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>239</td>
-<td>213</td>
-<td>papayawhip</td>
-</tr>
-<tr class="row-even"><td>255</td>
-<td>235</td>
-<td>205</td>
-<td>blanchedalmond</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>228</td>
-<td>196</td>
-<td>bisque</td>
-</tr>
-<tr class="row-even"><td>255</td>
-<td>218</td>
-<td>185</td>
-<td>peachpuff</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>222</td>
-<td>173</td>
-<td>navajowhite</td>
-</tr>
-<tr class="row-even"><td>255</td>
-<td>228</td>
-<td>181</td>
-<td>moccasin</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>250</td>
-<td>205</td>
-<td>lemonchiffon</td>
-</tr>
-<tr class="row-even"><td>255</td>
-<td>248</td>
-<td>220</td>
-<td>cornsilk</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>255</td>
-<td>240</td>
-<td>ivory</td>
-</tr>
-<tr class="row-even"><td>240</td>
-<td>255</td>
-<td>240</td>
-<td>honeydew</td>
-</tr>
-<tr class="row-odd"><td>245</td>
-<td>255</td>
-<td>250</td>
-<td>mintcream</td>
-</tr>
-<tr class="row-even"><td>240</td>
-<td>255</td>
-<td>255</td>
-<td>azure</td>
-</tr>
-<tr class="row-odd"><td>240</td>
-<td>248</td>
-<td>255</td>
-<td>aliceblue</td>
-</tr>
-<tr class="row-even"><td>230</td>
-<td>230</td>
-<td>250</td>
-<td>lavender</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>240</td>
-<td>245</td>
-<td>lavenderblush</td>
-</tr>
-<tr class="row-even"><td>255</td>
-<td>228</td>
-<td>225</td>
-<td>mistyrose</td>
-</tr>
-<tr class="row-odd"><td>100</td>
-<td>149</td>
-<td>237</td>
-<td>cornflowerblue</td>
-</tr>
-<tr class="row-even"><td>106</td>
-<td>90</td>
-<td>205</td>
-<td>slateblue</td>
-</tr>
-<tr class="row-odd"><td>123</td>
-<td>104</td>
-<td>238</td>
-<td>mediumslateblue</td>
-</tr>
-<tr class="row-even"><td>132</td>
-<td>112</td>
-<td>255</td>
-<td>lightslateblue</td>
-</tr>
-<tr class="row-odd"><td>135</td>
-<td>206</td>
-<td>235</td>
-<td>skyblue</td>
-</tr>
-<tr class="row-even"><td>135</td>
-<td>206</td>
-<td>250</td>
-<td>lightskyblue</td>
-</tr>
-<tr class="row-odd"><td>119</td>
-<td>136</td>
-<td>153</td>
-<td>lightslategray</td>
-</tr>
-<tr class="row-even"><td>119</td>
-<td>136</td>
-<td>153</td>
-<td>lightslategrey</td>
-</tr>
-<tr class="row-odd"><td>112</td>
-<td>128</td>
-<td>144</td>
-<td>slategray</td>
-</tr>
-<tr class="row-even"><td>112</td>
-<td>128</td>
-<td>144</td>
-<td>slategrey</td>
-</tr>
-<tr class="row-odd"><td>176</td>
-<td>196</td>
-<td>222</td>
-<td>lightsteelblue</td>
-</tr>
-<tr class="row-even"><td>173</td>
-<td>216</td>
-<td>230</td>
-<td>lightblue</td>
-</tr>
-<tr class="row-odd"><td>224</td>
-<td>255</td>
-<td>255</td>
-<td>lightcyan</td>
-</tr>
-<tr class="row-even"><td>176</td>
-<td>224</td>
-<td>230</td>
-<td>powderblue</td>
-</tr>
-<tr class="row-odd"><td>175</td>
-<td>238</td>
-<td>238</td>
-<td>paleturquoise</td>
-</tr>
-<tr class="row-even"><td>102</td>
-<td>205</td>
-<td>170</td>
-<td>mediumaquamarine</td>
-</tr>
-<tr class="row-odd"><td>127</td>
-<td>255</td>
-<td>212</td>
-<td>aquamarine</td>
-</tr>
-<tr class="row-even"><td>144</td>
-<td>238</td>
-<td>144</td>
-<td>lightgreen</td>
-</tr>
-<tr class="row-odd"><td>143</td>
-<td>188</td>
-<td>143</td>
-<td>darkseagreen</td>
-</tr>
-<tr class="row-even"><td>152</td>
-<td>251</td>
-<td>152</td>
-<td>palegreen</td>
-</tr>
-<tr class="row-odd"><td>124</td>
-<td>252</td>
-<td>0</td>
-<td>lawngreen</td>
-</tr>
-<tr class="row-even"><td>127</td>
-<td>255</td>
-<td>0</td>
-<td>chartreuse</td>
-</tr>
-<tr class="row-odd"><td>173</td>
-<td>255</td>
-<td>47</td>
-<td>greenyellow</td>
-</tr>
-<tr class="row-even"><td>154</td>
-<td>205</td>
-<td>50</td>
-<td>yellowgreen</td>
-</tr>
-<tr class="row-odd"><td>107</td>
-<td>142</td>
-<td>35</td>
-<td>olivedrab</td>
-</tr>
-<tr class="row-even"><td>189</td>
-<td>183</td>
-<td>107</td>
-<td>darkkhaki</td>
-</tr>
-<tr class="row-odd"><td>240</td>
-<td>230</td>
-<td>140</td>
-<td>khaki</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>232</td>
-<td>170</td>
-<td>palegoldenrod</td>
-</tr>
-<tr class="row-odd"><td>238</td>
-<td>221</td>
-<td>130</td>
-<td>lightgoldenrod</td>
-</tr>
-<tr class="row-even"><td>255</td>
-<td>255</td>
-<td>224</td>
-<td>lightyellow</td>
-</tr>
-<tr class="row-odd"><td>250</td>
-<td>250</td>
-<td>210</td>
-<td>lightgoldenrodyellow</td>
-</tr>
-<tr class="row-even"><td>255</td>
-<td>255</td>
-<td>0</td>
-<td>yellow</td>
-</tr>
-<tr class="row-odd"><td>128</td>
-<td>128</td>
-<td>0</td>
-<td>darkyellow</td>
-</tr>
-<tr class="row-even"><td>255</td>
-<td>215</td>
-<td>0</td>
-<td>gold</td>
-</tr>
-<tr class="row-odd"><td>218</td>
-<td>165</td>
-<td>32</td>
-<td>goldenrod</td>
-</tr>
-<tr class="row-even"><td>184</td>
-<td>134</td>
-<td>11</td>
-<td>darkgoldenrod</td>
-</tr>
-<tr class="row-odd"><td>188</td>
-<td>143</td>
-<td>143</td>
-<td>rosybrown</td>
-</tr>
-<tr class="row-even"><td>205</td>
-<td>92</td>
-<td>92</td>
-<td>indianred</td>
-</tr>
-<tr class="row-odd"><td>139</td>
-<td>69</td>
-<td>19</td>
-<td>saddlebrown</td>
-</tr>
-<tr class="row-even"><td>160</td>
-<td>82</td>
-<td>45</td>
-<td>sienna</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>133</td>
-<td>63</td>
-<td>peru</td>
-</tr>
-<tr class="row-even"><td>222</td>
-<td>184</td>
-<td>135</td>
-<td>burlywood</td>
-</tr>
-<tr class="row-odd"><td>245</td>
-<td>245</td>
-<td>220</td>
-<td>beige</td>
-</tr>
-<tr class="row-even"><td>245</td>
-<td>222</td>
-<td>179</td>
-<td>wheat</td>
-</tr>
-<tr class="row-odd"><td>244</td>
-<td>164</td>
-<td>96</td>
-<td>sandybrown</td>
-</tr>
-<tr class="row-even"><td>210</td>
-<td>180</td>
-<td>140</td>
-<td>tan</td>
-</tr>
-<tr class="row-odd"><td>210</td>
-<td>105</td>
-<td>30</td>
-<td>chocolate</td>
-</tr>
-<tr class="row-even"><td>178</td>
-<td>34</td>
-<td>34</td>
-<td>firebrick</td>
-</tr>
-<tr class="row-odd"><td>235</td>
-<td>190</td>
-<td>85</td>
-<td>lightbrown</td>
-</tr>
-<tr class="row-even"><td>165</td>
-<td>42</td>
-<td>42</td>
-<td>brown</td>
-</tr>
-<tr class="row-odd"><td>120</td>
-<td>60</td>
-<td>30</td>
-<td>darkbrown</td>
-</tr>
-<tr class="row-even"><td>233</td>
-<td>150</td>
-<td>122</td>
-<td>darksalmon</td>
-</tr>
-<tr class="row-odd"><td>250</td>
-<td>128</td>
-<td>114</td>
-<td>salmon</td>
-</tr>
-<tr class="row-even"><td>255</td>
-<td>160</td>
-<td>122</td>
-<td>lightsalmon</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>192</td>
-<td>128</td>
-<td>lightorange</td>
-</tr>
-<tr class="row-even"><td>255</td>
-<td>165</td>
-<td>0</td>
-<td>orange</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>140</td>
-<td>0</td>
-<td>darkorange</td>
-</tr>
-<tr class="row-even"><td>255</td>
-<td>127</td>
-<td>80</td>
-<td>coral</td>
-</tr>
-<tr class="row-odd"><td>240</td>
-<td>128</td>
-<td>128</td>
-<td>lightcoral</td>
-</tr>
-<tr class="row-even"><td>255</td>
-<td>99</td>
-<td>71</td>
-<td>tomato</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>69</td>
-<td>0</td>
-<td>orangered</td>
-</tr>
-<tr class="row-even"><td>255</td>
-<td>0</td>
-<td>0</td>
-<td>red</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>128</td>
-<td>128</td>
-<td>lightred</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>0</td>
-<td>0</td>
-<td>darkred</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>20</td>
-<td>147</td>
-<td>deeppink</td>
-</tr>
-<tr class="row-even"><td>255</td>
-<td>105</td>
-<td>180</td>
-<td>hotpink</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>192</td>
-<td>203</td>
-<td>pink</td>
-</tr>
-<tr class="row-even"><td>255</td>
-<td>182</td>
-<td>193</td>
-<td>lightpink</td>
-</tr>
-<tr class="row-odd"><td>219</td>
-<td>112</td>
-<td>147</td>
-<td>palevioletred</td>
-</tr>
-<tr class="row-even"><td>176</td>
-<td>48</td>
-<td>96</td>
-<td>maroon</td>
-</tr>
-<tr class="row-odd"><td>199</td>
-<td>21</td>
-<td>133</td>
-<td>mediumvioletred</td>
-</tr>
-<tr class="row-even"><td>208</td>
-<td>32</td>
-<td>144</td>
-<td>violetred</td>
-</tr>
-<tr class="row-odd"><td>139</td>
-<td>0</td>
-<td>139</td>
-<td>darkmagenta</td>
-</tr>
-<tr class="row-even"><td>255</td>
-<td>0</td>
-<td>255</td>
-<td>magenta</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>128</td>
-<td>255</td>
-<td>lightmagenta</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>130</td>
-<td>238</td>
-<td>violet</td>
-</tr>
-<tr class="row-odd"><td>218</td>
-<td>112</td>
-<td>214</td>
-<td>orchid</td>
-</tr>
-<tr class="row-even"><td>221</td>
-<td>160</td>
-<td>221</td>
-<td>plum</td>
-</tr>
-<tr class="row-odd"><td>186</td>
-<td>85</td>
-<td>211</td>
-<td>mediumorchid</td>
-</tr>
-<tr class="row-even"><td>153</td>
-<td>50</td>
-<td>204</td>
-<td>darkorchid</td>
-</tr>
-<tr class="row-odd"><td>148</td>
-<td>0</td>
-<td>211</td>
-<td>darkviolet</td>
-</tr>
-<tr class="row-even"><td>138</td>
-<td>43</td>
-<td>226</td>
-<td>blueviolet</td>
-</tr>
-<tr class="row-odd"><td>160</td>
-<td>32</td>
-<td>240</td>
-<td>purple</td>
-</tr>
-<tr class="row-even"><td>147</td>
-<td>112</td>
-<td>219</td>
-<td>mediumpurple</td>
-</tr>
-<tr class="row-odd"><td>216</td>
-<td>191</td>
-<td>216</td>
-<td>thistle</td>
-</tr>
-<tr class="row-even"><td>105</td>
-<td>105</td>
-<td>105</td>
-<td>dimgray</td>
-</tr>
-<tr class="row-odd"><td>105</td>
-<td>105</td>
-<td>105</td>
-<td>dimgrey</td>
-</tr>
-<tr class="row-even"><td>169</td>
-<td>169</td>
-<td>169</td>
-<td>darkgray</td>
-</tr>
-<tr class="row-odd"><td>169</td>
-<td>169</td>
-<td>169</td>
-<td>darkgrey</td>
-</tr>
-<tr class="row-even"><td>190</td>
-<td>190</td>
-<td>190</td>
-<td>gray</td>
-</tr>
-<tr class="row-odd"><td>190</td>
-<td>190</td>
-<td>190</td>
-<td>grey</td>
-</tr>
-<tr class="row-even"><td>211</td>
-<td>211</td>
-<td>211</td>
-<td>lightgrey</td>
-</tr>
-<tr class="row-odd"><td>211</td>
-<td>211</td>
-<td>211</td>
-<td>lightgray</td>
-</tr>
-<tr class="row-even"><td>220</td>
-<td>220</td>
-<td>220</td>
-<td>gainsboro</td>
-</tr>
-<tr class="row-odd"><td>245</td>
-<td>245</td>
-<td>245</td>
-<td>whitesmoke</td>
-</tr>
-<tr class="row-even"><td>255</td>
-<td>255</td>
-<td>255</td>
-<td>white</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>250</td>
-<td>250</td>
-<td>snow1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>233</td>
-<td>233</td>
-<td>snow2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>201</td>
-<td>201</td>
-<td>snow3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>137</td>
-<td>137</td>
-<td>snow4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>245</td>
-<td>238</td>
-<td>seashell1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>229</td>
-<td>222</td>
-<td>seashell2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>197</td>
-<td>191</td>
-<td>seashell3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>134</td>
-<td>130</td>
-<td>seashell4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>239</td>
-<td>219</td>
-<td>antiquewhite1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>223</td>
-<td>204</td>
-<td>antiquewhite2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>192</td>
-<td>176</td>
-<td>antiquewhite3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>131</td>
-<td>120</td>
-<td>antiquewhite4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>228</td>
-<td>196</td>
-<td>bisque1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>213</td>
-<td>183</td>
-<td>bisque2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>183</td>
-<td>158</td>
-<td>bisque3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>125</td>
-<td>107</td>
-<td>bisque4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>218</td>
-<td>185</td>
-<td>peachpuff1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>203</td>
-<td>173</td>
-<td>peachpuff2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>175</td>
-<td>149</td>
-<td>peachpuff3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>119</td>
-<td>101</td>
-<td>peachpuff4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>222</td>
-<td>173</td>
-<td>navajowhite1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>207</td>
-<td>161</td>
-<td>navajowhite2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>179</td>
-<td>139</td>
-<td>navajowhite3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>121</td>
-<td>94</td>
-<td>navajowhite4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>250</td>
-<td>205</td>
-<td>lemonchiffon1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>233</td>
-<td>191</td>
-<td>lemonchiffon2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>201</td>
-<td>165</td>
-<td>lemonchiffon3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>137</td>
-<td>112</td>
-<td>lemonchiffon4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>248</td>
-<td>220</td>
-<td>cornsilk1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>232</td>
-<td>205</td>
-<td>cornsilk2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>200</td>
-<td>177</td>
-<td>cornsilk3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>136</td>
-<td>120</td>
-<td>cornsilk4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>255</td>
-<td>240</td>
-<td>ivory1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>238</td>
-<td>224</td>
-<td>ivory2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>205</td>
-<td>193</td>
-<td>ivory3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>139</td>
-<td>131</td>
-<td>ivory4</td>
-</tr>
-<tr class="row-odd"><td>240</td>
-<td>255</td>
-<td>240</td>
-<td>honeydew1</td>
-</tr>
-<tr class="row-even"><td>224</td>
-<td>238</td>
-<td>224</td>
-<td>honeydew2</td>
-</tr>
-<tr class="row-odd"><td>193</td>
-<td>205</td>
-<td>193</td>
-<td>honeydew3</td>
-</tr>
-<tr class="row-even"><td>131</td>
-<td>139</td>
-<td>131</td>
-<td>honeydew4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>240</td>
-<td>245</td>
-<td>lavenderblush1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>224</td>
-<td>229</td>
-<td>lavenderblush2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>193</td>
-<td>197</td>
-<td>lavenderblush3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>131</td>
-<td>134</td>
-<td>lavenderblush4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>228</td>
-<td>225</td>
-<td>mistyrose1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>213</td>
-<td>210</td>
-<td>mistyrose2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>183</td>
-<td>181</td>
-<td>mistyrose3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>125</td>
-<td>123</td>
-<td>mistyrose4</td>
-</tr>
-<tr class="row-odd"><td>240</td>
-<td>255</td>
-<td>255</td>
-<td>azure1</td>
-</tr>
-<tr class="row-even"><td>224</td>
-<td>238</td>
-<td>238</td>
-<td>azure2</td>
-</tr>
-<tr class="row-odd"><td>193</td>
-<td>205</td>
-<td>205</td>
-<td>azure3</td>
-</tr>
-<tr class="row-even"><td>131</td>
-<td>139</td>
-<td>139</td>
-<td>azure4</td>
-</tr>
-<tr class="row-odd"><td>131</td>
-<td>111</td>
-<td>255</td>
-<td>slateblue1</td>
-</tr>
-<tr class="row-even"><td>122</td>
-<td>103</td>
-<td>238</td>
-<td>slateblue2</td>
-</tr>
-<tr class="row-odd"><td>105</td>
-<td>89</td>
-<td>205</td>
-<td>slateblue3</td>
-</tr>
-<tr class="row-even"><td>135</td>
-<td>206</td>
-<td>255</td>
-<td>skyblue1</td>
-</tr>
-<tr class="row-odd"><td>126</td>
-<td>192</td>
-<td>238</td>
-<td>skyblue2</td>
-</tr>
-<tr class="row-even"><td>108</td>
-<td>166</td>
-<td>205</td>
-<td>skyblue3</td>
-</tr>
-<tr class="row-odd"><td>176</td>
-<td>226</td>
-<td>255</td>
-<td>lightskyblue1</td>
-</tr>
-<tr class="row-even"><td>164</td>
-<td>211</td>
-<td>238</td>
-<td>lightskyblue2</td>
-</tr>
-<tr class="row-odd"><td>141</td>
-<td>182</td>
-<td>205</td>
-<td>lightskyblue3</td>
-</tr>
-<tr class="row-even"><td>198</td>
-<td>226</td>
-<td>255</td>
-<td>slategray1</td>
-</tr>
-<tr class="row-odd"><td>185</td>
-<td>211</td>
-<td>238</td>
-<td>slategray2</td>
-</tr>
-<tr class="row-even"><td>159</td>
-<td>182</td>
-<td>205</td>
-<td>slategray3</td>
-</tr>
-<tr class="row-odd"><td>108</td>
-<td>123</td>
-<td>139</td>
-<td>slategray4</td>
-</tr>
-<tr class="row-even"><td>202</td>
-<td>225</td>
-<td>255</td>
-<td>lightsteelblue1</td>
-</tr>
-<tr class="row-odd"><td>188</td>
-<td>210</td>
-<td>238</td>
-<td>lightsteelblue2</td>
-</tr>
-<tr class="row-even"><td>162</td>
-<td>181</td>
-<td>205</td>
-<td>lightsteelblue3</td>
-</tr>
-<tr class="row-odd"><td>110</td>
-<td>123</td>
-<td>139</td>
-<td>lightsteelblue4</td>
-</tr>
-<tr class="row-even"><td>191</td>
-<td>239</td>
-<td>255</td>
-<td>lightblue1</td>
-</tr>
-<tr class="row-odd"><td>178</td>
-<td>223</td>
-<td>238</td>
-<td>lightblue2</td>
-</tr>
-<tr class="row-even"><td>154</td>
-<td>192</td>
-<td>205</td>
-<td>lightblue3</td>
-</tr>
-<tr class="row-odd"><td>104</td>
-<td>131</td>
-<td>139</td>
-<td>lightblue4</td>
-</tr>
-<tr class="row-even"><td>224</td>
-<td>255</td>
-<td>255</td>
-<td>lightcyan1</td>
-</tr>
-<tr class="row-odd"><td>209</td>
-<td>238</td>
-<td>238</td>
-<td>lightcyan2</td>
-</tr>
-<tr class="row-even"><td>180</td>
-<td>205</td>
-<td>205</td>
-<td>lightcyan3</td>
-</tr>
-<tr class="row-odd"><td>122</td>
-<td>139</td>
-<td>139</td>
-<td>lightcyan4</td>
-</tr>
-<tr class="row-even"><td>187</td>
-<td>255</td>
-<td>255</td>
-<td>paleturquoise1</td>
-</tr>
-<tr class="row-odd"><td>174</td>
-<td>238</td>
-<td>238</td>
-<td>paleturquoise2</td>
-</tr>
-<tr class="row-even"><td>150</td>
-<td>205</td>
-<td>205</td>
-<td>paleturquoise3</td>
-</tr>
-<tr class="row-odd"><td>102</td>
-<td>139</td>
-<td>139</td>
-<td>paleturquoise4</td>
-</tr>
-<tr class="row-even"><td>152</td>
-<td>245</td>
-<td>255</td>
-<td>cadetblue1</td>
-</tr>
-<tr class="row-odd"><td>142</td>
-<td>229</td>
-<td>238</td>
-<td>cadetblue2</td>
-</tr>
-<tr class="row-even"><td>122</td>
-<td>197</td>
-<td>205</td>
-<td>cadetblue3</td>
-</tr>
-<tr class="row-odd"><td>151</td>
-<td>255</td>
-<td>255</td>
-<td>darkslategray1</td>
-</tr>
-<tr class="row-even"><td>141</td>
-<td>238</td>
-<td>238</td>
-<td>darkslategray2</td>
-</tr>
-<tr class="row-odd"><td>121</td>
-<td>205</td>
-<td>205</td>
-<td>darkslategray3</td>
-</tr>
-<tr class="row-even"><td>127</td>
-<td>255</td>
-<td>212</td>
-<td>aquamarine1</td>
-</tr>
-<tr class="row-odd"><td>118</td>
-<td>238</td>
-<td>198</td>
-<td>aquamarine2</td>
-</tr>
-<tr class="row-even"><td>102</td>
-<td>205</td>
-<td>170</td>
-<td>aquamarine3</td>
-</tr>
-<tr class="row-odd"><td>193</td>
-<td>255</td>
-<td>193</td>
-<td>darkseagreen1</td>
-</tr>
-<tr class="row-even"><td>180</td>
-<td>238</td>
-<td>180</td>
-<td>darkseagreen2</td>
-</tr>
-<tr class="row-odd"><td>155</td>
-<td>205</td>
-<td>155</td>
-<td>darkseagreen3</td>
-</tr>
-<tr class="row-even"><td>105</td>
-<td>139</td>
-<td>105</td>
-<td>darkseagreen4</td>
-</tr>
-<tr class="row-odd"><td>154</td>
-<td>255</td>
-<td>154</td>
-<td>palegreen1</td>
-</tr>
-<tr class="row-even"><td>144</td>
-<td>238</td>
-<td>144</td>
-<td>palegreen2</td>
-</tr>
-<tr class="row-odd"><td>124</td>
-<td>205</td>
-<td>124</td>
-<td>palegreen3</td>
-</tr>
-<tr class="row-even"><td>127</td>
-<td>255</td>
-<td>0</td>
-<td>chartreuse1</td>
-</tr>
-<tr class="row-odd"><td>118</td>
-<td>238</td>
-<td>0</td>
-<td>chartreuse2</td>
-</tr>
-<tr class="row-even"><td>102</td>
-<td>205</td>
-<td>0</td>
-<td>chartreuse3</td>
-</tr>
-<tr class="row-odd"><td>192</td>
-<td>255</td>
-<td>62</td>
-<td>olivedrab1</td>
-</tr>
-<tr class="row-even"><td>179</td>
-<td>238</td>
-<td>58</td>
-<td>olivedrab2</td>
-</tr>
-<tr class="row-odd"><td>154</td>
-<td>205</td>
-<td>50</td>
-<td>olivedrab3</td>
-</tr>
-<tr class="row-even"><td>105</td>
-<td>139</td>
-<td>34</td>
-<td>olivedrab4</td>
-</tr>
-<tr class="row-odd"><td>202</td>
-<td>255</td>
-<td>112</td>
-<td>darkolivegreen1</td>
-</tr>
-<tr class="row-even"><td>188</td>
-<td>238</td>
-<td>104</td>
-<td>darkolivegreen2</td>
-</tr>
-<tr class="row-odd"><td>162</td>
-<td>205</td>
-<td>90</td>
-<td>darkolivegreen3</td>
-</tr>
-<tr class="row-even"><td>110</td>
-<td>139</td>
-<td>61</td>
-<td>darkolivegreen4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>246</td>
-<td>143</td>
-<td>khaki1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>230</td>
-<td>133</td>
-<td>khaki2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>198</td>
-<td>115</td>
-<td>khaki3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>134</td>
-<td>78</td>
-<td>khaki4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>236</td>
-<td>139</td>
-<td>lightgoldenrod1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>220</td>
-<td>130</td>
-<td>lightgoldenrod2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>190</td>
-<td>112</td>
-<td>lightgoldenrod3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>129</td>
-<td>76</td>
-<td>lightgoldenrod4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>255</td>
-<td>224</td>
-<td>lightyellow1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>238</td>
-<td>209</td>
-<td>lightyellow2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>205</td>
-<td>180</td>
-<td>lightyellow3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>139</td>
-<td>122</td>
-<td>lightyellow4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>255</td>
-<td>0</td>
-<td>yellow1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>238</td>
-<td>0</td>
-<td>yellow2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>205</td>
-<td>0</td>
-<td>yellow3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>139</td>
-<td>0</td>
-<td>yellow4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>215</td>
-<td>0</td>
-<td>gold1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>201</td>
-<td>0</td>
-<td>gold2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>173</td>
-<td>0</td>
-<td>gold3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>117</td>
-<td>0</td>
-<td>gold4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>193</td>
-<td>37</td>
-<td>goldenrod1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>180</td>
-<td>34</td>
-<td>goldenrod2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>155</td>
-<td>29</td>
-<td>goldenrod3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>105</td>
-<td>20</td>
-<td>goldenrod4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>185</td>
-<td>15</td>
-<td>darkgoldenrod1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>173</td>
-<td>14</td>
-<td>darkgoldenrod2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>149</td>
-<td>12</td>
-<td>darkgoldenrod3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>101</td>
-<td>8</td>
-<td>darkgoldenrod4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>193</td>
-<td>193</td>
-<td>rosybrown1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>180</td>
-<td>180</td>
-<td>rosybrown2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>155</td>
-<td>155</td>
-<td>rosybrown3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>105</td>
-<td>105</td>
-<td>rosybrown4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>106</td>
-<td>106</td>
-<td>indianred1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>99</td>
-<td>99</td>
-<td>indianred2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>85</td>
-<td>85</td>
-<td>indianred3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>58</td>
-<td>58</td>
-<td>indianred4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>130</td>
-<td>71</td>
-<td>sienna1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>121</td>
-<td>66</td>
-<td>sienna2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>104</td>
-<td>57</td>
-<td>sienna3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>71</td>
-<td>38</td>
-<td>sienna4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>211</td>
-<td>155</td>
-<td>burlywood1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>197</td>
-<td>145</td>
-<td>burlywood2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>170</td>
-<td>125</td>
-<td>burlywood3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>115</td>
-<td>85</td>
-<td>burlywood4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>231</td>
-<td>186</td>
-<td>wheat1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>216</td>
-<td>174</td>
-<td>wheat2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>186</td>
-<td>150</td>
-<td>wheat3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>126</td>
-<td>102</td>
-<td>wheat4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>165</td>
-<td>79</td>
-<td>tan1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>154</td>
-<td>73</td>
-<td>tan2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>133</td>
-<td>63</td>
-<td>tan3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>90</td>
-<td>43</td>
-<td>tan4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>127</td>
-<td>36</td>
-<td>chocolate1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>118</td>
-<td>33</td>
-<td>chocolate2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>102</td>
-<td>29</td>
-<td>chocolate3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>69</td>
-<td>19</td>
-<td>chocolate4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>48</td>
-<td>48</td>
-<td>firebrick1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>44</td>
-<td>44</td>
-<td>firebrick2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>38</td>
-<td>38</td>
-<td>firebrick3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>26</td>
-<td>26</td>
-<td>firebrick4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>64</td>
-<td>64</td>
-<td>brown1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>59</td>
-<td>59</td>
-<td>brown2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>51</td>
-<td>51</td>
-<td>brown3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>35</td>
-<td>35</td>
-<td>brown4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>140</td>
-<td>105</td>
-<td>salmon1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>130</td>
-<td>98</td>
-<td>salmon2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>112</td>
-<td>84</td>
-<td>salmon3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>76</td>
-<td>57</td>
-<td>salmon4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>160</td>
-<td>122</td>
-<td>lightsalmon1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>149</td>
-<td>114</td>
-<td>lightsalmon2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>129</td>
-<td>98</td>
-<td>lightsalmon3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>87</td>
-<td>66</td>
-<td>lightsalmon4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>165</td>
-<td>0</td>
-<td>orange1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>154</td>
-<td>0</td>
-<td>orange2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>133</td>
-<td>0</td>
-<td>orange3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>90</td>
-<td>0</td>
-<td>orange4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>127</td>
-<td>0</td>
-<td>darkorange1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>118</td>
-<td>0</td>
-<td>darkorange2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>102</td>
-<td>0</td>
-<td>darkorange3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>69</td>
-<td>0</td>
-<td>darkorange4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>114</td>
-<td>86</td>
-<td>coral1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>106</td>
-<td>80</td>
-<td>coral2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>91</td>
-<td>69</td>
-<td>coral3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>62</td>
-<td>47</td>
-<td>coral4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>99</td>
-<td>71</td>
-<td>tomato1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>92</td>
-<td>66</td>
-<td>tomato2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>79</td>
-<td>57</td>
-<td>tomato3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>54</td>
-<td>38</td>
-<td>tomato4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>69</td>
-<td>0</td>
-<td>orangered1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>64</td>
-<td>0</td>
-<td>orangered2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>55</td>
-<td>0</td>
-<td>orangered3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>37</td>
-<td>0</td>
-<td>orangered4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>0</td>
-<td>0</td>
-<td>red1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>0</td>
-<td>0</td>
-<td>red2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>0</td>
-<td>0</td>
-<td>red3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>0</td>
-<td>0</td>
-<td>red4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>20</td>
-<td>147</td>
-<td>deeppink1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>18</td>
-<td>137</td>
-<td>deeppink2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>16</td>
-<td>118</td>
-<td>deeppink3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>10</td>
-<td>80</td>
-<td>deeppink4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>110</td>
-<td>180</td>
-<td>hotpink1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>106</td>
-<td>167</td>
-<td>hotpink2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>96</td>
-<td>144</td>
-<td>hotpink3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>58</td>
-<td>98</td>
-<td>hotpink4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>181</td>
-<td>197</td>
-<td>pink1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>169</td>
-<td>184</td>
-<td>pink2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>145</td>
-<td>158</td>
-<td>pink3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>99</td>
-<td>108</td>
-<td>pink4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>174</td>
-<td>185</td>
-<td>lightpink1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>162</td>
-<td>173</td>
-<td>lightpink2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>140</td>
-<td>149</td>
-<td>lightpink3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>95</td>
-<td>101</td>
-<td>lightpink4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>130</td>
-<td>171</td>
-<td>palevioletred1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>121</td>
-<td>159</td>
-<td>palevioletred2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>104</td>
-<td>137</td>
-<td>palevioletred3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>71</td>
-<td>93</td>
-<td>palevioletred4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>52</td>
-<td>179</td>
-<td>maroon1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>48</td>
-<td>167</td>
-<td>maroon2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>41</td>
-<td>144</td>
-<td>maroon3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>28</td>
-<td>98</td>
-<td>maroon4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>62</td>
-<td>150</td>
-<td>violetred1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>58</td>
-<td>140</td>
-<td>violetred2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>50</td>
-<td>120</td>
-<td>violetred3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>34</td>
-<td>82</td>
-<td>violetred4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>0</td>
-<td>255</td>
-<td>magenta1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>0</td>
-<td>238</td>
-<td>magenta2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>0</td>
-<td>205</td>
-<td>magenta3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>0</td>
-<td>139</td>
-<td>magenta4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>131</td>
-<td>250</td>
-<td>orchid1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>122</td>
-<td>233</td>
-<td>orchid2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>105</td>
-<td>201</td>
-<td>orchid3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>71</td>
-<td>137</td>
-<td>orchid4</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>187</td>
-<td>255</td>
-<td>plum1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>174</td>
-<td>238</td>
-<td>plum2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>150</td>
-<td>205</td>
-<td>plum3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>102</td>
-<td>139</td>
-<td>plum4</td>
-</tr>
-<tr class="row-odd"><td>224</td>
-<td>102</td>
-<td>255</td>
-<td>mediumorchid1</td>
-</tr>
-<tr class="row-even"><td>209</td>
-<td>95</td>
-<td>238</td>
-<td>mediumorchid2</td>
-</tr>
-<tr class="row-odd"><td>180</td>
-<td>82</td>
-<td>205</td>
-<td>mediumorchid3</td>
-</tr>
-<tr class="row-even"><td>122</td>
-<td>55</td>
-<td>139</td>
-<td>mediumorchid4</td>
-</tr>
-<tr class="row-odd"><td>191</td>
-<td>62</td>
-<td>255</td>
-<td>darkorchid1</td>
-</tr>
-<tr class="row-even"><td>178</td>
-<td>58</td>
-<td>238</td>
-<td>darkorchid2</td>
-</tr>
-<tr class="row-odd"><td>154</td>
-<td>50</td>
-<td>205</td>
-<td>darkorchid3</td>
-</tr>
-<tr class="row-even"><td>104</td>
-<td>34</td>
-<td>139</td>
-<td>darkorchid4</td>
-</tr>
-<tr class="row-odd"><td>155</td>
-<td>48</td>
-<td>255</td>
-<td>purple1</td>
-</tr>
-<tr class="row-even"><td>145</td>
-<td>44</td>
-<td>238</td>
-<td>purple2</td>
-</tr>
-<tr class="row-odd"><td>125</td>
-<td>38</td>
-<td>205</td>
-<td>purple3</td>
-</tr>
-<tr class="row-even"><td>171</td>
-<td>130</td>
-<td>255</td>
-<td>mediumpurple1</td>
-</tr>
-<tr class="row-odd"><td>159</td>
-<td>121</td>
-<td>238</td>
-<td>mediumpurple2</td>
-</tr>
-<tr class="row-even"><td>137</td>
-<td>104</td>
-<td>205</td>
-<td>mediumpurple3</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>225</td>
-<td>255</td>
-<td>thistle1</td>
-</tr>
-<tr class="row-even"><td>238</td>
-<td>210</td>
-<td>238</td>
-<td>thistle2</td>
-</tr>
-<tr class="row-odd"><td>205</td>
-<td>181</td>
-<td>205</td>
-<td>thistle3</td>
-</tr>
-<tr class="row-even"><td>139</td>
-<td>123</td>
-<td>139</td>
-<td>thistle4</td>
-</tr>
-<tr class="row-odd"><td>102</td>
-<td>102</td>
-<td>102</td>
-<td>gray40</td>
-</tr>
-<tr class="row-even"><td>102</td>
-<td>102</td>
-<td>102</td>
-<td>grey40</td>
-</tr>
-<tr class="row-odd"><td>105</td>
-<td>105</td>
-<td>105</td>
-<td>gray41</td>
-</tr>
-<tr class="row-even"><td>105</td>
-<td>105</td>
-<td>105</td>
-<td>grey41</td>
-</tr>
-<tr class="row-odd"><td>107</td>
-<td>107</td>
-<td>107</td>
-<td>gray42</td>
-</tr>
-<tr class="row-even"><td>107</td>
-<td>107</td>
-<td>107</td>
-<td>grey42</td>
-</tr>
-<tr class="row-odd"><td>110</td>
-<td>110</td>
-<td>110</td>
-<td>gray43</td>
-</tr>
-<tr class="row-even"><td>110</td>
-<td>110</td>
-<td>110</td>
-<td>grey43</td>
-</tr>
-<tr class="row-odd"><td>112</td>
-<td>112</td>
-<td>112</td>
-<td>gray44</td>
-</tr>
-<tr class="row-even"><td>112</td>
-<td>112</td>
-<td>112</td>
-<td>grey44</td>
-</tr>
-<tr class="row-odd"><td>115</td>
-<td>115</td>
-<td>115</td>
-<td>gray45</td>
-</tr>
-<tr class="row-even"><td>115</td>
-<td>115</td>
-<td>115</td>
-<td>grey45</td>
-</tr>
-<tr class="row-odd"><td>117</td>
-<td>117</td>
-<td>117</td>
-<td>gray46</td>
-</tr>
-<tr class="row-even"><td>117</td>
-<td>117</td>
-<td>117</td>
-<td>grey46</td>
-</tr>
-<tr class="row-odd"><td>120</td>
-<td>120</td>
-<td>120</td>
-<td>gray47</td>
-</tr>
-<tr class="row-even"><td>120</td>
-<td>120</td>
-<td>120</td>
-<td>grey47</td>
-</tr>
-<tr class="row-odd"><td>122</td>
-<td>122</td>
-<td>122</td>
-<td>gray48</td>
-</tr>
-<tr class="row-even"><td>122</td>
-<td>122</td>
-<td>122</td>
-<td>grey48</td>
-</tr>
-<tr class="row-odd"><td>125</td>
-<td>125</td>
-<td>125</td>
-<td>gray49</td>
-</tr>
-<tr class="row-even"><td>125</td>
-<td>125</td>
-<td>125</td>
-<td>grey49</td>
-</tr>
-<tr class="row-odd"><td>127</td>
-<td>127</td>
-<td>127</td>
-<td>gray50</td>
-</tr>
-<tr class="row-even"><td>127</td>
-<td>127</td>
-<td>127</td>
-<td>grey50</td>
-</tr>
-<tr class="row-odd"><td>130</td>
-<td>130</td>
-<td>130</td>
-<td>gray51</td>
-</tr>
-<tr class="row-even"><td>130</td>
-<td>130</td>
-<td>130</td>
-<td>grey51</td>
-</tr>
-<tr class="row-odd"><td>133</td>
-<td>133</td>
-<td>133</td>
-<td>gray52</td>
-</tr>
-<tr class="row-even"><td>133</td>
-<td>133</td>
-<td>133</td>
-<td>grey52</td>
-</tr>
-<tr class="row-odd"><td>135</td>
-<td>135</td>
-<td>135</td>
-<td>gray53</td>
-</tr>
-<tr class="row-even"><td>135</td>
-<td>135</td>
-<td>135</td>
-<td>grey53</td>
-</tr>
-<tr class="row-odd"><td>138</td>
-<td>138</td>
-<td>138</td>
-<td>gray54</td>
-</tr>
-<tr class="row-even"><td>138</td>
-<td>138</td>
-<td>138</td>
-<td>grey54</td>
-</tr>
-<tr class="row-odd"><td>140</td>
-<td>140</td>
-<td>140</td>
-<td>gray55</td>
-</tr>
-<tr class="row-even"><td>140</td>
-<td>140</td>
-<td>140</td>
-<td>grey55</td>
-</tr>
-<tr class="row-odd"><td>143</td>
-<td>143</td>
-<td>143</td>
-<td>gray56</td>
-</tr>
-<tr class="row-even"><td>143</td>
-<td>143</td>
-<td>143</td>
-<td>grey56</td>
-</tr>
-<tr class="row-odd"><td>145</td>
-<td>145</td>
-<td>145</td>
-<td>gray57</td>
-</tr>
-<tr class="row-even"><td>145</td>
-<td>145</td>
-<td>145</td>
-<td>grey57</td>
-</tr>
-<tr class="row-odd"><td>148</td>
-<td>148</td>
-<td>148</td>
-<td>gray58</td>
-</tr>
-<tr class="row-even"><td>148</td>
-<td>148</td>
-<td>148</td>
-<td>grey58</td>
-</tr>
-<tr class="row-odd"><td>150</td>
-<td>150</td>
-<td>150</td>
-<td>gray59</td>
-</tr>
-<tr class="row-even"><td>150</td>
-<td>150</td>
-<td>150</td>
-<td>grey59</td>
-</tr>
-<tr class="row-odd"><td>153</td>
-<td>153</td>
-<td>153</td>
-<td>gray60</td>
-</tr>
-<tr class="row-even"><td>153</td>
-<td>153</td>
-<td>153</td>
-<td>grey60</td>
-</tr>
-<tr class="row-odd"><td>156</td>
-<td>156</td>
-<td>156</td>
-<td>gray61</td>
-</tr>
-<tr class="row-even"><td>156</td>
-<td>156</td>
-<td>156</td>
-<td>grey61</td>
-</tr>
-<tr class="row-odd"><td>158</td>
-<td>158</td>
-<td>158</td>
-<td>gray62</td>
-</tr>
-<tr class="row-even"><td>158</td>
-<td>158</td>
-<td>158</td>
-<td>grey62</td>
-</tr>
-<tr class="row-odd"><td>161</td>
-<td>161</td>
-<td>161</td>
-<td>gray63</td>
-</tr>
-<tr class="row-even"><td>161</td>
-<td>161</td>
-<td>161</td>
-<td>grey63</td>
-</tr>
-<tr class="row-odd"><td>163</td>
-<td>163</td>
-<td>163</td>
-<td>gray64</td>
-</tr>
-<tr class="row-even"><td>163</td>
-<td>163</td>
-<td>163</td>
-<td>grey64</td>
-</tr>
-<tr class="row-odd"><td>166</td>
-<td>166</td>
-<td>166</td>
-<td>gray65</td>
-</tr>
-<tr class="row-even"><td>166</td>
-<td>166</td>
-<td>166</td>
-<td>grey65</td>
-</tr>
-<tr class="row-odd"><td>168</td>
-<td>168</td>
-<td>168</td>
-<td>gray66</td>
-</tr>
-<tr class="row-even"><td>168</td>
-<td>168</td>
-<td>168</td>
-<td>grey66</td>
-</tr>
-<tr class="row-odd"><td>171</td>
-<td>171</td>
-<td>171</td>
-<td>gray67</td>
-</tr>
-<tr class="row-even"><td>171</td>
-<td>171</td>
-<td>171</td>
-<td>grey67</td>
-</tr>
-<tr class="row-odd"><td>173</td>
-<td>173</td>
-<td>173</td>
-<td>gray68</td>
-</tr>
-<tr class="row-even"><td>173</td>
-<td>173</td>
-<td>173</td>
-<td>grey68</td>
-</tr>
-<tr class="row-odd"><td>176</td>
-<td>176</td>
-<td>176</td>
-<td>gray69</td>
-</tr>
-<tr class="row-even"><td>176</td>
-<td>176</td>
-<td>176</td>
-<td>grey69</td>
-</tr>
-<tr class="row-odd"><td>179</td>
-<td>179</td>
-<td>179</td>
-<td>gray70</td>
-</tr>
-<tr class="row-even"><td>179</td>
-<td>179</td>
-<td>179</td>
-<td>grey70</td>
-</tr>
-<tr class="row-odd"><td>181</td>
-<td>181</td>
-<td>181</td>
-<td>gray71</td>
-</tr>
-<tr class="row-even"><td>181</td>
-<td>181</td>
-<td>181</td>
-<td>grey71</td>
-</tr>
-<tr class="row-odd"><td>184</td>
-<td>184</td>
-<td>184</td>
-<td>gray72</td>
-</tr>
-<tr class="row-even"><td>184</td>
-<td>184</td>
-<td>184</td>
-<td>grey72</td>
-</tr>
-<tr class="row-odd"><td>186</td>
-<td>186</td>
-<td>186</td>
-<td>gray73</td>
-</tr>
-<tr class="row-even"><td>186</td>
-<td>186</td>
-<td>186</td>
-<td>grey73</td>
-</tr>
-<tr class="row-odd"><td>189</td>
-<td>189</td>
-<td>189</td>
-<td>gray74</td>
-</tr>
-<tr class="row-even"><td>189</td>
-<td>189</td>
-<td>189</td>
-<td>grey74</td>
-</tr>
-<tr class="row-odd"><td>191</td>
-<td>191</td>
-<td>191</td>
-<td>gray75</td>
-</tr>
-<tr class="row-even"><td>191</td>
-<td>191</td>
-<td>191</td>
-<td>grey75</td>
-</tr>
-<tr class="row-odd"><td>194</td>
-<td>194</td>
-<td>194</td>
-<td>gray76</td>
-</tr>
-<tr class="row-even"><td>194</td>
-<td>194</td>
-<td>194</td>
-<td>grey76</td>
-</tr>
-<tr class="row-odd"><td>196</td>
-<td>196</td>
-<td>196</td>
-<td>gray77</td>
-</tr>
-<tr class="row-even"><td>196</td>
-<td>196</td>
-<td>196</td>
-<td>grey77</td>
-</tr>
-<tr class="row-odd"><td>199</td>
-<td>199</td>
-<td>199</td>
-<td>gray78</td>
-</tr>
-<tr class="row-even"><td>199</td>
-<td>199</td>
-<td>199</td>
-<td>grey78</td>
-</tr>
-<tr class="row-odd"><td>201</td>
-<td>201</td>
-<td>201</td>
-<td>gray79</td>
-</tr>
-<tr class="row-even"><td>201</td>
-<td>201</td>
-<td>201</td>
-<td>grey79</td>
-</tr>
-<tr class="row-odd"><td>204</td>
-<td>204</td>
-<td>204</td>
-<td>gray80</td>
-</tr>
-<tr class="row-even"><td>204</td>
-<td>204</td>
-<td>204</td>
-<td>grey80</td>
-</tr>
-<tr class="row-odd"><td>207</td>
-<td>207</td>
-<td>207</td>
-<td>gray81</td>
-</tr>
-<tr class="row-even"><td>207</td>
-<td>207</td>
-<td>207</td>
-<td>grey81</td>
-</tr>
-<tr class="row-odd"><td>209</td>
-<td>209</td>
-<td>209</td>
-<td>gray82</td>
-</tr>
-<tr class="row-even"><td>209</td>
-<td>209</td>
-<td>209</td>
-<td>grey82</td>
-</tr>
-<tr class="row-odd"><td>212</td>
-<td>212</td>
-<td>212</td>
-<td>gray83</td>
-</tr>
-<tr class="row-even"><td>212</td>
-<td>212</td>
-<td>212</td>
-<td>grey83</td>
-</tr>
-<tr class="row-odd"><td>214</td>
-<td>214</td>
-<td>214</td>
-<td>gray84</td>
-</tr>
-<tr class="row-even"><td>214</td>
-<td>214</td>
-<td>214</td>
-<td>grey84</td>
-</tr>
-<tr class="row-odd"><td>217</td>
-<td>217</td>
-<td>217</td>
-<td>gray85</td>
-</tr>
-<tr class="row-even"><td>217</td>
-<td>217</td>
-<td>217</td>
-<td>grey85</td>
-</tr>
-<tr class="row-odd"><td>219</td>
-<td>219</td>
-<td>219</td>
-<td>gray86</td>
-</tr>
-<tr class="row-even"><td>219</td>
-<td>219</td>
-<td>219</td>
-<td>grey86</td>
-</tr>
-<tr class="row-odd"><td>222</td>
-<td>222</td>
-<td>222</td>
-<td>gray87</td>
-</tr>
-<tr class="row-even"><td>222</td>
-<td>222</td>
-<td>222</td>
-<td>grey87</td>
-</tr>
-<tr class="row-odd"><td>224</td>
-<td>224</td>
-<td>224</td>
-<td>gray88</td>
-</tr>
-<tr class="row-even"><td>224</td>
-<td>224</td>
-<td>224</td>
-<td>grey88</td>
-</tr>
-<tr class="row-odd"><td>227</td>
-<td>227</td>
-<td>227</td>
-<td>gray89</td>
-</tr>
-<tr class="row-even"><td>227</td>
-<td>227</td>
-<td>227</td>
-<td>grey89</td>
-</tr>
-<tr class="row-odd"><td>229</td>
-<td>229</td>
-<td>229</td>
-<td>gray90</td>
-</tr>
-<tr class="row-even"><td>229</td>
-<td>229</td>
-<td>229</td>
-<td>grey90</td>
-</tr>
-<tr class="row-odd"><td>232</td>
-<td>232</td>
-<td>232</td>
-<td>gray91</td>
-</tr>
-<tr class="row-even"><td>232</td>
-<td>232</td>
-<td>232</td>
-<td>grey91</td>
-</tr>
-<tr class="row-odd"><td>235</td>
-<td>235</td>
-<td>235</td>
-<td>gray92</td>
-</tr>
-<tr class="row-even"><td>235</td>
-<td>235</td>
-<td>235</td>
-<td>grey92</td>
-</tr>
-<tr class="row-odd"><td>237</td>
-<td>237</td>
-<td>237</td>
-<td>gray93</td>
-</tr>
-<tr class="row-even"><td>237</td>
-<td>237</td>
-<td>237</td>
-<td>grey93</td>
-</tr>
-<tr class="row-odd"><td>240</td>
-<td>240</td>
-<td>240</td>
-<td>gray94</td>
-</tr>
-<tr class="row-even"><td>240</td>
-<td>240</td>
-<td>240</td>
-<td>grey94</td>
-</tr>
-<tr class="row-odd"><td>242</td>
-<td>242</td>
-<td>242</td>
-<td>gray95</td>
-</tr>
-<tr class="row-even"><td>242</td>
-<td>242</td>
-<td>242</td>
-<td>grey95</td>
-</tr>
-<tr class="row-odd"><td>245</td>
-<td>245</td>
-<td>245</td>
-<td>gray96</td>
-</tr>
-<tr class="row-even"><td>245</td>
-<td>245</td>
-<td>245</td>
-<td>grey96</td>
-</tr>
-<tr class="row-odd"><td>247</td>
-<td>247</td>
-<td>247</td>
-<td>gray97</td>
-</tr>
-<tr class="row-even"><td>247</td>
-<td>247</td>
-<td>247</td>
-<td>grey97</td>
-</tr>
-<tr class="row-odd"><td>250</td>
-<td>250</td>
-<td>250</td>
-<td>gray98</td>
-</tr>
-<tr class="row-even"><td>250</td>
-<td>250</td>
-<td>250</td>
-<td>grey98</td>
-</tr>
-<tr class="row-odd"><td>252</td>
-<td>252</td>
-<td>252</td>
-<td>gray99</td>
-</tr>
-<tr class="row-even"><td>252</td>
-<td>252</td>
-<td>252</td>
-<td>grey99</td>
-</tr>
-<tr class="row-odd"><td>255</td>
-<td>255</td>
-<td>255</td>
-<td>gray100</td>
-</tr>
-<tr class="row-even"><td>255</td>
-<td>255</td>
-<td>255</td>
-<td>grey100</td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="further-information">
-<h2>Further Information<a class="headerlink" href="#further-information" title="Permalink to this headline">¶</a></h2>
-<p>For more information on the use of color, read Appendix I of the <strong>GMT
-TECHNICAL REFERENCE AND COOKBOOK</strong>.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> , <a class="reference internal" href="gmtlogo.html"><em>gmtlogo</em></a> ,
-<a class="reference internal" href="grdcontour.html"><em>grdcontour</em></a> ,
-<a class="reference internal" href="grdvector.html"><em>grdvector</em></a> , <a class="reference internal" href="grdview.html"><em>grdview</em></a>
-<a class="reference internal" href="psbasemap.html"><em>psbasemap</em></a> ,
-<a class="reference internal" href="pscoast.html"><em>pscoast</em></a> , <a class="reference internal" href="pscontour.html"><em>pscontour</em></a>,
-<a class="reference internal" href="pshistogram.html"><em>pshistogram</em></a> ,
-<a class="reference internal" href="psimage.html"><em>psimage</em></a> , <a class="reference internal" href="pslegend.html"><em>pslegend</em></a> ,
-<a class="reference internal" href="psmask.html"><em>psmask</em></a> , <a class="reference internal" href="psrose.html"><em>psrose</em></a> ,
-<a class="reference internal" href="pstext.html"><em>pstext</em></a> , <a class="reference internal" href="pswiggle.html"><em>pswiggle</em></a> ,
-<a class="reference internal" href="psxy.html"><em>psxy</em></a> , <a class="reference internal" href="psxyz.html"><em>psxyz</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">gmtcolors</a><ul>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#list-of-colors">List Of Colors</a></li>
-<li><a class="reference internal" href="#further-information">Further Information</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="gmt5syntax.html"
- title="previous chapter">gmt5syntax</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="gmtconnect.html"
- title="next chapter">gmtconnect</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/gmtcolors.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="gmtconnect.html" title="gmtconnect"
- >next</a> </li>
- <li class="right" >
- <a href="gmt5syntax.html" title="gmt5syntax"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" >GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gmtconnect.html b/doc_release/html/gmtconnect.html
deleted file mode 100644
index b9cf79e..0000000
--- a/doc_release/html/gmtconnect.html
+++ /dev/null
@@ -1,347 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>gmtconnect — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GM" href="GM.html" />
- <link rel="next" title="gmtconvert" href="gmtconvert.html" />
- <link rel="prev" title="gmtcolors" href="gmtcolors.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="gmtconvert.html" title="gmtconvert"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="gmtcolors.html" title="gmtcolors"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" accesskey="U">GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gmtconnect">
-<span id="index-0"></span><h1>gmtconnect<a class="headerlink" href="#gmtconnect" title="Permalink to this headline">¶</a></h1>
-<p>gmtconnect - Connect individual lines whose end points match within tolerance</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmtconnect</strong> [ <em>table</em> ] [ <strong>-C</strong>[<em>closed</em>] ]
-[ <strong>-D</strong>[<em>template</em>] ] [ <strong>-L</strong>[<em>linkfile</em>] ]
-[ <strong>-Q</strong>[<em>template</em>] ] [ <strong>-T</strong><em>cutoff</em>[<em>unit</em>][/<em>nn_dist</em>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-b</strong>[<strong>i</strong>|<strong>o</strong>][<em>ncol</em>][<strong>type</strong>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-o</strong><em>cols</em>[,...] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmtconnect</strong> reads standard input or one or more data files, which may
-be multisegment files, and examines the coordinates of the end points of
-all line segments. If a pair of end points are identical or closer to
-each other than the specified separation tolerance then the two line
-segments are joined into a single segment. The process repeats until all
-the remaining endpoints no longer pass the tolerance test; the resulting
-segments are then written out to standard output or specified output
-file. If it is not clear what the separation tolerance should be then
-use <strong>-L</strong> to get a list of all separation distances and analyze them to
-determine a suitable cutoff.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<p>None.</p>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>[<em>ncols</em>][<em>type</em>]) data
-table file(s) holding a number of data columns. If no tables are given
-then we read from standard input. </dd>
-<dt><strong>-C</strong>[<em>closed</em>]</dt>
-<dd>Write all the closed polygons to <em>closed</em> [gmtconnect_closed.txt]
-and all other segments as they are to stdout. No connection takes
-place. Use <strong>-T</strong><em>cutoff</em> to set a minimum separation [0], and if
-<em>cutoff</em> is > 0 then we also explicitly close the polygons on output.</dd>
-<dt><strong>-D</strong>[<em>template</em>]</dt>
-<dd>For multiple segment data, dump each segment to a separate output
-file [Default writes a single multiple segment file]. Append a
-format template for the individual file names; this template
-<strong>must</strong> contain a C format specifier that can format an integer
-argument (the segment number); this is usually %d but could be %08d
-which gives leading zeros, etc. Optionally, it may also contain the
-format %c <em>before</em> the integer; this will then be replaced by C
-(closed) or O (open) to indicate segment type. [Default is
-gmtconnect_segment_%d.txt]. Note that segment headers will be
-written in either case. For composite segments, a generic segment
-header will be written and the segment headers of individual pieces
-will be written out as comments to make it possible to identify
-where the connected pieces came from.</dd>
-<dt><strong>-L</strong>[<em>linkfile</em>]</dt>
-<dd>Writes the link information to the specified file
-[gmtconnect_link.txt]. For each segment we write the original
-segment id, and for the beginning and end point of the segment we
-report the id of the closest segment, whether it is the beginning
-(B) or end (E) point that is closest, and the distance between those
-points in units determined by <strong>-T</strong>.</dd>
-<dt><strong>-Q</strong>[<em>template</em>]</dt>
-<dd>Used with <strong>-D</strong> to a list file with the names of the individual
-output files. Optionally, append a filename template for the
-individual file names; this template <strong>may</strong> contain a C format
-specifier that can format an character (C or O for closed or open,
-respectively). [Default is gmtconnect_list.txt].</dd>
-<dt><strong>-T</strong><em>cutoff</em>[<em>unit</em>][/<em>nn_dist</em>]</dt>
-<dd>Specifies the separation tolerance in the data coordinate units [0];
-append distance unit (see UNITS). If two lines has end-points that
-are closer than this cutoff they will be joined. Optionally, append
-/<em>nn_dist</em> which adds the requirement that a link will only be made
-if the second closest connection exceeds the <em>nn_dist</em>. The latter
-distance must be given in the same units as <em>cutoff</em>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 2 input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. [Default is same as input].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] <a class="reference internal" href="gmt.html#g-full"><em>(more ...)</em></a></dt>
-<dd>Determine data gaps and line breaks. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-o</strong><em>cols</em>[,...] <a class="reference internal" href="gmt.html#ocols-full"><em>(more ...)</em></a></dt>
-<dd>Select output columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc9">Units</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>For map distance unit, append <em>unit</em> <strong>d</strong> for arc degree, <strong>m</strong> for arc
-minute, and <strong>s</strong> for arc second, or <strong>e</strong> for meter [Default], <strong>f</strong>
-for foot, <strong>k</strong> for km, <strong>M</strong> for statute mile, <strong>n</strong> for nautical mile,
-and <strong>u</strong> for US survey foot. By default we compute such distances using
-a spherical approximation with great circles. Prepend <strong>-</strong> to a
-distance (or the unit is no distance is given) to perform “Flat Earth”
-calculations (quicker but less accurate) or prepend <strong>+</strong> to perform
-exact geodesic calculations (slower but more accurate).</p>
-</div>
-<div class="section" id="ascii-format-precision">
-<h2>Ascii Format Precision<a class="headerlink" href="#ascii-format-precision" title="Permalink to this headline">¶</a></h2>
-<p>The ASCII output formats of numerical data are controlled by parameters
-in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file. Longitude and latitude are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>, whereas other values are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>. Be aware that the format in effect
-can lead to loss of precision in the output, which can lead to various
-problems downstream. If you find the output is not written with enough
-precision, consider switching to binary output (<strong>-bo</strong> if available) or
-specify more decimals using the <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> setting.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To combine the digitized segment lines segment_*.txt (whose
-coordinates are in cm) into as few complete lines as possible, assuming
-the end points slop could be up to 0.1 mm, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt connect segment_*.txt -Tf0.1 > new_segments.txt
-</pre></div>
-</div>
-</div></blockquote>
-<p>To combine the digitized segments in the multisegment file my_lines.txt
-(whose coordinates are in lon,lat) into as few complete lines as
-possible, assuming the end points slop could be up to 150 m, and write
-the complete segments to separate files called Map_segment_0001.dat,
-Map_segment_0002.dat, etc., run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt connect my_lines.txt -T150e -DMap_segment_%04d.dat
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="bugs">
-<h2>Bugs<a class="headerlink" href="#bugs" title="Permalink to this headline">¶</a></h2>
-<p>The line connection does not work if a line only has a single point.
-However, gmtconnect will correctly add the point to the nearest segment.
-Running gmtconnect again on the new set of lines will eventually connect
-all close lines.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>,
-<a class="reference internal" href="gmtsimplify.html"><em>gmtsimplify</em></a>,
-<a class="reference internal" href="gmtspatial.html"><em>gmtspatial</em></a>,
-<a class="reference internal" href="mapproject.html"><em>mapproject</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">gmtconnect</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#id1">Units</a></li>
-<li><a class="reference internal" href="#ascii-format-precision">Ascii Format Precision</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#bugs">Bugs</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="gmtcolors.html"
- title="previous chapter">gmtcolors</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="gmtconvert.html"
- title="next chapter">gmtconvert</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/gmtconnect.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="gmtconvert.html" title="gmtconvert"
- >next</a> </li>
- <li class="right" >
- <a href="gmtcolors.html" title="gmtcolors"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" >GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gmtconvert.html b/doc_release/html/gmtconvert.html
deleted file mode 100644
index 3115aaa..0000000
--- a/doc_release/html/gmtconvert.html
+++ /dev/null
@@ -1,424 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>gmtconvert — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GM" href="GM.html" />
- <link rel="next" title="gmtdefaults" href="gmtdefaults.html" />
- <link rel="prev" title="gmtconnect" href="gmtconnect.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="gmtdefaults.html" title="gmtdefaults"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="gmtconnect.html" title="gmtconnect"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" accesskey="U">GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gmtconvert">
-<span id="index-0"></span><h1>gmtconvert<a class="headerlink" href="#gmtconvert" title="Permalink to this headline">¶</a></h1>
-<p>gmtconvert - Convert, Paste, and/or Extract columns from data tables</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmtconvert</strong> [ <em>table</em> ] [ <strong>-A</strong> ] [ <strong>-D</strong>[<em>template</em>] ]
-[ <strong>-E</strong>[<strong>f</strong>|<strong>l</strong>|<strong>m</strong><em>stride</em>] ] [ <strong>-L</strong> ]
-[ <strong>-I</strong>[<strong>tsr</strong>] ] [ <strong>-Q</strong>[<strong>~</strong>]*selection* ]
-[ <strong>-S</strong>[<strong>~</strong>]<em>“search string”</em> |
-<strong>-S</strong>[<strong>~</strong>]/<em>regexp</em>/[<strong>i</strong>] ]
-[ <strong>-T</strong> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-a</strong><em>col</em>=<em>name</em>[<em>...</em>] ]
-[ <strong>-b</strong>[<strong>i</strong>|<strong>o</strong>][<em>ncol</em>][<strong>type</strong>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-o</strong><em>cols</em>[,...] ]
-[ <strong>-s</strong>[<em>cols</em>][<strong>a</strong>|<strong>r</strong>] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmtconvert</strong> reads its standard input [or input files] and writes out
-the desired information to standard output. It can do a combination of
-seven tasks: (1) convert between binary and ASCII data tables, (2) paste
-corresponding records from multiple files horizontally into a single
-file, (3) extract a subset of the available columns, (4) only extract
-segments whose header record matches a text pattern search, (5) only
-list segment headers and no data records, (6) extract first and/or last
-data record for each segment, and (7) reverse the order
-of items on output. Input (and hence output) may have multiple
-sub-headers, and ASCII tables may have regular headers as well.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<p>None</p>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>[<em>ncols</em>][<em>type</em>]) data
-table file(s) holding a number of data columns. If no tables are given
-then we read from standard input. </dd>
-<dt><strong>-A</strong></dt>
-<dd>The records from the input files should be pasted horizontally, not
-appended vertically [Default]. All files must have the same number
-of segments and number of rows per segment. Note for binary input,
-all the files you want to paste must have the same number of columns
-(as set with <strong>-bi</strong>); ascii tables can have different number of columns.</dd>
-<dt><strong>-D</strong>[<em>template</em>]</dt>
-<dd>For multiple segment data, dump each segment to a separate output
-file [Default writes a multiple segment file to stdout]. Append a
-format template for the individual file names; this template
-<strong>must</strong> contain a C format specifier that can format an integer
-argument (the running segment number across all tables); this is
-usually %d but could be %08d which gives leading zeros, etc.
-[Default is gmtconvert_segment_%d.{txt|bin}, depending on
-<strong>-bo</strong>]. Alternatively, give a template with
-two C format specifiers and we will supply the table number and the
-segment number within the table to build the file name.</dd>
-<dt><strong>-E</strong>[<strong>f</strong>|<strong>l</strong>|<strong>m</strong><em>stride</em>]</dt>
-<dd>Only extract the first and last record for each segment of interest
-[Default extracts all records]. Optionally, append <strong>f</strong> or <strong>l</strong> to
-only extract the first or last record of each segment, respectively.
-Alternatively, append <strong>m</strong><em>stride</em> to extract only one out of <em>stride</em> records.</dd>
-<dt><strong>-I</strong></dt>
-<dd>Invert the order of items, i.e., output the items in reverse order,
-starting with the last and ending up with the first item [Default
-keeps original order]. Append up to three items that should be
-reversed: <strong>t</strong> will reverse the order of tables, <strong>s</strong> will reverse
-the order of segments within each table, and <strong>r</strong> will reverse the
-order of records within each segment [Default].</dd>
-<dt><strong>-L</strong></dt>
-<dd>Only output a listing of all segment header records and no data
-records (requires ASCII data).</dd>
-<dt><strong>-Q</strong>[<strong>~</strong>]*selection*</dt>
-<dd>Only write segments whose number is included in <em>selection</em> and skip
-all others. Cannot be used with <strong>-S</strong>. The <em>selection</em> syntax is
-<em>range*[,*range</em>,...] where each <em>range</em> of items is either a single
-segment <em>number</em>, a range of segment numbers <em>start-stop</em>, or a range with
-stepped increments given via <em>start:step:stop</em>. A leading <strong>~</strong> will
-invert the selection and write all segments but the ones listed. Instead
-of a list of ranges, use <strong>+f</strong><em>file</em> to supply a file list with one
-<em>range</em> per line.</dd>
-<dt><strong>-S</strong>[<strong>~</strong>]<em>“search string”</em> or <strong>-S</strong>[<strong>~</strong>]/<em>regexp</em>/[<strong>i</strong>]</dt>
-<dd>Only output those segments whose header record contains the
-specified text string. To reverse the search, i.e., to output
-segments whose headers do <em>not</em> contain the specified pattern, use
-<strong>-S~</strong>. Should your pattern happen to start with ~ you need to
-escape this character with a backslash [Default output all
-segments]. Cannot be used with <strong>-Q</strong>. For matching segments based
-on aspatial values (via OGR/GMT format), give the search string as
-<em>varname</em>=<em>value</em> and we will compare <em>value</em> against the value
-of <em>varname</em> for each segment. Note: If the features are polygons
-then a match of a particular polygon perimeter also means that any
-associated polygon holes will also be matched. For matching segment
-headers against extended regular expressions enclose the expression
-in slashes. Append <strong>i</strong> for caseless matching.
-For a list of such patterns, give <strong>+f</strong><em>file</em> with one pattern per line.
-To give a single pattern starting with +f, escape it with a backslash.</dd>
-<dt><strong>-T</strong></dt>
-<dd>Suppress the writing of segment headers on output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-a</strong><em>col</em>=<em>name</em>[<em>...</em>] <a class="reference internal" href="gmt.html#aspatial-full"><em>(more ...)</em></a></dt>
-<dd>Set aspatial column associations <em>col</em>=<em>name</em>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. [Default is same as input].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] <a class="reference internal" href="gmt.html#g-full"><em>(more ...)</em></a></dt>
-<dd>Determine data gaps and line breaks. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-o</strong><em>cols</em>[,...] <a class="reference internal" href="gmt.html#ocols-full"><em>(more ...)</em></a></dt>
-<dd>Select output columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-s</strong>[<em>cols</em>][<strong>a</strong>|<strong>r</strong>] <a class="reference internal" href="gmt.html#s-full"><em>(more ...)</em></a></dt>
-<dd>Set handling of NaN records.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="ascii-format-precision">
-<h2>Ascii Format Precision<a class="headerlink" href="#ascii-format-precision" title="Permalink to this headline">¶</a></h2>
-<p>The ASCII output formats of numerical data are controlled by parameters
-in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file. Longitude and latitude are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>, whereas other values are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>. Be aware that the format in effect
-can lead to loss of precision in the output, which can lead to various
-problems downstream. If you find the output is not written with enough
-precision, consider switching to binary output (<strong>-bo</strong> if available) or
-specify more decimals using the <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> setting.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To convert the binary file test.b (single precision) with 4 columns to ASCII:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtconvert test.b -bi4f > test.dat
-</pre></div>
-</div>
-</div></blockquote>
-<p>To convert the multiple segment ASCII table test.d to a double precision binary file:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtconvert test.d -bo > test.b
-</pre></div>
-</div>
-</div></blockquote>
-<p>You have an ASCII table with 6 columns and you want to plot column 5 versus column 0. Try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtconvert table.d -o5,0 | psxy ...
-</pre></div>
-</div>
-</div></blockquote>
-<p>If the file instead is the binary file results.b which has 9
-single-precision values per record, we extract the last column and
-columns 4-6 and write ASCII with the command</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtconvert results.b -o8,4-6 -bi9s | psxy ...
-</pre></div>
-</div>
-</div></blockquote>
-<p>You want to plot the 2nd column of a 2-column file left.d versus the
-first column of a file right.d:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtconvert left.d right.d -A -o1,2 | psxy ...
-</pre></div>
-</div>
-</div></blockquote>
-<p>To extract all segments in the file big_file.d whose headers contain
-the string “RIDGE AXIS”, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtconvert big_file.d -S"RIDGE AXIS" > subset.d
-</pre></div>
-</div>
-</div></blockquote>
-<p>To invert the selection of segments whose headers begin with “profile ”
-followed by an integer number and any letter between “g” and “l”, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtconvert -S~"/^profile [0-9]+[g-l]$/"
-</pre></div>
-</div>
-</div></blockquote>
-<p>To reverse the order of segments in a file without reversing the order
-of records within each segment, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtconvert lots_of_segments.txt -Is > last_segment_first.txt
-</pre></div>
-</div>
-</div></blockquote>
-<p>To extract segments 20 to 40 in steps of 2, plus segment 0 in a file, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtconvert lots_of_segments.txt -Q0,20:2:40 > my_segments.txt
-</pre></div>
-</div>
-</div></blockquote>
-<p>To extract the attribute ELEVATION from an ogr gmt file like this</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre># @VGMT1.0 @GPOINT
-...
-# @NELEVATION|DISPX|DISPY
-# @Tdouble|double|double
-# FEATURE_DATA
-# @D4.945000|-106500.00000000|-32700.00000000
--9.36890245902635 39.367156766570389
-</pre></div>
-</div>
-</div></blockquote>
-<p>do</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtconvert file.gmt -a2=ELEVATION > xyz.dat
-</pre></div>
-</div>
-</div></blockquote>
-<p>or just</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtconvert file.gmt -aELEVATION > xyz.dat
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="gmtinfo.html"><em>gmtinfo</em></a>,
-<a class="reference internal" href="gmtselect.html"><em>gmtselect</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">gmtconvert</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#ascii-format-precision">Ascii Format Precision</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="gmtconnect.html"
- title="previous chapter">gmtconnect</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="gmtdefaults.html"
- title="next chapter">gmtdefaults</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/gmtconvert.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="gmtdefaults.html" title="gmtdefaults"
- >next</a> </li>
- <li class="right" >
- <a href="gmtconnect.html" title="gmtconnect"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" >GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gmtdefaults.html b/doc_release/html/gmtdefaults.html
deleted file mode 100644
index 8a4c680..0000000
--- a/doc_release/html/gmtdefaults.html
+++ /dev/null
@@ -1,240 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>gmtdefaults — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GM" href="GM.html" />
- <link rel="next" title="gmtget" href="gmtget.html" />
- <link rel="prev" title="gmtconvert" href="gmtconvert.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="gmtget.html" title="gmtget"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="gmtconvert.html" title="gmtconvert"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" accesskey="U">GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gmtdefaults">
-<span id="index-0"></span><h1>gmtdefaults<a class="headerlink" href="#gmtdefaults" title="Permalink to this headline">¶</a></h1>
-<p>gmtdefaults - List current GMT default parameters</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmtdefaults</strong> [ <strong>-D</strong>[<strong>u</strong>|<strong>s</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmtdefaults</strong> lists the GMT parameter defaults if the option
-<strong>-D</strong> is used. There are three ways to change some of the settings: (1)
-Use the command <a class="reference internal" href="gmtset.html"><em>gmtset</em></a>, (2) use any texteditor to edit the file
-<a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> in your home, ~/.gmt or current directory (if you do not
-have this file, run <a class="reference internal" href="gmtset.html"><em>gmtset</em></a> <strong>-D</strong> to get one with the system default
-settings), or (3) override any parameter by specifying one
-or more <strong>-</strong><strong>-PARAMETER</strong>=<em>VALUE</em> statements on the commandline of any
-GMT command (<strong>PARAMETER</strong> and <em>VALUE</em> are any combination listed
-below). The first two options are permanent changes until explicitly
-changed back, while the last option is ephemeral and only applies to the
-single GMT command that received the override. GMT can provide
-default values in US or SI units. This choice is determined at compile time.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<p>None.</p>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-D</strong></dt>
-<dd>Print the system GMT defaults to standard output. Append <strong>u</strong>
-for US defaults or <strong>s</strong> for SI defaults. [<strong>-D</strong> alone gives the
-version selected at compile time; If <strong>-D</strong> is omitted, the user’s
-currently active defaults are printed.]</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-<p>Your currently active defaults come from the <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file in
-the current working directory, if present; else from the
-<a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file in your home directory, if present; else from the
-file <strong>~/.gmt/gmt.conf</strong> if present; else from the system defaults
-set at the time GMT was compiled.</p>
-</div>
-<div class="section" id="gmt-parameters">
-<h2>GMT PARAMETERS<a class="headerlink" href="#gmt-parameters" title="Permalink to this headline">¶</a></h2>
-<p>Read the <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> man page for a full list of the parameters that
-are user-definable in GMT.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To get a copy of the GMT parameter defaults in your home directory, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtdefaults -D > ~/gmt.conf
-</pre></div>
-</div>
-</div></blockquote>
-<p>You may now change the settings by editing this file using a text editor
-of your choice, or use <strong>gmtset</strong> to change specified parameters on the
-command line.</p>
-</div>
-<div class="section" id="bugs">
-<h2>Bugs<a class="headerlink" href="#bugs" title="Permalink to this headline">¶</a></h2>
-<p>If you have typographical errors in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file(s), a warning
-message will be issued, and the GMT defaults for the affected
-parameters will be used.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>,
-<a class="reference internal" href="gmtcolors.html"><em>gmtcolors</em></a>, <a class="reference internal" href="gmtget.html"><em>gmtget</em></a>,
-<a class="reference internal" href="gmtset.html"><em>gmtset</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">gmtdefaults</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#gmt-parameters">GMT PARAMETERS</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#bugs">Bugs</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="gmtconvert.html"
- title="previous chapter">gmtconvert</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="gmtget.html"
- title="next chapter">gmtget</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/gmtdefaults.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="gmtget.html" title="gmtget"
- >next</a> </li>
- <li class="right" >
- <a href="gmtconvert.html" title="gmtconvert"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" >GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gmtget.html b/doc_release/html/gmtget.html
deleted file mode 100644
index f91874d..0000000
--- a/doc_release/html/gmtget.html
+++ /dev/null
@@ -1,210 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>gmtget — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GM" href="GM.html" />
- <link rel="next" title="gmtinfo" href="gmtinfo.html" />
- <link rel="prev" title="gmtdefaults" href="gmtdefaults.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="gmtinfo.html" title="gmtinfo"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="gmtdefaults.html" title="gmtdefaults"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" accesskey="U">GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gmtget">
-<span id="index-0"></span><h1>gmtget<a class="headerlink" href="#gmtget" title="Permalink to this headline">¶</a></h1>
-<p>gmtget - Get individual GMT default parameters</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmtget</strong> [ <strong>-G</strong><em>defaultsfile</em> ] [ <strong>-L</strong> ] <em>PARAMETER1</em> [ <em>PARAMETER2</em> <em>PARAMETER3</em> ... ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmtget</strong> will list the value of one or more GMT default parameters.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt>PARAMETER</dt>
-<dd>Provide one or several parameters of interest. The current value of
-those parameters will be writen to <em>stdout</em>. For a complete listing
-of available parameters and their meaning, see the <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> man page.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-G</strong><em>defaultsfile</em></dt>
-<dd>Name of specific <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file to read [Default looks first in
-current directory, then in your home directory, then in ~/.gmt and
-finally in the system defaults].</dd>
-<dt><strong>-L</strong></dt>
-<dd>Return the values of the parameters on separate lines [Default
-returns all selected parameter values on one line separated by
-spaces]</dd>
-</dl>
-</div>
-<div class="section" id="example">
-<h2>Example<a class="headerlink" href="#example" title="Permalink to this headline">¶</a></h2>
-<p>To list the value of the parameter PS_COMMENTS:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt get PS_COMMENTS
-</pre></div>
-</div>
-</div></blockquote>
-<p>To get both the values of the parameter
-MAP_GRID_CROSS_SIZE_PRIMARY and MAP_GRID_CROSS_SIZE_SECONDARY on one line, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt get MAP_GRID_CROSS_SIZE_PRIMARY MAP_GRID_CROSS_SIZE_SECONDARY
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>,
-<a class="reference internal" href="gmtdefaults.html"><em>gmtdefaults</em></a>,
-<a class="reference internal" href="gmtset.html"><em>gmtset</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">gmtget</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#example">Example</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="gmtdefaults.html"
- title="previous chapter">gmtdefaults</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="gmtinfo.html"
- title="next chapter">gmtinfo</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/gmtget.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="gmtinfo.html" title="gmtinfo"
- >next</a> </li>
- <li class="right" >
- <a href="gmtdefaults.html" title="gmtdefaults"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" >GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gmtinfo.html b/doc_release/html/gmtinfo.html
deleted file mode 100644
index ab6c7fd..0000000
--- a/doc_release/html/gmtinfo.html
+++ /dev/null
@@ -1,350 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>gmtinfo — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GM" href="GM.html" />
- <link rel="next" title="gmtlogo" href="gmtlogo.html" />
- <link rel="prev" title="gmtget" href="gmtget.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="gmtlogo.html" title="gmtlogo"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="gmtget.html" title="gmtget"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" accesskey="U">GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gmtinfo">
-<span id="index-0"></span><h1>gmtinfo<a class="headerlink" href="#gmtinfo" title="Permalink to this headline">¶</a></h1>
-<p>gmtinfo - Get information about data tables</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmtinfo</strong> [ <em>table</em> ] [ <strong>-A</strong><strong>a</strong>|<strong>f</strong>|<strong>s</strong> ] [ <strong>-C</strong> ]
-[ <strong>-D</strong>[<em>dx</em>[/<em>dy</em>]] ] [ <strong>-EL</strong>|<strong>l</strong>|<strong>H</strong>|<strong>h</strong><em>col</em> ]
-[ <strong>-I</strong>[<strong>p</strong>|<strong>f</strong>|<strong>s</strong>]<em>dx</em>[/<em>dy</em>[/<em>dz</em>...] ]
-[ <strong>-S</strong>[<strong>x</strong>][<strong>y</strong>] ] [ <strong>-T</strong><em>dz</em>[/<em>col</em>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-bi</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-o</strong><em>cols</em>[,...] ]
-[ <strong>-r</strong> ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmtinfo</strong> reads its standard input [or from files] and finds the
-extreme values in each of the columns. It recognizes NaNs and will print
-warnings if the number of columns vary from record to record. As an
-option, <strong>gmtinfo</strong> will find the extent of the first <em>n</em> columns rounded
-up and down to the nearest multiple of the supplied increments. By
-default, this output will be in the form <strong>-R</strong><em>w/e/s/n</em> which can be
-used directly in the command line for other programs (hence only <em>dx</em>
-and <em>dy</em> are needed), or the output will be in column form for as many
-columns as there are increments provided. A similar option (<strong>-T</strong>) will
-provide a <strong>-T</strong><em>zmin/zmax/dz</em> string for makecpt.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<p>None.</p>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>[<em>ncols</em>][<em>type</em>]) data
-table file(s) holding a number of data columns. If no tables are given
-then we read from standard input. </dd>
-<dt><strong>-A</strong><strong>a</strong>|<strong>f</strong>|<strong>s</strong></dt>
-<dd>Specify how the range should be reported. Choose <strong>-Aa</strong> for the
-range of all files combined, <strong>-Af</strong> to report the range for each
-file separately, and <strong>-As</strong> to report the range for each segment
-(in multisegment files) separately. [Default is <strong>-Aa</strong>].</dd>
-<dt><strong>-C</strong></dt>
-<dd>Report the min/max values per column in separate columns [Default
-uses <min/max> format]. When used, users may also use <strong>-o</strong> to
-limit which output columns should be reported [all].</dd>
-<dt><strong>-D</strong></dt>
-<dd>Modifies results obtained by <strong>-I</strong> by shifting the region to better
-align with the center of the data. Optionally, append granularity
-for this shift [Default performs an exact shift].</dd>
-<dt><strong>-EL</strong>|<strong>l</strong>|<strong>H</strong>|<strong>h</strong><em>col</em></dt>
-<dd>Returns the record whose column <em>col</em> contains the minimum
-(<strong>l</strong>) or maximum (<strong>h</strong>) value. Upper case
-(<strong>L|H</strong>) works on absolute value of the data. In case of multiple
-matches, only the first record is returned. If <em>col</em> is not
-specified we default to the last column in the data.</dd>
-<dt><strong>-I</strong>[<strong>p</strong>|<strong>f</strong>|<strong>s</strong>]<em>dx</em>[/<em>dy</em>[/<em>dz</em>...]</dt>
-<dd>Report the min/max of the first <em>n</em> columns to the nearest multiple
-of the provided increments (separate the <em>n</em> increments by slashes),
-and output results in the form <strong>-R</strong><em>w/e/s/n</em> (unless <strong>-C</strong> is
-set). If only one increment is given we also use it for the second
-column (for backwards compatibility). To override this behavior, use
-<strong>-Ip</strong><em>dx</em>. If the input <em>x</em>- and <em>y</em>-coordinates all have the
-same phase shift relative to the <em>dx</em> and <em>dy</em> increments then we
-use those phase shifts in determining the region, and you may use
-<strong>-r</strong> to switch from gridline-registration to pixel-registration.
-For irregular data both phase shifts are set to 0 and the <strong>-r</strong> is ignored.
-Use <strong>-If</strong><em>dx</em>[/<em>dy</em>] to report an extended region optimized
-to give grid dimensions for fastest results in programs using FFTs.
-Use <strong>-Is</strong><em>dx</em>[/<em>dy</em>] to report an extended region optimized to
-give grid dimensions for fastest results in programs like surface.
-If <em>dx</em> is given as - then the actual min/max of the input is given
-in the <strong>-R</strong> string.</dd>
-<dt><strong>-S</strong>[<strong>x</strong>][<strong>y</strong>]</dt>
-<dd>Add extra space for error bars. Useful together with <strong>-I</strong> option
-and when later plotting with <strong>psxy</strong> <strong>-E</strong>. <strong>-Sx</strong> leaves space
-for horizontal error bars using the values in third
-(2) column. <strong>-Sy</strong> leaves space for vertical error
-bars using the values in third (2) column. <strong>-S</strong>
-or <strong>-Sxy</strong> leaves space for both error bars using the values in
-third and fourth (2 and 3) columns.</dd>
-<dt><strong>-T</strong><em>dz</em>[/<em>col</em>]</dt>
-<dd>Report the min/max of the first (0’th) column to the nearest
-multiple of <em>dz</em> and output this in the form <strong>-T</strong><em>zmin/zmax/dz</em>.
-To use another column, append /<em>col</em>. Only works when <strong>-I</strong> is
-selected.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 2 input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] <a class="reference internal" href="gmt.html#g-full"><em>(more ...)</em></a></dt>
-<dd>Determine data gaps and line breaks. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-r</strong> <a class="reference internal" href="gmt.html#nodereg-full"><em>(more ...)</em></a></dt>
-<dd>Set pixel node registration [gridline]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="ascii-format-precision">
-<h2>Ascii Format Precision<a class="headerlink" href="#ascii-format-precision" title="Permalink to this headline">¶</a></h2>
-<p>The ASCII output formats of numerical data are controlled by parameters
-in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file. Longitude and latitude are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>, whereas other values are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>. Be aware that the format in effect
-can lead to loss of precision in the output, which can lead to various
-problems downstream. If you find the output is not written with enough
-precision, consider switching to binary output (<strong>-bo</strong> if available) or
-specify more decimals using the <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> setting.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To find the extreme values in the file ship_gravity.xygd:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt info ship_gravity.xygd
-</pre></div>
-</div>
-</div></blockquote>
-<p>Output should look like</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>ship_gravity.xygd: N = 6992 <326.125/334.684> <-28.0711/-8.6837> <-47.7/177.6> <0.6/3544.9>
-</pre></div>
-</div>
-</div></blockquote>
-<p>To find the extreme values in the file track.xy to the nearest 5 units
-but shifted to within 1 unit of the data center, and use this region to
-draw a line using psxy, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psxy `gmt info -I5 -D1 track.xy` track.xy -Jx1 -B5 -P > track.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>To find the min and max values for each of the first 4 columns, but
-rounded to integers, and return the result individually for each data
-file, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt info profile_*.txt -C -I1/1/1/1
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="bugs">
-<h2>Bugs<a class="headerlink" href="#bugs" title="Permalink to this headline">¶</a></h2>
-<p>The <strong>-I</strong> option does not yet work properly with time series data
-(e.g., <strong>-f</strong>0T). Thus, such variable intervals as months and years
-are not calculated. Instead, specify your interval in the same units as
-the current setting of <a class="reference internal" href="gmt.conf.html#time-unit"><em>TIME_UNIT</em></a>.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="gmtconvert.html"><em>gmtconvert</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">gmtinfo</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#ascii-format-precision">Ascii Format Precision</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#bugs">Bugs</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="gmtget.html"
- title="previous chapter">gmtget</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="gmtlogo.html"
- title="next chapter">gmtlogo</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/gmtinfo.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="gmtlogo.html" title="gmtlogo"
- >next</a> </li>
- <li class="right" >
- <a href="gmtget.html" title="gmtget"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" >GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gmtlogo.html b/doc_release/html/gmtlogo.html
deleted file mode 100644
index 54dd32c..0000000
--- a/doc_release/html/gmtlogo.html
+++ /dev/null
@@ -1,190 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>gmtlogo — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GM" href="GM.html" />
- <link rel="next" title="gmtmath" href="gmtmath.html" />
- <link rel="prev" title="gmtinfo" href="gmtinfo.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="gmtmath.html" title="gmtmath"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="gmtinfo.html" title="gmtinfo"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" accesskey="U">GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gmtlogo">
-<span id="index-0"></span><h1>gmtlogo<a class="headerlink" href="#gmtlogo" title="Permalink to this headline">¶</a></h1>
-<p>gmtlogo - Adding a GMT graphics logo overlay to an illustration</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmtlogo</strong> <em>dx</em> <em>dy</em> [ <strong>-G</strong><em>fill</em> ] [ <strong>-W</strong>[<em>pen</em>] ] >> <em>plot.ps</em></p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p>This script appends the GMT logo as an overlay to an “open”
-PostScript file. The logo is 2 inches wide and 1 inch high and will be
-positioned relative to the current plot origin.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>dx</em>,<em>dy</em></dt>
-<dd>Sets the lower-left corner of the logo relative to current plot
-origin.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-G</strong><em>fill</em></dt>
-<dd>Select color or pattern for filling the underlying box [Default is
-no fill].</dd>
-<dt><strong>-W</strong>[<em>pen</em>]</dt>
-<dd>Set pen attributes for the outline of the box [Default is no
-outline].</dd>
-</dl>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="gmtcolors.html"><em>gmtcolors</em></a>,
-<a class="reference internal" href="psimage.html"><em>psimage</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">gmtlogo</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="gmtinfo.html"
- title="previous chapter">gmtinfo</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="gmtmath.html"
- title="next chapter">gmtmath</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/gmtlogo.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="gmtmath.html" title="gmtmath"
- >next</a> </li>
- <li class="right" >
- <a href="gmtinfo.html" title="gmtinfo"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" >GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gmtmath.html b/doc_release/html/gmtmath.html
deleted file mode 100644
index c56ae5d..0000000
--- a/doc_release/html/gmtmath.html
+++ /dev/null
@@ -1,1140 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>gmtmath — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GM" href="GM.html" />
- <link rel="next" title="gmtselect" href="gmtselect.html" />
- <link rel="prev" title="gmtlogo" href="gmtlogo.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="gmtselect.html" title="gmtselect"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="gmtlogo.html" title="gmtlogo"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" accesskey="U">GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gmtmath">
-<span id="index-0"></span><h1>gmtmath<a class="headerlink" href="#gmtmath" title="Permalink to this headline">¶</a></h1>
-<p>gmtmath - Reverse Polish Notation (RPN) calculator for data tables</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmtmath</strong> [ <strong>-A</strong><em>t_f(t).d</em>[<strong>+s</strong>|<strong>r</strong>] ] [ <strong>-C</strong><em>cols</em> ]
-[ <strong>-E</strong><em>eigen</em> ] [ <strong>-I</strong> ]
-[ <strong>-N</strong><em>n_col</em>[/<em>t_col</em>] ] [ <strong>-Q</strong> ] [ <strong>-S</strong>[<strong>f</strong>|<strong>l</strong>]
-] [ <strong>-T</strong><em>t_min</em>/<em>t_max</em>/<em>t_inc</em>[<strong>+</strong>]|<em>tfile</em> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-b</strong>[<strong>i</strong>|<strong>o</strong>][<em>ncol</em>][<strong>type</strong>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-o</strong><em>cols</em>[,...] ]
-[ <strong>-s</strong>[<em>cols</em>][<strong>a</strong>|<strong>r</strong>] ]
-<em>operand</em> [ <em>operand</em> ] <strong>OPERATOR</strong> [ <em>operand</em> ] <strong>OPERATOR</strong> ...
-<strong>=</strong> [ <em>outfile</em> ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmtmath</strong> will perform operations like add, subtract, multiply, and
-divide on one or more table data files or constants using Reverse Polish
-Notation (RPN) syntax (e.g., Hewlett-Packard calculator-style).
-Arbitrarily complicated expressions may therefore be evaluated; the
-final result is written to an output file [or standard output]. Data
-operations are element-by-element, not matrix manipulations (except
-where noted). Some operators only require one operand (see below). If no
-data tables are used in the expression then options <strong>-T</strong>, <strong>-N</strong> can
-be set (and optionally <strong>-bo</strong> to indicate the
-data type for binary tables). If STDIN is given, the standard input will
-be read and placed on the stack as if a file with that content had been
-given on the command line. By default, all columns except the “time”
-column are operated on, but this can be changed (see <strong>-C</strong>).
-Complicated or frequently occurring expressions may be coded as a macro
-for future use or stored and recalled via named memory locations.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>operand</em></dt>
-<dd>If <em>operand</em> can be opened as a file it will be read as an ASCII (or
-binary, see <strong>-bi</strong>) table data file. If not
-a file, it is interpreted as a numerical constant or a special
-symbol (see below). The special argument STDIN means that <em>stdin</em>
-will be read and placed on the stack; STDIN can appear more than
-once if necessary.</dd>
-<dt><em>outfile</em></dt>
-<dd>The name of a table data file that will hold the final result. If
-not given then the output is sent to stdout.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong><em>t_f(t).d</em></dt>
-<dd>Requires <strong>-N</strong> and will partially initialize a table with values
-from the given file containing <em>t</em> and <em>f(t)</em> only. The <em>t</em> is
-placed in column <em>t_col</em> while <em>f(t)</em> goes into column <em>n_col</em> - 1
-(see <strong>-N</strong>). If used with operators LSQFIT and SVDFIT you can
-optionally append the modifiers <strong>+s</strong> or <strong>+r</strong> which will write
-out the model solution or the residuals, respectively [Default
-writes one column with model coefficients].</dd>
-<dt><strong>-C</strong><em>cols</em></dt>
-<dd>Select the columns that will be operated on until next occurrence of
-<strong>-C</strong>. List columns separated by commas; ranges like 1,3-5,7 are
-allowed. <strong>-C</strong> (no arguments) resets the default action of using
-all columns except time column (see <strong>-N</strong>). <strong>-Ca</strong> selects all
-columns, including time column, while <strong>-Cr</strong> reverses (toggles) the
-current choices. When <strong>-C</strong> is in effect it also controls which
-columns from a file will be placed on the stack.</dd>
-<dt><strong>-E</strong><em>eigen</em></dt>
-<dd>Sets the minimum eigenvalue used by operators LSQFIT and SVDFIT [1e-7].
-Smaller eigenvalues are set to zero and will not be considered in the
-solution.</dd>
-<dt><strong>-I</strong></dt>
-<dd>Reverses the output row sequence from ascending time to descending
-[ascending].</dd>
-<dt><strong>-N</strong><em>n_col</em>[/<em>t_col</em>]</dt>
-<dd>Select the number of columns and optionally the column number that
-contains the “time” variable [0]. Columns are numbered starting at 0
-[2/0]. If input files are specified then <strong>-N</strong> will add any missing
-columns.</dd>
-<dt><strong>-Q</strong></dt>
-<dd>Quick mode for scalar calculation. Shorthand for <strong>-Ca</strong> <strong>-N</strong>1/0
-<strong>-T</strong>0/0/1.</dd>
-<dt><strong>-S</strong>[<strong>f</strong>|<strong>l</strong>]</dt>
-<dd>Only report the first or last row of the results [Default is all
-rows]. This is useful if you have computed a statistic (say the
-<strong>MODE</strong>) and only want to report a single number instead of
-numerous records with identical values. Append <strong>l</strong> to get the last
-row and <strong>f</strong> to get the first row only [Default].</dd>
-<dt><strong>-T</strong><em>t_min</em>/<em>t_max</em>/<em>t_inc</em>[<strong>+</strong>]|<em>tfile</em></dt>
-<dd>Required when no input files are given. Sets the t-coordinates of
-the first and last point and the equidistant sampling interval for
-the “time” column (see <strong>-N</strong>). Append <strong>+</strong> if you are specifying
-the number of equidistant points instead. If there is no time column
-(only data columns), give <strong>-T</strong> with no arguments; this also
-implies <strong>-Ca</strong>. Alternatively, give the name of a file whose first
-column contains the desired t-coordinates which may be irregular.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. [Default is same as input, but see <strong>-o</strong>]</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] <a class="reference internal" href="gmt.html#g-full"><em>(more ...)</em></a></dt>
-<dd>Determine data gaps and line breaks. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-o</strong><em>cols</em>[,...] <a class="reference internal" href="gmt.html#ocols-full"><em>(more ...)</em></a></dt>
-<dd>Select output columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-s</strong>[<em>cols</em>][<strong>a</strong>|<strong>r</strong>] <a class="reference internal" href="gmt.html#s-full"><em>(more ...)</em></a></dt>
-<dd>Set handling of NaN records.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="operators">
-<h2>Operators<a class="headerlink" href="#operators" title="Permalink to this headline">¶</a></h2>
-<p>Choose among the following 143 operators. “args” are the number of input
-and output arguments.</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="15%" />
-<col width="7%" />
-<col width="79%" />
-</colgroup>
-<tbody valign="top">
-<tr class="row-odd"><td>Operator</td>
-<td>args</td>
-<td>Returns</td>
-</tr>
-<tr class="row-even"><td><strong>ABS</strong></td>
-<td>1 1</td>
-<td>abs (A)</td>
-</tr>
-<tr class="row-odd"><td><strong>ACOS</strong></td>
-<td>1 1</td>
-<td>acos (A)</td>
-</tr>
-<tr class="row-even"><td><strong>ACOSH</strong></td>
-<td>1 1</td>
-<td>acosh (A)</td>
-</tr>
-<tr class="row-odd"><td><strong>ACSC</strong></td>
-<td>1 1</td>
-<td>acsc (A)</td>
-</tr>
-<tr class="row-even"><td><strong>ACOT</strong></td>
-<td>1 1</td>
-<td>acot (A)</td>
-</tr>
-<tr class="row-odd"><td><strong>ADD</strong></td>
-<td>2 1</td>
-<td>A + B</td>
-</tr>
-<tr class="row-even"><td><strong>AND</strong></td>
-<td>2 1</td>
-<td>B if A == NaN, else A</td>
-</tr>
-<tr class="row-odd"><td><strong>ASEC</strong></td>
-<td>1 1</td>
-<td>asec (A)</td>
-</tr>
-<tr class="row-even"><td><strong>ASIN</strong></td>
-<td>1 1</td>
-<td>asin (A)</td>
-</tr>
-<tr class="row-odd"><td><strong>ASINH</strong></td>
-<td>1 1</td>
-<td>asinh (A)</td>
-</tr>
-<tr class="row-even"><td><strong>ATAN</strong></td>
-<td>1 1</td>
-<td>atan (A)</td>
-</tr>
-<tr class="row-odd"><td><strong>ATAN2</strong></td>
-<td>2 1</td>
-<td>atan2 (A, B)</td>
-</tr>
-<tr class="row-even"><td><strong>ATANH</strong></td>
-<td>1 1</td>
-<td>atanh (A)</td>
-</tr>
-<tr class="row-odd"><td><strong>BEI</strong></td>
-<td>1 1</td>
-<td>bei (A)</td>
-</tr>
-<tr class="row-even"><td><strong>BER</strong></td>
-<td>1 1</td>
-<td>ber (A)</td>
-</tr>
-<tr class="row-odd"><td><strong>BITAND</strong></td>
-<td>2 1</td>
-<td>A & B (bitwise AND operator)</td>
-</tr>
-<tr class="row-even"><td><strong>BITLEFT</strong></td>
-<td>2 1</td>
-<td>A << B (bitwise left-shift operator)</td>
-</tr>
-<tr class="row-odd"><td><strong>BITNOT</strong></td>
-<td>1 1</td>
-<td>~A (bitwise NOT operator, i.e., return two’s complement)</td>
-</tr>
-<tr class="row-even"><td><strong>BITOR</strong></td>
-<td>2 1</td>
-<td>A | B (bitwise OR operator)</td>
-</tr>
-<tr class="row-odd"><td><strong>BITRIGHT</strong></td>
-<td>2 1</td>
-<td>A >> B (bitwise right-shift operator)</td>
-</tr>
-<tr class="row-even"><td><strong>BITTEST</strong></td>
-<td>2 1</td>
-<td>1 if bit B of A is set, else 0 (bitwise TEST operator)</td>
-</tr>
-<tr class="row-odd"><td><strong>BITXOR</strong></td>
-<td>2 1</td>
-<td>A ^ B (bitwise XOR operator)</td>
-</tr>
-<tr class="row-even"><td><strong>CEIL</strong></td>
-<td>1 1</td>
-<td>ceil (A) (smallest integer >= A)</td>
-</tr>
-<tr class="row-odd"><td><strong>CHICRIT</strong></td>
-<td>2 1</td>
-<td>Critical value for chi-squared-distribution, with alpha = A and n = B</td>
-</tr>
-<tr class="row-even"><td><strong>CHIDIST</strong></td>
-<td>2 1</td>
-<td>chi-squared-distribution P(chi2,n), with chi2 = A and n = B</td>
-</tr>
-<tr class="row-odd"><td><strong>COL</strong></td>
-<td>1 1</td>
-<td>Places column A on the stack</td>
-</tr>
-<tr class="row-even"><td><strong>CORRCOEFF</strong></td>
-<td>2 1</td>
-<td>Correlation coefficient r(A, B)</td>
-</tr>
-<tr class="row-odd"><td><strong>COS</strong></td>
-<td>1 1</td>
-<td>cos (A) (A in radians)</td>
-</tr>
-<tr class="row-even"><td><strong>COSD</strong></td>
-<td>1 1</td>
-<td>cos (A) (A in degrees)</td>
-</tr>
-<tr class="row-odd"><td><strong>COSH</strong></td>
-<td>1 1</td>
-<td>cosh (A)</td>
-</tr>
-<tr class="row-even"><td><strong>COT</strong></td>
-<td>1 1</td>
-<td>cot (A) (A in radians)</td>
-</tr>
-<tr class="row-odd"><td><strong>COTD</strong></td>
-<td>1 1</td>
-<td>cot (A) (A in degrees)</td>
-</tr>
-<tr class="row-even"><td><strong>CSC</strong></td>
-<td>1 1</td>
-<td>csc (A) (A in radians)</td>
-</tr>
-<tr class="row-odd"><td><strong>CSCD</strong></td>
-<td>1 1</td>
-<td>csc (A) (A in degrees)</td>
-</tr>
-<tr class="row-even"><td><strong>CPOISS</strong></td>
-<td>2 1</td>
-<td>Cumulative Poisson distribution F(x,lambda), with x = A and lambda = B</td>
-</tr>
-<tr class="row-odd"><td><strong>DDT</strong></td>
-<td>1 1</td>
-<td>d(A)/dt Central 1st derivative</td>
-</tr>
-<tr class="row-even"><td><strong>D2DT2</strong></td>
-<td>1 1</td>
-<td>d^2(A)/dt^2 2nd derivative</td>
-</tr>
-<tr class="row-odd"><td><strong>D2R</strong></td>
-<td>1 1</td>
-<td>Converts Degrees to Radians</td>
-</tr>
-<tr class="row-even"><td><strong>DILOG</strong></td>
-<td>1 1</td>
-<td>dilog (A)</td>
-</tr>
-<tr class="row-odd"><td><strong>DIFF</strong></td>
-<td>1 1</td>
-<td>Difference between adjacent elements of A (A[1]-A[0], A[2]-A[1], ..., 0)</td>
-</tr>
-<tr class="row-even"><td><strong>DIV</strong></td>
-<td>2 1</td>
-<td>A / B</td>
-</tr>
-<tr class="row-odd"><td><strong>DUP</strong></td>
-<td>1 2</td>
-<td>Places duplicate of A on the stack</td>
-</tr>
-<tr class="row-even"><td><strong>ERF</strong></td>
-<td>1 1</td>
-<td>Error function erf (A)</td>
-</tr>
-<tr class="row-odd"><td><strong>ERFC</strong></td>
-<td>1 1</td>
-<td>Complementary Error function erfc (A)</td>
-</tr>
-<tr class="row-even"><td><strong>ERFINV</strong></td>
-<td>1 1</td>
-<td>Inverse error function of A</td>
-</tr>
-<tr class="row-odd"><td><strong>EQ</strong></td>
-<td>2 1</td>
-<td>1 if A == B, else 0</td>
-</tr>
-<tr class="row-even"><td><strong>EXCH</strong></td>
-<td>2 2</td>
-<td>Exchanges A and B on the stack</td>
-</tr>
-<tr class="row-odd"><td><strong>EXP</strong></td>
-<td>1 1</td>
-<td>exp (A)</td>
-</tr>
-<tr class="row-even"><td><strong>FACT</strong></td>
-<td>1 1</td>
-<td>A! (A factorial)</td>
-</tr>
-<tr class="row-odd"><td><strong>FCRIT</strong></td>
-<td>3 1</td>
-<td>Critical value for F-distribution, with alpha = A, n1 = B, and n2 = C</td>
-</tr>
-<tr class="row-even"><td><strong>FDIST</strong></td>
-<td>3 1</td>
-<td>F-distribution Q(F,n1,n2), with F = A, n1 = B, and n2 = C</td>
-</tr>
-<tr class="row-odd"><td><strong>FLIPUD</strong></td>
-<td>1 1</td>
-<td>Reverse order of each column</td>
-</tr>
-<tr class="row-even"><td><strong>FLOOR</strong></td>
-<td>1 1</td>
-<td>floor (A) (greatest integer <= A)</td>
-</tr>
-<tr class="row-odd"><td><strong>FMOD</strong></td>
-<td>2 1</td>
-<td>A % B (remainder after truncated division)</td>
-</tr>
-<tr class="row-even"><td><strong>GE</strong></td>
-<td>2 1</td>
-<td>1 if A >= B, else 0</td>
-</tr>
-<tr class="row-odd"><td><strong>GT</strong></td>
-<td>2 1</td>
-<td>1 if A > B, else 0</td>
-</tr>
-<tr class="row-even"><td><strong>HYPOT</strong></td>
-<td>2 1</td>
-<td>hypot (A, B) = sqrt (A*A + B*B)</td>
-</tr>
-<tr class="row-odd"><td><strong>I0</strong></td>
-<td>1 1</td>
-<td>Modified Bessel function of A (1st kind, order 0)</td>
-</tr>
-<tr class="row-even"><td><strong>I1</strong></td>
-<td>1 1</td>
-<td>Modified Bessel function of A (1st kind, order 1)</td>
-</tr>
-<tr class="row-odd"><td><strong>IFELSE</strong></td>
-<td>3 1</td>
-<td>B if A != 0, else C</td>
-</tr>
-<tr class="row-even"><td><strong>IN</strong></td>
-<td>2 1</td>
-<td>Modified Bessel function of A (1st kind, order B)</td>
-</tr>
-<tr class="row-odd"><td><strong>INRANGE</strong></td>
-<td>3 1</td>
-<td>1 if B <= A <= C, else 0</td>
-</tr>
-<tr class="row-even"><td><strong>INT</strong></td>
-<td>1 1</td>
-<td>Numerically integrate A</td>
-</tr>
-<tr class="row-odd"><td><strong>INV</strong></td>
-<td>1 1</td>
-<td>1 / A</td>
-</tr>
-<tr class="row-even"><td><strong>ISFINITE</strong></td>
-<td>1 1</td>
-<td>1 if A is finite, else 0</td>
-</tr>
-<tr class="row-odd"><td><strong>ISNAN</strong></td>
-<td>1 1</td>
-<td>1 if A == NaN, else 0</td>
-</tr>
-<tr class="row-even"><td><strong>J0</strong></td>
-<td>1 1</td>
-<td>Bessel function of A (1st kind, order 0)</td>
-</tr>
-<tr class="row-odd"><td><strong>J1</strong></td>
-<td>1 1</td>
-<td>Bessel function of A (1st kind, order 1)</td>
-</tr>
-<tr class="row-even"><td><strong>JN</strong></td>
-<td>2 1</td>
-<td>Bessel function of A (1st kind, order B)</td>
-</tr>
-<tr class="row-odd"><td><strong>K0</strong></td>
-<td>1 1</td>
-<td>Modified Kelvin function of A (2nd kind, order 0)</td>
-</tr>
-<tr class="row-even"><td><strong>K1</strong></td>
-<td>1 1</td>
-<td>Modified Bessel function of A (2nd kind, order 1)</td>
-</tr>
-<tr class="row-odd"><td><strong>KN</strong></td>
-<td>2 1</td>
-<td>Modified Bessel function of A (2nd kind, order B)</td>
-</tr>
-<tr class="row-even"><td><strong>KEI</strong></td>
-<td>1 1</td>
-<td>kei (A)</td>
-</tr>
-<tr class="row-odd"><td><strong>KER</strong></td>
-<td>1 1</td>
-<td>ker (A)</td>
-</tr>
-<tr class="row-even"><td><strong>KURT</strong></td>
-<td>1 1</td>
-<td>Kurtosis of A</td>
-</tr>
-<tr class="row-odd"><td><strong>LE</strong></td>
-<td>2 1</td>
-<td>1 if A <= B, else 0</td>
-</tr>
-<tr class="row-even"><td><strong>LMSSCL</strong></td>
-<td>1 1</td>
-<td>LMS scale estimate (LMS STD) of A</td>
-</tr>
-<tr class="row-odd"><td><strong>LOG</strong></td>
-<td>1 1</td>
-<td>log (A) (natural log)</td>
-</tr>
-<tr class="row-even"><td><strong>LOG10</strong></td>
-<td>1 1</td>
-<td>log10 (A) (base 10)</td>
-</tr>
-<tr class="row-odd"><td><strong>LOG1P</strong></td>
-<td>1 1</td>
-<td>log (1+A) (accurate for small A)</td>
-</tr>
-<tr class="row-even"><td><strong>LOG2</strong></td>
-<td>1 1</td>
-<td>log2 (A) (base 2)</td>
-</tr>
-<tr class="row-odd"><td><strong>LOWER</strong></td>
-<td>1 1</td>
-<td>The lowest (minimum) value of A</td>
-</tr>
-<tr class="row-even"><td><strong>LRAND</strong></td>
-<td>2 1</td>
-<td>Laplace random noise with mean A and std. deviation B</td>
-</tr>
-<tr class="row-odd"><td><strong>LSQFIT</strong></td>
-<td>1 0</td>
-<td>Let current table be [A | b] return least squares solution x = A \ b</td>
-</tr>
-<tr class="row-even"><td><strong>LT</strong></td>
-<td>2 1</td>
-<td>1 if A < B, else 0</td>
-</tr>
-<tr class="row-odd"><td><strong>MAD</strong></td>
-<td>1 1</td>
-<td>Median Absolute Deviation (L1 STD) of A</td>
-</tr>
-<tr class="row-even"><td><strong>MAX</strong></td>
-<td>2 1</td>
-<td>Maximum of A and B</td>
-</tr>
-<tr class="row-odd"><td><strong>MEAN</strong></td>
-<td>1 1</td>
-<td>Mean value of A</td>
-</tr>
-<tr class="row-even"><td><strong>MED</strong></td>
-<td>1 1</td>
-<td>Median value of A</td>
-</tr>
-<tr class="row-odd"><td><strong>MIN</strong></td>
-<td>2 1</td>
-<td>Minimum of A and B</td>
-</tr>
-<tr class="row-even"><td><strong>MOD</strong></td>
-<td>2 1</td>
-<td>A mod B (remainder after floored division)</td>
-</tr>
-<tr class="row-odd"><td><strong>MODE</strong></td>
-<td>1 1</td>
-<td>Mode value (Least Median of Squares) of A</td>
-</tr>
-<tr class="row-even"><td><strong>MUL</strong></td>
-<td>2 1</td>
-<td>A * B</td>
-</tr>
-<tr class="row-odd"><td><strong>NAN</strong></td>
-<td>2 1</td>
-<td>NaN if A == B, else A</td>
-</tr>
-<tr class="row-even"><td><strong>NEG</strong></td>
-<td>1 1</td>
-<td>-A</td>
-</tr>
-<tr class="row-odd"><td><strong>NEQ</strong></td>
-<td>2 1</td>
-<td>1 if A != B, else 0</td>
-</tr>
-<tr class="row-even"><td><strong>NORM</strong></td>
-<td>1 1</td>
-<td>Normalize (A) so max(A)-min(A) = 1</td>
-</tr>
-<tr class="row-odd"><td><strong>NOT</strong></td>
-<td>1 1</td>
-<td>NaN if A == NaN, 1 if A == 0, else 0</td>
-</tr>
-<tr class="row-even"><td><strong>NRAND</strong></td>
-<td>2 1</td>
-<td>Normal, random values with mean A and std. deviation B</td>
-</tr>
-<tr class="row-odd"><td><strong>OR</strong></td>
-<td>2 1</td>
-<td>NaN if B == NaN, else A</td>
-</tr>
-<tr class="row-even"><td><strong>PLM</strong></td>
-<td>3 1</td>
-<td>Associated Legendre polynomial P(A) degree B order C</td>
-</tr>
-<tr class="row-odd"><td><strong>PLMg</strong></td>
-<td>3 1</td>
-<td>Normalized associated Legendre polynomial P(A) degree B order C (geophysical convention)</td>
-</tr>
-<tr class="row-even"><td><strong>POP</strong></td>
-<td>1 0</td>
-<td>Delete top element from the stack</td>
-</tr>
-<tr class="row-odd"><td><strong>POW</strong></td>
-<td>2 1</td>
-<td>A ^ B</td>
-</tr>
-<tr class="row-even"><td><strong>PQUANT</strong></td>
-<td>2 1</td>
-<td>The B’th Quantile (0-100%) of A</td>
-</tr>
-<tr class="row-odd"><td><strong>PSI</strong></td>
-<td>1 1</td>
-<td>Psi (or Digamma) of A</td>
-</tr>
-<tr class="row-even"><td><strong>PV</strong></td>
-<td>3 1</td>
-<td>Legendre function Pv(A) of degree v = real(B) + imag(C)</td>
-</tr>
-<tr class="row-odd"><td><strong>QV</strong></td>
-<td>3 1</td>
-<td>Legendre function Qv(A) of degree v = real(B) + imag(C)</td>
-</tr>
-<tr class="row-even"><td><strong>R2</strong></td>
-<td>2 1</td>
-<td>R2 = A^2 + B^2</td>
-</tr>
-<tr class="row-odd"><td><strong>R2D</strong></td>
-<td>1 1</td>
-<td>Convert Radians to Degrees</td>
-</tr>
-<tr class="row-even"><td><strong>RAND</strong></td>
-<td>2 1</td>
-<td>Uniform random values between A and B</td>
-</tr>
-<tr class="row-odd"><td><strong>RINT</strong></td>
-<td>1 1</td>
-<td>rint (A) (round to integral value nearest to A)</td>
-</tr>
-<tr class="row-even"><td><strong>ROTT</strong></td>
-<td>2 1</td>
-<td>Rotate A by the (constant) shift B in the t-direction</td>
-</tr>
-<tr class="row-odd"><td><strong>SEC</strong></td>
-<td>1 1</td>
-<td>sec (A) (A in radians)</td>
-</tr>
-<tr class="row-even"><td><strong>SECD</strong></td>
-<td>1 1</td>
-<td>sec (A) (A in degrees)</td>
-</tr>
-<tr class="row-odd"><td><strong>SIGN</strong></td>
-<td>1 1</td>
-<td>sign (+1 or -1) of A</td>
-</tr>
-<tr class="row-even"><td><strong>SIN</strong></td>
-<td>1 1</td>
-<td>sin (A) (A in radians)</td>
-</tr>
-<tr class="row-odd"><td><strong>SINC</strong></td>
-<td>1 1</td>
-<td>sinc (A) (sin (pi*A)/(pi*A))</td>
-</tr>
-<tr class="row-even"><td><strong>SIND</strong></td>
-<td>1 1</td>
-<td>sin (A) (A in degrees)</td>
-</tr>
-<tr class="row-odd"><td><strong>SINH</strong></td>
-<td>1 1</td>
-<td>sinh (A)</td>
-</tr>
-<tr class="row-even"><td><strong>SKEW</strong></td>
-<td>1 1</td>
-<td>Skewness of A</td>
-</tr>
-<tr class="row-odd"><td><strong>SQR</strong></td>
-<td>1 1</td>
-<td>A^2</td>
-</tr>
-<tr class="row-even"><td><strong>SQRT</strong></td>
-<td>1 1</td>
-<td>sqrt (A)</td>
-</tr>
-<tr class="row-odd"><td><strong>STD</strong></td>
-<td>1 1</td>
-<td>Standard deviation of A</td>
-</tr>
-<tr class="row-even"><td><strong>STEP</strong></td>
-<td>1 1</td>
-<td>Heaviside step function H(A)</td>
-</tr>
-<tr class="row-odd"><td><strong>STEPT</strong></td>
-<td>1 1</td>
-<td>Heaviside step function H(t-A)</td>
-</tr>
-<tr class="row-even"><td><strong>SUB</strong></td>
-<td>2 1</td>
-<td>A - B</td>
-</tr>
-<tr class="row-odd"><td><strong>SUM</strong></td>
-<td>1 1</td>
-<td>Cumulative sum of A</td>
-</tr>
-<tr class="row-even"><td><strong>TAN</strong></td>
-<td>1 1</td>
-<td>tan (A) (A in radians)</td>
-</tr>
-<tr class="row-odd"><td><strong>TAND</strong></td>
-<td>1 1</td>
-<td>tan (A) (A in degrees)</td>
-</tr>
-<tr class="row-even"><td><strong>TANH</strong></td>
-<td>1 1</td>
-<td>tanh (A)</td>
-</tr>
-<tr class="row-odd"><td><strong>TAPER</strong></td>
-<td>1 1</td>
-<td>Unit weights cosine-tapered to zero within A of end margins</td>
-</tr>
-<tr class="row-even"><td><strong>TN</strong></td>
-<td>2 1</td>
-<td>Chebyshev polynomial Tn(-1<A<+1) of degree B</td>
-</tr>
-<tr class="row-odd"><td><strong>TCRIT</strong></td>
-<td>2 1</td>
-<td>Critical value for Student’s t-distribution, with alpha = A and n = B</td>
-</tr>
-<tr class="row-even"><td><strong>TDIST</strong></td>
-<td>2 1</td>
-<td>Student’s t-distribution A(t,n), with t = A, and n = B</td>
-</tr>
-<tr class="row-odd"><td><strong>UPPER</strong></td>
-<td>1 1</td>
-<td>The highest (maximum) value of A</td>
-</tr>
-<tr class="row-even"><td><strong>XOR</strong></td>
-<td>2 1</td>
-<td>B if A == NaN, else A</td>
-</tr>
-<tr class="row-odd"><td><strong>Y0</strong></td>
-<td>1 1</td>
-<td>Bessel function of A (2nd kind, order 0)</td>
-</tr>
-<tr class="row-even"><td><strong>Y1</strong></td>
-<td>1 1</td>
-<td>Bessel function of A (2nd kind, order 1)</td>
-</tr>
-<tr class="row-odd"><td><strong>YN</strong></td>
-<td>2 1</td>
-<td>Bessel function of A (2nd kind, order B)</td>
-</tr>
-<tr class="row-even"><td><strong>ZCRIT</strong></td>
-<td>1 1</td>
-<td>Critical value for the normal-distribution, with alpha = A</td>
-</tr>
-<tr class="row-odd"><td><strong>ZDIST</strong></td>
-<td>1 1</td>
-<td>Cumulative normal-distribution C(x), with x = A</td>
-</tr>
-<tr class="row-even"><td><strong>ROOTS</strong></td>
-<td>2 1</td>
-<td>Treats col A as f(t) = 0 and returns its roots</td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="symbols">
-<h2>Symbols<a class="headerlink" href="#symbols" title="Permalink to this headline">¶</a></h2>
-<p>The following symbols have special meaning:</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="32%" />
-<col width="68%" />
-</colgroup>
-<tbody valign="top">
-<tr class="row-odd"><td><strong>PI</strong></td>
-<td>3.1415926...</td>
-</tr>
-<tr class="row-even"><td><strong>E</strong></td>
-<td>2.7182818...</td>
-</tr>
-<tr class="row-odd"><td><strong>EULER</strong></td>
-<td>0.5772156...</td>
-</tr>
-<tr class="row-even"><td><strong>TMIN</strong></td>
-<td>Minimum t value</td>
-</tr>
-<tr class="row-odd"><td><strong>TMAX</strong></td>
-<td>Maximum t value</td>
-</tr>
-<tr class="row-even"><td><strong>TINC</strong></td>
-<td>t increment</td>
-</tr>
-<tr class="row-odd"><td><strong>N</strong></td>
-<td>The number of records</td>
-</tr>
-<tr class="row-even"><td><strong>T</strong></td>
-<td>Table with t-coordinates</td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="ascii-format-precision">
-<h2>Ascii Format Precision<a class="headerlink" href="#ascii-format-precision" title="Permalink to this headline">¶</a></h2>
-<p>The ASCII output formats of numerical data are controlled by parameters
-in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file. Longitude and latitude are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>, whereas other values are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>. Be aware that the format in effect
-can lead to loss of precision in the output, which can lead to various
-problems downstream. If you find the output is not written with enough
-precision, consider switching to binary output (<strong>-bo</strong> if available) or
-specify more decimals using the <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> setting.</p>
-</div>
-<div class="section" id="notes-on-operators">
-<h2>Notes On Operators<a class="headerlink" href="#notes-on-operators" title="Permalink to this headline">¶</a></h2>
-<p>1. The operators <strong>PLM</strong> and <strong>PLMg</strong> calculate the associated Legendre
-polynomial of degree L and order M in x which must satisfy -1 <= x <= +1
-and 0 <= M <= L. x, L, and M are the three arguments preceding the
-operator. <strong>PLM</strong> is not normalized and includes the Condon-Shortley
-phase (-1)^M. <strong>PLMg</strong> is normalized in the way that is most commonly
-used in geophysics. The C-S phase can be added by using -M as argument.
-<strong>PLM</strong> will overflow at higher degrees, whereas <strong>PLMg</strong> is stable
-until ultra high degrees (at least 3000).</p>
-<p>2. Files that have the same names as some operators, e.g., <strong>ADD</strong>,
-<strong>SIGN</strong>, <strong>=</strong>, etc. should be identified by prepending the current
-directory (i.e., ./).</p>
-<ol class="arabic simple" start="3">
-<li>The stack depth limit is hard-wired to 100.</li>
-</ol>
-<p>4. All functions expecting a positive radius (e.g., <strong>LOG</strong>, <strong>KEI</strong>,
-etc.) are passed the absolute value of their argument.</p>
-<ol class="arabic simple" start="5">
-<li>The <strong>DDT</strong> and <strong>D2DT2</strong> functions only work on regularly spaced data.</li>
-</ol>
-<p>6. All derivatives are based on central finite differences, with
-natural boundary conditions.</p>
-<ol class="arabic simple" start="7">
-<li><strong>ROOTS</strong> must be the last operator on the stack, only followed by <strong>=</strong>.</li>
-</ol>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc14">STORE, RECALL and CLEAR</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>You may store intermediate calculations to a named variable that you may
-recall and place on the stack at a later time. This is useful if you
-need access to a computed quantity many times in your expression as it
-will shorten the overall expression and improve readability. To save a
-result you use the special operator <strong>STO</strong>@<em>label</em>, where <em>label</em>
-is the name you choose to give the quantity. To recall the stored result
-to the stack at a later time, use [<strong>RCL</strong>]@<em>label</em>, i.e., <strong>RCL</strong>
-is optional. To clear memory you may use <strong>CLR</strong>@<em>label</em>. Note that
-<strong>STO</strong> and <strong>CLR</strong> leave the stack unchanged.</p>
-<p>8. The bitwise operators
-(<strong>BITAND</strong>, <strong>BITLEFT</strong>, <strong>BITNOT</strong>, <strong>BITOR</strong>, <strong>BITRIGHT</strong>,
-<strong>BITTEST</strong>, and <strong>BITXOR</strong>) convert a tables’s double precision values
-to unsigned 64-bit ints to perform the bitwise operations. Consequently,
-the largest whole integer value that can be stored in a double precision
-value is 2^53 or 9,007,199,254,740,992. Any higher result will be masked
-to fit in the lower 54 bits. Thus, bit operations are effectively limited
-to 54 bits. All bitwise operators return NaN if given NaN arguments or
-bit-settings <= 0.</p>
-<p>9. TAPER will interpret its argument to be a width in the same units as
-the time-axis, but if no time is provided (i.e., plain data tables) then
-the width is taken to be given in number of rows.</p>
-</div>
-<div class="section" id="macros">
-<h2>Macros<a class="headerlink" href="#macros" title="Permalink to this headline">¶</a></h2>
-<p>Users may save their favorite operator combinations as macros via the
-file <em>gmtmath.macros</em> in their current or user directory. The file may contain
-any number of macros (one per record); comment lines starting with # are
-skipped. The format for the macros is <strong>name</strong> = <strong>arg1 arg2 ... arg2</strong>
-[ : <em>comment</em>] where <strong>name</strong> is how the macro will be used. When this
-operator appears on the command line we simply replace it with the
-listed argument list. No macro may call another macro. As an example,
-the following macro expects that the time-column contains seafloor ages
-in Myr and computes the predicted half-space bathymetry:</p>
-<p><strong>DEPTH</strong> = <strong>SQRT 350 MUL 2500 ADD NEG</strong> : <em>usage: DEPTH to return
-half-space seafloor depths</em></p>
-<p>Note: Because geographic or time constants may be present in a macro, it
-is required that the optional comment flag (:) must be followed by a space.
-As another example, we show a macro <strong>GPSWEEK</strong> which determines which GPS week
-a timestamp belongs to:</p>
-<p><strong>GPSWEEK</strong> = 1980-01-06T00:00:00 SUB 86400 DIV 7 DIV FLOOR : GPS week without rollover</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To take the square root of the content of the second data column being
-piped through <strong>gmtmath</strong> by process1 and pipe it through a 3rd process, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>process1 | gmt gmtmath STDIN SQRT = | process3
-</pre></div>
-</div>
-</div></blockquote>
-<p>To take log10 of the average of 2 data files, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtmath file1.d file2.d ADD 0.5 MUL LOG10 = file3.d
-</pre></div>
-</div>
-</div></blockquote>
-<p>Given the file samples.d, which holds seafloor ages in m.y. and seafloor
-depth in m, use the relation depth(in m) = 2500 + 350 * sqrt (age) to
-print the depth anomalies:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtmath samples.d T SQRT 350 MUL 2500 ADD SUB = | lpr
-</pre></div>
-</div>
-</div></blockquote>
-<p>To take the average of columns 1 and 4-6 in the three data sets sizes.1,
-sizes.2, and sizes.3, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtmath -C1,4-6 sizes.1 sizes.2 ADD sizes.3 ADD 3 DIV = ave.d
-</pre></div>
-</div>
-</div></blockquote>
-<p>To take the 1-column data set ages.d and calculate the modal value and
-assign it to a variable, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt set mode_age = `gmt gmtmath -S -T ages.d MODE =`
-</pre></div>
-</div>
-</div></blockquote>
-<p>To evaluate the dilog(x) function for coordinates given in the file t.d:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtmath -Tt.d T DILOG = dilog.d
-</pre></div>
-</div>
-</div></blockquote>
-<p>To demonstrate the use of stored variables, consider this sum of the
-first 3 cosine harmonics where we store and repeatedly recall the
-trigonometric argument (2*pi*T/360):</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtmath -T0/360/1 2 PI MUL 360 DIV T MUL STO at kT COS @kT 2 MUL COS ADD \
- @kT 3 MUL COS ADD = harmonics.d
-</pre></div>
-</div>
-</div></blockquote>
-<p>To use gmtmath as a RPN Hewlett-Packard calculator on scalars (i.e., no
-input files) and calculate arbitrary expressions, use the <strong>-Q</strong> option.
-As an example, we will calculate the value of Kei (((1 + 1.75)/2.2) +
-cos (60)) and store the result in the shell variable z:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>set z = `gmt gmtmath -Q 1 1.75 ADD 2.2 DIV 60 COSD ADD KEI =`
-</pre></div>
-</div>
-</div></blockquote>
-<p>To use <strong>gmtmath</strong> as a general least squares equation solver, imagine
-that the current table is the augmented matrix [ A | b ] and you want
-the least squares solution x to the matrix equation A * x = b. The
-operator <strong>LSQFIT</strong> does this; it is your job to populate the matrix
-correctly first. The <strong>-A</strong> option will facilitate this. Suppose you
-have a 2-column file ty.d with <em>t</em> and <em>b(t)</em> and you would like to fit
-a the model y(t) = a + b*t + c*H(t-t0), where H is the Heaviside step
-function for a given t0 = 1.55. Then, you need a 4-column augmented
-table loaded with t in column 1 and your observed y(t) in column 3. The
-calculation becomes</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtmath -N4/1 -Aty.d -C0 1 ADD -C2 1.55 STEPT ADD -Ca LSQFIT = solution.d
-</pre></div>
-</div>
-</div></blockquote>
-<p>Note we use the <strong>-C</strong> option to select which columns we are working on,
-then make active all the columns we need (here all of them, with
-<strong>-Ca</strong>) before calling <strong>LSQFIT</strong>. The second and fourth columns (col
-numbers 1 and 3) are preloaded with t and y(t), respectively, the other
-columns are zero. If you already have a pre-calculated table with the
-augmented matrix [ A | b ] in a file (say lsqsys.d), the least squares
-solution is simply</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtmath -T lsqsys.d LSQFIT = solution.d
-</pre></div>
-</div>
-</div></blockquote>
-<p>Users must be aware that when <strong>-C</strong> controls which columns are to be
-active the control extends to placing columns from files as well.
-Constrast the different result obtained by these very similar commands:</p>
-<div class="highlight-python"><div class="highlight"><pre>echo 1 2 3 4 | gmt math STDIN -C3 1 ADD =
-1 2 3 5
-</pre></div>
-</div>
-<p>versus</p>
-<div class="highlight-python"><div class="highlight"><pre>echo 1 2 3 4 | gmt math -C3 STDIN 1 ADD =
-0 0 0 5
-</pre></div>
-</div>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>Abramowitz, M., and I. A. Stegun, 1964, <em>Handbook of Mathematical
-Functions</em>, Applied Mathematics Series, vol. 55, Dover, New York.</p>
-<p>Holmes, S. A., and W. E. Featherstone, 2002, A unified approach to the
-Clenshaw summation and the recursive computation of very high degree and
-order normalized associated Legendre functions. <em>Journal of Geodesy</em>,
-76, 279-299.</p>
-<p>Press, W. H., S. A. Teukolsky, W. T. Vetterling, and B. P. Flannery,
-1992, <em>Numerical Recipes</em>, 2nd edition, Cambridge Univ., New York.</p>
-<p>Spanier, J., and K. B. Oldman, 1987, <em>An Atlas of Functions</em>, Hemisphere
-Publishing Corp.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="grdmath.html"><em>grdmath</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">gmtmath</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#operators">Operators</a></li>
-<li><a class="reference internal" href="#symbols">Symbols</a></li>
-<li><a class="reference internal" href="#ascii-format-precision">Ascii Format Precision</a></li>
-<li><a class="reference internal" href="#notes-on-operators">Notes On Operators</a></li>
-<li><a class="reference internal" href="#id1">STORE, RECALL and CLEAR</a></li>
-<li><a class="reference internal" href="#macros">Macros</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="gmtlogo.html"
- title="previous chapter">gmtlogo</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="gmtselect.html"
- title="next chapter">gmtselect</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/gmtmath.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="gmtselect.html" title="gmtselect"
- >next</a> </li>
- <li class="right" >
- <a href="gmtlogo.html" title="gmtlogo"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" >GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gmtselect.html b/doc_release/html/gmtselect.html
deleted file mode 100644
index 5b39115..0000000
--- a/doc_release/html/gmtselect.html
+++ /dev/null
@@ -1,477 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>gmtselect — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GM" href="GM.html" />
- <link rel="next" title="gmtset" href="gmtset.html" />
- <link rel="prev" title="gmtmath" href="gmtmath.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="gmtset.html" title="gmtset"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="gmtmath.html" title="gmtmath"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" accesskey="U">GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gmtselect">
-<span id="index-0"></span><h1>gmtselect<a class="headerlink" href="#gmtselect" title="Permalink to this headline">¶</a></h1>
-<p>gmtselect - Select data table subsets based on multiple spatial criteria</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmtselect</strong> [ <em>table</em> ]
-[ <strong>-A</strong><em>min_area</em>[/<em>min_level</em>/<em>max_level</em>][<strong>+as</strong>][<strong>+r</strong>|<strong>l</strong>][<strong>p</strong><em>percent</em>] ]
-[ <strong>-C</strong><em>dist</em>[<em>unit</em>]/<em>ptfile</em> ]
-[ <strong>-D</strong><em>resolution</em>[<strong>+</strong>] ] [ <strong>-E</strong>[<strong>fn</strong>] ]
-[ <strong>-F</strong><em>polygonfile</em> ] [ <strong>-I</strong>[<strong>cflrsz</strong>] ]
-[ <strong>-J</strong><em>parameters</em> ]
-[ <strong>-L</strong>[<strong>p</strong>]<em>dist</em>[<em>unit</em>]/<em>linefile</em> ]
-[ <strong>-N</strong><em>maskvalues</em> ]
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ]
-[ <strong>-Z</strong><em>min</em>[/<em>max</em>][<strong>+c</strong><em>col</em>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-b</strong>[<strong>i</strong>|<strong>o</strong>][<em>ncol</em>][<strong>type</strong>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-o</strong><em>cols</em>[,...] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmtselect</strong> is a filter that reads (longitude, latitude) positions
-from the first 2 columns of <em>infiles</em> [or standard input] and uses a
-combination of 1-6 criteria to pass or reject the records. Records can
-be selected based on whether or not they are 1) inside a rectangular
-region (<strong>-R</strong> [and <strong>-J</strong>]), 2) within <em>dist</em> km of any point in
-<em>ptfile</em>, 3) within <em>dist</em> km of any line in <em>linefile</em>, 4) inside one
-of the polygons in the <em>polygonfile</em>, 5) inside geographical features
-(based on coastlines), or 6) has z-values within a given range. The
-sense of the tests can be reversed for each of these 6 criteria by using
-the <strong>-I</strong> option. See option <strong>-:</strong> on how to read (latitude,longitude)
-files.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<p>None</p>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>[<em>ncols</em>][<em>type</em>]) data
-table file(s) holding a number of data columns. If no tables are given
-then we read from standard input. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-A</strong><em>min_area</em>[/<em>min_level</em>/<em>max_level</em>][<strong>+as</strong>][<strong>+r</strong>|<strong>l</strong>][<strong>+p</strong><em>percent</em>]</dt>
-<dd>Features with an area smaller than <em>min_area</em> in km^2 or of
-hierarchical level that is lower than <em>min_level</em> or higher than
-<em>max_level</em> will not be plotted [Default is 0/0/4 (all features)].
-Level 2 (lakes) contains regular lakes and wide river bodies which
-we normally include as lakes; append <strong>+r</strong> to just get river-lakes
-or <strong>+l</strong> to just get regular lakes. For expert users who wish to
-print their own Antarctica coastline and islands via <cite>psxy</cite> you can
-use <strong>+as</strong> to skip all GSHHG features below 60S. Finally, append
-<strong>+p</strong><em>percent</em> to exclude polygons whose percentage area of the
-corresponding full-resolution feature is less than <em>percent</em>. See
-GSHHG INFORMATION below for more details. Ignored unless <strong>-N</strong> is set.</dd>
-<dt><strong>-C</strong><em>dist</em>[<em>unit</em>]/<em>ptfile</em></dt>
-<dd>Pass all records whose location is within <em>dist</em> of any of the
-points in the ASCII file <em>ptfile</em>. If <em>dist</em> is zero then the 3rd
-column of <em>ptfile</em> must have each point’s individual radius of
-influence. Distances are Cartesian and in user units; specify
-<strong>-fg</strong> to indicate spherical distances and append a distance unit
-(see UNITS). Alternatively, if <strong>-R</strong> and <strong>-J</strong> are used then
-geographic coordinates are projected to map coordinates (in cm,
-inch, or points, as determined by <a class="reference internal" href="gmt.conf.html#proj-length-unit"><em>PROJ_LENGTH_UNIT</em></a>) before
-Cartesian distances are compared to <em>dist</em>.</dd>
-<dt><strong>-D</strong><em>resolution</em>[<strong>+</strong>]</dt>
-<dd>Ignored unless <strong>-N</strong> is set. Selects the resolution of the
-coastline data set to use ((<strong>f</strong>)ull, (<strong>h</strong>)igh,
-(<strong>i</strong>)ntermediate, (<strong>l</strong>)ow, or (<strong>c</strong>)rude). The resolution drops
-off by ~80% between data sets. [Default is <strong>l</strong>]. Append (+) to
-automatically select a lower resolution should the one requested not
-be available [abort if not found]. Note that because the coastlines
-differ in details it is not guaranteed that a point will remain
-inside [or outside] when a different resolution is selected.</dd>
-<dt><strong>-E</strong>[<strong>fn</strong>]</dt>
-<dd>Specify how points exactly on a polygon boundary should be
-considered. By default, such points are considered to be inside the
-polygon. Append <strong>n</strong> and/or <strong>f</strong> to change this behavior for the
-<strong>-F</strong> and <strong>-N</strong> options, respectively, so that boundary points are
-considered to be outside.</dd>
-<dt><strong>-F</strong><em>polygonfile</em></dt>
-<dd>Pass all records whose location is within one of the closed polygons
-in the multiple-segment file <em>polygonfile</em>. For spherical polygons
-(lon, lat), make sure no consecutive points are separated by 180
-degrees or more in longitude. Note that <em>polygonfile</em> must be in
-ASCII regardless of whether <strong>-bi</strong> is used.</dd>
-<dt><strong>-I</strong>[<strong>cflrsz</strong>]</dt>
-<dd><p class="first">Reverses the sense of the test for each of the criteria specified:</p>
-<p><strong>c</strong> select records NOT inside any point’s circle of influence.</p>
-<p><strong>f</strong> select records NOT inside any of the polygons.</p>
-<p><strong>l</strong> select records NOT within the specified distance of any line.</p>
-<p><strong>r</strong> select records NOT inside the specified rectangular region.</p>
-<p><strong>s</strong> select records NOT considered inside as specified by <strong>-N</strong>
-(and <strong>-A</strong>, <strong>-D</strong>).</p>
-<p class="last"><strong>z</strong> select records NOT within the range specified by <strong>-Z</strong>.</p>
-</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-J</strong><em>parameters</em> <a class="reference internal" href="gmt.html#j-full"><em>(more ...)</em></a></dt>
-<dd>Select map projection.</dd>
-<dt><strong>-L</strong>[<strong>p</strong>]<em>dist</em>[<em>unit</em>]/<em>linefile</em></dt>
-<dd>Pass all records whose location is within <em>dist</em> of any of the line
-segments in the ASCII multiple-segment file <em>linefile</em>. If <em>dist</em> is
-zero then we will scan each sub-header in the <em>ptfile</em> for an
-embedded <strong>-D</strong><em>dist</em> setting that sets each line’s individual
-distance value. Distances are Cartesian and in user units; specify
-<strong>-fg</strong> to indicate spherical distances append a distance unit (see
-UNITS). Alternatively, if <strong>-R</strong> and <strong>-J</strong> are used then geographic
-coordinates are projected to map coordinates (in cm, inch, m, or
-points, as determined by <a class="reference internal" href="gmt.conf.html#proj-length-unit"><em>PROJ_LENGTH_UNIT</em></a>) before Cartesian
-distances are compared to <em>dist</em>. Use <strong>-Lp</strong> to ensure only points
-whose orthogonal projections onto the nearest line-segment fall
-within the segments endpoints [Default considers points “beyond” the
-line’s endpoints.</dd>
-<dt><strong>-N</strong><em>maskvalues</em></dt>
-<dd><p class="first">Pass all records whose location is inside specified geographical
-features. Specify if records should be skipped (s) or kept (k) using
-1 of 2 formats:</p>
-<p><strong>-N</strong><em>wet/dry</em>.</p>
-<p><strong>-N</strong><em>ocean/land/lake/island/pond</em>.</p>
-<p class="last">[Default is s/k/s/k/s (i.e., s/k), which passes all points on dry land].</p>
-</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. If no map projection is supplied we implicitly set <strong>-Jx</strong>1.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-Z</strong><em>min</em>[/<em>max</em>][<strong>+c</strong><em>col</em>]</dt>
-<dd>Pass all records whose 3rd column (<em>z</em>; <em>col</em> = 2) lies within the given range
-or is NaN (use <strong>-s</strong> to skip NaN records).
-If <em>max</em> is omitted then we test if <em>z</em> equals <em>min</em> instead.
-Input file must have at least three columns. To indicate no limit on
-min or max, specify a hyphen (-). If your 3rd column is absolute
-time then remember to supply <strong>-f</strong>2T. To specify another column, append
-<strong>+c</strong><em>col</em>, and to specify several tests just repeat the <strong>Z</strong> option as
-many times has you have columns to test. Note: when more than one <strong>Z</strong> option
-is given then the <strong>Iz</strong> option cannot be used.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 2 input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. [Default is same as input].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] <a class="reference internal" href="gmt.html#g-full"><em>(more ...)</em></a></dt>
-<dd>Determine data gaps and line breaks. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-o</strong><em>cols</em>[,...] <a class="reference internal" href="gmt.html#ocols-full"><em>(more ...)</em></a></dt>
-<dd>Select output columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-s</strong>[<em>cols</em>][<strong>a</strong>|<strong>r</strong>] <a class="reference internal" href="gmt.html#s-full"><em>(more ...)</em></a></dt>
-<dd>Set handling of NaN records.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc9">Units</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>For map distance unit, append <em>unit</em> <strong>d</strong> for arc degree, <strong>m</strong> for arc
-minute, and <strong>s</strong> for arc second, or <strong>e</strong> for meter [Default], <strong>f</strong>
-for foot, <strong>k</strong> for km, <strong>M</strong> for statute mile, <strong>n</strong> for nautical mile,
-and <strong>u</strong> for US survey foot. By default we compute such distances using
-a spherical approximation with great circles. Prepend <strong>-</strong> to a
-distance (or the unit is no distance is given) to perform “Flat Earth”
-calculations (quicker but less accurate) or prepend <strong>+</strong> to perform
-exact geodesic calculations (slower but more accurate).</p>
-</div>
-<div class="section" id="ascii-format-precision">
-<h2>Ascii Format Precision<a class="headerlink" href="#ascii-format-precision" title="Permalink to this headline">¶</a></h2>
-<p>The ASCII output formats of numerical data are controlled by parameters
-in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file. Longitude and latitude are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>, whereas other values are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>. Be aware that the format in effect
-can lead to loss of precision in the output, which can lead to various
-problems downstream. If you find the output is not written with enough
-precision, consider switching to binary output (<strong>-bo</strong> if available) or
-specify more decimals using the <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> setting.</p>
-<p>This note applies to ASCII output only in combination with binary or
-netCDF input or the <strong>-:</strong> option. See also the note below.</p>
-</div>
-<div class="section" id="note-on-processing-ascii-input-records">
-<h2>Note On Processing Ascii Input Records<a class="headerlink" href="#note-on-processing-ascii-input-records" title="Permalink to this headline">¶</a></h2>
-<p>Unless you are using the <strong>-:</strong> option, selected ASCII input records are
-copied verbatim to output. That means that options like <strong>-foT</strong> and
-settings like <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> and <a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a> will not
-have any effect on the output. On the other hand, it allows selecting
-records with diverse content, including character strings, quoted or
-not, comments, and other non-numerical content.</p>
-</div>
-<div class="section" id="note-on-distances">
-<h2>Note On Distances<a class="headerlink" href="#note-on-distances" title="Permalink to this headline">¶</a></h2>
-<p>If options <strong>-C</strong> or <strong>-L</strong> are selected then distances are Cartesian
-and in user units; use <strong>-fg</strong> to imply spherical distances in km and
-geographical (lon, lat) coordinates. Alternatively, specify <strong>-R</strong> and
-<strong>-J</strong> to measure projected Cartesian distances in map units (cm, inch,
-or points, as determined by <a class="reference internal" href="gmt.conf.html#proj-length-unit"><em>PROJ_LENGTH_UNIT</em></a>).</p>
-<p>This program has evolved over the years. Originally, the <strong>-R</strong> and
-<strong>-J</strong> were mandatory in order to handle geographic data, but now there
-is full support for spherical calculations. Thus, <strong>-J</strong> should only be
-used if you want the tests to be applied on projected data and not the
-original coordinates. If <strong>-J</strong> is used the distances given via <strong>-C</strong>
-and <strong>-L</strong> are projected distances.</p>
-</div>
-<div class="section" id="note-on-segments">
-<h2>Note On Segments<a class="headerlink" href="#note-on-segments" title="Permalink to this headline">¶</a></h2>
-<p>Segment headers in the input files are copied to output if one or more
-records from a segment passes the test. Selection is always done point
-by point, not by segment.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To extract the subset of data set that is within 300 km of any of the
-points in pts.d but more than 100 km away from the lines in lines.d, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtselect lonlatfile -fg -C300k/pts.d -L100/lines.d -Il > subset
-</pre></div>
-</div>
-</div></blockquote>
-<p>Here, you must specify <strong>-fg</strong> so the program knows you are processing
-geographical data.</p>
-<p>To keep all points in data.d within the specified region, except the
-points on land (as determined by the high-resolution coastlines), use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtselect data.d -R120/121/22/24 -Dh -Nk/s > subset
-</pre></div>
-</div>
-</div></blockquote>
-<p>To return all points in quakes.d that are inside or on the spherical
-polygon lonlatpath.d, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtselect quakes.d -Flonlatpath.d -fg > subset1
-</pre></div>
-</div>
-</div></blockquote>
-<p>To return all points in stations.d that are within 5 cm of the point in
-origin.d for a certain projection, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtselect stations.d -C5/origin.d -R20/50/-10/20 -JM20c \
---PROJ_LENGTH_UNIT=cm > subset2
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="id2">
-<h2><a class="reference external" href="#toc11">Gshhs Information</a><a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h2>
-<p>The coastline database is GSHHG (formerly GSHHS) which is compiled from two sources:
-World Vector Shorelines (WVS) and CIA World Data Bank II (WDBII). In
-particular, all level-1 polygons (ocean-land boundary) are derived from
-the more accurate WVS while all higher level polygons (level 2-4,
-representing land/lake, lake/island-in-lake, and
-island-in-lake/lake-in-island-in-lake boundaries) are taken from WDBII.
-Much processing has taken place to convert WVS and WDBII data into
-usable form for GMT: assembling closed polygons from line segments,
-checking for duplicates, and correcting for crossings between polygons.
-The area of each polygon has been determined so that the user may choose
-not to draw features smaller than a minimum area (see <strong>-A</strong>); one may
-also limit the highest hierarchical level of polygons to be included (4
-is the maximum). The 4 lower-resolution databases were derived from the
-full resolution database using the Douglas-Peucker line-simplification
-algorithm. The classification of rivers and borders follow that of the
-WDBII. See the GMT Cookbook and Technical Reference Appendix K for
-further details.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>,
-<a class="reference internal" href="gmtconvert.html"><em>gmtconvert</em></a>,
-<a class="reference internal" href="gmtsimplify.html"><em>gmtsimplify</em></a>,
-<a class="reference internal" href="gmtspatial.html"><em>gmtspatial</em></a>,
-<a class="reference internal" href="grdlandmask.html"><em>grdlandmask</em></a>,
-<a class="reference internal" href="pscoast.html"><em>pscoast</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">gmtselect</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#id1">Units</a></li>
-<li><a class="reference internal" href="#ascii-format-precision">Ascii Format Precision</a></li>
-<li><a class="reference internal" href="#note-on-processing-ascii-input-records">Note On Processing Ascii Input Records</a></li>
-<li><a class="reference internal" href="#note-on-distances">Note On Distances</a></li>
-<li><a class="reference internal" href="#note-on-segments">Note On Segments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#id2">Gshhs Information</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="gmtmath.html"
- title="previous chapter">gmtmath</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="gmtset.html"
- title="next chapter">gmtset</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/gmtselect.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="gmtset.html" title="gmtset"
- >next</a> </li>
- <li class="right" >
- <a href="gmtmath.html" title="gmtmath"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" >GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gmtset.html b/doc_release/html/gmtset.html
deleted file mode 100644
index cddc1b2..0000000
--- a/doc_release/html/gmtset.html
+++ /dev/null
@@ -1,233 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>gmtset — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GM" href="GM.html" />
- <link rel="next" title="gmt_shell_functions.sh" href="gmt_shell_functions.sh.html" />
- <link rel="prev" title="gmtselect" href="gmtselect.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="gmt_shell_functions.sh.html" title="gmt_shell_functions.sh"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="gmtselect.html" title="gmtselect"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" accesskey="U">GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gmtset">
-<span id="index-0"></span><h1>gmtset<a class="headerlink" href="#gmtset" title="Permalink to this headline">¶</a></h1>
-<p>gmtset - Change individual GMT default parameters</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmtset</strong> [ <strong>-C</strong> | <strong>-D</strong>[<strong>s</strong>|<strong>u</strong>] |
-<strong>-G</strong><em>defaultsfile</em> ] [ <strong>-</strong>[<strong>BJRXxYycp</strong>]<em>value</em> ]
-PARAMETER1 [=] <em>value1</em> PARAMETER2 [=] <em>value2</em> PARAMETER3 [=] <em>value3</em>
-...</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmtset</strong> will adjust individual GMT defaults settings in the
-current directory’s <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file. If no such file exists one will
-be created. The main purpose of <strong>gmtset</strong> is temporarily to change
-certain parameters inside a shell script, e.g., set the dots-per-inch to
-72, run the script, and reset to 1200 dpi. Optionally, you can specify
-one or more temporary changes directly on any GMT command line with
-the syntax <strong>-</strong><strong>-PARAMETER</strong>=<em>VALUE</em>; such changes are only in effect
-for that command and do not permanently change the default settings on
-disk.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt>PARAMETER <em>value</em></dt>
-<dd>Provide one or several pairs of parameter/value combinations that
-you want to modify. For a complete listing of available parameters
-and their meaning, see the <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> man page.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-C</strong></dt>
-<dd>Convert a .gmtdefaults4 file created by GMT4 to a <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file
-used by GMT5. The original file is retained.</dd>
-<dt><strong>-D</strong>[<strong>s</strong>|<strong>u</strong>]</dt>
-<dd>Modify the GMT defaults based on the system settings. Append
-<strong>u</strong> for US defaults or <strong>s</strong> for SI defaults. [<strong>-D</strong> alone gives
-the version selected at compile time]</dd>
-<dt><strong>-G</strong><em>defaultsfile</em></dt>
-<dd>Name of specific <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file to read and modify [Default looks
-first in current directory, then in your home directory, then in
-~/.gmt and finally in the system defaults].</dd>
-<dt><strong>-</strong>[<strong>BJRXxYycp</strong>]<em>value</em></dt>
-<dd>Set the expansion of any of these shorthand options.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To change annotation font to 12-point Helvetica, select grid-crosses of
-size 0.1 inch, and set annotation offset to 0.2 cm:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt set FONT_ANNOT_PRIMARY 12p,Helvetica \
- MAP_GRID_CROSS_SIZE_PRIMARY 0.1i MAP_ANNOT_OFFSET_PRIMARY 0.2c
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>,
-<a class="reference internal" href="gmtdefaults.html"><em>gmtdefaults</em></a>, <a class="reference internal" href="gmtget.html"><em>gmtget</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">gmtset</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="gmtselect.html"
- title="previous chapter">gmtselect</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="gmt_shell_functions.sh.html"
- title="next chapter">gmt_shell_functions.sh</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/gmtset.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="gmt_shell_functions.sh.html" title="gmt_shell_functions.sh"
- >next</a> </li>
- <li class="right" >
- <a href="gmtselect.html" title="gmtselect"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" >GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gmtsimplify.html b/doc_release/html/gmtsimplify.html
deleted file mode 100644
index 2b73f50..0000000
--- a/doc_release/html/gmtsimplify.html
+++ /dev/null
@@ -1,325 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>gmtsimplify — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GM" href="GM.html" />
- <link rel="next" title="gmtspatial" href="gmtspatial.html" />
- <link rel="prev" title="gmt_shell_functions.sh" href="gmt_shell_functions.sh.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="gmtspatial.html" title="gmtspatial"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="gmt_shell_functions.sh.html" title="gmt_shell_functions.sh"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" accesskey="U">GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gmtsimplify">
-<span id="index-0"></span><h1>gmtsimplify<a class="headerlink" href="#gmtsimplify" title="Permalink to this headline">¶</a></h1>
-<p>gmtsimplify - Line reduction using the Douglas-Peucker algorithm</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmtsimplify</strong> [ <em>table</em> ] <strong>-T</strong><em>tolerance</em>[<em>unit</em>]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-b</strong>[<strong>i</strong>|<strong>o</strong>][<em>ncol</em>][<strong>type</strong>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-o</strong><em>cols</em>[,...] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmtsimplify</strong> reads one or more data files and apply the Douglas-Peucker
-line simplification algorithm. The method recursively subdivides a
-polygon until a run of points can be replaced by a straight line
-segment, with no point in that run deviating from the straight line by
-more than the tolerance. Have a look at this site to get a visual
-insight on how the algorithm works
-(<a class="reference external" href="http://geometryalgorithms.com/Archive/algorithm_0205/algorithm_0205.htm">http://geometryalgorithms.com/Archive/algorithm_0205/algorithm_0205.htm</a>)</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-T</strong><em>tolerance</em>[<em>unit</em>]</dt>
-<dd>Specifies the maximum mismatch tolerance in the user units. If the
-data is not Cartesian then append the distance unit (see UNITS).</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>[<em>ncols</em>][<em>type</em>]) data
-table file(s) holding a number of data columns. If no tables are given
-then we read from standard input. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 2 input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. [Default is same as input].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] <a class="reference internal" href="gmt.html#g-full"><em>(more ...)</em></a></dt>
-<dd>Determine data gaps and line breaks. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-o</strong><em>cols</em>[,...] <a class="reference internal" href="gmt.html#ocols-full"><em>(more ...)</em></a></dt>
-<dd>Select output columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc9">Units</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>For map distance unit, append <em>unit</em> <strong>d</strong> for arc degree, <strong>m</strong> for arc
-minute, and <strong>s</strong> for arc second, or <strong>e</strong> for meter [Default], <strong>f</strong>
-for foot, <strong>k</strong> for km, <strong>M</strong> for statute mile, <strong>n</strong> for nautical mile,
-and <strong>u</strong> for US survey foot. By default we compute such distances using
-a spherical approximation with great circles. Prepend <strong>-</strong> to a
-distance (or the unit is no distance is given) to perform “Flat Earth”
-calculations (quicker but less accurate) or prepend <strong>+</strong> to perform
-exact geodesic calculations (slower but more accurate).</p>
-</div>
-<div class="section" id="ascii-format-precision">
-<h2>Ascii Format Precision<a class="headerlink" href="#ascii-format-precision" title="Permalink to this headline">¶</a></h2>
-<p>The ASCII output formats of numerical data are controlled by parameters
-in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file. Longitude and latitude are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>, whereas other values are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>. Be aware that the format in effect
-can lead to loss of precision in the output, which can lead to various
-problems downstream. If you find the output is not written with enough
-precision, consider switching to binary output (<strong>-bo</strong> if available) or
-specify more decimals using the <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> setting.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To reduce the geographic line segment.d using a tolerance of 2 km, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtsimplify segment.d -T2k > new_segment.d
-</pre></div>
-</div>
-</div></blockquote>
-<p>To reduce the Cartesian lines xylines.d using a tolerance of 0.45 and
-write the reduced lines to file new_xylines.d, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtsimplify xylines.d -T0.45 > new_xylines.d
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="notes">
-<h2>Notes<a class="headerlink" href="#notes" title="Permalink to this headline">¶</a></h2>
-<p>There is a slight difference in how gmtsimplify processes lines versus
-closed polygons. Segments that are explicitly closed will be considered
-polygons, otherwise we treat them as line segments. Hence, segments
-recognized as polygons may reduce to a 3-point polygon with no area;
-these are suppressed from the output.</p>
-</div>
-<div class="section" id="bugs">
-<h2>Bugs<a class="headerlink" href="#bugs" title="Permalink to this headline">¶</a></h2>
-<p>One known issue with the Douglas-Peucker has to do with crossovers.
-Specifically, it cannot be guaranteed that the reduced line does not
-cross itself. Depending on how many lines you are considering it is also
-possible that reduced lines may intersect other reduced lines. Finally,
-the current implementation only does Flat Earth calculations even if you
-specify spherical; <strong>gmtsimplify</strong> will issue a warning and reset the
-calculation mode to Flat Earth.</p>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>Douglas, D. H., and T. K. Peucker, Algorithms for the reduction of the
-number of points required to represent a digitized line of its
-caricature, <em>Can. Cartogr.</em>, <strong>10</strong>, 112-122, 1973.</p>
-<p>This implementation of the algorithm has been kindly provided by Dr.
-<a class="reference external" href="http://www.met.reading.ac.uk/users/users/1327/">Gary J. Robinson</a>,
-Department of Meteorology, University of Reading, Reading, UK; his
-subroutine forms the basis for this program.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>,
-<a class="reference internal" href="gmtconnect.html"><em>gmtconnect</em></a>,
-<a class="reference internal" href="gmtconvert.html"><em>gmtconvert</em></a>,
-<a class="reference internal" href="gmtselect.html"><em>gmtselect</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">gmtsimplify</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#id1">Units</a></li>
-<li><a class="reference internal" href="#ascii-format-precision">Ascii Format Precision</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#notes">Notes</a></li>
-<li><a class="reference internal" href="#bugs">Bugs</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="gmt_shell_functions.sh.html"
- title="previous chapter">gmt_shell_functions.sh</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="gmtspatial.html"
- title="next chapter">gmtspatial</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/gmtsimplify.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="gmtspatial.html" title="gmtspatial"
- >next</a> </li>
- <li class="right" >
- <a href="gmt_shell_functions.sh.html" title="gmt_shell_functions.sh"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" >GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gmtspatial.html b/doc_release/html/gmtspatial.html
deleted file mode 100644
index fae0899..0000000
--- a/doc_release/html/gmtspatial.html
+++ /dev/null
@@ -1,402 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>gmtspatial — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GM" href="GM.html" />
- <link rel="next" title="gmtswitch" href="gmtswitch.html" />
- <link rel="prev" title="gmtsimplify" href="gmtsimplify.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="gmtswitch.html" title="gmtswitch"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="gmtsimplify.html" title="gmtsimplify"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" accesskey="U">GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gmtspatial">
-<span id="index-0"></span><h1>gmtspatial<a class="headerlink" href="#gmtspatial" title="Permalink to this headline">¶</a></h1>
-<p>gmtspatial - Do geospatial operations on lines and polygons</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmtspatial</strong> [ <em>table</em> ] [ <strong>-A</strong>[<strong>a</strong><em>min_dist</em>][<em>unit</em>]] [ <strong>-C</strong> ]
-[ <strong>-D</strong>[<strong>+f</strong><em>file</em>][<strong>+a</strong><em>amax</em>][<strong>+d</strong><em>dmax</em>][<strong>+c|C</strong><em>cmax</em>][<strong>+s</strong><em>fact</em>] ]
-[ <strong>-E</strong><strong>+</strong>|<strong>-</strong> ] [ <strong>-I</strong>[<strong>e</strong>|<strong>i</strong>] ]
-[ <strong>-N</strong><em>pfile</em>[<strong>+a</strong>][<strong>+p</strong><em>start</em>][<strong>+r</strong>][<strong>+z</strong>] ]
-[ <strong>-Q</strong>[<strong>+</strong>[<em>unit</em>]] ]
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ]
-[ <strong>-S</strong><strong>i</strong>|<strong>u</strong>|<strong>s</strong>|<strong>j</strong> ]
-[ <strong>-T</strong>[<em>clippolygon</em>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-b</strong>[<strong>i</strong>|<strong>o</strong>][<em>ncol</em>][<strong>type</strong>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-o</strong><em>cols</em>[,...] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmtspatial</strong> reads one or more data files (which may be multisegment
-files) that contains closed polygons and operates of these polygons in
-the specified way. Operations include area calculation, handedness
-reversals, and polygon intersections.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<p>None.</p>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>[<em>ncols</em>][<em>type</em>]) data
-table file(s) holding a number of data columns. If no tables are given
-then we read from standard input. </dd>
-<dt><strong>-A</strong>[<strong>a</strong><em>min_dist</em>][<em>unit</em>]</dt>
-<dd>Perform spatial nearest neighbor (NN) analysis: Determine the nearest
-neighbor of each point and report the NN distances and the point IDs
-involved in each pair (IDs are the input record numbers starting at 0).
-Use <strong>-Aa</strong> to decimate a data set so that no NN distance is lower than
-the threshold <em>min_dist</em>. In this case we write out the (possibly
-averaged) coordinates and the updated NN distances and point IDs. A
-negative point number means the original point was replaced by a weighted
-average (the absolute ID value gives the ID of the first original point
-ID to be included in the average.)</dd>
-<dt><strong>-C</strong></dt>
-<dd>Clips polygons to the map region, including map boundary to the
-polygon as needed. The result is a closed polygon (see <strong>-T</strong> for
-truncation instead). Requires <strong>-R</strong>.</dd>
-<dt><strong>-D</strong>[<strong>+f</strong><em>file</em>][<strong>+a</strong><em>amax</em>][<strong>+d</strong><em>dmax</em>][<strong>+c|C</strong><em>cmax</em>][<strong>+s</strong><em>fact</em>]</dt>
-<dd>Check for duplicates among the input lines or polygons, or, if
-<em>file</em> is given via <strong>+f</strong>, check if the input features already
-exist among the features in <em>file</em>. We consider the cases of exact
-(same number and coordinates) and approximate matches (average
-distance between nearest points of two features is less than a
-threshold). We also consider that some features may have been
-reversed. Features are considered approximate matches if their
-minimum distance is less than <em>dmax</em> [0] (see UNITS) and their
-closeness (defined as the ratio between the average distance between
-the features divided by their average length) is less than <em>cmax</em>
-[0.01]. For each duplicate found, the output record begins with the
-single letter Y (exact match) or ~ (approximate match). If the two
-matching segments differ in length by more than a factor of 2 then
-we consider the duplicate to be either a subset (-) or a superset
-(+). For polygons we also consider the fractional difference in
-areas; duplicates must differ by less than <em>amax</em> [0.01]. By
-default, we compute the mean line separation. Use <strong>-+C</strong><em>cmin</em> to
-instead compute the median line separation and therefore a robust
-closeness value. Also by default we consider all distances between
-points on one line and another. Append <strong>-+p</strong> to limit the
-comparison to points that project perpendicularly to points on the
-other line (and not its extension).</dd>
-<dt><strong>-E</strong><strong>+</strong>|<strong>-</strong> ]</dt>
-<dd>Reset the handedness of all polygons to match the given <strong>+</strong>
-(counter-clockwise) or <strong>-</strong> (clockwise). Implies <strong>-Q+</strong>.</dd>
-<dt><strong>-I</strong>[<strong>e</strong>|<strong>i</strong>]</dt>
-<dd>Determine the intersection locations between all pairs of polygons.
-Append <strong>i</strong> to only compute internal (i.e., self-intersecting
-polygons) crossovers or <strong>e</strong> to only compute external (i.e.,
-between paris of polygons) crossovers [Default is both].</dd>
-<dt><strong>-N</strong><em>pfile</em>[<strong>+a</strong>][<strong>+p</strong><em>start</em>][<strong>+r</strong>][<strong>+z</strong>]</dt>
-<dd>Determine if one (or all, with <strong>+a</strong>) points of each feature in the
-input data are inside any of the polygons given in the <em>pfile</em>. If
-inside, then report which polygon it is; the polygon ID is either
-taken from the aspatial value assigned to Z, the segment header
-(first <strong>-Z</strong>, then <strong>-L</strong> are scanned), or it is assigned the
-running number that is initialized to <em>start</em> [0]. By default the
-input segment that are found to be inside a polygon are written to
-stdout with the polygon ID encoded in the segment header as
-<strong>-Z</strong><em>ID</em>. Alternatively, append <strong>+r</strong> to just report which
-polygon contains a feature or <strong>+z</strong> to have the IDs added as an
-extra data column on output. Segments that fail to be inside a
-polygon are not written out. If more than one polygon contains the
-same segment we skip the second (and further) scenario.</dd>
-<dt><strong>-Q</strong>[<strong>+</strong>[<em>unit</em>]]</dt>
-<dd>Measure the area of all polygons or length of line segments. Use
-<strong>-Q+</strong> to append the area to each polygons segment header [Default
-simply writes the area to stdout]. For polygons we also compute the
-centroid location while for line data we compute the mid-point
-(half-length) position. Append a distance unit to select the unit
-used (see UNITS). Note that the area will depend on the current
-setting of <a class="reference internal" href="gmt.conf.html#proj-ellipsoid"><em>PROJ_ELLIPSOID</em></a>; this should be a recent ellipsoid to get
-accurate results.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]</dt>
-<dd><em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> specify the region of interest,
-and you may specify them in decimal degrees or in
-[+-]dd:mm[:ss.xxx][W|E|S|N] format. Append <strong>r</strong> if lower left
-and upper right map coordinates are given instead of w/e/s/n. The
-two shorthands <strong>-Rg</strong> and <strong>-Rd</strong> stand for global domain (0/360
-and -180/+180 in longitude respectively, with -90/+90 in latitude).
-Alternatively, specify the name of an existing grid file and the
-<strong>-R</strong> settings (and grid spacing, if applicable) are copied from
-the grid. Using <strong>-R</strong><em>unit</em> expects projected (Cartesian)
-coordinates compatible with chosen <strong>-J</strong> and we inversely project
-to determine actual rectangular geographic region.
-For perspective view (<strong>-p</strong>), optionally append /<em>zmin</em>/<em>zmax</em>.
-In case of perspective view (<strong>-p</strong>), a z-range (<em>zmin</em>, <em>zmax</em>)
-can be appended to indicate the third dimension. This needs to be
-done only when using the <strong>-Jz</strong> option, not when using only the
-<strong>-p</strong> option. In the latter case a perspective view of the plane is
-plotted, with no third dimension. Clips polygons to the map
-region, including map boundary to the polygon as needed. The result
-is a closed polygon.</dd>
-<dt><strong>-S</strong><strong>i</strong>|<strong>j</strong>|<strong>s</strong>|<strong>u</strong></dt>
-<dd>Spatial processing of polygons. Choose from <strong>-Si</strong> which returns
-the intersection of polygons (closed), <strong>-Su</strong> which returns the
-union of polygons (closed), <strong>-Ss</strong> which will split polygons that
-straddle the Dateline, and <strong>-Sj</strong> which will join polygons that
-were split by the Dateline. Note: Only <strong>-Ss</strong> has been implemented.</dd>
-<dt><strong>-T</strong>[<em>clippolygon</em>]</dt>
-<dd>Truncate polygons against the specified polygon given, possibly
-resulting in open polygons. If no argument is given to <strong>-T</strong> we
-create a clipping polygon from <strong>-R</strong> which then is required. Note
-that when the <strong>-R</strong> clipping is in effect we will also look for
-polygons of length 4 or 5 that exactly match the <strong>-R</strong> clipping polygon.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 2 input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. [Default is same as input].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] <a class="reference internal" href="gmt.html#g-full"><em>(more ...)</em></a></dt>
-<dd>Determine data gaps and line breaks. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-o</strong><em>cols</em>[,...] <a class="reference internal" href="gmt.html#ocols-full"><em>(more ...)</em></a></dt>
-<dd>Select output columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc9">Units</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>For map distance unit, append <em>unit</em> <strong>d</strong> for arc degree, <strong>m</strong> for arc
-minute, and <strong>s</strong> for arc second, or <strong>e</strong> for meter [Default], <strong>f</strong>
-for foot, <strong>k</strong> for km, <strong>M</strong> for statute mile, <strong>n</strong> for nautical mile,
-and <strong>u</strong> for US survey foot. By default we compute such distances using
-a spherical approximation with great circles. Prepend <strong>-</strong> to a
-distance (or the unit is no distance is given) to perform “Flat Earth”
-calculations (quicker but less accurate) or prepend <strong>+</strong> to perform
-exact geodesic calculations (slower but more accurate).</p>
-</div>
-<div class="section" id="ascii-format-precision">
-<h2>Ascii Format Precision<a class="headerlink" href="#ascii-format-precision" title="Permalink to this headline">¶</a></h2>
-<p>The ASCII output formats of numerical data are controlled by parameters
-in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file. Longitude and latitude are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>, whereas other values are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>. Be aware that the format in effect
-can lead to loss of precision in the output, which can lead to various
-problems downstream. If you find the output is not written with enough
-precision, consider switching to binary output (<strong>-bo</strong> if available) or
-specify more decimals using the <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> setting.</p>
-</div>
-<div class="section" id="example">
-<h2>Example<a class="headerlink" href="#example" title="Permalink to this headline">¶</a></h2>
-<p>To compute the area of all geographic polygons in the multisegment file
-polygons.d, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtspatial polygons.d -Q > areas.d
-</pre></div>
-</div>
-</div></blockquote>
-<p>Same data, but now orient all polygons to go counter-clockwise and write
-their areas to the segment headers, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtspatial polygons.d -Q+ -E+ > areas.d
-</pre></div>
-</div>
-</div></blockquote>
-<p>To determine the intersections between the polygons A.d and B.d, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtspatial A.d B.d -Ce > crossovers.d
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="gmtconvert.html"><em>gmtconvert</em></a>,
-<a class="reference internal" href="gmtselect.html"><em>gmtselect</em></a>,
-<a class="reference internal" href="gmtsimplify.html"><em>gmtsimplify</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">gmtspatial</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#id1">Units</a></li>
-<li><a class="reference internal" href="#ascii-format-precision">Ascii Format Precision</a></li>
-<li><a class="reference internal" href="#example">Example</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="gmtsimplify.html"
- title="previous chapter">gmtsimplify</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="gmtswitch.html"
- title="next chapter">gmtswitch</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/gmtspatial.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="gmtswitch.html" title="gmtswitch"
- >next</a> </li>
- <li class="right" >
- <a href="gmtsimplify.html" title="gmtsimplify"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" >GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gmtswitch.html b/doc_release/html/gmtswitch.html
deleted file mode 100644
index 40aff38..0000000
--- a/doc_release/html/gmtswitch.html
+++ /dev/null
@@ -1,293 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>gmtswitch — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GM" href="GM.html" />
- <link rel="next" title="gmtvector" href="gmtvector.html" />
- <link rel="prev" title="gmtspatial" href="gmtspatial.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="gmtvector.html" title="gmtvector"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="gmtspatial.html" title="gmtspatial"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" accesskey="U">GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gmtswitch">
-<span id="index-0"></span><h1>gmtswitch<a class="headerlink" href="#gmtswitch" title="Permalink to this headline">¶</a></h1>
-<p>gmtswitch - Switching between different GMT versions</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmtswitch</strong> [ D | <em>version</em> ]</p>
-</div>
-<div class="section" id="introduction">
-<h2>Introduction<a class="headerlink" href="#introduction" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmtswitch</strong> helps you modify your environment to allow for the
-switching back and forth between several installed GMT versions, in
-particular GMT 5 and versions from the GMT 4 series. It works by
-maintaining a list of directories to GMT installations in a file in your
-home directory, then manipulates a symbolic link to point to the GMT
-directory whose executables we wish to use [The Windows version works a
-bit differently; see WINDOWS below].</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<p>None. If no arguments are given you are presented with a menu of
-installed GMT versions from 1 to <em>n</em> and you specify which one you wish
-to switch to.</p>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>D</strong></dt>
-<dd>Select the default GMT version. This is the first entry in the
-~/.gmtversions file</dd>
-<dt><em>version</em></dt>
-<dd>Search for a unique match in the ~/.gmtversions file. If one match
-is found we switch to that entry; otherwise an error is generated.
-where module is the name of a GMT program and the options are
-those that pertain to that particular program.</dd>
-</dl>
-</div>
-<div class="section" id="setup">
-<h2>Setup<a class="headerlink" href="#setup" title="Permalink to this headline">¶</a></h2>
-<p>If you have official versions installed then running gmtswitch the very
-first time will examine your hard disk starting at / and look for
-directories with GMT4 or GMT5 in the name. This will fail to find the
-subversion directories and possibly others you have placed elsewhere.
-The fastest way to get up and running is this:</p>
-<ol class="arabic">
-<li><dl class="first docutils">
-<dt>Edit/Create ~/.gmtversions and add the paths to all GMT installations</dt>
-<dd><p class="first last">you have or care to consider. Each path goes on separate lines and
-points to the top dir of each distribution, e.g.,
-/Users/pwessel/UH/RESEARCH/PROJECTS/GMTdev/GMT4.5.7</p>
-</dd>
-</dl>
-</li>
-<li><dl class="first docutils">
-<dt>In your .bashrc or .[t]csrh or wherever you are maintaining your PATH</dt>
-<dd><p class="first last">or path variable, remove any directories you have added that contain
-GMT, and add the new path $HOME/this_gmt/bin (might be $home for csh users).
-Make sure this path appears before any others that might contain a GMT
-installation, such as those used by package managers (e.g., /sw/bin for
-fink, /opt/local/bin for Macports, etc.).</p>
-</dd>
-</dl>
-</li>
-<li><p class="first">Make the new path take effect (quit/restart terminal, logout/login, etc).</p>
-</li>
-<li><dl class="first docutils">
-<dt>cd to the most recent GMT directory where a gmtswitch version lives,</dt>
-<dd><p class="first last">and run gmtswitch with no argument. Select one of the version from the
-menu.</p>
-</dd>
-</dl>
-</li>
-<li><p class="first">If in csh you may have to say rehash afterwards.</p>
-</li>
-<li><dl class="first docutils">
-<dt>Type “psxy -” and the synopsis should tell you that you got the</dt>
-<dd><p class="first last">correct version. You can now run gmtswitch from anywhere; try it out and
-make sure that you can switch between the versions.</p>
-</dd>
-</dl>
-</li>
-</ol>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To switch to GMT version 4.5.7 (assuming it was installed as such and not
-via a package manager), try</p>
-<blockquote>
-<div>gmtswitch GMT4.5.7</div></blockquote>
-<p>To switch to the default (your top choice), do</p>
-<blockquote>
-<div>gmtswitch D</div></blockquote>
-<p>Finally, to select from the menu, just run</p>
-<blockquote>
-<div>gmtswitch</div></blockquote>
-<p>and pick the one you want.</p>
-</div>
-<div class="section" id="beware">
-<h2>Beware<a class="headerlink" href="#beware" title="Permalink to this headline">¶</a></h2>
-<p>GMT remembers where it was installed the first time and uses that dir to
-find the default GMT share directory. If you move entire GMT
-installation after compilation then you may have to set GMT_SHAREDIR to
-point to the top dir in order for things to work. It is best not to move
-things after installation.</p>
-</div>
-<div class="section" id="windows">
-<h2>Windows<a class="headerlink" href="#windows" title="Permalink to this headline">¶</a></h2>
-<p>Under Windows use gmtswitch.bat which is a batch script that changes the
-Windows PATH variable so that the BIN directory of the preferred version
-always comes first. To do that the batch works in two alternative modes:</p>
-<p>1 - Permanent mode</p>
-<p>2 - Temporary mode</p>
-<p>The permanent mode makes use of the free executable program “EditPath”
-to change the user path in the registry. It’s called permanent because
-the changes remains until ... next change. See</p>
-<p><a class="reference external" href="http://www.softpedia.com/get/Tweak/Registry-Tweak/EditPath.shtml">http://www.softpedia.com/get/Tweak/Registry-Tweak/EditPath.shtml</a></p>
-<p>Of course the editpath.exe binary must be in your system’s path as well.
-WARNING: The path change will not be visible on the shell cmd where it
-was executed. For the change to be active you will need to open a new
-cmd window.</p>
-<p>The second mode is temporary because the path to the selected GMT binary
-dir is prepended to the previous path via a shell command line. This
-modification disappears when the shell cmd window where it was executes
-is deleted.</p>
-<p>It is the user responsibility to set the contents of the G32_32 to
-G5_64 below to valid paths where the binaries of the different GMT
-versions are installed Note that it is not mandatory to have all four of
-them in you computer. For the ones you do not have just let them
-pointing to nothing e.g.,</p>
-<p>set G4_64=</p>
-<p>The permanent mode is the default one (but this can be changed. See edit
-section) To run in the temporary mode just give a second argument
-(doesn’t matter what)</p>
-<p>Example usage to set a GMT5 64 bits permanent</p>
-<p>gmtswitch g5_64</p>
-<p>To temporary set a GMT4 32 bits do</p>
-<p>gmtswitch g4_32 1</p>
-<p>Run without arguments to get a “Usage” (for permanent mode)</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">gmtswitch</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#introduction">Introduction</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#setup">Setup</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#beware">Beware</a></li>
-<li><a class="reference internal" href="#windows">Windows</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="gmtspatial.html"
- title="previous chapter">gmtspatial</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="gmtvector.html"
- title="next chapter">gmtvector</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/gmtswitch.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="gmtvector.html" title="gmtvector"
- >next</a> </li>
- <li class="right" >
- <a href="gmtspatial.html" title="gmtspatial"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" >GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gmtvector.html b/doc_release/html/gmtvector.html
deleted file mode 100644
index b6741fc..0000000
--- a/doc_release/html/gmtvector.html
+++ /dev/null
@@ -1,368 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>gmtvector — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GM" href="GM.html" />
- <link rel="next" title="gmtwhich" href="gmtwhich.html" />
- <link rel="prev" title="gmtswitch" href="gmtswitch.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="gmtwhich.html" title="gmtwhich"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="gmtswitch.html" title="gmtswitch"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" accesskey="U">GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gmtvector">
-<span id="index-0"></span><h1>gmtvector<a class="headerlink" href="#gmtvector" title="Permalink to this headline">¶</a></h1>
-<p>gmtvector - Basic manipulation of Cartesian vectors</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmtvector</strong> [ <em>table</em> ] [ <strong>-A</strong><strong>m</strong>[<em>conf</em>]|<em>vector</em> ]
-[ <strong>-C</strong>[<strong>i</strong>|<strong>o</strong>] ]
-[ <strong>-E</strong> ] [ <strong>-N</strong> ] [ <strong>-S</strong><em>vector</em> ]
-[ <strong>-T</strong><strong>a</strong>|<strong>d</strong>|<strong>D</strong>|<strong>p</strong><em>az</em>|<strong>r</strong>[<em>arg</em>|<strong>R</strong>|<strong>s</strong>|<strong>x</strong>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-b</strong>[<strong>i</strong>|<strong>o</strong>][<em>ncol</em>][<strong>type</strong>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-o</strong><em>cols</em>[,...] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmtvector</strong> reads either (x, y), (x, y, z), (r, theta) or (lon, lat)
-[or (lat,lon); see <strong>-:</strong>] coordinates from the first 2-3 columns on
-standard input [or <em>infiles</em>]. If <strong>-fg</strong> is selected and only two items
-are read (i.e., lon, lat) then these coordinates are converted to
-Cartesian three-vectors on the unit sphere. Otherwise we expect (r,
-theta) unless <strong>-Ci</strong> is in effect. If no file is found we expect a
-single vector to be given as argument to <strong>-A</strong>; this argument will also
-be interpreted as an x/y[/z], lon/lat, or r/theta vector. The input
-vectors (or the one provided via <strong>-A</strong>) are denoted the prime
-vector(s). Several standard vector operations (angle between vectors,
-cross products, vector sums, and vector rotations) can be selected; most
-require a single second vector, provided via <strong>-S</strong>. The output vectors
-will be converted back to (lon, lat) or (r, theta) unless <strong>-Co</strong> is set
-which requests (x, y[, z]) Cartesian coordinates.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<p>None.</p>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII [or binary, see <strong>-bi</strong>]
-file containing lon,lat [lat,lon if <strong>-:</strong>] values in the first 2
-columns (if <strong>-fg</strong> is given) or (r, theta), or perhaps (x, y[, z])
-if <strong>-Ci</strong> is given). If no file is specified, <strong>gmtvector</strong>, will
-read from standard input.</dd>
-<dt><strong>-A</strong><strong>m</strong>[<em>conf</em>]|<em>vector</em></dt>
-<dd>Specify a single, primary vector instead of reading <em>infiles</em>; see
-<em>infiles</em> for possible vector formats. Alternatively, append <strong>m</strong>
-to read <em>infiles</em> and set the single, primary vector to be the mean
-resultant vector first. We also compute the confidence ellipse for
-the mean vector (azimuth of major axis, major axis, and minor axis;
-for geographic data the axes will be reported in km). You may
-optionally append the confidence level in percent [95]. These three
-parameters are reported in the final three output columns.</dd>
-<dt><strong>-C</strong>[<strong>i</strong>|<strong>o</strong>]</dt>
-<dd>Select Cartesian coordinates on input and output. Append <strong>i</strong> for
-input only or <strong>o</strong> for output only; otherwise both input and output
-will be assumed to be Cartesian [Default is polar r/theta for 2-D
-data and geographic lon/lat for 3-D].</dd>
-<dt><strong>-E</strong></dt>
-<dd>Convert input geographic coordinates from geodetic to geocentric and
-output geographic coordinates from geocentric to geodetic. Ignored
-unless <strong>-fg</strong> is in effect, and is bypassed if <strong>-C</strong> is selected.</dd>
-<dt><strong>-N</strong></dt>
-<dd>Normalize the resultant vectors prior to reporting the output [No
-normalization]. This only has an effect if <strong>-Co</strong> is selected.</dd>
-<dt><strong>-S</strong>[<em>vector</em>]</dt>
-<dd>Specify a single, secondary vector in the same format as the first
-vector. Required by operations in <strong>-T</strong> that need two vectors
-(average, bisector, dot product, cross product, and sum).</dd>
-<dt><strong>-T</strong><strong>a</strong>|<strong>d</strong>|<strong>D</strong>|<strong>p</strong><em>az</em>|<strong>s</strong>|<strong>r</strong>[<em>arg</em>|<strong>R</strong>|<strong>x</strong>]</dt>
-<dd>Specify the vector transformation of interest. Append <strong>a</strong> for
-average, <strong>b</strong> for the pole of the two points bisector, <strong>d</strong> for
-dot product (use <strong>D</strong> to get angle in degrees between the two
-vectors), <strong>p</strong><em>az</em> for the pole to the great circle specified by
-input vector and the circle’s <em>az</em> (no second vector used), <strong>s</strong> for vector sum,
-<strong>r</strong><em>par</em> for vector rotation (here, <em>par</em> is a single
-angle for 2-D Cartesian data and <em>lon/lat/angle</em> for a 3-D rotation
-pole and angle), <strong>R</strong> will instead rotate the fixed secondary vector
-by the rotations implied by the input records, and <strong>x</strong> for cross-product.
-If <strong>-T</strong> is not given then no transformation takes place; the
-output is determined by other options such as <strong>-A</strong>, <strong>-C</strong>,
-<strong>-E</strong>, and <strong>-N</strong>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 2 or 3 input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] <a class="reference internal" href="gmt.html#g-full"><em>(more ...)</em></a></dt>
-<dd>Determine data gaps and line breaks. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-o</strong><em>cols</em>[,...] <a class="reference internal" href="gmt.html#ocols-full"><em>(more ...)</em></a></dt>
-<dd>Select output columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="ascii-format-precision">
-<h2>Ascii Format Precision<a class="headerlink" href="#ascii-format-precision" title="Permalink to this headline">¶</a></h2>
-<p>The ASCII output formats of numerical data are controlled by parameters
-in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file. Longitude and latitude are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>, whereas other values are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>. Be aware that the format in effect
-can lead to loss of precision in the output, which can lead to various
-problems downstream. If you find the output is not written with enough
-precision, consider switching to binary output (<strong>-bo</strong> if available) or
-specify more decimals using the <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> setting.</p>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc7">Examples</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>Suppose you have a file with lon, lat called points.txt. You want to
-compute the spherical angle between each of these points and the
-location 133/34. Try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtvector points.txt -S133/34 -TD -fg > angles.txt
-</pre></div>
-</div>
-</div></blockquote>
-<p>To rotate the same points 35 degrees around a pole at 133/34, and output
-Cartesian 3-D vectors, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtvector points.txt -Tr133/34/35 -Co -fg > reconstructed.txt
-</pre></div>
-</div>
-</div></blockquote>
-<p>To rotate the point 65/33 by all rotations given in file rots.txt, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtvector rots.txt -TR -S64/33 -fg > reconstructed.txt
-</pre></div>
-</div>
-</div></blockquote>
-<p>To compute the cross-product between the two Cartesian vectors 0.5/1/2
-and 1/0/0.4, and normalizing the result, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtvector -A0.5/1/2 -Tx -S1/0/0.4 -N -C > cross.txt
-</pre></div>
-</div>
-</div></blockquote>
-<p>To rotate the 2-D vector, given in polar form as r = 2 and theta = 35,
-by an angle of 120, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtvector -A2/35 -Tr120 > rotated.txt
-</pre></div>
-</div>
-</div></blockquote>
-<p>To find the mid-point along the great circle connecting the points 123/35 and -155/-30, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtvector -A123/35 -S-155/-30 -Ta -fg > midpoint.txt
-</pre></div>
-</div>
-</div></blockquote>
-<p>To find the mean location of the geographical points listed in
-points.txt, with its 99% confidence ellipse, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtvector points.txt -Am99 -fg > centroid.txt
-</pre></div>
-</div>
-</div></blockquote>
-<p>To find the pole corresponding to the great circle that goes through
-the point -30/60 at an azimuth of 105 degrees, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtvector -A-30/60 -Tp105 -fg > pole.txt
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="rotations">
-<h2>Rotations<a class="headerlink" href="#rotations" title="Permalink to this headline">¶</a></h2>
-<p>For more advanced 3-D rotations as used in plate tectonic
-reconstructions, see the GMT “spotter” supplement.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="project.html"><em>project</em></a>, <a class="reference internal" href="mapproject.html"><em>mapproject</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">gmtvector</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#ascii-format-precision">Ascii Format Precision</a></li>
-<li><a class="reference internal" href="#id1">Examples</a></li>
-<li><a class="reference internal" href="#rotations">Rotations</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="gmtswitch.html"
- title="previous chapter">gmtswitch</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="gmtwhich.html"
- title="next chapter">gmtwhich</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/gmtvector.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="gmtwhich.html" title="gmtwhich"
- >next</a> </li>
- <li class="right" >
- <a href="gmtswitch.html" title="gmtswitch"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" >GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/gmtwhich.html b/doc_release/html/gmtwhich.html
deleted file mode 100644
index 1f80cb9..0000000
--- a/doc_release/html/gmtwhich.html
+++ /dev/null
@@ -1,215 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>gmtwhich — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GM" href="GM.html" />
- <link rel="next" title="GR" href="GR.html" />
- <link rel="prev" title="gmtvector" href="gmtvector.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="GR.html" title="GR"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="gmtvector.html" title="gmtvector"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" accesskey="U">GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gmtwhich">
-<span id="index-0"></span><h1>gmtwhich<a class="headerlink" href="#gmtwhich" title="Permalink to this headline">¶</a></h1>
-<p>gmtwhich - Find full path to specified files</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmtwhich</strong> <em>files</em> [ <strong>-A</strong> ] [ <strong>-C</strong> ] [ <strong>-D</strong> ] [ <strong>-V</strong>[<em>level</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmtwhich</strong> reports the full paths to the files given on the command
-line. We look for the file in (1) the current directory,
-(2) in $GMT_USERDIR (if defined), (3) in $GMT_DATADIR (if defined). If
-found we print the full path name to the file, just the directory (see
-<strong>-D</strong>), or a confirmation (see <strong>-C</strong>). The $GMT_USERDIR and
-$GMT_DATADIR environment variables can be colon-separated list of
-directories, and we search recursively down any directory that ends with
-/ (i.e., /export/data is a single directory whereas /export/data/ will
-be searched recursively.)</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>files</em></dt>
-<dd>One or more file names of any data type (grids, tables, etc.).</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong></dt>
-<dd>Only consider files that the user has permission to read [Default consider
-all files found].</dd>
-<dt><strong>-C</strong></dt>
-<dd>Instead of reporting the paths, print the confirmation Y if the file
-is found and N if it is not.</dd>
-<dt><strong>-D</strong></dt>
-<dd>Instead of reporting the paths, print the directories that contains
-the files.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">gmtwhich</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="gmtvector.html"
- title="previous chapter">gmtvector</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="GR.html"
- title="next chapter">GR</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/gmtwhich.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="GR.html" title="GR"
- >next</a> </li>
- <li class="right" >
- <a href="gmtvector.html" title="gmtvector"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GM.html" >GM</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/grd2cpt.html b/doc_release/html/grd2cpt.html
deleted file mode 100644
index 254387c..0000000
--- a/doc_release/html/grd2cpt.html
+++ /dev/null
@@ -1,360 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grd2cpt — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GR" href="GR.html" />
- <link rel="next" title="grd2rgb" href="grd2rgb.html" />
- <link rel="prev" title="greenspline" href="greenspline.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grd2rgb.html" title="grd2rgb"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="greenspline.html" title="greenspline"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" accesskey="U">GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grd2cpt">
-<span id="index-0"></span><h1>grd2cpt<a class="headerlink" href="#grd2cpt" title="Permalink to this headline">¶</a></h1>
-<p>grd2cpt - Make linear or histogram-equalized color palette table from grid</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grd2cpt</strong> <em>grid</em> [ <strong>-A</strong>[<strong>+</strong>]<em>transparency</em> ]
-[ <strong>-C</strong><em>cptmaster</em> ] [ <strong>-D</strong>[<strong>i</strong>|<strong>o</strong>] ] [ <strong>-E</strong><em>nlevels</em> ]
-[ <strong>-F</strong>[<strong>R</strong>|<strong>r</strong>|<strong>h</strong>|<strong>c</strong> ] [ <strong>-G</strong><em>zlo</em>/<em>zhi</em> ] [ <strong>-I</strong> ]
-[ <strong>-L</strong><em>minlimit/maxlimit</em> ] [ <strong>-M</strong> ] [ <strong>-N</strong> ]
-[ <strong>-Q</strong>[<strong>i</strong>|<strong>o</strong>] ]
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ]
-[ <strong>-S</strong><em>zstart/zstop/zinc</em> ]
-[ <strong>-T</strong><strong>-</strong>|<strong>+</strong>|<strong>_</strong>|<strong>=</strong> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W</strong> ]
-[ <strong>-Z</strong> ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grd2cpt</strong> reads one or more grid files and writes a color palette
-(cpt) file to standard output. The cpt file is based on an existing
-master cpt file of your choice, and the mapping from data value to
-colors is through the data’s cumulative distribution function (CDF), so
-that the colors are histogram equalized. Thus if the grid(s) and the
-resulting cpt file are used in <strong>grdimage</strong> with a linear projection,
-the colors will be uniformly distributed in area on the plot. Let z be
-the data values in the grid. Define CDF(Z) = (# of z < Z) / (# of z in
-grid). (NaNs are ignored). These z-values are then normalized to the
-master cpt file and colors are sampled at the desired intervals.</p>
-<p>The color palette includes three additional colors beyond the range of
-z-values. These are the background color (B) assigned to values lower
-than the lowest <em>z</em>-value, the foreground color (F) assigned to values
-higher than the highest <em>z</em>-value, and the NaN color (N) painted
-wherever values are undefined. For color tables beyond the
-standard GMT offerings, visit cpt-city:
-<a class="reference external" href="http://soliton.vm.bytemark.co.uk/pub/cpt-city/">http://soliton.vm.bytemark.co.uk/pub/cpt-city/</a>.</p>
-<p>If the master cpt file includes B, F, and N entries, these will be
-copied into the new master file. If not, the parameters
-<strong>COLOR_BACKGROUND</strong>, <strong>COLOR_FOREGROUND</strong>, and <strong>COLOR_NAN</strong> from
-the <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file or the command line will be used. This default
-behavior can be overruled using the options <strong>-D</strong>, <strong>-M</strong> or <strong>-N</strong>.</p>
-<p>The color model (RGB, HSV or CMYK) of the palette created by <strong>makecpt</strong>
-will be the same as specified in the header of the master cpt file. When
-there is no <strong>COLOR_MODEL</strong> entry in the master cpt file, the
-<strong>COLOR_MODEL</strong> specified in the <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file or on the command
-line will be used.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>grid</em></dt>
-<dd>Names of one or more grid files used to derive the color palette
-table. All grids need to have the same size and dimensions. (See
-GRID FILE FORMATS below).</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong>[<strong>+</strong>]<em>transparency</em></dt>
-<dd>Sets a constant level of transparency (0-100) for all color slices.
-Prepend <strong>+</strong> to also affect the fore-, back-, and nan-colors
-[Default is no transparency, i.e., 0 (opaque)].</dd>
-<dt><strong>-C</strong><em>cptmaster</em></dt>
-<dd>Selects the master color table to use in the interpolation. Choose
-among the built-in tables (type <strong>grd2cpt</strong> to see the list) or give
-the name of an existing cpt file [Default gives a rainbow cpt file].</dd>
-<dt><strong>-D</strong>[<strong>i</strong>|<strong>o</strong>]</dt>
-<dd>Select the back- and foreground colors to match the colors for
-lowest and highest <em>z</em>-values in the output cpt file [Default uses
-the colors specified in the master file, or those defined by the
-parameters <strong>COLOR_BACKGROUND</strong>, <strong>COLOR_FOREGROUND</strong>, and
-<strong>COLOR_NAN</strong>]. Append <strong>i</strong> to match the colors for the lowest and
-highest values in the input (instead of the output) cpt file.</dd>
-<dt><strong>-E</strong><em>nlevels</em></dt>
-<dd>Create a linear color table by dividing the grid z-range into
-<em>nlevels</em> equidistant slices.</dd>
-<dt><strong>-F</strong>[<strong>R</strong>|<strong>r</strong>|<strong>h</strong>|<strong>c</strong>]</dt>
-<dd>Force output cpt file to written with r/g/b codes, gray-scale values
-or color name (<strong>R</strong>, default) or r/g/b codes only (<strong>r</strong>), or h-s-v
-codes (<strong>h</strong>), or c/m/y/k codes (<strong>c</strong>).</dd>
-<dt><strong>-G</strong><em>zlo</em>/<em>zhi</em></dt>
-<dd>Truncate the incoming CPT so that the lowest and highest z-levels
-are to <em>zlo</em> and <em>zhi</em>. If one of these equal NaN then
-we leave that end of the CPT alone. The truncation takes place
-before any resampling.</dd>
-<dt><strong>-I</strong></dt>
-<dd>Reverses the sense of color progression in the master cpt file. Also
-exchanges the foreground and background colors, including those
-specified by the parameters <strong>COLOR_BACKGROUND</strong> and
-<strong>COLOR_FOREGROUND</strong>.</dd>
-<dt><strong>-L</strong><em>minlimit/maxlimit</em></dt>
-<dd>Limit range of cpt file to <em>minlimit/maxlimit</em>, and don’t count data
-outside this range when estimating CDF(Z). [Default uses min and max of data.]</dd>
-<dt><strong>-M</strong></dt>
-<dd>Overrule background, foreground, and NaN colors specified in the
-master cpt file with the values of the parameters
-<strong>COLOR_BACKGROUND</strong>, <strong>COLOR_FOREGROUND</strong>, and <strong>COLOR_NAN</strong>
-specified in the <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file or on the command line. When
-combined with <strong>-D</strong>, only <strong>COLOR_NAN</strong> is considered.</dd>
-<dt><strong>-N</strong></dt>
-<dd>Do not write out the background, foreground, and NaN-color fields
-[Default will write them].</dd>
-<dt><strong>-Q</strong>[<strong>i</strong>|<strong>o</strong>]</dt>
-<dd>Selects a logarithmic interpolation scheme [Default is linear].
-<strong>-Qi</strong> expects input z-values to be log10(z), assigns colors, and
-writes out z [Default]. <strong>-Qo</strong> takes log10(z) first, assigns
-colors, and writes out z.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-<dt><strong>-S</strong><em>zstart/zstop/zinc</em> or <strong>-S</strong><em>n</em></dt>
-<dd>Set steps in cpt file. Calculate entries in cpt file from <em>zstart</em>
-to <em>zstop</em> in steps of (<em>zinc</em>). Default chooses arbitrary values by
-a crazy scheme based on equidistant values for a Gaussian CDF.
-Use <strong>-S</strong><em>n</em> to select <em>n</em> points from such a
-cumulative normal distribution [11].</dd>
-<dt><strong>-T</strong><strong>-</strong>|<strong>+</strong>|<strong>_</strong>|<strong>=</strong></dt>
-<dd>Force the color table to be symmetric about zero (from -R to +R).
-Append flag to set the range R: <strong>-</strong> for R =|zmin|, <strong>+</strong> for R =
-|zmax|, <strong>_</strong> for R = min(|zmin|, |zmax|), or <strong>=</strong> for R =
-max(|zmin|, |zmax|).</dd>
-<dt><strong>-V</strong></dt>
-<dd>Verbose operation. This will write CDF(Z) estimates to stderr.
-[Default is silent.]</dd>
-<dt><strong>-W</strong></dt>
-<dd>Do not interpolate the input color table but pick the output colors
-starting at the beginning of the map. This is particularly useful in
-combination with a categorical color table. Cannot be used in
-combination with <strong>-Z</strong>.</dd>
-<dt><strong>-Z</strong></dt>
-<dd>Will create a continuous color palette. [Default is discontinuous,
-i.e., constant color intervals]</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="grid-file-formats">
-<h2>Grid File Formats<a class="headerlink" href="#grid-file-formats" title="Permalink to this headline">¶</a></h2>
-<p>By default GMT writes out grid as single precision floats in a
-COARDS-complaint netCDF file format. However, GMT is able to produce
-grid files in many other commonly used grid file formats and also
-facilitates so called “packing” of grids, writing out floating point
-data as 1- or 2-byte integers. To specify the precision, scale and
-offset, the user should add the suffix
-<strong>=</strong><em>id</em>[<strong>/</strong><em>scale</em><strong>/</strong><em>offset</em>[<strong>/</strong><em>nan</em>]], where
-<em>id</em> is a two-letter identifier of the grid type and precision, and
-<em>scale</em> and <em>offset</em> are optional scale factor and offset to be applied
-to all grid values, and <em>nan</em> is the value used to indicate missing
-data. When reading grids, the format is generally automatically
-recognized. If not, the same suffix can be added to input grid file
-names. See <a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section
-<a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a>
-of the GMT Technical Reference and Cookbook for more information.</p>
-<p>When reading a netCDF file that contains multiple grids, GMT will
-read, by default, the first 2-dimensional grid that can find in that
-file. To coax GMT into reading another multi-dimensional variable in
-the grid file, append <strong>?</strong><em>varname</em> to the file name, where <em>varname</em>
-is the name of the variable. Note that you may need to escape the
-special meaning of <strong>?</strong> in your shell program by putting a backslash in
-front of it, or by placing the filename and suffix between quotes or
-double quotes. The <strong>?</strong><em>varname</em> suffix can also be used for output
-grids to specify a variable name different from the default: “z”. See
-<a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section <a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a> of the GMT
-Technical Reference and Cookbook for more information, particularly on
-how to read splices of 3-, 4-, or 5-dimensional grids.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>Sometimes you don’t want to make a cpt file (yet) but would find it
-helpful to know that 90% of your data lie between z1 and z2, something
-you cannot learn from <a class="reference internal" href="grdinfo.html"><em>grdinfo</em></a>. So you can do this to see some points
-on the CDF(Z) curve (use <strong>-V</strong> option to see more):</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grd2cpt mydata.nc -V > /dev/null
-</pre></div>
-</div>
-</div></blockquote>
-<p>To make a cpt file with entries from 0 to 200 in steps of 20, and ignore
-data below zero in computing CDF(Z), and use the built-in master cpt
-file relief, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grd2cpt mydata.nc -Crelief -L0/10000 -S0/200/20 > mydata.cpt
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>,
-<a class="reference internal" href="grdhisteq.html"><em>grdhisteq</em></a>, <a class="reference internal" href="grdinfo.html"><em>grdinfo</em></a>, <a class="reference internal" href="makecpt.html"><em>makecpt</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grd2cpt</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#grid-file-formats">Grid File Formats</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="greenspline.html"
- title="previous chapter">greenspline</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grd2rgb.html"
- title="next chapter">grd2rgb</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/grd2cpt.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grd2rgb.html" title="grd2rgb"
- >next</a> </li>
- <li class="right" >
- <a href="greenspline.html" title="greenspline"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" >GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/grd2rgb.html b/doc_release/html/grd2rgb.html
deleted file mode 100644
index 868bf20..0000000
--- a/doc_release/html/grd2rgb.html
+++ /dev/null
@@ -1,278 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grd2rgb — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GR" href="GR.html" />
- <link rel="next" title="grd2xyz" href="grd2xyz.html" />
- <link rel="prev" title="grd2cpt" href="grd2cpt.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grd2xyz.html" title="grd2xyz"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grd2cpt.html" title="grd2cpt"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" accesskey="U">GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grd2rgb">
-<span id="index-0"></span><h1>grd2rgb<a class="headerlink" href="#grd2rgb" title="Permalink to this headline">¶</a></h1>
-<p>grd2rgb - Write r/g/b grid files from a grid file, a raw RGB file, or SUN rasterfile</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grd2rgb</strong> <em>infile</em> <strong>-G</strong><em>template</em> [ <strong>-C</strong><em>cptfile</em> ] [
-<strong>-I</strong><em>xinc</em>[<strong>m</strong>|<strong>s</strong>][/<em>yinc</em>[<strong>m</strong>|<strong>s</strong>]] ]
-[ <strong>-L</strong><em>layer</em> ]
-<strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>]
-<strong>-V</strong>[<em>level</em>]
-[ <strong>-W</strong><em>width</em>/<em>height</em>[/<em>n_bytes</em>] ]
-[ <strong>-r</strong> ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grd2rgb</strong> reads one of three types of input files: (1) A Sun 8-, 24-,
-or 32-bit raster file; we the write out the red, green, and blue
-components (0-255 range) to separate grid files. Since the raster file
-header is limited you may use the <strong>-R</strong>, <strong>-I</strong>, <strong>-r</strong> options to set
-a complete header record [Default is simply based on the number of rows
-and columns]. (2) A binary 2-D grid file; we then convert the z-values
-to red, green, blue via the provided cpt file. Optionally, only write
-out one of the r, g, b, layers. (3) A RGB or RGBA raw raster file. Since
-raw rasterfiles have no header, you have to give the image dimensions
-via the <strong>-W</strong> option.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>infile</em></dt>
-<dd>The (1) Sun raster file, (2) 2-D binary grid file, or (3) raw raster file to be converted.</dd>
-<dt><strong>-G</strong><em>template</em></dt>
-<dd>Provide an output name template for the three output grids. The
-template should be a regular grid file name except it must contain
-the string %c which on output will be replaced by r, g, or b.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-C</strong><em>cptfile</em></dt>
-<dd>name of the color palette table (for 2-D binary input grid only).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]</dt>
-<dd><em>x_inc</em> [and optionally <em>y_inc</em>] is the grid spacing. Optionally,
-append a suffix modifier. <strong>Geographical (degrees) coordinates</strong>: Append
-<strong>m</strong> to indicate arc minutes or <strong>s</strong> to indicate arc seconds. If one
-of the units <strong>e</strong>, <strong>f</strong>, <strong>k</strong>, <strong>M</strong>, <strong>n</strong> or <strong>u</strong> is appended
-instead, the increment is assumed to be given in meter, foot, km, Mile,
-nautical mile or US survey foot, respectively, and will be converted to
-the equivalent degrees longitude at the middle latitude of the region
-(the conversion depends on <a class="reference internal" href="gmt.conf.html#projection-parameters"><em>PROJ_ELLIPSOID</em></a>). If /<em>y_inc</em> is given
-but set to 0 it will be reset equal to <em>x_inc</em>; otherwise it will be
-converted to degrees latitude. <strong>All coordinates</strong>: If <strong>=</strong> is appended
-then the corresponding max <em>x</em> (<em>east</em>) or <em>y</em> (<em>north</em>) may be slightly
-adjusted to fit exactly the given increment [by default the increment
-may be adjusted slightly to fit the given domain]. Finally, instead of
-giving an increment you may specify the <em>number of nodes</em> desired by
-appending <strong>+</strong> to the supplied integer argument; the increment is then
-recalculated from the number of nodes and the domain. The resulting
-increment value depends on whether you have selected a
-gridline-registered or pixel-registered grid; see <a class="reference internal" href="GMT_Docs.html#app-file-formats"><em>B. GMT File Formats</em></a> for
-details. Note: if <strong>-R</strong><em>grdfile</em> is used then the grid spacing has
-already been initialized; use <strong>-I</strong> to override the values.</dd>
-<dt><strong>-L</strong><em>layer</em></dt>
-<dd>Output only the specified layer (r, g, or b). [Default outputs all 3 layers].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong><em>width</em>/<em>height</em>[/<em>n_bytes</em>]</dt>
-<dd>Sets the size of the raw raster file. By default an RGB file (which
-has 3 bytes/pixel) is assumed. For RGBA files use <em>n_bytes</em> = 4.
-Use <strong>-W</strong> for guessing the image size of a RGB raw file, and
-<strong>-W</strong><em>=/=/4</em> if the raw image is of the RGBA type. Notice that
-this might be a bit slow because the guessing algorithm makes uses
-of FFTs.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-r</strong> <a class="reference internal" href="gmt.html#nodereg-full"><em>(more ...)</em></a></dt>
-<dd>Set pixel node registration [gridline]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To use the color palette topo.cpt to create r, g, b component grids from
-hawaii_grv.nc file, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grd2rgb hawaii_grv.nc -Ctopo.cpt -Ghawaii_grv_%c.nc
-</pre></div>
-</div>
-</div></blockquote>
-<p>To output the red component from the Sun raster radiation.ras file, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grd2rgb radiation.ras -Lr -Gcomp_%c.nc
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>,
-<a class="reference internal" href="grdedit.html"><em>grdedit</em></a>, <a class="reference internal" href="grdimage.html"><em>grdimage</em></a>,
-<a class="reference internal" href="grdmath.html"><em>grdmath</em></a> , <a class="reference internal" href="grdview.html"><em>grdview</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grd2rgb</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grd2cpt.html"
- title="previous chapter">grd2cpt</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grd2xyz.html"
- title="next chapter">grd2xyz</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/grd2rgb.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grd2xyz.html" title="grd2xyz"
- >next</a> </li>
- <li class="right" >
- <a href="grd2cpt.html" title="grd2cpt"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" >GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/grd2xyz.html b/doc_release/html/grd2xyz.html
deleted file mode 100644
index 3a39ee7..0000000
--- a/doc_release/html/grd2xyz.html
+++ /dev/null
@@ -1,358 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grd2xyz — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GR" href="GR.html" />
- <link rel="next" title="grdblend" href="grdblend.html" />
- <link rel="prev" title="grd2rgb" href="grd2rgb.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grdblend.html" title="grdblend"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grd2rgb.html" title="grd2rgb"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" accesskey="U">GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grd2xyz">
-<span id="index-0"></span><h1>grd2xyz<a class="headerlink" href="#grd2xyz" title="Permalink to this headline">¶</a></h1>
-<p>grd2xyz - Convert grid file to data table</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grd2xyz</strong> <em>grid</em> [ <strong>-C</strong>[<strong>f</strong>|<strong>i</strong>] ] [ <strong>-N</strong>[<strong>i</strong>]<em>nodata</em> ]
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W</strong>[<em>weight</em>] ] [ <strong>-Z</strong>[<em>flags</em>] ]
-[ <strong>-bo</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-ho</strong>[<em>n</em>] ]
-[ <strong>-o</strong><em>cols</em>[,...] ]
-[ <strong>-s</strong>[<em>cols</em>][<strong>a</strong>|<strong>r</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grd2xyz</strong> reads one or more binary 2-D grid files and writes out
-xyz-triplets in ASCII [or binary] format to standard output. Modify the
-precision of the ASCII output format by editing the
-<a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> parameter in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file or use
-<strong>-</strong><strong>-D_FORMAT</strong>=<em>format</em> on the command line, or choose binary
-output using single or double precision storage. As an option you may
-output z-values without the (x,y) coordinates; see <strong>-Z</strong> below.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>grid</em></dt>
-<dd>Names of 2-D binary grid files to be converted. (See GRID FILE
-FORMATS below.)</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-C</strong>[<strong>f</strong>|<strong>i</strong>]</dt>
-<dd>Replace the x- and y-coordinates on output with the corresponding
-column and row numbers. These start at 0 (C-style counting); append
-<strong>f</strong> to start at 1 (Fortran-style counting). Alternatively, append
-<strong>i</strong> to write just the two columns <em>index</em> and <em>z</em>, where <em>index</em>
-is the 1-D indexing that GMT uses when referring to grid nodes.</dd>
-<dt><strong>-N</strong>[<strong>i</strong>]<em>nodata</em></dt>
-<dd>Output this z-value where the latter equals NaN [Default writes NaN].
-Alternatively prepend <strong>i</strong> to do the inverse. That is, to replace the
-<em>nodata</em> values in grid with NaN. Useful to use with the <strong>-s</strong> option.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. Using the <strong>-R</strong> option
-will select a subsection of the grid. If this subsection exceeds the
-boundaries of the grid, only the common region will be output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong>[<em>weight</em>]</dt>
-<dd>Write out x,y,z,w, where w is the supplied <em>weight</em> (or 1 if not
-supplied) [Default writes x,y,z only].</dd>
-<dt><strong>-Z</strong>[<em>flags</em>]</dt>
-<dd><p class="first">Write a 1-column ASCII [or binary] table. Output will be organized
-according to the specified ordering convention contained in <em>flags</em>.
-If data should be written by rows, make <em>flags</em> start with
-<strong>T</strong> (op) if first row is y = ymax or
-<strong>B</strong> (ottom) if first row is y = ymin. Then,
-append <strong>L</strong> or <strong>R</strong> to indicate that first element should start at
-left or right end of row. Likewise for column formats: start with
-<strong>L</strong> or <strong>R</strong> to position first column, and then append <strong>T</strong> or
-<strong>B</strong> to position first element in a row. For gridline registered
-grids: If grid is periodic in x but the outcoming data should not
-contain the (redundant) column at x = xmax, append <strong>x</strong>. For grid
-periodic in y, skip writing the redundant row at y = ymax by
-appending <strong>y</strong>. If the byte-order needs to be swapped, append
-<strong>w</strong>. Select one of several data types (all binary except <strong>a</strong>):</p>
-<ul class="simple">
-<li><strong>a</strong> ASCII representation of a single item per record</li>
-<li><strong>c</strong> int8_t, signed 1-byte character</li>
-<li><strong>u</strong> uint8_t, unsigned 1-byte character</li>
-<li><strong>h</strong> int16_t, short 2-byte integer</li>
-<li><strong>H</strong> uint16_t, unsigned short 2-byte integer</li>
-<li><strong>i</strong> int32_t, 4-byte integer</li>
-<li><strong>I</strong> uint32_t, unsigned 4-byte integer</li>
-<li><strong>l</strong> int64_t, long (8-byte) integer</li>
-<li><strong>L</strong> uint64_t, unsigned long (8-byte) integer</li>
-<li><strong>f</strong> 4-byte floating point single precision</li>
-<li><strong>d</strong> 8-byte floating point double precision</li>
-</ul>
-<p class="last">Default format is scanline orientation of ASCII numbers: <strong>-ZTLa</strong>.
-Note that <strong>-Z</strong> only applies to 1-column output.</p>
-</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. [Default is 3]. This option
-only applies to xyz output; see <strong>-Z</strong> for z table output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. See also <strong>TIME
-COORDINATES</strong> below. <strong>-h</strong> Output 1 header record based on
-information in the first grid file header. Ignored if binary output
-is selected. [Default is no header].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-o</strong><em>cols</em>[,...] <a class="reference internal" href="gmt.html#ocols-full"><em>(more ...)</em></a></dt>
-<dd>Select output columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-s</strong>[<em>cols</em>][<strong>a</strong>|<strong>r</strong>] <a class="reference internal" href="gmt.html#s-full"><em>(more ...)</em></a></dt>
-<dd>Set handling of NaN records.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="ascii-format-precision">
-<h2>Ascii Format Precision<a class="headerlink" href="#ascii-format-precision" title="Permalink to this headline">¶</a></h2>
-<p>The ASCII output formats of numerical data are controlled by parameters
-in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file. Longitude and latitude are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>, whereas other values are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>. Be aware that the format in effect
-can lead to loss of precision in the output, which can lead to various
-problems downstream. If you find the output is not written with enough
-precision, consider switching to binary output (<strong>-bo</strong> if available) or
-specify more decimals using the <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> setting.</p>
-</div>
-<div class="section" id="grid-file-formats">
-<h2>Grid File Formats<a class="headerlink" href="#grid-file-formats" title="Permalink to this headline">¶</a></h2>
-<p>By default GMT writes out grid as single precision floats in a
-COARDS-complaint netCDF file format. However, GMT is able to produce
-grid files in many other commonly used grid file formats and also
-facilitates so called “packing” of grids, writing out floating point
-data as 1- or 2-byte integers. To specify the precision, scale and
-offset, the user should add the suffix
-<strong>=</strong><em>id</em>[<strong>/</strong><em>scale</em><strong>/</strong><em>offset</em>[<strong>/</strong><em>nan</em>]], where
-<em>id</em> is a two-letter identifier of the grid type and precision, and
-<em>scale</em> and <em>offset</em> are optional scale factor and offset to be applied
-to all grid values, and <em>nan</em> is the value used to indicate missing
-data. When reading grids, the format is generally automatically
-recognized. If not, the same suffix can be added to input grid file
-names. See <a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section
-<a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a>
-of the GMT Technical Reference and Cookbook for more information.</p>
-<p>When reading a netCDF file that contains multiple grids, GMT will
-read, by default, the first 2-dimensional grid that can find in that
-file. To coax GMT into reading another multi-dimensional variable in
-the grid file, append <strong>?</strong><em>varname</em> to the file name, where <em>varname</em>
-is the name of the variable. Note that you may need to escape the
-special meaning of <strong>?</strong> in your shell program by putting a backslash in
-front of it, or by placing the filename and suffix between quotes or
-double quotes. The <strong>?</strong><em>varname</em> suffix can also be used for output
-grids to specify a variable name different from the default: “z”. See
-<a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section <a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a> of the GMT
-Technical Reference and Cookbook for more information, particularly on
-how to read splices of 3-, 4-, or 5-dimensional grids.</p>
-</div>
-<div class="section" id="time-coordinates">
-<h2>Time Coordinates<a class="headerlink" href="#time-coordinates" title="Permalink to this headline">¶</a></h2>
-<p>Time coordinates in netCDF grids, be it the x, y, or z coordinate, will
-be recognized as such. The variable’s <strong>unit</strong> attribute is parsed to
-determine the unit and epoch of the time coordinate in the grid. Values
-are then converted to the internal time system specified by
-<a class="reference internal" href="gmt.conf.html#time-unit"><em>TIME_UNIT</em></a> and <a class="reference internal" href="gmt.conf.html#time-epoch"><em>TIME_EPOCH</em></a> in the
-<a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file or on the
-command line. The default output is relative time in that time system,
-or absolute time when using the option <strong>-f0T</strong>, <strong>-f1T</strong>, or <strong>-f2T</strong>
-for x, y, or z coordinate, respectively.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To edit individual values in the 5’ by 5’ hawaii_grv.nc file, dump the .nc to ASCII:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grd2xyz hawaii_grv.nc > hawaii_grv.xyz
-</pre></div>
-</div>
-</div></blockquote>
-<p>To write a single precision binary file without the x,y positions from
-the file raw_data.nc file, using scanline orientation, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grd2xyz raw_data.nc -ZTLf > hawaii_grv.b
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>, <a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="grdedit.html"><em>grdedit</em></a>, <a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a>,
-<a class="reference internal" href="xyz2grd.html"><em>xyz2grd</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grd2xyz</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#ascii-format-precision">Ascii Format Precision</a></li>
-<li><a class="reference internal" href="#grid-file-formats">Grid File Formats</a></li>
-<li><a class="reference internal" href="#time-coordinates">Time Coordinates</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grd2rgb.html"
- title="previous chapter">grd2rgb</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grdblend.html"
- title="next chapter">grdblend</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/grd2xyz.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grdblend.html" title="grdblend"
- >next</a> </li>
- <li class="right" >
- <a href="grd2rgb.html" title="grd2rgb"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" >GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/grdblend.html b/doc_release/html/grdblend.html
deleted file mode 100644
index 25ae0db..0000000
--- a/doc_release/html/grdblend.html
+++ /dev/null
@@ -1,379 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grdblend — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GR" href="GR.html" />
- <link rel="next" title="grdclip" href="grdclip.html" />
- <link rel="prev" title="grd2xyz" href="grd2xyz.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grdclip.html" title="grdclip"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grd2xyz.html" title="grd2xyz"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" accesskey="U">GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grdblend">
-<span id="index-0"></span><h1>grdblend<a class="headerlink" href="#grdblend" title="Permalink to this headline">¶</a></h1>
-<p>grdblend - Blend several partially over-lapping grids into one large grid</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdblend</strong> [ <em>blendfile</em> | <em>grid1</em> <em>grid2</em> ... ] <strong>-G</strong><em>outgrid</em>
-[ <strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]] ]
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ]
-[ <strong>-C</strong><strong>f</strong>|<strong>l</strong>|<strong>o</strong>|<strong>u</strong> ] [ <strong>-N</strong><em>nodata</em> ]
-[ <strong>-Q</strong> ] [ <strong>-Z</strong><em>scale</em> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W</strong> ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-r</strong> ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdblend</strong> reads a listing of grid files and blend parameters and
-creates a binary grid file by blending the other grids using
-cosine-taper weights. <strong>grdblend</strong> will report if some of the nodes are
-not filled in with data. Such unconstrained nodes are set to a value
-specified by the user [Default is NaN]. Nodes with more than one value
-will be set to the weighted average value. Any input grid that does not
-share the final output grid’s node registration and grid spacing will
-automatically be resampled via calls to grdsample. Note: Due to the
-row-by-row i/o nature of operations in grdblend we only support the
-netCDF and native binary grid formats for both input and output.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-G</strong><em>outgrid</em></dt>
-<dd><em>outgrid</em> is the name of the binary output grid file. (See GRID FILE
-FORMATS below). Only netCDF and native binary grid formats are can
-be written directly. Other output format choices will be handled by
-reformatting the output once blending is complete.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]</dt>
-<dd><em>x_inc</em> [and optionally <em>y_inc</em>] is the grid spacing. Optionally,
-append a suffix modifier. <strong>Geographical (degrees) coordinates</strong>: Append
-<strong>m</strong> to indicate arc minutes or <strong>s</strong> to indicate arc seconds. If one
-of the units <strong>e</strong>, <strong>f</strong>, <strong>k</strong>, <strong>M</strong>, <strong>n</strong> or <strong>u</strong> is appended
-instead, the increment is assumed to be given in meter, foot, km, Mile,
-nautical mile or US survey foot, respectively, and will be converted to
-the equivalent degrees longitude at the middle latitude of the region
-(the conversion depends on <a class="reference internal" href="gmt.conf.html#projection-parameters"><em>PROJ_ELLIPSOID</em></a>). If /<em>y_inc</em> is given
-but set to 0 it will be reset equal to <em>x_inc</em>; otherwise it will be
-converted to degrees latitude. <strong>All coordinates</strong>: If <strong>=</strong> is appended
-then the corresponding max <em>x</em> (<em>east</em>) or <em>y</em> (<em>north</em>) may be slightly
-adjusted to fit exactly the given increment [by default the increment
-may be adjusted slightly to fit the given domain]. Finally, instead of
-giving an increment you may specify the <em>number of nodes</em> desired by
-appending <strong>+</strong> to the supplied integer argument; the increment is then
-recalculated from the number of nodes and the domain. The resulting
-increment value depends on whether you have selected a
-gridline-registered or pixel-registered grid; see <a class="reference internal" href="GMT_Docs.html#app-file-formats"><em>B. GMT File Formats</em></a> for
-details. Note: if <strong>-R</strong><em>grdfile</em> is used then the grid spacing has
-already been initialized; use <strong>-I</strong> to override the values.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>blendfile</em></dt>
-<dd>ASCII file with one record per grid file to include in the blend.
-Each record may contain up to three items, separated by spaces or tabs:
-the gridfile name (required), the <strong>-R</strong>-setting for the interior region
-(optional), and the relative weight <em>wr</em> (optional). In the combined weighting scheme, this
-grid will be given zero weight outside its domain, weight = <em>wr</em>
-inside the interior region, and a 2-D cosine-tapered weight between
-those end-members in the boundary strip. However, if a negative <em>wr</em>
-is given then the sense of tapering is inverted (i.e., zero weight
-inside its domain). If the inner region should instead exactly match
-the grid region then specify a - instead of the <strong>-R</strong>-setting, or
-leave it off entirely. Likewise, if a weight <em>wr</em> is not specified
-we default to a weight of 1. If the ASCII <em>blendfile</em> file is not
-given <strong>grdblend</strong> will read standard input. Alternatively, if you
-have more than one grid file to blend and you wish (a) all input
-grids to have the same weight (1) and (b) all grids
-should use their actual region as the interior region, then you may simply
-list all the grids on the command line instead of providing a
-<em>blendfile</em>. You must specify at least 2 input grids for this
-mechanism to work. Any grid that is not co-registered with the
-desired output layout implied by <strong>-R</strong>, <strong>-I</strong> (and <strong>-r</strong>) will
-first be resampled via <strong>grdsample</strong>. Also, grids that are not in
-netCDF or native binary format will first be reformatted via
-<strong>grdreformat</strong>.</dd>
-<dt><strong>-C</strong></dt>
-<dd>Clobber mode: Instead of blending, simply pick the value of one of
-the grids that covers a node. Select from the following modes: <strong>f</strong>
-for the first grid to visit a node; <strong>o</strong> for the last grid to visit
-a node; <strong>l</strong> for the grid with the lowest value, and <strong>u</strong> for the
-grid with the uppermost value. For modes <strong>f</strong> and <strong>o</strong> the
-ordering of grids in the <em>blendfile</em> will dictate which grid
-contributes to the final result. Weights and cosine tapering are not
-considered when clobber mode is active.</dd>
-<dt><strong>-N</strong><em>nodata</em></dt>
-<dd>No data. Set nodes with no input grid to this value [Default is NaN].</dd>
-<dt><strong>-Q</strong></dt>
-<dd>Create a header-less grid file suitable for use with <strong>grdraster</strong>.
-Requires that the output grid file is a native format (i.e., not netCDF).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong></dt>
-<dd>Do not blend, just output the weights used for each node. This
-option is valid when only one input grid is provided [Default makes the blend].</dd>
-<dt><strong>-Z</strong><em>scale</em></dt>
-<dd>Scale output values by <em>scale</em> before writing to file. [1].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-r</strong> <a class="reference internal" href="gmt.html#nodereg-full"><em>(more ...)</em></a></dt>
-<dd>Set pixel node registration [gridline]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="grid-file-formats">
-<h2>Grid File Formats<a class="headerlink" href="#grid-file-formats" title="Permalink to this headline">¶</a></h2>
-<p>By default GMT writes out grid as single precision floats in a
-COARDS-complaint netCDF file format. However, GMT is able to produce
-grid files in many other commonly used grid file formats and also
-facilitates so called “packing” of grids, writing out floating point
-data as 1- or 2-byte integers. To specify the precision, scale and
-offset, the user should add the suffix
-<strong>=</strong><em>id</em>[<strong>/</strong><em>scale</em><strong>/</strong><em>offset</em>[<strong>/</strong><em>nan</em>]], where
-<em>id</em> is a two-letter identifier of the grid type and precision, and
-<em>scale</em> and <em>offset</em> are optional scale factor and offset to be applied
-to all grid values, and <em>nan</em> is the value used to indicate missing
-data. See <a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section
-<a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a>
-of the GMT Technical Reference and Cookbook for more information.</p>
-<p>When writing a netCDF file, the grid is stored by default with the
-variable name “z”. To specify another variable name <em>varname</em>, append
-<strong>?</strong><em>varname</em> to the file name. Note that you may need to escape the
-special meaning of <strong>?</strong> in your shell program by putting a backslash in
-front of it, or by placing the filename and suffix between quotes or
-double quotes.</p>
-</div>
-<div class="section" id="geographical-and-time-coordinates">
-<h2>Geographical And Time Coordinates<a class="headerlink" href="#geographical-and-time-coordinates" title="Permalink to this headline">¶</a></h2>
-<p>When the output grid type is netCDF, the coordinates will be labeled
-“longitude”, “latitude”, or “time” based on the attributes of the input
-data or grid (if any) or on the <strong>-f</strong> or <strong>-R</strong> options. For example,
-both <strong>-f0x</strong> <strong>-f1t</strong> and <strong>-R</strong>90w/90e/0t/3t will result in a
-longitude/time grid. When the x, y, or z coordinate is time, it will be
-stored in the grid as relative time since epoch as specified by
-<a class="reference internal" href="gmt.conf.html#time-unit"><em>TIME_UNIT</em></a> and <a class="reference internal" href="gmt.conf.html#time-epoch"><em>TIME_EPOCH</em></a> in the
-<a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file or on the
-command line. In addition, the <strong>unit</strong> attribute of the time variable
-will indicate both this unit and epoch.</p>
-</div>
-<div class="section" id="tapering">
-<h2>Tapering<a class="headerlink" href="#tapering" title="Permalink to this headline">¶</a></h2>
-<p>While the weights computed are tapered from 1 to 0, we are computing weighted
-averages, so if there is only a single grid given then the weighted output
-will be identical to the input. If you are looking for a way to taper your
-data grid, see grdmath’s TAPER operator.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To create a grid file from the four grid files piece_?.nc, giving them each the different
-weights, make the blendfile like this</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre><span class="n">piece_1</span><span class="o">.</span><span class="n">nc</span> <span class="o">-</span><span class="n">R</span><span class="o"><</span><span class="n">subregion_1</span><span class="o">></span> <span class="mi">1</span>
-<span class="n">piece_2</span><span class="o">.</span><span class="n">nc</span> <span class="o">-</span><span class="n">R</span><span class="o"><</span><span class="n">subregion_2</span><span class="o">></span> <span class="mf">1.5</span>
-<span class="n">piece_3</span><span class="o">.</span><span class="n">nc</span> <span class="o">-</span><span class="n">R</span><span class="o"><</span><span class="n">subregion_3</span><span class="o">></span> <span class="mf">0.9</span>
-<span class="n">piece_4</span><span class="o">.</span><span class="n">nc</span> <span class="o">-</span><span class="n">R</span><span class="o"><</span><span class="n">subregion_4</span><span class="o">></span> <span class="mi">1</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>Then run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdblend blend.job -Gblend.nc -R<full_region> -I<dx/dy> -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>To blend all the grids called MB_*.nc given them all equal weight, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdblend MB_*.nc -Gblend.nc -R<full_region> -I<dx/dy> -V
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="warning-on-large-file-sets">
-<h2>Warning on large file sets<a class="headerlink" href="#warning-on-large-file-sets" title="Permalink to this headline">¶</a></h2>
-<p>While grdblend can process any number of files, it works by keeping those
-files open that are being blended, and close files as soon as they are finished.
-Depending on your session, many files may remain open at the same time.
-Some operating systems set fairly modest
-default limits on how many concurrent files can be open, e.g., 256. If you
-run into this problem then you can change this limit; see your operating system
-documentation for how to change system limits.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="grd2xyz.html"><em>grd2xyz</em></a>,
-<a class="reference internal" href="grdedit.html"><em>grdedit</em></a> <a class="reference internal" href="grdraster.html"><em>grdraster</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grdblend</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#grid-file-formats">Grid File Formats</a></li>
-<li><a class="reference internal" href="#geographical-and-time-coordinates">Geographical And Time Coordinates</a></li>
-<li><a class="reference internal" href="#tapering">Tapering</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#warning-on-large-file-sets">Warning on large file sets</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grd2xyz.html"
- title="previous chapter">grd2xyz</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grdclip.html"
- title="next chapter">grdclip</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/grdblend.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grdclip.html" title="grdclip"
- >next</a> </li>
- <li class="right" >
- <a href="grd2xyz.html" title="grd2xyz"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" >GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/grdclip.html b/doc_release/html/grdclip.html
deleted file mode 100644
index c853d80..0000000
--- a/doc_release/html/grdclip.html
+++ /dev/null
@@ -1,277 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grdclip — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GR" href="GR.html" />
- <link rel="next" title="grdcontour" href="grdcontour.html" />
- <link rel="prev" title="grdblend" href="grdblend.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grdcontour.html" title="grdcontour"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grdblend.html" title="grdblend"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" accesskey="U">GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grdclip">
-<span id="index-0"></span><h1>grdclip<a class="headerlink" href="#grdclip" title="Permalink to this headline">¶</a></h1>
-<p>grdclip - Clip the range of grids</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdclip</strong> <em>ingrid</em> <strong>-G</strong><em>outgrid</em>
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ]
-[ <strong>-Sa</strong><em>high/above</em> ]
-[ <strong>-Sb</strong><em>low/below</em> ] [ <strong>-Si</strong><em>low/high/between</em> ] [ <strong>-Sr</strong><em>old/new</em> ]
-[ <strong>-V</strong>[<em>level</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdclip</strong> will set values < <em>low</em> to <em>below</em> and/or values > <em>high</em> to
-<em>above</em>. You can also specify one or more intervals where all values should be
-set to IT(between), or replace individual values. Such operations are useful
-when you want all of a continent or an ocean to fall
-into one color or gray shade in image processing, when clipping of the
-range of data values is required, or for reclassification of data values.
-<em>above</em>, <em>below</em>, <em>between</em>, <em>old</em> and <em>new</em> can be any number or even NaN
-(Not a Number). You must choose at least one of the <strong>-S</strong> options. Use
-<strong>-R</strong> to only extract a subset of the <em>ingrid</em> file.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>ingrid</em></dt>
-<dd>The input 2-D binary grid file.</dd>
-<dt><strong>-G</strong><em>outgrid</em></dt>
-<dd><em>outgrid</em> is the modified output grid file.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. Using the <strong>-R</strong> option
-will select a subsection of <em>ingrid</em> grid. If this subsection
-exceeds the boundaries of the grid, only the common region will be extracted.</dd>
-<dt><strong>-Sa</strong><em>high/above</em></dt>
-<dd>Set all data[i] > <em>high</em> to <em>above</em>.</dd>
-<dt><strong>-Sb</strong><em>low/below</em></dt>
-<dd>Set all data[i] < <em>low</em> to <em>below</em>.</dd>
-<dt><strong>-Si</strong><em>low/high/between</em></dt>
-<dd>Set all data[i] >= <em>low</em> and <= <em>high</em> to <em>between</em>.
-Repeat the option for as many intervals as are needed.</dd>
-<dt><strong>-Sr</strong><em>old/new</em></dt>
-<dd>Set all data[i] == <em>old</em> to <em>new</em>. This is mostly useful when
-your data are known to be integer values. Repeat the option
-for as many replacements as are needed.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="grid-file-formats">
-<h2>Grid File Formats<a class="headerlink" href="#grid-file-formats" title="Permalink to this headline">¶</a></h2>
-<p>By default GMT writes out grid as single precision floats in a
-COARDS-complaint netCDF file format. However, GMT is able to produce
-grid files in many other commonly used grid file formats and also
-facilitates so called “packing” of grids, writing out floating point
-data as 1- or 2-byte integers. To specify the precision, scale and
-offset, the user should add the suffix
-<strong>=</strong><em>id</em>[<strong>/</strong><em>scale</em><strong>/</strong><em>offset</em>[<strong>/</strong><em>nan</em>]], where
-<em>id</em> is a two-letter identifier of the grid type and precision, and
-<em>scale</em> and <em>offset</em> are optional scale factor and offset to be applied
-to all grid values, and <em>nan</em> is the value used to indicate missing
-data. When reading grids, the format is generally automatically
-recognized. If not, the same suffix can be added to input grid file
-names. See <a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section
-<a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a>
-of the GMT Technical Reference and Cookbook for more information.</p>
-<p>When reading a netCDF file that contains multiple grids, GMT will
-read, by default, the first 2-dimensional grid that can find in that
-file. To coax GMT into reading another multi-dimensional variable in
-the grid file, append <strong>?</strong><em>varname</em> to the file name, where <em>varname</em>
-is the name of the variable. Note that you may need to escape the
-special meaning of <strong>?</strong> in your shell program by putting a backslash in
-front of it, or by placing the filename and suffix between quotes or
-double quotes. The <strong>?</strong><em>varname</em> suffix can also be used for output
-grids to specify a variable name different from the default: “z”. See
-<a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section <a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a> of the GMT
-Technical Reference and Cookbook for more information, particularly on
-how to read splices of 3-, 4-, or 5-dimensional grids.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To set all values > 70 to NaN and all values < 0 to 0 in file data.nc:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdclip data.nc -Gnew_data.nc -Sa70/NaN -Sb0/0 -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>To reclassify all values in the 25-30 range to 99, those in 35-39 to 55,
-exchange 17 for 11 and all values < 10 to 0 in file classes.nc, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdclip classes.nc -Gnew_classes.nc -Si25/30/99 -Si35/39/55 -Sr17/11 -Sb10/0 -V
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="grdlandmask.html"><em>grdlandmask</em></a>,
-<a class="reference internal" href="grdmask.html"><em>grdmask</em></a>, <a class="reference internal" href="grdmath.html"><em>grdmath</em></a>,
-<a class="reference internal" href="grd2xyz.html"><em>grd2xyz</em></a>, <a class="reference internal" href="xyz2grd.html"><em>xyz2grd</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grdclip</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#grid-file-formats">Grid File Formats</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grdblend.html"
- title="previous chapter">grdblend</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grdcontour.html"
- title="next chapter">grdcontour</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/grdclip.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grdcontour.html" title="grdcontour"
- >next</a> </li>
- <li class="right" >
- <a href="grdblend.html" title="grdblend"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" >GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/grdcontour.html b/doc_release/html/grdcontour.html
deleted file mode 100644
index 49739a8..0000000
--- a/doc_release/html/grdcontour.html
+++ /dev/null
@@ -1,566 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grdcontour — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GR" href="GR.html" />
- <link rel="next" title="grdcut" href="grdcut.html" />
- <link rel="prev" title="grdclip" href="grdclip.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grdcut.html" title="grdcut"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grdclip.html" title="grdclip"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" accesskey="U">GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grdcontour">
-<span id="index-0"></span><h1>grdcontour<a class="headerlink" href="#grdcontour" title="Permalink to this headline">¶</a></h1>
-<p>grdcontour - Make contour map using a grid</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdcontour</strong> <em>grid</em> <strong>-C</strong>[+]<em>cont_int</em>|<em>cpt</em>
-<strong>-J</strong><em>parameters</em> [ <strong>-A</strong>[<strong>-</strong>|[+]<em>annot_int</em>][<em>labelinfo</em>] ]
-[ <strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> ]
-[ <strong>-D</strong><em><template></em> ]
-[ <strong>-F</strong>[<strong>l</strong>|<strong>r</strong>] ]
-[ <strong>-G</strong>[<strong>d</strong>|<strong>f</strong>|<strong>n</strong>|<strong>l</strong>|<strong>L</strong>|<strong>x</strong>|<strong>X</strong>]<em>params</em> ]
-[ <strong>-Jz</strong>|<strong>Z</strong><em>parameters</em> ] [ <strong>-K</strong> ] [ <strong>-L</strong><em>low/high</em> ]
-[ <strong>-O</strong> ] [ <strong>-P</strong> ] [ <strong>-Q</strong><em>cut</em> ]
-[ <strong>-R</strong><em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>] ]
-[ <strong>-S</strong><em>smoothfactor</em> ]
-[ <strong>-T</strong>[<strong>+|-</strong>][<em>gap/length</em>][<strong>:</strong>[<em>labels</em>]] ]
-[ <strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W</strong>[<strong>+</strong>][<em>type</em>]<em>pen</em> ]
-[ <strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Z</strong>[<em>factor</em>[/<em>shift</em>]][<strong>p</strong>] ]
-[ <strong>-bo</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-c</strong><em>copies</em> ]
-[ <strong>-ho</strong>[<em>n</em>] ]
-[ <strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] ]
-[ <strong>-t</strong>[<em>transp</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdcontour</strong> reads a 2-D grid file and produces a contour map by
-tracing each contour through the grid. PostScript code is generated
-and sent to standard output. Various options that affect the plotting
-are available. Alternatively, the x/y/z positions of the contour lines
-may be saved to one or more output files (or stdout) and no plot is produced.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>grid</em></dt>
-<dd>2-D gridded data set to be contoured. (See GRID FILE FORMATS below).</dd>
-<dt><strong>-C</strong>[+]<em>cont_int</em></dt>
-<dd><p class="first">The contours to be drawn may be specified in one of three possible ways:</p>
-<ol class="arabic simple">
-<li>If <em>cont_int</em> has the suffix ”.cpt” and can be opened as a
-file, it is assumed to be a color palette table. The color
-boundaries are then used as contour levels. If the cpt-file has
-annotation flags in the last column then those contours will be
-annotated. By default all contours are labeled; use <strong>-A-</strong> to
-disable all annotations.</li>
-<li>If <em>cont_int</em> is a file but not a cpt-file, it is expected to
-contain contour levels in column 1 and a
-C(ontour) OR A(nnotate) in
-col 2. The levels marked C (or c) are contoured, the levels marked A
-(or a) are contoured and annotated. Optionally, a third column may
-be present and contain the fixed annotation angle for this contour
-level.</li>
-<li>If no file is found, then <em>cont_int</em> is interpreted as a
-constant contour interval. However, if prepended with the + sign the
-<em>cont_int</em> is taken as meaning draw that single contour. The <strong>-A</strong>
-option offers the same possibility so they may be used together to
-plot only one annotated and one non-annotated contour.
-If <strong>-A</strong> is set and <strong>-C</strong> is not, then the contour interval is set
-equal to the specified annotation interval.</li>
-</ol>
-<p class="last">If a file is given and <strong>-T</strong> is set, then only contours marked with
-upper case C or A will have tickmarks. In all cases the contour
-values have the same units as the grid.</p>
-</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-J</strong><em>parameters</em> <a class="reference internal" href="gmt.html#j-full"><em>(more ...)</em></a></dt>
-<dd>Select map projection.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong>[<strong>-</strong>|[+]<em>annot_int</em>][<em>labelinfo</em>]</dt>
-<dd><em>annot_int</em> is annotation interval in data units; it is ignored if
-contour levels are given in a file. [Default is no annotations]. Append
-<strong>-</strong> to disable all annotations implied by <strong>-C</strong>. Alternatively prepend
-+ to the annotation interval to plot that as a single contour. The optional
-<em>labelinfo</em> controls the specifics of the label formatting and consists
-of a concatenated string made up of any of the following control arguments:</dd>
-</dl>
-<blockquote>
-<div><dl class="docutils">
-<dt><strong>+a</strong><em>angle</em></dt>
-<dd>For annotations at a fixed angle, <strong>+an</strong> for contour-normal, or
-<strong>+ap</strong> for contour-parallel [Default]. For <strong>+ap</strong>, you may optionally
-append <strong>u</strong> for up-hill and <strong>d</strong> for down-hill cartographic annotations.</dd>
-<dt><strong>+c</strong><em>dx</em>[/<em>dy</em>]</dt>
-<dd>Sets the clearance between label and optional text box. Append
-<strong>c</strong>|<strong>i</strong>|<strong>p</strong> to specify the unit or % to indicate a
-percentage of the label font size [15%].</dd>
-<dt><strong>+d</strong></dt>
-<dd>Turns on debug which will draw helper points and lines to illustrate
-the workings of the contour line setup.</dd>
-<dt><strong>+e</strong></dt>
-<dd>Delay the plotting of the text. This is used to build a clip path
-based on the text, then lay down other overlays while that clip path
-is in effect, then turning of clipping with psclip <strong>-Cs</strong> which
-finally plots the original text.</dd>
-<dt><strong>+f</strong><em>font</em></dt>
-<dd>Sets the desired font [Default <strong>FONT_ANNOT_PRIMARY</strong> with its
-size changed to 9p].</dd>
-<dt><strong>+g</strong>[<em>color</em>]</dt>
-<dd>Selects opaque text boxes [Default is transparent]; optionally
-specify the color [Default is <strong>PS_PAGE_COLOR</strong>].</dd>
-<dt><strong>+j</strong><em>just</em></dt>
-<dd>Sets label justification [Default is MC].</dd>
-<dt><strong>+n</strong><em>dx</em>[/<em>dy</em>]</dt>
-<dd>Nudges the placement of labels by the specified amount (append
-<strong>c</strong>|<strong>i</strong>|<strong>p</strong> to specify the units). Increments
-are considered in the coordinate system defined by the
-orientation of the contour; use <strong>+N</strong> to force increments in the
-plot x/y coordinates system [no nudging]. Not allowed with <strong>+v</strong>.</dd>
-<dt><strong>+o</strong></dt>
-<dd>Selects rounded rectangular text box [Default is rectangular].
-Not applicable for curved text (<strong>+v</strong>) and only makes sense for
-opaque text boxes.</dd>
-<dt><strong>+p</strong>[<em>pen</em>]</dt>
-<dd>Draws the outline of text boxes [Default is no outline];
-optionally specify pen for outline [Default is width = 0.25p,
-color = black, style = solid].</dd>
-<dt><strong>+r</strong><em>min_rad</em></dt>
-<dd>Will not place labels where the contours’s radius of curvature is
-less than <em>min_rad</em> [Default is 0].</dd>
-<dt><strong>+t</strong>[<em>file</em>]</dt>
-<dd>Saves contour label x, y, and text to <em>file</em> [Contour_labels.txt].
-Use <strong>+T</strong> to save x, y, angle, text instead.</dd>
-<dt><strong>+u</strong><em>unit</em></dt>
-<dd>Appends <em>unit</em> to all contour labels. [Default is no unit].
-If <strong>z</strong> is appended we use the z-unit from the grdfile.</dd>
-<dt><strong>+v</strong></dt>
-<dd>Specifies curved labels following the contour [Default is straight
-labels].</dd>
-<dt><strong>+w</strong></dt>
-<dd>Specifies how many (<em>x</em>,<em>y</em>) points will be used to estimate
-label angles [Default is 10].</dd>
-<dt><strong>+=</strong><em>prefix</em></dt>
-<dd>Prepends <em>prefix</em> to all contour labels. [Default is no prefix].</dd>
-</dl>
-</div></blockquote>
-<dl class="docutils">
-<dt><strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> <a class="reference internal" href="gmt.html#b-full"><em>(more ...)</em></a></dt>
-<dd>Set map boundary intervals.</dd>
-<dt><strong>-D</strong><em><template></em></dt>
-<dd>Dump contours as data line segments; no plotting takes place.
-Append filename template which may contain C-format specifiers.
-If no filename template is given we write all lines to stdout.
-If filename has no specifiers then we write all lines to a single file.
-If a float format (e.g., %6.2f) is found we substitute the contour z-value.
-If an integer format (e.g., %06d) is found we substitute a running segment count.
-If an char format (%c) is found we substitute C or O for closed and open contours.
-The 1-3 specifiers may be combined and appear in any order to produce the
-the desired number of output files (e.g., just %c gives two files, just %f would.
-separate segments into one file per contour level, and %d would write all segments.
-to individual files; see manual page for more examples.</dd>
-<dt><strong>-F</strong>[<strong>l</strong>|<strong>r</strong>]</dt>
-<dd>Force dumped contours to be oriented so that higher z-values are to the
-left (<strong>-Fl</strong> [Default]) or right (<strong>-Fr</strong>) as we move along the contour
-[Default is arbitrary orientation]. Requires <strong>-D</strong>.</dd>
-</dl>
-<p><strong>-G</strong>[<strong>d</strong>|<strong>f</strong>|<strong>n</strong>|<strong>l</strong>|<strong>L</strong>|<strong>x</strong>|<strong>X</strong>]<em>params</em></p>
-<blockquote>
-<div><p>The required argument controls the placement of labels along the quoted
-lines. Choose among five controlling algorithms:</p>
-<dl class="docutils">
-<dt><strong>d</strong><em>dist</em>[<strong>c</strong>|<strong>i</strong>|<strong>p</strong>] or <strong>D</strong><em>dist</em>[<strong>d</strong>|<strong>e</strong>|<strong>f</strong>|<strong>k</strong>|<strong>m</strong>|<strong>M</strong>|<strong>n</strong>|<strong>s</strong>]</dt>
-<dd>For lower case <strong>d</strong>, give distances between labels on the plot
-in your preferred measurement unit <strong>c</strong> (cm), <strong>i</strong> (inch), or
-<strong>p</strong> (points), while for upper case <strong>D</strong>, specify distances in
-map units and append the unit; choose among <strong>e</strong> (m), <strong>f</strong>
-(foot), <strong>k</strong> (km), <strong>M</strong> (mile), <strong>n</strong> (nautical mile) or <strong>u</strong>
-(US survey foot), and <strong>d</strong> (arc degree), <strong>m</strong> (arc minute), or
-<strong>s</strong> (arc second). [Default is 10<strong>c</strong> or 4<strong>i</strong>]. As an
-option, you can append /<em>fraction</em> which is used to place the
-very first label for each contour when the cumulative
-along-contour distance equals <em>fraction * dist</em> [0.25].</dd>
-<dt><strong>f</strong><em>ffile.d</em></dt>
-<dd>Reads the ascii file <em>ffile.d</em> and places labels at locations in
-the file that matches locations along the quoted lines. Inexact
-matches and points outside the region are skipped.</dd>
-<dt><strong>l|L</strong><em>line1</em>[,<em>line2</em>,...]</dt>
-<dd>Give <em>start</em> and <em>stop</em> coordinates for one or more
-comma-separated straight line segments. Labels will be placed
-where these lines intersect the quoted lines. The format of each
-<em>line</em> specification is <em>start/stop</em>, where <em>start</em> and <em>stop</em>
-are either a specified point <em>lon/lat</em> or a 2-character <strong>XY</strong>
-key that uses the justification format employed in <strong>pstext</strong> to
-indicate a point on the map, given as [LCR][BMT].
-In addition, you can use Z-, Z+ to mean the global minimum and
-maximum locations in the grid. <strong>L</strong> will interpret the point pairs
-as defining great circles [Default is straight line].</dd>
-<dt><strong>n</strong><em>n_label</em></dt>
-<dd>Specifies the number of equidistant labels for quoted lines line
-[1]. Upper case <strong>N</strong> starts labeling exactly at the start of
-the line [Default centers them along the line]. <strong>N</strong>-1 places
-one justified label at start, while <strong>N</strong>+1 places one
-justified label at the end of quoted lines. Optionally, append
-/<em>min_dist</em>[<strong>c</strong>|<strong>i</strong>|<strong>p</strong>] to enforce that a
-minimum distance separation between successive labels is
-enforced.</dd>
-<dt><strong>x|X</strong><em>xfile.d</em></dt>
-<dd>Reads the multisegment file <em>xfile.d</em> and places labels at the
-intersections between the quoted lines and the lines in
-<em>xfile.d</em>. <strong>X</strong> will resample the lines first along
-great-circle arcs.</dd>
-</dl>
-<p>In addition, you may optionally append
-<strong>+r</strong><em>radius</em>[<strong>c</strong>|<strong>i</strong>|<strong>p</strong>] to set a minimum
-label separation in the x-y plane [no limitation].</p>
-</div></blockquote>
-<dl class="docutils">
-<dt><strong>-Jz</strong>|<strong>Z</strong><em>parameters</em> <a class="reference internal" href="gmt.html#jz-full"><em>(more ...)</em></a></dt>
-<dd>Set z-axis scaling; same syntax as <strong>-Jx</strong>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-K</strong> <a class="reference internal" href="gmt.html#k-full"><em>(more ...)</em></a></dt>
-<dd>Do not finalize the PostScript plot.</dd>
-<dt><strong>-L</strong><em>low/high</em></dt>
-<dd>Limit range: Do not draw contours for data values below <em>low</em> or
-above <em>high</em>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-O</strong> <a class="reference internal" href="gmt.html#o-full"><em>(more ...)</em></a></dt>
-<dd>Append to existing PostScript plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-P</strong> <a class="reference internal" href="gmt.html#p-full"><em>(more ...)</em></a></dt>
-<dd>Select “Portrait” plot orientation.</dd>
-<dt><strong>-Q</strong><em>cut</em></dt>
-<dd>Do not draw contours with less than <em>cut</em> number of points [Draw all contours].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-</dl>
-<p>For perspective view <strong>p</strong>, optionally append /<em>zmin</em>/<em>zmax</em>. <a class="reference internal" href="gmt.html#rz-full"><em>(more ...)</em></a> [Default is region defined in the grid file].</p>
-<dl class="docutils">
-<dt><strong>-S</strong><em>smoothfactor</em></dt>
-<dd>Used to resample the contour lines at roughly every
-(gridbox_size/<em>smoothfactor</em>) interval.</dd>
-<dt><strong>-T</strong>[<strong>+|-</strong>][<em>gap/length</em>][<strong>:</strong>[<em>labels</em>]]</dt>
-<dd>Will draw tickmarks pointing in the downward direction every <em>gap</em>
-along the innermost closed contours. Append <em>gap</em> and tickmark
-length (append units as <strong>c</strong>, <strong>i</strong>, or <strong>p</strong>) or use defaults
-[15<strong>p</strong>/3<strong>p</strong>]. User may choose to tick only local highs or local
-lows by specifying <strong>-T+</strong> or <strong>-T-</strong>, respectively. Append
-<strong>:</strong><em>labels</em> to annotate the centers of closed innermost contours
-(i.e, the local lows and highs). If no <em>labels</em> is appended we use -
-and + as the labels. Appending two characters, <strong>:LH</strong>, will plot
-the two characters (here, L and H) as labels. For more elaborate
-labels, separate the two label strings by a comma (e.g.,
-<strong>:</strong><em>lo</em>,<em>hi</em>). If a file is given by <strong>-C</strong> and <strong>-T</strong> is set,
-then only contours marked with upper case C or A will have tickmarks
-[and annotation].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] <a class="reference internal" href="gmt.html#u-full"><em>(more ...)</em></a></dt>
-<dd>Draw GMT time stamp logo on plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong>[<strong>+</strong>][<em>type</em>]<em>pen</em> <a class="reference internal" href="gmt.html#set-pens"><em>(more ...)</em></a></dt>
-<dd><em>type</em>, if present, can be <strong>a</strong> for annotated contours or <strong>c</strong> for
-regular contours [Default]. <em>pen</em> sets the attributes for the
-particular line. Default pen for annotated contours: 0.75p,black.
-Regular contours use pen 0.25p,black. If the <strong>+</strong> flag is prepended
-then the color of the contour lines are taken from the cpt file (see
-<strong>-C</strong>). If the <strong>-</strong> flag is prepended then the color from the cpt
-file is applied both to the contours and the contour annotations.</dd>
-</dl>
-<p><strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]]</p>
-<dl class="docutils">
-<dt><strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] <a class="reference internal" href="gmt.html#xy-full"><em>(more ...)</em></a></dt>
-<dd>Shift plot origin.</dd>
-<dt><strong>-Z</strong>[<em>factor</em>[/<em>shift</em>]][<strong>p</strong>]</dt>
-<dd>Use to subtract <em>shift</em> from the data and multiply the results by
-<em>factor</em> before contouring starts [1/0]. (Numbers in <strong>-A</strong>, <strong>-C</strong>,
-<strong>-L</strong> refer to values after this scaling has occurred.) Append
-<strong>p</strong> to indicate that this grid file contains z-values that are
-periodic in 360 degrees (e.g., phase data, angular distributions)
-and that special precautions must be taken when determining
-0-contours.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-c</strong><em>copies</em> <a class="reference internal" href="gmt.html#c-full"><em>(more ...)</em></a></dt>
-<dd>Specify number of plot copies [Default is 1].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] <a class="reference internal" href="gmt.html#perspective-full"><em>(more ...)</em></a></dt>
-<dd>Select perspective view. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-t</strong>[<em>transp</em>] <a class="reference internal" href="gmt.html#t-full"><em>(more ...)</em></a></dt>
-<dd>Set PDF transparency level in percent.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="ascii-format-precision">
-<h2>Ascii Format Precision<a class="headerlink" href="#ascii-format-precision" title="Permalink to this headline">¶</a></h2>
-<p>The ASCII output formats of numerical data are controlled by parameters
-in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file. Longitude and latitude are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>, whereas other values are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>. Be aware that the format in effect
-can lead to loss of precision in the output, which can lead to various
-problems downstream. If you find the output is not written with enough
-precision, consider switching to binary output (<strong>-bo</strong> if available) or
-specify more decimals using the <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> setting.</p>
-</div>
-<div class="section" id="grid-file-formats">
-<h2>Grid File Formats<a class="headerlink" href="#grid-file-formats" title="Permalink to this headline">¶</a></h2>
-<p>By default GMT writes out grid as single precision floats in a
-COARDS-complaint netCDF file format. However, GMT is able to produce
-grid files in many other commonly used grid file formats and also
-facilitates so called “packing” of grids, writing out floating point
-data as 1- or 2-byte integers. To specify the precision, scale and
-offset, the user should add the suffix
-<strong>=</strong><em>id</em>[<strong>/</strong><em>scale</em><strong>/</strong><em>offset</em>[<strong>/</strong><em>nan</em>]], where
-<em>id</em> is a two-letter identifier of the grid type and precision, and
-<em>scale</em> and <em>offset</em> are optional scale factor and offset to be applied
-to all grid values, and <em>nan</em> is the value used to indicate missing
-data. When reading grids, the format is generally automatically
-recognized. If not, the same suffix can be added to input grid file
-names. See <a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section
-<a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a>
-of the GMT Technical Reference and Cookbook for more information.</p>
-<p>When reading a netCDF file that contains multiple grids, GMT will
-read, by default, the first 2-dimensional grid that can find in that
-file. To coax GMT into reading another multi-dimensional variable in
-the grid file, append <strong>?</strong><em>varname</em> to the file name, where <em>varname</em>
-is the name of the variable. Note that you may need to escape the
-special meaning of <strong>?</strong> in your shell program by putting a backslash in
-front of it, or by placing the filename and suffix between quotes or
-double quotes. The <strong>?</strong><em>varname</em> suffix can also be used for output
-grids to specify a variable name different from the default: “z”. See
-<a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section <a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a> of the GMT
-Technical Reference and Cookbook for more information, particularly on
-how to read splices of 3-, 4-, or 5-dimensional grids.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To contour the file hawaii_grav.nc every 25 mGal on a Mercator map at
-0.5 inch/degree, annotate every 50 mGal (using fontsize = 10p), using 1
-degree tickmarks, and draw 30 minute gridlines:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdcontour hawaii_grav.nc -Jm0.5i -C25 -A50+f10p -B1g30m > hawaii_grav.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>To contour the file image.nc using the levels in the file cont.d on a
-linear projection at 0.1 cm/x-unit and 50 cm/y-unit, using 20 (x) and
-0.1 (y) tickmarks, smooth the contours a bit, use “RMS Misfit” as
-plot-title, use a thick red pen for annotated contours, and a thin,
-dashed, blue pen for the rest, and send the output to the default printer:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdcontour image.nc -Jx0.1c/50.0c -Ccont.d -S4 -B20/0.1:."RMS \
- Misfit":-Wathick,red -Wcthinnest,blue,- | lp
-</pre></div>
-</div>
-</div></blockquote>
-<p>The labeling of local highs and lows may plot outside the innermost
-contour since only the mean value of the contour coordinates is used to
-position the label.</p>
-<p>To save the smoothed 100-m contour lines in topo.nc and separate them
-into two multisegment files: contours_C.txt for closed and
-contours_O.txt for open contours, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdcontour topo.nc -C100 -S4 -Dcontours_%c.txt
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>,
-<a class="reference internal" href="gmtcolors.html"><em>gmtcolors</em></a>,
-<a class="reference internal" href="psbasemap.html"><em>psbasemap</em></a>,
-<a class="reference internal" href="grdimage.html"><em>grdimage</em></a>, <a class="reference internal" href="grdview.html"><em>grdview</em></a>,
-<a class="reference internal" href="pscontour.html"><em>pscontour</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grdcontour</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#ascii-format-precision">Ascii Format Precision</a></li>
-<li><a class="reference internal" href="#grid-file-formats">Grid File Formats</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grdclip.html"
- title="previous chapter">grdclip</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grdcut.html"
- title="next chapter">grdcut</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/grdcontour.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grdcut.html" title="grdcut"
- >next</a> </li>
- <li class="right" >
- <a href="grdclip.html" title="grdclip"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" >GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/grdcut.html b/doc_release/html/grdcut.html
deleted file mode 100644
index 147e444..0000000
--- a/doc_release/html/grdcut.html
+++ /dev/null
@@ -1,324 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grdcut — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GR" href="GR.html" />
- <link rel="next" title="grdedit" href="grdedit.html" />
- <link rel="prev" title="grdcontour" href="grdcontour.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grdedit.html" title="grdedit"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grdcontour.html" title="grdcontour"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" accesskey="U">GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grdcut">
-<span id="index-0"></span><h1>grdcut<a class="headerlink" href="#grdcut" title="Permalink to this headline">¶</a></h1>
-<p>grdcut - Extract subregion from a grid</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdcut</strong> <em>ingrid</em> <strong>-G</strong><em>outgrid</em>
-<strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>]
-[ <strong>-N</strong>[<em>nodata</em>] ]
-[ <strong>-S</strong>[<strong>n</strong>]<em>lon/lat/radius</em>[<em>unit</em>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-Z</strong>[<strong>n</strong>|<strong>r</strong>]<em>min/max</em> ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdcut</strong> will produce a new <em>outgrid</em> file which is a subregion of
-<em>ingrid</em>. The subregion is specified with <strong>-R</strong> as in other programs;
-the specified range must not exceed the range of <em>ingrid</em> (but see <strong>-N</strong>).
-If in doubt, run <strong>grdinfo</strong> to check range. Alternatively, define the subregion
-indirectly via a range check on the node values or via distances from a
-given point. Complementary to <strong>grdcut</strong> there is <strong>grdpaste</strong>, which
-will join together two grid files along a common edge.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>ingrid</em></dt>
-<dd>This is the input grid file.</dd>
-<dt><strong>-G</strong><em>outgrid</em></dt>
-<dd>This is the output grid file.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-N</strong>[<em>nodata</em>]</dt>
-<dd>Allow grid to be extended if new <strong>-R</strong> exceeds existing boundaries.
-Append <em>nodata</em> value to initialize nodes outside current region [Default is NaN].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. This defines the subregion to be cut out.</dd>
-<dt><strong>-S</strong>[<strong>n</strong>]<em>lon/lat/radius</em>[<em>unit</em>]</dt>
-<dd>Specify an origin and radius; append a distance unit (see UNITS) and
-we determine the corresponding rectangular region so that all grid
-nodes on or inside the circle are contained in the subset. If
-<strong>-Sn</strong> is used we set all nodes outside the circle to NaN.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-Z</strong>[<strong>n</strong>|<strong>r</strong>]<em>min/max</em></dt>
-<dd>Determine the new rectangular region so that all nodes <em>outside</em> this
-region are also outside the given <em>z</em>-range [-inf/+inf]. To indicate
-no limit on min or max, specify a hyphen (-). Normally, any NaNs
-encountered are simply skipped and not considered in the decision.
-Use <strong>-Zn</strong> to consider a NaN to be outside the <em>z</em>-range. This means
-the new subset will be NaN-free. Alternatively, use <strong>-Zr</strong> to
-consider NaNs to be within the data range. In this case we stop
-shrinking the boundaries once a NaN is found [Default simply skips NaNs
-when making the range decision].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc9">Units</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>For map distance unit, append <em>unit</em> <strong>d</strong> for arc degree, <strong>m</strong> for arc
-minute, and <strong>s</strong> for arc second, or <strong>e</strong> for meter [Default], <strong>f</strong>
-for foot, <strong>k</strong> for km, <strong>M</strong> for statute mile, <strong>n</strong> for nautical mile,
-and <strong>u</strong> for US survey foot. By default we compute such distances using
-a spherical approximation with great circles. Prepend <strong>-</strong> to a
-distance (or the unit is no distance is given) to perform “Flat Earth”
-calculations (quicker but less accurate) or prepend <strong>+</strong> to perform
-exact geodesic calculations (slower but more accurate).</p>
-</div>
-<div class="section" id="grid-file-formats">
-<h2>Grid File Formats<a class="headerlink" href="#grid-file-formats" title="Permalink to this headline">¶</a></h2>
-<p>By default GMT writes out grid as single precision floats in a
-COARDS-complaint netCDF file format. However, GMT is able to produce
-grid files in many other commonly used grid file formats and also
-facilitates so called “packing” of grids, writing out floating point
-data as 1- or 2-byte integers. To specify the precision, scale and
-offset, the user should add the suffix
-<strong>=</strong><em>id</em>[<strong>/</strong><em>scale</em><strong>/</strong><em>offset</em>[<strong>/</strong><em>nan</em>]], where
-<em>id</em> is a two-letter identifier of the grid type and precision, and
-<em>scale</em> and <em>offset</em> are optional scale factor and offset to be applied
-to all grid values, and <em>nan</em> is the value used to indicate missing
-data. When reading grids, the format is generally automatically
-recognized. If not, the same suffix can be added to input grid file
-names. See <a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section
-<a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a>
-of the GMT Technical Reference and Cookbook for more information.</p>
-<p>When reading a netCDF file that contains multiple grids, GMT will
-read, by default, the first 2-dimensional grid that can find in that
-file. To coax GMT into reading another multi-dimensional variable in
-the grid file, append <strong>?</strong><em>varname</em> to the file name, where <em>varname</em>
-is the name of the variable. Note that you may need to escape the
-special meaning of <strong>?</strong> in your shell program by putting a backslash in
-front of it, or by placing the filename and suffix between quotes or
-double quotes. The <strong>?</strong><em>varname</em> suffix can also be used for output
-grids to specify a variable name different from the default: “z”. See
-<a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section <a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a> of the GMT
-Technical Reference and Cookbook for more information, particularly on
-how to read splices of 3-, 4-, or 5-dimensional grids.</p>
-</div>
-<div class="section" id="geographical-and-time-coordinates">
-<h2>Geographical And Time Coordinates<a class="headerlink" href="#geographical-and-time-coordinates" title="Permalink to this headline">¶</a></h2>
-<p>When the output grid type is netCDF, the coordinates will be labeled
-“longitude”, “latitude”, or “time” based on the attributes of the input
-data or grid (if any) or on the <strong>-f</strong> or <strong>-R</strong> options. For example,
-both <strong>-f0x</strong> <strong>-f1t</strong> and <strong>-R</strong>90w/90e/0t/3t will result in a
-longitude/time grid. When the x, y, or z coordinate is time, it will be
-stored in the grid as relative time since epoch as specified by
-<a class="reference internal" href="gmt.conf.html#time-unit"><em>TIME_UNIT</em></a> and <a class="reference internal" href="gmt.conf.html#time-epoch"><em>TIME_EPOCH</em></a> in the
-<a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file or on the
-command line. In addition, the <strong>unit</strong> attribute of the time variable
-will indicate both this unit and epoch.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>Suppose you have used <strong>surface</strong> to grid ship gravity in the region
-between 148E - 162E and 8N - 32N, and you do not trust the gridding near
-the edges, so you want to keep only the area between 150E - 160E and 10N - 30N, then:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdcut grav_148_162_8_32.nc -Ggrav_150_160_10_30.nc -R150/160/10/30 -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>To return the subregion of a grid such that any boundary strips where
-all values are entirely above 0 are excluded, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdcut bathy.nc -Gtrimmed_bathy.nc -Z-/0 -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>To return the subregion of a grid that contains all nodes within a
-distance of 500 km from the point 45,30 try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdcut bathy.nc -Gsubset_bathy.nc -S45/30/500k -V
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="id2">
-<h2><a class="reference external" href="#toc10">See Also</a><a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="grdclip.html"><em>grdclip</em></a>,
-<a class="reference internal" href="grdpaste.html"><em>grdpaste</em></a>,
-<a class="reference internal" href="grdinfo.html"><em>grdinfo</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grdcut</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#id1">Units</a></li>
-<li><a class="reference internal" href="#grid-file-formats">Grid File Formats</a></li>
-<li><a class="reference internal" href="#geographical-and-time-coordinates">Geographical And Time Coordinates</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#id2">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grdcontour.html"
- title="previous chapter">grdcontour</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grdedit.html"
- title="next chapter">grdedit</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/grdcut.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grdedit.html" title="grdedit"
- >next</a> </li>
- <li class="right" >
- <a href="grdcontour.html" title="grdcontour"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" >GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/grdedit.html b/doc_release/html/grdedit.html
deleted file mode 100644
index bfb6658..0000000
--- a/doc_release/html/grdedit.html
+++ /dev/null
@@ -1,355 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grdedit — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GR" href="GR.html" />
- <link rel="next" title="grdfft" href="grdfft.html" />
- <link rel="prev" title="grdcut" href="grdcut.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grdfft.html" title="grdfft"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grdcut.html" title="grdcut"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" accesskey="U">GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grdedit">
-<span id="index-0"></span><h1>grdedit<a class="headerlink" href="#grdedit" title="Permalink to this headline">¶</a></h1>
-<p>grdedit - Modify header or content of a grid</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdedit</strong> <em>grid</em> [ <strong>-A</strong> ]
-[ <strong>-D</strong><em>xname</em>/<em>yname</em>/<em>zname</em>/<em>scale</em>/<em>offset</em>/<em>invalid</em>/<em>title</em>/<em>remark</em> ]
-[ <strong>-E</strong> ] [ <strong>-N</strong><em>table</em> ]
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ]
-[ <strong>-S</strong> ] [ <strong>-T</strong> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-bi</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdedit</strong> reads the header information in a binary 2-D grid file and
-replaces the information with values provided on the command line [if
-any]. As an option, global, geographical grids (with 360 degrees
-longitude range) can be rotated in the east-west direction, and
-individual nodal values can be replaced from a table of <em>x</em>, <em>y</em>, <em>z</em>
-values. <strong>grdedit</strong> only operates on files containing a grdheader. Note:
-If it is important to retain the original data you should work on a copy
-of that file.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>grid</em></dt>
-<dd>Name of the 2-D grid file to modify. (See GRID FILE FORMATS below).</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong></dt>
-<dd>If necessary, adjust the file’s <em>x_inc</em>, <em>y_inc</em> to be compatible
-with its domain (or a new domain set with <strong>-R</strong>). Older grid files
-(i.e., created prior to GMT 3.1) often had excessive slop in
-<em>x_inc</em>, <em>y_inc</em> and an adjustment is necessary. Newer files are
-created correctly.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-D</strong><em>xname</em>/<em>yname</em>/<em>zname</em>/<em>scale</em>/<em>offset</em>/<em>invalid</em>/<em>title</em>/<em>remark</em></dt>
-<dd>Give values for <em>xname</em>, <em>yname</em>, <em>zname</em> (give the names of those variables
-and in square bracket their units, e.g., “distance [km]”), <em>scale</em> (to multiply grid values after
-read [normally 1]), <em>offset</em> (to add to grid after scaling [normally 0]),
-<em>invalid</em> (a value to represent missing data [NaN]), <em>title</em> (anything you
-like), and <em>remark</em> (anything you like). To leave some of these values untouched,
-leave field blank. Empty fields in the end may be skipped. Alternatively,
-to allow “/” to be part of one of the values, use any non-alphanumeric
-character (and not the equal sign) as separator by both starting and ending
-with it. For example:
-<strong>-D</strong>:<em>xname</em>:<em>yname</em>:<em>zname</em>:<em>scale</em>:<em>offset</em>:<em>invalid</em>:<em>title</em>:<em>remark</em>:
-Use quotes to group texts with more than one word.
-Note that for geographic grids (<strong>-fg</strong>) <em>xname</em> and <em>yname</em> are set automatically.</dd>
-<dt><strong>-E</strong></dt>
-<dd>Transpose the grid and exchange the <em>x</em> and <em>y</em> information.
-Incompatible with the other options.</dd>
-<dt><strong>-N</strong><em>table</em></dt>
-<dd>Read the ASCII (or binary; see <strong>-bi</strong>) file
-<em>table</em> and replace the corresponding nodal values in the grid with
-these <em>x</em>,<em>y</em>,<em>z</em> values.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. The new w/e/s/n values will
-replace those in the grid, and the <em>x_inc</em>, <em>y_inc</em> values are
-adjusted, if necessary.</dd>
-<dt><strong>-S</strong></dt>
-<dd>For global, geographical grids only. Grid values will be shifted
-longitudinally according to the new borders given in <strong>-R</strong>.</dd>
-<dt><strong>-T</strong></dt>
-<dd>Make necessary changes in the header to convert a
-gridline-registered grid to a pixel-registered grid, or vice-versa.
-Basically, gridline-registered grids will have their domain extended
-by half the x- and y-increments whereas pixel-registered grids will
-have their domain shrunk by the same amount.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 3 input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="grid-file-formats">
-<h2>Grid File Formats<a class="headerlink" href="#grid-file-formats" title="Permalink to this headline">¶</a></h2>
-<p>By default GMT writes out grid as single precision floats in a
-COARDS-complaint netCDF file format. However, GMT is able to produce
-grid files in many other commonly used grid file formats and also
-facilitates so called “packing” of grids, writing out floating point
-data as 1- or 2-byte integers. To specify the precision, scale and
-offset, the user should add the suffix
-<strong>=</strong><em>id</em>[<strong>/</strong><em>scale</em><strong>/</strong><em>offset</em>[<strong>/</strong><em>nan</em>]], where
-<em>id</em> is a two-letter identifier of the grid type and precision, and
-<em>scale</em> and <em>offset</em> are optional scale factor and offset to be applied
-to all grid values, and <em>nan</em> is the value used to indicate missing
-data. When reading grids, the format is generally automatically
-recognized. If not, the same suffix can be added to input grid file
-names. See <a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section
-<a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a>
-of the GMT Technical Reference and Cookbook for more information.</p>
-<p>When reading a netCDF file that contains multiple grids, GMT will
-read, by default, the first 2-dimensional grid that can find in that
-file. To coax GMT into reading another multi-dimensional variable in
-the grid file, append <strong>?</strong><em>varname</em> to the file name, where <em>varname</em>
-is the name of the variable. Note that you may need to escape the
-special meaning of <strong>?</strong> in your shell program by putting a backslash in
-front of it, or by placing the filename and suffix between quotes or
-double quotes. The <strong>?</strong><em>varname</em> suffix can also be used for output
-grids to specify a variable name different from the default: “z”. See
-<a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section <a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a> of the GMT
-Technical Reference and Cookbook for more information, particularly on
-how to read splices of 3-, 4-, or 5-dimensional grids.</p>
-</div>
-<div class="section" id="geographical-and-time-coordinates">
-<h2>Geographical And Time Coordinates<a class="headerlink" href="#geographical-and-time-coordinates" title="Permalink to this headline">¶</a></h2>
-<p>When the output grid type is netCDF, the coordinates will be labeled
-“longitude”, “latitude”, or “time” based on the attributes of the input
-data or grid (if any) or on the <strong>-f</strong> or <strong>-R</strong> options. For example,
-both <strong>-f0x</strong> <strong>-f1t</strong> and <strong>-R</strong>90w/90e/0t/3t will result in a
-longitude/time grid. When the x, y, or z coordinate is time, it will be
-stored in the grid as relative time since epoch as specified by
-<a class="reference internal" href="gmt.conf.html#time-unit"><em>TIME_UNIT</em></a> and <a class="reference internal" href="gmt.conf.html#time-epoch"><em>TIME_EPOCH</em></a> in the
-<a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file or on the
-command line. In addition, the <strong>unit</strong> attribute of the time variable
-will indicate both this unit and epoch.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>Let us assume the file data.nc covers the area 300/310/10/30. We want to
-change the boundaries from geodetic longitudes to geographic and put a
-new title in the header. We accomplish this by</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdedit data.nc -R-60/-50/10/30 -D//////"Gravity Anomalies"
-</pre></div>
-</div>
-</div></blockquote>
-<p>The grid world.nc has the limits 0/360/-72/72. To shift the data so that
-the limits would be -180/180/-72/72, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdedit world.nc -R-180/180/-72/72 -S
-</pre></div>
-</div>
-</div></blockquote>
-<p>The file junk.nc was created prior to GMT 3.1 with incompatible
-<strong>-R</strong> and <strong>-I</strong> arguments. To reset the x- and y-increments we run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdedit junk.nc -A
-</pre></div>
-</div>
-</div></blockquote>
-<p>The file junk.nc was created prior to GMT 4.1.3 and does not contain
-the required information to indicate that the grid is geographic. To add
-this information, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdedit junk.nc -fg
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="grd2xyz.html"><em>grd2xyz</em></a>,
-<a class="reference internal" href="grdinfo.html"><em>grdinfo</em></a>
-<a class="reference internal" href="xyz2grd.html"><em>xyz2grd</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grdedit</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#grid-file-formats">Grid File Formats</a></li>
-<li><a class="reference internal" href="#geographical-and-time-coordinates">Geographical And Time Coordinates</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grdcut.html"
- title="previous chapter">grdcut</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grdfft.html"
- title="next chapter">grdfft</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/grdedit.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grdfft.html" title="grdfft"
- >next</a> </li>
- <li class="right" >
- <a href="grdcut.html" title="grdcut"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" >GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/grdfft.html b/doc_release/html/grdfft.html
deleted file mode 100644
index d4d382b..0000000
--- a/doc_release/html/grdfft.html
+++ /dev/null
@@ -1,437 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grdfft — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GR" href="GR.html" />
- <link rel="next" title="grdfilter" href="grdfilter.html" />
- <link rel="prev" title="grdedit" href="grdedit.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grdfilter.html" title="grdfilter"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grdedit.html" title="grdedit"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" accesskey="U">GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grdfft">
-<span id="index-0"></span><h1>grdfft<a class="headerlink" href="#grdfft" title="Permalink to this headline">¶</a></h1>
-<p>grdfft - Do mathematical operations on grids in the wavenumber (or frequency) domain</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdfft</strong> <em>ingrid</em> [ <em>ingrid2</em> ] <strong>-G</strong><em>outfile</em> [ <strong>-A</strong><em>azimuth</em> ]
-[ <strong>-C</strong><em>zlevel</em> ] [ <strong>-D</strong>[<em>scale</em>|<strong>g</strong>] ]
-[ <strong>-E</strong>[<strong>r</strong>|<strong>x</strong>|<strong>y</strong>][<strong>w</strong>[<strong>k</strong>]] ]
-[ <strong>-F</strong>[<strong>r</strong>|<strong>x</strong>|<strong>y</strong>]<em>params</em> ]
-[ <strong>-I</strong>[<em>scale</em>|<strong>g</strong>] ]
-[ <strong>-N</strong>[<strong>f</strong>|<strong>q</strong>|<strong>s</strong>|<em>nx/ny</em>][<strong>+a</strong>|<strong>d</strong>|<strong>h</strong>|<strong>l</strong>][<strong>+e</strong>|<strong>n</strong>|<strong>m</strong>][<strong>+t</strong><em>width</em>][<strong>+w</strong>[<em>suffix</em>]][<strong>+z</strong>[<strong>p</strong>]] ]
-[ <strong>-S</strong><em>scale</em> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-fg</strong> ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdfft</strong> will take the 2-D forward Fast Fourier Transform and perform
-one or more mathematical operations in the frequency domain before
-transforming back to the space domain. An option is provided to scale
-the data before writing the new values to an output file. The horizontal
-dimensions of the grid are assumed to be in meters. Geographical grids
-may be used by specifying the <strong>-fg</strong> option that scales degrees to
-meters. If you have grids with dimensions in km, you could change this
-to meters using <a class="reference internal" href="grdedit.html"><em>grdedit</em></a> or scale the output with <a class="reference internal" href="grdmath.html"><em>grdmath</em></a>.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>ingrid</em></dt>
-<dd>2-D binary grid file to be operated on. (See GRID FILE FORMATS
-below). For cross-spectral operations, also give the second grid
-file <em>ingrd2</em>.</dd>
-<dt><strong>-G</strong><em>outfile</em></dt>
-<dd>Specify the name of the output grid file or the 1-D spectrum table
-(see <strong>-E</strong>). (See GRID FILE FORMATS below).</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong><em>azimuth</em></dt>
-<dd>Take the directional derivative in the <em>azimuth</em> direction measured
-in degrees CW from north.</dd>
-<dt><strong>-C</strong><em>zlevel</em></dt>
-<dd>Upward (for <em>zlevel</em> > 0) or downward (for <em>zlevel</em> < 0) continue
-the field <em>zlevel</em> meters.</dd>
-<dt><strong>-D</strong>[<em>scale</em>|<strong>g</strong>]</dt>
-<dd>Differentiate the field, i.e., take d(field)/dz. This is equivalent
-to multiplying by kr in the frequency domain (kr is radial wave
-number). Append a scale to multiply by (kr * <em>scale</em>) instead.
-Alternatively, append <strong>g</strong> to indicate that your data are geoid
-heights in meters and output should be gravity anomalies in mGal.
-[Default is no scale].</dd>
-<dt><strong>-E</strong>[<strong>r</strong>|<strong>x</strong>|<strong>y</strong>][<strong>w</strong>[<strong>k</strong>]]</dt>
-<dd>Estimate power spectrum in the radial direction [<strong>r</strong>]. Place
-<strong>x</strong> or <strong>y</strong> immediately after <strong>-E</strong> to compute the spectrum in
-the x or y direction instead. No grid file is created. If one grid
-is given then f (i.e., frequency or wave number), power[f],
-and 1 standard deviation in power[f] are written to the file set by
-<strong>-G</strong> [stdout]. If two grids are given we write f and 8 quantities:
-Xpower[f], Ypower[f], coherent power[f], noise power[f], phase[f],
-admittance[f], gain[f], coherency[f]. Each quantity is followed by
-its own 1-std dev error estimate, hence the output is 17 columns wide.
-Append <strong>w</strong> to write wavelength instead of frequency. If your grid
-is geographic you may further append <strong>k</strong> to scale wavelengths from
-meter [Default] to km.</dd>
-<dt><strong>-F</strong>[<strong>r</strong>|<strong>x</strong>|<strong>y</strong>]<em>params</em></dt>
-<dd><p class="first">Filter the data. Place <strong>x</strong> or <strong>y</strong> immediately after <strong>-F</strong> to
-filter <em>x</em> or <em>y</em> direction only; default is isotropic [<strong>r</strong>].
-Choose between a cosine-tapered band-pass, a Gaussian band-pass
-filter, or a Butterworth band-pass filter.</p>
-<dl class="last docutils">
-<dt>Cosine-taper:</dt>
-<dd>Specify four wavelengths <em>lc</em>/<em>lp</em>/<em>hp</em>/<em>hc</em> in correct units (see <strong>-fg</strong>)
-to design a bandpass filter: wavelengths greater than <em>lc</em> or less
-than <em>hc</em> will be cut, wavelengths greater than <em>lp</em> and less than
-<em>hp</em> will be passed, and wavelengths in between will be
-cosine-tapered. E.g., <strong>-F</strong>1000000/250000/50000/10000 <strong>-fg</strong>
-will bandpass, cutting wavelengths > 1000 km and < 10 km, passing
-wavelengths between 250 km and 50 km. To make a highpass or lowpass
-filter, give hyphens (-) for <em>hp</em>/<em>hc</em> or <em>lc</em>/<em>lp</em>. E.g.,
-<strong>-Fx</strong>-/-/50/10 will lowpass <em>x</em>, passing wavelengths > 50 and
-rejecting wavelengths < 10. <strong>-Fy</strong>1000/250/-/- will highpass <em>y</em>,
-passing wavelengths < 250 and rejecting wavelengths > 1000.</dd>
-<dt>Gaussian band-pass:</dt>
-<dd>Append <em>lo</em>/<em>hi</em>, the two wavelengths in correct units
-(see <strong>-fg</strong>) to design a bandpass filter. At the given wavelengths
-the Gaussian filter weights will be 0.5. To make a highpass or
-lowpass filter, give a hyphen (-) for the <em>hi</em> or <em>lo</em> wavelength,
-respectively. E.g., <strong>-F</strong>-/30 will lowpass the data using a
-Gaussian filter with half-weight at 30, while <strong>-F</strong>400/- will
-highpass the data.</dd>
-<dt>Butterworth band-pass:</dt>
-<dd>Append <em>lo</em>/<em>hi</em>/<em>order</em>,
-the two wavelengths in correct units (see <strong>-fg</strong>) and the filter
-order (an integer) to design a bandpass filter. At the given
-wavelengths the Butterworth filter weights will be 0.5. To make a
-highpass or lowpass filter, give a hyphen (-) for the <em>hi</em> or <em>lo</em>
-wavelength, respectively. E.g., <strong>-F</strong>-/30/2 will lowpass the data
-using a 2nd-order Butterworth filter, with half-weight at 30, while
-<strong>-F</strong>400/-/2 will highpass the data.</dd>
-</dl>
-</dd>
-<dt><strong>-I</strong>[<em>scale</em>|<strong>g</strong>]</dt>
-<dd>Integrate the field, i.e., compute integral_over_z (field * dz).
-This is equivalent to divide by kr in the frequency domain (kr is
-radial wave number). Append a scale to divide by (kr * <em>scale</em>)
-instead. Alternatively, append <strong>g</strong> to indicate that your data set
-is gravity anomalies in mGal and output should be geoid heights in
-meters. [Default is no scale].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-N</strong>[<strong>f</strong>|<strong>q</strong>|<strong>s</strong>|<em>nx/ny</em>][<strong>+a</strong>|[<strong>+d</strong>|<strong>h</strong>|<strong>l</strong>][<strong>+e</strong>|<strong>n</strong>|<strong>m</strong>][<strong>+t</strong><em>width</em>][<strong>+w</strong>[<em>suffix</em>]][<strong>+z</strong>[<strong>p</strong>]]</dt>
-<dd><p class="first">Choose or inquire about suitable grid dimensions for FFT and set
-optional parameters. Control the FFT dimension:</p>
-<blockquote>
-<div><p><strong>-Nf</strong> will force the FFT to use the actual dimensions of the data.</p>
-<p><strong>-Nq</strong> will inQuire about more suitable dimensions, report those, then continue.</p>
-<p><strong>-Ns</strong> will present a list of optional dimensions, then exit.</p>
-<p><strong>-N</strong><em>nx/ny</em> will do FFT on array size <em>nx/ny</em> (must be >= grid file size). Default chooses
-dimensions >= data which optimize speed and accuracy of FFT. If FFT
-dimensions > grid file dimensions, data are extended and tapered to zero.</p>
-</div></blockquote>
-<p>Control detrending of data: Append modifiers for removing a linear trend:</p>
-<blockquote>
-<div><p><strong>+d</strong>: Detrend data, i.e. remove best-fitting linear trend [Default].</p>
-<p><strong>+a</strong>: Only remove mean value.</p>
-<p><strong>+h</strong>: Only remove mid value, i.e. 0.5 * (max + min).</p>
-<p><strong>+l</strong>: Leave data alone.</p>
-</div></blockquote>
-<p>Control extension and tapering of data:
-Use modifiers to control how the extension and tapering are to be performed:</p>
-<blockquote>
-<div><p><strong>+e</strong> extends the grid by imposing edge-point symmetry [Default],</p>
-<p><strong>+m</strong> extends the grid by imposing edge mirror symmetry</p>
-<p><strong>+n</strong> turns off data extension.</p>
-<p>Tapering is performed from the data edge to the FFT grid edge [100%].
-Change this percentage via <strong>+t</strong><em>width</em>. When <strong>+n</strong> is in effect,
-the tapering is applied instead to the data margins as no extension is
-available [0%].</p>
-</div></blockquote>
-<p class="last">Control writing of temporary results:
-For detailed investigation you can write the intermediate grid being passed
-to the forward FFT; this is likely to have been detrended, extended by
-point-symmetry along all edges, and tapered. Append <strong>+w</strong>[<em>suffix</em>] from
-which output file name(s) will be created (i.e., <em>ingrid_prefix.ext</em>)
-[tapered], where <em>ext</em> is your file extension. Finally, you may save
-the complex grid produced by the forward FFT by appending <strong>+z</strong>. By
-default we write the real and imaginary components to
-<em>ingrid</em>_*real* <em>ext</em> and <em>ingrid</em>_imag.<em>ext</em>. Append
-<strong>p</strong> to save instead the polar form of magnitude and phase to files
-<em>ingrid</em>_mag.<em>ext</em> and <em>ingrid</em>_phase.<em>ext</em>.</p>
-</dd>
-<dt><strong>-S</strong><em>scale</em></dt>
-<dd>Multiply each element by <em>scale</em> in the space domain (after the
-frequency domain operations). [Default is 1.0].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-fg</strong></dt>
-<dd>Geographic grids (dimensions of longitude, latitude) will be converted to
-meters via a “Flat Earth” approximation using the current ellipsoid parameters.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="grid-file-formats">
-<h2>Grid File Formats<a class="headerlink" href="#grid-file-formats" title="Permalink to this headline">¶</a></h2>
-<p>By default GMT writes out grid as single precision floats in a
-COARDS-complaint netCDF file format. However, GMT is able to produce
-grid files in many other commonly used grid file formats and also
-facilitates so called “packing” of grids, writing out floating point
-data as 1- or 2-byte integers. To specify the precision, scale and
-offset, the user should add the suffix
-<strong>=</strong><em>id</em>[<strong>/</strong><em>scale</em><strong>/</strong><em>offset</em>[<strong>/</strong><em>nan</em>]], where
-<em>id</em> is a two-letter identifier of the grid type and precision, and
-<em>scale</em> and <em>offset</em> are optional scale factor and offset to be applied
-to all grid values, and <em>nan</em> is the value used to indicate missing
-data. When reading grids, the format is generally automatically
-recognized. If not, the same suffix can be added to input grid file
-names. See <a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section
-<a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a>
-of the GMT Technical Reference and Cookbook for more information.</p>
-<p>When reading a netCDF file that contains multiple grids, GMT will
-read, by default, the first 2-dimensional grid that can find in that
-file. To coax GMT into reading another multi-dimensional variable in
-the grid file, append <strong>?</strong><em>varname</em> to the file name, where <em>varname</em>
-is the name of the variable. Note that you may need to escape the
-special meaning of <strong>?</strong> in your shell program by putting a backslash in
-front of it, or by placing the filename and suffix between quotes or
-double quotes. The <strong>?</strong><em>varname</em> suffix can also be used for output
-grids to specify a variable name different from the default: “z”. See
-<a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section <a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a> of the GMT
-Technical Reference and Cookbook for more information, particularly on
-how to read splices of 3-, 4-, or 5-dimensional grids.</p>
-</div>
-<div class="section" id="grid-distance-units">
-<h2>Grid Distance Units<a class="headerlink" href="#grid-distance-units" title="Permalink to this headline">¶</a></h2>
-<p>If the grid does not have meter as the horizontal unit, append <strong>+u</strong><em>unit</em> to the input file name to convert from the
-specified unit to meter. If your grid is geographic, convert distances to meters by supplying <strong>-fg</strong> instead.</p>
-</div>
-<div class="section" id="considerations">
-<h2>Considerations<a class="headerlink" href="#considerations" title="Permalink to this headline">¶</a></h2>
-<p>netCDF COARDS grids will automatically be recognized as geographic. For
-other grids geographical grids were you want to convert degrees into
-meters, select <strong>-fg</strong>. If the data are close to either pole, you should
-consider projecting the grid file onto a rectangular coordinate system
-using <a class="reference internal" href="grdproject.html"><em>grdproject</em></a></p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To upward continue the sea-level magnetic anomalies in the file
-mag_0.nc to a level 800 m above sealevel:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdfft mag_0.nc -C800 -V -Gmag_800.nc
-</pre></div>
-</div>
-</div></blockquote>
-<p>To transform geoid heights in m (geoid.nc) on a geographical grid to
-free-air gravity anomalies in mGal:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdfft geoid.nc -Dg -V -Ggrav.nc
-</pre></div>
-</div>
-</div></blockquote>
-<p>To transform gravity anomalies in mGal (faa.nc) to deflections of the
-vertical (in micro-radians) in the 038 direction, we must first
-integrate gravity to get geoid, then take the directional derivative,
-and finally scale radians to micro-radians:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdfft faa.nc -Ig -A38 -S1e6 -V -Gdefl_38.nc
-</pre></div>
-</div>
-</div></blockquote>
-<p>Second vertical derivatives of gravity anomalies are related to the
-curvature of the field. We can compute these as mGal/m^2 by
-differentiating twice:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdfft gravity.nc -D -D -V -Ggrav_2nd_derivative.nc
-</pre></div>
-</div>
-</div></blockquote>
-<p>To compute cross-spectral estimates for co-registered bathymetry and
-gravity grids, and report result as functions of wavelengths in km, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdfft bathymetry.nc gravity.grd -Ewk -fg -V > cross_spectra.txt
-</pre></div>
-</div>
-</div></blockquote>
-<p>To examine the pre-FFT grid after detrending, point-symmetry reflection,
-and tapering has been applied, as well as saving the real and imaginary
-components of the raw spectrum of the data in topo.nc, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdfft topo.nc -N+w+z -fg -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>You can now make plots of the data in topo_taper.nc, topo_real.nc, and topo_imag.nc.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="grdedit.html"><em>grdedit</em></a>,
-<a class="reference internal" href="grdfilter.html"><em>grdfilter</em></a>,
-<a class="reference internal" href="grdmath.html"><em>grdmath</em></a>,
-<a class="reference internal" href="grdproject.html"><em>grdproject</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grdfft</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#grid-file-formats">Grid File Formats</a></li>
-<li><a class="reference internal" href="#grid-distance-units">Grid Distance Units</a></li>
-<li><a class="reference internal" href="#considerations">Considerations</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grdedit.html"
- title="previous chapter">grdedit</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grdfilter.html"
- title="next chapter">grdfilter</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/grdfft.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grdfilter.html" title="grdfilter"
- >next</a> </li>
- <li class="right" >
- <a href="grdedit.html" title="grdedit"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" >GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/grdfilter.html b/doc_release/html/grdfilter.html
deleted file mode 100644
index 4adaa1a..0000000
--- a/doc_release/html/grdfilter.html
+++ /dev/null
@@ -1,385 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grdfilter — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GR" href="GR.html" />
- <link rel="next" title="grdgradient" href="grdgradient.html" />
- <link rel="prev" title="grdfft" href="grdfft.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grdgradient.html" title="grdgradient"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grdfft.html" title="grdfft"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" accesskey="U">GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grdfilter">
-<span id="index-0"></span><h1>grdfilter<a class="headerlink" href="#grdfilter" title="Permalink to this headline">¶</a></h1>
-<p>grdfilter - Filter a grid in the space (or time) domain</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdfilter</strong> <em>ingrid</em> <strong>-D</strong><em>distance_flag</em>
-<strong>-Fx</strong><em>width</em>[/<em>width2</em>][<em>mode</em>][<strong>+q</strong><em>quantile</em>]
-<strong>-G</strong><em>outgrid</em>
-[ <strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]] ]
-[ <strong>-N</strong><strong>i</strong>|<strong>p</strong>|<strong>r</strong> ]
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ] [ <strong>-T</strong> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdfilter</strong> will filter a <em>.nc</em> file in the time domain using one of
-the selected convolution or non-convolution isotropic or rectangular
-filters and compute distances using Cartesian or Spherical geometries.
-The output <em>.nc</em> file can optionally be generated as a sub-region of the
-input (via <strong>-R</strong>) and/or with new increment (via <strong>-I</strong>) or
-registration (via <strong>-T</strong>). In this way, one may have “extra space” in
-the input data so that the edges will not be used and the output can be
-within one-half- width of the input edges. If the filter is low-pass,
-then the output may be less frequently sampled than the input.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>ingrid</em></dt>
-<dd>The grid file of points to be filtered. (See GRID FILE FORMATS below).</dd>
-<dt><strong>-D</strong><em>distance_flag</em></dt>
-<dd><p class="first">Distance <em>flag</em> tells how grid (x,y) relates to filter <em>width</em> as
-follows:</p>
-<p><em>flag</em> = p: grid (px,py) with <em>width</em> an odd number of pixels;
-Cartesian distances.</p>
-<p><em>flag</em> = 0: grid (x,y) same units as <em>width</em>, Cartesian distances.</p>
-<p><em>flag</em> = 1: grid (x,y) in degrees, <em>width</em> in kilometers, Cartesian
-distances.</p>
-<p><em>flag</em> = 2: grid (x,y) in degrees, <em>width</em> in km, dx scaled by
-cos(middle y), Cartesian distances.</p>
-<p>The above options are fastest because they allow weight matrix to be
-computed only once. The next three options are slower because they
-recompute weights for each latitude.</p>
-<p><em>flag</em> = 3: grid (x,y) in degrees, <em>width</em> in km, dx scaled by
-cosine(y), Cartesian distance calculation.</p>
-<p><em>flag</em> = 4: grid (x,y) in degrees, <em>width</em> in km, Spherical distance
-calculation.</p>
-<p class="last"><em>flag</em> = 5: grid (x,y) in Mercator <strong>-Jm</strong>1 img units, <em>width</em> in
-km, Spherical distance calculation.</p>
-</dd>
-<dt><strong>-Fx</strong><em>width</em>[/<em>width2</em>][<em>mode</em>]</dt>
-<dd><p class="first">Sets the filter type. Choose among convolution and non-convolution
-filters. Use any filter code <strong>x</strong> (listed below) followed by the full
-diameter <em>width</em>. This gives an isotropic filter; append /<em>width2</em>
-for a rectangular filter (requires <strong>-Dp</strong> or <strong>-D0</strong>).</p>
-<p>Convolution filters (and their codes) are:</p>
-<p>(<strong>b</strong>) Boxcar: All weights are equal.</p>
-<p>(<strong>c</strong>) Cosine Arch: Weights follow a cosine arch curve.</p>
-<p>(<strong>g</strong>) Gaussian: Weights are given by the Gaussian function, where
-<em>width</em> is 6 times the conventional Gaussian sigma.</p>
-<p>(<strong>f</strong>) Custom: Weights are given by the precomputed values in the
-filter weight grid file <em>weight</em>, which must have odd dimensions;
-also requires <strong>-D0</strong> and output spacing must match input spacing or
-be integer multiples.</p>
-<p>(<strong>o</strong>) Operator: Weights are given by the precomputed values in the
-filter weight grid file <em>weight</em>, which must have odd dimensions;
-also requires <strong>-D0</strong> and output spacing must match input spacing or
-be integer multiples. Weights are assumed to sum to zero so no
-accumulation of weight sums and normalization will be done.</p>
-<p>Non-convolution filters (and their codes) are:</p>
-<p>(<strong>m</strong>) Median: Returns median value. To select another quantile
-append <strong>+q</strong><em>quantile</em> in the 0-1 range [Default is 0.5, i.e., median].</p>
-<p>(<strong>p</strong>) Maximum likelihood probability (a mode estimator): Return
-modal value. If more than one mode is found we return their average
-value. Append <strong>-</strong> or <strong>+</strong> to the filter width if you rather want
-to return the smallest or largest of the modal values. By mode we mean
-the least median of squares approximation to the mode.</p>
-<p>(<strong>l</strong>) Lower: Return the minimum of all values.</p>
-<p>(<strong>L</strong>) Lower: Return minimum of all positive values only.</p>
-<p>(<strong>u</strong>) Upper: Return maximum of all values.</p>
-<p>(<strong>U</strong>) Upper: Return maximum or all negative values only.</p>
-<p class="last">In the case of <strong>L</strong>|<strong>U</strong> it is possible that no data passes
-the initial sign test; in that case the filter will return NaN.</p>
-</dd>
-<dt><strong>-G</strong><em>outgrid</em></dt>
-<dd><em>outgrid</em> is the output grid file of the filter. (See GRID FILE FORMATS below).</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]</dt>
-<dd><em>x_inc</em> [and optionally <em>y_inc</em>] is the output Increment. Append
-<strong>m</strong> to indicate arc minutes, or <strong>s</strong> to indicate arc seconds. If
-the new <em>x_inc</em>, <em>y_inc</em> are NOT integer multiples of the old ones
-(in the input data), filtering will be considerably slower.
-[Default: Same as input.]</dd>
-<dt><strong>-N</strong><strong>i</strong>|<strong>p</strong>|<strong>r</strong></dt>
-<dd>Determine how NaN-values in the input grid affects the filtered
-output: Append <strong>i</strong> to ignore all NaNs in the calculation of
-filtered value [Default], <strong>r</strong> is same as <strong>i</strong> except if the input
-node was NaN then the output node will be set to NaN (only applies
-if both grids are co-registered), and <strong>p</strong> which will force the
-filtered value to be NaN if any grid-nodes with NaN-values are found
-inside the filter circle.</dd>
-<dt><strong>-R</strong></dt>
-<dd><em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> defines the Region of the
-output points. [Default: Same as input.]</dd>
-<dt><strong>-T</strong></dt>
-<dd>Toggle the node registration for the output grid so as to become the
-opposite of the input grid [Default gives the same registration as
-the input grid].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="grid-file-formats">
-<h2>Grid File Formats<a class="headerlink" href="#grid-file-formats" title="Permalink to this headline">¶</a></h2>
-<p>By default GMT writes out grid as single precision floats in a
-COARDS-complaint netCDF file format. However, GMT is able to produce
-grid files in many other commonly used grid file formats and also
-facilitates so called “packing” of grids, writing out floating point
-data as 1- or 2-byte integers. To specify the precision, scale and
-offset, the user should add the suffix
-<strong>=</strong><em>id</em>[<strong>/</strong><em>scale</em><strong>/</strong><em>offset</em>[<strong>/</strong><em>nan</em>]], where
-<em>id</em> is a two-letter identifier of the grid type and precision, and
-<em>scale</em> and <em>offset</em> are optional scale factor and offset to be applied
-to all grid values, and <em>nan</em> is the value used to indicate missing
-data. When reading grids, the format is generally automatically
-recognized. If not, the same suffix can be added to input grid file
-names. See <a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section
-<a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a>
-of the GMT Technical Reference and Cookbook for more information.</p>
-<p>When reading a netCDF file that contains multiple grids, GMT will
-read, by default, the first 2-dimensional grid that can find in that
-file. To coax GMT into reading another multi-dimensional variable in
-the grid file, append <strong>?</strong><em>varname</em> to the file name, where <em>varname</em>
-is the name of the variable. Note that you may need to escape the
-special meaning of <strong>?</strong> in your shell program by putting a backslash in
-front of it, or by placing the filename and suffix between quotes or
-double quotes. The <strong>?</strong><em>varname</em> suffix can also be used for output
-grids to specify a variable name different from the default: “z”. See
-<a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section <a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a> of the GMT
-Technical Reference and Cookbook for more information, particularly on
-how to read splices of 3-, 4-, or 5-dimensional grids.</p>
-</div>
-<div class="section" id="geographical-and-time-coordinates">
-<h2>Geographical And Time Coordinates<a class="headerlink" href="#geographical-and-time-coordinates" title="Permalink to this headline">¶</a></h2>
-<p>When the output grid type is netCDF, the coordinates will be labeled
-“longitude”, “latitude”, or “time” based on the attributes of the input
-data or grid (if any) or on the <strong>-f</strong> or <strong>-R</strong> options. For example,
-both <strong>-f0x</strong> <strong>-f1t</strong> and <strong>-R</strong>90w/90e/0t/3t will result in a
-longitude/time grid. When the x, y, or z coordinate is time, it will be
-stored in the grid as relative time since epoch as specified by
-<a class="reference internal" href="gmt.conf.html#time-unit"><em>TIME_UNIT</em></a> and <a class="reference internal" href="gmt.conf.html#time-epoch"><em>TIME_EPOCH</em></a> in the
-<a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file or on the
-command line. In addition, the <strong>unit</strong> attribute of the time variable
-will indicate both this unit and epoch.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>Suppose that north_pacific_etopo5.nc is a file of 5 minute bathymetry
-from 140E to 260E and 0N to 50N, and you want to find the medians of
-values within a 300km radius (600km full width) of the output points,
-which you choose to be from 150E to 250E and 10N to 40N, and you want
-the output values every 0.5 degree. Using spherical distance
-calculations, you need:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdfilter north_pacific_etopo5.nc -Gfiltered_pacific.nc -Fm600 \
- -D4 -R150/250/10/40 -I0.5 -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>If we instead wanted a high-pass result then one can perform the
-corresponding low-pass filter using a coarse grid interval as grdfilter
-will resample the result to the same resolution as the input grid so we
-can compute the residuals, e.g.,</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdfilter north_pacific_etopo5.nc -Gresidual_pacific.nc -Fm-600 \
- -D4 -R150/250/10/40 -I0.5 -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>Here, the residual_pacific.nc grid will have the same 5 minute
-resolution as the original.</p>
-<p>To filter the dataset in ripples.nc using a custom anisotropic Gaussian
-filter exp (-0.5*r^2) whose distances r from the center is given by
-(2x^2 + y^2 -2xy)/6, with major axis at an angle of 63 degrees with the
-horizontal, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdmath -R-10/10/-10/10 -I1 X 2 POW 2 MUL Y 2 POW ADD X Y MUL 2 MUL \
- SUB 6 DIV NEG 2 DIV EXP DUP SUM DIV = gfilter.nc
-gmt grdfilter ripples.nc -Ffgfilter.nc -D0 -Gsmooth.nc -V
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="limitations">
-<h2>Limitations<a class="headerlink" href="#limitations" title="Permalink to this headline">¶</a></h2>
-<p>To use the <strong>-D</strong>5 option the input Mercator grid must be created by
-img2mercgrd using the <strong>-C</strong> option so the origin of the y-values is the
-Equator (i.e., x = y = 0 correspond to lon = lat = 0).</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="grdfft.html"><em>grdfft</em></a> <a class="reference internal" href="supplements/img/img2grd.html"><em>img2grd</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grdfilter</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#grid-file-formats">Grid File Formats</a></li>
-<li><a class="reference internal" href="#geographical-and-time-coordinates">Geographical And Time Coordinates</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#limitations">Limitations</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grdfft.html"
- title="previous chapter">grdfft</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grdgradient.html"
- title="next chapter">grdgradient</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/grdfilter.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grdgradient.html" title="grdgradient"
- >next</a> </li>
- <li class="right" >
- <a href="grdfft.html" title="grdfft"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" >GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/grdgradient.html b/doc_release/html/grdgradient.html
deleted file mode 100644
index 6027e62..0000000
--- a/doc_release/html/grdgradient.html
+++ /dev/null
@@ -1,373 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grdgradient — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GR" href="GR.html" />
- <link rel="next" title="grdhisteq" href="grdhisteq.html" />
- <link rel="prev" title="grdfilter" href="grdfilter.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grdhisteq.html" title="grdhisteq"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grdfilter.html" title="grdfilter"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" accesskey="U">GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grdgradient">
-<span id="index-0"></span><h1>grdgradient<a class="headerlink" href="#grdgradient" title="Permalink to this headline">¶</a></h1>
-<p>grdgradient - Compute directional derivative or gradient from a grid</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdgradient</strong> <em>in_grdfile</em> <strong>-G</strong><em>out_grdfile</em>
-[ <strong>-A</strong><em>azim</em>[/<em>azim2</em>] ] [ <strong>-D</strong>[<strong>c</strong>][<strong>o</strong>][<strong>n</strong>] ]
-[ <strong>-E</strong>[<strong>s|p</strong>]<em>azim/elev</em>[/<em>ambient</em>/<em>diffuse</em>/<em>specular</em>/<em>shine</em>] ]
-[ <strong>-L</strong><em>flag</em> ]
-[ <strong>-N</strong>[<strong>e</strong>][<strong>t</strong>][<em>amp</em>][/<em>sigma</em>[/<em>offset</em>]] ]
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ] [ <strong>-S</strong><em>slopefile</em> ]
-[ <strong>-V</strong>[<em>level</em>] ] [ <strong>-fg</strong> ]
-[ <strong>-n</strong>[<strong>b</strong>|<strong>c</strong>|<strong>l</strong>|<strong>n</strong>][<strong>+a</strong>][<strong>+b</strong><em>BC</em>][<strong>+t</strong><em>threshold</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdgradient</strong> may be used to compute the directional derivative in a
-given direction (<strong>-A</strong>), or the direction (<strong>-S</strong>) [and the magnitude
-(<strong>-D</strong>)] of the vector gradient of the data.</p>
-<p>Estimated values in the first/last row/column of output depend on
-boundary conditions (see <strong>-L</strong>).</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>in_grdfile</em></dt>
-<dd>2-D grid file from which to compute directional derivative. (See
-GRID FILE FORMATS below).</dd>
-<dt><strong>-G</strong><em>out_grdfile</em></dt>
-<dd>Name of the output grid file for the directional derivative. (See
-GRID FILE FORMATS below).</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong><em>azim</em>[/<em>azim2</em>]</dt>
-<dd>Azimuthal direction for a directional derivative; <em>azim</em> is the
-angle in the x,y plane measured in degrees positive clockwise from
-north (the +y direction) toward east (the +x direction). The
-negative of the directional derivative, -[dz/dx*sin(<em>azim</em>) +
-dz/dy*cos(<em>azim</em>)], is found; negation yields positive values
-when the slope of z(x,y) is downhill in the <em>azim</em> direction, the
-correct sense for shading the illumination of an image (see
-<a class="reference internal" href="grdimage.html"><em>grdimage</em></a> and <a class="reference internal" href="grdview.html"><em>grdview</em></a>) by a light source above the x,y plane
-shining from the <em>azim</em> direction. Optionally, supply two azimuths,
-<strong>-A</strong><em>azim</em>/<em>azim2</em>, in which case the gradients in each of these
-directions are calculated and the one larger in magnitude is
-retained; this is useful for illuminating data with two directions
-of lineated structures, e.g., <strong>-A</strong><em>0</em>/<em>270</em> illuminates from the
-north (top) and west (left).</dd>
-<dt><strong>-D</strong>[<strong>c</strong>][<strong>o</strong>][<strong>n</strong>]</dt>
-<dd>Find the direction of the gradient of the data. By default, the
-directions are measured clockwise from north, as <em>azim</em> in <strong>-A</strong>
-above. Append <strong>c</strong> to use conventional Cartesian angles measured
-counterclockwise from the positive x (east) direction. Append <strong>o</strong>
-to report orientations (0-180) rather than directions (0-360).
-Append <strong>n</strong> to add 90 degrees to all angles (e.g., to give
-orientation of lineated features). Unlike <strong>-A</strong>, here we return
-the up-slope direction of the gradient.</dd>
-<dt><strong>-E</strong>[<strong>s|p</strong>]<em>azim/elev</em>[/<em>ambient</em>/<em>diffuse</em>/<em>specular</em>/<em>shine</em>]</dt>
-<dd>Compute Lambertian radiance appropriate to use with <a class="reference internal" href="grdimage.html"><em>grdimage</em></a> and <a class="reference internal" href="grdview.html"><em>grdview</em></a>.
-The Lambertian Reflection assumes an ideal surface that
-reflects all the light that strikes it and the surface appears
-equally bright from all viewing directions. <em>azim</em> and <em>elev</em> are
-the azimuth and elevation of light vector. Optionally, supply
-<em>ambient</em> <em>diffuse</em> <em>specular</em> <em>shine</em> which are parameters that
-control the reflectance properties of the surface. Default values
-are: <em>0.55</em>/<em>0.6</em>/<em>0.4</em>/<em>10</em> To leave some of the values untouched,
-specify = as the new value. For example <strong>-E</strong><em>60</em>/<em>30</em>/<em>=</em>/<em>0.5</em>
-sets the <em>azim</em> <em>elev</em> and <em>diffuse</em> to 60, 30 and 0.5 and leaves
-the other reflectance parameters untouched. Append <strong>s</strong> to use a
-simpler Lambertian algorithm. Note that with this form you only have
-to provide the azimuth and elevation parameters. Append <strong>p</strong> to use
-the Peucker piecewise linear approximation (simpler but faster
-algorithm; in this case the <em>azim</em> and <em>elev</em> are hardwired to 315
-and 45 degrees. This means that even if you provide other values
-they will be ignored.)</dd>
-<dt><strong>-L</strong><em>flag</em></dt>
-<dd>Boundary condition <em>flag</em> may be <em>x</em> or <em>y</em> or <em>xy</em> indicating data
-is periodic in range of x or y or both, or <em>flag</em> may be <em>g</em>
-indicating geographical conditions (x and y are lon and lat).
-[Default uses “natural” conditions (second partial derivative normal
-to edge is zero).]</dd>
-<dt><strong>-N</strong>[<strong>e</strong>][<strong>t</strong>][<em>amp</em>][/<em>sigma</em>[/<em>offset</em>]]</dt>
-<dd>Normalization. [Default: no normalization.] The actual gradients <em>g</em>
-are offset and scaled to produce normalized gradients <em>gn</em> with a
-maximum output magnitude of <em>amp</em>. If <em>amp</em> is not given, default
-<em>amp</em> = 1. If <em>offset</em> is not given, it is set to the average of
-<em>g</em>. <strong>-N</strong> yields <em>gn</em> = <em>amp</em> * (<em>g</em> - <em>offset</em>)/max(abs(<em>g</em> -
-<em>offset</em>)). <strong>-Ne</strong> normalizes using a cumulative Laplace
-distribution yielding <em>gn</em> = <em>amp</em> * (1.0 -
-exp(sqrt(2) * (<em>g</em> - <em>offset</em>)/ <em>sigma</em>)) where
-<em>sigma</em> is estimated using the L1 norm of (<em>g</em> - <em>offset</em>) if it is
-not given. <strong>-Nt</strong> normalizes using a cumulative Cauchy distribution
-yielding <em>gn</em> = (2 * <em>amp</em> / PI) * atan( (<em>g</em> - <em>offset</em>)/
-<em>sigma</em>) where <em>sigma</em> is estimated using the L2 norm of (<em>g</em> -
-<em>offset</em>) if it is not given.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. Using the <strong>-R</strong> option
-will select a subsection of <em>in_grdfile</em> grid. If this subsection
-exceeds the boundaries of the grid, only the common region will be extracted.</dd>
-<dt><strong>-S</strong><em>slopefile</em></dt>
-<dd>Name of output grid file with scalar magnitudes of gradient vectors.
-Requires <strong>-D</strong> but makes <strong>-G</strong> optional.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-fg</strong></dt>
-<dd>Geographic grids (dimensions of longitude, latitude) will be converted to
-meters via a “Flat Earth” approximation using the current ellipsoid parameters.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-n</strong>[<strong>b</strong>|<strong>c</strong>|<strong>l</strong>|<strong>n</strong>][<strong>+a</strong>][<strong>+b</strong><em>BC</em>][<strong>+c</strong>][<strong>+t</strong><em>threshold</em>] <a class="reference internal" href="gmt.html#n-full"><em>(more ...)</em></a></dt>
-<dd>Select interpolation mode for grids.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="grid-distance-units">
-<h2>Grid Distance Units<a class="headerlink" href="#grid-distance-units" title="Permalink to this headline">¶</a></h2>
-<p>If the grid does not have meter as the horizontal unit, append <strong>+u</strong><em>unit</em> to the input file name to convert from the
-specified unit to meter. If your grid is geographic, convert distances to meters by supplying <strong>-fg</strong> instead.</p>
-</div>
-<div class="section" id="hints">
-<h2>Hints<a class="headerlink" href="#hints" title="Permalink to this headline">¶</a></h2>
-<p>If you don’t know what <strong>-N</strong> options to use to make an intensity file
-for <a class="reference internal" href="grdimage.html"><em>grdimage</em></a> or <a class="reference internal" href="grdview.html"><em>grdview</em></a>, a good first try is <strong>-Ne</strong>0.6.</p>
-<p>Usually 255 shades are more than enough for visualization purposes. You
-can save 75% disk space by appending =nb/a to the output filename
-<em>out_grdfile</em>.</p>
-<p>If you want to make several illuminated maps of subregions of a large
-data set, and you need the illumination effects to be consistent across
-all the maps, use the <strong>-N</strong> option and supply the same value of <em>sigma</em>
-and <em>offset</em> to <strong>grdgradient</strong> for each map. A good guess is <em>offset</em> =
-0 and <em>sigma</em> found by <strong>grdinfo</strong> <strong>-L2</strong> or <strong>-L1</strong> applied to an
-unnormalized gradient grd.</p>
-<p>If you simply need the <em>x</em>- or <em>y</em>-derivatives of the grid, use <a class="reference internal" href="grdmath.html"><em>grdmath</em></a>.</p>
-</div>
-<div class="section" id="grid-file-formats">
-<h2>Grid File Formats<a class="headerlink" href="#grid-file-formats" title="Permalink to this headline">¶</a></h2>
-<p>By default GMT writes out grid as single precision floats in a
-COARDS-complaint netCDF file format. However, GMT is able to produce
-grid files in many other commonly used grid file formats and also
-facilitates so called “packing” of grids, writing out floating point
-data as 1- or 2-byte integers. To specify the precision, scale and
-offset, the user should add the suffix
-<strong>=</strong><em>id</em>[<strong>/</strong><em>scale</em><strong>/</strong><em>offset</em>[<strong>/</strong><em>nan</em>]], where
-<em>id</em> is a two-letter identifier of the grid type and precision, and
-<em>scale</em> and <em>offset</em> are optional scale factor and offset to be applied
-to all grid values, and <em>nan</em> is the value used to indicate missing
-data. When reading grids, the format is generally automatically
-recognized. If not, the same suffix can be added to input grid file
-names. See <a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section
-<a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a>
-of the GMT Technical Reference and Cookbook for more information.</p>
-<p>When reading a netCDF file that contains multiple grids, GMT will
-read, by default, the first 2-dimensional grid that can find in that
-file. To coax GMT into reading another multi-dimensional variable in
-the grid file, append <strong>?</strong><em>varname</em> to the file name, where <em>varname</em>
-is the name of the variable. Note that you may need to escape the
-special meaning of <strong>?</strong> in your shell program by putting a backslash in
-front of it, or by placing the filename and suffix between quotes or
-double quotes. The <strong>?</strong><em>varname</em> suffix can also be used for output
-grids to specify a variable name different from the default: “z”. See
-<a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section <a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a> of the GMT
-Technical Reference and Cookbook for more information, particularly on
-how to read splices of 3-, 4-, or 5-dimensional grids.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To make a file for illuminating the data in geoid.nc using exp-
-normalized gradients in the range [-0.6,0.6] imitating light sources in
-the north and west directions:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdgradient geoid.nc -A0/270 -Ggradients.nc=nb/a -Ne0.6 -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>To find the azimuth orientations of seafloor fabric in the file topo.nc:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdgradient topo.nc -Dno -Gazimuths.nc -V
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>Horn, B.K.P., Hill-Shading and the Reflectance Map, Proceedings of the
-IEEE, Vol. 69, No. 1, January 1981, pp. 14-47.
-(<a class="reference external" href="http://people.csail.mit.edu/bkph/papers/Hill-Shading.pdf">http://people.csail.mit.edu/bkph/papers/Hill-Shading.pdf</a>)</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>
-<a class="reference internal" href="grdhisteq.html"><em>grdhisteq</em></a>,
-<a class="reference internal" href="grdmath.html"><em>grdmath</em></a>,
-<a class="reference internal" href="grdimage.html"><em>grdimage</em></a>, <a class="reference internal" href="grdview.html"><em>grdview</em></a>,
-<a class="reference internal" href="grdvector.html"><em>grdvector</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grdgradient</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#grid-distance-units">Grid Distance Units</a></li>
-<li><a class="reference internal" href="#hints">Hints</a></li>
-<li><a class="reference internal" href="#grid-file-formats">Grid File Formats</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grdfilter.html"
- title="previous chapter">grdfilter</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grdhisteq.html"
- title="next chapter">grdhisteq</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/grdgradient.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grdhisteq.html" title="grdhisteq"
- >next</a> </li>
- <li class="right" >
- <a href="grdfilter.html" title="grdfilter"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" >GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/grdhisteq.html b/doc_release/html/grdhisteq.html
deleted file mode 100644
index 8236ad1..0000000
--- a/doc_release/html/grdhisteq.html
+++ /dev/null
@@ -1,324 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grdhisteq — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GR" href="GR.html" />
- <link rel="next" title="grdimage" href="grdimage.html" />
- <link rel="prev" title="grdgradient" href="grdgradient.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grdimage.html" title="grdimage"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grdgradient.html" title="grdgradient"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" accesskey="U">GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grdhisteq">
-<span id="index-0"></span><h1>grdhisteq<a class="headerlink" href="#grdhisteq" title="Permalink to this headline">¶</a></h1>
-<p>grdhisteq - Perform histogram equalization for a grid</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdhisteq</strong> <em>in_grdfile</em> [ <strong>-G</strong><em>out_grdfile</em> ]
-[ <strong>-C</strong><em>n_cells</em> ] [ <strong>-D</strong>[<em>file</em>] ] [ <strong>-N</strong>[<em>norm</em>] ]
-[ <strong>-Q</strong> ]
-<strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>]
-<strong>-V</strong>[<em>level</em>]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdhisteq</strong> allows the user to find the data values which divide a
-given grid file into patches of equal area. One common use of
-<strong>grdhisteq</strong> is in a kind of histogram equalization of an image. In
-this application, the user might have a grid of flat topography with a
-mountain in the middle. Ordinary gray shading of this file (using
-grdimage/grdview) with a linear mapping from topography to graytone will
-result in most of the image being very dark gray, with the mountain
-being almost white. One could use <strong>grdhisteq</strong> to write to stdout or file an
-ASCII list of those data values which divide the range of the data into
-<em>n_cells</em> segments, each of which has an equal area in the image. Using
-<strong>awk</strong> or <a class="reference internal" href="makecpt.html"><em>makecpt</em></a> one can take this output and build a cpt file;
-using the cptfile with grdimage will result in an image with all levels
-of gray occurring equally. Alternatively, see <a class="reference internal" href="grd2cpt.html"><em>grd2cpt</em></a>.</p>
-<p>The second common use of <strong>grdhisteq</strong> is in writing a grid with
-statistics based on some kind of cumulative distribution function. In
-this application, the output has relative highs and lows in the same
-(x,y) locations as the input file, but the values are changed to reflect
-their place in some cumulative distribution. One example would be to
-find the lowest 10% of the data: Take a grid, run <strong>grdhisteq</strong> and make
-a grid using <em>n_cells</em> = 10, and then contour the result to trace the 1
-contour. This will enclose the lowest 10% of the data, regardless of
-their original values. Another example is in equalizing the output of
-<a class="reference internal" href="grdgradient.html"><em>grdgradient</em></a>. For shading purposes it is desired that the data have a
-smooth distribution, such as a Gaussian. If you run <strong>grdhisteq</strong> on
-output from <a class="reference internal" href="grdgradient.html"><em>grdgradient</em></a> and make a grid file output with the
-Gaussian option, you will have a grid whose values are distributed
-according to a Gaussian distribution with zero mean and unit variance.
-The locations of these values will correspond to the locations of the
-input; that is, the most negative output value will be in the (x,y)
-location of the most negative input value, and so on.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>in_grdfile</em></dt>
-<dd>2-D grid file to be equalized. (See GRID FILE FORMATS below).</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-C</strong><em>n_cells</em></dt>
-<dd>Sets how many cells (or divisions) of data range to make [16].</dd>
-<dt><strong>-D</strong></dt>
-<dd>Dump level information to <em>file</em>, or standard output if no file is
-provided.</dd>
-<dt><strong>-G</strong><em>out_grdfile</em></dt>
-<dd>Name of output 2-D grid file. Used with <strong>-N</strong> only. (See GRID FILE
-FORMATS below).</dd>
-<dt><strong>-N</strong>[<em>norm</em>]</dt>
-<dd>Gaussian output. Use with <strong>-G</strong> to make an output grid with
-standard normal scores. Append <em>norm</em> to force the scores to fall in
-the <-1,+1> range [Default is standard normal scores].</dd>
-<dt><strong>-Q</strong></dt>
-<dd>Use quadratic intensity scaling. [Default is linear].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. Using the <strong>-R</strong> option
-will select a subsection of <em>in_grdfile</em> grid. If this subsection
-exceeds the boundaries of the grid, only the common region will be extracted.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="grid-file-formats">
-<h2>Grid File Formats<a class="headerlink" href="#grid-file-formats" title="Permalink to this headline">¶</a></h2>
-<p>By default GMT writes out grid as single precision floats in a
-COARDS-complaint netCDF file format. However, GMT is able to produce
-grid files in many other commonly used grid file formats and also
-facilitates so called “packing” of grids, writing out floating point
-data as 1- or 2-byte integers. To specify the precision, scale and
-offset, the user should add the suffix
-<strong>=</strong><em>id</em>[<strong>/</strong><em>scale</em><strong>/</strong><em>offset</em>[<strong>/</strong><em>nan</em>]], where
-<em>id</em> is a two-letter identifier of the grid type and precision, and
-<em>scale</em> and <em>offset</em> are optional scale factor and offset to be applied
-to all grid values, and <em>nan</em> is the value used to indicate missing
-data. When reading grids, the format is generally automatically
-recognized. If not, the same suffix can be added to input grid file
-names. See <a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section
-<a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a>
-of the GMT Technical Reference and Cookbook for more information.</p>
-<p>When reading a netCDF file that contains multiple grids, GMT will
-read, by default, the first 2-dimensional grid that can find in that
-file. To coax GMT into reading another multi-dimensional variable in
-the grid file, append <strong>?</strong><em>varname</em> to the file name, where <em>varname</em>
-is the name of the variable. Note that you may need to escape the
-special meaning of <strong>?</strong> in your shell program by putting a backslash in
-front of it, or by placing the filename and suffix between quotes or
-double quotes. The <strong>?</strong><em>varname</em> suffix can also be used for output
-grids to specify a variable name different from the default: “z”. See
-<a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section <a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a> of the GMT
-Technical Reference and Cookbook for more information, particularly on
-how to read splices of 3-, 4-, or 5-dimensional grids.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To find the height intervals that divide the file heights.nc into 16
-divisions of equal area:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdhisteq heights.nc -C16 -D > levels.d
-</pre></div>
-</div>
-</div></blockquote>
-<p>To make the poorly distributed intensities in the file raw_intens.nc
-suitable for use with <a class="reference internal" href="grdimage.html"><em>grdimage</em></a> or <a class="reference internal" href="grdview.html"><em>grdview</em></a>, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdhisteq raw_intens.nc -Gsmooth_intens.nc -N -V
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="restrictions">
-<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
-<p>If you use <strong>grdhisteq</strong> to make a Gaussian output for gradient shading
-in <a class="reference internal" href="grdimage.html"><em>grdimage</em></a> or <a class="reference internal" href="grdview.html"><em>grdview</em></a>, you should be aware of the following:
-the output will be in the range [-x, x], where x is based on the number
-of data in the input grid (nx * ny) and the cumulative Gaussian
-distribution function F(x). That is, let N = nx * ny. Then x will be
-adjusted so that F(x) = (N - 1 + 0.5)/N. Since about 68% of the values
-from a standard normal distribution fall within +/- 1, this will be true
-of the output grid. But if N is very large, it is possible for x to be
-greater than 4. Therefore, with the <a class="reference internal" href="grdview.html"><em>grdview</em></a> program clipping
-gradients to the range [-1, 1], you will get correct shading of 68% of
-your data, while 16% of them will be clipped to -1 and 16% of them
-clipped to +1. If this makes too much of the image too light or too
-dark, you should take the output of <strong>grdhisteq</strong> and rescale it using
-<strong>grdmath</strong> and multiplying by something less than 1.0, to shrink the
-range of the values, thus bringing more than 68% of the image into the
-range [-1, 1]. Alternatively, supply a normalization factor with <strong>-N</strong>.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>,
-<a class="reference internal" href="grd2cpt.html"><em>grd2cpt</em></a>,
-<a class="reference internal" href="grdgradient.html"><em>grdgradient</em></a>,
-<a class="reference internal" href="grdimage.html"><em>grdimage</em></a>, <a class="reference internal" href="grdmath.html"><em>grdmath</em></a>,
-<a class="reference internal" href="grdview.html"><em>grdview</em></a>, <a class="reference internal" href="makecpt.html"><em>makecpt</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grdhisteq</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#grid-file-formats">Grid File Formats</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#restrictions">Restrictions</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grdgradient.html"
- title="previous chapter">grdgradient</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grdimage.html"
- title="next chapter">grdimage</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/grdhisteq.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grdimage.html" title="grdimage"
- >next</a> </li>
- <li class="right" >
- <a href="grdgradient.html" title="grdgradient"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" >GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/grdimage.html b/doc_release/html/grdimage.html
deleted file mode 100644
index 7bb2a36..0000000
--- a/doc_release/html/grdimage.html
+++ /dev/null
@@ -1,465 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grdimage — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GR" href="GR.html" />
- <link rel="next" title="grdinfo" href="grdinfo.html" />
- <link rel="prev" title="grdhisteq" href="grdhisteq.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grdinfo.html" title="grdinfo"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grdhisteq.html" title="grdhisteq"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" accesskey="U">GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grdimage">
-<span id="index-0"></span><h1>grdimage<a class="headerlink" href="#grdimage" title="Permalink to this headline">¶</a></h1>
-<p>grdimage - Project grids or images and plot them on maps</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdimage</strong> <em>grd_z</em> | <em>grd_r grd_g grd_b</em>
-[ <strong>-A</strong><em>out_img</em><strong>=</strong><em>driver</em> ] [ <strong>-C</strong><em>cptfile</em> ]
-[ <strong>-D</strong>[<strong>r</strong>] ] <strong>-J</strong><em>parameters</em>
-[ <strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] ]
-[ <strong>-G</strong>[<strong>f</strong>|<strong>b</strong>]<em>color</em> ] [ <strong>-I</strong><em>intensfile</em>|<em>intensity</em> ]
-[ <strong>-Jz</strong>|<strong>Z</strong><em>parameters</em> ] [ <strong>-K</strong> ] [ <strong>-M</strong> ] [ <strong>-N</strong> ]
-[ <strong>-O</strong> ] [ <strong>-P</strong> ] [ <strong>-Q</strong> ]
-[ <strong>-R</strong><em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>] ]
-[ <strong>-T</strong> ]
-[ <strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] ]
-[ <strong>-c</strong><em>copies</em> ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-n</strong>[<strong>b</strong>|<strong>c</strong>|<strong>l</strong>|<strong>n</strong>][<strong>+a</strong>][<strong>+b</strong><em>BC</em>][<strong>+t</strong><em>threshold</em>] ]
-[ <strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] ]
-[ <strong>-tr</strong> ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdimage</strong> reads one 2-D grid file and produces a gray-shaded (or
-colored) map by plotting rectangles centered on each grid node and
-assigning them a gray-shade (or color) based on the z-value.
-Alternatively, <strong>grdimage</strong> reads three 2-D grid files with the red,
-green, and blue components directly (all must be in the 0-255 range).
-Optionally, illumination may be added by providing a file with
-intensities in the (-1,+1) range. Values outside this range will be
-clipped. Such intensity files can be created from the grid using
-<a class="reference internal" href="grdgradient.html"><em>grdgradient</em></a> and, optionally, modified by <a class="reference internal" href="grdmath.html"><em>grdmath</em></a> or
-<a class="reference internal" href="grdhisteq.html"><em>grdhisteq</em></a>. Yet as a third alternative available when GMT is build
-with GDAL support the grd_z file can be an image referenced or not
-(than see <strong>-Dr</strong>). In this case the images can be illuminated with the
-file provided via the <strong>-I</strong> option. Here if image has no coordinates
-those of the intensity file will be used.</p>
-<p>When using map projections, the grid is first resampled on a new
-rectangular grid with the same dimensions. Higher resolution images can
-be obtained by using the <strong>-E</strong> option. To obtain the resampled value
-(and hence shade or color) of each map pixel, its location is inversely
-projected back onto the input grid after which a value is interpolated
-between the surrounding input grid values. By default bi-cubic
-interpolation is used. Aliasing is avoided by also forward projecting
-the input grid nodes. If two or more nodes are projected onto the same
-pixel, their average will dominate in the calculation of the pixel
-value. Interpolation and aliasing is controlled with the <strong>-n</strong> option.</p>
-<p>The <strong>-R</strong> option can be used to select a map region larger or smaller
-than that implied by the extent of the grid.</p>
-<p>A (color) PostScript file is output.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>grd_z</em> | <em>grd_r grd_g grd_b</em></dt>
-<dd>2-D gridded data set (or red, green, blue grids) to be imaged (See
-GRID FILE FORMATS below.)</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-J</strong><em>parameters</em> <a class="reference internal" href="gmt.html#j-full"><em>(more ...)</em></a></dt>
-<dd>Select map projection.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong><em>out_img</em><strong>=</strong><em>driver</em></dt>
-<dd>With GDAL aware versions: save image in a raster format instead of
-PostScript. Append <em>out_img</em><strong>=</strong><em>driver</em> to select the file
-name and image format. The <em>driver</em> is the driver code name used by
-GDAL. For example, <strong>-A</strong>img.tif=GTiff will write a GeoTiff image
-if the subset of GMT syntax projections that is currently possible
-to translate into the PROJ4 syntax allows it, or a plain tiff file
-otherwise. Note: any vector elements are lost.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> <a class="reference internal" href="gmt.html#b-full"><em>(more ...)</em></a></dt>
-<dd>Set map boundary intervals.</dd>
-<dt><strong>-C</strong><em>cptfile</em></dt>
-<dd>Name of the color palette table (for <em>grd_z</em> only). Alternatively,
-supply the name of a GMT color master CPT [rainbow] and let
-<strong>grdimage</strong> automatically determine a 16-level continuous CPT from
-the grid’s z-range.</dd>
-<dt><strong>-D</strong>[<strong>r</strong>]</dt>
-<dd>Specifies that the grid supplied is an image file to be read via
-GDAL. Obviously this option will work only with GMT versions
-built with GDAL support. The image can be indexed or true color
-(RGB) and can be an URL of a remotely located file. That is <strong>-D</strong>
-<a class="reference external" href="http://www.somewhere.com/image.jpg">http://www.somewhere.com/image.jpg</a>
-is a valid file syntax. Note, however, that to use it this way you
-must not be blocked by a proxy. If you are, chances are good that it
-can work by setting the environmental variable
-<em>http_proxy</em> with the value ‘your_proxy:port’ Append
-<strong>r</strong> to use the region specified by <strong>-R</strong> to apply to the image.
-For example, if you have used <strong>-Rd</strong> then the image will be
-assigned the limits of a global domain. The interest of this mode is
-that you can project a raw image (an image without referencing
-coordinates).</dd>
-<dt><strong>-Ei</strong>[|*dpi*]</dt>
-<dd>Sets the resolution of the projected grid that will be created if a
-map projection other than Linear or Mercator was selected [100]. By
-default, the projected grid will be of the same size (rows and
-columns) as the input file. Specify <strong>i</strong> to use the PostScript
-image operator to interpolate the image at the device resolution.</dd>
-<dt><strong>-G</strong>[<strong>f</strong>|<strong>b</strong>]<em>color</em></dt>
-<dd>This option only applies when the resulting image otherwise would
-consist of only two colors: black (0) and white (255). If so, this
-option will instead use the image as a transparent mask and paint
-the mask (or its inverse, with <strong>-Gb</strong>) with the given color
-combination.</dd>
-<dt><strong>-I</strong><em>intensfile</em>|<em>intensity</em></dt>
-<dd>Gives the name of a grid file with intensities in the (-1,+1) range,
-or a constant intensity to apply everywhere.
-[Default is no illumination].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-Jz</strong>|<strong>Z</strong><em>parameters</em> <a class="reference internal" href="gmt.html#jz-full"><em>(more ...)</em></a></dt>
-<dd>Set z-axis scaling; same syntax as <strong>-Jx</strong>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-K</strong> <a class="reference internal" href="gmt.html#k-full"><em>(more ...)</em></a></dt>
-<dd>Do not finalize the PostScript plot.</dd>
-<dt><strong>-M</strong></dt>
-<dd>Force conversion to monochrome image using the (television) YIQ
-transformation. Cannot be used with <strong>-Q</strong>.</dd>
-<dt><strong>-N</strong></dt>
-<dd>Do not clip the image at the map boundary (only relevant for
-non-rectangular maps).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-O</strong> <a class="reference internal" href="gmt.html#o-full"><em>(more ...)</em></a></dt>
-<dd>Append to existing PostScript plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-P</strong> <a class="reference internal" href="gmt.html#p-full"><em>(more ...)</em></a></dt>
-<dd>Select “Portrait” plot orientation.</dd>
-<dt><strong>-Q</strong></dt>
-<dd>Make grid nodes with z = NaN transparent, using the colormasking
-feature in PostScript Level 3 (the PS device must support PS Level 3).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-</dl>
-<p>For perspective view <strong>p</strong>, optionally append /<em>zmin</em>/<em>zmax</em>. <a class="reference internal" href="gmt.html#rz-full"><em>(more ...)</em></a> You may ask for a larger
-<em>w/e/s/n</em> region to have more room between the image and the axes. A
-smaller region than specified in the grid file will result in a
-subset of the grid [Default is the region given by the grid file].</p>
-<dl class="docutils">
-<dt><strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] <a class="reference internal" href="gmt.html#u-full"><em>(more ...)</em></a></dt>
-<dd>Draw GMT time stamp logo on plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<p><strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]]</p>
-<dl class="docutils">
-<dt><strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] <a class="reference internal" href="gmt.html#xy-full"><em>(more ...)</em></a></dt>
-<dd>Shift plot origin.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-c</strong><em>copies</em> <a class="reference internal" href="gmt.html#c-full"><em>(more ...)</em></a></dt>
-<dd>Specify number of plot copies [Default is 1].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-n</strong>[<strong>b</strong>|<strong>c</strong>|<strong>l</strong>|<strong>n</strong>][<strong>+a</strong>][<strong>+b</strong><em>BC</em>][<strong>+c</strong>][<strong>+t</strong><em>threshold</em>] <a class="reference internal" href="gmt.html#n-full"><em>(more ...)</em></a></dt>
-<dd>Select interpolation mode for grids.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] <a class="reference internal" href="gmt.html#perspective-full"><em>(more ...)</em></a></dt>
-<dd>Select perspective view. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-t</strong>[<em>transp</em>] <a class="reference internal" href="gmt.html#t-full"><em>(more ...)</em></a></dt>
-<dd>Set PDF transparency level in percent.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="grid-file-formats">
-<h2>Grid File Formats<a class="headerlink" href="#grid-file-formats" title="Permalink to this headline">¶</a></h2>
-<p>By default GMT writes out grid as single precision floats in a
-COARDS-complaint netCDF file format. However, GMT is able to produce
-grid files in many other commonly used grid file formats and also
-facilitates so called “packing” of grids, writing out floating point
-data as 1- or 2-byte integers. To specify the precision, scale and
-offset, the user should add the suffix
-<strong>=</strong><em>id</em>[<strong>/</strong><em>scale</em><strong>/</strong><em>offset</em>[<strong>/</strong><em>nan</em>]], where
-<em>id</em> is a two-letter identifier of the grid type and precision, and
-<em>scale</em> and <em>offset</em> are optional scale factor and offset to be applied
-to all grid values, and <em>nan</em> is the value used to indicate missing
-data. When reading grids, the format is generally automatically
-recognized. If not, the same suffix can be added to input grid file
-names. See <a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section
-<a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a>
-of the GMT Technical Reference and Cookbook for more information.</p>
-<p>When reading a netCDF file that contains multiple grids, GMT will
-read, by default, the first 2-dimensional grid that can find in that
-file. To coax GMT into reading another multi-dimensional variable in
-the grid file, append <strong>?</strong><em>varname</em> to the file name, where <em>varname</em>
-is the name of the variable. Note that you may need to escape the
-special meaning of <strong>?</strong> in your shell program by putting a backslash in
-front of it, or by placing the filename and suffix between quotes or
-double quotes. The <strong>?</strong><em>varname</em> suffix can also be used for output
-grids to specify a variable name different from the default: “z”. See
-<a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section <a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a> of the GMT
-Technical Reference and Cookbook for more information, particularly on
-how to read splices of 3-, 4-, or 5-dimensional grids.</p>
-</div>
-<div class="section" id="imaging-grids-with-nans">
-<h2>Imaging Grids With Nans<a class="headerlink" href="#imaging-grids-with-nans" title="Permalink to this headline">¶</a></h2>
-<p>Be aware that if your input grid contains patches of NaNs, these patches
-can become larger as a consequence of the resampling that must take
-place with most map projections. Because <strong>grdimage</strong> uses the
-PostScript colorimage operator, for most non-linear projections we
-must resample your grid onto an equidistant rectangular lattice. If you
-find that the NaN areas are not treated adequately, consider (a) use a
-linear projection, or (b) use <a class="reference internal" href="grdview.html"><em>grdview</em></a> <strong>-Ts</strong> instead.</p>
-</div>
-<div class="section" id="consequences-of-grid-resampling">
-<h2>Consequences of grid resampling<a class="headerlink" href="#consequences-of-grid-resampling" title="Permalink to this headline">¶</a></h2>
-<p>Except for Cartesian cases, we need to resample your geographic grid onto
-an equidistant projected grid. In doing so various algorithms come into play
-that projects data from one lattice to another while avoiding anti-aliasing,
-leading to possible distortions.
-One expected effect of resampling with splines is the tendency for the new
-resampled grid to slightly exceed the global min/max limits of the original
-grid. If this is coupled with tight CPT file limits you may find that some
-map areas may show up with fore- or background color due to the resampling.
-In that case you have two options: (1) Modify your CPT file to fit the resampled
-extrema (reported with <strong>-V</strong>) or (2) Impose clipping of resampled values
-so they do not exceed the input min/max values (add <strong>+c</strong> to your <strong>-n</strong>
-option).</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>For a quick-and-dirty color map of the data in the file stuff.nc, with
-the maximum map dimension limited to be 6 inches, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdimage stuff.nc -JX6i+ > quick.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>To gray-shade the file hawaii_grav.nc with shades given in shades.cpt
-on a Lambert map at 1.5 cm/degree along the standard parallels 18 and
-24, and using 1 degree tickmarks:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdimage hawaii_grav.nc -Jl18/24/1.5c -Cshades.cpt -B1 > hawaii_grav_image.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>To create an illuminated color PostScript plot of the gridded data set
-image.nc, using the intensities provided by the file intens.nc, and
-color levels in the file colors.cpt, with linear scaling at 10
-inch/x-unit, tickmarks every 5 units:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdimage image.nc -Jx10i -Ccolors.cpt -Iintens.nc -B5 > image.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>To create an false color PostScript plot from the three grid files
-red.nc, green.nc, and blue.nc, with linear scaling at 10 inch/x-unit,
-tickmarks every 5 units:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdimage red.nc green.nc blue.nc -Jx10i -B5 > rgbimage.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>When GDAL support is built in: To create a sinusoidal projection of a
-remotely located Jessica Rabbit</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdimage -JI15c -Rd -Dr
- http://larryfire.files.wordpress.com/2009/07/untooned_jessicarabbit.jpg \
- -P > jess.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>,
-<a class="reference internal" href="grd2rgb.html"><em>grd2rgb</em></a>,
-<a class="reference internal" href="grdcontour.html"><em>grdcontour</em></a>,
-<a class="reference internal" href="grdview.html"><em>grdview</em></a>,
-<a class="reference internal" href="grdgradient.html"><em>grdgradient</em></a>,
-<a class="reference internal" href="grdhisteq.html"><em>grdhisteq</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grdimage</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#grid-file-formats">Grid File Formats</a></li>
-<li><a class="reference internal" href="#imaging-grids-with-nans">Imaging Grids With Nans</a></li>
-<li><a class="reference internal" href="#consequences-of-grid-resampling">Consequences of grid resampling</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grdhisteq.html"
- title="previous chapter">grdhisteq</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grdinfo.html"
- title="next chapter">grdinfo</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/grdimage.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grdinfo.html" title="grdinfo"
- >next</a> </li>
- <li class="right" >
- <a href="grdhisteq.html" title="grdhisteq"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" >GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/grdinfo.html b/doc_release/html/grdinfo.html
deleted file mode 100644
index ec4c42b..0000000
--- a/doc_release/html/grdinfo.html
+++ /dev/null
@@ -1,301 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grdinfo — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GR" href="GR.html" />
- <link rel="next" title="grdlandmask" href="grdlandmask.html" />
- <link rel="prev" title="grdimage" href="grdimage.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grdlandmask.html" title="grdlandmask"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grdimage.html" title="grdimage"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" accesskey="U">GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grdinfo">
-<span id="index-0"></span><h1>grdinfo<a class="headerlink" href="#grdinfo" title="Permalink to this headline">¶</a></h1>
-<p>grdinfo - Extract information from grids</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdinfo</strong> <em>grdfiles</em> [ <strong>-C</strong> ] [ <strong>-F</strong> ]
-[ <strong>-I</strong>[<em>dx</em>[/<em>dy</em>]|<strong>-</strong>|<strong>b</strong>] ]
-[ <strong>-L</strong>[<strong>0</strong>|<strong>1</strong>|<strong>2</strong>] ] [ <strong>-M</strong> ]
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ]
-[ <strong>-T</strong>[<strong>s</strong>]<em>dz</em> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdinfo</strong> reads a 2-D binary grid file and reports metadata and
-various statistics for the (<em>x</em>,<em>y</em>,<em>z</em>) data in the grid file(s).
-The output information contains the minimum/maximum values for <em>x</em>, <em>y</em>,
-and <em>z</em>, where the min/max of <em>z</em> occur, the <em>x</em>- and <em>y</em>-increments,
-and the number of <em>x</em> and <em>y</em> nodes, and [optionally] the mean, standard
-deviation, and/or the median, L1 scale of <em>z</em>, and number of nodes set
-to NaN. We also report if the grid is pixel- or gridline-registered and
-if it is a Cartesian or Geographic data set (based on metadata in the file).</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>grdfile</em></dt>
-<dd>The name of one or several 2-D grid files. (See GRID FILE FORMATS below.)</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-C</strong></dt>
-<dd>Formats the report using tab-separated fields on a single line. The
-output is <em>w e s n z0 z1 dx dy nx ny</em>[ <em>x0 y0 x1 y1</em> ] [ <em>med
-scale</em> ] [<em>mean std rms</em>] [<em>n_nan</em>]. The data in brackets are
-output only if the corresponding options <strong>-M</strong>, <strong>-L1</strong>, <strong>-L2</strong>,
-and <strong>-M</strong> are used, respectively. If the <strong>-I</strong> option is used, the
-output format is instead <em>NF w e s n z0 z1</em>, where <em>NF</em> is the total
-number of grids read and <em>w e s n</em> are rounded off (see <strong>-I</strong>).</dd>
-<dt><strong>-F</strong></dt>
-<dd>Report grid domain and x/y-increments in world mapping format
-[Default is generic]. Does not apply to the <strong>-C</strong> option.</dd>
-<dt><strong>-I</strong>[<em>dx</em>[/<em>dy</em>]|<strong>-</strong>|<strong>b</strong>]</dt>
-<dd>Report the min/max of the region to the nearest multiple of <em>dx</em> and
-<em>dy</em>, and output this in the form <strong>-R</strong><em>w/e/s/n</em> (unless <strong>-C</strong>
-is set). To report the actual grid region, select <strong>-I-</strong>. If no
-argument is given then we report the grid increment in the form
-<strong>-I</strong><em>xinc/yinc</em>. If <strong>-Ib</strong> is given we write each grid’s
-bounding box polygon instead.</dd>
-<dt><strong>-L</strong>[<strong>0</strong> | <strong>1</strong> | <strong>2</strong>]</dt>
-<dd><dl class="first last docutils">
-<dt><strong>-L0</strong></dt>
-<dd>Report range of z after actually scanning the data, not just
-reporting what the header says.</dd>
-<dt><strong>-L1</strong></dt>
-<dd>Report median and L1 scale of z (L1 scale = 1.4826 * Median
-Absolute Deviation (MAD)).</dd>
-<dt><strong>-L2</strong></dt>
-<dd>Report mean, standard deviation, and root-mean-square (rms) of z.</dd>
-</dl>
-</dd>
-<dt><strong>-M</strong></dt>
-<dd>Find and report the location of min/max z-values, and count and
-report the number of nodes set to NaN, if any.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. Using the <strong>-R</strong> option
-will select a subsection of the input grid(s). If this subsection
-exceeds the boundaries of the grid, only the common region will be extracted.</dd>
-<dt><strong>-T</strong><em>dz</em></dt>
-<dd>Determine min and max z-value, round off to multiples of <em>dz</em>, and
-report as the text string <strong>-T</strong><em>zmin/zmax/dz</em> for use by
-<strong>makecpt</strong>. To get a symmetrical range about zero, using the max
-absolute multiple of <em>dz</em>, use <strong>-Ts</strong><em>dz</em> instead.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="grid-file-formats">
-<h2>Grid File Formats<a class="headerlink" href="#grid-file-formats" title="Permalink to this headline">¶</a></h2>
-<p>By default GMT writes out grid as single precision floats in a
-COARDS-complaint netCDF file format. However, GMT is able to produce
-grid files in many other commonly used grid file formats and also
-facilitates so called “packing” of grids, writing out floating point
-data as 1- or 2-byte integers. To specify the precision, scale and
-offset, the user should add the suffix
-<strong>=</strong><em>id</em>[<strong>/</strong><em>scale</em><strong>/</strong><em>offset</em>[<strong>/</strong><em>nan</em>]], where
-<em>id</em> is a two-letter identifier of the grid type and precision, and
-<em>scale</em> and <em>offset</em> are optional scale factor and offset to be applied
-to all grid values, and <em>nan</em> is the value used to indicate missing
-data. When reading grids, the format is generally automatically
-recognized. If not, the same suffix can be added to input grid file
-names. See <a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section
-<a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a>
-of the GMT Technical Reference and Cookbook for more information.</p>
-<p>When reading a netCDF file that contains multiple grids, GMT will
-read, by default, the first 2-dimensional grid that can find in that
-file. To coax GMT into reading another multi-dimensional variable in
-the grid file, append <strong>?</strong><em>varname</em> to the file name, where <em>varname</em>
-is the name of the variable. Note that you may need to escape the
-special meaning of <strong>?</strong> in your shell program by putting a backslash in
-front of it, or by placing the filename and suffix between quotes or
-double quotes. The <strong>?</strong><em>varname</em> suffix can also be used for output
-grids to specify a variable name different from the default: “z”. See
-<a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section <a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a> of the GMT
-Technical Reference and Cookbook for more information, particularly on
-how to read splices of 3-, 4-, or 5-dimensional grids.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To obtain all the information about the data set in file hawaii_topo.nc:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdinfo -L1 -L2 -M hawaii_topo.nc
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="grd2cpt.html"><em>grd2cpt</em></a>,
-<a class="reference internal" href="grd2xyz.html"><em>grd2xyz</em></a>, <a class="reference internal" href="grdedit.html"><em>grdedit</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grdinfo</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#grid-file-formats">Grid File Formats</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grdimage.html"
- title="previous chapter">grdimage</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grdlandmask.html"
- title="next chapter">grdlandmask</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/grdinfo.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grdlandmask.html" title="grdlandmask"
- >next</a> </li>
- <li class="right" >
- <a href="grdimage.html" title="grdimage"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" >GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/grdlandmask.html b/doc_release/html/grdlandmask.html
deleted file mode 100644
index 66b475f..0000000
--- a/doc_release/html/grdlandmask.html
+++ /dev/null
@@ -1,344 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grdlandmask — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GR" href="GR.html" />
- <link rel="next" title="grdmask" href="grdmask.html" />
- <link rel="prev" title="grdinfo" href="grdinfo.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grdmask.html" title="grdmask"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grdinfo.html" title="grdinfo"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" accesskey="U">GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grdlandmask">
-<span id="index-0"></span><h1>grdlandmask<a class="headerlink" href="#grdlandmask" title="Permalink to this headline">¶</a></h1>
-<p>grdlandmask - Create a “wet-dry” mask grid from shoreline data base</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdlandmask</strong> <strong>-G</strong><em>mask_grd_file</em>]
-<strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]
-<strong>-R</strong><em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[<strong>r</strong>] [
-<strong>-A</strong><em>min_area</em>[/<em>min_level</em>/<em>max_level</em>][<strong>+as</strong>][<strong>+r</strong>|<strong>l</strong>][<strong>p</strong><em>percent</em>]
-] [ <strong>-D</strong><em>resolution</em>[<strong>+</strong>] ] [ <strong>-N</strong><em>maskvalues</em>[<strong>o</strong>]
-] [ <strong>-V</strong>[<em>level</em>] ] [ <strong>-r</strong> ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdlandmask</strong> reads the selected shoreline database and uses that
-information to decide which nodes in the specified grid are over land or
-over water. The nodes defined by the selected region and lattice spacing
-will be set according to one of two criteria: (1) land vs water, or
-(2) the more detailed (hierarchical) ocean vs land vs lake
-vs island vs pond. The resulting mask may be used in subsequent
-operations involving <strong>grdmath</strong> to mask out data from land [or water] areas.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-G</strong><em>mask_grd_file</em>]</dt>
-<dd>Name of resulting output mask grid file. (See GRID FILE FORMATS below).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]</dt>
-<dd><em>x_inc</em> [and optionally <em>y_inc</em>] is the grid spacing. Optionally,
-append a suffix modifier. <strong>Geographical (degrees) coordinates</strong>: Append
-<strong>m</strong> to indicate arc minutes or <strong>s</strong> to indicate arc seconds. If one
-of the units <strong>e</strong>, <strong>f</strong>, <strong>k</strong>, <strong>M</strong>, <strong>n</strong> or <strong>u</strong> is appended
-instead, the increment is assumed to be given in meter, foot, km, Mile,
-nautical mile or US survey foot, respectively, and will be converted to
-the equivalent degrees longitude at the middle latitude of the region
-(the conversion depends on <a class="reference internal" href="gmt.conf.html#projection-parameters"><em>PROJ_ELLIPSOID</em></a>). If /<em>y_inc</em> is given
-but set to 0 it will be reset equal to <em>x_inc</em>; otherwise it will be
-converted to degrees latitude. <strong>All coordinates</strong>: If <strong>=</strong> is appended
-then the corresponding max <em>x</em> (<em>east</em>) or <em>y</em> (<em>north</em>) may be slightly
-adjusted to fit exactly the given increment [by default the increment
-may be adjusted slightly to fit the given domain]. Finally, instead of
-giving an increment you may specify the <em>number of nodes</em> desired by
-appending <strong>+</strong> to the supplied integer argument; the increment is then
-recalculated from the number of nodes and the domain. The resulting
-increment value depends on whether you have selected a
-gridline-registered or pixel-registered grid; see <a class="reference internal" href="GMT_Docs.html#app-file-formats"><em>B. GMT File Formats</em></a> for
-details. Note: if <strong>-R</strong><em>grdfile</em> is used then the grid spacing has
-already been initialized; use <strong>-I</strong> to override the values.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]</dt>
-<dd><em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> specify the region of interest,
-and you may specify them in decimal degrees or in
-[+-]dd:mm[:ss.xxx][W|E|S|N] format. Append <strong>r</strong> if lower left
-and upper right map coordinates are given instead of w/e/s/n. The
-two shorthands <strong>-Rg</strong> and <strong>-Rd</strong> stand for global domain (0/360
-and -180/+180 in longitude respectively, with -90/+90 in latitude).
-Alternatively, specify the name of an existing grid file and the
-<strong>-R</strong> settings (and grid spacing, if applicable) are copied from
-the grid. Using <strong>-R</strong><em>unit</em> expects projected (Cartesian)
-coordinates compatible with chosen <strong>-J</strong> and we inversely project
-to determine actual rectangular geographic region.
-For perspective view (<strong>-p</strong>), optionally append /<em>zmin</em>/<em>zmax</em>.
-In case of perspective view (<strong>-p</strong>), a z-range (<em>zmin</em>, <em>zmax</em>)
-can be appended to indicate the third dimension. This needs to be
-done only when using the <strong>-Jz</strong> option, not when using only the
-<strong>-p</strong> option. In the latter case a perspective view of the plane is
-plotted, with no third dimension. </dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong><em>min_area</em>[/<em>min_level</em>/<em>max_level</em>][<strong>+as</strong>][<strong>+r</strong>|<strong>l</strong>][<strong>+p</strong><em>percent</em>]</dt>
-<dd>Features with an area smaller than <em>min_area</em> in km^2 or of
-hierarchical level that is lower than <em>min_level</em> or higher than
-<em>max_level</em> will not be plotted [Default is 0/0/4 (all features)].
-Level 2 (lakes) contains regular lakes and wide river bodies which
-we normally include as lakes; append <strong>+r</strong> to just get river-lakes
-or <strong>+l</strong> to just get regular lakes. For expert users who wish to
-print their own Antarctica coastline and islands via <cite>psxy</cite> you can
-use <strong>+as</strong> to skip all GSHHG features below 60S. Finally, append
-<strong>+p</strong><em>percent</em> to exclude polygons whose percentage area of the
-corresponding full-resolution feature is less than <em>percent</em>. See
-GSHHG INFORMATION below for more details. </dd>
-<dt><strong>-D</strong><em>resolution</em>[<strong>+</strong>]</dt>
-<dd>Selects the resolution of the data set to use ((<strong>f</strong>)ull,
-(<strong>h</strong>)igh, (<strong>i</strong>)ntermediate, (<strong>l</strong>)ow, or (<strong>c</strong>)rude). The
-resolution drops off by ~80% between data sets. [Default is <strong>l</strong>].
-Append <strong>+</strong> to automatically select a lower resolution should the
-one requested not be available [abort if not found]. Note that
-because the coastlines differ in details a node in a mask file using
-one resolution is not guaranteed to remain inside [or outside] when
-a different resolution is selected.</dd>
-<dt><strong>-N</strong><em>maskvalues</em>[<strong>o</strong>]</dt>
-<dd><p class="first">Sets the values that will be assigned to nodes. Values can be any
-number, including the textstring NaN. Append <strong>o</strong> to let nodes
-exactly on feature boundaries be considered outside [Default is
-inside]. Specify this information using 1 of 2 formats:</p>
-<p><strong>-N</strong><em>wet/dry</em>.</p>
-<p><strong>-N</strong><em>ocean/land/lake/island/pond</em>.</p>
-<p class="last">[Default is 0/1/0/1/0 (i.e., 0/1)].</p>
-</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-r</strong> <a class="reference internal" href="gmt.html#nodereg-full"><em>(more ...)</em></a></dt>
-<dd>Set pixel node registration [gridline]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="grid-file-formats">
-<h2>Grid File Formats<a class="headerlink" href="#grid-file-formats" title="Permalink to this headline">¶</a></h2>
-<p>By default GMT writes out grid as single precision floats in a
-COARDS-complaint netCDF file format. However, GMT is able to produce
-grid files in many other commonly used grid file formats and also
-facilitates so called “packing” of grids, writing out floating point
-data as 1- or 2-byte integers. To specify the precision, scale and
-offset, the user should add the suffix
-<strong>=</strong><em>id</em>[<strong>/</strong><em>scale</em><strong>/</strong><em>offset</em>[<strong>/</strong><em>nan</em>]], where
-<em>id</em> is a two-letter identifier of the grid type and precision, and
-<em>scale</em> and <em>offset</em> are optional scale factor and offset to be applied
-to all grid values, and <em>nan</em> is the value used to indicate missing
-data. See <a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section
-<a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a>
-of the GMT Technical Reference and Cookbook for more information.</p>
-<p>When writing a netCDF file, the grid is stored by default with the
-variable name “z”. To specify another variable name <em>varname</em>, append
-<strong>?</strong><em>varname</em> to the file name. Note that you may need to escape the
-special meaning of <strong>?</strong> in your shell program by putting a backslash in
-front of it, or by placing the filename and suffix between quotes or
-double quotes.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To set all nodes on land to NaN, and nodes over water to 1, using the
-high resolution data set, do</p>
-<blockquote>
-<div>gmt grdlandmask -R-60/-40/-40/-30 -Dh -I5m -N1/NaN -Gland_mask.nc -V</div></blockquote>
-<p>To make a 1x1 degree global grid with the hierarchical levels of the
-nodes based on the low resolution data:</p>
-<blockquote>
-<div>gmt grdlandmask -R0/360/-90/90 -Dl -I1 -N0/1/2/3/4 -Glevels.nc -V</div></blockquote>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc11">Gshhs Information</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>The coastline database is GSHHG (formerly GSHHS) which is compiled from two sources:
-World Vector Shorelines (WVS) and CIA World Data Bank II (WDBII). In
-particular, all level-1 polygons (ocean-land boundary) are derived from
-the more accurate WVS while all higher level polygons (level 2-4,
-representing land/lake, lake/island-in-lake, and
-island-in-lake/lake-in-island-in-lake boundaries) are taken from WDBII.
-Much processing has taken place to convert WVS and WDBII data into
-usable form for GMT: assembling closed polygons from line segments,
-checking for duplicates, and correcting for crossings between polygons.
-The area of each polygon has been determined so that the user may choose
-not to draw features smaller than a minimum area (see <strong>-A</strong>); one may
-also limit the highest hierarchical level of polygons to be included (4
-is the maximum). The 4 lower-resolution databases were derived from the
-full resolution database using the Douglas-Peucker line-simplification
-algorithm. The classification of rivers and borders follow that of the
-WDBII. See the GMT Cookbook and Technical Reference Appendix K for
-further details.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="grdmath.html"><em>grdmath</em></a>,
-<a class="reference internal" href="grdclip.html"><em>grdclip</em></a>, <a class="reference internal" href="psmask.html"><em>psmask</em></a>,
-<a class="reference internal" href="psclip.html"><em>psclip</em></a>, <a class="reference internal" href="pscoast.html"><em>pscoast</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grdlandmask</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#grid-file-formats">Grid File Formats</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#id1">Gshhs Information</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grdinfo.html"
- title="previous chapter">grdinfo</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grdmask.html"
- title="next chapter">grdmask</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/grdlandmask.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grdmask.html" title="grdmask"
- >next</a> </li>
- <li class="right" >
- <a href="grdinfo.html" title="grdinfo"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" >GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/grdmask.html b/doc_release/html/grdmask.html
deleted file mode 100644
index 592d914..0000000
--- a/doc_release/html/grdmask.html
+++ /dev/null
@@ -1,381 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grdmask — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GR" href="GR.html" />
- <link rel="next" title="grdmath" href="grdmath.html" />
- <link rel="prev" title="grdlandmask" href="grdlandmask.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grdmath.html" title="grdmath"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grdlandmask.html" title="grdlandmask"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" accesskey="U">GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grdmask">
-<span id="index-0"></span><h1>grdmask<a class="headerlink" href="#grdmask" title="Permalink to this headline">¶</a></h1>
-<p>grdmask - Create mask grid from polygons or point coverage</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdmask</strong> <em>pathfiles</em> <strong>-G</strong><em>mask_grd_file</em>]
-<strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]
-<strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>]
-[ <strong>-A</strong>[<strong>m</strong>|<strong>p</strong>] ]
-[ <strong>-N</strong>[<strong>z</strong>|<strong>Z</strong>|<strong>p</strong>|<strong>P</strong>]<em>values</em> ]
-[ <strong>-S</strong><em>search_radius</em>[<em>unit</em>] ] [ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-bi</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-r</strong> ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdmask</strong> can operate in two different modes. 1. It reads one or more
-xy-files that each define a closed polygon. The nodes defined by the
-specified region and lattice spacing will be set equal to one of three
-possible values depending on whether the node is outside, on the polygon
-perimeter, or inside the polygon. The resulting mask may be used in
-subsequent operations involving <strong>grdmath</strong> to mask out data from
-polygonal areas. 2. The xy-files simply represent data point locations
-and the mask is set to the inside or outside value depending on whether
-a node is within a maximum distance from the nearest data point. If the
-distance specified is zero then only the nodes nearest each data point
-are considered “inside”.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>pathfiles</em></dt>
-<dd>The name of 1 or more ASCII [or binary, see
-<strong>-bi</strong>] files holding the polygon(s) or data points.</dd>
-<dt><strong>-G</strong><em>mask_grd_file</em>]</dt>
-<dd>Name of resulting output mask grid file. (See GRID FILE FORMATS below).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]</dt>
-<dd><em>x_inc</em> [and optionally <em>y_inc</em>] is the grid spacing. Optionally,
-append a suffix modifier. <strong>Geographical (degrees) coordinates</strong>: Append
-<strong>m</strong> to indicate arc minutes or <strong>s</strong> to indicate arc seconds. If one
-of the units <strong>e</strong>, <strong>f</strong>, <strong>k</strong>, <strong>M</strong>, <strong>n</strong> or <strong>u</strong> is appended
-instead, the increment is assumed to be given in meter, foot, km, Mile,
-nautical mile or US survey foot, respectively, and will be converted to
-the equivalent degrees longitude at the middle latitude of the region
-(the conversion depends on <a class="reference internal" href="gmt.conf.html#projection-parameters"><em>PROJ_ELLIPSOID</em></a>). If /<em>y_inc</em> is given
-but set to 0 it will be reset equal to <em>x_inc</em>; otherwise it will be
-converted to degrees latitude. <strong>All coordinates</strong>: If <strong>=</strong> is appended
-then the corresponding max <em>x</em> (<em>east</em>) or <em>y</em> (<em>north</em>) may be slightly
-adjusted to fit exactly the given increment [by default the increment
-may be adjusted slightly to fit the given domain]. Finally, instead of
-giving an increment you may specify the <em>number of nodes</em> desired by
-appending <strong>+</strong> to the supplied integer argument; the increment is then
-recalculated from the number of nodes and the domain. The resulting
-increment value depends on whether you have selected a
-gridline-registered or pixel-registered grid; see <a class="reference internal" href="GMT_Docs.html#app-file-formats"><em>B. GMT File Formats</em></a> for
-details. Note: if <strong>-R</strong><em>grdfile</em> is used then the grid spacing has
-already been initialized; use <strong>-I</strong> to override the values.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong>[<strong>m</strong>|<strong>p</strong>]</dt>
-<dd>If the input data are geographic (as indicated by <strong>-fi</strong>) then the
-sides in the polygons will be approximated by great circle arcs.
-When using the <strong>-A</strong> sides will be regarded as straight lines.
-Alternatively, append <strong>m</strong> to have sides first follow meridians,
-then parallels. Or append <strong>p</strong> to first follow parallels, then meridians.</dd>
-<dt><strong>-N</strong>[<strong>z</strong>|<strong>Z</strong>|<strong>p</strong>|<strong>P</strong>]<em>values</em></dt>
-<dd>Sets the <em>out/edge/in</em> that will be assigned to nodes that are
-<em>out</em>side the polygons, on the <em>edge</em>, or <em>in</em>side. Values can
-be any number, including the textstring NaN [Default is 0/0/1].
-Optionally, use <strong>Nz</strong> to set polygon insides to the z-value
-obtained from the data (either segment header <strong>-Z</strong><em>zval</em>,
-<strong>-L</strong><em>header</em> or via <strong>-a</strong>Z=<em>name</em>); use <strong>-NZ</strong> to consider
-the polygon boundary as part of the inside. Alternatively, use
-<strong>-Np</strong> to use a running number as polygon ID; optionally append
-start of the sequence [0]. Here, <strong>-NP</strong> includes the polygon
-perimeter as inside. Note:
-<strong>-N</strong><strong>z</strong>|<strong>Z</strong>|<strong>p</strong>|<strong>P</strong> cannot be used in
-conjunction with <strong>-S</strong>; they also all optionally accept /<em>out</em> [0].</dd>
-<dt><strong>-S</strong><em>search_radius</em>[<em>unit</em>]</dt>
-<dd>Set nodes to inside, on edge, or outside depending on their distance
-to the nearest data point. Nodes within <em>radius</em> [0] from the
-nearest data point are considered inside; append a distance unit
-(see UNITS). If <em>radius</em> is given as <strong>z</strong> then we instead read
-individual radii from the 3rd input column. If <strong>-S</strong> is not set
-then we consider the input data to define closed polygon(s) instead.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 2 input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] <a class="reference internal" href="gmt.html#g-full"><em>(more ...)</em></a></dt>
-<dd>Determine data gaps and line breaks. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-r</strong> <a class="reference internal" href="gmt.html#nodereg-full"><em>(more ...)</em></a></dt>
-<dd>Set pixel node registration [gridline]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc9">Units</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>For map distance unit, append <em>unit</em> <strong>d</strong> for arc degree, <strong>m</strong> for arc
-minute, and <strong>s</strong> for arc second, or <strong>e</strong> for meter [Default], <strong>f</strong>
-for foot, <strong>k</strong> for km, <strong>M</strong> for statute mile, <strong>n</strong> for nautical mile,
-and <strong>u</strong> for US survey foot. By default we compute such distances using
-a spherical approximation with great circles. Prepend <strong>-</strong> to a
-distance (or the unit is no distance is given) to perform “Flat Earth”
-calculations (quicker but less accurate) or prepend <strong>+</strong> to perform
-exact geodesic calculations (slower but more accurate).</p>
-</div>
-<div class="section" id="grid-file-formats">
-<h2>Grid File Formats<a class="headerlink" href="#grid-file-formats" title="Permalink to this headline">¶</a></h2>
-<p>By default GMT writes out grid as single precision floats in a
-COARDS-complaint netCDF file format. However, GMT is able to produce
-grid files in many other commonly used grid file formats and also
-facilitates so called “packing” of grids, writing out floating point
-data as 1- or 2-byte integers. To specify the precision, scale and
-offset, the user should add the suffix
-<strong>=</strong><em>id</em>[<strong>/</strong><em>scale</em><strong>/</strong><em>offset</em>[<strong>/</strong><em>nan</em>]], where
-<em>id</em> is a two-letter identifier of the grid type and precision, and
-<em>scale</em> and <em>offset</em> are optional scale factor and offset to be applied
-to all grid values, and <em>nan</em> is the value used to indicate missing
-data. See <a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section
-<a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a>
-of the GMT Technical Reference and Cookbook for more information.</p>
-<p>When writing a netCDF file, the grid is stored by default with the
-variable name “z”. To specify another variable name <em>varname</em>, append
-<strong>?</strong><em>varname</em> to the file name. Note that you may need to escape the
-special meaning of <strong>?</strong> in your shell program by putting a backslash in
-front of it, or by placing the filename and suffix between quotes or
-double quotes.</p>
-</div>
-<div class="section" id="geographical-and-time-coordinates">
-<h2>Geographical And Time Coordinates<a class="headerlink" href="#geographical-and-time-coordinates" title="Permalink to this headline">¶</a></h2>
-<p>When the output grid type is netCDF, the coordinates will be labeled
-“longitude”, “latitude”, or “time” based on the attributes of the input
-data or grid (if any) or on the <strong>-f</strong> or <strong>-R</strong> options. For example,
-both <strong>-f0x</strong> <strong>-f1t</strong> and <strong>-R</strong>90w/90e/0t/3t will result in a
-longitude/time grid. When the x, y, or z coordinate is time, it will be
-stored in the grid as relative time since epoch as specified by
-<a class="reference internal" href="gmt.conf.html#time-unit"><em>TIME_UNIT</em></a> and <a class="reference internal" href="gmt.conf.html#time-epoch"><em>TIME_EPOCH</em></a> in the
-<a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file or on the
-command line. In addition, the <strong>unit</strong> attribute of the time variable
-will indicate both this unit and epoch.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To set all nodes inside and on the polygons coastline_*.xy to 0, and
-outside points to 1, do</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdmask coastline_*.xy -R-60/-40/-40/-30 -I5m -N1/0/0 -Gland_mask.nc=nb -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>To set nodes within 50 km of data points to 1 and other nodes to NaN, do</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdmask data.xyz -R-60/-40/-40/-30 -I5m -NNaN/1/1 -S50k -Gdata_mask.nc=nb -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>To assign polygon IDs to the gridnodes using the insides of the polygons
-in plates.gmt, based on the attribute POL_ID, do</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdmask plates.gmt -R-40/40/-40/40 -I2m -Nz -Gplate_IDs.nc -aZ=POL_ID -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>Same exercise, but instead compute running polygon IDs starting at 100, do</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdmask plates.gmt -R-40/40/-40/40 -I2m -Np100 -Gplate_IDs.nc -V
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="grdlandmask.html"><em>grdlandmask</em></a>,
-<a class="reference internal" href="grdmath.html"><em>grdmath</em></a>, <a class="reference internal" href="grdclip.html"><em>grdclip</em></a>,
-<a class="reference internal" href="psmask.html"><em>psmask</em></a>, <a class="reference internal" href="psclip.html"><em>psclip</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grdmask</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#id1">Units</a></li>
-<li><a class="reference internal" href="#grid-file-formats">Grid File Formats</a></li>
-<li><a class="reference internal" href="#geographical-and-time-coordinates">Geographical And Time Coordinates</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grdlandmask.html"
- title="previous chapter">grdlandmask</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grdmath.html"
- title="next chapter">grdmath</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/grdmask.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grdmath.html" title="grdmath"
- >next</a> </li>
- <li class="right" >
- <a href="grdlandmask.html" title="grdlandmask"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" >GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/grdmath.html b/doc_release/html/grdmath.html
deleted file mode 100644
index c7c6d4c..0000000
--- a/doc_release/html/grdmath.html
+++ /dev/null
@@ -1,1227 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grdmath — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GR" href="GR.html" />
- <link rel="next" title="grdpaste" href="grdpaste.html" />
- <link rel="prev" title="grdmask" href="grdmask.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grdpaste.html" title="grdpaste"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grdmask.html" title="grdmask"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" accesskey="U">GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grdmath">
-<span id="index-0"></span><h1>grdmath<a class="headerlink" href="#grdmath" title="Permalink to this headline">¶</a></h1>
-<p>grdmath - Reverse Polish Notation (RPN) calculator for grids (element by element)</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdmath</strong>
-[ <strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]] ]
-[ <strong>-M</strong> ] [ <strong>-N</strong> ]
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ] [ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-bi</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-n</strong>[<strong>b</strong>|<strong>c</strong>|<strong>l</strong>|<strong>n</strong>][<strong>+a</strong>][<strong>+b</strong><em>BC</em>][<strong>+t</strong><em>threshold</em>] ]
-[ <strong>-r</strong> ] <em>operand</em> [ <em>operand</em> ] <strong>OPERATOR</strong> [ <em>operand</em> ]
-<strong>OPERATOR</strong> ... <strong>=</strong> <em>outgrdfile</em></p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdmath</strong> will perform operations like add, subtract, multiply, and
-divide on one or more grid files or constants using Reverse Polish
-Notation (RPN) syntax (e.g., Hewlett-Packard calculator-style).
-Arbitrarily complicated expressions may therefore be evaluated; the
-final result is written to an output grid file. Grid operations are
-element-by-element, not matrix manipulations. Some operators only
-require one operand (see below). If no grid files are used in the
-expression then options <strong>-R</strong>, <strong>-I</strong> must be set (and optionally
-<strong>-r</strong>). The expression <strong>=</strong> <em>outgrdfile</em> can occur as many times as
-the depth of the stack allows in order to save intermediate results.
-Complicated or frequently occurring expressions may be coded as a macro
-for future use or stored and recalled via named memory locations.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>operand</em></dt>
-<dd>If <em>operand</em> can be opened as a file it will be read as a grid file.
-If not a file, it is interpreted as a numerical constant or a
-special symbol (see below).</dd>
-<dt><em>outgrdfile</em></dt>
-<dd>The name of a 2-D grid file that will hold the final result. (See
-GRID FILE FORMATS below).</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]</dt>
-<dd><em>x_inc</em> [and optionally <em>y_inc</em>] is the grid spacing. Optionally,
-append a suffix modifier. <strong>Geographical (degrees) coordinates</strong>: Append
-<strong>m</strong> to indicate arc minutes or <strong>s</strong> to indicate arc seconds. If one
-of the units <strong>e</strong>, <strong>f</strong>, <strong>k</strong>, <strong>M</strong>, <strong>n</strong> or <strong>u</strong> is appended
-instead, the increment is assumed to be given in meter, foot, km, Mile,
-nautical mile or US survey foot, respectively, and will be converted to
-the equivalent degrees longitude at the middle latitude of the region
-(the conversion depends on <a class="reference internal" href="gmt.conf.html#projection-parameters"><em>PROJ_ELLIPSOID</em></a>). If /<em>y_inc</em> is given
-but set to 0 it will be reset equal to <em>x_inc</em>; otherwise it will be
-converted to degrees latitude. <strong>All coordinates</strong>: If <strong>=</strong> is appended
-then the corresponding max <em>x</em> (<em>east</em>) or <em>y</em> (<em>north</em>) may be slightly
-adjusted to fit exactly the given increment [by default the increment
-may be adjusted slightly to fit the given domain]. Finally, instead of
-giving an increment you may specify the <em>number of nodes</em> desired by
-appending <strong>+</strong> to the supplied integer argument; the increment is then
-recalculated from the number of nodes and the domain. The resulting
-increment value depends on whether you have selected a
-gridline-registered or pixel-registered grid; see <a class="reference internal" href="GMT_Docs.html#app-file-formats"><em>B. GMT File Formats</em></a> for
-details. Note: if <strong>-R</strong><em>grdfile</em> is used then the grid spacing has
-already been initialized; use <strong>-I</strong> to override the values.</dd>
-<dt><strong>-M</strong></dt>
-<dd>By default any derivatives calculated are in z_units/ x(or
-y)_units. However, the user may choose this option to convert dx,dy
-in degrees of longitude,latitude into meters using a flat Earth
-approximation, so that gradients are in z_units/meter.</dd>
-<dt><strong>-N</strong></dt>
-<dd>Turn off strict domain match checking when multiple grids are
-manipulated [Default will insist that each grid domain is within
-1e-4 * grid_spacing of the domain of the first grid listed].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. The binary input option
-only applies to the data files needed by operators <strong>LDIST</strong>,
-<strong>PDIST</strong>, and <strong>INSIDE</strong>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] <a class="reference internal" href="gmt.html#g-full"><em>(more ...)</em></a></dt>
-<dd>Determine data gaps and line breaks. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-n</strong>[<strong>b</strong>|<strong>c</strong>|<strong>l</strong>|<strong>n</strong>][<strong>+a</strong>][<strong>+b</strong><em>BC</em>][<strong>+c</strong>][<strong>+t</strong><em>threshold</em>] <a class="reference internal" href="gmt.html#n-full"><em>(more ...)</em></a></dt>
-<dd>Select interpolation mode for grids.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-r</strong> <a class="reference internal" href="gmt.html#nodereg-full"><em>(more ...)</em></a></dt>
-<dd>Set pixel node registration [gridline]. Only used with <strong>-R</strong> <strong>-I</strong>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="operators">
-<h2>Operators<a class="headerlink" href="#operators" title="Permalink to this headline">¶</a></h2>
-<p>Choose among the following 161 operators. “args” are the number of input
-and output arguments.</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="12%" />
-<col width="6%" />
-<col width="83%" />
-</colgroup>
-<tbody valign="top">
-<tr class="row-odd"><td>Operator</td>
-<td>args</td>
-<td>Returns</td>
-</tr>
-<tr class="row-even"><td><strong>ABS</strong></td>
-<td>1 1</td>
-<td>abs (A)</td>
-</tr>
-<tr class="row-odd"><td><strong>ACOS</strong></td>
-<td>1 1</td>
-<td>acos (A)</td>
-</tr>
-<tr class="row-even"><td><strong>ACOSH</strong></td>
-<td>1 1</td>
-<td>acosh (A)</td>
-</tr>
-<tr class="row-odd"><td><strong>ACOT</strong></td>
-<td>1 1</td>
-<td>acot (A)</td>
-</tr>
-<tr class="row-even"><td><strong>ACSC</strong></td>
-<td>1 1</td>
-<td>acsc (A)</td>
-</tr>
-<tr class="row-odd"><td><strong>ADD</strong></td>
-<td>2 1</td>
-<td>A + B</td>
-</tr>
-<tr class="row-even"><td><strong>AND</strong></td>
-<td>2 1</td>
-<td>B if A == NaN, else A</td>
-</tr>
-<tr class="row-odd"><td><strong>ASEC</strong></td>
-<td>1 1</td>
-<td>asec (A)</td>
-</tr>
-<tr class="row-even"><td><strong>ASIN</strong></td>
-<td>1 1</td>
-<td>asin (A)</td>
-</tr>
-<tr class="row-odd"><td><strong>ASINH</strong></td>
-<td>1 1</td>
-<td>asinh (A)</td>
-</tr>
-<tr class="row-even"><td><strong>ATAN</strong></td>
-<td>1 1</td>
-<td>atan (A)</td>
-</tr>
-<tr class="row-odd"><td><strong>ATAN2</strong></td>
-<td>2 1</td>
-<td>atan2 (A, B)</td>
-</tr>
-<tr class="row-even"><td><strong>ATANH</strong></td>
-<td>1 1</td>
-<td>atanh (A)</td>
-</tr>
-<tr class="row-odd"><td><strong>BEI</strong></td>
-<td>1 1</td>
-<td>bei (A)</td>
-</tr>
-<tr class="row-even"><td><strong>BER</strong></td>
-<td>1 1</td>
-<td>ber (A)</td>
-</tr>
-<tr class="row-odd"><td><strong>BITAND</strong></td>
-<td>2 1</td>
-<td>A & B (bitwise AND operator)</td>
-</tr>
-<tr class="row-even"><td><strong>BITLEFT</strong></td>
-<td>2 1</td>
-<td>A << B (bitwise left-shift operator)</td>
-</tr>
-<tr class="row-odd"><td><strong>BITNOT</strong></td>
-<td>1 1</td>
-<td>~A (bitwise NOT operator, i.e., return two’s complement)</td>
-</tr>
-<tr class="row-even"><td><strong>BITOR</strong></td>
-<td>2 1</td>
-<td>A | B (bitwise OR operator)</td>
-</tr>
-<tr class="row-odd"><td><strong>BITRIGHT</strong></td>
-<td>2 1</td>
-<td>A >> B (bitwise right-shift operator)</td>
-</tr>
-<tr class="row-even"><td><strong>BITTEST</strong></td>
-<td>2 1</td>
-<td>1 if bit B of A is set, else 0 (bitwise TEST operator)</td>
-</tr>
-<tr class="row-odd"><td><strong>BITXOR</strong></td>
-<td>2 1</td>
-<td>A ^ B (bitwise XOR operator)</td>
-</tr>
-<tr class="row-even"><td><strong>CAZ</strong></td>
-<td>2 1</td>
-<td>Cartesian azimuth from grid nodes to stack x,y (i.e., A, B)</td>
-</tr>
-<tr class="row-odd"><td><strong>CBAZ</strong></td>
-<td>2 1</td>
-<td>Cartesian backazimuth from grid nodes to stack x,y (i.e., A, B)</td>
-</tr>
-<tr class="row-even"><td><strong>CDIST</strong></td>
-<td>2 1</td>
-<td>Cartesian distance between grid nodes and stack x,y (i.e., A, B)</td>
-</tr>
-<tr class="row-odd"><td><strong>CEIL</strong></td>
-<td>1 1</td>
-<td>ceil (A) (smallest integer >= A)</td>
-</tr>
-<tr class="row-even"><td><strong>CHICRIT</strong></td>
-<td>2 1</td>
-<td>Critical value for chi-squared-distribution, with alpha = A and n = B</td>
-</tr>
-<tr class="row-odd"><td><strong>CHIDIST</strong></td>
-<td>2 1</td>
-<td>chi-squared-distribution P(chi2,n), with chi2 = A and n = B</td>
-</tr>
-<tr class="row-even"><td><strong>CORRCOEFF</strong></td>
-<td>2 1</td>
-<td>Correlation coefficient r(A, B)</td>
-</tr>
-<tr class="row-odd"><td><strong>COS</strong></td>
-<td>1 1</td>
-<td>cos (A) (A in radians)</td>
-</tr>
-<tr class="row-even"><td><strong>COSD</strong></td>
-<td>1 1</td>
-<td>cos (A) (A in degrees)</td>
-</tr>
-<tr class="row-odd"><td><strong>COSH</strong></td>
-<td>1 1</td>
-<td>cosh (A)</td>
-</tr>
-<tr class="row-even"><td><strong>COT</strong></td>
-<td>1 1</td>
-<td>cot (A) (A in radians)</td>
-</tr>
-<tr class="row-odd"><td><strong>COTD</strong></td>
-<td>1 1</td>
-<td>cot (A) (A in degrees)</td>
-</tr>
-<tr class="row-even"><td><strong>CPOISS</strong></td>
-<td>2 1</td>
-<td>Cumulative Poisson distribution F(x,lambda), with x = A and lambda = B</td>
-</tr>
-<tr class="row-odd"><td><strong>CSC</strong></td>
-<td>1 1</td>
-<td>csc (A) (A in radians)</td>
-</tr>
-<tr class="row-even"><td><strong>CSCD</strong></td>
-<td>1 1</td>
-<td>csc (A) (A in degrees)</td>
-</tr>
-<tr class="row-odd"><td><strong>CURV</strong></td>
-<td>1 1</td>
-<td>Curvature of A (Laplacian)</td>
-</tr>
-<tr class="row-even"><td><strong>D2DX2</strong></td>
-<td>1 1</td>
-<td>d^2(A)/dx^2 2nd derivative</td>
-</tr>
-<tr class="row-odd"><td><strong>D2DY2</strong></td>
-<td>1 1</td>
-<td>d^2(A)/dy^2 2nd derivative</td>
-</tr>
-<tr class="row-even"><td><strong>D2DXY</strong></td>
-<td>1 1</td>
-<td>d^2(A)/dxdy 2nd derivative</td>
-</tr>
-<tr class="row-odd"><td><strong>D2R</strong></td>
-<td>1 1</td>
-<td>Converts Degrees to Radians</td>
-</tr>
-<tr class="row-even"><td><strong>DDX</strong></td>
-<td>1 1</td>
-<td>d(A)/dx Central 1st derivative</td>
-</tr>
-<tr class="row-odd"><td><strong>DDY</strong></td>
-<td>1 1</td>
-<td>d(A)/dy Central 1st derivative</td>
-</tr>
-<tr class="row-even"><td><strong>DEG2KM</strong></td>
-<td>1 1</td>
-<td>Converts Spherical Degrees to Kilometers</td>
-</tr>
-<tr class="row-odd"><td><strong>DILOG</strong></td>
-<td>1 1</td>
-<td>dilog (A)</td>
-</tr>
-<tr class="row-even"><td><strong>DIV</strong></td>
-<td>2 1</td>
-<td>A / B</td>
-</tr>
-<tr class="row-odd"><td><strong>DUP</strong></td>
-<td>1 2</td>
-<td>Places duplicate of A on the stack</td>
-</tr>
-<tr class="row-even"><td><strong>ERF</strong></td>
-<td>1 1</td>
-<td>Error function erf (A)</td>
-</tr>
-<tr class="row-odd"><td><strong>ERFC</strong></td>
-<td>1 1</td>
-<td>Complementary Error function erfc (A)</td>
-</tr>
-<tr class="row-even"><td><strong>EQ</strong></td>
-<td>2 1</td>
-<td>1 if A == B, else 0</td>
-</tr>
-<tr class="row-odd"><td><strong>ERFINV</strong></td>
-<td>1 1</td>
-<td>Inverse error function of A</td>
-</tr>
-<tr class="row-even"><td><strong>EXCH</strong></td>
-<td>2 2</td>
-<td>Exchanges A and B on the stack</td>
-</tr>
-<tr class="row-odd"><td><strong>EXP</strong></td>
-<td>1 1</td>
-<td>exp (A)</td>
-</tr>
-<tr class="row-even"><td><strong>FACT</strong></td>
-<td>1 1</td>
-<td>A! (A factorial)</td>
-</tr>
-<tr class="row-odd"><td><strong>EXTREMA</strong></td>
-<td>1 1</td>
-<td>Local Extrema: +2/-2 is max/min, +1/-1 is saddle with max/min in x, 0 elsewhere</td>
-</tr>
-<tr class="row-even"><td><strong>FCRIT</strong></td>
-<td>3 1</td>
-<td>Critical value for F-distribution, with alpha = A, n1 = B, and n2 = C</td>
-</tr>
-<tr class="row-odd"><td><strong>FDIST</strong></td>
-<td>3 1</td>
-<td>F-distribution Q(F,n1,n2), with F = A, n1 = B, and n2 = C</td>
-</tr>
-<tr class="row-even"><td><strong>FLIPLR</strong></td>
-<td>1 1</td>
-<td>Reverse order of values in each row</td>
-</tr>
-<tr class="row-odd"><td><strong>FLIPUD</strong></td>
-<td>1 1</td>
-<td>Reverse order of values in each column</td>
-</tr>
-<tr class="row-even"><td><strong>FLOOR</strong></td>
-<td>1 1</td>
-<td>floor (A) (greatest integer <= A)</td>
-</tr>
-<tr class="row-odd"><td><strong>FMOD</strong></td>
-<td>2 1</td>
-<td>A % B (remainder after truncated division)</td>
-</tr>
-<tr class="row-even"><td><strong>GE</strong></td>
-<td>2 1</td>
-<td>1 if A >= B, else 0</td>
-</tr>
-<tr class="row-odd"><td><strong>GT</strong></td>
-<td>2 1</td>
-<td>1 if A > B, else 0</td>
-</tr>
-<tr class="row-even"><td><strong>HYPOT</strong></td>
-<td>2 1</td>
-<td>hypot (A, B) = sqrt (A*A + B*B)</td>
-</tr>
-<tr class="row-odd"><td><strong>I0</strong></td>
-<td>1 1</td>
-<td>Modified Bessel function of A (1st kind, order 0)</td>
-</tr>
-<tr class="row-even"><td><strong>I1</strong></td>
-<td>1 1</td>
-<td>Modified Bessel function of A (1st kind, order 1)</td>
-</tr>
-<tr class="row-odd"><td><strong>IFELSE</strong></td>
-<td>3 1</td>
-<td>B if A != 0, else C</td>
-</tr>
-<tr class="row-even"><td><strong>IN</strong></td>
-<td>2 1</td>
-<td>Modified Bessel function of A (1st kind, order B)</td>
-</tr>
-<tr class="row-odd"><td><strong>INRANGE</strong></td>
-<td>3 1</td>
-<td>1 if B <= A <= C, else 0</td>
-</tr>
-<tr class="row-even"><td><strong>INSIDE</strong></td>
-<td>1 1</td>
-<td>1 when inside or on polygon(s) in A, else 0</td>
-</tr>
-<tr class="row-odd"><td><strong>INV</strong></td>
-<td>1 1</td>
-<td>1 / A</td>
-</tr>
-<tr class="row-even"><td><strong>ISFINITE</strong></td>
-<td>1 1</td>
-<td>1 if A is finite, else 0</td>
-</tr>
-<tr class="row-odd"><td><strong>ISNAN</strong></td>
-<td>1 1</td>
-<td>1 if A == NaN, else 0</td>
-</tr>
-<tr class="row-even"><td><strong>J0</strong></td>
-<td>1 1</td>
-<td>Bessel function of A (1st kind, order 0)</td>
-</tr>
-<tr class="row-odd"><td><strong>J1</strong></td>
-<td>1 1</td>
-<td>Bessel function of A (1st kind, order 1)</td>
-</tr>
-<tr class="row-even"><td><strong>JN</strong></td>
-<td>2 1</td>
-<td>Bessel function of A (1st kind, order B)</td>
-</tr>
-<tr class="row-odd"><td><strong>K0</strong></td>
-<td>1 1</td>
-<td>Modified Kelvin function of A (2nd kind, order 0)</td>
-</tr>
-<tr class="row-even"><td><strong>K1</strong></td>
-<td>1 1</td>
-<td>Modified Bessel function of A (2nd kind, order 1)</td>
-</tr>
-<tr class="row-odd"><td><strong>KEI</strong></td>
-<td>1 1</td>
-<td>kei (A)</td>
-</tr>
-<tr class="row-even"><td><strong>KER</strong></td>
-<td>1 1</td>
-<td>ker (A)</td>
-</tr>
-<tr class="row-odd"><td><strong>KM2DEG</strong></td>
-<td>1 1</td>
-<td>Converts Kilometers to Spherical Degrees</td>
-</tr>
-<tr class="row-even"><td><strong>KN</strong></td>
-<td>2 1</td>
-<td>Modified Bessel function of A (2nd kind, order B)</td>
-</tr>
-<tr class="row-odd"><td><strong>KURT</strong></td>
-<td>1 1</td>
-<td>Kurtosis of A</td>
-</tr>
-<tr class="row-even"><td><strong>LDIST</strong></td>
-<td>1 1</td>
-<td>Compute minimum distance (in km if -fg) from lines in multi-segment ASCII file A</td>
-</tr>
-<tr class="row-odd"><td><strong>LDIST2</strong></td>
-<td>2 1</td>
-<td>As LDIST, from lines in ASCII file B but only to nodes where A != 0</td>
-</tr>
-<tr class="row-even"><td><strong>LE</strong></td>
-<td>2 1</td>
-<td>1 if A <= B, else 0</td>
-</tr>
-<tr class="row-odd"><td><strong>LOG</strong></td>
-<td>1 1</td>
-<td>log (A) (natural log)</td>
-</tr>
-<tr class="row-even"><td><strong>LOG10</strong></td>
-<td>1 1</td>
-<td>log10 (A) (base 10)</td>
-</tr>
-<tr class="row-odd"><td><strong>LOG1P</strong></td>
-<td>1 1</td>
-<td>log (1+A) (accurate for small A)</td>
-</tr>
-<tr class="row-even"><td><strong>LOG2</strong></td>
-<td>1 1</td>
-<td>log2 (A) (base 2)</td>
-</tr>
-<tr class="row-odd"><td><strong>LMSSCL</strong></td>
-<td>1 1</td>
-<td>LMS scale estimate (LMS STD) of A</td>
-</tr>
-<tr class="row-even"><td><strong>LOWER</strong></td>
-<td>1 1</td>
-<td>The lowest (minimum) value of A</td>
-</tr>
-<tr class="row-odd"><td><strong>LRAND</strong></td>
-<td>2 1</td>
-<td>Laplace random noise with mean A and std. deviation B</td>
-</tr>
-<tr class="row-even"><td><strong>LT</strong></td>
-<td>2 1</td>
-<td>1 if A < B, else 0</td>
-</tr>
-<tr class="row-odd"><td><strong>MAD</strong></td>
-<td>1 1</td>
-<td>Median Absolute Deviation (L1 STD) of A</td>
-</tr>
-<tr class="row-even"><td><strong>MAX</strong></td>
-<td>2 1</td>
-<td>Maximum of A and B</td>
-</tr>
-<tr class="row-odd"><td><strong>MEAN</strong></td>
-<td>1 1</td>
-<td>Mean value of A</td>
-</tr>
-<tr class="row-even"><td><strong>MED</strong></td>
-<td>1 1</td>
-<td>Median value of A</td>
-</tr>
-<tr class="row-odd"><td><strong>MIN</strong></td>
-<td>2 1</td>
-<td>Minimum of A and B</td>
-</tr>
-<tr class="row-even"><td><strong>MOD</strong></td>
-<td>2 1</td>
-<td>A mod B (remainder after floored division)</td>
-</tr>
-<tr class="row-odd"><td><strong>MODE</strong></td>
-<td>1 1</td>
-<td>Mode value (Least Median of Squares) of A</td>
-</tr>
-<tr class="row-even"><td><strong>MUL</strong></td>
-<td>2 1</td>
-<td>A * B</td>
-</tr>
-<tr class="row-odd"><td><strong>NAN</strong></td>
-<td>2 1</td>
-<td>NaN if A == B, else A</td>
-</tr>
-<tr class="row-even"><td><strong>NEG</strong></td>
-<td>1 1</td>
-<td>-A</td>
-</tr>
-<tr class="row-odd"><td><strong>NEQ</strong></td>
-<td>2 1</td>
-<td>1 if A != B, else 0</td>
-</tr>
-<tr class="row-even"><td><strong>NORM</strong></td>
-<td>1 1</td>
-<td>Normalize (A) so max(A)-min(A) = 1</td>
-</tr>
-<tr class="row-odd"><td><strong>NOT</strong></td>
-<td>1 1</td>
-<td>NaN if A == NaN, 1 if A == 0, else 0</td>
-</tr>
-<tr class="row-even"><td><strong>NRAND</strong></td>
-<td>2 1</td>
-<td>Normal, random values with mean A and std. deviation B</td>
-</tr>
-<tr class="row-odd"><td><strong>OR</strong></td>
-<td>2 1</td>
-<td>NaN if B == NaN, else A</td>
-</tr>
-<tr class="row-even"><td><strong>PDIST</strong></td>
-<td>1 1</td>
-<td>Compute minimum distance (in km if -fg) from points in ASCII file A</td>
-</tr>
-<tr class="row-odd"><td><strong>PDIST2</strong></td>
-<td>2 1</td>
-<td>As PDIST, from points in ASCII file B but only to nodes where A != 0</td>
-</tr>
-<tr class="row-even"><td><strong>POP</strong></td>
-<td>1 0</td>
-<td>Delete top element from the stack</td>
-</tr>
-<tr class="row-odd"><td><strong>PLM</strong></td>
-<td>3 1</td>
-<td>Associated Legendre polynomial P(A) degree B order C</td>
-</tr>
-<tr class="row-even"><td><strong>PLMg</strong></td>
-<td>3 1</td>
-<td>Normalized associated Legendre polynomial P(A) degree B order C (geophysical convention)</td>
-</tr>
-<tr class="row-odd"><td><strong>POW</strong></td>
-<td>2 1</td>
-<td>A ^ B</td>
-</tr>
-<tr class="row-even"><td><strong>PQUANT</strong></td>
-<td>2 1</td>
-<td>The B’th Quantile (0-100%) of A</td>
-</tr>
-<tr class="row-odd"><td><strong>PSI</strong></td>
-<td>1 1</td>
-<td>Psi (or Digamma) of A</td>
-</tr>
-<tr class="row-even"><td><strong>PV</strong></td>
-<td>3 1</td>
-<td>Legendre function Pv(A) of degree v = real(B) + imag(C)</td>
-</tr>
-<tr class="row-odd"><td><strong>QV</strong></td>
-<td>3 1</td>
-<td>Legendre function Qv(A) of degree v = real(B) + imag(C)</td>
-</tr>
-<tr class="row-even"><td><strong>R2</strong></td>
-<td>2 1</td>
-<td>R2 = A^2 + B^2</td>
-</tr>
-<tr class="row-odd"><td><strong>R2D</strong></td>
-<td>1 1</td>
-<td>Convert Radians to Degrees</td>
-</tr>
-<tr class="row-even"><td><strong>RAND</strong></td>
-<td>2 1</td>
-<td>Uniform random values between A and B</td>
-</tr>
-<tr class="row-odd"><td><strong>RINT</strong></td>
-<td>1 1</td>
-<td>rint (A) (round to integral value nearest to A)</td>
-</tr>
-<tr class="row-even"><td><strong>ROTX</strong></td>
-<td>2 1</td>
-<td>Rotate A by the (constant) shift B in x-direction</td>
-</tr>
-<tr class="row-odd"><td><strong>ROTY</strong></td>
-<td>2 1</td>
-<td>Rotate A by the (constant) shift B in y-direction</td>
-</tr>
-<tr class="row-even"><td><strong>SDIST</strong></td>
-<td>2 1</td>
-<td>Spherical (Great circle|geodesic) distance (in km) between nodes and stack (A, B) <a class="reference internal" href="#sdist"><em>(...)</em></a></td>
-</tr>
-<tr class="row-odd"><td><strong>SAZ</strong></td>
-<td>2 1</td>
-<td>Spherical azimuth from grid nodes to stack lon, lat (i.e., A, B)</td>
-</tr>
-<tr class="row-even"><td><strong>SBAZ</strong></td>
-<td>2 1</td>
-<td>Spherical backazimuth from grid nodes to stack lon, lat (i.e., A, B)</td>
-</tr>
-<tr class="row-odd"><td><strong>SEC</strong></td>
-<td>1 1</td>
-<td>sec (A) (A in radians)</td>
-</tr>
-<tr class="row-even"><td><strong>SECD</strong></td>
-<td>1 1</td>
-<td>sec (A) (A in degrees)</td>
-</tr>
-<tr class="row-odd"><td><strong>SIGN</strong></td>
-<td>1 1</td>
-<td>sign (+1 or -1) of A</td>
-</tr>
-<tr class="row-even"><td><strong>SIN</strong></td>
-<td>1 1</td>
-<td>sin (A) (A in radians)</td>
-</tr>
-<tr class="row-odd"><td><strong>SINC</strong></td>
-<td>1 1</td>
-<td>sinc (A) (sin (pi*A)/(pi*A))</td>
-</tr>
-<tr class="row-even"><td><strong>SIND</strong></td>
-<td>1 1</td>
-<td>sin (A) (A in degrees)</td>
-</tr>
-<tr class="row-odd"><td><strong>SINH</strong></td>
-<td>1 1</td>
-<td>sinh (A)</td>
-</tr>
-<tr class="row-even"><td><strong>SKEW</strong></td>
-<td>1 1</td>
-<td>Skewness of A</td>
-</tr>
-<tr class="row-odd"><td><strong>SQR</strong></td>
-<td>1 1</td>
-<td>A^2</td>
-</tr>
-<tr class="row-even"><td><strong>SQRT</strong></td>
-<td>1 1</td>
-<td>sqrt (A)</td>
-</tr>
-<tr class="row-odd"><td><strong>STD</strong></td>
-<td>1 1</td>
-<td>Standard deviation of A</td>
-</tr>
-<tr class="row-even"><td><strong>STEP</strong></td>
-<td>1 1</td>
-<td>Heaviside step function: H(A)</td>
-</tr>
-<tr class="row-odd"><td><strong>STEPX</strong></td>
-<td>1 1</td>
-<td>Heaviside step function in x: H(x-A)</td>
-</tr>
-<tr class="row-even"><td><strong>STEPY</strong></td>
-<td>1 1</td>
-<td>Heaviside step function in y: H(y-A)</td>
-</tr>
-<tr class="row-odd"><td><strong>SUB</strong></td>
-<td>2 1</td>
-<td>A - B</td>
-</tr>
-<tr class="row-even"><td><strong>SUM</strong></td>
-<td>1 1</td>
-<td>Sum of all values in A</td>
-</tr>
-<tr class="row-odd"><td><strong>TAN</strong></td>
-<td>1 1</td>
-<td>tan (A) (A in radians)</td>
-</tr>
-<tr class="row-even"><td><strong>TAND</strong></td>
-<td>1 1</td>
-<td>tan (A) (A in degrees)</td>
-</tr>
-<tr class="row-odd"><td><strong>TANH</strong></td>
-<td>1 1</td>
-<td>tanh (A)</td>
-</tr>
-<tr class="row-even"><td><strong>TAPER</strong></td>
-<td>2 1</td>
-<td>Unit weights cosine-tapered to zero within A and B of x and y grid margins</td>
-</tr>
-<tr class="row-odd"><td><strong>TN</strong></td>
-<td>2 1</td>
-<td>Chebyshev polynomial Tn(-1<t<+1,n), with t = A, and n = B</td>
-</tr>
-<tr class="row-even"><td><strong>TCRIT</strong></td>
-<td>2 1</td>
-<td>Critical value for Student’s t-distribution, with alpha = A and n = B</td>
-</tr>
-<tr class="row-odd"><td><strong>TDIST</strong></td>
-<td>2 1</td>
-<td>Student’s t-distribution A(t,n), with t = A, and n = B</td>
-</tr>
-<tr class="row-even"><td><strong>UPPER</strong></td>
-<td>1 1</td>
-<td>The highest (maximum) value of A</td>
-</tr>
-<tr class="row-odd"><td><strong>XOR</strong></td>
-<td>2 1</td>
-<td>0 if A == NaN and B == NaN, NaN if B == NaN, else A</td>
-</tr>
-<tr class="row-even"><td><strong>Y0</strong></td>
-<td>1 1</td>
-<td>Bessel function of A (2nd kind, order 0)</td>
-</tr>
-<tr class="row-odd"><td><strong>Y1</strong></td>
-<td>1 1</td>
-<td>Bessel function of A (2nd kind, order 1)</td>
-</tr>
-<tr class="row-even"><td><strong>YLM</strong></td>
-<td>2 2</td>
-<td>Re and Im orthonormalized spherical harmonics degree A order B</td>
-</tr>
-<tr class="row-odd"><td><strong>YLMg</strong></td>
-<td>2 2</td>
-<td>Cos and Sin normalized spherical harmonics degree A order B (geophysical convention)</td>
-</tr>
-<tr class="row-even"><td><strong>YN</strong></td>
-<td>2 1</td>
-<td>Bessel function of A (2nd kind, order B)</td>
-</tr>
-<tr class="row-odd"><td><strong>ZCRIT</strong></td>
-<td>1 1</td>
-<td>Critical value for the normal-distribution, with alpha = A</td>
-</tr>
-<tr class="row-even"><td><strong>ZDIST</strong></td>
-<td>1 1</td>
-<td>Cumulative normal-distribution C(x), with x = A</td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="symbols">
-<h2>Symbols<a class="headerlink" href="#symbols" title="Permalink to this headline">¶</a></h2>
-<p>The following symbols have special meaning:</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="21%" />
-<col width="79%" />
-</colgroup>
-<tbody valign="top">
-<tr class="row-odd"><td><strong>PI</strong></td>
-<td>3.1415926...</td>
-</tr>
-<tr class="row-even"><td><strong>E</strong></td>
-<td>2.7182818...</td>
-</tr>
-<tr class="row-odd"><td><strong>EULER</strong></td>
-<td>0.5772156...</td>
-</tr>
-<tr class="row-even"><td><strong>XMIN</strong></td>
-<td>Minimum x value</td>
-</tr>
-<tr class="row-odd"><td><strong>XMAX</strong></td>
-<td>Maximum x value</td>
-</tr>
-<tr class="row-even"><td><strong>XINC</strong></td>
-<td>x increment</td>
-</tr>
-<tr class="row-odd"><td><strong>NX</strong></td>
-<td>The number of x nodes</td>
-</tr>
-<tr class="row-even"><td><strong>YMIN</strong></td>
-<td>Minimum y value</td>
-</tr>
-<tr class="row-odd"><td><strong>YMAX</strong></td>
-<td>Maximum y value</td>
-</tr>
-<tr class="row-even"><td><strong>YINC</strong></td>
-<td>y increment</td>
-</tr>
-<tr class="row-odd"><td><strong>NY</strong></td>
-<td>The number of y nodes</td>
-</tr>
-<tr class="row-even"><td><strong>X</strong></td>
-<td>Grid with x-coordinates</td>
-</tr>
-<tr class="row-odd"><td><strong>Y</strong></td>
-<td>Grid with y-coordinates</td>
-</tr>
-<tr class="row-even"><td><strong>Xn</strong></td>
-<td>Grid with normalized [-1 to +1] x-coordinates</td>
-</tr>
-<tr class="row-odd"><td><strong>Yn</strong></td>
-<td>Grid with normalized [-1 to +1] y-coordinates</td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="notes-on-operators">
-<h2>Notes On Operators<a class="headerlink" href="#notes-on-operators" title="Permalink to this headline">¶</a></h2>
-<ol class="arabic">
-<li><p class="first">The operator <strong>SDIST</strong> calculates spherical distances in km between the
-(lon, lat) point on the stack and all node positions in the grid. The
-grid domain and the (lon, lat) point are expected to be in degrees.
-Similarly, the <strong>SAZ</strong> and <strong>SBAZ</strong> operators calculate spherical
-azimuth and back-azimuths in degrees, respectively. The operators
-<strong>LDIST</strong> and <strong>PDIST</strong> compute spherical distances in km if <strong>-fg</strong> is
-set or implied, else they return Cartesian distances. Note: If the current
-<a class="reference internal" href="gmt.conf.html#projection-parameters"><em>PROJ_ELLIPSOID</em></a> is ellipsoidal then
-geodesics are used in calculations of distances, which can be slow.
-You can trade speed with accuracy by changing the algorithm used to
-compute the geodesic (see <a class="reference internal" href="gmt.conf.html#projection-parameters"><em>PROJ_GEODESIC</em></a>).</p>
-</li>
-<li><p class="first">The operator <strong>PLM</strong> calculates the associated Legendre polynomial
-of degree L and order M (0 <= M <= L), and its argument is the sine of
-the latitude. <strong>PLM</strong> is not normalized and includes the Condon-Shortley
-phase (-1)^M. <strong>PLMg</strong> is normalized in the way that is most commonly
-used in geophysics. The C-S phase can be added by using -M as argument.
-<strong>PLM</strong> will overflow at higher degrees, whereas <strong>PLMg</strong> is stable
-until ultra high degrees (at least 3000).</p>
-</li>
-<li><p class="first">The operators <strong>YLM</strong> and <strong>YLMg</strong> calculate normalized spherical
-harmonics for degree L and order M (0 <= M <= L) for all positions in
-the grid, which is assumed to be in degrees. <strong>YLM</strong> and <strong>YLMg</strong> return
-two grids, the real (cosine) and imaginary (sine) component of the
-complex spherical harmonic. Use the <strong>POP</strong> operator (and <strong>EXCH</strong>) to
-get rid of one of them, or save both by giving two consecutive = file.nc calls.</p>
-<p>The orthonormalized complex harmonics <strong>YLM</strong> are most commonly used in
-physics and seismology. The square of <strong>YLM</strong> integrates to 1 over a
-sphere. In geophysics, <strong>YLMg</strong> is normalized to produce unit power when
-averaging the cosine and sine terms (separately!) over a sphere (i.e.,
-their squares each integrate to 4 pi). The Condon-Shortley phase (-1)^M
-is not included in <strong>YLM</strong> or <strong>YLMg</strong>, but it can be added by using -M
-as argument.</p>
-</li>
-<li><p class="first">All the derivatives are based on central finite differences, with
-natural boundary conditions.</p>
-</li>
-<li><p class="first">Files that have the same names as some operators, e.g., <strong>ADD</strong>,
-<strong>SIGN</strong>, <strong>=</strong>, etc. should be identified by prepending the current
-directory (i.e., ./LOG).</p>
-</li>
-<li><p class="first">Piping of files is not allowed.</p>
-</li>
-<li><p class="first">The stack depth limit is hard-wired to 100.</p>
-</li>
-<li><p class="first">All functions expecting a positive radius (e.g., <strong>LOG</strong>, <strong>KEI</strong>,
-etc.) are passed the absolute value of their argument. (9) The bitwise
-operators (<strong>BITAND</strong>, <strong>BITLEFT</strong>, <strong>BITNOT</strong>, <strong>BITOR</strong>, <strong>BITRIGHT</strong>,
-<strong>BITTEST</strong>, and <strong>BITXOR</strong>) convert a grid’s single precision values to
-unsigned 32-bit ints to perform the bitwise operations. Consequently,
-the largest whole integer value that can be stored in a float grid is
-2^24 or 16,777,216. Any higher result will be masked to fit in the lower
-24 bits. Thus, bit operations are effectively limited to 24 bit. All
-bitwise operators return NaN if given NaN arguments or bit-settings <= 0.</p>
-</li>
-</ol>
-</div>
-<div class="section" id="grid-values-precision">
-<h2>Grid Values Precision<a class="headerlink" href="#grid-values-precision" title="Permalink to this headline">¶</a></h2>
-<p>Regardless of the precision of the input data, GMT programs that create
-grid files will internally hold the grids in 4-byte floating point
-arrays. This is done to conserve memory and furthermore most if not all
-real data can be stored using 4-byte floating point values. Data with
-higher precision (i.e., double precision values) will lose that
-precision once GMT operates on the grid or writes out new grids. To
-limit loss of precision when processing data you should always consider
-normalizing the data prior to processing.</p>
-</div>
-<div class="section" id="grid-file-formats">
-<h2>Grid File Formats<a class="headerlink" href="#grid-file-formats" title="Permalink to this headline">¶</a></h2>
-<p>By default GMT writes out grid as single precision floats in a
-COARDS-complaint netCDF file format. However, GMT is able to produce
-grid files in many other commonly used grid file formats and also
-facilitates so called “packing” of grids, writing out floating point
-data as 1- or 2-byte integers. To specify the precision, scale and
-offset, the user should add the suffix
-<strong>=</strong><em>id</em>[<strong>/</strong><em>scale</em><strong>/</strong><em>offset</em>[<strong>/</strong><em>nan</em>]], where
-<em>id</em> is a two-letter identifier of the grid type and precision, and
-<em>scale</em> and <em>offset</em> are optional scale factor and offset to be applied
-to all grid values, and <em>nan</em> is the value used to indicate missing
-data. When reading grids, the format is generally automatically
-recognized. If not, the same suffix can be added to input grid file
-names. See <a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section
-<a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a>
-of the GMT Technical Reference and Cookbook for more information.</p>
-<p>When reading a netCDF file that contains multiple grids, GMT will
-read, by default, the first 2-dimensional grid that can find in that
-file. To coax GMT into reading another multi-dimensional variable in
-the grid file, append <strong>?</strong><em>varname</em> to the file name, where <em>varname</em>
-is the name of the variable. Note that you may need to escape the
-special meaning of <strong>?</strong> in your shell program by putting a backslash in
-front of it, or by placing the filename and suffix between quotes or
-double quotes. The <strong>?</strong><em>varname</em> suffix can also be used for output
-grids to specify a variable name different from the default: “z”. See
-<a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section <a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a> of the GMT
-Technical Reference and Cookbook for more information, particularly on
-how to read splices of 3-, 4-, or 5-dimensional grids.</p>
-</div>
-<div class="section" id="geographical-and-time-coordinates">
-<h2>Geographical And Time Coordinates<a class="headerlink" href="#geographical-and-time-coordinates" title="Permalink to this headline">¶</a></h2>
-<p>When the output grid type is netCDF, the coordinates will be labeled
-“longitude”, “latitude”, or “time” based on the attributes of the input
-data or grid (if any) or on the <strong>-f</strong> or <strong>-R</strong> options. For example,
-both <strong>-f0x</strong> <strong>-f1t</strong> and <strong>-R</strong>90w/90e/0t/3t will result in a
-longitude/time grid. When the x, y, or z coordinate is time, it will be
-stored in the grid as relative time since epoch as specified by
-<a class="reference internal" href="gmt.conf.html#time-unit"><em>TIME_UNIT</em></a> and <a class="reference internal" href="gmt.conf.html#time-epoch"><em>TIME_EPOCH</em></a> in the
-<a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file or on the
-command line. In addition, the <strong>unit</strong> attribute of the time variable
-will indicate both this unit and epoch.</p>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc14">STORE, RECALL and CLEAR</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>You may store intermediate calculations to a named variable that you may
-recall and place on the stack at a later time. This is useful if you
-need access to a computed quantity many times in your expression as it
-will shorten the overall expression and improve readability. To save a
-result you use the special operator <strong>STO</strong>@<em>label</em>, where <em>label</em>
-is the name you choose to give the quantity. To recall the stored result
-to the stack at a later time, use [<strong>RCL</strong>]@<em>label</em>, i.e., <strong>RCL</strong>
-is optional. To clear memory you may use <strong>CLR</strong>@<em>label</em>. Note that
-<strong>STO</strong> and <strong>CLR</strong> leave the stack unchanged.</p>
-</div>
-<div class="section" id="macros">
-<h2>Macros<a class="headerlink" href="#macros" title="Permalink to this headline">¶</a></h2>
-<p>Users may save their favorite operator combinations as macros via the
-file <em>grdmath.macros</em> in their current or user directory. The file may contain
-any number of macros (one per record); comment lines starting with # are
-skipped. The format for the macros is <strong>name</strong> = <strong>arg1 arg2 ... arg2</strong>
-: <em>comment</em> where <strong>name</strong> is how the macro will be used. When this
-operator appears on the command line we simply replace it with the
-listed argument list. No macro may call another macro. As an example,
-the following macro expects three arguments (radius x0 y0) and sets the
-modes that are inside the given circle to 1 and those outside to 0:</p>
-<p>INCIRCLE = CDIST EXCH DIV 1 LE : usage: r x y INCIRCLE to return 1
-inside circle</p>
-<p>Note: Because geographic or time constants may be present in a macro, it
-is required that the optional comment flag (:) must be followed by a space.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p id="sdist">To compute all distances to north pole:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdmath -Rg -I1 0 90 SDIST = dist_to_NP.nc
-</pre></div>
-</div>
-</div></blockquote>
-<p>To take log10 of the average of 2 files, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdmath file1.nc file2.nc ADD 0.5 MUL LOG10 = file3.nc
-</pre></div>
-</div>
-</div></blockquote>
-<p>Given the file ages.nc, which holds seafloor ages in m.y., use the
-relation depth(in m) = 2500 + 350 * sqrt (age) to estimate normal seafloor depths:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdmath ages.nc SQRT 350 MUL 2500 ADD = depths.nc
-</pre></div>
-</div>
-</div></blockquote>
-<p>To find the angle a (in degrees) of the largest principal stress from
-the stress tensor given by the three files s_xx.nc s_yy.nc, and
-s_xy.nc from the relation tan (2*a) = 2 * s_xy / (s_xx - s_yy), use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdmath 2 s_xy.nc MUL s_xx.nc s_yy.nc SUB DIV ATAN 2 DIV = direction.nc
-</pre></div>
-</div>
-</div></blockquote>
-<p>To calculate the fully normalized spherical harmonic of degree 8 and
-order 4 on a 1 by 1 degree world map, using the real amplitude 0.4 and
-the imaginary amplitude 1.1:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdmath -R0/360/-90/90 -I1 8 4 YML 1.1 MUL EXCH 0.4 MUL ADD = harm.nc
-</pre></div>
-</div>
-</div></blockquote>
-<p>To extract the locations of local maxima that exceed 100 mGal in the file faa.nc:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdmath faa.nc DUP EXTREMA 2 EQ MUL DUP 100 GT MUL 0 NAN = z.nc
-gmt grd2xyz z.nc -s > max.xyz
-</pre></div>
-</div>
-</div></blockquote>
-<p>To demonstrate the use of named variables, consider this radial wave
-where we store and recall the normalized radial arguments in radians:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdmath -R0/10/0/10 -I0.25 5 5 CDIST 2 MUL PI MUL 5 DIV STO at r COS @r SIN MUL = wave.nc
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>Abramowitz, M., and I. A. Stegun, 1964, <em>Handbook of Mathematical
-Functions</em>, Applied Mathematics Series, vol. 55, Dover, New York.</p>
-<p>Holmes, S. A., and W. E. Featherstone, 2002, A unified approach to the
-Clenshaw summation and the recursive computation of very high degree and
-order normalised associated Legendre functions. <em>Journal of Geodesy</em>,
-76, 279-299.</p>
-<p>Press, W. H., S. A. Teukolsky, W. T. Vetterling, and B. P. Flannery,
-1992, <em>Numerical Recipes</em>, 2nd edition, Cambridge Univ., New York.</p>
-<p>Spanier, J., and K. B. Oldman, 1987, <em>An Atlas of Functions</em>, Hemisphere
-Publishing Corp.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="gmtmath.html"><em>gmtmath</em></a>,
-<a class="reference internal" href="grd2xyz.html"><em>grd2xyz</em></a>, <a class="reference internal" href="grdedit.html"><em>grdedit</em></a>,
-<a class="reference internal" href="grdinfo.html"><em>grdinfo</em></a>, <a class="reference internal" href="xyz2grd.html"><em>xyz2grd</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grdmath</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#operators">Operators</a></li>
-<li><a class="reference internal" href="#symbols">Symbols</a></li>
-<li><a class="reference internal" href="#notes-on-operators">Notes On Operators</a></li>
-<li><a class="reference internal" href="#grid-values-precision">Grid Values Precision</a></li>
-<li><a class="reference internal" href="#grid-file-formats">Grid File Formats</a></li>
-<li><a class="reference internal" href="#geographical-and-time-coordinates">Geographical And Time Coordinates</a></li>
-<li><a class="reference internal" href="#id1">STORE, RECALL and CLEAR</a></li>
-<li><a class="reference internal" href="#macros">Macros</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grdmask.html"
- title="previous chapter">grdmask</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grdpaste.html"
- title="next chapter">grdpaste</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/grdmath.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grdpaste.html" title="grdpaste"
- >next</a> </li>
- <li class="right" >
- <a href="grdmask.html" title="grdmask"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" >GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/grdpaste.html b/doc_release/html/grdpaste.html
deleted file mode 100644
index cf6b92c..0000000
--- a/doc_release/html/grdpaste.html
+++ /dev/null
@@ -1,259 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grdpaste — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GR" href="GR.html" />
- <link rel="next" title="grdproject" href="grdproject.html" />
- <link rel="prev" title="grdmath" href="grdmath.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grdproject.html" title="grdproject"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grdmath.html" title="grdmath"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" accesskey="U">GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grdpaste">
-<span id="index-0"></span><h1>grdpaste<a class="headerlink" href="#grdpaste" title="Permalink to this headline">¶</a></h1>
-<p>grdpaste - Join two grids along their common edge</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdpaste</strong> <em>file_a.nc file_b.nc</em> <strong>-G</strong><em>outfile.nc</em>
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdpaste</strong> will combine <em>file_a.nc</em> and <em>file_b.nc</em> into
-<em>outfile.nc</em> by pasting them together along their common edge. Files
-<em>file_a.nc</em> and <em>file_b.nc</em> must have the same dx, dy and have one
-edge in common. If in doubt, check with <strong>grdinfo</strong> and use <strong>grdcut</strong>
-and/or <strong>grdsample</strong> if necessary to prepare the edge joint. Note: For
-geographical grids, you may have to use <strong>-f</strong> to handle periodic longitudes
-unless the input grids are properly recognized as such via their meta-data.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>file_a.nc</em></dt>
-<dd>One of two files to be pasted together.</dd>
-<dt><em>file_b.nc</em></dt>
-<dd>The other of two files to be pasted together.</dd>
-<dt><strong>-G</strong><em>outfile.nc</em></dt>
-<dd>The name for the combined output.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="grid-file-formats">
-<h2>Grid File Formats<a class="headerlink" href="#grid-file-formats" title="Permalink to this headline">¶</a></h2>
-<p>By default GMT writes out grid as single precision floats in a
-COARDS-complaint netCDF file format. However, GMT is able to produce
-grid files in many other commonly used grid file formats and also
-facilitates so called “packing” of grids, writing out floating point
-data as 1- or 2-byte integers. To specify the precision, scale and
-offset, the user should add the suffix
-<strong>=</strong><em>id</em>[<strong>/</strong><em>scale</em><strong>/</strong><em>offset</em>[<strong>/</strong><em>nan</em>]], where
-<em>id</em> is a two-letter identifier of the grid type and precision, and
-<em>scale</em> and <em>offset</em> are optional scale factor and offset to be applied
-to all grid values, and <em>nan</em> is the value used to indicate missing
-data. When reading grids, the format is generally automatically
-recognized. If not, the same suffix can be added to input grid file
-names. See <a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section
-<a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a>
-of the GMT Technical Reference and Cookbook for more information.</p>
-<p>When reading a netCDF file that contains multiple grids, GMT will
-read, by default, the first 2-dimensional grid that can find in that
-file. To coax GMT into reading another multi-dimensional variable in
-the grid file, append <strong>?</strong><em>varname</em> to the file name, where <em>varname</em>
-is the name of the variable. Note that you may need to escape the
-special meaning of <strong>?</strong> in your shell program by putting a backslash in
-front of it, or by placing the filename and suffix between quotes or
-double quotes. The <strong>?</strong><em>varname</em> suffix can also be used for output
-grids to specify a variable name different from the default: “z”. See
-<a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section <a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a> of the GMT
-Technical Reference and Cookbook for more information, particularly on
-how to read splices of 3-, 4-, or 5-dimensional grids.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>Suppose file_a.nc is 150E - 180E and 0 - 30N, and file_b.nc is 150E -
-180E, -30S - 0, then you can make outfile.nc which will be 150 - 180 and
--30S - 30N by:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdpaste file_a.nc file_b.nc -Goutfile.nc -V -fg
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="grdblend.html"><em>grdblend</em></a>,
-<a class="reference internal" href="grdclip.html"><em>grdclip</em></a>,
-<a class="reference internal" href="grdcut.html"><em>grdcut</em></a>,
-<a class="reference internal" href="grdinfo.html"><em>grdinfo</em></a>,
-<a class="reference internal" href="grdsample.html"><em>grdsample</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grdpaste</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#grid-file-formats">Grid File Formats</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grdmath.html"
- title="previous chapter">grdmath</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grdproject.html"
- title="next chapter">grdproject</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/grdpaste.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grdproject.html" title="grdproject"
- >next</a> </li>
- <li class="right" >
- <a href="grdmath.html" title="grdmath"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" >GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/grdproject.html b/doc_release/html/grdproject.html
deleted file mode 100644
index 8e39cc8..0000000
--- a/doc_release/html/grdproject.html
+++ /dev/null
@@ -1,333 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grdproject — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GR" href="GR.html" />
- <link rel="next" title="grdraster" href="grdraster.html" />
- <link rel="prev" title="grdpaste" href="grdpaste.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grdraster.html" title="grdraster"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grdpaste.html" title="grdpaste"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" accesskey="U">GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grdproject">
-<span id="index-0"></span><h1>grdproject<a class="headerlink" href="#grdproject" title="Permalink to this headline">¶</a></h1>
-<p>grdproject - Forward and inverse map transformation of grids</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdproject</strong> <em>in_grdfile</em> <strong>-G</strong><em>out_grdfile</em> <strong>-J</strong><em>parameters</em>
-[ <strong>-A</strong>[<strong>c|i|p|e|f|k|M|n|u</strong>] ] [ <strong>-C</strong>[<em>dx/dy</em>] ] [
-<strong>-D</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]
-] [ <strong>-E</strong><em>dpi</em> ] [ <strong>-I</strong> ] [ <strong>-Mc</strong>|<strong>i</strong>|<strong>p</strong> ] [
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-n</strong>[<strong>b</strong>|<strong>c</strong>|<strong>l</strong>|<strong>n</strong>][<strong>+a</strong>][<strong>+b</strong><em>BC</em>][<strong>+t</strong><em>threshold</em>] ]
-[ <strong>-r</strong> ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdproject</strong> will do one of two things depending whether <strong>-I</strong> has
-been set. If set, it will transform a gridded data set from a
-rectangular coordinate system onto a geographical system by resampling
-the surface at the new nodes. If not set, it will project a geographical
-gridded data set onto a rectangular grid. To obtain the value at each
-new node, its location is inversely projected back onto the input grid
-after which a value is interpolated between the surrounding input grid
-values. By default bi-cubic interpolation is used. Aliasing is avoided
-by also forward projecting the input grid nodes. If two or more nodes
-are projected onto the same new node, their average will dominate in the
-calculation of the new node value. Interpolation and aliasing is
-controlled with the <strong>-n</strong> option. The new node spacing may be
-determined in one of several ways by specifying the grid spacing, number
-of nodes, or resolution. Nodes not constrained by input data are set to
-NaN.</p>
-<p>The <strong>-R</strong> option can be used to select a map region larger or smaller
-than that implied by the extent of the grid file.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>in_grdfile</em></dt>
-<dd>2-D binary grid file to be transformed. (See GRID FILE FORMATS below.)</dd>
-<dt><strong>-G</strong><em>out_grdfile</em></dt>
-<dd>Specify the name of the output grid file. (See GRID FILE FORMATS below.)</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-J</strong><em>parameters</em> <a class="reference internal" href="gmt.html#j-full"><em>(more ...)</em></a></dt>
-<dd>Select map projection.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong>[<strong>c|i|p|e|f|k|M|n|u</strong>]</dt>
-<dd>Force 1:1 scaling, i.e., output (or input, see <strong>-I</strong>) data are in
-actual projected meters [<strong>e</strong>]. To specify other units, append
-<strong>f</strong> (foot), <strong>k</strong> (km), <strong>M</strong> (statute mile), <strong>n</strong> (nautical
-mile), <strong>u</strong> (US survey foot), <strong>i</strong> (inch), <strong>c</strong> (cm), or <strong>p</strong>
-(point). Without <strong>-A</strong>, the output (or input, see <strong>-I</strong>) are in
-the units specified by <a class="reference internal" href="gmt.conf.html#proj-length-unit"><em>PROJ_LENGTH_UNIT</em></a> (but see <strong>-M</strong>).</dd>
-<dt><strong>-C</strong>[<em>dx/dy</em>]</dt>
-<dd>Let projected coordinates be relative to projection center [Default
-is relative to lower left corner]. Optionally, add offsets in the
-projected units to be added (or subtracted when <strong>-I</strong> is set) to
-(from) the projected coordinates, such as false eastings and
-northings for particular projection zones [0/0].</dd>
-<dt><strong>-D</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]</dt>
-<dd>Set the grid spacing for the new grid. Append <strong>m</strong> for arc minute,
-<strong>s</strong> for arc second. If neither <strong>-D</strong> nor <strong>-E</strong> are set then we
-select the same number of output nodes as there are input nodes.</dd>
-<dt><strong>-E</strong><em>dpi</em></dt>
-<dd>Set the resolution for the new grid in dots per inch.</dd>
-<dt><strong>-I</strong></dt>
-<dd>Do the Inverse transformation, from rectangular to geographical.</dd>
-<dt><strong>-Mc</strong>|<strong>i</strong>|<strong>p</strong></dt>
-<dd>Append <strong>c</strong>, <strong>i</strong>, or <strong>p</strong> to indicate that cm, inch, or point
-should be the projected measure unit [Default is set by
-<a class="reference internal" href="gmt.conf.html#proj-length-unit"><em>PROJ_LENGTH_UNIT</em></a> in <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>]. Cannot be used with <strong>-A</strong>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. You may ask to project only
-a subset of the grid by specifying a smaller input <em>w/e/s/n</em> region
-[Default is the region given by the grid file].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-n</strong>[<strong>b</strong>|<strong>c</strong>|<strong>l</strong>|<strong>n</strong>][<strong>+a</strong>][<strong>+b</strong><em>BC</em>][<strong>+c</strong>][<strong>+t</strong><em>threshold</em>] <a class="reference internal" href="gmt.html#n-full"><em>(more ...)</em></a></dt>
-<dd>Select interpolation mode for grids.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-r</strong> <a class="reference internal" href="gmt.html#nodereg-full"><em>(more ...)</em></a></dt>
-<dd>Set pixel node registration [gridline]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="grid-file-formats">
-<h2>Grid File Formats<a class="headerlink" href="#grid-file-formats" title="Permalink to this headline">¶</a></h2>
-<p>By default GMT writes out grid as single precision floats in a
-COARDS-complaint netCDF file format. However, GMT is able to produce
-grid files in many other commonly used grid file formats and also
-facilitates so called “packing” of grids, writing out floating point
-data as 1- or 2-byte integers. To specify the precision, scale and
-offset, the user should add the suffix
-<strong>=</strong><em>id</em>[<strong>/</strong><em>scale</em><strong>/</strong><em>offset</em>[<strong>/</strong><em>nan</em>]], where
-<em>id</em> is a two-letter identifier of the grid type and precision, and
-<em>scale</em> and <em>offset</em> are optional scale factor and offset to be applied
-to all grid values, and <em>nan</em> is the value used to indicate missing
-data. When reading grids, the format is generally automatically
-recognized. If not, the same suffix can be added to input grid file
-names. See <a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section
-<a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a>
-of the GMT Technical Reference and Cookbook for more information.</p>
-<p>When reading a netCDF file that contains multiple grids, GMT will
-read, by default, the first 2-dimensional grid that can find in that
-file. To coax GMT into reading another multi-dimensional variable in
-the grid file, append <strong>?</strong><em>varname</em> to the file name, where <em>varname</em>
-is the name of the variable. Note that you may need to escape the
-special meaning of <strong>?</strong> in your shell program by putting a backslash in
-front of it, or by placing the filename and suffix between quotes or
-double quotes. The <strong>?</strong><em>varname</em> suffix can also be used for output
-grids to specify a variable name different from the default: “z”. See
-<a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section <a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a> of the GMT
-Technical Reference and Cookbook for more information, particularly on
-how to read splices of 3-, 4-, or 5-dimensional grids.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To transform the geographical grid dbdb5.nc onto a pixel Mercator grid
-at 300 dpi, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdproject dbdb5.nc -R20/50/12/25 -Jm0.25i -E300 -r -Gdbdb5_merc.nc
-</pre></div>
-</div>
-</div></blockquote>
-<p>To inversely transform the file topo_tm.nc back onto a geographical grid, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdproject topo_tm.nc -R-80/-70/20/40 -Jt-75/1:500000 -I -D5m -V -Gtopo.nc
-</pre></div>
-</div>
-</div></blockquote>
-<p>This assumes, of course, that the coordinates in topo_tm.nc were
-created with the same projection parameters.</p>
-<p>To inversely transform the file topo_utm.nc (which is in UTM meters)
-back to a geographical grid we specify a one-to-one mapping with meter
-as the measure unit:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdproject topo_utm.nc -R203/205/60/65 -Ju5/1:1 -I -Mm -Gtopo.nc -V
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="restrictions">
-<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
-<p>The boundaries of a projected (rectangular) data set will not
-necessarily give rectangular geographical boundaries (Mercator is one
-exception). In those cases some nodes may be unconstrained (set to NaN).
-To get a full grid back, your input grid may have to cover a larger area
-than you are interested in.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>, <a class="reference internal" href="mapproject.html"><em>mapproject</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grdproject</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#grid-file-formats">Grid File Formats</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#restrictions">Restrictions</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grdpaste.html"
- title="previous chapter">grdpaste</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grdraster.html"
- title="next chapter">grdraster</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/grdproject.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grdraster.html" title="grdraster"
- >next</a> </li>
- <li class="right" >
- <a href="grdpaste.html" title="grdpaste"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" >GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/grdraster.html b/doc_release/html/grdraster.html
deleted file mode 100644
index 7788678..0000000
--- a/doc_release/html/grdraster.html
+++ /dev/null
@@ -1,324 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grdraster — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GR" href="GR.html" />
- <link rel="next" title="grdreformat" href="grdreformat.html" />
- <link rel="prev" title="grdproject" href="grdproject.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grdreformat.html" title="grdreformat"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grdproject.html" title="grdproject"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" accesskey="U">GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grdraster">
-<span id="index-0"></span><h1>grdraster<a class="headerlink" href="#grdraster" title="Permalink to this headline">¶</a></h1>
-<p>grdraster - Extract subregion from a binary raster and save as a GMT grid</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdraster</strong> [ <em>filenumber</em> | <em>“text pattern”</em> ]
-<strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>]
-[ <strong>-G</strong><em>grdfile</em> ]
-[ <strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]] ]
-[ <strong>-J</strong><em>parameters</em> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-bo</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-o</strong><em>cols</em>[,...] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdraster</strong> reads a file called <em>grdraster.info</em> from the current
-working directory, the directories pointed to by the environment
-variables <strong>$GMT_USERDIR</strong> and <strong>$GMT_DATADIR</strong>, or in
-<strong>$GMT_SHAREDIR</strong>/dbase (in that order). The file <em>grdraster.info</em>
-defines binary arrays of data stored in scan-line format in data files.
-Each file is given a <em>filenumber</em> in the info file. <strong>grdraster</strong>
-figures out how to load the raster data into a grid file spanning a
-region defined by <strong>-R</strong>. By default the grid spacing equals the raster
-spacing. The <strong>-I</strong> option may be used to sub-sample the raster data. No
-filtering or interpolating is done, however; the <em>x_inc</em> and <em>y_inc</em>
-of the grid must be multiples of the increments of the raster file and
-<strong>grdraster</strong> simply takes every n’th point. The output of <strong>grdraster</strong>
-is either grid or pixel registered depending on the registration of the
-raster used. It is up to the GMT system person to maintain the
-<em>grdraster.info</em> file in accordance with the available rasters at each
-site. Raster data sets are not supplied with GMT but can be obtained
-by anonymous ftp and on CD-ROM (see README page in dbase directory).
-<strong>grdraster</strong> will list the available files if no arguments are given.
-Finally, <strong>grdraster</strong> will write xyz-triplets to stdout if no output
-gridfile name is given</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>filenumber</em></dt>
-<dd>If an integer matching one of the files listed in the
-<em>grdraster.info</em> file is given we will use that data set, else we
-will match the given text pattern with the data set description in
-order to determine the data set.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]</dt>
-<dd><em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> specify the region of interest,
-and you may specify them in decimal degrees or in
-[+-]dd:mm[:ss.xxx][W|E|S|N] format. Append <strong>r</strong> if lower left
-and upper right map coordinates are given instead of w/e/s/n. The
-two shorthands <strong>-Rg</strong> and <strong>-Rd</strong> stand for global domain (0/360
-and -180/+180 in longitude respectively, with -90/+90 in latitude).
-Alternatively, specify the name of an existing grid file and the
-<strong>-R</strong> settings (and grid spacing, if applicable) are copied from
-the grid. Using <strong>-R</strong><em>unit</em> expects projected (Cartesian)
-coordinates compatible with chosen <strong>-J</strong> and we inversely project
-to determine actual rectangular geographic region.
-For perspective view (<strong>-p</strong>), optionally append /<em>zmin</em>/<em>zmax</em>.
-In case of perspective view (<strong>-p</strong>), a z-range (<em>zmin</em>, <em>zmax</em>)
-can be appended to indicate the third dimension. This needs to be
-done only when using the <strong>-Jz</strong> option, not when using only the
-<strong>-p</strong> option. In the latter case a perspective view of the plane is
-plotted, with no third dimension. If <strong>r</strong> is appended, you may also specify a
-map projection to define the shape of your region. The output region
-will be rounded off to the nearest whole grid-step in both dimensions.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-G</strong><em>grdfile</em></dt>
-<dd>Name of output grid file. If not set, the grid will be written as
-ASCII (or binary; see <strong>-bo</strong>) xyz-triplets
-to stdout instead.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]</dt>
-<dd><em>x_inc</em> [and optionally <em>y_inc</em>] is the grid spacing. Optionally,
-append a suffix modifier. <strong>Geographical (degrees) coordinates</strong>: Append
-<strong>m</strong> to indicate arc minutes or <strong>s</strong> to indicate arc seconds. If one
-of the units <strong>e</strong>, <strong>f</strong>, <strong>k</strong>, <strong>M</strong>, <strong>n</strong> or <strong>u</strong> is appended
-instead, the increment is assumed to be given in meter, foot, km, Mile,
-nautical mile or US survey foot, respectively, and will be converted to
-the equivalent degrees longitude at the middle latitude of the region
-(the conversion depends on <a class="reference internal" href="gmt.conf.html#projection-parameters"><em>PROJ_ELLIPSOID</em></a>). If /<em>y_inc</em> is given
-but set to 0 it will be reset equal to <em>x_inc</em>; otherwise it will be
-converted to degrees latitude. <strong>All coordinates</strong>: If <strong>=</strong> is appended
-then the corresponding max <em>x</em> (<em>east</em>) or <em>y</em> (<em>north</em>) may be slightly
-adjusted to fit exactly the given increment [by default the increment
-may be adjusted slightly to fit the given domain]. Finally, instead of
-giving an increment you may specify the <em>number of nodes</em> desired by
-appending <strong>+</strong> to the supplied integer argument; the increment is then
-recalculated from the number of nodes and the domain. The resulting
-increment value depends on whether you have selected a
-gridline-registered or pixel-registered grid; see <a class="reference internal" href="GMT_Docs.html#app-file-formats"><em>B. GMT File Formats</em></a> for
-details. Note: if <strong>-R</strong><em>grdfile</em> is used then the grid spacing has
-already been initialized; use <strong>-I</strong> to override the values.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-J</strong><em>parameters</em> <a class="reference internal" href="gmt.html#j-full"><em>(more ...)</em></a></dt>
-<dd>Select map projection.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-o</strong><em>cols</em>[,...] <a class="reference internal" href="gmt.html#ocols-full"><em>(more ...)</em></a></dt>
-<dd>Select output columns (0 is first column).</dd>
-</dl>
-<div class="line-block">
-<div class="line"><br /></div>
-<div class="line-block">
-<div class="line">This option applies only if no <strong>-G</strong> option has been set.</div>
-</div>
-</div>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To extract data from raster 1, taking one point every 30 minutes, in an
-area extended beyond 360 degrees to allow later filtering, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdraster 1 -R-4/364/-62/62 -I30m -Gdata.nc
-</pre></div>
-</div>
-</div></blockquote>
-<p>To obtain data for an oblique Mercator projection we need to extract
-more data that is actually used. This is necessary because the output of
-<strong>grdraster</strong> has edges defined by parallels and meridians, while the
-oblique map in general does not. Hence, to get all the data from the
-ETOPO2 data needed to make a contour map for the region defined by its
-lower left and upper right corners and the desired projection, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdraster ETOPO2 -R160/20/220/30r -Joc190/25.5/292/69/1 -Gdata.nc
-</pre></div>
-</div>
-</div></blockquote>
-<p>To extract data from the 2 min Geoware relief blend and write it as
-binary double precision xyz-triplets to standard output:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdraster "2 min Geoware" -R20/25/-10/5 -bo > triplets.b
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmtdefaults.html"><em>gmtdefaults</em></a>, <a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="grdsample.html"><em>grdsample</em></a>, <a class="reference internal" href="grdfilter.html"><em>grdfilter</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grdraster</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grdproject.html"
- title="previous chapter">grdproject</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grdreformat.html"
- title="next chapter">grdreformat</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/grdraster.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grdreformat.html" title="grdreformat"
- >next</a> </li>
- <li class="right" >
- <a href="grdproject.html" title="grdproject"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" >GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/grdreformat.html b/doc_release/html/grdreformat.html
deleted file mode 100644
index 97acbce..0000000
--- a/doc_release/html/grdreformat.html
+++ /dev/null
@@ -1,459 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grdreformat — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GR" href="GR.html" />
- <link rel="next" title="grdsample" href="grdsample.html" />
- <link rel="prev" title="grdraster" href="grdraster.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grdsample.html" title="grdsample"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grdraster.html" title="grdraster"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" accesskey="U">GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grdreformat">
-<span id="index-0"></span><h1>grdreformat<a class="headerlink" href="#grdreformat" title="Permalink to this headline">¶</a></h1>
-<p>grdreformat - Convert between different grid formats</p>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc1">Synopsis</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdreformat</strong> <em>ingrdfile</em>[<em>=id</em>[<em>/scale/offset</em>[<em>/NaNvalue</em>]]]
-<em>outgrdfile</em>[<em>=id</em>[<em>/scale/offset</em>[<em>/NaNvalue</em>]][<em>:driver</em>[<em>/datatype</em>]]]
-[ <strong>-N</strong> ]
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdreformat</strong> reads a grid file in one format and writes it out using
-another format. As an option the user may select a subset of the data to
-be written and to specify scaling, translation, and NaN-value.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>ingrdfile</em></dt>
-<dd>The grid file to be read. Append format =<em>id</em> code if not a
-standard COARDS-compliant netCDF grid file. If =<em>id</em> is set (see
-below), you may optionally append <em>scale</em> and <em>offset</em>. These
-options will scale the data and then offset them with the specified
-amounts after reading.
-If <em>scale</em> and <em>offset</em> are supplied you may also append a value
-that represents ‘Not-a-Number’ (for floating-point grids this is
-unnecessary since the IEEE NaN is used; however integers need a
-value which means no data available). The <em>scale</em> and <em>offset</em>
-modifiers may be left empty to select default values (scale = 1,
-offset = 0).</dd>
-<dt><em>outgrdfile</em></dt>
-<dd><p class="first">The grid file to be written. Append format =<em>id</em> code if not a
-standard COARDS-compliant netCDF grid file. If =<em>id</em> is set (see
-below), you may optionally append <em>scale</em> and <em>offset</em>. These
-options are particularly practical when storing the data as
-integers, first removing an offset and then scaling down the values.
-Since the scale and offset are applied in reverse order when
-reading, this does not affect the data values (except for
-round-offs).</p>
-<p>If <em>scale</em> and <em>offset</em> are supplied you may also append a value
-that represents ‘Not-a-Number’ (for floating-point grids this is
-unnecessary since the IEEE NaN is used; however integers need a
-value which means no data available). The <em>scale</em> and <em>offset</em>
-modifiers may be left empty to select default values (scale = 1,
-offset = 0), or you may specify <em>a</em> for auto-adjusting the scale
-and/or offset of packed integer grids (=<em>id/a</em> is a shorthand for
-=<em>id/a/a</em>). When <em>id</em>=<em>gd</em>, the file will be saved using the
-GDAL library. Append the format <em>:driver</em> and optionally the output
-<em>datatype</em>. The driver names are those used by GDAL itself (e.g.,
-netCDF, GTiFF, etc.), and the data type is one of
-<em>u8</em>|<em>u16</em>|<em>i16</em>|<em>u32</em>|<em>i32</em>|<em>float32</em>,
-where ‘i’ and ‘u’ denote signed and unsigned integers respectively.
-The default type is <em>float32</em>. Note also that both driver names and
-data types are case insensitive.</p>
-<p class="last">Consider setting <a class="reference internal" href="gmt.conf.html#io-nc4-deflation-level"><em>IO_NC4_DEFLATION_LEVEL</em></a>
-to reduce file size and to further increase read/write performace.
-Especially when working with subsets of global grids, masks, and grids with
-repeating grid values, the improvement is usually significant.</p>
-</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-N</strong></dt>
-<dd>Suppress the writing of the GMT header structure. This is useful
-when you want to write a native grid to be used by <strong>grdraster</strong>. It
-only applies to native grids and is ignored for netCDF output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="format-identifier">
-<h2>Format Identifier<a class="headerlink" href="#format-identifier" title="Permalink to this headline">¶</a></h2>
-<p>By default, grids will be written as floating point data stored in
-binary files using the netCDF format and meta-data structure. This
-format is conform the COARDS conventions. GMT versions prior to 4.1
-produced netCDF files that did not conform to these conventions.
-Although these files are still supported, their use is deprecated. To
-write other than floating point COARDS-compliant netCDF files, append
-the =<em>id</em> suffix to the filename <em>outgrdfile</em>.</p>
-<p>When reading files, <strong>grdreformat</strong> and other GMT programs will try
-to automatically recognize the type of the input grid file. If this
-fails you may append the =<em>id</em> suffix to the filename <em>ingrdfile</em>.</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="14%" />
-<col width="86%" />
-</colgroup>
-<tbody valign="top">
-<tr class="row-odd"><td>ID</td>
-<td>Explanation</td>
-</tr>
-<tr class="row-even"><td><strong>nb</strong></td>
-<td>GMT netCDF format (8-bit integer, COARDS, CF-1.5)</td>
-</tr>
-<tr class="row-odd"><td><strong>ns</strong></td>
-<td>GMT netCDF format (16-bit integer, COARDS, CF-1.5)</td>
-</tr>
-<tr class="row-even"><td><strong>ni</strong></td>
-<td>GMT netCDF format (32-bit integer, COARDS, CF-1.5)</td>
-</tr>
-<tr class="row-odd"><td><strong>nf</strong></td>
-<td>GMT netCDF format (32-bit float, COARDS, CF-1.5)</td>
-</tr>
-<tr class="row-even"><td><strong>nd</strong></td>
-<td>GMT netCDF format (64-bit float, COARDS, CF-1.5)</td>
-</tr>
-<tr class="row-odd"><td><strong>cb</strong></td>
-<td>GMT netCDF format (8-bit integer, deprecated)</td>
-</tr>
-<tr class="row-even"><td><strong>cs</strong></td>
-<td>GMT netCDF format (16-bit integer, deprecated)</td>
-</tr>
-<tr class="row-odd"><td><strong>ci</strong></td>
-<td>GMT netCDF format (32-bit integer, deprecated)</td>
-</tr>
-<tr class="row-even"><td><strong>cf</strong></td>
-<td>GMT netCDF format (32-bit float, deprecated)</td>
-</tr>
-<tr class="row-odd"><td><strong>cd</strong></td>
-<td>GMT netCDF format (64-bit float, deprecated)</td>
-</tr>
-<tr class="row-even"><td><strong>bm</strong></td>
-<td>GMT native, C-binary format (bit-mask)</td>
-</tr>
-<tr class="row-odd"><td><strong>bb</strong></td>
-<td>GMT native, C-binary format (8-bit integer)</td>
-</tr>
-<tr class="row-even"><td><strong>bs</strong></td>
-<td>GMT native, C-binary format (16-bit integer)</td>
-</tr>
-<tr class="row-odd"><td><strong>bi</strong></td>
-<td>GMT native, C-binary format (32-bit integer)</td>
-</tr>
-<tr class="row-even"><td><strong>bf</strong></td>
-<td>GMT native, C-binary format (32-bit float)</td>
-</tr>
-<tr class="row-odd"><td><strong>bd</strong></td>
-<td>GMT native, C-binary format (64-bit float)</td>
-</tr>
-<tr class="row-even"><td><strong>rb</strong></td>
-<td>SUN rasterfile format (8-bit standard)</td>
-</tr>
-<tr class="row-odd"><td><strong>rf</strong></td>
-<td>GEODAS grid format GRD98 (NGDC)</td>
-</tr>
-<tr class="row-even"><td><strong>sf</strong></td>
-<td>Golden Software Surfer format 6 (32-bit float)</td>
-</tr>
-<tr class="row-odd"><td><strong>sd</strong></td>
-<td>Golden Software Surfer format 7 (64-bit float, read-only)</td>
-</tr>
-<tr class="row-even"><td><strong>af</strong></td>
-<td>Atlantic Geoscience Center format AGC (32-bit float)</td>
-</tr>
-<tr class="row-odd"><td><strong>ei</strong></td>
-<td>ESRI Arc/Info ASCII Grid Interchange format (ASCII integer)</td>
-</tr>
-<tr class="row-even"><td><strong>ef</strong></td>
-<td>ESRI Arc/Info ASCII Grid Interchange format (ASCII float)</td>
-</tr>
-<tr class="row-odd"><td><strong>gd</strong></td>
-<td>Import/export through GDAL</td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="gmt-standard-netcdf-files">
-<h2>Gmt Standard Netcdf Files<a class="headerlink" href="#gmt-standard-netcdf-files" title="Permalink to this headline">¶</a></h2>
-<p>The standard format used for grdfiles is based on netCDF and conforms to
-the COARDS conventions. Files written in this format can be read by
-numerous third-party programs and are platform-independent. Some
-disk-space can be saved by storing the data as bytes or shorts in stead
-of integers. Use the <em>scale</em> and <em>offset</em> parameters to make this work
-without loss of data range or significance. For more details, see
-<a class="reference internal" href="GMT_Docs.html#app-file-formats"><em>B. GMT File Formats</em></a>.</p>
-<p><strong>Multi-variable grid files</strong></p>
-<p>By default, GMT programs will read the first 2-dimensional grid
-contained in a COARDS-compliant netCDF file. Alternatively, use
-<em>ingrdfile</em><strong>?</strong><em>varname</em> (ahead of any optional suffix <strong>=</strong><em>id</em>)
-to specify the requested variable <em>varname</em>. Since <strong>?</strong> has special
-meaning as a wildcard, escape this meaning by placing the full filename
-and suffix between quotes.</p>
-<p><strong>Multi-dimensional grids</strong></p>
-<p>To extract one <em>layer</em> or <em>level</em> from a 3-dimensional grid stored in a
-COARDS-compliant netCDF file, append both the name of the variable and
-the index associated with the layer (starting at zero) in the form:
-<em>ingrdfile</em><strong>?</strong><em>varname</em><strong>[</strong><em>layer</em><strong>]</strong>. Alternatively,
-specify the value associated with that layer using parentheses in stead
-of brackets:
-<em>ingridfile</em><strong>?</strong><em>varname</em><strong>(</strong><em>layer</em><strong>)</strong>.</p>
-<p>In a similar way layers can be extracted from 4- or even 5-dimensional
-grids. For example, if a grid has the dimensions (parameter, time,
-depth, latitude, longitude), a map can be selected by using:
-<em>ingridfile</em><strong>?</strong><em>varname</em><strong>(</strong><em>parameter</em>,<em>time</em>,<em>depth</em><strong>)</strong>.</p>
-<p>Since question marks, brackets and parentheses have special meanings on
-the command line, escape these meanings by placing the full filename and
-suffix between quotes.</p>
-</div>
-<div class="section" id="native-binary-files">
-<h2>Native Binary Files<a class="headerlink" href="#native-binary-files" title="Permalink to this headline">¶</a></h2>
-<p>For binary native GMT files the size of the GMT grdheader block
-is <em>hsize</em> = 892 bytes, and the total size of the file is <em>hsize</em> + <em>nx</em>
-* <em>ny</em> * <em>item_size</em>, where <em>item_size</em> is the size in bytes of each
-element (1, 2, 4). Bit grids are stored using 4-byte integers, each
-holding 32 bits, so for these files the size equation is modified by
-using ceil (<em>nx</em> / 32) * 4 instead of <em>nx</em>. Note that these files are
-platform-dependent. Files written on Little Endian machines (e.g., PCs)
-can not be read on Big Endian machines (e.g., most workstations). Also
-note that it is not possible for GMT to determine uniquely if a
-4-byte grid is float or int; in such cases it is best to use the <em>=ID</em>
-mechanism to specify the file format. In all cases a native grid is
-considered to be signed (i.e., there are no provision for unsigned short
-ints or unsigned bytes). For header and grid details, see <a class="reference internal" href="GMT_Docs.html#app-file-formats"><em>B. GMT File Formats</em></a>.</p>
-</div>
-<div class="section" id="grid-values-precision">
-<h2>Grid Values Precision<a class="headerlink" href="#grid-values-precision" title="Permalink to this headline">¶</a></h2>
-<p>Regardless of the precision of the input data, GMT programs that create
-grid files will internally hold the grids in 4-byte floating point
-arrays. This is done to conserve memory and furthermore most if not all
-real data can be stored using 4-byte floating point values. Data with
-higher precision (i.e., double precision values) will lose that
-precision once GMT operates on the grid or writes out new grids. To
-limit loss of precision when processing data you should always consider
-normalizing the data prior to processing.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To extract the second layer from a 3-dimensional grid named temp from a
-COARDS-compliant netCDF file climate.nc:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdreformat climate.nc?temp[1] temp.nc -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>To create a 4-byte native floating point grid from the COARDS-compliant
-netCDF file data.nc:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdreformat data.nc ras_data.b4=bf -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>To make a 2-byte short integer file, scale it by 10, subtract 32000,
-setting NaNs to -9999, do</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdreformat values.nc shorts.i2=bs/10/-32000/-9999 -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>To create a Sun standard 8-bit rasterfile for a subset of the data file
-image.nc, assuming the range in image.nc is 0-1 and we need 0-255, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdreformat image.nc -R-60/-40/-40/-30 image.ras8=rb/255/0 -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>To convert etopo2.nc to etopo2.i2 that can be used by <strong>grdraster</strong>, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdreformat etopo2.nc etopo2.i2=bs -N -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>To creat a dumb file saved as a 32 bits float GeoTiff using GDAL, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdmath -Rd -I10 X Y MUL = lixo.tiff=gd:GTiff
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>, <a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="grdmath.html"><em>grdmath</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grdreformat</a><ul>
-<li><a class="reference internal" href="#id1">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#format-identifier">Format Identifier</a></li>
-<li><a class="reference internal" href="#gmt-standard-netcdf-files">Gmt Standard Netcdf Files</a></li>
-<li><a class="reference internal" href="#native-binary-files">Native Binary Files</a></li>
-<li><a class="reference internal" href="#grid-values-precision">Grid Values Precision</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grdraster.html"
- title="previous chapter">grdraster</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grdsample.html"
- title="next chapter">grdsample</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/grdreformat.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grdsample.html" title="grdsample"
- >next</a> </li>
- <li class="right" >
- <a href="grdraster.html" title="grdraster"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" >GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/grdsample.html b/doc_release/html/grdsample.html
deleted file mode 100644
index 24232a9..0000000
--- a/doc_release/html/grdsample.html
+++ /dev/null
@@ -1,338 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grdsample — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GR" href="GR.html" />
- <link rel="next" title="grdtrack" href="grdtrack.html" />
- <link rel="prev" title="grdreformat" href="grdreformat.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grdtrack.html" title="grdtrack"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grdreformat.html" title="grdreformat"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" accesskey="U">GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grdsample">
-<span id="index-0"></span><h1>grdsample<a class="headerlink" href="#grdsample" title="Permalink to this headline">¶</a></h1>
-<p>grdsample - Resample a grid onto a new lattice</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdsample</strong> <em>in_grdfile</em> <strong>-G</strong><em>out_grdfile</em>
-[ <strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]] ]
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-n</strong>[<strong>b</strong>|<strong>c</strong>|<strong>l</strong>|<strong>n</strong>][<strong>+a</strong>][<strong>+b</strong><em>BC</em>][<strong>+t</strong><em>threshold</em>] ]
-[ <strong>-r</strong> ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdsample</strong> reads a grid file and interpolates it to create a new grid
-file with either: a different registration (<strong>-r</strong> or <strong>-T</strong>); or, a new
-grid-spacing or number of nodes (<strong>-I</strong>), and perhaps also a new
-sub-region (<strong>-R</strong>). A bicubic [Default], bilinear, B-spline or
-nearest-neighbor interpolation is used; see <strong>-n</strong> for settings. Note
-that using <strong>-R</strong> only is equivalent to <strong>grdcut</strong> or <strong>grdedit -S</strong>.
-<strong>grdsample</strong> safely creates a fine mesh from a coarse one; the converse
-may suffer aliasing unless the data are filtered using <strong>grdfft</strong> or
-<strong>grdfilter</strong>.</p>
-<p>When <strong>-R</strong> is omitted, the output grid will cover the same region as
-the input grid. When <strong>-I</strong> is omitted, the grid spacing of the output
-grid will be the same as the input grid. Either <strong>-r</strong> or <strong>-T</strong> can be
-used to change the grid registration. When omitted, the output grid will
-have the same registration as the input grid.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>in_grdfile</em></dt>
-<dd>The name of the input 2-D binary grid file. (See GRID FILE FORMAT below.)</dd>
-<dt><strong>-G</strong><em>out_grdfile</em></dt>
-<dd>The name of the output grid file. (See GRID FILE FORMAT below.)</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]</dt>
-<dd><em>x_inc</em> [and optionally <em>y_inc</em>] is the grid spacing. Optionally,
-append a suffix modifier. <strong>Geographical (degrees) coordinates</strong>: Append
-<strong>m</strong> to indicate arc minutes or <strong>s</strong> to indicate arc seconds. If one
-of the units <strong>e</strong>, <strong>f</strong>, <strong>k</strong>, <strong>M</strong>, <strong>n</strong> or <strong>u</strong> is appended
-instead, the increment is assumed to be given in meter, foot, km, Mile,
-nautical mile or US survey foot, respectively, and will be converted to
-the equivalent degrees longitude at the middle latitude of the region
-(the conversion depends on <a class="reference internal" href="gmt.conf.html#projection-parameters"><em>PROJ_ELLIPSOID</em></a>). If /<em>y_inc</em> is given
-but set to 0 it will be reset equal to <em>x_inc</em>; otherwise it will be
-converted to degrees latitude. <strong>All coordinates</strong>: If <strong>=</strong> is appended
-then the corresponding max <em>x</em> (<em>east</em>) or <em>y</em> (<em>north</em>) may be slightly
-adjusted to fit exactly the given increment [by default the increment
-may be adjusted slightly to fit the given domain]. Finally, instead of
-giving an increment you may specify the <em>number of nodes</em> desired by
-appending <strong>+</strong> to the supplied integer argument; the increment is then
-recalculated from the number of nodes and the domain. The resulting
-increment value depends on whether you have selected a
-gridline-registered or pixel-registered grid; see <a class="reference internal" href="GMT_Docs.html#app-file-formats"><em>B. GMT File Formats</em></a> for
-details. Note: if <strong>-R</strong><em>grdfile</em> is used then the grid spacing has
-already been initialized; use <strong>-I</strong> to override the values.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-<dt><strong>-T</strong></dt>
-<dd>Translate between grid and pixel registration; if the input is
-grid-registered, the output will be pixel-registered and vice-versa.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-n</strong>[<strong>b</strong>|<strong>c</strong>|<strong>l</strong>|<strong>n</strong>][<strong>+a</strong>][<strong>+b</strong><em>BC</em>][<strong>+c</strong>][<strong>+t</strong><em>threshold</em>] <a class="reference internal" href="gmt.html#n-full"><em>(more ...)</em></a></dt>
-<dd>Select interpolation mode for grids.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-r</strong> <a class="reference internal" href="gmt.html#nodereg-full"><em>(more ...)</em></a></dt>
-<dd>Set pixel node registration [gridline]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="grid-values-precision">
-<h2>Grid Values Precision<a class="headerlink" href="#grid-values-precision" title="Permalink to this headline">¶</a></h2>
-<p>Regardless of the precision of the input data, GMT programs that create
-grid files will internally hold the grids in 4-byte floating point
-arrays. This is done to conserve memory and furthermore most if not all
-real data can be stored using 4-byte floating point values. Data with
-higher precision (i.e., double precision values) will lose that
-precision once GMT operates on the grid or writes out new grids. To
-limit loss of precision when processing data you should always consider
-normalizing the data prior to processing.</p>
-</div>
-<div class="section" id="grid-file-formats">
-<h2>Grid File Formats<a class="headerlink" href="#grid-file-formats" title="Permalink to this headline">¶</a></h2>
-<p>By default GMT writes out grid as single precision floats in a
-COARDS-complaint netCDF file format. However, GMT is able to produce
-grid files in many other commonly used grid file formats and also
-facilitates so called “packing” of grids, writing out floating point
-data as 1- or 2-byte integers. To specify the precision, scale and
-offset, the user should add the suffix
-<strong>=</strong><em>id</em>[<strong>/</strong><em>scale</em><strong>/</strong><em>offset</em>[<strong>/</strong><em>nan</em>]], where
-<em>id</em> is a two-letter identifier of the grid type and precision, and
-<em>scale</em> and <em>offset</em> are optional scale factor and offset to be applied
-to all grid values, and <em>nan</em> is the value used to indicate missing
-data. When reading grids, the format is generally automatically
-recognized. If not, the same suffix can be added to input grid file
-names. See <a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section
-<a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a>
-of the GMT Technical Reference and Cookbook for more information.</p>
-<p>When reading a netCDF file that contains multiple grids, GMT will
-read, by default, the first 2-dimensional grid that can find in that
-file. To coax GMT into reading another multi-dimensional variable in
-the grid file, append <strong>?</strong><em>varname</em> to the file name, where <em>varname</em>
-is the name of the variable. Note that you may need to escape the
-special meaning of <strong>?</strong> in your shell program by putting a backslash in
-front of it, or by placing the filename and suffix between quotes or
-double quotes. The <strong>?</strong><em>varname</em> suffix can also be used for output
-grids to specify a variable name different from the default: “z”. See
-<a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section <a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a> of the GMT
-Technical Reference and Cookbook for more information, particularly on
-how to read splices of 3-, 4-, or 5-dimensional grids.</p>
-</div>
-<div class="section" id="consequences-of-grid-resampling">
-<h2>Consequences of grid resampling<a class="headerlink" href="#consequences-of-grid-resampling" title="Permalink to this headline">¶</a></h2>
-<p>Resample or sampling of grids will use various algorithms (see <strong>-n</strong>) that may lead
-to possible distortions or unexpected results in the resampled values.
-One expected effect of resampling with splines is the tendency for the new
-resampled values to slightly exceed the global min/max limits of the original
-grid. If this is unacceptable, you can impose clipping of the resampled values
-values so they do not exceed the input min/max values by adding <strong>+c</strong> to
-your <strong>-n</strong> option.</p>
-</div>
-<div class="section" id="hints">
-<h2>Hints<a class="headerlink" href="#hints" title="Permalink to this headline">¶</a></h2>
-<p>If an interpolation point is not on a node of the input grid, then a NaN
-at any node in the neighborhood surrounding the point will yield an
-interpolated NaN. Bicubic interpolation [default] yields continuous
-first derivatives but requires a neighborhood of 4 nodes by 4 nodes.
-Bilinear interpolation [<strong>-n</strong>] uses only a 2 by 2 neighborhood, but
-yields only zero-order continuity. Use bicubic when smoothness is
-important. Use bilinear to minimize the propagation of NaNs.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To resample the 5 x 5 minute grid in hawaii_5by5_topo.nc onto a 1 minute grid:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdsample hawaii_5by5_topo.nc -I1m -Ghawaii_1by1_topo.nc
-</pre></div>
-</div>
-</div></blockquote>
-<p>To translate the gridline-registered file surface.nc to pixel
-registration while keeping the same region and grid interval:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdsample surface.nc -T -Gpixel.nc
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="grdedit.html"><em>grdedit</em></a>,
-<a class="reference internal" href="grdfft.html"><em>grdfft</em></a>, <a class="reference internal" href="grdfilter.html"><em>grdfilter</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grdsample</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#grid-values-precision">Grid Values Precision</a></li>
-<li><a class="reference internal" href="#grid-file-formats">Grid File Formats</a></li>
-<li><a class="reference internal" href="#consequences-of-grid-resampling">Consequences of grid resampling</a></li>
-<li><a class="reference internal" href="#hints">Hints</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grdreformat.html"
- title="previous chapter">grdreformat</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grdtrack.html"
- title="next chapter">grdtrack</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/grdsample.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grdtrack.html" title="grdtrack"
- >next</a> </li>
- <li class="right" >
- <a href="grdreformat.html" title="grdreformat"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" >GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/grdtrack.html b/doc_release/html/grdtrack.html
deleted file mode 100644
index fd2b302..0000000
--- a/doc_release/html/grdtrack.html
+++ /dev/null
@@ -1,498 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grdtrack — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GR" href="GR.html" />
- <link rel="next" title="grdtrend" href="grdtrend.html" />
- <link rel="prev" title="grdsample" href="grdsample.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grdtrend.html" title="grdtrend"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grdsample.html" title="grdsample"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" accesskey="U">GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grdtrack">
-<span id="index-0"></span><h1>grdtrack<a class="headerlink" href="#grdtrack" title="Permalink to this headline">¶</a></h1>
-<p>grdtrack - Sample grids at specified (x,y) locations</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdtrack</strong> [ <em>xyfile</em> ] <strong>-G</strong><em>grd1</em> <strong>-G</strong><em>grd2</em> ...
-[ <strong>-A</strong><strong>f</strong>|<strong>p</strong>|<strong>m</strong>|<strong>r</strong>|<strong>R</strong>[<strong>+l</strong>] ]
-[ <strong>-C</strong><em>length</em>[<strong>u</strong>]/<em>ds</em>[<em>spacing</em>][<strong>+a</strong>] ] [<strong>-D</strong><em>dfile</em> ]
-[ <strong>-E</strong><em>line</em>[,<em>line</em>,...][<strong>+a</strong><em>az</em>][<strong>+d</strong>][<strong>+i</strong><em>inc</em>[<strong>u</strong>]][<strong>+l</strong><em>length</em>[<strong>u</strong>]][<strong>+n</strong><em>np</em>][<strong>+o</strong><em>az</em>][<strong>+r</strong><em>radius</em>[<strong>u</strong>] ]
-[ <strong>-N</strong> ]
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ]
-[ <strong>-S</strong><em>method</em>/<em>modifiers</em> ] [ <strong>-T</strong>[<em>radius</em>[<strong>u</strong>]][<strong>+e</strong>|<strong>p</strong>]]
-[ <strong>-V</strong>[<em>level</em>] ] [ <strong>-Z</strong> ]
-[ <strong>-b</strong>[<em>ncol</em>][<strong>t</strong>][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-n</strong>[<strong>b</strong>|<strong>c</strong>|<strong>l</strong>|<strong>n</strong>][<strong>+a</strong>][<strong>+b</strong><em>BC</em>][<strong>+t</strong><em>threshold</em>] ]
-[ <strong>-o</strong><em>cols</em>[,...] ] [ <strong>-s</strong>[<em>cols</em>][<strong>a</strong>|<strong>r</strong>] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdtrack</strong> reads one or more grid files (or a Sandwell/Smith IMG
-files) and a table (from file or standard input; but see <strong>-E</strong> for
-exception) with (x,y) [or (lon,lat)] positions in the first two columns
-(more columns may be present). It interpolates the grid(s) at the
-positions in the table and writes out the table with the interpolated
-values added as (one or more) new columns. Alternatively (<strong>-C</strong>), the
-input is considered to be line-segments and we create orthogonal
-cross-profiles at each data point or with an equidistant separation and
-sample the grid(s) along these profiles. A bicubic [Default], bilinear,
-B-spline or nearest-neighbor (see <strong>-n</strong>) interpolation is used,
-requiring boundary conditions at the limits of the region (see <strong>-n</strong>;
-Default uses “natural” conditions (second partial derivative normal to
-edge is zero) unless the grid is automatically recognized as periodic.)</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-G</strong><em>gridfile</em></dt>
-<dd><em>grdfile</em> is a 2-D binary grid file with the function f(x,y). If the
-specified grid is in Sandwell/Smith Mercator format you must append
-a comma-separated list of arguments that includes a scale to
-multiply the data (usually 1 or 0.1), the mode which stand for the
-following: (0) Img files with no constraint code, returns data at
-all points, (1) Img file with constraints coded, return data at all
-points, (2) Img file with constraints coded, return data only at
-constrained points and NaN elsewhere, and (3) Img file
-with constraints coded, return 1 at constraints and 0 elsewhere, and
-optionally the max latitude in the IMG file [80.738]. You may repeat
-<strong>-G</strong> as many times as you have grids you wish to sample. The grids
-are sampled and results are output in the order given. (See GRID
-FILE FORMAT below.)</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>xyfile</em></dt>
-<dd>This is an ASCII (or binary, see <strong>-bi</strong>)
-file where the first 2 columns hold the (x,y) positions where the
-user wants to sample the 2-D data set.</dd>
-<dt><strong>-A</strong><strong>f</strong>|<strong>p</strong><strong>m</strong>|<strong>r</strong>|<strong>R</strong></dt>
-<dd>For track resampling (if <strong>-C</strong> is set) we can select how this is to
-be performed. Append <strong>f</strong> to keep original points, but add
-intermediate points if needed [Default], <strong>m</strong> as <strong>f</strong>, but first
-follow meridian (along y) then parallel (along x), <strong>p</strong> as <strong>f</strong>,
-but first follow parallel (along y) then meridian (along x), <strong>r</strong>
-to resample at equidistant locations; input points are not
-necessarily included in the output, and <strong>R</strong> as <strong>r</strong>, but adjust
-given spacing to fit the track length exactly. Finally, append
-<strong>+l</strong> if distances should be measured along rhumb lines
-(loxodromes). Ignored unless <strong>-C</strong> is used.</dd>
-<dt><strong>-C</strong><em>length</em>[<strong>u</strong>]/<em>ds</em>[<em>spacing</em>][<strong>+a</strong>]</dt>
-<dd>Use input line segments to create an equidistant and (optionally)
-equally-spaced set of crossing profiles along which we sample the
-grid(s) [Default simply samples the grid(s) at the input locations].
-Specify two length scales that control how the sampling is done:
-<em>length</em> sets the full length of each cross-profile, while <em>ds</em> is
-the sampling spacing along each cross-profile. Optionally, append
-<strong>/</strong><em>spacing</em> for an equidistant spacing between cross-profiles
-[Default erects cross-profiles at the input coordinates]. By
-default, all cross-profiles have the same direction. Append <strong>+a</strong>
-to alternate the direction of cross-profiles. Append suitable units
-to <em>length</em>; it sets the unit used for <em>ds</em> [and <em>spacing</em>] (See
-UNITS below). The default unit for geographic grids is meter while
-Cartesian grids implies the user unit. The output columns will be
-<em>lon</em>, <em>lat</em>, <em>dist</em>, <em>azimuth</em>, <em>z1</em>, <em>z2</em>, ..., <em>zn</em> (The <em>zi</em> are
-the sampled values for each of the <em>n</em> grids)</dd>
-<dt><strong>-D</strong><em>dfile</em></dt>
-<dd>In concert with <strong>-C</strong> we can save the (possibly resampled) original
-lines to the file <em>dfile</em> [Default only saves the cross-profiles].
-The columns will be <em>lon</em>, <em>lat</em>, <em>dist</em>, <em>azimuth</em>, <em>z1</em>, <em>z2</em>, ...
-(sampled value for each grid)</dd>
-<dt><strong>-E</strong><em>line</em>[,<em>line</em>,...][<strong>+a</strong><em>az</em>][<strong>+d</strong>][<strong>+i</strong><em>inc</em>[<strong>u</strong>]][<strong>+l</strong><em>length</em>[<strong>u</strong>]][<strong>+n</strong><em>np</em>][<strong>+o</strong><em>az</em>][<strong>+r</strong><em>radius</em>[<strong>u</strong>]</dt>
-<dd>Instead of reading input track coordinates, specify profiles via
-coordinates and modifiers. The format of each <em>line</em> is
-<em>start</em>/<em>stop</em>, where <em>start</em> or <em>stop</em> are either <em>lon</em>/<em>lat</em> (<em>x</em>/<em>y</em> for
-Cartesian data) or a 2-character XY key that uses the “pstext”-style
-justification format format to specify a point on the map as
-[LCR][BMT]. In addition, you can use Z-, Z+ to mean the global
-minimum and maximum locations in the grid (only available if only
-one grid is given). Instead of two coordinates you can specify an
-origin and one of <strong>+a</strong>, <strong>+o</strong>, or <strong>+r</strong>. You may append
-<strong>+i</strong><em>inc</em>[<strong>u</strong>] to set the sampling interval; if not given then we default to half the minimum grid interval.
-The <strong>+a</strong> sets the azimuth of a profile of given
-length starting at the given origin, while <strong>+o</strong> centers the profile
-on the origin; both require <strong>+l</strong>. For circular sampling specify
-<strong>+r</strong> to define a circle of given radius centered on the origin;
-this option requires either <strong>+n</strong> or <strong>+i</strong>. The <strong>+n</strong><em>np</em> sets
-the desired number of points, while <strong>+l</strong><em>length</em> gives the
-total length of the profile. Append <strong>+d</strong> to output the along-track
-distances after the coordinates. Note: No track file will be read.
-Also note that only one distance unit can be chosen. Giving different units
-will result in an error. If no units are specified we default to
-great circle distances in km (if geographic). If working with geographic
-data you can prepend - (Flat Earth) or + (Geodesic) to <em>inc</em>, <em>length</em>, or <em>radius</em>
-to change the mode of distance calculation [Great Circle].</dd>
-<dt><strong>-N</strong></dt>
-<dd>Do <em>not</em> skip points that fall outside the domain of the grid(s)
-[Default only output points within grid domain].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-<dt><strong>-S</strong><em>method</em>/<em>modifiers</em></dt>
-<dd>In conjunction with <strong>-C</strong>, compute a single stacked profile from
-all profiles across each segment. Append how stacking should be
-computed: <strong>a</strong> = mean (average), <strong>m</strong> = median, <strong>p</strong> = mode
-(maximum likelihood), <strong>l</strong> = lower, <strong>L</strong> = lower but only consider
-positive values, <strong>u</strong> = upper, <strong>U</strong> = upper but only consider
-negative values [<strong>a</strong>]. The <em>modifiers</em> control the output;
-choose one or more among these choices: <strong>+a</strong> : Append stacked
-values to all cross-profiles. <strong>+d</strong> : Append stack deviations to
-all cross-profiles. <strong>+d</strong> : Append data residuals (data - stack) to
-all cross-profiles. <strong>+s</strong>[<em>file</em>] : Save stacked profile to
-<em>file</em> [grdtrack_stacked_profile.txt]. <strong>+c</strong><em>fact</em> : Compute
-envelope on stacked profile as +/- <em>fact</em>*<em>deviation</em> [2].
-Notes: (1) Deviations depend on <em>method</em> and are st.dev (<strong>a</strong>), L1
-scale (<strong>m</strong> and <strong>p</strong>), or half-range (upper-lower)/2. (2) The
-stacked profile file contains 1 plus groups of 4-6 columns, one
-group for each sampled grid. The first column holds cross distance,
-while the first 4 in a group hold stacked value, deviation, min
-value, and max value. If <em>method</em> is one of
-<strong>a</strong>|<strong>m</strong>|<strong>p</strong> then we also write the lower and upper
-confidence bounds (see <strong>+c</strong>). When one or more of <strong>+a</strong>, <strong>+d</strong>,
-and <strong>+r</strong> are used then we append the results to the end of each
-row for all cross-profiles. The order is always stacked value
-(<strong>+a</strong>), followed by deviations (<strong>+d</strong>) and residuals (<strong>+r</strong>).
-When more than one grid is sampled this sequence of 1-3 columns are
-repeated for each grid.</dd>
-<dt><strong>-T</strong>[<em>radius</em>[<strong>u</strong>]][<strong>+e</strong>|<strong>p</strong>]</dt>
-<dd>To be used with normal grid sampling, and limited to a single, non-IMG grid.
-If the nearest node to the input point is NaN, search outwards until we find
-the nearest non-NaN node and report that value instead. Optionally specify
-a search radius which limits the consideration to points within this distance
-from the input point. To report the location of the nearest node and its
-distance from the input point, append <strong>+e</strong>. To instead replace the input
-point with the coordinates of the nearest node, append <strong>+p</strong>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-Z</strong></dt>
-<dd>Only write out the sampled z-values [Default writes all columns].</dd>
-<dt><strong>-:</strong></dt>
-<dd>Toggles between (longitude,latitude) and (latitude,longitude)
-input/output. [Default is (longitude,latitude)].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 2 input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. [Default is one more than input].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] <a class="reference internal" href="gmt.html#g-full"><em>(more ...)</em></a></dt>
-<dd>Determine data gaps and line breaks. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-n</strong>[<strong>b</strong>|<strong>c</strong>|<strong>l</strong>|<strong>n</strong>][<strong>+a</strong>][<strong>+b</strong><em>BC</em>][<strong>+c</strong>][<strong>+t</strong><em>threshold</em>] <a class="reference internal" href="gmt.html#n-full"><em>(more ...)</em></a></dt>
-<dd>Select interpolation mode for grids.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-o</strong><em>cols</em>[,...] <a class="reference internal" href="gmt.html#ocols-full"><em>(more ...)</em></a></dt>
-<dd>Select output columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-s</strong>[<em>cols</em>][<strong>a</strong>|<strong>r</strong>] <a class="reference internal" href="gmt.html#s-full"><em>(more ...)</em></a></dt>
-<dd>Set handling of NaN records.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc9">Units</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>For map distance unit, append <em>unit</em> <strong>d</strong> for arc degree, <strong>m</strong> for arc
-minute, and <strong>s</strong> for arc second, or <strong>e</strong> for meter [Default], <strong>f</strong>
-for foot, <strong>k</strong> for km, <strong>M</strong> for statute mile, <strong>n</strong> for nautical mile,
-and <strong>u</strong> for US survey foot. By default we compute such distances using
-a spherical approximation with great circles. Prepend <strong>-</strong> to a
-distance (or the unit is no distance is given) to perform “Flat Earth”
-calculations (quicker but less accurate) or prepend <strong>+</strong> to perform
-exact geodesic calculations (slower but more accurate).</p>
-</div>
-<div class="section" id="ascii-format-precision">
-<h2>Ascii Format Precision<a class="headerlink" href="#ascii-format-precision" title="Permalink to this headline">¶</a></h2>
-<p>The ASCII output formats of numerical data are controlled by parameters
-in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file. Longitude and latitude are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>, whereas other values are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>. Be aware that the format in effect
-can lead to loss of precision in the output, which can lead to various
-problems downstream. If you find the output is not written with enough
-precision, consider switching to binary output (<strong>-bo</strong> if available) or
-specify more decimals using the <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> setting.</p>
-</div>
-<div class="section" id="grid-file-formats">
-<h2>Grid File Formats<a class="headerlink" href="#grid-file-formats" title="Permalink to this headline">¶</a></h2>
-<p>By default GMT writes out grid as single precision floats in a
-COARDS-complaint netCDF file format. However, GMT is able to produce
-grid files in many other commonly used grid file formats and also
-facilitates so called “packing” of grids, writing out floating point
-data as 1- or 2-byte integers. To specify the precision, scale and
-offset, the user should add the suffix
-<strong>=</strong><em>id</em>[<strong>/</strong><em>scale</em><strong>/</strong><em>offset</em>[<strong>/</strong><em>nan</em>]], where
-<em>id</em> is a two-letter identifier of the grid type and precision, and
-<em>scale</em> and <em>offset</em> are optional scale factor and offset to be applied
-to all grid values, and <em>nan</em> is the value used to indicate missing
-data. When reading grids, the format is generally automatically
-recognized. If not, the same suffix can be added to input grid file
-names. See <a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section
-<a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a>
-of the GMT Technical Reference and Cookbook for more information.</p>
-<p>When reading a netCDF file that contains multiple grids, GMT will
-read, by default, the first 2-dimensional grid that can find in that
-file. To coax GMT into reading another multi-dimensional variable in
-the grid file, append <strong>?</strong><em>varname</em> to the file name, where <em>varname</em>
-is the name of the variable. Note that you may need to escape the
-special meaning of <strong>?</strong> in your shell program by putting a backslash in
-front of it, or by placing the filename and suffix between quotes or
-double quotes. The <strong>?</strong><em>varname</em> suffix can also be used for output
-grids to specify a variable name different from the default: “z”. See
-<a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section <a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a> of the GMT
-Technical Reference and Cookbook for more information, particularly on
-how to read splices of 3-, 4-, or 5-dimensional grids.</p>
-</div>
-<div class="section" id="consequences-of-grid-resampling">
-<h2>Consequences of grid resampling<a class="headerlink" href="#consequences-of-grid-resampling" title="Permalink to this headline">¶</a></h2>
-<p>Resample or sampling of grids will use various algorithms (see <strong>-n</strong>) that may lead
-to possible distortions or unexpected results in the resampled values.
-One expected effect of resampling with splines is the tendency for the new
-resampled values to slightly exceed the global min/max limits of the original
-grid. If this is unacceptable, you can impose clipping of the resampled values
-values so they do not exceed the input min/max values by adding <strong>+c</strong> to
-your <strong>-n</strong> option.</p>
-</div>
-<div class="section" id="hints">
-<h2>Hints<a class="headerlink" href="#hints" title="Permalink to this headline">¶</a></h2>
-<p>If an interpolation point is not on a node of the input grid, then a NaN
-at any node in the neighborhood surrounding the point will yield an
-interpolated NaN. Bicubic interpolation [default] yields continuous
-first derivatives but requires a neighborhood of 4 nodes by 4 nodes.
-Bilinear interpolation [<strong>-n</strong>] uses only a 2 by 2 neighborhood, but
-yields only zeroth-order continuity. Use bicubic when smoothness is
-important. Use bilinear to minimize the propagation of NaNs, or lower
-<em>threshold</em>.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To sample the file hawaii_topo.nc along the SEASAT track track_4.xyg
-(An ASCII table containing longitude, latitude, and SEASAT-derived
-gravity, preceded by one header record):</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>grdtrack track_4.xyg -Ghawaii_topo.nc -h > track_4.xygt
-</pre></div>
-</div>
-</div></blockquote>
-<p>To sample the Sandwell/Smith IMG format file topo.8.2.img (2 minute
-predicted bathymetry on a Mercator grid) and the Muller et al age grid
-age.3.2.nc along the lon,lat coordinates given in the file
-cruise_track.xy, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>grdtrack cruise_track.xy -Gtopo.8.2.img,1,1 -Gage.3.2.nc > depths-age.d
-</pre></div>
-</div>
-</div></blockquote>
-<p>To sample the Sandwell/Smith IMG format file grav.18.1.img (1 minute
-free-air anomalies on a Mercator grid) along 100-km-long cross-profiles
-that are orthogonal to the line segment given in the file track.xy,
-erecting cross-profiles every 25 km and sampling the grid every 3 km, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>grdtrack track.xy -Ggrav.18.1.img,0.1,1 -C100k/3/25 -Ar > xprofiles.txt
-</pre></div>
-</div>
-</div></blockquote>
-<p>To sample the grid data.nc along a line from the lower left to the upper
-right corner, using a grid spacing of 1 km, and output distances as well,
-try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre><span class="n">grdtrack</span> <span class="o">-</span><span class="n">ELB</span><span class="o">/</span><span class="n">RT</span><span class="o">+</span><span class="n">i1k</span><span class="o">+</span><span class="n">d</span> <span class="o">-</span><span class="n">Gdata</span><span class="o">.</span><span class="n">nc</span> <span class="o">></span> <span class="n">profiles</span><span class="o">.</span><span class="n [...]
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="gmtconvert.html"><em>gmtconvert</em></a>,
-<a class="reference internal" href="sample1d.html"><em>sample1d</em></a>,
-<a class="reference internal" href="surface.html"><em>surface</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grdtrack</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#id1">Units</a></li>
-<li><a class="reference internal" href="#ascii-format-precision">Ascii Format Precision</a></li>
-<li><a class="reference internal" href="#grid-file-formats">Grid File Formats</a></li>
-<li><a class="reference internal" href="#consequences-of-grid-resampling">Consequences of grid resampling</a></li>
-<li><a class="reference internal" href="#hints">Hints</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grdsample.html"
- title="previous chapter">grdsample</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grdtrend.html"
- title="next chapter">grdtrend</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/grdtrack.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grdtrend.html" title="grdtrend"
- >next</a> </li>
- <li class="right" >
- <a href="grdsample.html" title="grdsample"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" >GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/grdtrend.html b/doc_release/html/grdtrend.html
deleted file mode 100644
index b459d04..0000000
--- a/doc_release/html/grdtrend.html
+++ /dev/null
@@ -1,299 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grdtrend — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GR" href="GR.html" />
- <link rel="next" title="grdvector" href="grdvector.html" />
- <link rel="prev" title="grdtrack" href="grdtrack.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grdvector.html" title="grdvector"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grdtrack.html" title="grdtrack"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" accesskey="U">GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grdtrend">
-<span id="index-0"></span><h1>grdtrend<a class="headerlink" href="#grdtrend" title="Permalink to this headline">¶</a></h1>
-<p>grdtrend - Fit trend surface to grids and compute residuals</p>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc1">Synopsis</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdtrend</strong> <em>grdfile</em> <strong>-N</strong><em>n_model</em>[<strong>r</strong>] [ <strong>-D</strong><em>diff.nc</em> ]
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ]
-[ <strong>-T</strong><em>trend.nc</em> ] [ <strong>-W</strong><em>weight.nc</em> ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdtrend</strong> reads a 2-D grid file and fits a low-order polynomial trend
-to these data by [optionally weighted] least-squares. The trend surface
-is defined by:</p>
-<blockquote>
-<div>m1 + m2*x + m3*y + m4*x*y + m5*x*x + m6*y*y + m7*x*x*x +
-m8*x*x*y + m9*x*y*y + m10*y*y*y.</div></blockquote>
-<p>The user must specify <strong>-N</strong><em>n_model</em>, the number of model parameters
-to use; thus, <strong>-N</strong><em>3</em> fits a bilinear trend, <strong>-N</strong><em>6</em> a quadratic
-surface, and so on. Optionally, append <strong>r</strong> to the <strong>-N</strong> option to
-perform a robust fit. In this case, the program will iteratively
-reweight the data based on a robust scale estimate, in order to converge
-to a solution insensitive to outliers. This may be handy when separating
-a “regional” field from a “residual” which should have non-zero mean,
-such as a local mountain on a regional surface.</p>
-<p>If data file has values set to NaN, these will be ignored during
-fitting; if output files are written, these will also have NaN in the
-same locations.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>grdfile</em></dt>
-<dd>The name of a 2-D binary grid file.</dd>
-<dt><strong>-N</strong><em>n_model</em>[<strong>r</strong>]</dt>
-<dd><em>n_model</em> sets the number of model parameters to fit.
-Append <strong>r</strong> for robust fit.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-D</strong><em>diff.nc</em></dt>
-<dd>Write the difference (input data - trend) to the file <em>diff.nc</em>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. Using the <strong>-R</strong> option
-will select a subsection of the input grid. If this subsection
-exceeds the boundaries of the grid, only the common region will be extracted.</dd>
-<dt><strong>-T</strong><em>trend.nc</em></dt>
-<dd>Write the fitted trend to the file <em>trend.nc</em>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong><em>weight.nc</em></dt>
-<dd>If <em>weight.nc</em> exists, it will be read and used to solve a weighted
-least-squares problem. [Default: Ordinary least-squares fit.] If the
-robust option has been selected, the weights used in the robust fit
-will be written to <em>weight.nc</em>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="remarks">
-<h2>Remarks<a class="headerlink" href="#remarks" title="Permalink to this headline">¶</a></h2>
-<p>The domain of x and y will be shifted and scaled to [-1, 1] and the
-basis functions are built from Legendre polynomials. These have a
-numerical advantage in the form of the matrix which must be inverted and
-allow more accurate solutions. NOTE: The model parameters listed with
-<strong>-V</strong> are Legendre polynomial coefficients; they are not numerically
-equivalent to the m#s in the equation described above. The description
-above is to allow the user to match <strong>-N</strong> with the order of the
-polynomial surface. See <strong>grdmath</strong> if you need to evaluate the trend
-using the reported coefficients.</p>
-</div>
-<div class="section" id="grid-file-formats">
-<h2>Grid File Formats<a class="headerlink" href="#grid-file-formats" title="Permalink to this headline">¶</a></h2>
-<p>By default GMT writes out grid as single precision floats in a
-COARDS-complaint netCDF file format. However, GMT is able to produce
-grid files in many other commonly used grid file formats and also
-facilitates so called “packing” of grids, writing out floating point
-data as 1- or 2-byte integers. To specify the precision, scale and
-offset, the user should add the suffix
-<strong>=</strong><em>id</em>[<strong>/</strong><em>scale</em><strong>/</strong><em>offset</em>[<strong>/</strong><em>nan</em>]], where
-<em>id</em> is a two-letter identifier of the grid type and precision, and
-<em>scale</em> and <em>offset</em> are optional scale factor and offset to be applied
-to all grid values, and <em>nan</em> is the value used to indicate missing
-data. When reading grids, the format is generally automatically
-recognized. If not, the same suffix can be added to input grid file
-names. See <a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section
-<a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a>
-of the GMT Technical Reference and Cookbook for more information.</p>
-<p>When reading a netCDF file that contains multiple grids, GMT will
-read, by default, the first 2-dimensional grid that can find in that
-file. To coax GMT into reading another multi-dimensional variable in
-the grid file, append <strong>?</strong><em>varname</em> to the file name, where <em>varname</em>
-is the name of the variable. Note that you may need to escape the
-special meaning of <strong>?</strong> in your shell program by putting a backslash in
-front of it, or by placing the filename and suffix between quotes or
-double quotes. The <strong>?</strong><em>varname</em> suffix can also be used for output
-grids to specify a variable name different from the default: “z”. See
-<a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section <a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a> of the GMT
-Technical Reference and Cookbook for more information, particularly on
-how to read splices of 3-, 4-, or 5-dimensional grids.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To remove a planar trend from hawaii_topo.nc and write result in hawaii_residual.nc:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdtrend hawaii_topo.nc -N3 -Dhawaii_residual.nc
-</pre></div>
-</div>
-</div></blockquote>
-<p>To do a robust fit of a bicubic surface to hawaii_topo.nc, writing the
-result in hawaii_trend.nc and the weights used in hawaii_weight.nc,
-and reporting the progress:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdtrend hawaii_topo.nc -N10r -Thawaii_trend.nc -Whawaii_weight.nc -V
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="grdfft.html"><em>grdfft</em></a>,
-<a class="reference internal" href="grdfilter.html"><em>grdfilter</em></a>,
-<a class="reference internal" href="grdmath.html"><em>grdmath</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grdtrend</a><ul>
-<li><a class="reference internal" href="#id1">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#remarks">Remarks</a></li>
-<li><a class="reference internal" href="#grid-file-formats">Grid File Formats</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grdtrack.html"
- title="previous chapter">grdtrack</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grdvector.html"
- title="next chapter">grdvector</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/grdtrend.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grdvector.html" title="grdvector"
- >next</a> </li>
- <li class="right" >
- <a href="grdtrack.html" title="grdtrack"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" >GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/grdvector.html b/doc_release/html/grdvector.html
deleted file mode 100644
index 6843422..0000000
--- a/doc_release/html/grdvector.html
+++ /dev/null
@@ -1,397 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grdvector — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GR" href="GR.html" />
- <link rel="next" title="grdview" href="grdview.html" />
- <link rel="prev" title="grdtrend" href="grdtrend.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grdview.html" title="grdview"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grdtrend.html" title="grdtrend"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" accesskey="U">GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grdvector">
-<span id="index-0"></span><h1>grdvector<a class="headerlink" href="#grdvector" title="Permalink to this headline">¶</a></h1>
-<p>grdvector - Plot vector field from two component grids</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdvector</strong> <em>compx.nc</em> <em>compy.nc</em> <strong>-J</strong><em>parameters</em> [ <strong>-A</strong> ]
-[ <strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> ]
-[ <strong>-G</strong><em>fill</em> ]
-[ <strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]] ]
-[ <strong>-K</strong> ] [ <strong>-N</strong> ] [ <strong>-O</strong> ] [ <strong>-P</strong> ] [ <strong>-Q</strong><em>parameters</em> ]
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ]
-[ <strong>-S</strong>[<strong>i</strong>|<strong>l</strong>]<em>scale</em> ] [ <strong>-T</strong> ]
-[ <strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] ]
-[ <strong>-W</strong><em>pen</em> ]
-[ <strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Z</strong> ]
-[ <strong>-c</strong><em>copies</em> ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] ]
-[ <strong>-t</strong>[<em>transp</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdvector</strong> reads two 2-D grid files which represents the x- and
-y-components of a vector field and produces a vector field plot by
-drawing vectors with orientation and length according to the information
-in the files. Alternatively, polar coordinate components may be used (r,
-theta). <strong>grdvector</strong> is basically a short-hand for using 2 calls to
-<a class="reference internal" href="grd2xyz.html"><em>grd2xyz</em></a> and pasting the output through <strong>psxy -SV</strong>.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>compx.nc</em></dt>
-<dd>Contains the x-component of the vector field.</dd>
-<dt><em>compy.nc</em></dt>
-<dd>Contains the y-component of the vector field. (See GRID FILE FORMATS below.)</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-J</strong><em>parameters</em> <a class="reference internal" href="gmt.html#j-full"><em>(more ...)</em></a></dt>
-<dd>Select map projection.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong></dt>
-<dd>Means grid files have polar (r, theta) components instead of
-Cartesian (x, y).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> <a class="reference internal" href="gmt.html#b-full"><em>(more ...)</em></a></dt>
-<dd>Set map boundary intervals.</dd>
-<dt><strong>-C</strong>[<em>cptfile</em>]</dt>
-<dd>Use <em>cptfile</em> to assign colors based on vector length. Alternatively,
-supply the name of a GMT color master CPT [rainbow] and let
-<strong>grdvector</strong> automatically determine a 16-level continuous CPT from
-the grid’s z-range.</dd>
-<dt><strong>-G</strong><em>fill</em></dt>
-<dd>Sets color or shade for vector interiors [Default is no fill].</dd>
-<dt><strong>-I</strong></dt>
-<dd>Only plot vectors at nodes every <em>x_inc</em>, <em>y_inc</em> apart (must be
-multiples of original grid spacing). Append <strong>m</strong> for arc minutes or
-<strong>s</strong> for arc seconds. [Default plots every node].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-K</strong> <a class="reference internal" href="gmt.html#k-full"><em>(more ...)</em></a></dt>
-<dd>Do not finalize the PostScript plot.</dd>
-<dt><strong>-N</strong></dt>
-<dd>Do NOT clip vectors at map boundaries [Default will clip].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-O</strong> <a class="reference internal" href="gmt.html#o-full"><em>(more ...)</em></a></dt>
-<dd>Append to existing PostScript plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-P</strong> <a class="reference internal" href="gmt.html#p-full"><em>(more ...)</em></a></dt>
-<dd>Select “Portrait” plot orientation.</dd>
-<dt><strong>-Q</strong><em>parameters</em></dt>
-<dd>Modify vector parameters. For vector heads, append vector head
-<em>size</em> [Default is 0, i.e., stick-plot]. See VECTOR ATTRIBUTES for
-specifying additional attributes.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. Specify a subset of the grid.</dd>
-<dt><strong>-S</strong>[<strong>i</strong>|<strong>l</strong>]<em>scale</em></dt>
-<dd>Sets scale for Cartesian vector length in data units per distance measurement
-unit [1]. Append <strong>c</strong>, <strong>i</strong>, or <strong>p</strong> to indicate the measurement
-unit (cm, inch,or point). Prepend <strong>l</strong> to indicate a fixed length
-for all vectors. For Geographic data, give scale in data units per
-km. Use <strong>-Si</strong> if it is simpler to give the reciprocal scale in
-measurement unit per data unit or km per data unit.</dd>
-<dt><strong>-T</strong></dt>
-<dd>Means azimuth of Cartesian data sets should be adjusted for different scales
-in the x- and y-directions [Leave alone].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] <a class="reference internal" href="gmt.html#u-full"><em>(more ...)</em></a></dt>
-<dd>Draw GMT time stamp logo on plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong><em>pen</em></dt>
-<dd>Set pen attributes used for vector outlines [Default: width =
-default, color = black, style = solid].</dd>
-</dl>
-<p><strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]]</p>
-<dl class="docutils">
-<dt><strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] <a class="reference internal" href="gmt.html#xy-full"><em>(more ...)</em></a></dt>
-<dd>Shift plot origin.</dd>
-<dt><strong>-Z</strong></dt>
-<dd>Means the angles provided are azimuths rather than direction
-(requires <strong>-A</strong>).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-c</strong><em>copies</em> <a class="reference internal" href="gmt.html#c-full"><em>(more ...)</em></a></dt>
-<dd>Specify number of plot copies [Default is 1].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] <a class="reference internal" href="gmt.html#perspective-full"><em>(more ...)</em></a></dt>
-<dd>Select perspective view. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-t</strong>[<em>transp</em>] <a class="reference internal" href="gmt.html#t-full"><em>(more ...)</em></a></dt>
-<dd>Set PDF transparency level in percent.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="grid-file-formats">
-<h2>Grid File Formats<a class="headerlink" href="#grid-file-formats" title="Permalink to this headline">¶</a></h2>
-<p>By default GMT writes out grid as single precision floats in a
-COARDS-complaint netCDF file format. However, GMT is able to produce
-grid files in many other commonly used grid file formats and also
-facilitates so called “packing” of grids, writing out floating point
-data as 1- or 2-byte integers. To specify the precision, scale and
-offset, the user should add the suffix
-<strong>=</strong><em>id</em>[<strong>/</strong><em>scale</em><strong>/</strong><em>offset</em>[<strong>/</strong><em>nan</em>]], where
-<em>id</em> is a two-letter identifier of the grid type and precision, and
-<em>scale</em> and <em>offset</em> are optional scale factor and offset to be applied
-to all grid values, and <em>nan</em> is the value used to indicate missing
-data. When reading grids, the format is generally automatically
-recognized. If not, the same suffix can be added to input grid file
-names. See <a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section
-<a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a>
-of the GMT Technical Reference and Cookbook for more information.</p>
-<p>When reading a netCDF file that contains multiple grids, GMT will
-read, by default, the first 2-dimensional grid that can find in that
-file. To coax GMT into reading another multi-dimensional variable in
-the grid file, append <strong>?</strong><em>varname</em> to the file name, where <em>varname</em>
-is the name of the variable. Note that you may need to escape the
-special meaning of <strong>?</strong> in your shell program by putting a backslash in
-front of it, or by placing the filename and suffix between quotes or
-double quotes. The <strong>?</strong><em>varname</em> suffix can also be used for output
-grids to specify a variable name different from the default: “z”. See
-<a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section <a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a> of the GMT
-Technical Reference and Cookbook for more information, particularly on
-how to read splices of 3-, 4-, or 5-dimensional grids.</p>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc15">Vector Attributes</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>Several modifiers may be appended to the vector-producing options to
-specify the placement of vector heads, their shapes, and the
-justification of the vector. Below, left and right refers to the
-side of the vector line when viewed from the start point to the
-end point of the segment:</p>
-<blockquote>
-<div><p><strong>+a</strong><em>angle</em> sets the angle of the vector head apex [30].</p>
-<p><strong>+b</strong> places a vector head at the beginning of the vector path [none].
-Append <strong>l</strong>|<strong>r</strong> to only draw the left or right side of this head
-[both sides].</p>
-<p><strong>+e</strong> places a vector head at the end of the vector path [none].
-Append <strong>l</strong>|<strong>r</strong> to only draw the left or right side of this head
-[both sides].</p>
-<p><strong>+g</strong>-|<em>fill</em> turns off vector head fill (if -) or sets the vector
-head fill [Default fill is used, which may be no fill].</p>
-<p><strong>+l</strong> draws half-arrows, using only the left side of specified heads [both sides].</p>
-<p><strong>+n</strong><em>norm</em> scales down vector attributes (pen thickness, head size)
-with decreasing length, where vectors shorter than <em>norm</em> will have
-their attributes scaled by length/<em>norm</em> [arrow attributes remains
-invariant to length].</p>
-<p><strong>+o</strong><em>plon</em>/<em>plat</em> specifies the oblique pole for the great or
-small circles. Only needed for great circles if <strong>+q</strong> is given.</p>
-<p><strong>+p</strong>[-][<em>pen</em>] sets the vector pen attributes. If <em>pen</em> has a
-leading - then the head outline is not drawn. [Default pen is used, and
-head outline is drawn]</p>
-<p><strong>+q</strong> means the input <em>angle</em>, <em>length</em> data instead represent the <em>start</em> and <em>stop</em>
-opening angles of the arc segment relative to the given point.</p>
-<p><strong>+r</strong> draws half-arrows, using only the right side of specified heads [both sides].</p>
-</div></blockquote>
-<p>In addition, all but circular vectors may take these modifiers:</p>
-<blockquote>
-<div><p><strong>+j</strong><em>just</em> determines how the input <em>x</em>,<em>y</em> point relates to the
-vector. Choose from <strong>b</strong>eginning [default], <strong>e</strong>nd, or <strong>c</strong>enter.</p>
-<p><strong>+s</strong> means the input <em>angle</em>, <em>length</em> is instead the <em>x</em>, <em>y</em>
-coordinates of the vector end point.</p>
-</div></blockquote>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To draw the vector field given by the files r.nc and theta.nc on a
-linear plot with scale 5 cm per data unit, using vector rather than
-stick plot, scale vector magnitudes so that 10 units equal 1 inch, and
-center vectors on the node locations, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdvector r.nc theta.nc -Jx5c -A -Q0.1i+e+jc -S10i > gradient.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>To plot a geographic data sets given the files com_x.nc and comp_y.nc,
-using a scale of 200 km per data unit, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdvector comp_x.nc comp_y.nc -JH0/20c -Q0.1i+e+jc -S200 > globe.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="gmtcolors.html"><em>gmtcolors</em></a>,
-<a class="reference internal" href="grdcontour.html"><em>grdcontour</em></a>, <a class="reference internal" href="psxy.html"><em>psxy</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grdvector</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#grid-file-formats">Grid File Formats</a></li>
-<li><a class="reference internal" href="#id1">Vector Attributes</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grdtrend.html"
- title="previous chapter">grdtrend</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grdview.html"
- title="next chapter">grdview</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/grdvector.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grdview.html" title="grdview"
- >next</a> </li>
- <li class="right" >
- <a href="grdtrend.html" title="grdtrend"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" >GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/grdview.html b/doc_release/html/grdview.html
deleted file mode 100644
index 14aa430..0000000
--- a/doc_release/html/grdview.html
+++ /dev/null
@@ -1,465 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grdview — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GR" href="GR.html" />
- <link rel="next" title="grdvolume" href="grdvolume.html" />
- <link rel="prev" title="grdvector" href="grdvector.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grdvolume.html" title="grdvolume"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grdvector.html" title="grdvector"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" accesskey="U">GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grdview">
-<span id="index-0"></span><h1>grdview<a class="headerlink" href="#grdview" title="Permalink to this headline">¶</a></h1>
-<p>grdview - Create 3-D perspective image or surface mesh from a grid</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdview</strong> <em>relief_file</em> <strong>-J</strong><em>parameters</em>
-[ <strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> ]
-[ <strong>-C</strong>[<em>cptfile</em>]]
-[ <strong>-G</strong><em>drapefile</em> | <strong>-G</strong><em>grd_r</em>,<em>grd_g</em>,<em>grd_b</em> ]
-[ <strong>-I</strong><em>intensfile</em>|<em>intensity</em> ] [ <strong>-Jz</strong>|<strong>Z</strong><em>parameters</em> ] [ <strong>-K</strong> ]
-[ <strong>-N</strong><em>level</em>[<strong>+g</strong><em>fill</em>] ] [ <strong>-O</strong> ] [ <strong>-P</strong> ]
-[ <strong>-Q</strong><em>args</em>[<strong>+m</strong>] ]
-[ <strong>-R</strong><em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>] ]
-[ <strong>-S</strong><em>smooth</em> ]
-[ <strong>-T</strong>[<strong>s</strong>][<strong>o</strong>[<em>pen</em>]] ]
-[ <strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] ]
-[ <strong>-W</strong><strong>type</strong><em>pen</em> ]
-[ <strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] ]
-[ <strong>-c</strong><em>copies</em> ]
-[ <strong>-n</strong>[<strong>b</strong>|<strong>c</strong>|<strong>l</strong>|<strong>n</strong>][<strong>+a</strong>][<strong>+b</strong><em>BC</em>][<strong>+t</strong><em>threshold</em>] ]
-[ <strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] ]
-[ <strong>-t</strong>[<em>transp</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdview</strong> reads a 2-D grid file and produces a 3-D perspective plot by
-drawing a mesh, painting a colored/grayshaded surface made up of
-polygons, or by scanline conversion of these polygons to a raster image.
-Options include draping a data set on top of a surface, plotting of
-contours on top of the surface, and apply artificial illumination based
-on intensities provided in a separate grid file.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>relief_file</em></dt>
-<dd>2-D gridded data set to be imaged (the relief of the surface). (See
-GRID FILE FORMAT below.)</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-J</strong><em>parameters</em> <a class="reference internal" href="gmt.html#j-full"><em>(more ...)</em></a></dt>
-<dd>Select map projection.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-Jz</strong>|<strong>Z</strong><em>parameters</em> <a class="reference internal" href="gmt.html#jz-full"><em>(more ...)</em></a></dt>
-<dd>Set z-axis scaling; same syntax as <strong>-Jx</strong>.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> <a class="reference internal" href="gmt.html#b-full"><em>(more ...)</em></a></dt>
-<dd>Set map boundary intervals.</dd>
-<dt><strong>-C</strong>[<em>cptfile</em>]</dt>
-<dd>name of the color palette file. Must be present if you want
-(1) mesh plot with contours (<strong>-Qm</strong>), or
-(2) shaded/colored perspective image (<strong>-Qs</strong> or
-<strong>-Qi</strong>). For <strong>-Qs</strong>: You can specify that you want to skip a
-z-slice by setting red = -; to use a pattern give red =
-<strong>P|p</strong><em>dpi/pattern</em>[:<strong>F</strong><em>color</em>[<strong>B</strong><em>color</em>]].
-Alternatively, supply the name of a GMT color master CPT [rainbow] and let
-<strong>grdview</strong> automatically determine a 16-level continuous CPT from
-the grid’s z-range.</dd>
-<dt><strong>-G</strong><em>drapefile</em> | <strong>-G</strong><em>grd_r</em>,<em>grd_g</em>,<em>grd_b</em></dt>
-<dd>Drape the image in <em>drapefile</em> on top of the relief provided by
-<em>relief_file</em>. [Default is <em>relief_file</em>]. Note that <strong>-Jz</strong> and
-<strong>-N</strong> always refers to the <em>relief_file</em>. The <em>drapefile</em> only
-provides the information pertaining to colors, which is looked-up
-via the cpt file (see <strong>-C</strong>). Alternatively, give three grid files
-separated by commas. These files must contain the red, green, and
-blue colors directly (in 0-255 range) and no cpt file is needed. The
-<em>drapefile</em> may be of higher resolution than the <em>relief_file</em>.</dd>
-<dt><strong>-I</strong><em>intensfile</em>|<em>intensity</em></dt>
-<dd>Gives the name of a grid file with intensities in the (-1,+1) range,
-or a constant intensity to apply everywhere.
-[Default is no illumination].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-K</strong> <a class="reference internal" href="gmt.html#k-full"><em>(more ...)</em></a></dt>
-<dd>Do not finalize the PostScript plot.</dd>
-<dt><strong>-N</strong><em>level</em>[<strong>+g</strong><em>fill</em>]</dt>
-<dd>Draws a plane at this z-level. If the optional <em>color</em> is provided
-via the <strong>+g</strong> modifier,
-the frontal facade between the plane and the data perimeter is
-colored. See <strong>-Wf</strong> for setting the pen used for the outline.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-O</strong> <a class="reference internal" href="gmt.html#o-full"><em>(more ...)</em></a></dt>
-<dd>Append to existing PostScript plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-P</strong> <a class="reference internal" href="gmt.html#p-full"><em>(more ...)</em></a></dt>
-<dd>Select “Portrait” plot orientation.</dd>
-<dt><strong>-Q</strong><em>args</em>[<strong>+m</strong>]</dt>
-<dd>Select one of four settings: 1. Specify <strong>m</strong> for mesh plot
-[Default], and optionally append <em>color</em> for a different mesh paint
-[white]. 2. Specify <strong>s</strong> for surface plot, and optionally append
-<strong>m</strong> to have mesh lines drawn on top of surface. 3. Specify <strong>i</strong>
-for image plot, and optionally append the effective dpi resolution
-for the rasterization [100]. 4. Specify <strong>c</strong>. Same as <strong>-Qi</strong> but
-will make nodes with z = NaN transparent, using the colormasking
-feature in PostScript Level 3 (the PS device must support PS Level
-3). For any of these choices, you may force a monochrome image by
-appending the modifier <strong>+m</strong>. Colors are then converted to shades
-of gray using the (monochrome television) YIQ transformation.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-</dl>
-<p>For perspective view <strong>p</strong>, optionally append /<em>zmin</em>/<em>zmax</em>. <a class="reference internal" href="gmt.html#rz-full"><em>(more ...)</em></a> This option may be used to
-indicate the range used for the 3-D axes [Default is region given by
-the <em>relief_file</em>]. You may ask for a larger <em>w/e/s/n</em> region to
-have more room between the image and the axes. A smaller region than
-specified in the <em>relief_file</em> will result in a subset of the grid.</p>
-<dl class="docutils">
-<dt><strong>-S</strong><em>smooth</em></dt>
-<dd>Smooth the contours before plotting (see <strong>grdcontour</strong>) [Default is
-no smoothing].</dd>
-<dt><strong>-T</strong>[<strong>s</strong>][<strong>o</strong>[<em>pen</em>]]</dt>
-<dd>Plot image without any interpolation. This involves converting each
-node-centered bin into a polygon which is then painted separately.
-Append <strong>s</strong> to skip nodes with z = NaN. This option is useful for
-categorical data where interpolating between values is meaningless.
-Optionally, append <strong>o</strong> to draw the tile outlines, and specify a
-custom pen if the default pen is not to your liking. As this option
-produces a flat surface it cannot be combined with <strong>-JZ</strong> or
-<strong>-Jz</strong>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] <a class="reference internal" href="gmt.html#u-full"><em>(more ...)</em></a></dt>
-<dd>Draw GMT time stamp logo on plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<p><strong>-W</strong><strong>type</strong><em>pen</em></p>
-<blockquote>
-<div><dl class="docutils">
-<dt><strong>-Wc</strong></dt>
-<dd>Draw contour lines on top of surface or mesh (not image). Append pen
-attributes used for the contours. [Default: width = 0.75p, color =
-black, style = solid].</dd>
-<dt><strong>-Wm</strong></dt>
-<dd>Sets the pen attributes used for the mesh. [Default: width = 0.25p,
-color = black, style = solid]. You must also select <strong>-Qm</strong> or
-<strong>-Qsm</strong> for meshlines to be drawn.</dd>
-<dt><strong>-Wf</strong></dt>
-<dd>Sets the pen attributes used for the facade. [Default: width =
-0.25p, color = black, style = solid]. You must also select <strong>-N</strong>
-for the facade outline to be drawn.</dd>
-</dl>
-</div></blockquote>
-<p><strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]]</p>
-<dl class="docutils">
-<dt><strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] <a class="reference internal" href="gmt.html#xy-full"><em>(more ...)</em></a></dt>
-<dd>Shift plot origin.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-c</strong><em>copies</em> <a class="reference internal" href="gmt.html#c-full"><em>(more ...)</em></a></dt>
-<dd>Specify number of plot copies [Default is 1].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-n</strong>[<strong>b</strong>|<strong>c</strong>|<strong>l</strong>|<strong>n</strong>][<strong>+a</strong>][<strong>+b</strong><em>BC</em>][<strong>+c</strong>][<strong>+t</strong><em>threshold</em>] <a class="reference internal" href="gmt.html#n-full"><em>(more ...)</em></a></dt>
-<dd>Select interpolation mode for grids.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] <a class="reference internal" href="gmt.html#perspective-full"><em>(more ...)</em></a></dt>
-<dd>Select perspective view. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-t</strong>[<em>transp</em>] <a class="reference internal" href="gmt.html#t-full"><em>(more ...)</em></a></dt>
-<dd>Set PDF transparency level in percent.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="grid-file-formats">
-<h2>Grid File Formats<a class="headerlink" href="#grid-file-formats" title="Permalink to this headline">¶</a></h2>
-<p>By default GMT writes out grid as single precision floats in a
-COARDS-complaint netCDF file format. However, GMT is able to produce
-grid files in many other commonly used grid file formats and also
-facilitates so called “packing” of grids, writing out floating point
-data as 1- or 2-byte integers. To specify the precision, scale and
-offset, the user should add the suffix
-<strong>=</strong><em>id</em>[<strong>/</strong><em>scale</em><strong>/</strong><em>offset</em>[<strong>/</strong><em>nan</em>]], where
-<em>id</em> is a two-letter identifier of the grid type and precision, and
-<em>scale</em> and <em>offset</em> are optional scale factor and offset to be applied
-to all grid values, and <em>nan</em> is the value used to indicate missing
-data. When reading grids, the format is generally automatically
-recognized. If not, the same suffix can be added to input grid file
-names. See <a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section
-<a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a>
-of the GMT Technical Reference and Cookbook for more information.</p>
-<p>When reading a netCDF file that contains multiple grids, GMT will
-read, by default, the first 2-dimensional grid that can find in that
-file. To coax GMT into reading another multi-dimensional variable in
-the grid file, append <strong>?</strong><em>varname</em> to the file name, where <em>varname</em>
-is the name of the variable. Note that you may need to escape the
-special meaning of <strong>?</strong> in your shell program by putting a backslash in
-front of it, or by placing the filename and suffix between quotes or
-double quotes. The <strong>?</strong><em>varname</em> suffix can also be used for output
-grids to specify a variable name different from the default: “z”. See
-<a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section <a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a> of the GMT
-Technical Reference and Cookbook for more information, particularly on
-how to read splices of 3-, 4-, or 5-dimensional grids.</p>
-</div>
-<div class="section" id="consequences-of-grid-resampling">
-<h2>Consequences of grid resampling<a class="headerlink" href="#consequences-of-grid-resampling" title="Permalink to this headline">¶</a></h2>
-<p>Except for Cartesian cases, we need to resample your geographic grid onto
-an equidistant projected grid. In doing so various algorithms come into play
-that projects data from one lattice to another while avoiding anti-aliasing,
-leading to possible distortions.
-One expected effect of resampling with splines is the tendency for the new
-resampled grid to slightly exceed the global min/max limits of the original
-grid. If this is coupled with tight CPT file limits you may find that some
-map areas may show up with fore- or background color due to the resampling.
-In that case you have two options: (1) Modify your CPT file to fit the resampled
-extrema (reported with <strong>-V</strong>) or (2) Impose clipping of resampled values
-so they do not exceed the input min/max values (add <strong>+c</strong> to your <strong>-n</strong>
-option).</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To make a mesh plot from the file hawaii_grav.nc and drawing the
-contours given in the color palette file hawaii.cpt on a Lambert map at
-1.5 cm/degree along the standard parallels 18 and 24, with vertical
-scale 20 mgal/cm, and looking at the surface from SW at 30 degree
-elevation, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdview hawaii_grav.nc -Jl18/24/1.5c -Chawaii.cpt \
- -Jz0.05c -Qm -N-100 -p225/30 -Wc > hawaii_grav_image.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>To create a illuminated color perspective plot of the gridded data set
-image.nc, using the color palette file color.rgb, with linear scaling at
-10 cm/x-unit and tickmarks every 5 units, with intensities provided by
-the file intens.nc, and looking from the SE, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdview image.nc -Jx10.0c -Ccolor.rgb -Qs -p135/30 -Iintens.nc > image3D.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>To make the same plot using the rastering option with dpi = 50, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdview image.nc -Jx10.0c -Ccolor.rgb -Qi50 -p135/30 -Iintens.nc > image3D.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>To create a color PostScript perspective plot of the gridded data set
-magnetics.nc, using the color palette file mag_intens.cpt, draped over
-the relief given by the file topography.nc, with Mercator map width of 6
-inch and tickmarks every 1 degree, with intensities provided by the file
-topo_intens.nc, and looking from the SE, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdview topography.nc -JM6i -Gmagnetics.nc -Cmag_intens.cpt \
- -Qs -p140/30 -Itopo_intens.nc > draped3D.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>Given topo.nc and the Landsat image veggies.ras, first run <strong>grd2rgb</strong>
-to get the red, green, and blue grids, and then drape this image over
-the topography and shade the result for good measure. The commands are</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grd2rgb veggies.ras -Glayer_%c.nc
-gmt grdview topo.nc -JM6i -Qi -p140/30 -Itopo_intens.nc \
- -Glayer_r.nc,layer_g.nc,layer_b.nc > image.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="remarks">
-<h2>Remarks<a class="headerlink" href="#remarks" title="Permalink to this headline">¶</a></h2>
-<p>For the <strong>-Qs</strong> option: PostScript provides no way of smoothly varying
-colors within a polygon, so colors can only vary from polygon to
-polygon. To obtain smooth images this way you may resample the grid
-file(s) using <strong>grdsample</strong> or use a finer grid size when running
-gridding programs like <strong>surface</strong> or <strong>nearneighbor</strong>. Unfortunately,
-this produces huge PostScript files. The alternative is to use the
-<strong>-Qi</strong> option, which computes bilinear or bicubic continuous color
-variations within polygons by using scanline conversion to image the polygons.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="grd2rgb.html"><em>grd2rgb</em></a>,
-<a class="reference internal" href="gmtcolors.html"><em>gmtcolors</em></a>,
-<a class="reference internal" href="grdcontour.html"><em>grdcontour</em></a>,
-<a class="reference internal" href="grdimage.html"><em>grdimage</em></a>,
-<a class="reference internal" href="nearneighbor.html"><em>nearneighbor</em></a>,
-<a class="reference internal" href="psbasemap.html"><em>psbasemap</em></a>,
-<a class="reference internal" href="pscontour.html"><em>pscontour</em></a>, <a class="reference internal" href="pstext.html"><em>pstext</em></a>,
-<a class="reference internal" href="surface.html"><em>surface</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grdview</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#grid-file-formats">Grid File Formats</a></li>
-<li><a class="reference internal" href="#consequences-of-grid-resampling">Consequences of grid resampling</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#remarks">Remarks</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grdvector.html"
- title="previous chapter">grdvector</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grdvolume.html"
- title="next chapter">grdvolume</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/grdview.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grdvolume.html" title="grdvolume"
- >next</a> </li>
- <li class="right" >
- <a href="grdvector.html" title="grdvector"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" >GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/grdvolume.html b/doc_release/html/grdvolume.html
deleted file mode 100644
index 2d05006..0000000
--- a/doc_release/html/grdvolume.html
+++ /dev/null
@@ -1,338 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grdvolume — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GR" href="GR.html" />
- <link rel="next" title="I" href="I.html" />
- <link rel="prev" title="grdview" href="grdview.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="I.html" title="I"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grdview.html" title="grdview"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" accesskey="U">GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grdvolume">
-<span id="index-0"></span><h1>grdvolume<a class="headerlink" href="#grdvolume" title="Permalink to this headline">¶</a></h1>
-<p>grdvolume - Calculate grid volume and area constrained by a contour</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdvolume</strong> <em>grdfile</em> [ <strong>-C</strong><em>cval</em> or <strong>-C</strong><em>low/high/delta</em> or <strong>-Cr</strong><em>low/high</em> ]
-[ <strong>-L</strong><em>base</em> ]
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ]
-[ <strong>-S</strong>[<em>unit</em>] ] [ <strong>-T</strong>[<strong>c</strong>|<strong>h</strong>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-Z</strong><em>fact</em>[/<em>shift</em>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-o</strong><em>cols</em>[,...] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdvolume</strong> reads a 2-D binary grid file and calculates the volume
-contained between the surface and the plane specified by the given
-contour (or zero if not given) and reports the area, volume, and maximum
-mean height (volume/area). Alternatively, specify a range of contours to
-be tried and <strong>grdvolume</strong> will determine the volume and area inside the
-contour for all contour values. Using <strong>-T</strong>, the contour that produced
-the maximum mean height (or maximum curvature of heights vs contour
-value) is reported as well. This feature may be used with <strong>grdfilter</strong>
-in designing an Optimal Robust Separator [<em>Wessel</em>, 1998].</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>grdfile</em></dt>
-<dd>The name of the input 2-D binary grid file. (See GRID FILE FORMAT below.)</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-C</strong><em>cval</em> or <strong>-C</strong><em>low/high/delta</em> or <strong>-Cr</strong><em>low/high</em></dt>
-<dd>find area, volume and mean height (volume/area) inside the <em>cval</em>
-contour. Alternatively, search using all contours from <em>low</em> to
-<em>high</em> in steps of <em>delta</em>. [Default returns area, volume and mean
-height of the entire grid]. The area is measured in the plane of the contour.
-The <strong>Cr</strong> form on the other hand computes volume between the grid
-surface and the plans defined by <em>low</em> and <em>high</em>. Note that this is an
-<em>outside</em> volume whilst the other forms compute an <em>inside</em> (bellow the surface)
-area volume. Use this form to compute for example the volume of water
-between two contours.</dd>
-<dt><strong>-L</strong><em>base</em></dt>
-<dd>Also add in the volume from the level of the contour down to <em>base</em>
-[Default base is contour].</dd>
-<dt><strong>-S</strong>[<em>unit</em>]</dt>
-<dd>Convert degrees to Flat Earth distances, append a unit from
-<strong>e</strong>|<strong>f</strong>|<strong>k</strong>|<strong>M</strong>|<strong>n</strong>|<strong>u</strong>
-[Default is Cartesian].</dd>
-<dt><strong>-T</strong>[<strong>c</strong>|<strong>h</strong>]</dt>
-<dd>Determine the single contour that maximized the average height (=
-volume/area). Select <strong>-Tc</strong> to use the maximum curvature of heights
-versus contour value rather than the contour with the maximum height
-to pick the best contour value (requires <strong>-C</strong>).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-Z</strong><em>fact</em>[/<em>shift</em>]</dt>
-<dd>Optionally subtract <em>shift</em> before scaling data by <em>fact</em>. [Default
-is no scaling]. (Numbers in <strong>-C</strong>, <strong>-L</strong> refer to values after
-this scaling has occurred).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-o</strong><em>cols</em>[,...] <a class="reference internal" href="gmt.html#ocols-full"><em>(more ...)</em></a></dt>
-<dd>Select output columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="grid-file-formats">
-<h2>Grid File Formats<a class="headerlink" href="#grid-file-formats" title="Permalink to this headline">¶</a></h2>
-<p>By default GMT writes out grid as single precision floats in a
-COARDS-complaint netCDF file format. However, GMT is able to produce
-grid files in many other commonly used grid file formats and also
-facilitates so called “packing” of grids, writing out floating point
-data as 1- or 2-byte integers. To specify the precision, scale and
-offset, the user should add the suffix
-<strong>=</strong><em>id</em>[<strong>/</strong><em>scale</em><strong>/</strong><em>offset</em>[<strong>/</strong><em>nan</em>]], where
-<em>id</em> is a two-letter identifier of the grid type and precision, and
-<em>scale</em> and <em>offset</em> are optional scale factor and offset to be applied
-to all grid values, and <em>nan</em> is the value used to indicate missing
-data. When reading grids, the format is generally automatically
-recognized. If not, the same suffix can be added to input grid file
-names. See <a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section
-<a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a>
-of the GMT Technical Reference and Cookbook for more information.</p>
-<p>When reading a netCDF file that contains multiple grids, GMT will
-read, by default, the first 2-dimensional grid that can find in that
-file. To coax GMT into reading another multi-dimensional variable in
-the grid file, append <strong>?</strong><em>varname</em> to the file name, where <em>varname</em>
-is the name of the variable. Note that you may need to escape the
-special meaning of <strong>?</strong> in your shell program by putting a backslash in
-front of it, or by placing the filename and suffix between quotes or
-double quotes. The <strong>?</strong><em>varname</em> suffix can also be used for output
-grids to specify a variable name different from the default: “z”. See
-<a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section <a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a> of the GMT
-Technical Reference and Cookbook for more information, particularly on
-how to read splices of 3-, 4-, or 5-dimensional grids.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To determine the volume in km^3 under the surface hawaii_topo.nc (height in km), use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdvolume hawaii_topo.nc -Sk
-</pre></div>
-</div>
-</div></blockquote>
-<p>To find the volume between the surface peaks.nc and the contour z = 250, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdvolume peaks.nc -Sk -C250
-</pre></div>
-</div>
-</div></blockquote>
-<p>To search for the contour, between 100 and 300 in steps of 10, that
-maximizes the ratio of volume to surface area for the file peaks.nc, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdvolume peaks.nc -Sk -C100/300/10 -Th > results.d
-</pre></div>
-</div>
-</div></blockquote>
-<p>To see the areas and volumes for all the contours in the previous example, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdvolume peaks.nc -Sk -C100/300/10 > results.d
-</pre></div>
-</div>
-</div></blockquote>
-<p>To find the volume of water in a lake with its free surface at 0 and max depth of 300 meters, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdvolume lake.nc -Cr-300/0
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="notes">
-<h2>Notes<a class="headerlink" href="#notes" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdvolume</strong> distinguishes between gridline and pixel-registered grids.
-In both cases the area and volume are computed up to the grid
-boundaries. That means that in the first case the grid cells on the
-boundary only contribute half their area (and volume), whereas in the
-second case all grid cells are fully used. The exception is when the
-<strong>-C</strong> flag is used: since contours do not extend beyond the outermost
-grid point, both grid types are treated the same. That means the outer
-rim in pixel oriented grids is ignored when using the <strong>-C</strong> flag.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="grdfilter.html"><em>grdfilter</em></a>,
-<a class="reference internal" href="grdmask.html"><em>grdmask</em></a>,
-<a class="reference internal" href="grdmath.html"><em>grdmath</em></a></p>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>Wessel, P., 1998, An empirical method for optimal robust
-regional-residual separation of geophysical data, <em>Math. Geol.</em>, <strong>30</strong>(4), 391-408.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grdvolume</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#grid-file-formats">Grid File Formats</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#notes">Notes</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grdview.html"
- title="previous chapter">grdview</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="I.html"
- title="next chapter">I</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/grdvolume.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="I.html" title="I"
- >next</a> </li>
- <li class="right" >
- <a href="grdview.html" title="grdview"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" >GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/greenspline.html b/doc_release/html/greenspline.html
deleted file mode 100644
index 8cf3090..0000000
--- a/doc_release/html/greenspline.html
+++ /dev/null
@@ -1,543 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>greenspline — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="GR" href="GR.html" />
- <link rel="next" title="grd2cpt" href="grd2cpt.html" />
- <link rel="prev" title="GR" href="GR.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grd2cpt.html" title="grd2cpt"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="GR.html" title="GR"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" accesskey="U">GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="greenspline">
-<span id="index-0"></span><h1>greenspline<a class="headerlink" href="#greenspline" title="Permalink to this headline">¶</a></h1>
-<p>greenspline - Interpolate using Green’s functions for splines in 1-3 dimensions</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>greenspline</strong> [ <em>table</em> ]
-[ <strong>-A</strong>[<strong>1</strong>|<strong>2</strong>|<strong>3</strong>|<strong>4</strong>|<strong>5</strong>,]<em>gradfile</em> ]
-[ <strong>-C</strong>[<strong>n</strong>|<strong>v</strong>]<em>cut</em>[/<em>file</em>] ] [ <strong>-D</strong><em>mode</em> ] [ <strong>-G</strong><em>grdfile</em> ]
-[ <strong>-I</strong><em>xinc</em>[/<em>yinc</em>[/<em>zinc</em>]] ] [ <strong>-L</strong> ] [ <strong>-N</strong><em>nodefile</em> ]
-[ <strong>-Q</strong><em>az</em>|<em>x/y/z</em> ]
-[ <strong>-R</strong><em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>] ]
-[ <strong>-S</strong><strong>c|t|l|r|p|q</strong>[<em>pars</em>] ] [ <strong>-T</strong><em>maskgrid</em> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W</strong> ]
-[ <strong>-b</strong>[<strong>i</strong>|<strong>o</strong>][<em>ncol</em>][<strong>type</strong>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-o</strong><em>cols</em>[,...] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>greenspline</strong> uses the Green’s function G(<strong>x</strong>; <strong>x’</strong>) for the
-chosen spline and geometry to interpolate data at regular [or arbitrary]
-output locations. Mathematically, the solution is composed as
-<em>w</em>(<strong>x</strong>) = sum {<em>c</em>(<em>i</em>) G(<strong>x’</strong>; <strong>x</strong>(<em>i</em>))}, for <em>i</em> = 1,
-<em>n</em>, the number of data points {<strong>x</strong>(<em>i</em>), <em>w</em>(<em>i</em>)}. Once the <em>n</em>
-coefficients <em>c</em>(<em>i</em>) have been found the sum can be evaluated at any
-output point <strong>x</strong>. Choose between minimum curvature, regularized, or
-continuous curvature splines in tension for either 1-D, 2-D, or 3-D
-Cartesian coordinates or spherical surface coordinates. After first
-removing a linear or planar trend (Cartesian geometries) or mean value
-(spherical surface) and normalizing these residuals, the least-squares
-matrix solution for the spline coefficients <em>c</em>(<em>i</em>) is found by
-solving the <em>n</em> by <em>n</em> linear system <em>w</em>(<em>j</em>) = sum-over-<em>i</em>
-{<em>c</em>(<em>i</em>) G(<strong>x</strong>(<em>j</em>); <strong>x</strong>(<em>i</em>))}, for <em>j</em> = 1, <em>n</em>; this
-solution yields an exact interpolation of the supplied data points.
-Alternatively, you may choose to perform a singular value decomposition
-(SVD) and eliminate the contribution from the smallest eigenvalues; this
-approach yields an approximate solution. Trends and scales are restored
-when evaluating the output.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<p>None.</p>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>The name of one or more ASCII [or binary, see
-<strong>-bi</strong>] files holding the <strong>x</strong>, <em>w</em> data
-points. If no file is given then we read standard input instead.</dd>
-<dt><strong>-A</strong>[<strong>1</strong>|<strong>2</strong>|<strong>3</strong>|<strong>4</strong>|<strong>5</strong>,]<em>gradfile</em></dt>
-<dd>The solution will partly be constrained by surface gradients <strong>v</strong> =
-<em>v</em>*<strong>n</strong>, where <em>v</em> is the gradient magnitude and <strong>n</strong> its
-unit vector direction. The gradient direction may be specified
-either by Cartesian components (either unit vector <strong>n</strong> and
-magnitude <em>v</em> separately or gradient components <strong>v</strong> directly) or
-angles w.r.t. the coordinate axes. Specify one of five input
-formats: <strong>0</strong>: For 1-D data there is no direction, just gradient
-magnitude (slope) so the input format is <em>x</em>, <em>gradient</em>. Options
-1-2 are for 2-D data sets: <strong>1</strong>: records contain <em>x</em>, <em>y</em>,
-<em>azimuth</em>, <em>gradient</em> (<em>azimuth</em> in degrees is measured clockwise
-from the vertical (north) [Default]). <strong>2</strong>: records contain <em>x</em>,
-<em>y</em>, <em>gradient</em>, <em>azimuth</em> (<em>azimuth</em> in degrees is measured
-clockwise from the vertical (north)). Options 3-5 are for either 2-D
-or 3-D data: <strong>3</strong>: records contain <strong>x</strong>, <em>direction(s)</em>, <em>v</em>
-(<em>direction(s)</em> in degrees are measured counter-clockwise from the
-horizontal (and for 3-D the vertical axis). <strong>4</strong>: records contain
-<strong>x</strong>, <strong>v</strong>. <strong>5</strong>: records contain <strong>x</strong>, <strong>n</strong>, <em>v</em>. Append name
-of ASCII file with the surface gradients (following a comma if a
-format is specified).</dd>
-<dt><strong>-C</strong>[<strong>n</strong>|<strong>v</strong>]<em>cut</em>[/<em>file</em>]</dt>
-<dd>Find an approximate surface fit: Solve the linear system for the
-spline coefficients by SVD and eliminate the contribution from all
-eigenvalues whose ratio to the largest eigenvalue is less than <em>cut</em>
-[Default uses Gauss-Jordan elimination to solve the linear system
-and fit the data exactly]. Optionally, append /<em>file</em> to save the
-eigenvalue ratios to the specified file for further analysis.
-Finally, if a negative <em>cut</em> is given then /<em>file</em> is required and
-execution will stop after saving the eigenvalues, i.e., no surface
-output is produced. Specify <strong>-Cv</strong> to use the
-largest eigenvalues needed to explain <em>cut</em> % of the data variance.
-Alternatively, use <strong>-Cn</strong> to select the <em>cut</em> largest eigenvalues.
-If a <em>file</em> is given with <strong>-Cv</strong> then we save the eigenvalues instead
-of the ratios.</dd>
-<dt><strong>-D</strong><em>mode</em></dt>
-<dd>Sets the distance flag that determines how we calculate distances
-between data points. Select <em>mode</em> 0 for Cartesian 1-D spline
-interpolation: <strong>-D</strong>0 means (<em>x</em>) in user units, Cartesian
-distances, Select <em>mode</em> 1-3 for Cartesian 2-D surface spline
-interpolation: <strong>-D</strong>1 means (<em>x</em>,<em>y</em>) in user units, Cartesian
-distances, <strong>-D</strong>2 for (<em>x</em>,<em>y</em>) in degrees, Flat Earth
-distances, and <strong>-D</strong>3 for (<em>x</em>,<em>y</em>) in degrees, Spherical
-distances in km. Then, if <a class="reference internal" href="gmt.conf.html#proj-ellipsoid"><em>PROJ_ELLIPSOID</em></a> is spherical, we
-compute great circle arcs, otherwise geodesics. Option <em>mode</em> = 4
-applies to spherical surface spline interpolation only: <strong>-D</strong>4
-for (<em>x</em>,<em>y</em>) in degrees, use cosine of great circle (or geodesic)
-arcs. Select <em>mode</em> 5 for Cartesian 3-D surface spline
-interpolation: <strong>-D</strong>5 means (<em>x</em>,<em>y</em>,<em>z</em>) in user units,
-Cartesian distances.</dd>
-<dt><strong>-G</strong><em>grdfile</em></dt>
-<dd>Name of resulting output file. (1) If options <strong>-R</strong>, <strong>-I</strong>, and
-possibly <strong>-r</strong> are set we produce an equidistant output table. This
-will be written to stdout unless <strong>-G</strong> is specified. Note: for 2-D
-grids the <strong>-G</strong> option is required. (2) If option <strong>-T</strong> is
-selected then <strong>-G</strong> is required and the output file is a 2-D binary
-grid file. Applies to 2-D interpolation only. (3) If <strong>-N</strong> is
-selected then the output is an ASCII (or binary; see
-<strong>-bo</strong>) table; if <strong>-G</strong> is not given then
-this table is written to standard output. Ignored if <strong>-C</strong> or
-<strong>-C</strong>0 is given.</dd>
-<dt><strong>-I</strong><em>xinc</em>[/<em>yinc</em>[/<em>zinc</em>]]</dt>
-<dd>Specify equidistant sampling intervals, on for each dimension,
-separated by slashes.</dd>
-<dt><strong>-L</strong></dt>
-<dd>Do <em>not</em> remove a linear (1-D) or planer (2-D) trend when <strong>-D</strong>
-selects mode 0-3 [For those Cartesian cases a least-squares line or
-plane is modeled and removed, then restored after fitting a spline
-to the residuals]. However, in mixed cases with both data values and
-gradients, or for spherical surface data, only the mean data value
-is removed (and later and restored).</dd>
-<dt><strong>-N</strong><em>nodefile</em></dt>
-<dd>ASCII file with coordinates of desired output locations <strong>x</strong> in the
-first column(s). The resulting <em>w</em> values are appended to each
-record and written to the file given in <strong>-G</strong> [or stdout if not
-specified]; see <strong>-bo</strong> for binary output
-instead. This option eliminates the need to specify options <strong>-R</strong>,
-<strong>-I</strong>, and <strong>-r</strong>.</dd>
-<dt><strong>-Q</strong><em>az</em>|<em>x/y/z</em></dt>
-<dd>Rather than evaluate the surface, take the directional derivative in
-the <em>az</em> azimuth and return the magnitude of this derivative
-instead. For 3-D interpolation, specify the three components of the
-desired vector direction (the vector will be normalized before use).</dd>
-<dt><strong>-R</strong><em>xmin</em>/<em>xmax</em>[/<em>ymin</em>/<em>ymax</em>[/<em>zmin</em><em>zmax</em>]]</dt>
-<dd><p class="first">Specify the domain for an equidistant lattice where output
-predictions are required. Requires <strong>-I</strong> and optionally <strong>-r</strong>.</p>
-<p><em>1-D:</em> Give <em>xmin/xmax</em>, the minimum and maximum <em>x</em> coordinates.</p>
-<p><em>2-D:</em> Give <em>xmin/xmax/ymin/ymax</em>, the minimum and maximum <em>x</em> and
-<em>y</em> coordinates. These may be Cartesian or geographical. If
-geographical, then <em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> specify the
-Region of interest, and you may specify them in decimal degrees or
-in [+-]dd:mm[:ss.xxx][W|E|S|N] format. The two shorthands <strong>-Rg</strong>
-and <strong>-Rd</strong> stand for global domain (0/360 and -180/+180 in
-longitude respectively, with -90/+90 in latitude).</p>
-<p class="last"><em>3-D:</em> Give <em>xmin/xmax/ymin/ymax/zmin/zmax</em>, the minimum and maximum
-<em>x</em>, <em>y</em> and <em>z</em> coordinates. See the 2-D section if your horizontal
-coordinates are geographical; note the shorthands <strong>-Rg</strong> and
-<strong>-Rd</strong> cannot be used if a 3-D domain is specified.</p>
-</dd>
-<dt><strong>-S</strong><strong>c|t|l|r|p|q</strong>[<em>pars</em>]</dt>
-<dd>Select one of six different splines. The first two are used for
-1-D, 2-D, or 3-D Cartesian splines (see <strong>-D</strong> for discussion). Note
-that all tension values are expected to be normalized tension in the
-range 0 < <em>t</em> < 1: (<strong>c</strong>) Minimum curvature spline [<em>Sandwell</em>,
-1987], (<strong>t</strong>) Continuous curvature spline in tension [<em>Wessel and
-Bercovici</em>, 1998]; append <em>tension</em>[/<em>scale</em>] with <em>tension</em> in
-the 0-1 range and optionally supply a length scale [Default is the
-average grid spacing]. The next is a 1-D or 2-D spline: (<strong>l</strong>)
-Linear (1-D) or Bilinear (2-D) spline; these produce output that do
-not exceed the range of the given data. The next is a 2-D or 3-D spline: (<strong>r</strong>)
-Regularized spline in tension [<em>Mitasova and Mitas</em>, 1993]; again,
-append <em>tension</em> and optional <em>scale</em>. The last two are spherical
-surface splines and both imply <strong>-D</strong>4: (<strong>p</strong>) Minimum
-curvature spline [<em>Parker</em>, 1994], (<strong>q</strong>) Continuous curvature
-spline in tension [<em>Wessel and Becker</em>, 2008]; append <em>tension</em>. The
-G(<strong>x’</strong>; <strong>x’</strong>) for the last method is slower to compute (a series solution) so we
-pre-calculate values and use cubic spline interpolation lookup instead.
-Optionally append <strong>+n</strong><em>N</em> (an odd integer) to change how many
-points to use in the spline setup [10001]. The finite Legendre sum has
-a truncation error [1e-6]; you can lower that by appending <strong>+e</strong><em>limit</em>
-at the expense of longer run-time.</dd>
-<dt><strong>-T</strong><em>maskgrid</em></dt>
-<dd>For 2-D interpolation only. Only evaluate the solution at the nodes
-in the <em>maskgrid</em> that are not equal to NaN. This option eliminates
-the need to specify options <strong>-R</strong>, <strong>-I</strong>, and <strong>-r</strong>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong></dt>
-<dd>Expect data weights in the final input column, typically given as
-weight = 1 / sigma, the data uncertainty. This results in a weighted
-least squares fit. Note that this only has an effect if <strong>-CC</strong> is used.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 2-4 input
-columns (<strong>x</strong>,<em>w</em>); the number depends on the chosen dimension].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-o</strong><em>cols</em>[,...] <a class="reference internal" href="gmt.html#ocols-full"><em>(more ...)</em></a></dt>
-<dd>Select output columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-r</strong> <a class="reference internal" href="gmt.html#nodereg-full"><em>(more ...)</em></a></dt>
-<dd>Set pixel node registration [gridline]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="d-examples">
-<h2>1-d Examples<a class="headerlink" href="#d-examples" title="Permalink to this headline">¶</a></h2>
-<p>To resample the <em>x</em>,<em>y</em> Gaussian random data created by <a class="reference internal" href="gmtmath.html"><em>gmtmath</em></a>
-and stored in 1D.txt, requesting output every 0.1 step from 0 to 10, and
-using a minimum cubic spline, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtmath -T0/10/1 0 1 NRAND = 1D.txt
-gmt psxy -R0/10/-5/5 -JX6i/3i -B2f1/1 -Sc0.1 -Gblack 1D.txt -K > 1D.ps
-gmt greenspline 1D.txt -R0/10 -I0.1 -Sc -V | psxy -R -J -O -Wthin >> 1D.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>To apply a spline in tension instead, using a tension of 0.7, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psxy -R0/10/-5/5 -JX6i/3i -B2f1/1 -Sc0.1 -Gblack 1D.txt -K > 1Dt.ps
-gmt greenspline 1D.txt -R0/10 -I0.1 -St0.7 -V | psxy -R -J -O -Wthin >> 1Dt.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="id1">
-<h2>2-d Examples<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>To make a uniform grid using the minimum curvature spline for the same
-Cartesian data set from Davis (1986) that is used in the GMT Technical
-Reference and Cookbook example 16, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt greenspline table_5.11 -R0/6.5/-0.2/6.5 -I0.1 -Sc -V -D1 -GS1987.nc
-gmt psxy -R0/6.5/-0.2/6.5 -JX6i -B2f1 -Sc0.1 -Gblack table_5.11 -K > 2D.ps
-gmt grdcontour -JX6i -B2f1 -O -C25 -A50 S1987.nc >> 2D.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>To use Cartesian splines in tension but only evaluate the solution where
-the input mask grid is not NaN, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt greenspline table_5.11 -Tmask.nc -St0.5 -V -D1 -GWB1998.nc
-</pre></div>
-</div>
-</div></blockquote>
-<p>To use Cartesian generalized splines in tension and return the magnitude
-of the surface slope in the NW direction, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt greenspline table_5.11 -R0/6.5/-0.2/6.5 -I0.1 -Sr0.95 -V -D1 -Q-45 -Gslopes.nc
-</pre></div>
-</div>
-</div></blockquote>
-<p>Finally, to use Cartesian minimum curvature splines in recovering a
-surface where the input data is a single surface value (pt.d) and the
-remaining constraints specify only the surface slope and direction
-(slopes.d), use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt greenspline pt.d -R-3.2/3.2/-3.2/3.2 -I0.1 -Sc -V -D1 -A1,slopes.d -Gslopes.nc
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="id2">
-<h2>3-d Examples<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h2>
-<p>To create a uniform 3-D Cartesian grid table based on the data in
-table_5.23 in Davis (1986) that contains <em>x</em>,<em>y</em>,<em>z</em> locations and
-a measure of uranium oxide concentrations (in percent), try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt greenspline table_5.23 -R5/40/-5/10/5/16 -I0.25 -Sr0.85 -V -D5 -G3D_UO2.txt
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="d-spherical-surface-examples">
-<h2>2-d Spherical Surface Examples<a class="headerlink" href="#d-spherical-surface-examples" title="Permalink to this headline">¶</a></h2>
-<p>To recreate Parker’s [1994] example on a global 1x1 degree grid,
-assuming the data are in file mag_obs_1990.d, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>greenspline -V -Rg -Sp -D3 -I1 -GP1994.nc mag_obs_1990.d
-</pre></div>
-</div>
-</div></blockquote>
-<p>To do the same problem but applying tension of 0.85, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>greenspline -V -Rg -Sq0.85 -D3 -I1 -GWB2008.nc mag_obs_1990.d
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="considerations">
-<h2>Considerations<a class="headerlink" href="#considerations" title="Permalink to this headline">¶</a></h2>
-<p>(1) For the Cartesian cases we use the free-space Green functions, hence
-no boundary conditions are applied at the edges of the specified domain.
-For most applications this is fine as the region typically is
-arbitrarily set to reflect the extent of your data. However, if your
-application requires particular boundary conditions then you may
-consider using <a class="reference internal" href="surface.html"><em>surface</em></a> instead.</p>
-<p>(2) In all cases, the solution is obtained by inverting a <em>n</em> x <em>n</em>
-double precision matrix for the Green function coefficients, where <em>n</em>
-is the number of data constraints. Hence, your computer’s memory may
-place restrictions on how large data sets you can process with
-<cite>greenspline <greenspline.html></cite>. Pre-processing your data with <cite>blockmean <blockmean.html></cite>,
-<cite>blockmedian <blockmedian.html></cite>, or <cite>blockmode <blockmode.html></cite> is recommended to avoid aliasing and
-may also control the size of <em>n</em>. For information, if <em>n</em> = 1024 then
-only 8 Mb memory is needed, but for <em>n</em> = 10240 we need 800 Mb. Note
-that <cite>greenspline <greenspline.html></cite> is fully 64-bit compliant if compiled as such.
-For spherical data you may consider decimating using <cite>gmtspatial <gmtspatial.html></cite>
-nearest neighbor reduction.</p>
-<p>(3) The inversion for coefficients can become numerically unstable when
-data neighbors are very close compared to the overall span of the data.
-You can remedy this by pre-processing the data, e.g., by averaging
-closely spaced neighbors. Alternatively, you can improve stability by
-using the SVD solution and discard information associated with the
-smallest eigenvalues (see <strong>-C</strong>).</p>
-<p>(4) The series solution implemented for <strong>-Sq</strong> was developed by
-Robert L. Parker, Scripps Institution of Oceanography, which we
-gratefully acknowledge.</p>
-</div>
-<div class="section" id="tension">
-<h2>Tension<a class="headerlink" href="#tension" title="Permalink to this headline">¶</a></h2>
-<p>Tension is generally used to suppress spurious oscillations caused by
-the minimum curvature requirement, in particular when rapid gradient
-changes are present in the data. The proper amount of tension can only
-be determined by experimentation. Generally, very smooth data (such as
-potential fields) do not require much, if any tension, while rougher
-data (such as topography) will typically interpolate better with
-moderate tension. Make sure you try a range of values before choosing
-your final result. Note: the regularized spline in tension is only
-stable for a finite range of <em>scale</em> values; you must experiment to find
-the valid range and a useful setting. For more information on tension
-see the references below.</p>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>Davis, J. C., 1986, <em>Statistics and Data Analysis in Geology</em>, 2nd
-Edition, 646 pp., Wiley, New York,</p>
-<p>Mitasova, H., and L. Mitas, 1993, Interpolation by regularized spline
-with tension: I. Theory and implementation, <em>Math. Geol.</em>, <strong>25</strong>,
-641-655.</p>
-<p>Parker, R. L., 1994, <em>Geophysical Inverse Theory</em>, 386 pp., Princeton
-Univ. Press, Princeton, N.J.</p>
-<p>Sandwell, D. T., 1987, Biharmonic spline interpolation of Geos-3 and
-Seasat altimeter data, <em>Geophys. Res. Lett.</em>, <strong>14</strong>, 139-142.</p>
-<p>Wessel, P., and D. Bercovici, 1998, Interpolation with splines in
-tension: a Green’s function approach, <em>Math. Geol.</em>, <strong>30</strong>, 77-93.</p>
-<p>Wessel, P., and J. M. Becker, 2008, Interpolation using a generalized
-Green’s function for a spherical surface spline in tension, <em>Geophys. J.
-Int</em>, <strong>174</strong>, 21-28.</p>
-<p>Wessel, P., 2009, A general-purpose Green’s function interpolator,
-<em>Computers & Geosciences</em>, <strong>35</strong>, 1247-1254, doi:10.1016/j.cageo.2008.08.012.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="gmtmath.html"><em>gmtmath</em></a>,
-<a class="reference internal" href="nearneighbor.html"><em>nearneighbor</em></a>, <a class="reference internal" href="psxy.html"><em>psxy</em></a>,
-<a class="reference internal" href="sphtriangulate.html"><em>sphtriangulate</em></a>,
-<a class="reference internal" href="surface.html"><em>surface</em></a>,
-<a class="reference internal" href="triangulate.html"><em>triangulate</em></a>, <a class="reference internal" href="xyz2grd.html"><em>xyz2grd</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">greenspline</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#d-examples">1-d Examples</a></li>
-<li><a class="reference internal" href="#id1">2-d Examples</a></li>
-<li><a class="reference internal" href="#id2">3-d Examples</a></li>
-<li><a class="reference internal" href="#d-spherical-surface-examples">2-d Spherical Surface Examples</a></li>
-<li><a class="reference internal" href="#considerations">Considerations</a></li>
-<li><a class="reference internal" href="#tension">Tension</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="GR.html"
- title="previous chapter">GR</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grd2cpt.html"
- title="next chapter">grd2cpt</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/greenspline.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grd2cpt.html" title="grd2cpt"
- >next</a> </li>
- <li class="right" >
- <a href="GR.html" title="GR"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="GR.html" >GR</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/index.html b/doc_release/html/index.html
deleted file mode 100644
index 8ee68a3..0000000
--- a/doc_release/html/index.html
+++ /dev/null
@@ -1,491 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>Man pages — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="#" />
- <link rel="next" title="Man Pages" href="man_pages.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="man_pages.html" title="Man Pages"
- accesskey="N">next</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="#">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="toctree-wrapper compound">
-</div>
-<div class="section" id="man-pages">
-<h1>Man pages<a class="headerlink" href="#man-pages" title="Permalink to this headline">¶</a></h1>
-<table border="1" class="docutils">
-<colgroup>
-<col width="25%" />
-<col width="25%" />
-<col width="25%" />
-<col width="25%" />
-</colgroup>
-<tbody valign="top">
-<tr class="row-odd"><td><div class="toctree-wrapper first last compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="B.html">B</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="blockmean.html">blockmean</a></li>
-<li class="toctree-l2"><a class="reference internal" href="blockmedian.html">blockmedian</a></li>
-<li class="toctree-l2"><a class="reference internal" href="blockmode.html">blockmode</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="F.html">F</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="filter1d.html">filter1d</a></li>
-<li class="toctree-l2"><a class="reference internal" href="fitcircle.html">fitcircle</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="GM.html">GM</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="gmt.conf.html">gmt.conf</a></li>
-<li class="toctree-l2"><a class="reference internal" href="gmt.html">gmt</a></li>
-<li class="toctree-l2"><a class="reference internal" href="gmt2kml.html">gmt2kml</a></li>
-<li class="toctree-l2"><a class="reference internal" href="gmt5syntax.html">gmt5syntax</a></li>
-<li class="toctree-l2"><a class="reference internal" href="gmtcolors.html">gmtcolors</a></li>
-<li class="toctree-l2"><a class="reference internal" href="gmtconnect.html">gmtconnect</a></li>
-<li class="toctree-l2"><a class="reference internal" href="gmtconvert.html">gmtconvert</a></li>
-<li class="toctree-l2"><a class="reference internal" href="gmtdefaults.html">gmtdefaults</a></li>
-<li class="toctree-l2"><a class="reference internal" href="gmtget.html">gmtget</a></li>
-<li class="toctree-l2"><a class="reference internal" href="gmtinfo.html">gmtinfo</a></li>
-<li class="toctree-l2"><a class="reference internal" href="gmtlogo.html">gmtlogo</a></li>
-<li class="toctree-l2"><a class="reference internal" href="gmtmath.html">gmtmath</a></li>
-<li class="toctree-l2"><a class="reference internal" href="gmtselect.html">gmtselect</a></li>
-<li class="toctree-l2"><a class="reference internal" href="gmtset.html">gmtset</a></li>
-<li class="toctree-l2"><a class="reference internal" href="gmt_shell_functions.sh.html">gmt_shell_functions.sh</a></li>
-<li class="toctree-l2"><a class="reference internal" href="gmtsimplify.html">gmtsimplify</a></li>
-<li class="toctree-l2"><a class="reference internal" href="gmtspatial.html">gmtspatial</a></li>
-<li class="toctree-l2"><a class="reference internal" href="gmtswitch.html">gmtswitch</a></li>
-<li class="toctree-l2"><a class="reference internal" href="gmtvector.html">gmtvector</a></li>
-<li class="toctree-l2"><a class="reference internal" href="gmtwhich.html">gmtwhich</a></li>
-</ul>
-</li>
-</ul>
-</div>
-</td>
-<td><div class="toctree-wrapper first last compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="GR.html">GR</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="greenspline.html">greenspline</a></li>
-<li class="toctree-l2"><a class="reference internal" href="grd2cpt.html">grd2cpt</a></li>
-<li class="toctree-l2"><a class="reference internal" href="grd2rgb.html">grd2rgb</a></li>
-<li class="toctree-l2"><a class="reference internal" href="grd2xyz.html">grd2xyz</a></li>
-<li class="toctree-l2"><a class="reference internal" href="grdblend.html">grdblend</a></li>
-<li class="toctree-l2"><a class="reference internal" href="grdclip.html">grdclip</a></li>
-<li class="toctree-l2"><a class="reference internal" href="grdcontour.html">grdcontour</a></li>
-<li class="toctree-l2"><a class="reference internal" href="grdcut.html">grdcut</a></li>
-<li class="toctree-l2"><a class="reference internal" href="grdedit.html">grdedit</a></li>
-<li class="toctree-l2"><a class="reference internal" href="grdfft.html">grdfft</a></li>
-<li class="toctree-l2"><a class="reference internal" href="grdfilter.html">grdfilter</a></li>
-<li class="toctree-l2"><a class="reference internal" href="grdgradient.html">grdgradient</a></li>
-<li class="toctree-l2"><a class="reference internal" href="grdhisteq.html">grdhisteq</a></li>
-<li class="toctree-l2"><a class="reference internal" href="grdimage.html">grdimage</a></li>
-<li class="toctree-l2"><a class="reference internal" href="grdinfo.html">grdinfo</a></li>
-<li class="toctree-l2"><a class="reference internal" href="grdlandmask.html">grdlandmask</a></li>
-<li class="toctree-l2"><a class="reference internal" href="grdmask.html">grdmask</a></li>
-<li class="toctree-l2"><a class="reference internal" href="grdmath.html">grdmath</a></li>
-<li class="toctree-l2"><a class="reference internal" href="grdpaste.html">grdpaste</a></li>
-<li class="toctree-l2"><a class="reference internal" href="grdproject.html">grdproject</a></li>
-<li class="toctree-l2"><a class="reference internal" href="grdraster.html">grdraster</a></li>
-<li class="toctree-l2"><a class="reference internal" href="grdreformat.html">grdreformat</a></li>
-<li class="toctree-l2"><a class="reference internal" href="grdsample.html">grdsample</a></li>
-<li class="toctree-l2"><a class="reference internal" href="grdtrack.html">grdtrack</a></li>
-<li class="toctree-l2"><a class="reference internal" href="grdtrend.html">grdtrend</a></li>
-<li class="toctree-l2"><a class="reference internal" href="grdvector.html">grdvector</a></li>
-<li class="toctree-l2"><a class="reference internal" href="grdview.html">grdview</a></li>
-<li class="toctree-l2"><a class="reference internal" href="grdvolume.html">grdvolume</a></li>
-</ul>
-</li>
-</ul>
-</div>
-</td>
-<td><div class="toctree-wrapper first last compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="I.html">I</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="isogmt.html">isogmt</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="K.html">K</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="kml2gmt.html">kml2gmt</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="M.html">M</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="makecpt.html">makecpt</a></li>
-<li class="toctree-l2"><a class="reference internal" href="mapproject.html">mapproject</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="N.html">N</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="nearneighbor.html">nearneighbor</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="P.html">P</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="project.html">project</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="PS.html">PS</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="ps2raster.html">ps2raster</a></li>
-<li class="toctree-l2"><a class="reference internal" href="psbasemap.html">psbasemap</a></li>
-<li class="toctree-l2"><a class="reference internal" href="psclip.html">psclip</a></li>
-<li class="toctree-l2"><a class="reference internal" href="pscoast.html">pscoast</a></li>
-<li class="toctree-l2"><a class="reference internal" href="pscontour.html">pscontour</a></li>
-<li class="toctree-l2"><a class="reference internal" href="pshistogram.html">pshistogram</a></li>
-<li class="toctree-l2"><a class="reference internal" href="psimage.html">psimage</a></li>
-<li class="toctree-l2"><a class="reference internal" href="pslegend.html">pslegend</a></li>
-<li class="toctree-l2"><a class="reference internal" href="pslib.html">pslib</a></li>
-<li class="toctree-l2"><a class="reference internal" href="psmask.html">psmask</a></li>
-<li class="toctree-l2"><a class="reference internal" href="psrose.html">psrose</a></li>
-<li class="toctree-l2"><a class="reference internal" href="psscale.html">psscale</a></li>
-<li class="toctree-l2"><a class="reference internal" href="pstext.html">pstext</a></li>
-<li class="toctree-l2"><a class="reference internal" href="pswiggle.html">pswiggle</a></li>
-<li class="toctree-l2"><a class="reference internal" href="psxy.html">psxy</a></li>
-<li class="toctree-l2"><a class="reference internal" href="psxyz.html">psxyz</a></li>
-</ul>
-</li>
-</ul>
-</div>
-</td>
-<td><div class="toctree-wrapper first last compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="S.html">S</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="sample1d.html">sample1d</a></li>
-<li class="toctree-l2"><a class="reference internal" href="spectrum1d.html">spectrum1d</a></li>
-<li class="toctree-l2"><a class="reference internal" href="sph2grd.html">sph2grd</a></li>
-<li class="toctree-l2"><a class="reference internal" href="sphdistance.html">sphdistance</a></li>
-<li class="toctree-l2"><a class="reference internal" href="sphinterpolate.html">sphinterpolate</a></li>
-<li class="toctree-l2"><a class="reference internal" href="sphtriangulate.html">sphtriangulate</a></li>
-<li class="toctree-l2"><a class="reference internal" href="splitxyz.html">splitxyz</a></li>
-<li class="toctree-l2"><a class="reference internal" href="surface.html">surface</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="T.html">T</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="trend1d.html">trend1d</a></li>
-<li class="toctree-l2"><a class="reference internal" href="trend2d.html">trend2d</a></li>
-<li class="toctree-l2"><a class="reference internal" href="triangulate.html">triangulate</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="X.html">X</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="xyz2grd.html">xyz2grd</a></li>
-</ul>
-</li>
-</ul>
-</div>
-</td>
-</tr>
-</tbody>
-</table>
-<div class="section" id="supplements">
-<h2>Supplements<a class="headerlink" href="#supplements" title="Permalink to this headline">¶</a></h2>
-<table border="1" class="docutils">
-<colgroup>
-<col width="33%" />
-<col width="33%" />
-<col width="33%" />
-</colgroup>
-<tbody valign="top">
-<tr class="row-odd"><td><div class="toctree-wrapper first last compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="SUP_GSHHS.html">GSHHG</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="supplements/gshhg/gshhg.html">gshhg</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="SUP_IMGSRC.html">IMGSRC</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="supplements/img/img2grd.html">img2grd</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/img/img2google.html">img2google</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="SUP_MECA.html">MECA</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="supplements/meca/pscoupe.html">pscoupe</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/meca/psmeca.html">psmeca</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/meca/pspolar.html">pspolar</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/meca/psvelo.html">psvelo</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="SUP_MGD77.html">MGD77</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="supplements/mgd77/mgd77convert.html">mgd77convert</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/mgd77/mgd77info.html">mgd77info</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/mgd77/mgd77list.html">mgd77list</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/mgd77/mgd77magref.html">mgd77magref</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/mgd77/mgd77manage.html">mgd77manage</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/mgd77/mgd77path.html">mgd77path</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/mgd77/mgd77sniffer.html">mgd77sniffer</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/mgd77/mgd77track.html">mgd77track</a></li>
-</ul>
-</li>
-</ul>
-</div>
-</td>
-<td><div class="toctree-wrapper first last compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="SUP_MISC.html">MISC</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="supplements/misc/dimfilter.html">dimfilter</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="SUP_POTENTIAL.html">POTENTIAL</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="supplements/potential/gmtgravmag3d.html">gmtgravmag3d</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/potential/gravfft.html">gravfft</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/potential/grdgravmag3d.html">grdgravmag3d</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/potential/grdredpol.html">grdredpol</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/potential/grdseamount.html">grdseamount</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="SUP_SEGY.html">SEGY</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="supplements/segy/pssegy.html">pssegy</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/segy/pssegyz.html">pssegyz</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/segy/segy2grd.html">segy2grd</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="SUP_SPOTTER.html">SPOTTER</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="supplements/spotter/backtracker.html">backtracker</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/spotter/grdpmodeler.html">grdpmodeler</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/spotter/grdrotater.html">grdrotater</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/spotter/grdspotter.html">grdspotter</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/spotter/hotspotter.html">hotspotter</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/spotter/originator.html">originator</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/spotter/rotconverter.html">rotconverter</a></li>
-</ul>
-</li>
-</ul>
-</div>
-</td>
-<td><div class="toctree-wrapper first last compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="SUP_X2SYS.html">X2SYS</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="supplements/x2sys/x2sys_binlist.html">x2sys_binlist</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/x2sys/x2sys_cross.html">x2sys_cross</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/x2sys/x2sys_datalist.html">x2sys_datalist</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/x2sys/x2sys_get.html">x2sys_get</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/x2sys/x2sys_init.html">x2sys_init</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/x2sys/x2sys_list.html">x2sys_list</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/x2sys/x2sys_merge.html">x2sys_merge</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/x2sys/x2sys_put.html">x2sys_put</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/x2sys/x2sys_report.html">x2sys_report</a></li>
-<li class="toctree-l2"><a class="reference internal" href="supplements/x2sys/x2sys_solve.html">x2sys_solve</a></li>
-</ul>
-</li>
-</ul>
-</div>
-</td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="section" id="gallery">
-<h1>Gallery<a class="headerlink" href="#gallery" title="Permalink to this headline">¶</a></h1>
-<table border="1" class="docutils">
-<colgroup>
-<col width="100%" />
-</colgroup>
-<tbody valign="top">
-<tr class="row-odd"><td><div class="toctree-wrapper first last compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="Gallery.html">The GMT historical collection</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="Gallery.html#the-40-examples">The 40 Examples</a></li>
-<li class="toctree-l2"><a class="reference internal" href="Gallery.html#animations">Animations</a></li>
-</ul>
-</li>
-<li class="toctree-l1"><a class="reference internal" href="Users_contrib_script.html">Users Script Contributions</a></li>
-<li class="toctree-l1"><a class="reference internal" href="Users_contrib_symbols.html">Users Symbol Contributions</a></li>
-</ul>
-</div>
-</td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="the-cookbook">
-<h1>The CookBook<a class="headerlink" href="#the-cookbook" title="Permalink to this headline">¶</a></h1>
-<table border="1" class="docutils">
-<colgroup>
-<col width="100%" />
-</colgroup>
-<tbody valign="top">
-<tr class="row-odd"><td><div class="toctree-wrapper first last compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="cookbook.html">CookBook</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="GMT_Docs.html">1. Acknowledgments</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_Docs.html#a-reminder">2. A Reminder</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_Docs.html#copyright-and-caveat-emptor">3. Copyright and Caveat Emptor!</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_Docs.html#preface">4. Preface</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_Docs.html#new-features-in-gmt-5">5. New Features in GMT 5</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_Docs.html#switching-between-different-gmt-versions">6. Switching between different GMT versions</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_Docs.html#introduction">7. Introduction</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_Docs.html#gmt-overview-and-quick-reference">8. GMT Overview and Quick Reference</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_Docs.html#general-features">9. General Features</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_Docs.html#gmt-coordinate-transformations">10. GMT Coordinate Transformations</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_Docs.html#gmt-map-projections">11. GMT Map Projections</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_Docs.html#creating-gmt-graphics">12. Creating GMT Graphics</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_Docs.html#creating-gmt-animations">13. Creating GMT Animations</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_Docs.html#a-gmt-supplemental-packages">14. A. GMT Supplemental Packages</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_Docs.html#b-gmt-file-formats">15. B. GMT File Formats</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_Docs.html#c-including-gmt-graphics-into-your-documents">16. C. Including GMT Graphics into your Documents</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_Docs.html#e-predefined-bit-and-hachure-patterns-in-gmt">17. E. Predefined Bit and Hachure Patterns in GMT</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_Docs.html#f-chart-of-octal-codes-for-characters">18. F. Chart of Octal Codes for Characters</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_Docs.html#g-postscript-fonts-used-by-gmt">19. G. PostScript Fonts Used by GMT</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_Docs.html#h-color-space-the-final-frontier">20. H. Color Space: The Final Frontier</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_Docs.html#i-filtering-of-data-in-gmt">21. I. Filtering of Data in GMT</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_Docs.html#j-the-gmt-high-resolution-coastline-data">22. J. The GMT High-Resolution Coastline Data</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_Docs.html#k-gmt-on-non-unix-platforms">23. K. GMT on non-UNIX Platforms</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_Docs.html#l-of-colors-and-color-legends">24. L. Of Colors and Color Legends</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_Docs.html#m-custom-plot-symbols">25. M. Custom Plot Symbols</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_Docs.html#n-annotation-of-contours-and-quoted-lines">26. N. Annotation of Contours and “Quoted Lines”</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_Docs.html#o-special-operations">27. O. Special Operations</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_Docs.html#p-the-gmt-vector-data-format-for-ogr-compatibility">28. P. The GMT Vector Data Format for OGR Compatibility</a></li>
-</ul>
-</li>
-</ul>
-</div>
-</td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="api-reference">
-<h1>API Reference<a class="headerlink" href="#api-reference" title="Permalink to this headline">¶</a></h1>
-<table border="1" class="docutils">
-<colgroup>
-<col width="100%" />
-</colgroup>
-<tbody valign="top">
-<tr class="row-odd"><td><div class="toctree-wrapper first last compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="api.html">GMT_API</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="GMT_API.html">1. Introduction</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_API.html#overview-of-the-gmt-c-application-program-interface">2. Overview of the GMT C Application Program Interface</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_API.html#the-gmt-c-application-program-interface">3. The GMT C Application Program Interface</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_API.html#the-gmt-fft-interface">4. The GMT FFT Interface</a></li>
-<li class="toctree-l2"><a class="reference internal" href="GMT_API.html#fortran-interfaces">5. FORTRAN interfaces</a></li>
-</ul>
-</li>
-</ul>
-</div>
-</td>
-</tr>
-</tbody>
-</table>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="#">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">Man pages</a><ul>
-<li><a class="reference internal" href="#supplements">Supplements</a><ul>
-</ul>
-</li>
-</ul>
-</li>
-<li><a class="reference internal" href="#gallery">Gallery</a></li>
-<li><a class="reference internal" href="#the-cookbook">The CookBook</a></li>
-<li><a class="reference internal" href="#api-reference">API Reference</a></li>
-</ul>
-
- <h4>Next topic</h4>
- <p class="topless"><a href="man_pages.html"
- title="next chapter">Man Pages</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/index.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="man_pages.html" title="Man Pages"
- >next</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="#">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/isogmt.html b/doc_release/html/isogmt.html
deleted file mode 100644
index 7dca610..0000000
--- a/doc_release/html/isogmt.html
+++ /dev/null
@@ -1,178 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>isogmt — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="I" href="I.html" />
- <link rel="next" title="K" href="K.html" />
- <link rel="prev" title="I" href="I.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="K.html" title="K"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="I.html" title="I"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="I.html" accesskey="U">I</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="isogmt">
-<span id="index-0"></span><h1>isogmt<a class="headerlink" href="#isogmt" title="Permalink to this headline">¶</a></h1>
-<p>isogmt - Run GMT command or script in isolation mode</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>isogmt</strong> <em>command</em></p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>isogmt</strong> runs a single GMT command or shell script in <strong>isolation
-mode</strong>. This means that the files <em>gmt.history</em> and <em>gmt.conf</em> will be
-read from the usual locations (current directory, <em>~/.gmt</em>, or home
-directory), but changes will only be written in a temporary directory,
-which will be removed after execution. The name of the temporary
-directory will be available to the command or script as the environment
-variable GMT_TMPDIR.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>Run the shell script <em>script.gmt</em> in isolation mode</p>
-<blockquote>
-<div>isogmt sh script.gmt</div></blockquote>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc4">See Also</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">isogmt</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#id1">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="I.html"
- title="previous chapter">I</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="K.html"
- title="next chapter">K</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/isogmt.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="K.html" title="K"
- >next</a> </li>
- <li class="right" >
- <a href="I.html" title="I"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="I.html" >I</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/kml2gmt.html b/doc_release/html/kml2gmt.html
deleted file mode 100644
index 7240ccc..0000000
--- a/doc_release/html/kml2gmt.html
+++ /dev/null
@@ -1,227 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>kml2gmt — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="K" href="K.html" />
- <link rel="next" title="M" href="M.html" />
- <link rel="prev" title="K" href="K.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="M.html" title="M"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="K.html" title="K"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="K.html" accesskey="U">K</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="kml2gmt">
-<span id="index-0"></span><h1>kml2gmt<a class="headerlink" href="#kml2gmt" title="Permalink to this headline">¶</a></h1>
-<p>kml2gmt - Extract GMT table data from Google Earth KML files</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>kml2gmt</strong> [ <em>kmlfiles</em> ] [ <strong>-V</strong>[<em>level</em>] ] [ <strong>-Z</strong> ]
-[ <strong>-bo</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>kml2gmt</strong> reads a Google Earth KML file and outputs a GMT table file.
-Only KML files that contain points, lines, or polygons can be processed.
-This is a bare-bones operation that aims to extract coordinates and
-possibly the name and description tags of each feature. The main use
-intended is to capture coordinates modified in Google Earth and then
-reinsert the modified data into the original GMT data file. For a more
-complete reformatting, consider using <strong>ogr2ogr -f</strong> “GMT” somefile.gmt
-somefile.kml.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<p>None.</p>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>kmlfiles</em></dt>
-<dd>Name of one or more KML files to work on. If not are given, then
-standard input is read.</dd>
-<dt><strong>-Z</strong></dt>
-<dd>Output the altitude coordinates as GMT z coordinates [Default will
-output just longitude and latitude].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To extract the lon,lat values from the KML file google.kml, try</p>
-<blockquote>
-<div>gmt kml2gmt google.kml -V > google.txt</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>,
-<a class="reference internal" href="supplements/img/img2google.html"><em>img2google</em></a>,
-<a class="reference internal" href="ps2raster.html"><em>ps2raster</em></a>, <a class="reference internal" href="gmt2kml.html"><em>gmt2kml</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">kml2gmt</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="K.html"
- title="previous chapter">K</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="M.html"
- title="next chapter">M</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/kml2gmt.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="M.html" title="M"
- >next</a> </li>
- <li class="right" >
- <a href="K.html" title="K"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="K.html" >K</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/makecpt.html b/doc_release/html/makecpt.html
deleted file mode 100644
index e4c0401..0000000
--- a/doc_release/html/makecpt.html
+++ /dev/null
@@ -1,316 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>makecpt — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="M" href="M.html" />
- <link rel="next" title="mapproject" href="mapproject.html" />
- <link rel="prev" title="M" href="M.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="mapproject.html" title="mapproject"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="M.html" title="M"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="M.html" accesskey="U">M</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="makecpt">
-<span id="index-0"></span><h1>makecpt<a class="headerlink" href="#makecpt" title="Permalink to this headline">¶</a></h1>
-<p>makecpt - Make GMT color palette tables</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>makecpt</strong> [ <strong>-A</strong>[<strong>+</strong>]<em>transparency</em> ] [ <strong>-C</strong><em>table</em> ]
-[ <strong>-D</strong>[<strong>i</strong>|<strong>o</strong>] ]
-[ <strong>-F</strong>[<strong>R</strong>|<strong>r</strong>|<strong>h</strong>|<strong>c</strong> ] [ <strong>-G</strong><em>zlo</em>/<em>zhi</em> ] [ <strong>-I</strong> ] [ <strong>-M</strong> ]
-[ <strong>-N</strong> ] [ <strong>-Q</strong>[<strong>i</strong>|<strong>o</strong>] ]
-[ <strong>-T</strong><em>z_min</em>/<em>z_max</em>[/<em>z_inc</em>[+]] | <strong>-T</strong><em>ztable</em> ]
-[ <strong>-V</strong>[<em>level</em>] ] [ <strong>-W</strong> ] [ <strong>-Z</strong> ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>makecpt</strong> is a utility that will help you make color palette tables
-(cpt files). You define an equidistant set of contour intervals or pass
-your own z-table, and create a new cpt file based on an existing master
-cpt file. The resulting cpt file can be reversed relative to the master
-cpt, and can be made continuous or discrete. For color tables beyond the
-standard GMT offerings, visit cpt-city:
-<a class="reference external" href="http://soliton.vm.bytemark.co.uk/pub/cpt-city/">http://soliton.vm.bytemark.co.uk/pub/cpt-city/</a>.</p>
-<p>The color palette includes three additional colors beyond the range of
-z-values. These are the background color (B) assigned to values lower
-than the lowest <em>z</em>-value, the foreground color (F) assigned to values
-higher than the highest <em>z</em>-value, and the NaN color (N) painted
-whereever values are undefined.</p>
-<p>If the master cpt file includes B, F, and N entries, these will be
-copied into the new master file. If not, the parameters
-<a class="reference internal" href="gmt.conf.html#color-background"><em>COLOR_BACKGROUND</em></a>, <a class="reference internal" href="gmt.conf.html#color-foreground"><em>COLOR_FOREGROUND</em></a>,
-and <a class="reference internal" href="gmt.conf.html#color-nan"><em>COLOR_NAN</em></a> from
-the <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file or the command line will be used. This default
-behavior can be overruled using the options <strong>-D</strong>, <strong>-M</strong> or <strong>-N</strong>.</p>
-<p>The color model (RGB, HSV or CMYK) of the palette created by <strong>makecpt</strong>
-will be the same as specified in the header of the master cpt file. When
-there is no <a class="reference internal" href="gmt.conf.html#color-model"><em>COLOR_MODEL</em></a> entry in the master cpt file, the
-<a class="reference internal" href="gmt.conf.html#color-model"><em>COLOR_MODEL</em></a> specified in the <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file or on the command
-line will be used.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<p>None.</p>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong>[<strong>+</strong>]<em>transparency</em></dt>
-<dd>Sets a constant level of transparency (0-100) for all color slices.
-Prepend <strong>+</strong> to also affect the fore-, back-, and nan-colors
-[Default is no transparency, i.e., 0 (opaque)].</dd>
-<dt><strong>-C</strong><em>table</em></dt>
-<dd>Selects the master color table <em>table</em> to use in the interpolation.
-Choose among the built-in tables (type <strong>makecpt</strong> to see the list)
-or give the name of an existing cpt file [Default gives a rainbow
-cpt file].</dd>
-<dt><strong>-D</strong>[<strong>i</strong>|<strong>o</strong>]</dt>
-<dd>Select the back- and foreground colors to match the colors for
-lowest and highest <em>z</em>-values in the output cpt file [Default uses
-the colors specified in the master file, or those defined by the
-parameters <a class="reference internal" href="gmt.conf.html#color-background"><em>COLOR_BACKGROUND</em></a>, <a class="reference internal" href="gmt.conf.html#color-foreground"><em>COLOR_FOREGROUND</em></a>, and
-<a class="reference internal" href="gmt.conf.html#color-nan"><em>COLOR_NAN</em></a>]. Append <strong>i</strong> to match the colors for the lowest and
-highest values in the input (instead of the output) cpt file.</dd>
-<dt><strong>-F</strong>[<strong>R</strong>|<strong>r</strong>|<strong>h</strong>|<strong>c</strong>]</dt>
-<dd>Force output cpt file to written with r/g/b codes, gray-scale values
-or color name (<strong>R</strong>, default) or r/g/b codes only (<strong>r</strong>), or h-s-v
-codes (<strong>h</strong>), or c/m/y/k codes (<strong>c</strong>).</dd>
-<dt><strong>-G</strong><em>zlo</em>/<em>zhi</em></dt>
-<dd>Truncate the incoming CPT so that the lowest and highest z-levels
-are to <em>zlo</em> and <em>zhi</em>. If one of these equal NaN then
-we leave that end of the CPT alone. The truncation takes place
-before any resampling.</dd>
-<dt><strong>-I</strong></dt>
-<dd>Reverses the sense of color progression in the master cpt file. Also
-exchanges the foreground and background colors, including those
-specified by the parameters <a class="reference internal" href="gmt.conf.html#color-background"><em>COLOR_BACKGROUND</em></a> and
-<a class="reference internal" href="gmt.conf.html#color-foreground"><em>COLOR_FOREGROUND</em></a>.</dd>
-<dt><strong>-M</strong></dt>
-<dd>Overrule background, foreground, and NaN colors specified in the
-master cpt file with the values of the parameters
-<a class="reference internal" href="gmt.conf.html#color-background"><em>COLOR_BACKGROUND</em></a>, <a class="reference internal" href="gmt.conf.html#color-foreground"><em>COLOR_FOREGROUND</em></a>,
-and <a class="reference internal" href="gmt.conf.html#color-nan"><em>COLOR_NAN</em></a>
-specified in the <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file or on the command line. When
-combined with <strong>-D</strong>, only <a class="reference internal" href="gmt.conf.html#color-nan"><em>COLOR_NAN</em></a> is considered.</dd>
-<dt><strong>-N</strong></dt>
-<dd>Do not write out the background, foreground, and NaN-color fields
-[Default will write them].</dd>
-<dt><strong>-Q</strong>[<strong>i</strong>|<strong>o</strong>]</dt>
-<dd>Selects a logarithmic interpolation scheme [Default is linear].
-<strong>-Qi</strong> expects input z-values to be log10(z), assigns colors, and
-writes out z [Default]. <strong>-Qo</strong> takes log10(z) first, assigns
-colors, and writes out z.</dd>
-<dt><strong>-T</strong><em>z_min</em>/<em>z_max</em>[/<em>z_inc</em>[+]] | <strong>-T</strong><em>ztable</em></dt>
-<dd>Defines the range of the new cpt file by giving the lowest and
-highest z-value and interval. When used with <strong>-C</strong> and <em>z_inc</em> is
-not specified, the number of intervals remains the same as in the
-input palette. If <em>z_inc</em> is specified with a trailing <strong>+</strong> we
-interpret <em>z_inc</em> as the number of desired intervals instead.
-Alternatively, give the name of a ASCII file that has one z-value
-per record. If <strong>-T</strong> is not given, the existing range in the master
-cpt file will be used intact.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong></dt>
-<dd>Do not interpolate the input color table but pick the output colors
-starting at the beginning of the color table, until colors for all
-intervals are assigned. This is particularly useful in combination
-with a categorical color table, like “categorical”. Cannot be used
-in combination with <strong>-Z</strong>.</dd>
-<dt><strong>-Z</strong></dt>
-<dd>Creates a continuous cpt file [Default is discontinuous, i.e.,
-constant colors for each interval].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To make a cpt file with z-values from -200 to 200, with discrete color
-changes every 25, and using a polar blue-white-red colortable:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt makecpt -Cpolar -T-200/200/25 > colors.cpt
-</pre></div>
-</div>
-</div></blockquote>
-<p>To make an equidistant cpt file from z = -2 to 6, in steps of 1, using
-continuous default rainbow colors:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt makecpt -T-2/6/1 -Z > rainbow.cpt
-</pre></div>
-</div>
-</div></blockquote>
-<p>To make a GEBCO look-alike cpt file for bathymetry, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt makecpt -Cgebco > my_gebco.cpt
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="bugs">
-<h2>Bugs<a class="headerlink" href="#bugs" title="Permalink to this headline">¶</a></h2>
-<p>Since <strong>makecpt</strong> will also interpolate from any existing .cpt file you
-may have in your directory, you cannot use one of the listed cpt names
-as an output filename; hence the my_gebco.cpt in the example.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="grd2cpt.html"><em>grd2cpt</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">makecpt</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#bugs">Bugs</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="M.html"
- title="previous chapter">M</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="mapproject.html"
- title="next chapter">mapproject</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/makecpt.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="mapproject.html" title="mapproject"
- >next</a> </li>
- <li class="right" >
- <a href="M.html" title="M"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="M.html" >M</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/man_pages.html b/doc_release/html/man_pages.html
deleted file mode 100644
index 8cbdf90..0000000
--- a/doc_release/html/man_pages.html
+++ /dev/null
@@ -1,289 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>Man Pages — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="next" title="blockmean" href="blockmean.html" />
- <link rel="prev" title="Man pages" href="index.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="blockmean.html" title="blockmean"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="index.html" title="Man pages"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="man-pages">
-<h1>Man Pages<a class="headerlink" href="#man-pages" title="Permalink to this headline">¶</a></h1>
-<div class="section" id="core-modules">
-<h2>Core modules<a class="headerlink" href="#core-modules" title="Permalink to this headline">¶</a></h2>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="blockmean.html">blockmean</a></li>
-<li class="toctree-l1"><a class="reference internal" href="blockmedian.html">blockmedian</a></li>
-<li class="toctree-l1"><a class="reference internal" href="blockmode.html">blockmode</a></li>
-<li class="toctree-l1"><a class="reference internal" href="filter1d.html">filter1d</a></li>
-<li class="toctree-l1"><a class="reference internal" href="fitcircle.html">fitcircle</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmt_shell_functions.sh.html">gmt_shell_functions.sh</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmt.conf.html">gmt.conf</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmt.html">gmt</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmt2kml.html">gmt2kml</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmt5syntax.html">gmt5syntax</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmtcolors.html">gmtcolors</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmtconnect.html">gmtconnect</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmtconvert.html">gmtconvert</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmtdefaults.html">gmtdefaults</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmtget.html">gmtget</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmtinfo.html">gmtinfo</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmtlogo.html">gmtlogo</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmtmath.html">gmtmath</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmtselect.html">gmtselect</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmtset.html">gmtset</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmtsimplify.html">gmtsimplify</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmtspatial.html">gmtspatial</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmtswitch.html">gmtswitch</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmtvector.html">gmtvector</a></li>
-<li class="toctree-l1"><a class="reference internal" href="gmtwhich.html">gmtwhich</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grd2cpt.html">grd2cpt</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grd2rgb.html">grd2rgb</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grd2xyz.html">grd2xyz</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdblend.html">grdblend</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdclip.html">grdclip</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdcontour.html">grdcontour</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdcut.html">grdcut</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdedit.html">grdedit</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdfft.html">grdfft</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdfilter.html">grdfilter</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdgradient.html">grdgradient</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdhisteq.html">grdhisteq</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdimage.html">grdimage</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdinfo.html">grdinfo</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdlandmask.html">grdlandmask</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdmask.html">grdmask</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdmath.html">grdmath</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdpaste.html">grdpaste</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdproject.html">grdproject</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdraster.html">grdraster</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdreformat.html">grdreformat</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdsample.html">grdsample</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdtrack.html">grdtrack</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdtrend.html">grdtrend</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdvector.html">grdvector</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdview.html">grdview</a></li>
-<li class="toctree-l1"><a class="reference internal" href="grdvolume.html">grdvolume</a></li>
-<li class="toctree-l1"><a class="reference internal" href="greenspline.html">greenspline</a></li>
-<li class="toctree-l1"><a class="reference internal" href="isogmt.html">isogmt</a></li>
-<li class="toctree-l1"><a class="reference internal" href="kml2gmt.html">kml2gmt</a></li>
-<li class="toctree-l1"><a class="reference internal" href="makecpt.html">makecpt</a></li>
-<li class="toctree-l1"><a class="reference internal" href="mapproject.html">mapproject</a></li>
-<li class="toctree-l1"><a class="reference internal" href="nearneighbor.html">nearneighbor</a></li>
-<li class="toctree-l1"><a class="reference internal" href="project.html">project</a></li>
-<li class="toctree-l1"><a class="reference internal" href="ps2raster.html">ps2raster</a></li>
-<li class="toctree-l1"><a class="reference internal" href="psbasemap.html">psbasemap</a></li>
-<li class="toctree-l1"><a class="reference internal" href="psclip.html">psclip</a></li>
-<li class="toctree-l1"><a class="reference internal" href="pscoast.html">pscoast</a></li>
-<li class="toctree-l1"><a class="reference internal" href="pscontour.html">pscontour</a></li>
-<li class="toctree-l1"><a class="reference internal" href="pshistogram.html">pshistogram</a></li>
-<li class="toctree-l1"><a class="reference internal" href="psimage.html">psimage</a></li>
-<li class="toctree-l1"><a class="reference internal" href="pslegend.html">pslegend</a></li>
-<li class="toctree-l1"><a class="reference internal" href="pslib.html">pslib</a></li>
-<li class="toctree-l1"><a class="reference internal" href="psmask.html">psmask</a></li>
-<li class="toctree-l1"><a class="reference internal" href="psrose.html">psrose</a></li>
-<li class="toctree-l1"><a class="reference internal" href="psscale.html">psscale</a></li>
-<li class="toctree-l1"><a class="reference internal" href="pstext.html">pstext</a></li>
-<li class="toctree-l1"><a class="reference internal" href="pswiggle.html">pswiggle</a></li>
-<li class="toctree-l1"><a class="reference internal" href="psxy.html">psxy</a></li>
-<li class="toctree-l1"><a class="reference internal" href="psxyz.html">psxyz</a></li>
-<li class="toctree-l1"><a class="reference internal" href="sample1d.html">sample1d</a></li>
-<li class="toctree-l1"><a class="reference internal" href="spectrum1d.html">spectrum1d</a></li>
-<li class="toctree-l1"><a class="reference internal" href="sph2grd.html">sph2grd</a></li>
-<li class="toctree-l1"><a class="reference internal" href="sphdistance.html">sphdistance</a></li>
-<li class="toctree-l1"><a class="reference internal" href="sphinterpolate.html">sphinterpolate</a></li>
-<li class="toctree-l1"><a class="reference internal" href="sphtriangulate.html">sphtriangulate</a></li>
-<li class="toctree-l1"><a class="reference internal" href="splitxyz.html">splitxyz</a></li>
-<li class="toctree-l1"><a class="reference internal" href="surface.html">surface</a></li>
-<li class="toctree-l1"><a class="reference internal" href="trend1d.html">trend1d</a></li>
-<li class="toctree-l1"><a class="reference internal" href="trend2d.html">trend2d</a></li>
-<li class="toctree-l1"><a class="reference internal" href="triangulate.html">triangulate</a></li>
-<li class="toctree-l1"><a class="reference internal" href="xyz2grd.html">xyz2grd</a></li>
-</ul>
-</div>
-</div>
-<div class="section" id="supplementary-modules">
-<h2>Supplementary modules<a class="headerlink" href="#supplementary-modules" title="Permalink to this headline">¶</a></h2>
-<div class="toctree-wrapper compound">
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="supplements/gshhg/gshhg.html">gshhg</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/img/img2grd.html">img2grd</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/meca/pscoupe.html">pscoupe</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/meca/psmeca.html">psmeca</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/meca/pspolar.html">pspolar</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/meca/psvelo.html">psvelo</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/mgd77/mgd77convert.html">mgd77convert</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/mgd77/mgd77info.html">mgd77info</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/mgd77/mgd77list.html">mgd77list</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/mgd77/mgd77magref.html">mgd77magref</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/mgd77/mgd77manage.html">mgd77manage</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/mgd77/mgd77path.html">mgd77path</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/mgd77/mgd77sniffer.html">mgd77sniffer</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/mgd77/mgd77track.html">mgd77track</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/misc/dimfilter.html">dimfilter</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/potential/gmtgravmag3d.html">gmtgravmag3d</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/potential/gravfft.html">gravfft</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/potential/grdgravmag3d.html">grdgravmag3d</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/potential/grdredpol.html">grdredpol</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/potential/grdseamount.html">grdseamount</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/segy/pssegy.html">pssegy</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/segy/pssegyz.html">pssegyz</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/segy/segy2grd.html">segy2grd</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/spotter/backtracker.html">backtracker</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/spotter/grdpmodeler.html">grdpmodeler</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/spotter/grdrotater.html">grdrotater</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/spotter/grdspotter.html">grdspotter</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/spotter/hotspotter.html">hotspotter</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/spotter/originator.html">originator</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/spotter/rotconverter.html">rotconverter</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/x2sys/x2sys_binlist.html">x2sys_binlist</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/x2sys/x2sys_cross.html">x2sys_cross</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/x2sys/x2sys_datalist.html">x2sys_datalist</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/x2sys/x2sys_get.html">x2sys_get</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/x2sys/x2sys_init.html">x2sys_init</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/x2sys/x2sys_list.html">x2sys_list</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/x2sys/x2sys_merge.html">x2sys_merge</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/x2sys/x2sys_put.html">x2sys_put</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/x2sys/x2sys_report.html">x2sys_report</a></li>
-<li class="toctree-l1"><a class="reference internal" href="supplements/x2sys/x2sys_solve.html">x2sys_solve</a></li>
-</ul>
-</div>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">Man Pages</a><ul>
-<li><a class="reference internal" href="#core-modules">Core modules</a></li>
-<li><a class="reference internal" href="#supplementary-modules">Supplementary modules</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="index.html"
- title="previous chapter">Man pages</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="blockmean.html"
- title="next chapter">blockmean</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/man_pages.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="blockmean.html" title="blockmean"
- >next</a> </li>
- <li class="right" >
- <a href="index.html" title="Man pages"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/mapproject.html b/doc_release/html/mapproject.html
deleted file mode 100644
index 9684b00..0000000
--- a/doc_release/html/mapproject.html
+++ /dev/null
@@ -1,482 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>mapproject — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="M" href="M.html" />
- <link rel="next" title="N" href="N.html" />
- <link rel="prev" title="makecpt" href="makecpt.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="N.html" title="N"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="makecpt.html" title="makecpt"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="M.html" accesskey="U">M</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="mapproject">
-<span id="index-0"></span><h1>mapproject<a class="headerlink" href="#mapproject" title="Permalink to this headline">¶</a></h1>
-<p>mapproject - Do forward and inverse map transformations, datum conversions and geodesy</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>mapproject</strong> [ <em>table</em> ] <strong>-J</strong><em>parameters</em>
-<strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>]
-[ <strong>-Ab</strong>|<strong>B</strong>|<strong>f</strong>|<strong>F</strong>|<strong>o</strong>|<strong>O</strong>[<em>lon0</em>/<em>lat0</em>] ]
-[ <strong>-C</strong>[<em>dx</em>/<em>dy</em>] ] [ <strong>-Dc</strong>|<strong>i</strong>|<strong>p</strong> ]
-[ <strong>-E</strong>[<em>datum</em>] ] [ <strong>-F</strong>[<em>unit</em>] ]
-[ <strong>-G</strong>[<em>x0</em>/<em>y0</em>/][[<strong>+</strong>|<strong>-</strong>]<em>unit</em>][<strong>+</strong>|<strong>-</strong>] ]
-[ <strong>-I</strong> ]
-[ <strong>-L</strong><em>line.xy</em>[/[<strong>+</strong>|<strong>-</strong>]<em>unit</em>][<strong>+</strong>] ]
-[ <strong>-N</strong>[<strong>a</strong>|<strong>c</strong>|<strong>g</strong>|<strong>m</strong>] ]
-[ <strong>-Q</strong>[<strong>d</strong>|<strong>e</strong> ] [ <strong>-S</strong> ]
-[ <strong>-T</strong>[<strong>h</strong>]<em>from</em>[/<em>to</em>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-b</strong>[<strong>i</strong>|<strong>o</strong>][<em>ncol</em>][<strong>type</strong>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-o</strong><em>cols</em>[,...] ]
-[ <strong>-s</strong>[<em>cols</em>][<strong>a</strong>|<strong>r</strong>] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>mapproject</strong> reads (longitude, latitude) positions from <em>infiles</em> [or
-standard input] and computes (x,y) coordinates using the specified map
-projection and scales. Optionally, it can read (x,y) positions and
-compute (longitude, latitude) values doing the inverse transformation.
-This can be used to transform linear (x,y) points obtained by digitizing
-a map of known projection to geographical coordinates. May also
-calculate distances along track, to a fixed point, or closest approach
-to a line. Finally, can be used to perform various datum conversions.
-Additional data fields are permitted after the first 2 columns which
-must have (longitude,latitude) or (x,y). See option <strong>-:</strong> on how to
-read (latitude,longitude) files.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-J</strong><em>parameters</em> <a class="reference internal" href="gmt.html#j-full"><em>(more ...)</em></a></dt>
-<dd>Select map projection.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. Special case for the UTM
-projection: If <strong>-C</strong> is used and <strong>-R</strong> is not given then the
-region is set to coincide with the given UTM zone so as to preserve
-the full ellipsoidal solution (See RESTRICTIONS for more information).</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>[<em>ncols</em>][<em>type</em>]) data
-table file(s) holding a number of data columns. If no tables are given
-then we read from standard input. </dd>
-<dt><strong>-Ab</strong>|<strong>B</strong>|<strong>f</strong>|<strong>F</strong>|<strong>o</strong>|<strong>O</strong>[<em>lon0</em>/<em>lat0</em>]</dt>
-<dd><strong>-Af</strong> calculates the (forward) azimuth from fixed point <em>lon/lat</em>
-to each data point. Use <strong>-Ab</strong> to get back-azimuth from data points
-to fixed point. Use <strong>-Ao</strong> to get orientations (-90/90) rather than
-azimuths (0/360). Upper case <strong>F</strong>, <strong>B</strong> or <strong>O</strong> will convert from
-geodetic to geocentric latitudes and estimate azimuth of geodesics
-(assuming the current ellipsoid is not a sphere). If no fixed point
-is given then we compute the azimuth (or back-azimuth) from the
-previous point.</dd>
-<dt><strong>-C</strong>[<em>dx</em>/<em>dy</em>]</dt>
-<dd>Set center of projected coordinates to be at map projection center
-[Default is lower left corner]. Optionally, add offsets in the
-projected units to be added (or subtracted when <strong>-I</strong> is set) to
-(from) the projected coordinates, such as false eastings and
-northings for particular projection zones [0/0]. The unit used for
-the offsets is the plot distance unit in effect (see
-<a class="reference internal" href="gmt.conf.html#proj-length-unit"><em>PROJ_LENGTH_UNIT</em></a>) unless <strong>-F</strong> is used, in which case the
-offsets are in meters.</dd>
-<dt><strong>-Dc</strong>|<strong>i</strong>|<strong>p</strong></dt>
-<dd>Temporarily override <a class="reference internal" href="gmt.conf.html#proj-length-unit"><em>PROJ_LENGTH_UNIT</em></a> and use <strong>c</strong> (cm),
-<strong>i</strong> (inch), or <strong>p</strong> (points) instead. Cannot be used with <strong>-F</strong>.</dd>
-<dt><strong>-E</strong>[<em>datum</em>]</dt>
-<dd>Convert from geodetic (lon, lat, height) to Earth Centered Earth
-Fixed (ECEF) (x,y,z) coordinates (add <strong>-I</strong> for the inverse
-conversion). Append datum ID (see <strong>-Qd</strong>) or give
-<em>ellipsoid</em>:<em>dx</em>,<em>dy</em>,<em>dz</em> where <em>ellipsoid</em> may be an ellipsoid
-ID (see <strong>-Qe</strong>) or given as <em>a</em>[,*inv_f*], where <em>a</em> is the
-semi-major axis and <em>inv_f</em> is the inverse flattening (0 if
-omitted). If <em>datum</em> is - or not given we assume WGS-84.</dd>
-<dt><strong>-F</strong>[<em>unit</em>]</dt>
-<dd>Force 1:1 scaling, i.e., output (or input, see <strong>-I</strong>) data are in
-actual projected meters. To specify other units, append the desired
-unit (see UNITS). Without <strong>-F</strong>, the output (or input, see <strong>-I</strong>)
-are in the units specified by <a class="reference internal" href="gmt.conf.html#proj-length-unit"><em>PROJ_LENGTH_UNIT</em></a> (but see
-<strong>-D</strong>).</dd>
-<dt><strong>-G</strong>[<em>x0</em>/<em>y0</em>/][[<strong>+</strong>|<strong>-</strong>]<em>unit</em>][<strong>+</strong>|<strong>-</strong>]</dt>
-<dd>Calculate distances along track <em>or</em> to the optional point set with
-<strong>-G</strong><em>x0/y0</em>. Append the distance unit (see UNITS), including
-<strong>c</strong> (Cartesian distance using input coordinates) or <strong>C</strong>
-(Cartesian distance using projected coordinates). The <strong>C</strong> unit
-requires <strong>-R</strong> and <strong>-J</strong> to be set. With no fixed point is given
-we calculate cumulate distances along track. Append <strong>-</strong> to obtain
-incremental distance between successive points. Append <strong>+</strong> to
-specify the 2nd point via two extra columns in the input file.</dd>
-<dt><strong>-I</strong></dt>
-<dd>Do the Inverse transformation, i.e., get (longitude,latitude) from (x,y) data.</dd>
-<dt><strong>-L</strong><em>line.xy</em>[/[<strong>+</strong>|<strong>-</strong>]<em>unit</em>][<strong>+</strong>]</dt>
-<dd>Determine the shortest distance from the input data points to the
-line(s) given in the ASCII multisegment file <em>line.xy</em>. The distance
-and the coordinates of the nearest point will be appended to the
-output as three new columns. Append the distance unit (see UNITS),
-including <strong>c</strong> (Cartesian distance using input coordinates) or
-<strong>C</strong> (Cartesian distance using projected coordinates). The <strong>C</strong>
-unit requires <strong>-R</strong> and <strong>-J</strong> to be set. Finally, append <strong>+</strong> to
-report the line segment id and the fractional point number instead
-of lon/lat of the nearest point.</dd>
-<dt><strong>-N</strong>[<strong>a</strong>|<strong>c</strong>|<strong>g</strong>|<strong>m</strong>]</dt>
-<dd>Convert from geodetic latitudes (using the current ellipsoid; see
-<a class="reference internal" href="gmt.conf.html#proj-ellipsoid"><em>PROJ_ELLIPSOID</em></a>) to one of four different auxiliary latitudes
-(longitudes are unaffected). Choose from <strong>a</strong>uthalic,
-<strong>c</strong>onformal, <strong>g</strong>eocentric, and <strong>m</strong>eridional latitudes
-[geocentric]. Use <strong>-I</strong> to convert from auxiliary latitudes to
-geodetic latitudes.</dd>
-<dt><strong>-Q</strong>[<strong>d</strong>|<strong>e</strong></dt>
-<dd>List all projection parameters. To only list datums, use <strong>-Qd</strong>. To
-only list ellipsoids, use <strong>-Qe</strong>.</dd>
-<dt><strong>-S</strong></dt>
-<dd>Suppress points that fall outside the region.</dd>
-<dt><strong>-T</strong>[<strong>h</strong>]<em>from</em>[/<em>to</em>]</dt>
-<dd>Coordinate conversions between datums <em>from</em> and <em>to</em> using the
-standard Molodensky transformation. Use <strong>-Th</strong> if 3rd input column
-has height above ellipsoid [Default assumes height = 0, i.e., on the
-ellipsoid]. Specify datums using the datum ID (see <strong>-Qd</strong>) or give
-<em>ellipsoid</em>:<em>dx</em>,<em>dy</em>,<em>dz</em> where <em>ellipsoid</em> may be an ellipsoid
-ID (see <strong>-Qe</strong>) or given as <em>a</em>[,*inv_f*], where <em>a</em> is the
-semi-major axis and <em>inv_f</em> is the inverse flattening (0 if
-omitted). If <em>datum</em> is - or not given we assume WGS-84. <strong>-T</strong> may
-be used in conjunction with <strong>-R</strong> <strong>-J</strong> to change the datum before
-coordinate projection (add <strong>-I</strong> to apply the datum conversion
-after the inverse projection). Make sure that the
-<a class="reference internal" href="gmt.conf.html#proj-ellipsoid"><em>PROJ_ELLIPSOID</em></a> setting is correct for your case.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 2 input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. [Default is same as input].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] <a class="reference internal" href="gmt.html#g-full"><em>(more ...)</em></a></dt>
-<dd>Determine data gaps and line breaks. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-o</strong><em>cols</em>[,...] <a class="reference internal" href="gmt.html#ocols-full"><em>(more ...)</em></a></dt>
-<dd>Select output columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-s</strong>[<em>cols</em>][<strong>a</strong>|<strong>r</strong>] <a class="reference internal" href="gmt.html#s-full"><em>(more ...)</em></a></dt>
-<dd>Set handling of NaN records.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc9">Units</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>For map distance unit, append <em>unit</em> <strong>d</strong> for arc degree, <strong>m</strong> for arc
-minute, and <strong>s</strong> for arc second, or <strong>e</strong> for meter [Default], <strong>f</strong>
-for foot, <strong>k</strong> for km, <strong>M</strong> for statute mile, <strong>n</strong> for nautical mile,
-and <strong>u</strong> for US survey foot. By default we compute such distances using
-a spherical approximation with great circles. Prepend <strong>-</strong> to a
-distance (or the unit is no distance is given) to perform “Flat Earth”
-calculations (quicker but less accurate) or prepend <strong>+</strong> to perform
-exact geodesic calculations (slower but more accurate).</p>
-</div>
-<div class="section" id="ascii-format-precision">
-<h2>Ascii Format Precision<a class="headerlink" href="#ascii-format-precision" title="Permalink to this headline">¶</a></h2>
-<p>The ASCII output formats of numerical data are controlled by parameters
-in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file. Longitude and latitude are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>, whereas other values are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>. Be aware that the format in effect
-can lead to loss of precision in the output, which can lead to various
-problems downstream. If you find the output is not written with enough
-precision, consider switching to binary output (<strong>-bo</strong> if available) or
-specify more decimals using the <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> setting.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To transform a file with (longitude,latitude) into (x,y) positions in cm
-on a Mercator grid for a given scale of 0.5 cm per degree, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mapproject lonlatfile -R20/50/12/25 -Jm0.5c > xyfile
-</pre></div>
-</div>
-</div></blockquote>
-<p>To transform several 2-column, binary, double precision files with
-(latitude,longitude) into (x,y) positions in inch on a Transverse
-Mercator grid (central longitude 75W) for scale = 1:500000 and suppress
-those points that would fall outside the map area, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mapproject tracks.* -R-80/-70/20/40 -Jt-75/1:500000 -: -S -Di -bo -bi2 > tmfile.b
-</pre></div>
-</div>
-</div></blockquote>
-<p>To convert the geodetic coordinates (lon, lat, height) in the file
-old.dat from the NAD27 CONUS datum (Datum ID 131 which uses the
-Clarke-1866 ellipsoid) to WGS 84, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mapproject old.dat -Th131 > new.dat
-</pre></div>
-</div>
-</div></blockquote>
-<p>To compute the closest distance (in km) between each point in the input
-file quakes.dat and the line segments given in the multisegment ASCII
-file coastline.xy, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mapproject quakes.dat -Lcoastline.xy/k > quake_dist.dat
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="restrictions">
-<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
-<p>The rectangular input region set with <strong>-R</strong> will in general be mapped
-into a non-rectangular grid. Unless <strong>-C</strong> is set, the leftmost point on
-this grid has xvalue = 0.0, and the lowermost point will have yvalue =
-0.0. Thus, before you digitize a map, run the extreme map coordinates
-through <strong>mapproject</strong> using the appropriate scale and see what (x,y)
-values they are mapped onto. Use these values when setting up for
-digitizing in order to have the inverse transformation work correctly,
-or alternatively, use <strong>awk</strong> to scale and shift the (x,y) values before
-transforming.</p>
-<p>For some projection, a spherical solution may be used despite the user
-having selected an ellipsoid. This occurs when the users <strong>-R</strong> setting
-implies a region that exceeds the domain in which the ellipsoidal series
-expansions are valid. These are the conditions: (1) Lambert Conformal
-Conic (<strong>-JL</strong>)and Albers Equal-Area (<strong>-JB</strong>) will use the spherical
-solution when the map scale exceeds 1.0E7. (2) Transverse Mercator
-(<strong>-JT</strong>) and UTM (<strong>-JU</strong>) will will use the spherical solution when
-either the west or east boundary given in <strong>-R</strong> is more than 10 degrees
-from the central meridian, and (3) same for Cassini
-(<strong>-JC</strong>) but with a limit of only 4 degrees.</p>
-</div>
-<div class="section" id="ellipsoids-and-spheroids">
-<h2>Ellipsoids And Spheroids<a class="headerlink" href="#ellipsoids-and-spheroids" title="Permalink to this headline">¶</a></h2>
-<p>GMT will use ellipsoidal formulae if they are implemented and the
-user have selected an ellipsoid as the reference shape (see
-<a class="reference internal" href="gmt.conf.html#proj-ellipsoid"><em>PROJ_ELLIPSOID</em></a>). The user needs to be aware of a
-few potential pitfalls: (1) For some projections, such as Transverse
-Mercator, Albers, and Lambert’s conformal conic we use the ellipsoidal
-expressions when the areas mapped are small, and switch to the spherical
-expressions (and substituting the appropriate auxiliary latitudes) for
-larger maps. The ellipsoidal formulae are used as follows: (a)
-Transverse Mercator: When all points are within 10 degrees of central
-meridian, (b) Conic projections when longitudinal range is less than 90
-degrees, (c) Cassini projection when all points are within 4 degrees of
-central meridian. (2) When you are trying to match some historical data
-(e.g., coordinates obtained with a certain projection and a certain
-reference ellipsoid) you may find that GMT gives results that are
-slightly different. One likely source of this mismatch is that older
-calculations often used less significant digits. For instance, Snyder’s
-examples often use the Clarke 1866 ellipsoid (defined by him as having a
-flattening f = 1/294.98). From f we get the eccentricity squared to be
-0.00676862818 (this is what GMT uses), while Snyder rounds off and
-uses 0.00676866. This difference can give discrepancies of several tens
-of cm. If you need to reproduce coordinates projected with this slightly
-different eccentricity, you should specify your own ellipsoid with the
-same parameters as Clarke 1866, but with f = 1/294.97861076. Also, be
-aware that older data may be referenced to different datums, and unless
-you know which datum was used and convert all data to a common datum you
-may experience mismatches of tens to hundreds of meters. (3) Finally, be
-aware that <a class="reference internal" href="gmt.conf.html#proj-scale-factor"><em>PROJ_SCALE_FACTOR</em></a> have certain default values for some
-projections so you may have to override the setting in order to match
-results produced with other settings.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>,
-<a class="reference internal" href="gmtvector.html"><em>gmtvector</em></a>,
-<a class="reference internal" href="project.html"><em>project</em></a></p>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>Bomford, G., 1952, Geodesy, Oxford U. Press.</p>
-<p>Snyder, J. P., 1987, Map Projections - A Working Manual, U.S. Geological
-Survey Prof. Paper 1395.</p>
-<p>Vanicek, P. and Krakiwsky, E, 1982, Geodesy - The Concepts,
-North-Holland Publ., ISBN: 0 444 86149 1.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">mapproject</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#id1">Units</a></li>
-<li><a class="reference internal" href="#ascii-format-precision">Ascii Format Precision</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#restrictions">Restrictions</a></li>
-<li><a class="reference internal" href="#ellipsoids-and-spheroids">Ellipsoids And Spheroids</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="makecpt.html"
- title="previous chapter">makecpt</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="N.html"
- title="next chapter">N</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/mapproject.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="N.html" title="N"
- >next</a> </li>
- <li class="right" >
- <a href="makecpt.html" title="makecpt"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="M.html" >M</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/nearneighbor.html b/doc_release/html/nearneighbor.html
deleted file mode 100644
index dd9e6a3..0000000
--- a/doc_release/html/nearneighbor.html
+++ /dev/null
@@ -1,352 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>nearneighbor — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="N" href="N.html" />
- <link rel="next" title="P" href="P.html" />
- <link rel="prev" title="N" href="N.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="P.html" title="P"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="N.html" title="N"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="N.html" accesskey="U">N</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="nearneighbor">
-<span id="index-0"></span><h1>nearneighbor<a class="headerlink" href="#nearneighbor" title="Permalink to this headline">¶</a></h1>
-<p>nearneighbor - Grid table data using a “Nearest neighbor” algorithm</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>nearneighbor</strong> [ <em>table</em> ] <strong>-G</strong><em>out_grdfile</em>
-<strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]
-<strong>-N</strong><em>sectors</em>[/<em>min_sectors</em>]
-<strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>]
-[ <strong>-S</strong><em>search_radius</em>[<em>unit</em>] [ <strong>-E</strong><em>empty</em> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W</strong> ]
-[ <strong>-bi</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-n</strong>[<strong>b</strong>|<strong>c</strong>|<strong>l</strong>|<strong>n</strong>][<strong>+a</strong>][<strong>+b</strong><em>BC</em>][<strong>+t</strong><em>threshold</em>] ]
-[ <strong>-r</strong> ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>nearneighbor</strong> reads arbitrarily located (x,y,z[,w]) triples
-[quadruplets] from standard input [or <em>table</em>] and uses a nearest
-neighbor algorithm to assign an average value to each node that have one
-or more points within a radius centered on the node. The average value
-is computed as a weighted mean of the nearest point from each sector
-inside the search radius. The weighting function used is w(r) = 1 / (1 +
-d ^ 2), where d = 3 * r / search_radius and r is distance from the
-node. This weight is modulated by the weights of the observation points [if
-supplied].</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-G</strong><em>out_grdfile</em></dt>
-<dd>Give the name of the output grid file.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]</dt>
-<dd><em>x_inc</em> [and optionally <em>y_inc</em>] is the grid spacing. Optionally,
-append a suffix modifier. <strong>Geographical (degrees) coordinates</strong>: Append
-<strong>m</strong> to indicate arc minutes or <strong>s</strong> to indicate arc seconds. If one
-of the units <strong>e</strong>, <strong>f</strong>, <strong>k</strong>, <strong>M</strong>, <strong>n</strong> or <strong>u</strong> is appended
-instead, the increment is assumed to be given in meter, foot, km, Mile,
-nautical mile or US survey foot, respectively, and will be converted to
-the equivalent degrees longitude at the middle latitude of the region
-(the conversion depends on <a class="reference internal" href="gmt.conf.html#projection-parameters"><em>PROJ_ELLIPSOID</em></a>). If /<em>y_inc</em> is given
-but set to 0 it will be reset equal to <em>x_inc</em>; otherwise it will be
-converted to degrees latitude. <strong>All coordinates</strong>: If <strong>=</strong> is appended
-then the corresponding max <em>x</em> (<em>east</em>) or <em>y</em> (<em>north</em>) may be slightly
-adjusted to fit exactly the given increment [by default the increment
-may be adjusted slightly to fit the given domain]. Finally, instead of
-giving an increment you may specify the <em>number of nodes</em> desired by
-appending <strong>+</strong> to the supplied integer argument; the increment is then
-recalculated from the number of nodes and the domain. The resulting
-increment value depends on whether you have selected a
-gridline-registered or pixel-registered grid; see <a class="reference internal" href="GMT_Docs.html#app-file-formats"><em>B. GMT File Formats</em></a> for
-details. Note: if <strong>-R</strong><em>grdfile</em> is used then the grid spacing has
-already been initialized; use <strong>-I</strong> to override the values.</dd>
-<dt><strong>-N</strong><em>sectors</em>[/<em>min_sectors</em>]</dt>
-<dd>The circular area centered on each node is divided into <em>sectors</em>
-sectors. Average values will only be computed if there is at least
-one value inside each of at least <em>min_sectors</em> of the sectors for a given
-node. Nodes that fail this test are assigned the value NaN (but see
-<strong>-E</strong>). If <em>Imin_sectors</em> is omitted it is set to be at least 50%
-of <em>sectors</em> (i.e., rounded up to next integer). [Default is a quadrant
-search with 100% coverage, i.e., <em>sectors</em> = <em>min_sectors</em> = 4]. Note
-that only the nearest value per sector enters into the averaging; the
-more distant points are ignored.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-<dt><strong>-S</strong><em>search_radius</em>[<em>unit</em>]</dt>
-<dd>Sets the <em>search_radius</em> that determines which data points are
-considered close to a node. Append the distance unit (see UNITS).</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>3 [or 4, see <strong>-W</strong>] column ASCII file(s) [or binary, see
-<strong>-bi</strong>] holding (x,y,z[,w]) data values. If
-no file is specified, <strong>nearneighbor</strong> will read from standard
-input.</dd>
-<dt><strong>-E</strong><em>empty</em></dt>
-<dd>Set the value assigned to empty nodes [NaN].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong></dt>
-<dd>Input data have a 4th column containing observation point weights.
-These are multiplied with the geometrical weight factor to determine
-the actual weights used in the calculations.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 3 (or 4 if <strong>-W</strong> is set) columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-<dt><strong>-n</strong>[<strong>b</strong>|<strong>c</strong>|<strong>l</strong>|<strong>n</strong>][<strong>+a</strong>][<strong>+b</strong><em>BC</em>][<strong>+t</strong><em>threshold</em>]</dt>
-<dd>Append <strong>+b</strong><em>BC</em> to set any boundary conditions to be used,
-adding <strong>g</strong> for geographic, <strong>p</strong> for periodic, or <strong>n</strong> for
-natural boundary conditions. For the latter two you may append <strong>x</strong>
-or <strong>y</strong> to specify just one direction, otherwise both are assumed.
-[Default is geographic if grid is geographic].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-r</strong> <a class="reference internal" href="gmt.html#nodereg-full"><em>(more ...)</em></a></dt>
-<dd>Set pixel node registration [gridline]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc9">Units</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>For map distance unit, append <em>unit</em> <strong>d</strong> for arc degree, <strong>m</strong> for arc
-minute, and <strong>s</strong> for arc second, or <strong>e</strong> for meter [Default], <strong>f</strong>
-for foot, <strong>k</strong> for km, <strong>M</strong> for statute mile, <strong>n</strong> for nautical mile,
-and <strong>u</strong> for US survey foot. By default we compute such distances using
-a spherical approximation with great circles. Prepend <strong>-</strong> to a
-distance (or the unit is no distance is given) to perform “Flat Earth”
-calculations (quicker but less accurate) or prepend <strong>+</strong> to perform
-exact geodesic calculations (slower but more accurate).</p>
-</div>
-<div class="section" id="grid-values-precision">
-<h2>Grid Values Precision<a class="headerlink" href="#grid-values-precision" title="Permalink to this headline">¶</a></h2>
-<p>Regardless of the precision of the input data, GMT programs that create
-grid files will internally hold the grids in 4-byte floating point
-arrays. This is done to conserve memory and furthermore most if not all
-real data can be stored using 4-byte floating point values. Data with
-higher precision (i.e., double precision values) will lose that
-precision once GMT operates on the grid or writes out new grids. To
-limit loss of precision when processing data you should always consider
-normalizing the data prior to processing.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To create a gridded data set from the file seaMARCII_bathy.lon_lat_z
-using a 0.5 min grid, a 5 km search radius, using an octant search with
-100% sector coverage, and set empty nodes to -9999:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt nearneighbor seaMARCII_bathy.lon_lat_z -R242/244/-22/-20 -I0.5m \
- -E-9999 -Gbathymetry.nc -S5k -N8/8
-</pre></div>
-</div>
-</div></blockquote>
-<p>To make a global grid file from the data in geoid.xyz using a 1 degree
-grid, a 200 km search radius, spherical distances, using an quadrant
-search, and set nodes to NaN only when fewer than two quadrants contain
-at least one value:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt nearneighbor geoid.xyz -R0/360/-90/90 -I1 -Lg -Ggeoid.nc -S200k -N4
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="blockmean.html"><em>blockmean</em></a>,
-<a class="reference internal" href="blockmedian.html"><em>blockmedian</em></a>,
-<a class="reference internal" href="blockmode.html"><em>blockmode</em></a>, <a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="greenspline.html"><em>greenspline</em></a>,
-<a class="reference internal" href="sphtriangulate.html"><em>sphtriangulate</em></a>,
-<a class="reference internal" href="surface.html"><em>surface</em></a>,
-<a class="reference internal" href="triangulate.html"><em>triangulate</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">nearneighbor</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#id1">Units</a></li>
-<li><a class="reference internal" href="#grid-values-precision">Grid Values Precision</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="N.html"
- title="previous chapter">N</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="P.html"
- title="next chapter">P</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/nearneighbor.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="P.html" title="P"
- >next</a> </li>
- <li class="right" >
- <a href="N.html" title="N"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="N.html" >N</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/objects.inv b/doc_release/html/objects.inv
deleted file mode 100644
index dacf98c..0000000
Binary files a/doc_release/html/objects.inv and /dev/null differ
diff --git a/doc_release/html/project.html b/doc_release/html/project.html
deleted file mode 100644
index f84fdd4..0000000
--- a/doc_release/html/project.html
+++ /dev/null
@@ -1,432 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>project — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="P" href="P.html" />
- <link rel="next" title="PS" href="PS.html" />
- <link rel="prev" title="P" href="P.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="PS.html" title="PS"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="P.html" title="P"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="P.html" accesskey="U">P</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="project">
-<span id="index-0"></span><h1>project<a class="headerlink" href="#project" title="Permalink to this headline">¶</a></h1>
-<p>project - Project table data onto lines or great circles, generate tracks, or translate coordinates</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>project</strong> [ <em>table</em> ] <strong>-C</strong><em>cx</em>/<em>cy</em> [ <strong>-A</strong><em>azimuth</em> ] [
-<strong>-E</strong><em>bx</em>/<em>by</em> ] [ <strong>-F</strong><em>flags</em> ]
-[ <strong>-G</strong><em>dist</em>[/<em>colat</em>][<strong>+</strong>] ]
-[ <strong>-L</strong>[<strong>w</strong>][<em>l_min</em>/<em>l_max</em>] ] [ <strong>-N</strong> ] [ <strong>-Q</strong> ] [ <strong>-S</strong> ]
-[ <strong>-T</strong><em>px</em>/<em>py</em> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W</strong><em>w_min</em>/<em>w_max</em> ]
-[ <strong>-b</strong>[<strong>i</strong>|<strong>o</strong>][<em>ncol</em>][<strong>type</strong>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-s</strong>[<em>cols</em>][<strong>a</strong>|<strong>r</strong>] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>project</strong> reads arbitrary (<em>x</em>, <em>y</em>[,<em>z</em>]) data from standard input
-[or <em>infile</em> ] and writes to standard output any combination of (<em>x</em>,
-<em>y</em>, <em>z</em>, <em>p</em>, <em>q</em>, <em>r</em>, <em>s</em>), where (<em>p</em>, <em>q</em>) are the coordinates in
-the projection, (<em>r</em>, <em>s</em>) is the position in the (<em>x</em>, <em>y</em>) coordinate
-system of the point on the profile (<em>q</em> = 0 path) closest to (<em>x</em>, <em>y</em>),
-and <em>z</em> is all remaining columns in the input (beyond the required <em>x</em>
-and <em>y</em> columns).</p>
-<p>Alternatively, <strong>project</strong> may be used to generate (<em>r</em>, <em>s</em>, <em>p</em>)
-triples at equal increments <em>dist</em> along a profile. In this case (
-<strong>-G</strong> option), no input is read.</p>
-<p>Projections are defined in any (but only) one of three ways:</p>
-<p>(Definition 1) By a Center <strong>-C</strong> and an Azimuth <strong>-A</strong> in degrees
-clockwise from North.</p>
-<p>(Definition 2) By a Center <strong>-C</strong> and end point E of the projection path <strong>-E</strong>.</p>
-<p>(Definition 3) By a Center <strong>-C</strong> and a roTation pole position <strong>-T</strong>.</p>
-<p>To spherically project data along a great circle path, an oblique
-coordinate system is created which has its equator along that path, and
-the zero meridian through the Center. Then the oblique longitude
-(<em>p</em>) corresponds to the distance from the Center
-along the great circle, and the oblique latitude (<em>q</em>) corresponds to
-the distance perpendicular to the great circle path. When moving in the
-increasing (<em>p</em>) direction, (toward <em>B</em> or in the
-<em>azimuth</em> direction), the positive (<em>q</em>) direction is to your left. If a
-Pole has been specified, then the positive (<em>q</em>) direction is toward the
-pole.</p>
-<p>To specify an oblique projection, use the <strong>-T</strong> option to set the Pole.
-Then the equator of the projection is already determined and the <strong>-C</strong>
-option is used to locate the <em>p</em> = 0 meridian. The Center <em>cx/cy</em> will
-be taken as a point through which the <em>p</em> = 0 meridian passes. If you do
-not care to choose a particular point, use the South pole (<em>ox</em> = 0,
-<em>oy</em> = -90).</p>
-<p>Data can be selectively windowed by using the <strong>-L</strong> and <strong>-W</strong> options.
-If <strong>-W</strong> is used, the projection Width is set to use only points with
-<em>w_min</em> < q < <em>w_max</em>. If <strong>-L</strong> is set, then the Length is set to use
-only those points with <em>l_min</em> < p < <em>l_max</em>. If the <strong>-E</strong> option has
-been used to define the projection, then <strong>-Lw</strong> may be selected to
-window the length of the projection to exactly the span from <strong>O</strong> to
-<strong>B</strong>.</p>
-<p>Flat Earth (Cartesian) coordinate transformations can also be made. Set
-<strong>-N</strong> and remember that <em>azimuth</em> is clockwise from North (the <em>y</em>
-axis), NOT the usual cartesian theta, which is counterclockwise from the
-<em>x</em> axis. <em>azimuth</em> = 90 - theta.</p>
-<p>No assumptions are made regarding the units for <em>x</em>, <em>y</em>, <em>r</em>, <em>s</em>, <em>p</em>,
-<em>q</em>, <em>dist</em>, <em>l_min</em>, <em>l_max</em>, <em>w_min</em>, <em>w_max</em>. If <strong>-Q</strong> is
-selected, map units are assumed and <em>x</em>, <em>y</em>, <em>r</em>, <em>s</em> must be in
-degrees and <em>p</em>, <em>q</em>, <em>dist</em>, <em>l_min</em>, <em>l_max</em>, <em>w_min</em>, <em>w_max</em>
-will be in km.</p>
-<p>Calculations of specific great-circle and geodesic distances or for
-back-azimuths or azimuths are better done using <strong>mapproject</strong>.</p>
-<p><strong>project</strong> is CASE SENSITIVE. Use UPPER CASE for all one-letter
-designators which begin optional arguments. Use lower case for the
-xyzpqrs letters in <strong>-flags</strong>.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-C</strong><em>cx</em>/<em>cy</em></dt>
-<dd><em>cx/cy</em> sets the origin of the projection, in Definition 1 or 2. If
-Definition 3 is used (<strong>-T</strong>), then <em>cx/cy</em> are the coordinates of a
-point through which the oblique zero meridian (<em>p</em> = 0) should pass.
-The <em>cx/cy</em> is not required to be 90 degrees from the pole.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>[<em>ncols</em>][<em>type</em>]) data
-table file(s) holding a number of data columns. If no tables are given
-then we read from standard input. </dd>
-<dt><strong>-A</strong><em>azimuth</em></dt>
-<dd><em>azimuth</em> defines the azimuth of the projection (Definition 1).</dd>
-<dt><strong>-E</strong><em>bx</em>/<em>by</em></dt>
-<dd><em>bx/by</em> defines the end point of the projection path (Definition 2).</dd>
-<dt><strong>-F</strong><em>flags</em></dt>
-<dd>Specify your desired output using any combination of <em>xyzpqrs</em>, in
-any order. Do not space between the letters. Use lower case. The
-output will be ASCII (or binary, see <strong>-bo</strong>)
-columns of values corresponding to <em>xyzpqrs</em> [Default]. If both
-input and output are using ASCII format then the <em>z</em> data are
-treated as textstring(s). If the <strong>-G</strong> option is selected, the
-output will be <em>rsp</em>.</dd>
-<dt><strong>-G</strong><em>dist</em>[/<em>colat</em>]</dt>
-<dd>Generate mode. No input is read. Create (<em>r</em>, <em>s</em>, <em>p</em>) output
-points every <em>dist</em> units of <em>p</em>. See <strong>-Q</strong> option. Alternatively,
-append <strong>/</strong><em>colat</em> for a small circle instead [Default is a
-colatitude of 90, i.e., a great circle]. Use <strong>-C</strong> and <strong>-E</strong> to
-generate a circle that goes through the center and end point. Note,
-in this case the center and end point cannot be farther apart than
-2*|<em>colat</em>|. Finally, if you append <strong>+</strong> the we will report
-the position of the pole as part of the segment header [no header].</dd>
-<dt><strong>-L</strong>[<strong>w</strong>][<em>l_min</em>/<em>l_max</em>]</dt>
-<dd>Length controls. Project only those points whose <em>p</em> coordinate is
-within <em>l_min</em> < <em>p</em> < <em>l_max</em>. If <strong>-E</strong> has been set, then you
-may use <strong>-Lw</strong> to stay within the distance from <strong>C</strong> to <strong>E</strong>.</dd>
-<dt><strong>-N</strong></dt>
-<dd>Flat Earth. Make a Cartesian coordinate transformation in the plane.
-[Default uses spherical trigonometry.]</dd>
-<dt><strong>-Q</strong></dt>
-<dd>Map type units, i.e., project assumes <em>x</em>, <em>y</em>, <em>r</em>, <em>s</em> are in
-degrees while <em>p</em>, <em>q</em>, <em>dist</em>, <em>l_min</em>, <em>l_max</em>, <em>w_min</em>,
-<em>w_max</em> are in km. If <strong>-Q</strong> is not set, then all these are assumed
-to be in the same units.</dd>
-<dt><strong>-S</strong></dt>
-<dd>Sort the output into increasing <em>p</em> order. Useful when projecting
-random data into a sequential profile.</dd>
-<dt><strong>-T</strong><em>px</em>/<em>py</em></dt>
-<dd><em>px/py</em> sets the position of the rotation pole of the projection.
-(Definition 3).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong><em>w_min</em>/<em>w_max</em></dt>
-<dd>Width controls. Project only those points whose <em>q</em> coordinate is
-within <em>w_min</em> < <em>q</em> < <em>w_max</em>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 2 input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. [Default is given by <strong>-F</strong> or <strong>-G</strong>].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] <a class="reference internal" href="gmt.html#g-full"><em>(more ...)</em></a></dt>
-<dd>Determine data gaps and line breaks. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-s</strong>[<em>cols</em>][<strong>a</strong>|<strong>r</strong>] <a class="reference internal" href="gmt.html#s-full"><em>(more ...)</em></a></dt>
-<dd>Set handling of NaN records.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="ascii-format-precision">
-<h2>Ascii Format Precision<a class="headerlink" href="#ascii-format-precision" title="Permalink to this headline">¶</a></h2>
-<p>The ASCII output formats of numerical data are controlled by parameters
-in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file. Longitude and latitude are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>, whereas other values are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>. Be aware that the format in effect
-can lead to loss of precision in the output, which can lead to various
-problems downstream. If you find the output is not written with enough
-precision, consider switching to binary output (<strong>-bo</strong> if available) or
-specify more decimals using the <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> setting.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To generate points every 10km along a great circle from 10N,50W to 30N,10W:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt project -C-50/10 -E-10/30 -G10 -Q > great_circle_points.xyp
-</pre></div>
-</div>
-</div></blockquote>
-<p>(Note that great_circle_points.xyp could now be used as input for <strong>grdtrack</strong>, etc. ).</p>
-<p>To generate points every 10km along a small circle of colatitude 60 from 10N,50W to 30N,10W:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt project -C-50/10 -E-10/30 -G10/60 -Q > small_circle_points.xyp
-</pre></div>
-</div>
-</div></blockquote>
-<p>To create a partial small circle of colatitude 80 about a pole at
-40E,85N, with extent of 45 degrees to either side of the meridian
-defined by the great circle from the pole to a point 15E,15N, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt project -C15/15 -T40/85 -G1/80 -L-45/45 > some_circle.xyp
-</pre></div>
-</div>
-</div></blockquote>
-<p>To project the shiptrack gravity, magnetics, and bathymetry in
-c2610.xygmb along a great circle through an origin at 30S, 30W, the
-great circle having an azimuth of N20W at the origin, keeping only the
-data from NE of the profile and within +/- 500 km of the origin, run:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt project c2610.xygmb -C-30/-30 -A-20 -W-10000/0 -L-500/500 -Fpz -Q > c2610_projected.pgmb
-</pre></div>
-</div>
-</div></blockquote>
-<p>(Note in this example that <strong>-W</strong>-10000/0 is used to admit any value
-with a large negative <em>q</em> coordinate. This will take those points which
-are on our right as we walk along the great circle path, or to the NE in this example.)</p>
-<p>To make a Cartesian coordinate transformation of mydata.xy so that the
-new origin is at 5,3 and the new <em>x</em> axis (<em>p</em>) makes
-an angle of 20 degrees with the old <em>x</em> axis, use:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt project mydata.xy -C5/3 -A70 -Fpq > mydata.pq
-</pre></div>
-</div>
-</div></blockquote>
-<p>To take data in the file pacific.lonlat and transform it into oblique
-coordinates using a pole from the hotspot reference frame and placing
-the oblique zero meridian (<em>p</em> = 0 line) through Tahiti, run:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt project pacific.lonlat -T-75/68 -C-149:26/-17:37 -Fpq > pacific.pq
-</pre></div>
-</div>
-</div></blockquote>
-<p>Suppose that pacific_topo.nc is a grid file of bathymetry, and you want
-to make a file of flowlines in the hotspot reference frame. If you run:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grd2xyz pacific_topo.nc | project -T-75/68 -C0/-90 -Fxyq | xyz2grd -Retc -Ietc -Cflow.nc
-</pre></div>
-</div>
-</div></blockquote>
-<p>then flow.nc is a file in the same area as pacific_topo.nc, but flow
-contains the latitudes about the pole of the projection. You now can use
-grdcontour on flow.nc to draw lines of constant oblique latitude, which
-are flow lines in the hotspot frame.</p>
-<p>If you have an arbitrarily rotation pole <em>px/py</em> and you would like to
-draw an oblique small circle on a map, you will first need to make a
-file with the oblique coordinates for the small circle (i.e., lon =
-0-360, lat is constant), then create a file with two records: the north
-pole (0/90) and the origin (0/0), and find what their oblique
-coordinates are using your rotation pole. Now, use the projected North
-pole and origin coordinates as the rotation pole and center,
-respectively, and project your file as in the pacific example above.
-This gives coordinates for an oblique small circle.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="fitcircle.html"><em>fitcircle</em></a>,
-<a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="gmtvector.html"><em>gmtvector</em></a>,
-<a class="reference internal" href="mapproject.html"><em>mapproject</em></a>,
-<a class="reference internal" href="grdproject.html"><em>grdproject</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">project</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#ascii-format-precision">Ascii Format Precision</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="P.html"
- title="previous chapter">P</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="PS.html"
- title="next chapter">PS</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/project.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="PS.html" title="PS"
- >next</a> </li>
- <li class="right" >
- <a href="P.html" title="P"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="P.html" >P</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/ps2raster.html b/doc_release/html/ps2raster.html
deleted file mode 100644
index d55e83d..0000000
--- a/doc_release/html/ps2raster.html
+++ /dev/null
@@ -1,477 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>ps2raster — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="PS" href="PS.html" />
- <link rel="next" title="psbasemap" href="psbasemap.html" />
- <link rel="prev" title="PS" href="PS.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="psbasemap.html" title="psbasemap"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="PS.html" title="PS"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" accesskey="U">PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="ps2raster">
-<span id="index-0"></span><h1>ps2raster<a class="headerlink" href="#ps2raster" title="Permalink to this headline">¶</a></h1>
-<p>ps2raster - Convert [E]PS file(s) to other formats using GhostScript</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>ps2raster</strong> <em>psfile(s)</em>
-[ <strong>-A</strong>[<strong>u</strong>][<em>margins</em>][<strong>-</strong>][<strong>+r</strong>][<strong>+s</strong>|<strong>S</strong><em>width</em>[<strong>u</strong>]/<em>height</em>[<strong>u</strong>]] ]
-[ <strong>-C</strong><em>gs_option</em> ] [ <strong>-D</strong><em>outdir</em> ] [ <strong>-E</strong><em>resolution</em> ]
-[ <strong>-G</strong><em>ghost_path</em> ] [ <strong>-I</strong> ] [ <strong>-L</strong><em>listfile</em> ] [ <strong>-P</strong> ]
-[ <strong>-Q</strong>[<strong>g</strong>|<strong>t</strong>][1|2|4] ] [ <strong>-S</strong> ]
-[ <strong>-Tb</strong>|<strong>e</strong>|<strong>E</strong>|<strong>f</strong>|<strong>F</strong>|<strong>j</strong>|<strong>g</strong>|<strong>G</strong>|<strong>m</strong>|<strong>t</strong> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W</strong>[<strong>+g</strong>][<strong>+t</strong><em>docname</em>][<strong>+n</strong><em>layername</em>][<strong>+o</strong><em>foldername</em>][<strong>+a</strong><em>altmode</em>[<em>alt</em>]][<strong>+l</strong><em>minLOD/maxLOD</em>][<strong>+f</strong><em>minfade/maxfade</em>][<strong>+u</strong><em>URL</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>ps2raster</strong> converts one or more PostScript files to other formats
-(BMP, EPS, JPEG, PDF, PNG, PPM, TIFF) using GhostScript. Input file
-names are read from the command line or from a file that lists them. The
-size of the resulting images is determined by the BoundingBox (or
-HiResBoundingBox, if present). As an option, a tight (HiRes)BoundingBox
-may be computed first. As another option, it can compute ESRI type world
-files used to reference, for instance, tif files and make them be
-recognized as geotiff. Note: If the PostScript file calls on any of
-the Adobe PDF transparency extensions <em>and</em> PDF is not the selected output
-format, then the file will first be converted to a temporary PDF file
-(for the transparency to take effect) before converting the PDF to the
-desired output format.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>psfiles</em></dt>
-<dd>Names of PostScript files to be converted. The output files will
-have the same name (unless <strong>-F</strong> is used) but with the conventional
-extension name associated to the raster format (e.g., .jpg for the
-jpeg format). Use <strong>-D</strong> to redirect the output to a different
-directory.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong>[<strong>u</strong>][<em>margins</em>][<strong>-</strong>][<strong>+r</strong>][<strong>+s</strong>|<strong>S</strong><em>width</em>[<strong>u</strong>]/<em>height</em>[<strong>u</strong>]]</dt>
-<dd><p class="first">Adjust the BoundingBox and HiResBoundingBox to the minimum required
-by the image content. Append <strong>u</strong> to first remove any GMT-produced
-time-stamps. Optionally, append extra margins to the bounding box.
-Give either one (uniform), two (x and y) or four (individual sides)
-margins; append unit [Default is set by <a class="reference internal" href="gmt.conf.html#proj-length-unit"><em>PROJ_LENGTH_UNIT</em></a>].
-Alternatively, use <strong>-A-</strong> to override any automatic setting of <strong>-A</strong> by <strong>-W</strong>.</p>
-<p>Use the <strong>-A+s</strong><em>new_width</em> to resize the output image to exactly <em>new_width</em> units.
-The default is to use what is set by <a class="reference internal" href="gmt.conf.html#proj-length-unit"><em>PROJ_LENGTH_UNIT</em></a>
-but you can append a new unit and/or impose different width and height. What happens
-here is that GhostScript will do the re-interpolation work and the final image will
-retain the DPI resolution set by <strong>-E</strong>.
-Alternatively use <strong>-A+S</strong><em>scale</em> to scale the image by a constant factor.</p>
-<p class="last">Use the <strong>-A+r</strong> to round the HighRes BoundingBox instead of using the <cite>ceil</cite> function.
-This is going against Adobe Law but can be useful when creating very small images
-where the difference of one pixel might matter.</p>
-</dd>
-<dt><strong>-C</strong><em>gs_option</em></dt>
-<dd>Specify a single, custom option that will be passed on to
-GhostScript as is. Repeat to add several options [none].</dd>
-<dt><strong>-D</strong><em>outdir</em></dt>
-<dd>Sets an alternative output directory (which must exist) [Default is
-the same directory as the PS files]. Use <strong>-D.</strong> to place the output
-in the current directory instead.</dd>
-<dt><strong>-E</strong><em>resolution</em></dt>
-<dd>Set raster resolution in dpi [default = 720 for PDF, 300 for others].</dd>
-<dt><strong>-F</strong></dt>
-<dd>Force the output file name. By default output names are constructed
-using the input names as base, which are appended with an
-appropriate extension. Use this option to provide a different name,
-but without extension. Extension is still determined automatically.</dd>
-<dt><strong>-G</strong><em>ghost_path</em></dt>
-<dd>Full path to your GhostScript executable. NOTE: For Unix systems
-this is generally not necessary. Under Windows, the GhostScript path
-is now fetched from the registry. If this fails you can still add
-the GS path to system’s path or give the full path here. (e.g.,
-<strong>-G</strong>c:\programs\gs\gs9.02\bin\gswin64c). WARNING: because
-of the poor decision of embedding the bits on the gs exe name we
-cannot satisfy both the 32 and 64 bits GhostScript executable names.
-So in case of ‘get from registry’ failure the default name (when no
-<strong>-G</strong> is used) is the one of the 64 bits version, or gswin64c</dd>
-<dt><strong>-I</strong></dt>
-<dd>Enforce gray-shades by using ICC profiles. GhostScript versions
->= 9.00 change gray-shades by using ICC profiles. GhostScript 9.05
-and above provide the ‘-dUseFastColor=true’ option to prevent that
-and that is what ps2raster does by default, unless option <strong>-I</strong> is
-set. Note that for GhostScript >= 9.00 and < 9.05 the gray-shade
-shifting is applied to all but PDF format. We have no solution to
-offer other than upgrade GhostScript.</dd>
-<dt><strong>-L</strong><em>listfile</em></dt>
-<dd>The <em>listfile</em> is an ASCII file with the names of the PostScript
-files to be converted.</dd>
-<dt><strong>-N</strong></dt>
-<dd>This option is obsolete. Use <strong>-S</strong> to print the GhostScript
-command, if applicable. Use <strong>-Te</strong> to save the intermediate EPS file.</dd>
-<dt><strong>-P</strong></dt>
-<dd>Force Portrait mode. All Landscape mode plots will be rotated back
-so that they show unrotated in Portrait mode. This is practical when
-converting to image formats or preparing EPS or PDF plots for
-inclusion in documents.</dd>
-<dt><strong>-Q</strong>[<strong>g</strong>|<strong>t</strong>][1|2|4]</dt>
-<dd>Set the anti-aliasing options for <strong>g</strong>raphics or <strong>t</strong>ext.
-Append the size of the subsample box (1, 2, or 4) [4]. Default is no
-anti-aliasing (same as <em>bits</em> = 1).</dd>
-<dt><strong>-S</strong></dt>
-<dd>Print to standard error the GhostScript command after it has been executed.
-This option also prevent all intermediate files from being removed.</dd>
-<dt><strong>-Tb</strong>|<strong>e</strong>|<strong>E</strong>|<strong>f</strong>|<strong>F</strong>|<strong>j</strong>|<strong>g</strong>|<strong>G</strong>|<strong>m</strong>|<strong>t</strong></dt>
-<dd>Sets the output format, where <strong>b</strong> means BMP, <strong>e</strong> means EPS,
-<strong>E</strong> means EPS with PageSize command, <strong>f</strong> means PDF, <strong>F</strong> means
-multi-page PDF, <strong>j</strong> means JPEG, <strong>g</strong> means PNG, <strong>G</strong> means
-transparent PNG (untouched regions are transparent), <strong>m</strong> means
-PPM, and <strong>t</strong> means TIFF [default is JPEG]. To <strong>bjgt</strong> you can
-append <strong>-</strong> in order to get a grayscale image. The EPS format can be
-combined with any of the other formats. For example, <strong>-Tef</strong>
-creates both an EPS and a PDF file. The <strong>-TF</strong> creates a multi-page
-PDF file from the list of input PS or PDF files. It requires the <strong>-F</strong> option.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong>[<strong>+g</strong>][<strong>+t</strong><em>docname</em>][<strong>+n</strong><em>layername</em>][<strong>+o</strong><em>foldername</em>][<strong>+a</strong><em>altmode</em>[<em>alt</em>]][<strong>+l</strong><em>minLOD/maxLOD</em>][<strong>+f</strong><em>minfade/maxfade</em>][<strong>+u</strong><em>URL</em>]</dt>
-<dd><p class="first">Write a ESRI type world file suitable to make (e.g) .tif files be
-recognized as geotiff by softwares that know how to do it. Be aware,
-however, that different results are obtained depending on the image
-contents and if the <strong>-B</strong> option has been used or not. The trouble
-with the <strong>-B</strong> option is that it creates a frame and very likely
-its annotations. That introduces pixels outside the map data extent,
-and therefore the map extents estimation will be wrong. To avoid
-this problem use –MAP_FRAME_TYPE=inside option which plots all
-annotations and ticks inside the image and therefore does not
-compromise the coordinate computations. Pay attention also to the
-cases when the plot has any of the sides with whites only because
-than the algorithm will fail miserably as those whites will be eaten
-by the GhostScript. In that case you really must use <strong>-B</strong> or use a
-slightly off-white color.</p>
-<p>Together with <strong>-V</strong> it prints on screen the gdal_translate
-(gdal_translate is a command line tool from the GDAL package)
-command that reads the raster + world file and creates a true
-geotiff file. Use <strong>-W+g</strong> to do a system call to gdal_translate
-and create a geoTIFF image right away. The output file will have a
-.tiff extension.</p>
-<p>The world file naming follows the convention of jamming a ‘w’ in the
-file extension. So, if output is tif <strong>-Tt</strong> the world file is a
-.tfw, for jpeg we have a .jgw and so on. This option automatically
-sets <strong>-A</strong> <strong>-P</strong>.</p>
-<p>Use <strong>-W+k</strong> to create a minimalist KML file that allows loading the
-image in GoogleEarth. Note that for this option the image must be in
-geographical coordinates. If not, a warning is issued but the KML
-file is created anyway. Several modifier options are available to
-customize the KML file in the form of <strong>+</strong><em>opt</em> strings. Append
-<strong>+t</strong><em>title</em> to set the document title [GMT KML Document],
-<strong>+n</strong><em>layername</em> to set the layer name, and
-<strong>+a</strong><em>/altmode</em>[<em>altitude</em>] to select one of 5 altitude modes
-recognized by Google Earth that determines the altitude (in m) of
-the image: <strong>G</strong> clamped to the ground, <strong>g</strong> append altitude
-relative to ground, <strong>a</strong> append absolute altitude, <strong>s</strong> append
-altitude relative to seafloor, and <strong>S</strong> clamp it to the seafloor.
-Control visibility of the layer with the <strong>+l</strong><em>minLOD/maxLOD</em> and
-<strong>+f</strong><em>minfade/maxfade</em> options. Finally, if you plan to leave the
-image itself on a server and only distribute the KML, use
-<strong>+u</strong><em>URL</em> to prepend the URL to the image reference. If you are
-building a multi-component KML file then you can issue a KML snipped
-without the KML header and trailer by using the <strong>+o</strong><em>foldername</em>
-modification; it will enclose the image and associated KML code
-within a KML folder of the specified name. See the KML documentation
-for further explanation
-(<a class="reference external" href="http://code.google.com/apis/kml/documentation/">http://code.google.com/apis/kml/documentation/</a>).</p>
-<p>Further notes on the creation of georeferenced rasters.
-<strong>ps2raster</strong> can create a georeferenced raster image with a world
-file OR uses GDAL to convert the GMT PostScript file to geotiff.
-GDAL uses Proj.4 for its projection library. To provide with the
-information it needs to do the georeferencing, GMT 4.5 embeds a
-comment near the start of the PostScript file defining the
-projection using Proj.4 syntax. Users with pre-GMT v4.5 PostScript
-files, or even non-GMT ps files, can provide the information
-<strong>ps2raster</strong> requires by manually editing a line into the
-PostScript file, prefixed with %%PROJ.</p>
-<p>For example the command</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt pscoast -JM0/12c -R-10/-4/37/43 \
--W1 -Di -Bg30m --MAP_FRAME_TYPE=inside > cara.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>adds this comment line</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>%%PROJ: merc -10.0 -4.0 37.0 43.0 -1113194.908 -445277.963
-4413389.889 5282821.824 +proj=merc +lon_0=0 +k=-1 +x_0=0 +y_0=0
-+a=6378137.0 +b=6356752.314245
-</pre></div>
-</div>
-</div></blockquote>
-<p class="last">where ‘merc’ is the keyword for the coordinate conversion; the 2 to
-5th elements contain the map limits, 6 to 9th the map limits in
-projected coordinates and the rest of the line has the regular proj4
-string for this projection.</p>
-</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="notes">
-<h2>Notes<a class="headerlink" href="#notes" title="Permalink to this headline">¶</a></h2>
-<p>The conversion to raster images (BMP, JPEG, PNG, PPM or TIFF) inherently
-results in loss of details that are available in the original
-PostScript file. Choose a resolution that is large enough for the
-application that the image will be used for. For web pages, smaller dpi
-values suffice, for Word documents and PowerPoint presentations a higher
-dpi value is recommended. <strong>ps2raster</strong> uses the loss-less DEFLATE
-compression technique when creating PDF and PNG files and LZW compression
-for TIFF images.</p>
-<p>EPS is a vector, not a raster format. Therefore, the <strong>-E</strong> option has
-no effect on the creation of EPS files. Using the option <strong>-Te</strong> will
-remove PageSize commands from the PostScript file and will adjust the
-BoundingBox when the <strong>-A</strong> option is used. Note the original and
-required BoundingBox is limited to integer points, hence Adobe added the
-optional HiResBoundingBox to add more precision in sizing. The <strong>-A</strong>
-option calculates both and writes both to the EPS file used in the
-rasterization (and output if <strong>-Te</strong> is set).</p>
-<p>Although PDF is also a vector format, the <strong>-E</strong> option has an effect on
-the resolution of pattern fills and fonts that are stored as bitmaps in
-the document. <strong>ps2raster</strong> therefore uses a larger default resolution
-when creating PDF files. In order to obtain high-quality PDF files, the
-<em>/prepress</em> options are in effect, allowing only loss-less DEFLATE
-compression of raster images embedded in the PostScript file.</p>
-<p>Although <strong>ps2raster</strong> was developed as part of the GMT, it can be
-used to convert PostScript files created by nearly any graphics
-program. However, <strong>-Au</strong> is GMT-specific.</p>
-<p>See <a class="reference internal" href="GMT_Docs.html#include-gmt-graphics"><em>C. Including GMT Graphics into your Documents</em></a> of the <strong>GMT Technical Reference and Cookbook</strong> for more
-information on how <strong>ps2raster</strong> is used to produce graphics that can be
-inserted into other documents (articles, presentations, posters, etc.).</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To convert the file psfile.ps to PNG using a tight BoundingBox and
-rotating it back to normal orientation in case it was in Landscape mode:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt ps2raster psfile.ps -A -P -Tg
-</pre></div>
-</div>
-</div></blockquote>
-<p>To create a 5 cm PNG version at 300 dpi of our example_01.ps file</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt ps2raster example_01.ps -A+s5c -Tg
-</pre></div>
-</div>
-</div></blockquote>
-<p>To create a 3 pages PDF file from 3 individual PS files</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt ps2raster -TF -Fabc a.ps b.ps c.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>To create a simple linear map with pscoast and convert it to tif with a
-.tfw the tight BoundingBox computation.</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt pscoast -JX12cd -R-10/-4/37/43 -W1 -Di -Bg30m -P -G200 --MAP_FRAME_TYPE=inside > cara.ps
-gmt ps2raster cara.ps -Tt -W
-</pre></div>
-</div>
-</div></blockquote>
-<p>To create a Mercator version of the above example and use GDAL to
-produce a true geotiff file.</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt pscoast -JM0/12c -R-10/-4/37/43 -W1 -Di -Bg30m -P -G200 --MAP_FRAME_TYPE=inside > cara.ps
-gdalwarp -s_srs +proj=merc cara.tif carageo.tiff
-</pre></div>
-</div>
-</div></blockquote>
-<p>To create a Polar Stereographic geotiff file of Patagonia</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt pscoast -JS-55/-60/15c -R-77/-55/-57.5/-48r -Di -Gred -P -Bg2 \
---MAP_FRAME_TYPE=inside > patagonia.ps
-gmt ps2raster patagonia.ps -Tt -W+g -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>To create a simple KMZ file for use in Google Earth, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdimage lonlatgrid.nc -Jx1 -Ccolors.cpt -P -B0g2 --MAP_FRAME_TYPE=inside > tile.ps
-gmt ps2raster tile.ps -Tg -W+k+t"my title"+l256/-1 -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>(These commands assume that GhostScript can be found in your system’s path.)</p>
-</div>
-<div class="section" id="ghostscript-options">
-<h2>GhostScript Options<a class="headerlink" href="#ghostscript-options" title="Permalink to this headline">¶</a></h2>
-<p>Most of the conversions done in <strong>ps2raster</strong> are handled by
-GhostScript. On most Unixes this program is available as <strong>gs</strong>; for
-Windows there is a version called <strong>gswin32c</strong>. GhostScript accepts a
-rich selection of command-line options that modify its behavior. Many of
-these are set indirectly by the options available above. However,
-hard-core usage may require some users to add additional options to
-fine-tune the result. Use <strong>-S</strong> to examine the actual command used, and
-add custom options via one or more instances of the <strong>-C</strong> option. For
-instance, to turn on image interpolation for all images, improving image
-quality for scaled images at the expense of speed, use
-<strong>-C</strong>-dDOINTERPOLATE. See www.ghostscript.com for complete
-documentation.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">ps2raster</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#notes">Notes</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#ghostscript-options">GhostScript Options</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="PS.html"
- title="previous chapter">PS</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="psbasemap.html"
- title="next chapter">psbasemap</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/ps2raster.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="psbasemap.html" title="psbasemap"
- >next</a> </li>
- <li class="right" >
- <a href="PS.html" title="PS"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" >PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/psbasemap.html b/doc_release/html/psbasemap.html
deleted file mode 100644
index 66bbf5f..0000000
--- a/doc_release/html/psbasemap.html
+++ /dev/null
@@ -1,754 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>psbasemap — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="PS" href="PS.html" />
- <link rel="next" title="psclip" href="psclip.html" />
- <link rel="prev" title="ps2raster" href="ps2raster.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="psclip.html" title="psclip"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="ps2raster.html" title="ps2raster"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" accesskey="U">PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="psbasemap">
-<span id="index-0"></span><h1>psbasemap<a class="headerlink" href="#psbasemap" title="Permalink to this headline">¶</a></h1>
-<p>psbasemap - Plot PostScript base maps</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>psbasemap</strong> <strong>-J</strong><em>parameters</em>
-<strong>-R</strong><em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]
-[ <strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> ]
-[ <strong>-D</strong>[<em>unit</em>]<em>xmin/xmax/ymin/ymax</em>[<strong>r</strong>]|<em>width</em>[/<em>height</em>][<strong>+c</strong><em>clon/clat</em>][<strong>+p</strong><em>pen</em>][<strong>+g</strong><em>fill</em>]]
-[ <strong>-K</strong> ] [ <strong>-Jz</strong>|<strong>Z</strong><em>parameters</em> ]
-<strong>-L</strong>[<strong>f</strong>][<strong>x</strong>]<em>lon0</em>/<em>lat0</em>[/<em>slon</em>]/<em>slat</em>/<em>length</em>[<strong>e</strong>|<strong>f</strong>|<strong>k</strong>|<strong>M</strong>|<strong>n</strong>|<strong>u</strong>][<strong>+l</strong><em>label</em>][<strong>+j</strong><em>just</em>][<strong>+p</strong><em>pen</em>][<strong>+g</strong><em>fill</em>][<strong>+u</strong>] ] ]
-[ <strong>-O</strong> ] [ <strong>-P</strong> ]
-[ <strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] ]
-[ <strong>-T</strong>[<strong>f</strong>|<strong>m</strong>][<strong>x</strong>]<em>lon0</em>/<em>lat0</em>/<em>size</em>[/<em>info</em>][<strong>:</strong><em>w</em>,<em>e</em>,<em>s</em>,<em>n</em><strong>:</strong>][<strong>+</strong><em>gint</em>[/<em>mint</em>]] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] ]
-[ <strong>-c</strong><em>copies</em> ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] ]
-[ <strong>-t</strong>[<em>transp</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>psbasemap</strong> creates PostScript code that will produce a basemap.
-Several map projections are available, and the user may specify separate
-tickmark intervals for boundary annotation, ticking, and [optionally]
-gridlines. A simple map scale or directional rose may also be plotted.
-At least one of the options <strong>-B</strong>,
-<strong>-L</strong>[<strong>f</strong>][<strong>x</strong>]<em>lon0</em>/<em>lat0</em>[/<em>slon</em>]/<em>slat</em>/<em>length</em>[<strong>e</strong>|<strong>f</strong>|<strong>k</strong>|<strong>M</strong>|<strong>n</strong>|<strong>u</strong>][<strong>+l</strong><em>label</em>][<strong>+j</strong><em>just</em>][<strong>+p</strong><em>pen</em>][<strong>+g</strong><em>fill</em>][<strong>+u</strong>],
-or
-<strong>-T</strong>[<strong>f</strong>|<strong>m</strong>][<strong>x</strong>]<em>lon0</em>/<em>lat0</em>/<em>size</em>[/<em>info</em>][<strong>:</strong><em>w</em>,<em>e</em>,<em>s</em>,<em>n</em><strong>:</strong>][<strong>+</strong><em>gint</em>[/<em>mint</em>]]
-must be specified.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-J</strong><em>parameters</em> <a class="reference internal" href="gmt.html#j-full"><em>(more ...)</em></a></dt>
-<dd>Select map projection.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-</dl>
-<p>For perspective view <strong>p</strong>, optionally append /<em>zmin</em>/<em>zmax</em>. <a class="reference internal" href="gmt.html#rz-full"><em>(more ...)</em></a> </p>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> <a class="reference internal" href="gmt.html#b-full"><em>(more ...)</em></a></dt>
-<dd>Set map boundary intervals.</dd>
-<dt><strong>-D</strong>[<em>unit</em>]<em>xmin/xmax/ymin/ymax</em>[<strong>r</strong>]|<em>width</em>[/<em>height</em>][<strong>+c</strong><em>clon/clat</em>][<strong>+p</strong><em>pen</em>][<strong>+g</strong><em>fill</em>]</dt>
-<dd>Draw a simple map insert box on the map. Specify the box in one of three ways:
-(a) Give <em>west/east/south/north</em> of geographic rectangle bounded by parallels
-and meridians; append <strong>r</strong> if the coordinates instead are the lower left and
-upper right corners of the desired rectangle. (b) Give <strong>u</strong><em>xmin/xmax/ymin/ymax</em>
-of bounding rectangle in projected coordinates (here, <strong>u</strong> is the coordinate unit).
-(c) Give [<strong>u</strong>]<em>width</em>[/<em>height</em>] of bounding rectangle and use <strong>+c</strong> to set
-box center. Append any combination of the following modifiers to draw the insert box:
-<strong>+c</strong><em>lon/lat</em> to specify box center.
-<strong>+g</strong><em>fill</em> to paint a insert [no fill].
-<strong>+p</strong><em>pen</em> to draw the insert outline [no outline].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-Jz</strong>|<strong>Z</strong><em>parameters</em> <a class="reference internal" href="gmt.html#jz-full"><em>(more ...)</em></a></dt>
-<dd>Set z-axis scaling; same syntax as <strong>-Jx</strong>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-K</strong> <a class="reference internal" href="gmt.html#k-full"><em>(more ...)</em></a></dt>
-<dd>Do not finalize the PostScript plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-L</strong>[<strong>f</strong>][<strong>x</strong>]<em>lon0</em>/<em>lat0</em>[/<em>slon</em>]/<em>slat</em>/<em>length</em>[<strong>e</strong>|<strong>f</strong>|<strong>k</strong>|<strong>M</strong>|<strong>n</strong>|<strong>u</strong>][<strong>+l</strong><em>label</em>][<strong>+j</strong><em>just</em>][<strong>+p</strong><em>pen</em>][<strong>+g</strong><em>fill</em>][<strong>+u</strong>]</dt>
-<dd>Draws a simple map scale centered on <em>lon0/lat0</em>. Use <strong>-Lx</strong> to
-specify x/y position instead. Scale is calculated at latitude <em>slat</em>
-(optionally supply longitude <em>slon</em> for oblique projections [Default
-is central meridian]), <em>length</em> is in km, or append unit from
-<strong>e</strong>|<strong>f</strong>|<strong>k</strong>|<strong>M</strong>|<strong>n</strong>|<strong>u</strong>. Use
-<strong>-Lf</strong> to get a “fancy” scale [Default is plain]. Append <strong>+l</strong> to
-select the default label which equals the distance unit (meter,
-foot, km, mile, nautical mile, US survey foot) and is justified on
-top of the scale [t]. Change this by giving your own label (append
-<strong>+l</strong><em>label</em>). Change label justification with
-<strong>+j</strong><em>justification</em> (choose among l(eft), r(ight), t(op), and b(ottom)). Apply
-<strong>+u</strong> to append the unit to all distance annotations along the
-scale. If you want to place a rectangle behind the scale, specify
-suitable <strong>+p</strong><em>pen</em> and/or <strong>+g</strong><em>fill</em> parameters. Note:
-Use <a class="reference internal" href="gmt.conf.html#font-label"><em>FONT_LABEL</em></a> to change the label font and <a class="reference internal" href="gmt.conf.html#font-annot-primary"><em>FONT_ANNOT_PRIMARY</em></a>
-to change the annotation font. The height of the map scale is controlled
-by <a class="reference internal" href="gmt.conf.html#map-scale-height"><em>MAP_SCALE_HEIGHT</em></a>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-O</strong> <a class="reference internal" href="gmt.html#o-full"><em>(more ...)</em></a></dt>
-<dd>Append to existing PostScript plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-P</strong> <a class="reference internal" href="gmt.html#p-full"><em>(more ...)</em></a></dt>
-<dd>Select “Portrait” plot orientation.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-T</strong>[<strong>f</strong>|<strong>m</strong>][<strong>x</strong>]<em>lon0</em>/<em>lat0</em>/<em>size</em>[/<em>info</em>][<strong>:</strong><em>w</em>,<em>e</em>,<em>s</em>,<em>n</em><strong>:</strong>][<strong>+</strong><em>gint</em>[/<em>mint</em>]]</dt>
-<dd>Draws a simple map directional rose centered on <em>lon0/lat0</em>. Use
-<strong>-Tx</strong> to specify x/y position instead. The <em>size</em> is the diameter
-of the rose, and optional label information can be specified to
-override the default values of W, E, S, and N (Give <strong>::</strong> to
-suppress all labels). The default [plain] map rose only labels
-north. Use <strong>-Tf</strong> to get a “fancy” rose, and specify in <em>info</em> what
-you want drawn. The default [<strong>1</strong>] draws the two principal E-W,
-N-S orientations, <strong>2</strong> adds the two intermediate NW-SE and NE-SW
-orientations, while <strong>3</strong> adds the eight minor orientations WNW-ESE,
-NNW-SSE, NNE-SSW, and ENE-WSW. For a magnetic compass rose, specify
-<strong>-Tm</strong>. If given, <em>info</em> must be the two parameters <em>dec/dlabel</em>,
-where <em>dec</em> is the magnetic declination and <em>dlabel</em> is a label for
-the magnetic compass needle (specify <strong>-</strong> to format a label from
-<em>dec</em>). Then, both directions to geographic and magnetic north are
-plotted [Default is geographic only]. If the north label is <strong>*</strong>
-then a north star is plotted instead of the north label. Annotation
-and two levels of tick intervals for both geographic and magnetic
-directions are 30/5/1 degrees; override these settings by appending
-<strong>+</strong><em>gints</em>[/<em>mints</em>]. Color and pen attributes for the rose
-are taken from <strong>COLOR_BACKGROUND</strong> and <strong>MAP_TICK_PEN</strong>,
-respectively, while label fonts, colors and sizes follow
-<strong>FONT_TITLE</strong> for the four major directions and <strong>FONT_LABEL</strong>
-for minor directions.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] <a class="reference internal" href="gmt.html#u-full"><em>(more ...)</em></a></dt>
-<dd>Draw GMT time stamp logo on plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<p><strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]]</p>
-<dl class="docutils">
-<dt><strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] <a class="reference internal" href="gmt.html#xy-full"><em>(more ...)</em></a></dt>
-<dd>Shift plot origin.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-c</strong><em>copies</em> <a class="reference internal" href="gmt.html#c-full"><em>(more ...)</em></a></dt>
-<dd>Specify number of plot copies [Default is 1].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. This applies only to the coordinates specified in the <strong>-R</strong> option.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] <a class="reference internal" href="gmt.html#perspective-full"><em>(more ...)</em></a></dt>
-<dd>Select perspective view. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-t</strong>[<em>transp</em>] <a class="reference internal" href="gmt.html#t-full"><em>(more ...)</em></a></dt>
-<dd>Set PDF transparency level in percent.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>The following section illustrates the use of the options by giving some
-examples for the available map projections. Note how scales may be given
-in several different ways depending on the projection. Also note the use
-of upper case letters to specify map width instead of map scale.</p>
-</div>
-<div class="section" id="non-geographical-projections">
-<h2>Non-geographical Projections<a class="headerlink" href="#non-geographical-projections" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="linear-x-y-plot">
-<h3>Linear x-y plot<a class="headerlink" href="#linear-x-y-plot" title="Permalink to this headline">¶</a></h3>
-<p>To make a linear x/y frame with all axes, but with only left and bottom
-axes annotated, using xscale = yscale = 1.0, ticking every 1 unit and
-annotating every 2, and using xlabel = “Distance” and ylabel = “No of samples”, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -R0/9/0/5 -Jx1 -Bf1a2:Distance:/:"No of samples":WeSn > linear.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="log-log-plot">
-<h3>Log-log plot<a class="headerlink" href="#log-log-plot" title="Permalink to this headline">¶</a></h3>
-<p>To make a log-log frame with only the left and bottom axes, where the
-x-axis is 25 cm and annotated every 1-2-5 and the y-axis is 15 cm and
-annotated every power of 10 but has tickmarks every 0.1, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -R1/10000/1e20/1e25 -JX25cl/15cl -B2:Wavelength:/a1pf3:Power:WS > loglog.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="power-axes">
-<h3>Power axes<a class="headerlink" href="#power-axes" title="Permalink to this headline">¶</a></h3>
-<p>To design an axis system to be used for a depth-sqrt(age) plot with
-depth positive down, ticked and annotated every 500m, and ages annotated
-at 1 my, 4 my, 9 my etc, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -R0/100/0/5000 -Jx1p0.5/-0.001 -B1p:"Crustal age":/500:Depth: > power.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="polar-theta-r-plot">
-<h3>Polar (theta,r) plot<a class="headerlink" href="#polar-theta-r-plot" title="Permalink to this headline">¶</a></h3>
-<p>For a base map for use with polar coordinates, where the radius from 0
-to 1000 should correspond to 3 inch and with gridlines and ticks every
-30 degrees and 100 units, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -R0/360/0/1000 -JP6i -B30p/100 > polar.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-</div>
-<div class="section" id="cylindrical-map-projections">
-<h2>Cylindrical Map Projections<a class="headerlink" href="#cylindrical-map-projections" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="cassini">
-<h3>Cassini<a class="headerlink" href="#cassini" title="Permalink to this headline">¶</a></h3>
-<p>A 10-cm-wide basemap using the Cassini projection may be obtained by</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -R20/50/20/35 -JC35/28/10c -P -B5g5:.Cassini: > cassini.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="mercator-conformal">
-<h3>Mercator [conformal]<a class="headerlink" href="#mercator-conformal" title="Permalink to this headline">¶</a></h3>
-<p>A Mercator map with scale 0.025 inch/degree along equator, and showing
-the length of 5000 km along the equator (centered on 1/1 inch), may be
-plotted as</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -R90/180/-50/50 -Jm0.025i -B30g30:.Mercator: -Lx1i/1i/0/5000 > mercator.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="miller">
-<h3>Miller<a class="headerlink" href="#miller" title="Permalink to this headline">¶</a></h3>
-<p>A global Miller cylindrical map with scale 1:200,000,000 may be plotted as</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -Rg -Jj180/1:200000000 -B30g30:.Miller: > miller.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="oblique-mercator-conformal">
-<h3>Oblique Mercator [conformal]<a class="headerlink" href="#oblique-mercator-conformal" title="Permalink to this headline">¶</a></h3>
-<p>To create a page-size global oblique Mercator basemap for a pole at
-(90,30) with gridlines every 30 degrees, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -R0/360/-70/70 -Joc0/0/90/30/0.064cd -B30g30:."Oblique Mercator": > oblmerc.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="transverse-mercator-conformal">
-<h3>Transverse Mercator [conformal]<a class="headerlink" href="#transverse-mercator-conformal" title="Permalink to this headline">¶</a></h3>
-<p>A regular Transverse Mercator basemap for some region may look like</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -R69:30/71:45/-17/-15:15 -Jt70/1:1000000 -B15m:."Survey area": -P > transmerc.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="equidistant-cylindrical-projection">
-<h3>Equidistant Cylindrical Projection<a class="headerlink" href="#equidistant-cylindrical-projection" title="Permalink to this headline">¶</a></h3>
-<p>This projection only needs the central meridian and scale. A 25 cm wide
-global basemap centered on the 130E meridian is made by</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -R-50/310/-90/90 -JQ130/25c -B30g30:."Equidistant Cylindrical": > cyl\_eqdist.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="universal-transverse-mercator-conformal">
-<h3>Universal Transverse Mercator [conformal]<a class="headerlink" href="#universal-transverse-mercator-conformal" title="Permalink to this headline">¶</a></h3>
-<p>To use this projection you must know the UTM zone number, which defines
-the central meridian. A UTM basemap for Indo-China can be plotted as</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -R95/5/108/20r -Ju46/1:10000000 -B3g3:.UTM: > utm.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="cylindrical-equal-area">
-<h3>Cylindrical Equal-Area<a class="headerlink" href="#cylindrical-equal-area" title="Permalink to this headline">¶</a></h3>
-<p>First select which of the cylindrical equal-area projections you want by
-deciding on the standard parallel. Here we will use 45 degrees which
-gives the Gall-Peters projection. A 9 inch wide global basemap centered
-on the Pacific is made by</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -Rg -JY180/45/9i -B30g30:.Gall-Peters: > gall-peters.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-</div>
-<div class="section" id="conic-map-projections">
-<h2>Conic Map Projections<a class="headerlink" href="#conic-map-projections" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="albers-equal-area">
-<h3>Albers [equal-area]<a class="headerlink" href="#albers-equal-area" title="Permalink to this headline">¶</a></h3>
-<p>A basemap for middle Europe may be created by</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -R0/90/25/55 -Jb45/20/32/45/0.25c -B10g10:."Albers Equal-area": > albers.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="lambert-conformal">
-<h3>Lambert [conformal]<a class="headerlink" href="#lambert-conformal" title="Permalink to this headline">¶</a></h3>
-<p>Another basemap for middle Europe may be created by</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -R0/90/25/55 -Jl45/20/32/45/0.1i -B10g10:."Lambert Conformal Conic": > lambertc.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="equidistant">
-<h3>Equidistant<a class="headerlink" href="#equidistant" title="Permalink to this headline">¶</a></h3>
-<p>Yet another basemap of width 6 inch for middle Europe may be created by</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -R0/90/25/55 -JD45/20/32/45/6i -B10g10:."Equidistant conic": > econic.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="polyconic">
-<h3>Polyconic<a class="headerlink" href="#polyconic" title="Permalink to this headline">¶</a></h3>
-<p>A basemap for north America may be created by</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -R-180/-20/0/90 -JPoly/4i -B30g10/10g10:."Polyconic": > polyconic.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-</div>
-<div class="section" id="azimuthal-map-projections">
-<h2>Azimuthal Map Projections<a class="headerlink" href="#azimuthal-map-projections" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="lambert-equal-area">
-<h3>Lambert [equal-area]<a class="headerlink" href="#lambert-equal-area" title="Permalink to this headline">¶</a></h3>
-<p>A 15-cm-wide global view of the world from the vantage point -80/-30
-will give the following basemap:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -Rg -JA-80/-30/15c -B30g30/15g15:."Lambert Azimuthal": > lamberta.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>Follow the instructions for stereographic projection if you want to
-impose rectangular boundaries on the azimuthal equal-area map but
-substitute <strong>-Ja</strong> for <strong>-Js</strong>.</p>
-</div>
-<div class="section" id="id1">
-<h3>Equidistant<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h3>
-<p>A 15-cm-wide global map in which distances from the center (here 125/10)
-to any point is true can be obtained by:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -Rg -JE125/10/15c -B30g30/15g15:.Equidistant: > equi.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="gnomonic">
-<h3>Gnomonic<a class="headerlink" href="#gnomonic" title="Permalink to this headline">¶</a></h3>
-<p>A view of the world from the vantage point -100/40 out to a horizon of
-60 degrees from the center can be made using the Gnomonic projection:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -Rg -JF-100/40/60/6i -B30g30/15g15:.Gnomonic: > gnomonic.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="orthographic">
-<h3>Orthographic<a class="headerlink" href="#orthographic" title="Permalink to this headline">¶</a></h3>
-<p>A global perspective (from infinite distance) view of the world from the
-vantage point 125/10 will give the following 6-inch-wide basemap:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -Rg -JG125/10/6i -B30g30/15g15:.Orthographic: > ortho.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="general-perspective">
-<h3>General Perspective<a class="headerlink" href="#general-perspective" title="Permalink to this headline">¶</a></h3>
-<p>The <strong>-JG</strong> option can be used in a more generalized form, specifying
-altitude above the surface, width and height of the view point, and
-twist and tilt. A view from 160 km above -74/41.5 with a tilt of 55 and
-azimuth of 210 degrees, and limiting the viewpoint to 30 degrees width
-and height will product a 6-inch-wide basemap:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -Rg -JG-74/41.5/160/210/55/30/30/6i -B5g1/5g1:."General Perspective": > genper.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="stereographic-conformal">
-<h3>Stereographic [conformal]<a class="headerlink" href="#stereographic-conformal" title="Permalink to this headline">¶</a></h3>
-<p>To make a polar stereographic projection basemap with radius = 12 cm to
--60 degree latitude, with plot title “Salinity measurements”, using 5
-degrees annotation/tick interval and 1 degree gridlines, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -R-45/45/-90/-60 -Js0/-90/12c/-60 -B5g5:."Salinity measurements": > stereo1.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>To make a 12-cm-wide stereographic basemap for Australia from an
-arbitrary view point (not the poles), and use a rectangular boundary, we
-must give the pole for the new projection and use the <strong>-R</strong> option to
-indicate the lower left and upper right corners (in lon/lat) that will
-define our rectangle. We choose a pole at 130/-30 and use 100/-45 and
-160/-5 as our corners. The command becomes</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -R100/-45/160/-5r -JS130/-30/12c -B30g30/15g15:."General Stereographic View": > stereo2.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-</div>
-<div class="section" id="id2">
-<h2><a class="reference external" href="#toc33">Miscellaneous Map Projections</a><a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h2>
-<div class="section" id="hammer-equal-area">
-<h3>Hammer [equal-area]<a class="headerlink" href="#hammer-equal-area" title="Permalink to this headline">¶</a></h3>
-<p>The Hammer projection is mostly used for global maps and thus the
-spherical form is used. To get a world map centered on Greenwich at a
-scale of 1:200000000, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -Rd -Jh0/1:200000000 -B30g30/15g15:.Hammer: > hammer.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="sinusoidal-equal-area">
-<h3>Sinusoidal [equal-area]<a class="headerlink" href="#sinusoidal-equal-area" title="Permalink to this headline">¶</a></h3>
-<p>To make a sinusoidal world map centered on Greenwich, with a scale along
-the equator of 0.02 inch/degree, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -Rd -Ji0/0.02i -B30g30/15g15:.Sinusoidal: > sinus1.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>To make an interrupted sinusoidal world map with breaks at 160W, 20W,
-and 60E, with a scale along the equator of 0.02 inch/degree, run the
-following sequence of commands:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -R-160/-20/-90/90 -Ji-90/0.02i -B30g30/15g15Wesn -K > sinus_i.ps
-gmt psbasemap -R-20/60/-90/90 -Ji20/0.02i -B30g30/15g15wesn -O -K -X2.8i >> sinus_i.ps
-gmt psbasemap -R60/200/-90/90 -Ji130/0.02i -B30g30/15g15wEsn -O -X1.6i >> sinus_i.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="eckert-iv-equal-area">
-<h3>Eckert IV [equal-area]<a class="headerlink" href="#eckert-iv-equal-area" title="Permalink to this headline">¶</a></h3>
-<p>Pseudo-cylindrical projection typically used for global maps only. Set
-the central longitude and scale, e.g.,</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -Rg -Jkf180/0.064c -B30g30/15g15:."Eckert IV": > eckert4.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="eckert-vi-equal-area">
-<h3>Eckert VI [equal-area]<a class="headerlink" href="#eckert-vi-equal-area" title="Permalink to this headline">¶</a></h3>
-<p>Another pseudo-cylindrical projection typically used for global maps
-only. Set the central longitude and scale, e.g.,</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -Rg -Jks180/0.064c -B30g30/15g15:."Eckert VI": > eckert6.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="robinson">
-<h3>Robinson<a class="headerlink" href="#robinson" title="Permalink to this headline">¶</a></h3>
-<p>Projection designed to make global maps “look right”. Set the central
-longitude and width, e.g.,</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -Rd -JN0/8i -B30g30/15g15:.Robinson: > robinson.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="winkel-tripel">
-<h3>Winkel Tripel<a class="headerlink" href="#winkel-tripel" title="Permalink to this headline">¶</a></h3>
-<p>Yet another projection typically used for global maps only. You can set
-the central longitude, e.g.,</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -R90/450/-90/90 -JR270/25c -B30g30/15g15:."Winkel Tripel": > winkel.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="mollweide-equal-area">
-<h3>Mollweide [equal-area]<a class="headerlink" href="#mollweide-equal-area" title="Permalink to this headline">¶</a></h3>
-<p>The Mollweide projection is also mostly used for global maps and thus
-the spherical form is used. To get a 25-cm-wide world map centered on
-the Dateline:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>psbasemap -Rg -JW180/25c -B30g30/15g15:.Mollweide: > mollweide.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="van-der-grinten">
-<h3>Van der Grinten<a class="headerlink" href="#van-der-grinten" title="Permalink to this headline">¶</a></h3>
-<p>The Van der Grinten projection is also mostly used for global maps and
-thus the spherical form is used. To get a 7-inch-wide world map centered on the Dateline:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psbasemap -Rg -JV180/7i -B30g30/15g15:."Van der Grinten": > grinten.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-</div>
-<div class="section" id="custom-labels-or-intervals">
-<h2>CUSTOM lABELS OR INTERVALS<a class="headerlink" href="#custom-labels-or-intervals" title="Permalink to this headline">¶</a></h2>
-<p>The <strong>-B</strong> option sets up a regular annotation interval and the
-annotations derive from the corresponding <em>x</em>, <em>y</em>, or <em>z</em> coordinates.
-However, some applications requires special control on which annotations
-to plot and even replace the annotation with other labels. This is
-achieved by using <strong>c</strong><em>intfile</em> in the <strong>-B</strong> option, where <em>intfile</em>
-contains all the information about annotations, ticks, and even
-gridlines. Each record is of the form <em>coord</em> <em>type</em> [<em>label</em>], where
-<em>coord</em> is the coordinate for this annotation (or tick or gridline),
-<em>type</em> is one or more letters from <strong>a</strong> (annotation), <strong>i</strong> interval
-annotation, <strong>f</strong> tickamrk, and <strong>g</strong> gridline. Note that <strong>a</strong> and
-<strong>i</strong> are mutually exclusive and cannot both appear in the same
-<em>intfile</em>. Both <strong>a</strong> and <strong>i</strong> requires you to supply a <em>label</em> which
-is used as the plot annotation. If not given then a regular formatted
-annotation based on the coordinate will occur.</p>
-</div>
-<div class="section" id="restrictions">
-<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
-<p>For some projections, a spherical earth is implicitly assumed. A warning
-will notify the user if <strong>-V</strong> is set.</p>
-</div>
-<div class="section" id="bugs">
-<h2>Bugs<a class="headerlink" href="#bugs" title="Permalink to this headline">¶</a></h2>
-<p>The <strong>-B</strong> option is somewhat complicated to explain and comprehend.
-However, it is fairly simple for most applications (see examples).</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>, <a class="reference internal" href="gmtcolors.html"><em>gmtcolors</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">psbasemap</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#non-geographical-projections">Non-geographical Projections</a><ul>
-<li><a class="reference internal" href="#linear-x-y-plot">Linear x-y plot</a></li>
-<li><a class="reference internal" href="#log-log-plot">Log-log plot</a></li>
-<li><a class="reference internal" href="#power-axes">Power axes</a></li>
-<li><a class="reference internal" href="#polar-theta-r-plot">Polar (theta,r) plot</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#cylindrical-map-projections">Cylindrical Map Projections</a><ul>
-<li><a class="reference internal" href="#cassini">Cassini</a></li>
-<li><a class="reference internal" href="#mercator-conformal">Mercator [conformal]</a></li>
-<li><a class="reference internal" href="#miller">Miller</a></li>
-<li><a class="reference internal" href="#oblique-mercator-conformal">Oblique Mercator [conformal]</a></li>
-<li><a class="reference internal" href="#transverse-mercator-conformal">Transverse Mercator [conformal]</a></li>
-<li><a class="reference internal" href="#equidistant-cylindrical-projection">Equidistant Cylindrical Projection</a></li>
-<li><a class="reference internal" href="#universal-transverse-mercator-conformal">Universal Transverse Mercator [conformal]</a></li>
-<li><a class="reference internal" href="#cylindrical-equal-area">Cylindrical Equal-Area</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#conic-map-projections">Conic Map Projections</a><ul>
-<li><a class="reference internal" href="#albers-equal-area">Albers [equal-area]</a></li>
-<li><a class="reference internal" href="#lambert-conformal">Lambert [conformal]</a></li>
-<li><a class="reference internal" href="#equidistant">Equidistant</a></li>
-<li><a class="reference internal" href="#polyconic">Polyconic</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#azimuthal-map-projections">Azimuthal Map Projections</a><ul>
-<li><a class="reference internal" href="#lambert-equal-area">Lambert [equal-area]</a></li>
-<li><a class="reference internal" href="#id1">Equidistant</a></li>
-<li><a class="reference internal" href="#gnomonic">Gnomonic</a></li>
-<li><a class="reference internal" href="#orthographic">Orthographic</a></li>
-<li><a class="reference internal" href="#general-perspective">General Perspective</a></li>
-<li><a class="reference internal" href="#stereographic-conformal">Stereographic [conformal]</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#id2">Miscellaneous Map Projections</a><ul>
-<li><a class="reference internal" href="#hammer-equal-area">Hammer [equal-area]</a></li>
-<li><a class="reference internal" href="#sinusoidal-equal-area">Sinusoidal [equal-area]</a></li>
-<li><a class="reference internal" href="#eckert-iv-equal-area">Eckert IV [equal-area]</a></li>
-<li><a class="reference internal" href="#eckert-vi-equal-area">Eckert VI [equal-area]</a></li>
-<li><a class="reference internal" href="#robinson">Robinson</a></li>
-<li><a class="reference internal" href="#winkel-tripel">Winkel Tripel</a></li>
-<li><a class="reference internal" href="#mollweide-equal-area">Mollweide [equal-area]</a></li>
-<li><a class="reference internal" href="#van-der-grinten">Van der Grinten</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#custom-labels-or-intervals">CUSTOM lABELS OR INTERVALS</a></li>
-<li><a class="reference internal" href="#restrictions">Restrictions</a></li>
-<li><a class="reference internal" href="#bugs">Bugs</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="ps2raster.html"
- title="previous chapter">ps2raster</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="psclip.html"
- title="next chapter">psclip</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/psbasemap.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="psclip.html" title="psclip"
- >next</a> </li>
- <li class="right" >
- <a href="ps2raster.html" title="ps2raster"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" >PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/psclip.html b/doc_release/html/psclip.html
deleted file mode 100644
index 91c322a..0000000
--- a/doc_release/html/psclip.html
+++ /dev/null
@@ -1,346 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>psclip — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="PS" href="PS.html" />
- <link rel="next" title="pscoast" href="pscoast.html" />
- <link rel="prev" title="psbasemap" href="psbasemap.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="pscoast.html" title="pscoast"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="psbasemap.html" title="psbasemap"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" accesskey="U">PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="psclip">
-<span id="index-0"></span><h1>psclip<a class="headerlink" href="#psclip" title="Permalink to this headline">¶</a></h1>
-<p>psclip - Initialize or terminate polygonal clip paths</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>psclip</strong> [ <em>table</em> ] <strong>-J</strong><em>parameters</em>
-<strong>-R</strong><em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]
-[ <strong>-A</strong>[<strong>m</strong>|<strong>p</strong>] ]
-[ <strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> ]
-<strong>-Jz</strong>|<strong>Z</strong><em>parameters</em> ] [ <strong>-K</strong> ] [ <strong>-N</strong> ] [ <strong>-O</strong> ]
-[ <strong>-P</strong> ] [ <strong>-T</strong> ]
-[ <strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] ]
-[ <strong>-bi</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-c</strong><em>copies</em> ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] ]
-[ <strong>-t</strong>[<em>transp</em>] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>psclip</strong> <strong>-C</strong>[<em>n</em>] [ <strong>-K</strong> ] [ <strong>-O</strong> ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>psclip</strong> reads (x,y) file(s) [or standard input] and draws polygons
-that are activated as clipping paths. Several files may be read to
-create complex paths consisting of several non-connecting segments. Only
-marks that are subsequently drawn inside the clipping path will be
-shown. To determine what is inside or outside the clipping path,
-<strong>psclip</strong> uses the even-odd rule. When a ray drawn from any point,
-regardless of direction, crosses the clipping path segments an odd
-number of times, the point is inside the clipping path. If the number is
-even, the point is outside. The <strong>-N</strong> option, reverses the sense of
-what is the inside and outside of the paths by plotting a clipping path
-along the map boundary. After subsequent plotting, which will be clipped
-against these paths, the clipping may be deactivated by running
-<strong>psclip</strong> a second time with the <strong>-C</strong> option only.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-C</strong>[|<em>n</em>]</dt>
-<dd>Mark end of existing clip path(s). No input file will be processed.
-No projection information is needed unless <strong>-B</strong> has been selected
-as well. With no arguments we terminate all active clipping paths.
-Experts may restrict the termination to just <em>n</em> of the active
-clipping path by passing that as the argument.
-Remember to supply
-<strong>-X</strong> and <strong>-Y</strong> settings if you have moved since the clip started.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-J</strong><em>parameters</em> <a class="reference internal" href="gmt.html#j-full"><em>(more ...)</em></a></dt>
-<dd>Select map projection.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-</dl>
-<p>For perspective view <strong>p</strong>, optionally append /<em>zmin</em>/<em>zmax</em>. <a class="reference internal" href="gmt.html#rz-full"><em>(more ...)</em></a> </p>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>[<em>ncols</em>][<em>type</em>]) data
-table file(s) holding a number of data columns. If no tables are given
-then we read from standard input. </dd>
-<dt><strong>-A</strong>[<strong>m</strong>|<strong>p</strong>]</dt>
-<dd>By default line segments are connected as great circle arcs. To connect them as
-straight lines, use the <strong>-A</strong> flag. Alternatively, add <strong>m</strong> to connect
-the line by first following a meridian, then a parallel. Or append <strong>p</strong>
-to start following a parallel, then a meridian. (This can be practical
-to connect lines along parallels, for example).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> <a class="reference internal" href="gmt.html#b-full"><em>(more ...)</em></a></dt>
-<dd>Set map boundary intervals.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-Jz</strong>|<strong>Z</strong><em>parameters</em> <a class="reference internal" href="gmt.html#jz-full"><em>(more ...)</em></a></dt>
-<dd>Set z-axis scaling; same syntax as <strong>-Jx</strong>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-K</strong> <a class="reference internal" href="gmt.html#k-full"><em>(more ...)</em></a></dt>
-<dd>Do not finalize the PostScript plot.</dd>
-<dt><strong>-N</strong></dt>
-<dd>Invert the sense of what is inside and outside. For example, when
-using a single path, this means that only points outside that path
-will be shown. Cannot be used together with <strong>-B</strong>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-O</strong> <a class="reference internal" href="gmt.html#o-full"><em>(more ...)</em></a></dt>
-<dd>Append to existing PostScript plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-P</strong> <a class="reference internal" href="gmt.html#p-full"><em>(more ...)</em></a></dt>
-<dd>Select “Portrait” plot orientation.</dd>
-<dt><strong>-T</strong></dt>
-<dd>Rather than read any input files, simply turn on clipping for the
-current map region. Basically, <strong>-T</strong> is a convenient way to run
-<strong>psclip</strong> with the arguments <strong>-N</strong> /dev/null (or, under Windows,
-<strong>-N</strong> NUL). Cannot be used together with <strong>-B</strong>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] <a class="reference internal" href="gmt.html#u-full"><em>(more ...)</em></a></dt>
-<dd>Draw GMT time stamp logo on plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<p><strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]]</p>
-<dl class="docutils">
-<dt><strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] <a class="reference internal" href="gmt.html#xy-full"><em>(more ...)</em></a></dt>
-<dd>Shift plot origin.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 2 input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-c</strong><em>copies</em> <a class="reference internal" href="gmt.html#c-full"><em>(more ...)</em></a></dt>
-<dd>Specify number of plot copies [Default is 1].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] <a class="reference internal" href="gmt.html#g-full"><em>(more ...)</em></a></dt>
-<dd>Determine data gaps and line breaks. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] <a class="reference internal" href="gmt.html#perspective-full"><em>(more ...)</em></a></dt>
-<dd>Select perspective view. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-t</strong>[<em>transp</em>] <a class="reference internal" href="gmt.html#t-full"><em>(more ...)</em></a></dt>
-<dd>Set PDF transparency level in percent.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To make an overlay PostScript file that will set up a complex clip
-area to which subsequent plotting will be confined, run:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psclip my_region.xy -R0/40/0/40 -Jm0.3i -O -K > clip_mask_on.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>To deactivate the clipping in an existing plotfile, run:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psclip -C -O >> complex_plot.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="grdmask.html"><em>grdmask</em></a>,
-<a class="reference internal" href="psbasemap.html"><em>psbasemap</em></a>, <a class="reference internal" href="psmask.html"><em>psmask</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">psclip</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="psbasemap.html"
- title="previous chapter">psbasemap</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="pscoast.html"
- title="next chapter">pscoast</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/psclip.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="pscoast.html" title="pscoast"
- >next</a> </li>
- <li class="right" >
- <a href="psbasemap.html" title="psbasemap"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" >PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/pscoast.html b/doc_release/html/pscoast.html
deleted file mode 100644
index d616af7..0000000
--- a/doc_release/html/pscoast.html
+++ /dev/null
@@ -1,547 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>pscoast — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="PS" href="PS.html" />
- <link rel="next" title="pscontour" href="pscontour.html" />
- <link rel="prev" title="psclip" href="psclip.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="pscontour.html" title="pscontour"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="psclip.html" title="psclip"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" accesskey="U">PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="pscoast">
-<span id="index-0"></span><h1>pscoast<a class="headerlink" href="#pscoast" title="Permalink to this headline">¶</a></h1>
-<p>pscoast - Plot continents, shorelines, rivers, and borders on maps</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>pscoast</strong> <strong>-J</strong><em>parameters</em>
-<strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>]
-[ <strong>-A</strong><em>min_area</em>[/<em>min_level</em>/<em>max_level</em>][<strong>+as</strong>][<strong>+r</strong>|<strong>l</strong>][<strong>p</strong><em>percent</em>] ]
-[ <strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> ]
-[ <strong>-C</strong>[<strong>l</strong>|<strong>r</strong>/]<em>fill</em> ]
-[ <strong>-D</strong><em>resolution</em>[<strong>+</strong>] ]
-[ <strong>-F</strong><em>code1,code2,...</em>[<strong>+l</strong>|<strong>L</strong>][<strong>+g</strong><em>fill</em>][<strong>+p</strong><em>pen</em>][<strong>+r</strong>|<strong>R</strong>[<em>incs</em>]]]
-[ <strong>-G</strong><em>fill</em>|<strong>c</strong> ] [ <strong>-I</strong><em>river</em>[/<em>pen</em>] ]
-[ <strong>-Jz</strong>|<strong>Z</strong><em>parameters</em> ] [ <strong>-K</strong> ]
-[ <strong>-L</strong>[<strong>f</strong>][<strong>x</strong>]<em>lon0</em>/<em>lat0</em>[/<em>slon</em>]/<em>slat</em>/<em>length</em>[<strong>e</strong>|<strong>f</strong>|<strong>k</strong>|<strong>M</strong>|<strong>n</strong>|<strong>u</strong>][<strong>+l</strong><em>label</em>][<strong>+j</strong><em>just</em>][<strong>+p</strong><em>pen</em>][<strong>+g</strong><em>fill</em>][<strong>+u</strong>] ] ]
-[ <strong>-M</strong> ] [ <strong>-N</strong><em>border</em>[/<em>pen</em>] ] [ <strong>-O</strong> ] [ <strong>-P</strong> ]
-[ <strong>-Q</strong> ] [ <strong>-S</strong><em>fill</em>|<strong>c</strong> ]
-[ <strong>-T</strong>[<strong>f</strong>|<strong>m</strong>][<strong>x</strong>]<em>lon0</em>/<em>lat0</em>/<em>size</em>[/<em>info</em>][<strong>:</strong><em>w</em>,<em>e</em>,<em>s</em>,<em>n</em><strong>:</strong>][<strong>+</strong><em>gint</em>[/<em>mint</em>]] ]
-[ <strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W</strong>[<em>level</em>/]<em>pen</em> ]
-[ <strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] ]
-[ <strong>-bo</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-c</strong><em>copies</em> ]
-[ <strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] ]
-[ <strong>-t</strong>[<em>transp</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>pscoast</strong> plots grayshaded, colored, or textured land-masses [or
-water-masses] on maps and [optionally] draws coastlines, rivers, and
-political boundaries. Alternatively, it can (1) issue clip
-paths that will contain all land or all water areas, or
-(2) dump the data to an ASCII table. The data files come
-in 5 different resolutions: (<strong>f</strong>)ull, (<strong>h</strong>)igh, (<strong>i</strong>)ntermediate,
-(<strong>l</strong>)ow, and (<strong>c</strong>)rude. The full resolution files amount to more
-than 55 Mb of data and provide great detail; for maps of larger
-geographical extent it is more economical to use one of the other
-resolutions. If the user selects to paint the land-areas and does not
-specify fill of water-areas then the latter will be transparent (i.e.,
-earlier graphics drawn in those areas will not be overwritten).
-Likewise, if the water-areas are painted and no land fill is set then
-the land-areas will be transparent. A map projection must be supplied.
-The PostScript code is written to standard output.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-J</strong><em>parameters</em> <a class="reference internal" href="gmt.html#j-full"><em>(more ...)</em></a></dt>
-<dd>Select map projection.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]</dt>
-<dd><em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> specify the region of interest,
-and you may specify them in decimal degrees or in
-[+-]dd:mm[:ss.xxx][W|E|S|N] format. Append <strong>r</strong> if lower left
-and upper right map coordinates are given instead of w/e/s/n. The
-two shorthands <strong>-Rg</strong> and <strong>-Rd</strong> stand for global domain (0/360
-and -180/+180 in longitude respectively, with -90/+90 in latitude).
-Alternatively, specify the name of an existing grid file and the
-<strong>-R</strong> settings (and grid spacing, if applicable) are copied from
-the grid. Using <strong>-R</strong><em>unit</em> expects projected (Cartesian)
-coordinates compatible with chosen <strong>-J</strong> and we inversely project
-to determine actual rectangular geographic region.
-For perspective view (<strong>-p</strong>), optionally append /<em>zmin</em>/<em>zmax</em>.
-In case of perspective view (<strong>-p</strong>), a z-range (<em>zmin</em>, <em>zmax</em>)
-can be appended to indicate the third dimension. This needs to be
-done only when using the <strong>-Jz</strong> option, not when using only the
-<strong>-p</strong> option. In the latter case a perspective view of the plane is
-plotted, with no third dimension. </dd>
-</dl>
-<p>For perspective view <strong>p</strong>, optionally append /<em>zmin</em>/<em>zmax</em>. <a class="reference internal" href="gmt.html#rz-full"><em>(more ...)</em></a> </p>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong><em>min_area</em>[/<em>min_level</em>/<em>max_level</em>][<strong>+as</strong>][<strong>+r</strong>|<strong>l</strong>][<strong>+p</strong><em>percent</em>]</dt>
-<dd>Features with an area smaller than <em>min_area</em> in km^2 or of
-hierarchical level that is lower than <em>min_level</em> or higher than
-<em>max_level</em> will not be plotted [Default is 0/0/4 (all features)].
-Level 2 (lakes) contains regular lakes and wide river bodies which
-we normally include as lakes; append <strong>+r</strong> to just get river-lakes
-or <strong>+l</strong> to just get regular lakes. For expert users who wish to
-print their own Antarctica coastline and islands via <cite>psxy</cite> you can
-use <strong>+as</strong> to skip all GSHHG features below 60S. Finally, append
-<strong>+p</strong><em>percent</em> to exclude polygons whose percentage area of the
-corresponding full-resolution feature is less than <em>percent</em>. See
-GSHHG INFORMATION below for more details. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> <a class="reference internal" href="gmt.html#b-full"><em>(more ...)</em></a></dt>
-<dd>Set map boundary intervals.</dd>
-<dt><strong>-C</strong>[<strong>l</strong>|<strong>r</strong>/]<em>fill</em></dt>
-<dd>Set the shade, color, or pattern for lakes and river-lakes [Default
-is the fill chosen for “wet” areas (<strong>-S</strong>)]. Optionally, specify
-separate fills by prepending <strong>l/</strong> for lakes and <strong>r/</strong> for
-river-lakes, repeating the <strong>-C</strong> option as needed.</dd>
-<dt><strong>-D</strong><em>resolution</em>[<strong>+</strong>]</dt>
-<dd>Selects the resolution of the data set to use ((<strong>f</strong>)ull,
-(<strong>h</strong>)igh, (<strong>i</strong>)ntermediate, (<strong>l</strong>)ow, and (<strong>c</strong>)rude). The
-resolution drops off by 80% between data sets [Default is <strong>l</strong>].
-Append <strong>+</strong> to automatically select a lower resolution should the one
-requested not be available [abort if not found].</dd>
-<dt><strong>-F</strong><em>code1,code2,...</em>[<strong>+l</strong>|<strong>L</strong>][<strong>+g</strong><em>fill</em>][<strong>+p</strong><em>pen</em>][<strong>+r</strong>|<strong>R</strong>[<em>incs</em>]]</dt>
-<dd>Select painting or dumping country polygons from the Digital Chart of the World.
-This is another dataset independent of GSHHG and hence the <strong>-A</strong> and <strong>-D</strong> options do not apply.
-Append one or more comma-separated countries using the 2-character
-ISO 3166-1 alpha-2 convention. To select a state of a country
-(if available), append .state, e.g, US.TX for Texas. To specify a
-whole continent, prepend = to any of the continent codes AF (Africa),
-AN (Antarctica), AS (Asia), EU (Europe), OC (Oceania),
-NA (North America), or SA (South America). Append <strong>+l</strong> to
-just list the countries and their codes [no data extraction or plotting takes place].
-Use <strong>+L</strong> to see states/territories for Argentina, Australia, Brazil, Canada, and the US.
-Use <strong>+r</strong> to obtain the bounding box coordinates from the polygon(s).
-Append <em>inc</em>, <em>xinc</em>/<em>yinc</em>, or <em>winc</em>/<em>einc</em>/<em>sinc</em>/<em>ninc</em> to adjust the
-region to be a multiple of these steps [no adjustment]. Use <strong>+R</strong> to extend the region
-outward by adding these increments instead [no extension].
-Append <strong>+p</strong><em>pen</em> to draw polygon outlines [no outline] and
-<strong>+g</strong><em>fill</em> to fill them [no fill]. One of <strong>+p</strong>|<strong>g</strong> must be
-specified unless <strong>+r</strong>, <strong>+R</strong>, or <strong>-M</strong> is in effect, and only one <strong>-F</strong> option can be given.
-To plot multiple countries in different colors, call pscoast multiple times.
-If modifiers <strong>+r</strong> or <strong>+R</strong> are used and neither <strong>-J</strong> nor <strong>-M</strong> is set then
-we just print the <strong>-R</strong><em>wesn</em> string.</dd>
-<dt><strong>-G</strong><em>fill</em>|<strong>c</strong></dt>
-<dd>Select filling or clipping of “dry” areas. Append the shade, color,
-or pattern; or use <strong>-Gc</strong> for clipping [Default is no fill].</dd>
-<dt><strong>-I</strong><em>river</em>[/<em>pen</em>]</dt>
-<dd><p class="first">Draw rivers. Specify the type of rivers and [optionally] append pen
-attributes [Default pen: width = default, color = black, style =
-solid].</p>
-<p>Choose from the list of river types below; repeat option <strong>-I</strong> as
-often as necessary.</p>
-<p>0 = Double-lined rivers (river-lakes)</p>
-<p>1 = Permanent major rivers</p>
-<p>2 = Additional major rivers</p>
-<p>3 = Additional rivers</p>
-<p>4 = Minor rivers</p>
-<p>5 = Intermittent rivers - major</p>
-<p>6 = Intermittent rivers - additional</p>
-<p>7 = Intermittent rivers - minor</p>
-<p>8 = Major canals</p>
-<p>9 = Minor canals</p>
-<p>10 = Irrigation canals</p>
-<p>You can also choose from several preconfigured river groups:</p>
-<p>a = All rivers and canals (0-10)</p>
-<p>A = All rivers and canals except river-lakes (1-10)</p>
-<p>r = All permanent rivers (0-4)</p>
-<p>R = All permanent rivers except river-lakes (1-4)</p>
-<p>i = All intermittent rivers (5-7)</p>
-<p class="last">c = All canals (8-10)</p>
-</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-Jz</strong>|<strong>Z</strong><em>parameters</em> <a class="reference internal" href="gmt.html#jz-full"><em>(more ...)</em></a></dt>
-<dd>Set z-axis scaling; same syntax as <strong>-Jx</strong>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-K</strong> <a class="reference internal" href="gmt.html#k-full"><em>(more ...)</em></a></dt>
-<dd>Do not finalize the PostScript plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-L</strong>[<strong>f</strong>][<strong>x</strong>]<em>lon0</em>/<em>lat0</em>[/<em>slon</em>]/<em>slat</em>/<em>length</em>[<strong>e</strong>|<strong>f</strong>|<strong>k</strong>|<strong>M</strong>|<strong>n</strong>|<strong>u</strong>][<strong>+l</strong><em>label</em>][<strong>+j</strong><em>just</em>][<strong>+p</strong><em>pen</em>][<strong>+g</strong><em>fill</em>][<strong>+u</strong>]</dt>
-<dd>Draws a simple map scale centered on <em>lon0/lat0</em>. Use <strong>-Lx</strong> to
-specify x/y position instead. Scale is calculated at latitude <em>slat</em>
-(optionally supply longitude <em>slon</em> for oblique projections [Default
-is central meridian]), <em>length</em> is in km, or append unit from
-<strong>e</strong>|<strong>f</strong>|<strong>k</strong>|<strong>M</strong>|<strong>n</strong>|<strong>u</strong>. Use
-<strong>-Lf</strong> to get a “fancy” scale [Default is plain]. Append <strong>+l</strong> to
-select the default label which equals the distance unit (meter,
-foot, km, mile, nautical mile, US survey foot) and is justified on
-top of the scale [t]. Change this by giving your own label (append
-<strong>+l</strong><em>label</em>). Change label justification with
-<strong>+j</strong><em>justification</em> (choose among l(eft), r(ight), t(op), and b(ottom)). Apply
-<strong>+u</strong> to append the unit to all distance annotations along the
-scale. If you want to place a rectangle behind the scale, specify
-suitable <strong>+p</strong><em>pen</em> and/or <strong>+g</strong><em>fill</em> parameters. Note:
-Use <a class="reference internal" href="gmt.conf.html#font-label"><em>FONT_LABEL</em></a> to change the label font and <a class="reference internal" href="gmt.conf.html#font-annot-primary"><em>FONT_ANNOT_PRIMARY</em></a>
-to change the annotation font. The height of the map scale is controlled
-by <a class="reference internal" href="gmt.conf.html#map-scale-height"><em>MAP_SCALE_HEIGHT</em></a>.</dd>
-<dt><strong>-M</strong></dt>
-<dd>Dumps a single multisegment ASCII (or binary, see
-<strong>-bo</strong>) file to standard output. No plotting
-occurs. Specify one of <strong>-F</strong>, <strong>-I</strong>, <strong>-N</strong> or <strong>-W</strong>.
-Note: if <strong>-M</strong> is used with <strong>-F</strong> then <strong>-R</strong> or the <strong>+r</strong> modifier
-to <strong>-F</strong> are not required as we automatically determine the region
-given the selected geographic entities.</dd>
-<dt><strong>-N</strong><em>border</em>[/<em>pen</em>]</dt>
-<dd><p class="first">Draw political boundaries. Specify the type of boundary and
-[optionally] append pen attributes [Default pen: width = default,
-color = black, style = solid].</p>
-<p>Choose from the list of boundaries below. Repeat option <strong>-N</strong> as
-often as necessary.</p>
-<p>1 = National boundaries</p>
-<p>2 = State boundaries within the Americas</p>
-<p>3 = Marine boundaries</p>
-<p class="last">a = All boundaries (1-3)</p>
-</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-O</strong> <a class="reference internal" href="gmt.html#o-full"><em>(more ...)</em></a></dt>
-<dd>Append to existing PostScript plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-P</strong> <a class="reference internal" href="gmt.html#p-full"><em>(more ...)</em></a></dt>
-<dd>Select “Portrait” plot orientation.</dd>
-<dt><strong>-Q</strong></dt>
-<dd>Mark end of existing clip path. No projection information is needed.
-Also supply <strong>-X</strong> and <strong>-Y</strong> settings if you have moved since the
-clip started.</dd>
-<dt><strong>-S</strong><em>fill</em>|<strong>c</strong></dt>
-<dd>Select filling or clipping of “wet” areas. Append the shade, color,
-or pattern; or use <strong>-Sc</strong> for clipping [Default is no fill].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-T</strong>[<strong>f</strong>|<strong>m</strong>][<strong>x</strong>]<em>lon0</em>/<em>lat0</em>/<em>size</em>[/<em>info</em>][<strong>:</strong><em>w</em>,<em>e</em>,<em>s</em>,<em>n</em><strong>:</strong>][<strong>+</strong><em>gint</em>[/<em>mint</em>]]</dt>
-<dd>Draws a simple map directional rose centered on <em>lon0/lat0</em>. Use
-<strong>-Tx</strong> to specify x/y position instead. The <em>size</em> is the diameter
-of the rose, and optional label information can be specified to
-override the default values of W, E, S, and N (Give <strong>::</strong> to
-suppress all labels). The default [plain] map rose only labels
-north. Use <strong>-Tf</strong> to get a “fancy” rose, and specify in <em>info</em> what
-you want drawn. The default [<strong>1</strong>] draws the two principal E-W,
-N-S orientations, <strong>2</strong> adds the two intermediate NW-SE and NE-SW
-orientations, while <strong>3</strong> adds the eight minor orientations WNW-ESE,
-NNW-SSE, NNE-SSW, and ENE-WSW. For a magnetic compass rose, specify
-<strong>-Tm</strong>. If given, <em>info</em> must be the two parameters <em>dec/dlabel</em>,
-where <em>dec</em> is the magnetic declination and <em>dlabel</em> is a label for
-the magnetic compass needle (specify <strong>-</strong> to format a label from
-<em>dec</em>). Then, both directions to geographic and magnetic north are
-plotted [Default is geographic only]. If the north label is <strong>*</strong>
-then a north star is plotted instead of the north label. Annotation
-and two levels of tick intervals for both geographic and magnetic
-directions are 30/5/1 degrees; override these settings by appending
-<strong>+</strong><em>gints</em>[/<em>mints</em>]. Color and pen attributes for the rose
-are taken from <strong>COLOR_BACKGROUND</strong> and <strong>MAP_TICK_PEN</strong>,
-respectively, while label fonts, colors and sizes follow
-<strong>FONT_TITLE</strong> for the four major directions and <strong>FONT_LABEL</strong>
-for minor directions.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] <a class="reference internal" href="gmt.html#u-full"><em>(more ...)</em></a></dt>
-<dd>Draw GMT time stamp logo on plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong>[<em>level</em>/]<em>pen</em> <a class="reference internal" href="gmt.html#set-pens"><em>(more ...)</em></a></dt>
-<dd>Draw shorelines [Default is no shorelines]. Append pen attributes
-[Defaults: width = default, color = black, style = solid] which
-apply to all four levels. To set the pen for each level differently,
-prepend <em>level</em>/, where <em>level</em> is 1-4 and represent coastline,
-lakeshore, island-in-lake shore, and lake-in-island-in-lake shore.
-Repeat <strong>-W</strong> as needed. When specific level pens are set, those not
-listed will not be drawn [Default draws all levels; but see <strong>-A</strong>].</dd>
-</dl>
-<p><strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]]</p>
-<dl class="docutils">
-<dt><strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] <a class="reference internal" href="gmt.html#xy-full"><em>(more ...)</em></a></dt>
-<dd>Shift plot origin.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-c</strong><em>copies</em> <a class="reference internal" href="gmt.html#c-full"><em>(more ...)</em></a></dt>
-<dd>Specify number of plot copies [Default is 1].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] <a class="reference internal" href="gmt.html#perspective-full"><em>(more ...)</em></a></dt>
-<dd>Select perspective view. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-t</strong>[<em>transp</em>] <a class="reference internal" href="gmt.html#t-full"><em>(more ...)</em></a></dt>
-<dd>Set PDF transparency level in percent.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To plot a green Africa with white outline on blue background, with
-permanent major rivers in thick blue pen, additional major rivers in
-thin blue pen, and national borders as dashed lines on a Mercator map at
-scale 0.1 inch/degree, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt pscoast -R-30/30/-40/40 -Jm0.1i -B5 -I1/1p,blue -N1/0.25p,- \
- -I2/0.25p,blue -W0.25p,white -Ggreen -Sblue -P > africa.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>To plot Iceland using the lava pattern (# 28) at 100 dots per inch, on a
-Mercator map at scale 1 cm/degree, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt pscoast -R-30/-10/60/65 -Jm1c -B5 -Gp100/28 > iceland.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>To initiate a clip path for Africa so that the subsequent colorimage of
-gridded topography is only seen over land, using a Mercator map at scale
-0.1 inch/degree, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt pscoast -R-30/30/-40/40 -Jm0.1i -B5 -Gc -P -K > africa.ps
-gmt grdimage -Jm0.1i etopo5.nc -Ccolors.cpt -O -K >> africa.ps
-gmt pscoast -Q -O >> africa.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p><strong>pscoast</strong> will first look for coastline files in directory
-<strong>$GMT_SHAREDIR</strong>/coast If the desired file is not found, it will look
-for the file <strong>$GMT_SHAREDIR</strong>/coastline.conf. This file may contain
-any number of records that each holds the full pathname of an
-alternative directory. Comment lines (#) and blank lines are allowed.
-The desired file is then sought for in the alternate directories.</p>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc11">Gshhs Information</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>The coastline database is GSHHG (formerly GSHHS) which is compiled from two sources:
-World Vector Shorelines (WVS) and CIA World Data Bank II (WDBII). In
-particular, all level-1 polygons (ocean-land boundary) are derived from
-the more accurate WVS while all higher level polygons (level 2-4,
-representing land/lake, lake/island-in-lake, and
-island-in-lake/lake-in-island-in-lake boundaries) are taken from WDBII.
-Much processing has taken place to convert WVS and WDBII data into
-usable form for GMT: assembling closed polygons from line segments,
-checking for duplicates, and correcting for crossings between polygons.
-The area of each polygon has been determined so that the user may choose
-not to draw features smaller than a minimum area (see <strong>-A</strong>); one may
-also limit the highest hierarchical level of polygons to be included (4
-is the maximum). The 4 lower-resolution databases were derived from the
-full resolution database using the Douglas-Peucker line-simplification
-algorithm. The classification of rivers and borders follow that of the
-WDBII. See the GMT Cookbook and Technical Reference Appendix K for
-further details.</p>
-</div>
-<div class="section" id="bugs">
-<h2>Bugs<a class="headerlink" href="#bugs" title="Permalink to this headline">¶</a></h2>
-<p>The options to fill (<strong>-C</strong> <strong>-G</strong> <strong>-S</strong>) may not always work if the
-Azimuthal equidistant projection is chosen (<strong>-Je</strong>|<strong>E</strong>). If the
-antipole of the projection is in the oceans it will most likely work. If
-not, try to avoid using projection center coordinates that are even
-multiples of the coastline bin size (1, 2, 5, 10, and 20 degrees for
-<strong>f</strong>, <strong>h</strong>, <strong>i</strong>, <strong>l</strong>, <strong>c</strong>, respectively). This projection is not
-supported for clipping.</p>
-<p>The political borders are for the most part 1970s-style but have been
-updated to reflect more recent border rearrangements in Europe and
-elsewhere. Let us know if you find something out of date.</p>
-<p>The full-resolution coastlines are also from a digitizing effort in the
-1970-80s and it is difficult to assess the accuracy. Users who zoom in
-close enough may find that the GSHHG coastline is not matching other
-data, e.g., satellite images, more recent coastline data, etc. We are
-aware of such mismatches but cannot undertake band-aid solutions each
-time this occurs.</p>
-<p>Some users of <strong>pscoast</strong> will not be satisfied with what they find for
-the Antarctic shoreline. In Antarctica, the boundary between ice and
-ocean varies seasonally and inter-annually. There are some areas of
-permanent sea ice. In addition to these time-varying ice-ocean
-boundaries, there are also ice grounding lines where ice goes from
-floating on the sea to sitting on land, and lines delimiting areas of
-rock outcrop. For consistency’s sake, we have used the World Vector
-Shoreline throughout the world in pscoast, as described in the GMT
-Cookbook Appendix K. Users who need specific boundaries in Antarctica
-should get the Antarctic Digital Database, prepared by the British
-Antarctic Survey, Scott Polar Research Institute, World Conservation
-Monitoring Centre, under the auspices of the Scientific Committee on
-Antarctic Research. This data base contains various kinds of limiting
-lines for Antarctica and is available on CD-ROM. It is published by the
-Scientific Committee on Antarctic Research, Scott Polar Research
-Institute, Lensfield Road, Cambridge CB2 1ER, United Kingdom.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>,
-<a class="reference internal" href="gmtcolors.html"><em>gmtcolors</em></a>,
-<a class="reference internal" href="grdlandmask.html"><em>grdlandmask</em></a>,
-<a class="reference internal" href="psbasemap.html"><em>psbasemap</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">pscoast</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#id1">Gshhs Information</a></li>
-<li><a class="reference internal" href="#bugs">Bugs</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="psclip.html"
- title="previous chapter">psclip</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="pscontour.html"
- title="next chapter">pscontour</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/pscoast.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="pscontour.html" title="pscontour"
- >next</a> </li>
- <li class="right" >
- <a href="psclip.html" title="psclip"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" >PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/pscontour.html b/doc_release/html/pscontour.html
deleted file mode 100644
index 3ecacfa..0000000
--- a/doc_release/html/pscontour.html
+++ /dev/null
@@ -1,553 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>pscontour — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="PS" href="PS.html" />
- <link rel="next" title="pshistogram" href="pshistogram.html" />
- <link rel="prev" title="pscoast" href="pscoast.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="pshistogram.html" title="pshistogram"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="pscoast.html" title="pscoast"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" accesskey="U">PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="pscontour">
-<span id="index-0"></span><h1>pscontour<a class="headerlink" href="#pscontour" title="Permalink to this headline">¶</a></h1>
-<p>pscontour - Contour table data by direct triangulation [method]</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>pscontour</strong> [ <em>table</em> ] <strong>-C</strong>[+]<em>cptfile</em> <strong>-J</strong><em>parameters</em>
-<strong>-R</strong><em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]
-[ <strong>-A</strong>[<strong>-</strong>|[+]<em>annot_int</em>][<em>labelinfo</em>] ]
-[ <strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> ]
-[ <strong>-D</strong>[<em>template</em>] ]
-[ <strong>-G</strong>[<strong>d</strong>|<strong>f</strong>|<strong>n</strong>|<strong>l</strong>|<strong>L</strong>|<strong>x</strong>|<strong>X</strong>]<em>params</em> ]
-[ <strong>-I</strong> ] [ <strong>-Jz</strong>|<strong>Z</strong><em>parameters</em> ] [ <strong>-K</strong> ]
-[ <strong>-L</strong><em>pen</em> ] [ <strong>-N</strong> ] [ <strong>-O</strong> ] [ <strong>-P</strong> ] [ <strong>-Q</strong><em>indexfile</em> ]
-[ <strong>-S</strong>[<em>p</em>|<em>t</em>] ]
-[ <strong>-T</strong>[<strong>+|-</strong>][<em>gap/length</em>][<strong>:</strong>[<em>labels</em>]] ]
-[ <strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] ]
-[ <strong>-V</strong>[<em>level</em>] ] [ <strong>-W</strong>[<strong>+</strong>]<em>pen</em> ]
-[ <strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] ]
-[ <strong>-b</strong>[<strong>i</strong>|<strong>o</strong>][<em>ncol</em>][<strong>type</strong>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-c</strong><em>copies</em> ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] ]
-[ <strong>-t</strong>[<em>transp</em>] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>pscontour</strong> reads an ASCII [or binary] xyz-file and produces a raw
-contour plot by triangulation. By default, the optimal Delaunay
-triangulation is performed (using either Shewchuk’s [1996] or Watson’s
-[1982] method as selected during GMT installation; type <strong>pscontour
--</strong> to see which method is selected), but the user may optionally
-provide a second file with network information, such as a triangular
-mesh used for finite element modeling. In addition to contours, the area
-between contours may be painted according to the color palette file.
-Alternatively, the x/y/z positions of the contour lines may be saved to
-one or more output files (or stdout) and no plot is produced.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-C</strong>[+]<em>cont_int</em></dt>
-<dd><p class="first">The contours to be drawn may be specified in one of three possible ways:</p>
-<ol class="arabic simple">
-<li>If <em>cont_int</em> has the suffix ”.cpt” and can be opened as a
-file, it is assumed to be a color palette table. The color
-boundaries are then used as contour levels. If the cpt-file has
-annotation flags in the last column then those contours will be
-annotated. By default all contours are labeled; use <strong>-A-</strong> to
-disable all annotations.</li>
-<li>If <em>cont_int</em> is a file but not a cpt-file, it is expected to
-contain contour levels in column 1 and a
-C(ontour) OR A(nnotate) in
-col 2. The levels marked C (or c) are contoured, the levels marked A
-(or a) are contoured and annotated. Optionally, a third column may
-be present and contain the fixed annotation angle for this contour
-level.</li>
-<li>If no file is found, then <em>cont_int</em> is interpreted as a
-constant contour interval. However, if prepended with the + sign the
-<em>cont_int</em> is taken as meaning draw that single contour. The <strong>-A</strong>
-option offers the same possibility so they may be used together to
-plot only one annotated and one non-annotated contour.
-If <strong>-A</strong> is set and <strong>-C</strong> is not, then the contour interval is set
-equal to the specified annotation interval.</li>
-</ol>
-<p class="last">If a file is given and <strong>-T</strong> is set, then only contours marked with
-upper case C or A will have tickmarks. In all cases the contour
-values have the same units as the file.</p>
-</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-J</strong><em>parameters</em> <a class="reference internal" href="gmt.html#j-full"><em>(more ...)</em></a></dt>
-<dd>Select map projection.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-</dl>
-<p>For perspective view <strong>p</strong>, optionally append /<em>zmin</em>/<em>zmax</em>. <a class="reference internal" href="gmt.html#rz-full"><em>(more ...)</em></a> </p>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>[<em>ncols</em>][<em>type</em>]) data
-table file(s) holding a number of data columns. If no tables are given
-then we read from standard input. </dd>
-<dt><strong>-A</strong>[<strong>-</strong>|[+]<em>annot_int</em>][<em>labelinfo</em>]</dt>
-<dd><em>annot_int</em> is annotation interval in data units; it is ignored if
-contour levels are given in a file. [Default is no annotations]. Append
-<strong>-</strong> to disable all annotations implied by <strong>-C</strong>. Alternatively prepend
-+ to the annotation interval to plot that as a single contour. The optional
-<em>labelinfo</em> controls the specifics of the label formatting and consists
-of a concatenated string made up of any of the following control arguments:</dd>
-</dl>
-<blockquote>
-<div><dl class="docutils">
-<dt><strong>+a</strong><em>angle</em></dt>
-<dd>For annotations at a fixed angle, <strong>+an</strong> for contour-normal, or
-<strong>+ap</strong> for contour-parallel [Default]. For <strong>+ap</strong>, you may optionally
-append <strong>u</strong> for up-hill and <strong>d</strong> for down-hill cartographic annotations.</dd>
-<dt><strong>+c</strong><em>dx</em>[/<em>dy</em>]</dt>
-<dd>Sets the clearance between label and optional text box. Append
-<strong>c</strong>|<strong>i</strong>|<strong>p</strong> to specify the unit or % to indicate a
-percentage of the label font size [15%].</dd>
-<dt><strong>+d</strong></dt>
-<dd>Turns on debug which will draw helper points and lines to illustrate
-the workings of the contour line setup.</dd>
-<dt><strong>+e</strong></dt>
-<dd>Delay the plotting of the text. This is used to build a clip path
-based on the text, then lay down other overlays while that clip path
-is in effect, then turning of clipping with psclip <strong>-Cs</strong> which
-finally plots the original text.</dd>
-<dt><strong>+f</strong><em>font</em></dt>
-<dd>Sets the desired font [Default <strong>FONT_ANNOT_PRIMARY</strong> with its
-size changed to 9p].</dd>
-<dt><strong>+g</strong>[<em>color</em>]</dt>
-<dd>Selects opaque text boxes [Default is transparent]; optionally
-specify the color [Default is <strong>PS_PAGE_COLOR</strong>].</dd>
-<dt><strong>+j</strong><em>just</em></dt>
-<dd>Sets label justification [Default is MC].</dd>
-<dt><strong>+n</strong><em>dx</em>[/<em>dy</em>]</dt>
-<dd>Nudges the placement of labels by the specified amount (append
-<strong>c</strong>|<strong>i</strong>|<strong>p</strong> to specify the units). Increments
-are considered in the coordinate system defined by the
-orientation of the contour; use <strong>+N</strong> to force increments in the
-plot x/y coordinates system [no nudging]. Not allowed with <strong>+v</strong>.</dd>
-<dt><strong>+o</strong></dt>
-<dd>Selects rounded rectangular text box [Default is rectangular].
-Not applicable for curved text (<strong>+v</strong>) and only makes sense for
-opaque text boxes.</dd>
-<dt><strong>+p</strong>[<em>pen</em>]</dt>
-<dd>Draws the outline of text boxes [Default is no outline];
-optionally specify pen for outline [Default is width = 0.25p,
-color = black, style = solid].</dd>
-<dt><strong>+r</strong><em>min_rad</em></dt>
-<dd>Will not place labels where the contours’s radius of curvature is
-less than <em>min_rad</em> [Default is 0].</dd>
-<dt><strong>+t</strong>[<em>file</em>]</dt>
-<dd>Saves contour label x, y, and text to <em>file</em> [Contour_labels.txt].
-Use <strong>+T</strong> to save x, y, angle, text instead.</dd>
-<dt><strong>+u</strong><em>unit</em></dt>
-<dd>Appends <em>unit</em> to all contour labels. [Default is no unit].
-If <strong>z</strong> is appended we use the z-unit from the grdfile.</dd>
-<dt><strong>+v</strong></dt>
-<dd>Specifies curved labels following the contour [Default is straight
-labels].</dd>
-<dt><strong>+w</strong></dt>
-<dd>Specifies how many (<em>x</em>,<em>y</em>) points will be used to estimate
-label angles [Default is 10].</dd>
-<dt><strong>+=</strong><em>prefix</em></dt>
-<dd>Prepends <em>prefix</em> to all contour labels. [Default is no prefix].</dd>
-</dl>
-</div></blockquote>
-<dl class="docutils">
-<dt><strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> <a class="reference internal" href="gmt.html#b-full"><em>(more ...)</em></a></dt>
-<dd>Set map boundary intervals.</dd>
-</dl>
-<p><strong>-D</strong>[<em>template</em>]</p>
-<p>Dump the (x,y,z) coordinates of each contour to one or more output files
-(or <em>stdout</em> if <em>template</em> is not given). No plotting will take place.
-If <em>template</em> contains one or more of the C-format specifiers %d, %f, %c
-then line segments will be written to different files; otherwise all
-lines are written to the specified file (<em>template</em>). The use of the
-C-format specifiers controls how many files are created and how the
-contours are organized. If the float format %f is present (standard
-modifications to width and precision are allowed, e.g., %f7.3f), then
-the filenames will contain the contour value and lines are thus
-separated into files based on a common contour value. If the integer
-format %d is present (including modifications like %05d), then all
-contours are written to individual segment files; if any of the other
-specifiers are present they just affect the file names. Finally, if the
-character format %c is present it is replaced with the letters C (for
-closed) or O (for open), reflecting the nature of each contour. Any
-combination of one, two, or all three modifiers are valid, resulting in
-different filenames and number of files. For instance, if %c appears by
-itself, then only two files are created, separating the open from the
-closed contours (assuming both kinds are present). If just %f is used,
-then all segments for the same contour level will be written to the same
-file, resulting in <em>N</em> multi-segment files. If both %f and %c were
-combined then each contour level would be further subdivided into closed
-and open contours. Any combination involving %d will result in one
-individual file for each segment; %c, %f only modifies the file names.
-The files are ASCII unless <strong>-bo</strong> is used.</p>
-<p><strong>-G</strong></p>
-<blockquote>
-<div><p>The required argument controls the placement of labels along the quoted
-lines. Choose among five controlling algorithms:</p>
-<dl class="docutils">
-<dt><strong>d</strong><em>dist</em>[<strong>c</strong>|<strong>i</strong>|<strong>p</strong>] or <strong>D</strong><em>dist</em>[<strong>d</strong>|<strong>e</strong>|<strong>f</strong>|<strong>k</strong>|<strong>m</strong>|<strong>M</strong>|<strong>n</strong>|<strong>s</strong>]</dt>
-<dd>For lower case <strong>d</strong>, give distances between labels on the plot
-in your preferred measurement unit <strong>c</strong> (cm), <strong>i</strong> (inch), or
-<strong>p</strong> (points), while for upper case <strong>D</strong>, specify distances in
-map units and append the unit; choose among <strong>e</strong> (m), <strong>f</strong>
-(foot), <strong>k</strong> (km), <strong>M</strong> (mile), <strong>n</strong> (nautical mile) or <strong>u</strong>
-(US survey foot), and <strong>d</strong> (arc degree), <strong>m</strong> (arc minute), or
-<strong>s</strong> (arc second). [Default is 10<strong>c</strong> or 4<strong>i</strong>]. As an
-option, you can append /<em>fraction</em> which is used to place the
-very first label for each contour when the cumulative
-along-contour distance equals <em>fraction * dist</em> [0.25].</dd>
-<dt><strong>f</strong><em>ffile.d</em></dt>
-<dd>Reads the ascii file <em>ffile.d</em> and places labels at locations in
-the file that matches locations along the quoted lines. Inexact
-matches and points outside the region are skipped.</dd>
-<dt><strong>l|L</strong><em>line1</em>[,<em>line2</em>,...]</dt>
-<dd>Give <em>start</em> and <em>stop</em> coordinates for one or more
-comma-separated straight line segments. Labels will be placed
-where these lines intersect the quoted lines. The format of each
-<em>line</em> specification is <em>start/stop</em>, where <em>start</em> and <em>stop</em>
-are either a specified point <em>lon/lat</em> or a 2-character <strong>XY</strong>
-key that uses the justification format employed in <strong>pstext</strong> to
-indicate a point on the map, given as [LCR][BMT].
-In addition, you can use Z-, Z+ to mean the global minimum and
-maximum locations in the grid. <strong>L</strong> will interpret the point pairs
-as defining great circles [Default is straight line].</dd>
-<dt><strong>n</strong><em>n_label</em></dt>
-<dd>Specifies the number of equidistant labels for quoted lines line
-[1]. Upper case <strong>N</strong> starts labeling exactly at the start of
-the line [Default centers them along the line]. <strong>N</strong>-1 places
-one justified label at start, while <strong>N</strong>+1 places one
-justified label at the end of quoted lines. Optionally, append
-/<em>min_dist</em>[<strong>c</strong>|<strong>i</strong>|<strong>p</strong>] to enforce that a
-minimum distance separation between successive labels is
-enforced.</dd>
-<dt><strong>x|X</strong><em>xfile.d</em></dt>
-<dd>Reads the multisegment file <em>xfile.d</em> and places labels at the
-intersections between the quoted lines and the lines in
-<em>xfile.d</em>. <strong>X</strong> will resample the lines first along
-great-circle arcs.</dd>
-</dl>
-<p>In addition, you may optionally append
-<strong>+r</strong><em>radius</em>[<strong>c</strong>|<strong>i</strong>|<strong>p</strong>] to set a minimum
-label separation in the x-y plane [no limitation].</p>
-</div></blockquote>
-<dl class="docutils">
-<dt><strong>-I</strong></dt>
-<dd>Color the triangles using the color palette table.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-Jz</strong>|<strong>Z</strong><em>parameters</em> <a class="reference internal" href="gmt.html#jz-full"><em>(more ...)</em></a></dt>
-<dd>Set z-axis scaling; same syntax as <strong>-Jx</strong>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-K</strong> <a class="reference internal" href="gmt.html#k-full"><em>(more ...)</em></a></dt>
-<dd>Do not finalize the PostScript plot.</dd>
-<dt><strong>-L</strong><em>pen</em> <a class="reference internal" href="gmt.html#set-pens"><em>(more ...)</em></a></dt>
-<dd>Draw the underlying triangular mesh using the specified pen
-attributes [Default is no mesh].</dd>
-<dt><strong>-N</strong></dt>
-<dd>Do NOT clip contours or image at the boundaries [Default will clip
-to fit inside region <strong>-R</strong>].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-O</strong> <a class="reference internal" href="gmt.html#o-full"><em>(more ...)</em></a></dt>
-<dd>Append to existing PostScript plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-P</strong> <a class="reference internal" href="gmt.html#p-full"><em>(more ...)</em></a></dt>
-<dd>Select “Portrait” plot orientation.</dd>
-<dt><strong>-Q</strong><em>indexfile</em></dt>
-<dd>Give name of file with network information. Each record must contain
-triplets of node numbers for a triangle [Default computes these
-using Delaunay triangulation (see <strong>triangulate</strong>)].</dd>
-<dt><strong>-S</strong>[<em>p</em>|<em>t</em>]</dt>
-<dd>Skip all input <em>xyz</em> points that fall outside the region [Default
-uses all the data in the triangulation]. Alternatively, use <strong>-St</strong>
-to skip triangles whose three vertices are all outside the region.
-<strong>-S</strong> with no modifier is interpreted as <strong>-Sp</strong>.</dd>
-<dt><strong>-T</strong>[<strong>+|-</strong>][<em>gap/length</em>][<strong>:</strong>[<em>labels</em>]]</dt>
-<dd>Will draw tickmarks pointing in the downward direction every <em>gap</em>
-along the innermost closed contours. Append <em>gap</em> and tickmark
-length (append units as <strong>c</strong>, <strong>i</strong>, or <strong>p</strong>) or use defaults
-[15<strong>p</strong>/3<strong>p</strong>]. User may choose to tick only local highs or local
-lows by specifying <strong>-T+</strong> or <strong>-T-</strong>, respectively. Append
-<strong>:</strong><em>labels</em> to annotate the centers of closed innermost contours
-(i.e, the local lows and highs). If no <em>labels</em> is appended we use -
-and + as the labels. Appending two characters, <strong>:LH</strong>, will plot
-the two characters (here, L and H) as labels. For more elaborate
-labels, separate the two label strings by a comma (e.g.,
-<strong>:</strong><em>lo</em>,<em>hi</em>). If a file is given by <strong>-C</strong> and <strong>-T</strong> is set,
-then only contours marked with upper case C or A will have tickmarks
-[and annotation].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] <a class="reference internal" href="gmt.html#u-full"><em>(more ...)</em></a></dt>
-<dd>Draw GMT time stamp logo on plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong>[<strong>+</strong>]<em>pen</em> <a class="reference internal" href="gmt.html#set-pens"><em>(more ...)</em></a></dt>
-<dd>Select contouring and set contour pen attributes. If the <strong>+</strong> flag
-is prepended then the color of the contour lines are taken from the
-cpt file (see <strong>-C</strong>). If the <strong>-</strong> flag is prepended then the color
-from the cpt file is applied both to the contours and the contour
-annotations.</dd>
-</dl>
-<p><strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]]</p>
-<dl class="docutils">
-<dt><strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] <a class="reference internal" href="gmt.html#xy-full"><em>(more ...)</em></a></dt>
-<dd>Shift plot origin.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 3 input columns]. Use 4-byte integer triplets for node ids (<strong>-Q</strong>).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. [Default is 3 output columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-c</strong><em>copies</em> <a class="reference internal" href="gmt.html#c-full"><em>(more ...)</em></a></dt>
-<dd>Specify number of plot copies [Default is 1].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] <a class="reference internal" href="gmt.html#perspective-full"><em>(more ...)</em></a></dt>
-<dd>Select perspective view. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-t</strong>[<em>transp</em>] <a class="reference internal" href="gmt.html#t-full"><em>(more ...)</em></a></dt>
-<dd>Set PDF transparency level in percent.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To make a raw contour plot from the file topo.xyz and drawing the
-contours (pen = 2) given in the color palette file topo.cpt on a Lambert
-map at 0.5 inch/degree along the standard parallels 18 and 24, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt pscontour topo.xyz -R320/330/20/30 -Jl18/24/0.5i -Ctopo.cpt -W0.5p > topo.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>To create a color PostScript plot of the numerical temperature
-solution obtained on a triangular mesh whose node coordinates and
-temperatures are stored in temp.xyz and mesh arrangement is given by the
-file mesh.ijk, using the colors in temp.cpt, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt pscontour temp.xyz -R0/150/0/100 -Jx0.1i -Ctemp.cpt -G -W0.25p > temp.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>To save the triangulated 100-m contour lines in topo.txt and separate
-them into multisegment files (one for each contour level), try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt pscontour topo.txt -C100 -Dcontours_%.0f.txt
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>,
-<a class="reference internal" href="gmtcolors.html"><em>gmtcolors</em></a>,
-<a class="reference internal" href="grdcontour.html"><em>grdcontour</em></a>,
-<a class="reference internal" href="grdimage.html"><em>grdimage</em></a>,
-<a class="reference internal" href="nearneighbor.html"><em>nearneighbor</em></a>,
-<a class="reference internal" href="psbasemap.html"><em>psbasemap</em></a>, <a class="reference internal" href="psscale.html"><em>psscale</em></a>,
-<a class="reference internal" href="surface.html"><em>surface</em></a>,
-<a class="reference internal" href="triangulate.html"><em>triangulate</em></a></p>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>Watson, D. F., 1982, Acord: Automatic contouring of raw data, <em>Comp. &
-Geosci.</em>, <strong>8</strong>, 97-101.</p>
-<p>Shewchuk, J. R., 1996, Triangle: Engineering a 2D Quality Mesh Generator
-and Delaunay Triangulator, First Workshop on Applied Computational
-Geometry (Philadelphia, PA), 124-133, ACM, May 1996.</p>
-<p><a class="reference external" href="http://www.cs.cmu.edu/~quake/triangle.html">http://www.cs.cmu.edu/~quake/triangle.html</a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">pscontour</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="pscoast.html"
- title="previous chapter">pscoast</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="pshistogram.html"
- title="next chapter">pshistogram</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/pscontour.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="pshistogram.html" title="pshistogram"
- >next</a> </li>
- <li class="right" >
- <a href="pscoast.html" title="pscoast"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" >PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/pshistogram.html b/doc_release/html/pshistogram.html
deleted file mode 100644
index 85f85dd..0000000
--- a/doc_release/html/pshistogram.html
+++ /dev/null
@@ -1,375 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>pshistogram — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="PS" href="PS.html" />
- <link rel="next" title="psimage" href="psimage.html" />
- <link rel="prev" title="pscontour" href="pscontour.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="psimage.html" title="psimage"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="pscontour.html" title="pscontour"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" accesskey="U">PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="pshistogram">
-<span id="index-0"></span><h1>pshistogram<a class="headerlink" href="#pshistogram" title="Permalink to this headline">¶</a></h1>
-<p>pshistogram - Calculate and plot histograms</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>pshistogram</strong> [ <em>table</em> ] <strong>-Jx</strong>|<strong>X</strong><em>parameters</em>
-<strong>-W</strong><em>bin_width</em> [ <strong>-A</strong> ]
-[ <strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> ]
-[ <strong>-C</strong><em>cptfile</em> ] [ <strong>-D</strong>[<strong>+b</strong>][<strong>+f</strong><em>font</em>][<strong>+o</strong><em>off</em>][<strong>+r</strong>] ]
-[ <strong>-F</strong> ] [ <strong>-G</strong><em>fill</em> ] [ <strong>-Jz</strong>|<strong>Z</strong><em>parameters</em> ]
-[ <strong>-I</strong>[<strong>o</strong>|<strong>O</strong>] ] [ <strong>-K</strong> ] [ <strong>-L</strong><em>pen</em> ]
-[ <strong>-N</strong>[<em>mode</em>][<strong>+p</strong><em>pen</em>] ] [ <strong>-O</strong> ] [<strong>-P</strong> ] [ <strong>-Q</strong> ]
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ]
-[ <strong>-S</strong> ]
-[ <strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Z</strong><em>type</em> ]
-[ <strong>-bi</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-c</strong><em>copies</em> ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] ]
-[ <strong>-t</strong>[<em>transp</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>pshistogram</strong> reads <em>file</em> [or standard input] and examines the first
-data column (or use <strong>-i</strong>) to calculate histogram parameters based on
-the bin-width provided. Using these parameters, scaling, and optional
-range parameters it will generate PostScript code that plots a
-histogram. A cumulative histogram may also be specified.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-Jx</strong></dt>
-<dd><em>xscale[/yscale]</em> (Linear scale(s) in distance unit/data unit).</dd>
-<dt><strong>-W</strong><em>bin_width</em></dt>
-<dd>Sets the bin width used for histogram calculations.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>[<em>ncols</em>][<em>type</em>]) data
-table file(s) holding a number of data columns. If no tables are given
-then we read from standard input. </dd>
-<dt><strong>-A</strong></dt>
-<dd>Plot the histogram horizontally from x = 0 [Default is vertically
-from y = 0].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> <a class="reference internal" href="gmt.html#b-full"><em>(more ...)</em></a></dt>
-<dd>Set map boundary intervals.</dd>
-<dt><strong>-C</strong><em>cptfile</em></dt>
-<dd>Give a color palette file. The mid x-value for each bar is used to
-look-up the bar color.</dd>
-<dt><strong>-D</strong>[<strong>+b</strong>][<strong>+f</strong><em>font</em>][<strong>+o</strong><em>off</em>][<strong>+r</strong>]</dt>
-<dd>Annotate each bar with the count it represents. Append any of the
-following modifiers: Use <strong>+b</strong> to place the labels beneath the bars
-instead of above; use <strong>+f</strong> to change to another font than the default
-annotation font; use <strong>+o</strong> to change the offset between bar and label [6p];
-use <strong>+r</strong> to rotate the labels from horizontal to vertical.</dd>
-<dt><strong>-F</strong></dt>
-<dd>Center bin on each value. [Default is left edge].</dd>
-<dt><strong>-G</strong><em>fill</em></dt>
-<dd>Select filling of bars [Default is no fill].</dd>
-<dt><strong>-I</strong>[<strong>o</strong>|<strong>O</strong>]</dt>
-<dd>Inquire about min/max x and y after binning. The <em>xmin xmax ymin
-ymax</em> is output; no plotting is done. Append <strong>o</strong> to output an
-ASCII table of the resulting x,y data instead. Upper case <strong>O</strong> will
-output all x,y bin data even when y == 0.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-Jz</strong>|<strong>Z</strong><em>parameters</em> <a class="reference internal" href="gmt.html#jz-full"><em>(more ...)</em></a></dt>
-<dd>Set z-axis scaling; same syntax as <strong>-Jx</strong>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-K</strong> <a class="reference internal" href="gmt.html#k-full"><em>(more ...)</em></a></dt>
-<dd>Do not finalize the PostScript plot.</dd>
-<dt><strong>-L</strong><em>pen</em></dt>
-<dd>Draw bar outline using the specified pen thickness. [Default is no outline].</dd>
-<dt><strong>-N</strong>[<em>mode</em>][<strong>+p</strong><em>pen</em>]</dt>
-<dd><p class="first">Draw the equivalent normal distribution; append desired pen [0.5p,black].
-The <em>mode</em> selects which central location and scale to use:</p>
-<ul class="simple">
-<li>0 = mean and standard deviation [Default];</li>
-<li>1 = median and L1 scale;</li>
-<li>2 = LMS mode and scale.</li>
-</ul>
-<p class="last">The <strong>-N</strong> option may be repeated to draw several of these curves.</p>
-</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-O</strong> <a class="reference internal" href="gmt.html#o-full"><em>(more ...)</em></a></dt>
-<dd>Append to existing PostScript plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-P</strong> <a class="reference internal" href="gmt.html#p-full"><em>(more ...)</em></a></dt>
-<dd>Select “Portrait” plot orientation.</dd>
-<dt><strong>-Q</strong></dt>
-<dd>Draw a cumulative histogram.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-</dl>
-<p>For perspective view <strong>p</strong>, optionally append /<em>zmin</em>/<em>zmax</em>. <a class="reference internal" href="gmt.html#rz-full"><em>(more ...)</em></a> If not given, <strong>pshistogram</strong> will automatically find reasonable values for the region.</p>
-<dl class="docutils">
-<dt><strong>-S</strong></dt>
-<dd>Draws a stairs-step diagram which does not include the internal bars
-of the default histogram.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] <a class="reference internal" href="gmt.html#u-full"><em>(more ...)</em></a></dt>
-<dd>Draw GMT time stamp logo on plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<p><strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]]</p>
-<dl class="docutils">
-<dt><strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] <a class="reference internal" href="gmt.html#xy-full"><em>(more ...)</em></a></dt>
-<dd>Shift plot origin.</dd>
-<dt><strong>-Z</strong><em>type</em></dt>
-<dd><p class="first">Choose between 6 types of histograms:</p>
-<ul class="last simple">
-<li>0 = counts [Default]</li>
-<li>1 = frequency_percent</li>
-<li>2 = log (1.0 + count)</li>
-<li>3 = log (1.0 + frequency_percent)</li>
-<li>4 = log10 (1.0 + count)</li>
-<li>5 = log10 (1.0 + frequency_percent).</li>
-</ul>
-</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 2 input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-c</strong><em>copies</em> <a class="reference internal" href="gmt.html#c-full"><em>(more ...)</em></a></dt>
-<dd>Specify number of plot copies [Default is 1].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] <a class="reference internal" href="gmt.html#perspective-full"><em>(more ...)</em></a></dt>
-<dd>Select perspective view. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-t</strong>[<em>transp</em>] <a class="reference internal" href="gmt.html#t-full"><em>(more ...)</em></a></dt>
-<dd>Set PDF transparency level in percent.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To draw a histogram of the data v3206.t containing seafloor depths,
-using a 250 meter bin width, center bars, and draw bar outline, use:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt pshistogram v3206.t -JXh -W250 -F -LP0.5p -V > plot.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>If you know the distribution of your data, you may explicitly specify
-range and scales. E.g., to plot a histogram of the y-values (2nd column)
-in the file errors.xy using a 1 meter bin width, plot from -10 to +10
-meters @ 0.75 cm/m, annotate every 2 m and 100 counts, and use black
-bars, run:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt pshistogram errors.xy -W1 -R-10/10/0/0 -Jxc/0.01c \
- -B2:Error:/100:Counts: -Gblack -i1 -V > plot.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>Since no y-range was specified, pshistogram will calculate ymax in even
-increments of 100.</p>
-</div>
-<div class="section" id="bugs">
-<h2>Bugs<a class="headerlink" href="#bugs" title="Permalink to this headline">¶</a></h2>
-<p>The <strong>-W</strong> option does not yet work properly with time series data
-(e.g., <strong>-f</strong>0T). Thus, such variable intervals as months and years
-are not calculated. Instead, specify your interval in the same units as
-the current setting of <strong>TIME_UNIT</strong>.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="gmtcolors.html"><em>gmtcolors</em></a>,
-<a class="reference internal" href="psbasemap.html"><em>psbasemap</em></a>, <a class="reference internal" href="psrose.html"><em>psrose</em></a>,
-<a class="reference internal" href="psxy.html"><em>psxy</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">pshistogram</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#bugs">Bugs</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="pscontour.html"
- title="previous chapter">pscontour</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="psimage.html"
- title="next chapter">psimage</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/pshistogram.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="psimage.html" title="psimage"
- >next</a> </li>
- <li class="right" >
- <a href="pscontour.html" title="pscontour"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" >PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/psimage.html b/doc_release/html/psimage.html
deleted file mode 100644
index 5e3ac4b..0000000
--- a/doc_release/html/psimage.html
+++ /dev/null
@@ -1,361 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>psimage — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="PS" href="PS.html" />
- <link rel="next" title="pslegend" href="pslegend.html" />
- <link rel="prev" title="pshistogram" href="pshistogram.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="pslegend.html" title="pslegend"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="pshistogram.html" title="pshistogram"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" accesskey="U">PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="psimage">
-<span id="index-0"></span><h1>psimage<a class="headerlink" href="#psimage" title="Permalink to this headline">¶</a></h1>
-<p>psimage - Place images or EPS files on maps</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>psimage</strong> <em>imagefile</em> [ <strong>-W</strong>[<strong>-</strong>]<em>width</em>[/<em>height</em>] |
-<strong>-E</strong><em>dpi</em> ] [ <strong>-C</strong><em>xpos</em>/<em>ypos</em>[/<em>justify</em>] ] [ <strong>-F</strong><em>pen</em>
-] [ <strong>-G</strong>[<strong>b</strong>|<strong>f</strong>|<strong>t</strong>]<em>color</em> ] [ <strong>-I</strong> ] [
-<strong>-J</strong><em>parameters</em> ] [ <strong>-Jz</strong>|<strong>Z</strong><em>parameters</em> ] [ <strong>-K</strong> ] [
-<strong>-M</strong> ] [ <strong>-N</strong><em>nx</em>[/<em>ny</em>] ] [ <strong>-O</strong> ] [ <strong>-P</strong> ] [
-<strong>-R</strong><em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>] ] [
-<strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] ] [ <strong>-V</strong>[<em>level</em>]
-] [
-<strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]]
-] [
-<strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]]
-] [ <strong>-c</strong><em>copies</em> ] [
-<strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>]
-] [ <strong>-t</strong>[<em>transp</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>psimage</strong> reads an Encapsulated PostScript file or a raster image
-file and plots it on a map. The image can be scaled arbitrarily, and
-1-bit raster images can be (1) inverted, i.e., black
-pixels (on) becomes white (off) and vice versa, or
-(2) colorized, by assigning different foreground and
-background colors, and (3) made transparent where one of
-back- or foreground is painted only. As an option, the user may choose
-to convert colored raster images to grayscale using TV’s
-YIQ-transformation. For raster files, the user can select which color to
-be made transparent. The user may also choose to replicate the image
-which, when preceded by appropriate clip paths, may allow larger
-custom-designed fill patterns to be implemented (the <strong>-Gp</strong> mechanism
-offered in most GMT programs is limited to rasters smaller than 146
-by 146).</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>imagefile</em></dt>
-<dd>This must be an Encapsulated PostScript (EPS) file or a raster
-image. An EPS file must contain an appropriate BoundingBox. A raster
-file can have a depth of 1, 8, 24, or 32 bits and is read via GDAL.
-If GDAL was not configured during GMT installation then only
-Sun raster files are supported natively.</dd>
-<dt><strong>-E</strong><em>dpi</em></dt>
-<dd>Sets the dpi of the image in dots per inch, or use <strong>-W</strong>.</dd>
-<dt><strong>-W</strong>[<strong>-</strong>]<em>width</em>[/<em>height</em>]</dt>
-<dd>Sets the width (and height) of the image in plot coordinates
-(inches, cm, etc.). If <em>height</em> is not given, the original aspect
-ratio of the image is maintained. If <em>width</em> is negative we use the
-absolute value and interpolate image to the device resolution using
-the PostScript image operator. Alternatively, use <strong>-E</strong>.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-C</strong><em>xpos</em>/<em>ypos</em>[/<em>justify</em>]</dt>
-<dd>Sets position of the image in plot coordinates (inches, cm, etc.)
-from the current origin of the plot. By default, this defines the
-position of the lower left corner of the image, but this can be
-changed by specifying justification [0/0/BL].</dd>
-<dt><strong>-F</strong><em>pen</em></dt>
-<dd>Draws a rectangular frame around the image with the given pen [no
-frame].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-J</strong><em>parameters</em> <a class="reference internal" href="gmt.html#j-full"><em>(more ...)</em></a></dt>
-<dd>Select map projection.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-Jz</strong>|<strong>Z</strong><em>parameters</em> <a class="reference internal" href="gmt.html#jz-full"><em>(more ...)</em></a></dt>
-<dd>Set z-axis scaling; same syntax as <strong>-Jx</strong>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-K</strong> <a class="reference internal" href="gmt.html#k-full"><em>(more ...)</em></a></dt>
-<dd>Do not finalize the PostScript plot.</dd>
-<dt><strong>-M</strong></dt>
-<dd>Convert color image to monochrome grayshades using the (television)
-YIQ-transformation.</dd>
-<dt><strong>-N</strong><em>nx</em>[/<em>ny</em>]</dt>
-<dd>Replicate the image <em>nx</em> times horizontally and <em>ny</em> times
-vertically. If <em>ny</em> is omitted, it will be identical to <em>nx</em>
-[Default is 1/1].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-O</strong> <a class="reference internal" href="gmt.html#o-full"><em>(more ...)</em></a></dt>
-<dd>Append to existing PostScript plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-P</strong> <a class="reference internal" href="gmt.html#p-full"><em>(more ...)</em></a></dt>
-<dd>Select “Portrait” plot orientation.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. (Used only with <strong>-p</strong>)</dd>
-</dl>
-<p>For perspective view <strong>p</strong>, optionally append /<em>zmin</em>/<em>zmax</em>. <a class="reference internal" href="gmt.html#rz-full"><em>(more ...)</em></a> </p>
-<dl class="docutils">
-<dt><strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] <a class="reference internal" href="gmt.html#u-full"><em>(more ...)</em></a></dt>
-<dd>Draw GMT time stamp logo on plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<p><strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]]</p>
-<dl class="docutils">
-<dt><strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] <a class="reference internal" href="gmt.html#xy-full"><em>(more ...)</em></a></dt>
-<dd>Shift plot origin.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-c</strong><em>copies</em> <a class="reference internal" href="gmt.html#c-full"><em>(more ...)</em></a></dt>
-<dd>Specify number of plot copies [Default is 1].</dd>
-</dl>
-<p>These options are for 1-bit images only. They have no effect when
-plotting other images or PostScript files.</p>
-<dl class="docutils">
-<dt><strong>-G</strong>[<strong>b</strong>|<strong>f</strong>|<strong>t</strong>]<em>color</em></dt>
-<dd><dl class="first last docutils">
-<dt><strong>-Gb</strong></dt>
-<dd>Sets background color (replace white pixel) of 1-bit images. Use -
-for transparency (and set <strong>-Gf</strong> to the desired color).</dd>
-<dt><strong>-Gf</strong></dt>
-<dd>Sets foreground color (replace black pixel) of 1-bit images. Use -
-for transparency (and set <strong>-Gb</strong> to the desired color).</dd>
-<dt><strong>-I</strong></dt>
-<dd>Invert 1-bit image before plotting. This is what is done when you
-use <strong>-GP</strong> in other GMT programs.</dd>
-</dl>
-</dd>
-</dl>
-<p>These options are for 8-, 24-, and 32-bit raster images only. They have
-no effect when plotting 1-bit images or PostScript files.</p>
-<dl class="docutils">
-<dt><strong>-Gt</strong></dt>
-<dd>Assigns the color that is to be made transparent. Sun Raster files
-do not support transparency, so indicate here which color to be made
-transparent.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] <a class="reference internal" href="gmt.html#perspective-full"><em>(more ...)</em></a></dt>
-<dd>Select perspective view. (Requires <strong>-R</strong> and <strong>-J</strong> for proper functioning).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-t</strong>[<em>transp</em>] <a class="reference internal" href="gmt.html#t-full"><em>(more ...)</em></a></dt>
-<dd>Set PDF transparency level in percent.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To plot the image contained in the 8-bit raster file scanned_face.ras,
-scaling it to 8 by 10 cm (thereby possibly changing the aspect ratio),
-and making the white color transparent, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psimage scanned_face.ras -W8c/10c -Gtwhite > image.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>To plot the image logo.jpg, scaling it be 1 inch wide (height is scaled
-accordingly), and outline with a thin, blue pen, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psimage logo.jpg -W1i -Fthin,blue > image.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>To include an Encapsulated PostScript file tiger.eps with its upper
-right corner 2 inch to the right and 1 inch up from the current
-location, and have its width scaled to 3 inches, while keeping the
-aspect ratio, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psimage tiger.eps -C2i/1i/TR -W3i > image.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>To replicate the 1-bit raster image template 1_bit.ras, colorize it
-(brown background and red foreground), and setting each of 5 by 5 tiles
-to be 1 cm wide, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psimage 1_bit.ras -Gbbrown -Gfred -N5 -W1c > image.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="gmtcolors.html"><em>gmtcolors</em></a>,
-<a class="reference internal" href="psxy.html"><em>psxy</em></a>,
-<em class="manpage">convert(1)</em></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">psimage</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="pshistogram.html"
- title="previous chapter">pshistogram</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="pslegend.html"
- title="next chapter">pslegend</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/psimage.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="pslegend.html" title="pslegend"
- >next</a> </li>
- <li class="right" >
- <a href="pshistogram.html" title="pshistogram"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" >PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/pslegend.html b/doc_release/html/pslegend.html
deleted file mode 100644
index 382677a..0000000
--- a/doc_release/html/pslegend.html
+++ /dev/null
@@ -1,471 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>pslegend — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="PS" href="PS.html" />
- <link rel="next" title="pslib" href="pslib.html" />
- <link rel="prev" title="psimage" href="psimage.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="pslib.html" title="pslib"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="psimage.html" title="psimage"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" accesskey="U">PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="pslegend">
-<span id="index-0"></span><h1>pslegend<a class="headerlink" href="#pslegend" title="Permalink to this headline">¶</a></h1>
-<p>pslegend - Plot legends on maps</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>pslegend</strong> [ <em>textfile</em> ]
-<strong>-D</strong>[<strong>x</strong>]<em>lon</em>/<em>lat</em>/<em>width</em>[/<em>height</em>]/<em>just</em>[/<em>dx</em>/<em>dy</em>]
-[ <strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> ] [ <strong>-C</strong><em>dx</em>/<em>dy</em> ] [
-<strong>-F</strong>[<strong>+g</strong><em>fill</em>][<strong>+i</strong>[[<em>gap</em>/]*pen*]][<strong>+p</strong>[<em>pen</em>]][<strong>+r</strong>[<em>radius</em>]][<strong>+s</strong>[[<em>dx</em>/<em>dy</em>/][<em>shade</em>]]] ] [
-<strong>-J</strong><em>parameters</em> ] [ <strong>-K</strong> ] [ <strong>-L</strong><em>spacing</em> ] [ <strong>-O</strong> ] [
-<strong>-P</strong> ] [ <strong>-R</strong><em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[<strong>r</strong>] ] [
-<strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] ] [ <strong>-V</strong>[<em>level</em>]
-] [
-<strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]]
-] [
-<strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]]
-] [ <strong>-c</strong><em>copies</em> ] [
-<strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>]
-] [ <strong>-t</strong>[<em>transp</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>pslegend</strong> will make legends that can be overlaid on maps. It reads
-specific legend-related information from an input file [or stdin].
-Unless otherwise noted, annotations will be made using the primary
-annotation font and size in effect (i.e., FONT_ANNOT_PRIMARY)</p>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc4">Required Arguments</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-D</strong>[<strong>x</strong>]<em>lon</em>/<em>lat</em>/<em>width</em>[/<em>height</em>]/<em>just</em>[/<em>dx</em>/<em>dy</em>]</dt>
-<dd>Positions the legend and specifies its size. The <em>just</em> is a 2-char
-justification string (see <a class="reference internal" href="pstext.html"><em>pstext</em></a>) that relates the given
-position to a point on the rectangular legend box. If you want to
-specify the position in map plot units (i.e., inches or cm), use
-<strong>-Dx</strong>; in that case the <strong>-R</strong> and <strong>-J</strong> are optional (provided
-it is an overlay, i.e., we are using <strong>-O</strong>). Use to optional
-<em>dx</em>/<em>dy</em> to shift the legend by that amount in the direction
-implied by the justification. If <em>height</em> is zero or not given then
-we estimate <em>height</em> based the expected vertical extent of the items
-to be placed.</dd>
-</dl>
-</div>
-<div class="section" id="id2">
-<h2><a class="reference external" href="#toc5">Optional Arguments</a><a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> <a class="reference internal" href="gmt.html#b-full"><em>(more ...)</em></a></dt>
-<dd>Set map boundary intervals.</dd>
-<dt><strong>-C</strong><em>dx</em>/<em>dy</em></dt>
-<dd>Sets the clearance between the legend frame and the internal items
-[4<strong>p</strong>/4<strong>p</strong>].</dd>
-<dt><strong>-F</strong>[<strong>+g</strong><em>fill</em>][<strong>+i</strong>[[<em>gap</em>/]*pen*]][<strong>+p</strong>[<em>pen</em>]][<strong>+r</strong>[<em>radius</em>]][<strong>+s</strong>[[<em>dx</em>/<em>dy</em>/][<em>shade</em>]]]</dt>
-<dd>Without further options, draws a rectangular border around the legend using
-<strong>MAP_FRAME_PEN</strong>; specify a different pen with <strong>+p</strong><em>pen</em>.
-Add <strong>+g</strong><em>fill</em> to fill the legend box [no fill]
-Append <strong>+i</strong> to draw a secondary, inner border as well. We use a
-<em>gap</em> between borders of 2<strong>p</strong> and the <strong>MAP_DEFAULTS_PEN</strong>
-unless other values are specified. Append <strong>+r</strong> to draw rounded
-rectangular borders instead, with a 6<strong>p</strong> corner radius. You can
-override this radius by appending another value. Finally, append
-<strong>+s</strong> to draw an offset background shaded region. Here, <em>dx</em>/<em>dy</em>
-indicates the shift relative to the foreground frame
-[4<strong>p</strong>/-4<strong>p</strong>] and <em>shade</em> sets the fill style to use for shading.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-J</strong><em>parameters</em> <a class="reference internal" href="gmt.html#j-full"><em>(more ...)</em></a></dt>
-<dd>Select map projection.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-K</strong> <a class="reference internal" href="gmt.html#k-full"><em>(more ...)</em></a></dt>
-<dd>Do not finalize the PostScript plot.</dd>
-<dt><strong>-L</strong><em>spacing</em></dt>
-<dd>Sets the linespacing factor in units of the current annotation font size [1.1].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-O</strong> <a class="reference internal" href="gmt.html#o-full"><em>(more ...)</em></a></dt>
-<dd>Append to existing PostScript plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-P</strong> <a class="reference internal" href="gmt.html#p-full"><em>(more ...)</em></a></dt>
-<dd>Select “Portrait” plot orientation.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] <a class="reference internal" href="gmt.html#u-full"><em>(more ...)</em></a></dt>
-<dd>Draw GMT time stamp logo on plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<p><strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]]</p>
-<dl class="docutils">
-<dt><strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] <a class="reference internal" href="gmt.html#xy-full"><em>(more ...)</em></a></dt>
-<dd>Shift plot origin.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-c</strong><em>copies</em> <a class="reference internal" href="gmt.html#c-full"><em>(more ...)</em></a></dt>
-<dd>Specify number of plot copies [Default is 1].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] <a class="reference internal" href="gmt.html#perspective-full"><em>(more ...)</em></a></dt>
-<dd>Select perspective view. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-t</strong>[<em>transp</em>] <a class="reference internal" href="gmt.html#t-full"><em>(more ...)</em></a></dt>
-<dd>Set PDF transparency level in percent.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="id3">
-<h2><a class="reference external" href="#toc6">Pslegend Codes</a><a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>textfile</em></dt>
-<dd>This file contains instruction for the layout of items in the
-legend. Each legend item is described by a unique record. All
-records begin with a unique character that is common to all records
-of the same kind. The order of the legend items is implied by the
-order of the records. Ten different record types are recognized, and
-the syntax for each of these records are presented below:</dd>
-<dt><strong>#</strong> <em>comment</em></dt>
-<dd>Records starting with # and blank lines are skipped.</dd>
-<dt><strong>B</strong> <em>cptname offset height</em> [ <em>optional arguments</em> ]</dt>
-<dd>The <strong>B</strong> record will plot a horizontal color bar, <strong>psscale</strong>-style
-in the middle, starting at <em>offset</em> from the left edge, and of the
-given <em>height</em>. You may add any additional <strong>psscale</strong> options from
-the list: <strong>-A</strong> <strong>-B</strong> <strong>-I</strong> <strong>-L</strong> <strong>-M</strong> <strong>-N</strong> <strong>-S</strong> <strong>-Z</strong>
-and <strong>-p</strong>. See the <strong>psscale</strong> man page for details.</dd>
-<dt><strong>C</strong> <em>textcolor</em></dt>
-<dd>The <strong>C</strong> record specifies the color with which the remaining text
-is to be printed. <em>textcolor</em> can be in the form <em>r/g/b</em>, <em>c/m/y/k</em>,
-or a named color. Use <strong>-</strong> to reset to default color.</dd>
-<dt><strong>D</strong> <em>offset pen</em></dt>
-<dd>The <strong>D</strong> record results in a horizontal line with specified <em>pen</em>
-across the legend with one quarter of the line spacing left blank
-above and below the line. Two gaps of <em>offset</em> units are left blank
-between the horizontal line and the left and right frame sides. If
-no pen is given we use MAP_GRID_PEN_PRIMARY</dd>
-<dt><strong>G</strong> <em>gap</em></dt>
-<dd>The <strong>G</strong> record specifies a vertical gap of the given length. In
-addition to the standard units (<strong>i</strong>, <strong>c</strong>, <strong>p</strong>) you may use
-<strong>l</strong> for lines. A negative <em>gap</em> will move the current line upwards (thus closing a gap).</dd>
-<dt><strong>H</strong> <em>fontsize</em>|<strong>-</strong> <em>font</em>|<strong>-</strong> header)</dt>
-<dd>The <strong>H</strong> record plots a centered text string using the specified
-font parameters. Use <strong>-</strong> to default to size and type of <strong>FONT_TITLE</strong>.</dd>
-<dt><strong>I</strong> <em>imagefile width justification</em></dt>
-<dd>Place an EPS or Sun raster image in the legend justified relative to
-the current point. The image <em>width</em> determines the size of the image on the page.</dd>
-<dt><strong>L</strong> <em>fontsize</em>|<strong>-</strong> <em>font</em>|<strong>-</strong> justification label)</dt>
-<dd>The <strong>L</strong> record plots a (L)eft, (C)entered, or (R)ight-justified
-text string within a column using the specified font parameters. Use
-<strong>-</strong> to default to the size and type of <strong>FONT_LABEL</strong>.</dd>
-<dt><strong>M</strong> <em>slon</em>|<strong>-</strong> <em>slat length</em> <strong>f</strong>|<strong>p</strong> [ <strong>-R</strong><em>w/e/s/n</em> <strong>-J</strong><em>param</em> ]</dt>
-<dd>Place a map scale in the legend. Specify <em>slon slat</em>, the point on
-the map where the scale applies (<em>slon</em> is only meaningful for
-certain oblique projections. If not needed, you must specify <strong>-</strong>
-instead), <em>length</em>, the length of the scale in km (for other units
-append <strong>e</strong> (meter), <strong>f</strong> (foot), <strong>M</strong> (mile), <strong>n</strong> (nautical
-mile), or <strong>u</strong> (survey foot)), and <strong>f</strong> or <strong>p</strong> for fancy or
-plain scale. If the <strong>-R</strong> <strong>-J</strong> supplied to <strong>pslegend</strong> is
-different than the projection needed for the scale (or not given at
-all, i.e., with <strong>-Dx</strong>), supply the optional <strong>-R</strong> <strong>-J</strong> settings
-as well. Append <strong>+l</strong> to the <em>length</em> to select the default label
-which equals the distance unit (meter, feet, km, miles, nautical
-miles, survey feet) and is justified on top of the scale [t]. Change
-this by giving your own label (append <strong>+l</strong><em>label</em>). Change label
-justification with <strong>+j</strong><em>justification</em> (choose among l(eft),
-r(ight), t(op) , and b(ottom)).
-Apply <strong>+u</strong> to append the unit to all distance annotations along
-the scale. If you want to place a rectangle behind the scale,
-specify suitable <strong>+p</strong><em>pen</em> and/or <strong>+f</strong><em>fill</em> parameters. All
-these )+)<em>modifiers</em> are appended to <em>length</em> to make a single
-string.</dd>
-<dt><strong>N</strong> <em>ncolumns</em></dt>
-<dd>Change the number of columns in the legend [1]. This only affects
-the printing of symbols (<strong>S</strong>) and labels (<strong>L</strong>). The number of
-columns stay in effect until <strong>N</strong> is used again.</dd>
-<dt><strong>S</strong> <em>dx1 symbol size fill pen</em> [ <em>dx2 text</em> ]</dt>
-<dd>Plots the selected symbol with specified diameter, fill, and outline
-(see <a class="reference internal" href="psxy.html"><em>psxy</em></a>). The symbol is centered at <em>dx1</em> from the left margin
-of the column, with the optional explanatory <em>text</em> starting <em>dx2</em>
-from the margin, printed with <strong>FONT_ANNOT_PRIMARY</strong>. Use <strong>-</strong> if
-no <em>fill</em> or outline (<em>pen</em>) is required. When plotting just a
-symbol, without text, <em>dx2</em> and <em>text</em> can be omitted. Three <strong>psxy</strong>
-symbols may take special modifiers: front (<strong>f</strong>), quoted line (<strong>q</strong>) and vector (<strong>v</strong>).
-You can append modifiers to the symbol and affect how the fronts, quoted lines and
-vectors are presented (see <a class="reference internal" href="psxy.html"><em>psxy</em></a> man page for modifiers).
-<strong>pslegend</strong> will determine default settings for all modifiers and
-secondary arguments if not provided. A few other symbols (the rectangles,
-ellipse, wedge, mathangle) may take more than a single argument size.
-Note that for a line segment you should use the horizontal dash symbol (<strong>-</strong>).
-If just a single size if given then <strong>pslegend</strong> will provide reasonable
-arguments to plot the symbol (See <a class="reference internal" href="#defaults">Defaults</a>).
-Alternatively, combine the required
-arguments into a single, comma-separated string and use that as the
-symbol size (again, see <a class="reference internal" href="psxy.html"><em>psxy</em></a> for details on the arguments needed).</dd>
-<dt><strong>T</strong> <em>paragraph-text</em></dt>
-<dd>One or more of these <strong>T</strong> records with <em>paragraph-text</em> printed
-with <strong>FONT_ANNOT_PRIMARY</strong>. To specify special positioning and
-typesetting arrangements, or to enter a paragraph break, use the
-optional <strong>P</strong> record.</dd>
-<dt><strong>V</strong> <em>offset pen</em></dt>
-<dd>The <strong>V</strong> record draws a vertical line between columns (if more than
-one) using the selected <em>pen</em> <em>offset</em> is analogous to the offset
-for the <strong>D</strong> records but in the vertical direction.</dd>
-<dt><strong>P</strong> <em>paragraph-mode-header-for-pstext</em></dt>
-<dd>Start a new text paragraph by specifying all the parameters needed
-(see <strong>pstext -M</strong> record description). Note that <strong>pslegend</strong> knows
-what all those values should be, so normally you can leave the
-entire record (after P) blank or leave it out all together. If you
-need to set at least one of the parameters directly, you must
-specify all and set the ones you want to leave at their default
-value to <strong>-</strong>.</dd>
-</dl>
-</div>
-<div class="section" id="defaults">
-<h2>Defaults<a class="headerlink" href="#defaults" title="Permalink to this headline">¶</a></h2>
-<p>When attributes are not provided, or extended symbol information (for symbols taking more than just an overall size) are
-not given as comma-separated quantities, <strong>pslegend</strong> will provide the following defaults:</p>
-<p>Front: Front symbol is left-side (here, that means upper side) box, with dimensions 30% of the given symbol size.</p>
-<p>Vector: Head size is 30% of given symbol size.</p>
-<p>Ellipse: Minor axis is 65% of major axis (the symbol size), with an azimuth of 0 degrees.</p>
-<p>Rectangle: Height is 65% of width (the symbol size).</p>
-<p>Rotated rectangle: Same, with a rotation of 30 degrees.</p>
-<p>Rounded rectangle: Same as rectangle, but with corner radius of 10% of width.</p>
-<p>Mathangle: Angles are -10 and 45 degrees, with arrow head size 30% of symbol size.</p>
-<p>Wedge: Angles are -30 and 30 degrees.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To add an example of a legend to a Mercator plot (map.ps) with the given
-specifications, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt pslegend -R-10/10/-10/10 -JM6i -F+gazure1 -Dx0.5i/0.5i/5i/3.3i/BL \
--C0.1i/0.1i -L1.2 -B5f1 << EOF >> map.ps
-# Legend test for pslegend
-# G is vertical gap, V is vertical line, N sets # of columns, D draws horizontal line.
-# H is header, L is label, S is symbol, T is paragraph text, M is map scale.
-#
-G -0.1i
-H 24 Times-Roman My Map Legend
-D 0.2i 1p
-N 2
-V 0 1p
-S 0.1i c 0.15i p300/12 0.25p 0.3i This circle is hachured
-S 0.1i e 0.15i yellow 0.25p 0.3i This ellipse is yellow
-S 0.1i w 0.15i green 0.25p 0.3i This wedge is green
-S 0.1i f0.1i+l+t 0.25i blue 0.25p 0.3i This is a fault
-S 0.1i - 0.15i - 0.25p,- 0.3i A dashed contour
-S 0.1i v0.1i+a40+e 0.25i magenta 0.25p 0.3i This is a vector
-S 0.1i i 0.15i cyan 0.25p 0.3i This triangle is boring
-V 0 1p
-D 0.2i 1p
-N 1
-M 5 5 600+u f
-G 0.05i
-I SOEST_logo.ras 3i CT
-G 0.05i
-B colors.cpt 0.2i 0.2i
-G 0.05i L 9 4 R Smith et al., @%5%J. Geophys. Res., 99@%%, 2000
-G 0.1i
-P
-T Let us just try some simple text that can go on a few lines.
-T There is no easy way to predetermine how many lines will be required,
-T so we may have to adjust the box height to get the right size box.
-EOF
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="note-on-legend-height">
-<h2>Note On Legend Height<a class="headerlink" href="#note-on-legend-height" title="Permalink to this headline">¶</a></h2>
-<p>As <strong>-D</strong> suggests, leaving the <em>height</em> off forces a calculation of the
-expected height. This is an exact calculation except in the case of
-legends that place paragraph text. Here we simply do a first-order
-estimate of how many typeset lines might appear. Without access to font
-metrics this estimate will occasionally be off by 1 line. If so, note
-the reported height (with <strong>-V</strong>) and specify a slightly larger or
-smaller height in <strong>-D</strong>.</p>
-</div>
-<div class="section" id="windows-remarks">
-<h2>Windows Remarks<a class="headerlink" href="#windows-remarks" title="Permalink to this headline">¶</a></h2>
-<p>Note that under Windows, the percent sign (%) is a variable indicator
-(like $ under Unix). To indicate a plain percentage sign in a batch
-script you need to repeat it (%%); hence the font switching mechanism
-(@%*font*% and @%%) may require twice the number of percent signs.
-This only applies to text inside a script or that otherwise is processed
-by DOS. Data files that are opened and read by <strong>pslegend</strong> do not need
-such duplication.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>,
-<a class="reference internal" href="gmtcolors.html"><em>gmtcolors</em></a>,
-<a class="reference internal" href="psbasemap.html"><em>psbasemap</em></a>, <a class="reference internal" href="pstext.html"><em>pstext</em></a>,
-<a class="reference internal" href="psxy.html"><em>psxy</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">pslegend</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#id1">Required Arguments</a></li>
-<li><a class="reference internal" href="#id2">Optional Arguments</a></li>
-<li><a class="reference internal" href="#id3">Pslegend Codes</a></li>
-<li><a class="reference internal" href="#defaults">Defaults</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#note-on-legend-height">Note On Legend Height</a></li>
-<li><a class="reference internal" href="#windows-remarks">Windows Remarks</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="psimage.html"
- title="previous chapter">psimage</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="pslib.html"
- title="next chapter">pslib</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/pslegend.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="pslib.html" title="pslib"
- >next</a> </li>
- <li class="right" >
- <a href="psimage.html" title="psimage"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" >PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/pslib.html b/doc_release/html/pslib.html
deleted file mode 100644
index 4426b9f..0000000
--- a/doc_release/html/pslib.html
+++ /dev/null
@@ -1,965 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>pslib — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="PS" href="PS.html" />
- <link rel="next" title="psmask" href="psmask.html" />
- <link rel="prev" title="pslegend" href="pslegend.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="psmask.html" title="psmask"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="pslegend.html" title="pslegend"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" accesskey="U">PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="pslib">
-<span id="index-0"></span><h1>pslib<a class="headerlink" href="#pslib" title="Permalink to this headline">¶</a></h1>
-<p>PSL 5.1 - A PostScript based plotting library</p>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p>PSL was created to make the generation of PostScript page
-description code easier. PS is a page description language developed by
-the Adobe for specifying how a printer should render a page of text or
-graphics. It uses a reverse Polish notation that puts and gets items
-from a stack to draws lines, text, and images and even performs
-calculations. PSL is a self-contained library that presents a series
-of functions that can be used to create plots. The resulting
-PostScript code is ASCII text (with some exceptions for images if so
-desired) and can thus be edited using any text editor. Thus, it is
-possible to modify a plot file even after it has been created, e.g., to
-change text strings, set new gray shades or colors, experiment with
-various pen widths, etc. Furthermore, various tools exist that can parse
-PostScript and let you make such edits via a graphical user interface
-(e.g., Adobe Illustrator). PSL is written in C but includes FORTRAN
-bindings and can therefore be called from both C and FORTRAN programs.
-To use this library, you must link your plotting program with PSL.
-PSL is used by the GMT graphics programs to generate PS. PSL
-output is freeform PostScript that conforms to the Adobe PostScript
-File Specification Version 3.0.</p>
-<p>Before any PSL calls can be issued, the plotting system must be
-initialized. This is done by calling <strong>PSL_beginsession</strong>, which
-initializes a new PSL session; then call <strong>PSL_setdefaults</strong> which
-sets internal variables and default settings, accepts settings for
-measurement units and character encoding, and returns a pointer to a
-struct PSL_CTRL which must be passed as first argument to all other
-PSL functions. The measure unit for sizes and positions can be set
-to be centimeter (c), inch (i), meter (m), or points
-(p). A PSL session is terminated by calling
-<strong>PSL_endsession</strong>. You may create one or more plots within the same
-session. A new plot is started by calling <strong>PSL_beginplot</strong>, which
-defines macros, sets up the plot-coordinate system, scales, and
-[optionally] opens a file where all the PS code will be written.
-Normally, the plot code is written to <em>stdout</em>. When all plotting to
-this file is done, you finalize the plot by calling <strong>PSL_endplot</strong>.</p>
-<p>A wide variety of output devices that support PostScript exist,
-including many printers and large-format plotters. Many tools exists to
-display PostScript on a computer screen. Open source tools such as
-ghostscript can be used to convert PostScript into PDF or raster
-images (e.g., TIFF, JPEG) at a user-defined resolution (DPI). In
-particular, the GMT tool ps2raster is a front-end to ghostscript and
-pre-selects the optimal options for ghostscript that will render quality
-PDF and images.</p>
-<p>The PSL is fully 64-bit compliant. Integer parameters are here
-specified by the type <strong>long</strong> to distinguish them from the 32-bit
-<strong>int</strong>. Note that under standard 32-bit compilation they are
-equivalent. Users of this library under 64-bit mode must make sure they
-pass proper <strong>long</strong> variables (under Unix flavors) or <strong>__int64</strong>
-under Windows 64.</p>
-</div>
-<div class="section" id="units">
-<h2>Units<a class="headerlink" href="#units" title="Permalink to this headline">¶</a></h2>
-<p>PSL can be instructed to use centimeters, inches, meters or points
-as input units for the coordinates and sizes of elements to be plotted.
-Any dimension that takes this setting as a unit is specified as <em>user
-units</em> or <em>plot units</em> in this manual. Excluded from this are line
-widths and font sizes which are always measured in <em>points</em>. The user
-units can be further refined by calling <strong>PSL_beginaxes</strong>, giving the
-user the opportunity to specify any linear coordinate frame. Changing
-the coordinate frame only affects the coordinates of plotted material
-indicated as measured in <em>plot units</em>, not the sizes of symbols (which
-remain in <em>user units</em>), nor line widths or font sizes (which remain in
-<em>points</em>).</p>
-</div>
-<div class="section" id="color">
-<h2>Color<a class="headerlink" href="#color" title="Permalink to this headline">¶</a></h2>
-<p>PSL uses the direct color model where red, green, and blue are given
-separately, each must be in the range from 0-1. If red = -1 then no fill
-operation takes place. If red = -3, then pattern fill will be used, and
-the green value will indicate the pattern to be used. Most plot-items
-can be plotted with or without outlines. If outline is desired (i.e.,
-set to 1), it will be drawn using the current line width and pattern.
-PSL uses highly optimized macro substitutions and scales the
-coordinates depending on the resolution of the hardcopy device so that
-the output file is kept as compact as possible.</p>
-</div>
-<div class="section" id="justification">
-<h2>Justification<a class="headerlink" href="#justification" title="Permalink to this headline">¶</a></h2>
-<p>Text strings, text boxes and images can be “justified” by specifying the
-corner to which the <em>x</em> and <em>y</em> coordinates of the subroutine call
-apply. Nine different values are possible, as shown schematically in
-this diagram:</p>
-<blockquote>
-<div><p>9————10———– 11</p>
-<p>| |</p>
-<p>5 6 7</p>
-<p>| |</p>
-<p>1———— 2———— 3</p>
-</div></blockquote>
-<p>The box represents the text or image. E.g., to plot a text string with
-its center at (<em>x</em>, <em>y</em>), you must use <em>justify</em> == 6. <em>justify</em> == 0
-means “no justification”, which generally means (<em>x</em>, <em>y</em>) is at the
-bottom left. Convenience values PSL_NONE, PSL_BL, PSL_BC, PSL_BL,
-PSL_ML, PSL_MC, PSL_MR, PSL_TL, PSL_TC and PSL_TR are available.</p>
-</div>
-<div class="section" id="initialization">
-<h2>Initialization<a class="headerlink" href="#initialization" title="Permalink to this headline">¶</a></h2>
-<p>These functions initialize or terminate the PSL system. We use the
-term PSL session to indicate one instance of the PSL system (a
-complicated program could run many PSL sessions concurrently as each
-would operate via its own control structure). During a single session,
-one or more plots may be created. Here are the functions involved in
-initialization:</p>
-<p><strong>struct PS_CTRL *New_PSL_Ctrl</strong> (<strong>char</strong> <em>*session</em>)</p>
-<blockquote>
-<div>This is the first function that must be called as it creates a new
-PSL session. Specifically, it will allocate a new PSL
-control structure and initialize the session default parameters. The
-pointer that is returned must be passed to all subsequent PSL
-functions.</div></blockquote>
-<p><strong>long *PSL_beginsession</strong> (<strong>struct PS_CTRL</strong> <em>*PSL</em>, <strong>long</strong>
-<em>search</em>, <strong>char</strong> <em>*sharedir</em>, <strong>char</strong> <em>*userdir</em>)</p>
-<blockquote>
-<div>This is the second function that must be called as it initializes
-the new PSL session. Here, <em>search</em> is an integer that is passed
-as 0 in GMT but should be 1 for other users. If so we will search
-for the environmental parameters PSL_SHAREDIR and PSL_USERDIR
-should the corresponding arguments <em>sharedir</em> and <em>userdir</em> be NULL.</div></blockquote>
-<p><strong>long PSL_endsession</strong> (<strong>struct PS_CTRL</strong> <em>*PSL</em>)</p>
-<blockquote>
-<div>This function terminates the active PSL session; it is the last
-function you must call in your program. Specifically, this function
-will deallocate memory used and free up resources.</div></blockquote>
-<p><strong>struct PS_CTRL *PSL_beginlayer</strong> (<strong>struct PS_CTRL</strong> <em>*PSL</em>,
-<strong>long</strong> <em>layer</em>)</p>
-<blockquote>
-<div>Adds a DSC comment by naming this layer; give a unique integer
-value. Terminate layer with PSL_endlayer</div></blockquote>
-<p><strong>struct PS_CTRL *PSL_endlayer</strong> (<strong>struct PS_CTRL</strong> <em>*PSL</em>)</p>
-<blockquote>
-<div>Terminate current layer with a DSC comment.</div></blockquote>
-<p><strong>long PSL_fopen</strong> (<strong>char</strong> <em>*file</em>, <strong>char</strong> <em>*mode</em>)</p>
-<blockquote>
-<div>This function simply opens a file, just like fopen. The reason it is
-replicated here is that under Windows, file pointers must be
-assigned within the same DLL as they are being used. Yes, this is
-retarded but if we do not do so then PSL will not work well under
-Windows. Under non-Windows this functions is just a macro that
-becomes fopen.</div></blockquote>
-<p><strong>void PSL_free</strong> (<strong>void</strong> <em>*ptr</em>)</p>
-<blockquote>
-<div>This function frees up the memory allocated inside PSL.
-Programmers using C/C++ should now this is a macro and there is no
-need to cast the pointer to <em>void *</em> as this will be done by the
-macro. Fortran programmers should instead call
-<strong>PSL_freefunction</strong>.</div></blockquote>
-<p><strong>void PSL_beginaxes</strong> (<strong>struct PS_CTRL</strong> <em>*PSL</em>, <strong>double</strong> <em>llx</em>,
-<strong>double</strong> <em>lly</em>, <strong>double</strong> <em>width</em>, <strong>double</strong> <em>height</em>, <strong>double</strong>
-<em>x0</em>, <strong>double</strong> <em>y0</em>, <strong>double</strong> <em>x1</em>, <strong>double</strong> <em>y1</em>)</p>
-<blockquote>
-<div>This function sets up the mapping that takes the users data
-coordinates and converts them to the positions on the plot in
-PostScript units. This should be used when plotting data
-coordinates and is terminated with <strong>PSL_endaxes</strong>, which returns
-PSL to the default measurement units and scaling. Here, <em>llx</em>
-and <em>lly</em> sets the lower left position of the mapping region, while
-<em>width</em> and <em>height</em> sets the dimension of the plot area in user
-units. Finally, <em>x0</em>, <em>x1</em> and <em>y0</em>, <em>y1</em> indicate the range of the
-users x- and y-coordinates, respectively. Specify a reverse axis
-direction (e.g., to let the y-axis be positive down) by setting <em>y0</em>
-larger than <em>y1</em>, and similarly for an x-axis that increases to the
-left.</div></blockquote>
-<p><strong>void PSL_endaxes</strong> (<strong>struct PS_CTRL</strong> <em>*PSL</em>)</p>
-<blockquote>
-<div>Terminates the map scalings initialized by <strong>PSL_beginaxes</strong> and
-returns PSL to standard scaling in measurement units.</div></blockquote>
-<p><strong>long PSL_beginplot</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>FILE</strong> <em>*fp</em>,
-<strong>long</strong> <em>orientation</em>, <strong>long</strong> <em>overlay</em>, <strong>long</strong> <em>color_mode</em>,
-<strong>char</strong> <em>origin</em>[], <strong>double</strong> <em>offset</em>[], <strong>double</strong>
-<em>page_size</em>[], <strong>char</strong> <em>*title</em>, <strong>long</strong> <em>font_no</em>[])</p>
-<blockquote>
-<div>Controls the initiation (or continuation) of a particular plot
-within the current session. Pass file pointer <em>fp</em> where the
-PostScript code will be written; if NULL then the output is
-written to <em>stdout</em>. The Fortran interface always sends to <em>stdout</em>.
-The <em>orientation</em> may be landscape (PSL_LANDSCAPE or 0) or portrait
-(PSL_PORTRAIT or 1). Set <em>overlay</em> to PSL_OVERLAY (0) if the
-following PostScript code should be appended to an existing plot;
-otherwise pass PSL_INIT (1) to start a new plot.
-Let <em>colormode</em> be one of PSL_RGB (0), PSL_CMYK
-(1), PSL_HSV (2) or PSL_GRAY (3); this setting controls how colors
-are presented in the PostScript code. The <em>origin</em> setting
-determines for x and y separately the origin of the specified
-offsets (next argument). Each of the two characters are either <strong>r</strong>
-for an offset relative to the current origin, <strong>a</strong> for a temporaty
-adjustment of the origin which is undone during BD(PSL_endplot),
-<strong>f</strong> for a placement of the origin relative to the lower left corner
-of the page, <strong>c</strong> for a placement of the origin relative to the
-center of the page. The array <em>offset</em> specifies the offset of the
-new origin relative to the position indicated by <strong>origin</strong>.
-<em>page_size</em> means the physical width and height of the plotting
-media in points (typically 612 by 792 for Letter or 595 by 842 for
-A4 format). The character string <em>title</em> can be used to specify the
-<strong>%%Title:</strong> header in the PostScript file (or use NULL for the
-default). The array <em>font_no</em> specifies all fonts used in the plot
-(by number), or use NULL to leave out the
-<strong>%%DocumentNeededResources:</strong> comment in the PostScript file.</div></blockquote>
-<p><strong>long PSL_endplot</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>long</strong> <em>last_page</em>)</p>
-<blockquote>
-<div>Terminates the plotting sequence and closes plot file (if other than
-<em>stdout</em>). If <em>last_page</em> == PSL_FINALIZE
-(1), then a PostScript <em>showpage</em> command
-is issued, which initiates the printing process on hardcopy devices.
-Otherwise, pass PSL_OVERLAY (0).</div></blockquote>
-<p><strong>long PSL_setorigin</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>double</strong>
-<em>xorigin</em>, <strong>double</strong> <em>yorigin</em>, <strong>double</strong> <em>angle</em>, <strong>long</strong> <em>mode</em>)</p>
-<blockquote>
-<div>Changes the coordinate system by translating by
-(<em>xorigin</em>,<em>yorigin</em>) followed by a <em>angle</em>-degree rotation
-(<em>mode</em>=PSL_FWD or 0) or alternatively the rotation followed by
-translation (<em>mode</em>=PSL_INV or 1).</div></blockquote>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc6">Changing Settings</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>The following functions are used to change various PSL settings and
-affect the current state of parameters such as line and fill attributes.</p>
-<p><strong>long PSL_define_pen</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>char</strong>
-<em>*name</em>, <strong>long</strong> <em>width</em>, <strong>char</strong> <em>*style</em>, <strong>double</strong> <em>offset</em>,
-<strong>double</strong> <em>rgb</em>[])</p>
-<blockquote>
-<div>Stores the specified pen characteristics in a PostScript variable
-called <em>name</em>. This can be used to place certain pen attributes in
-the PostScript file and then retrieve them later with
-<strong>PSL_load_pen</strong>. This makes the stored pen the current pen.</div></blockquote>
-<p><strong>long PSL_define_rgb</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>char</strong>
-<em>*name</em>, <strong>double</strong> <em>rgb</em>[])</p>
-<blockquote>
-<div>Stores the specified color in a PostScript variable called <em>name</em>.
-This can be used to place certain color values in the PostScript
-file and then retrieve them later with <strong>PSL_load_rgb</strong>. This
-makes the stored color the current color.</div></blockquote>
-<p><strong>long PSL_setcolor</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>double</strong>
-<em>rgb</em>[], <strong>long</strong> <em>mode</em>)</p>
-<blockquote>
-<div>Sets the current color for all stroked (mode = PSL_IS_STROKE (0))
-or filled (mode = PSL_IS_FILL (1)) material
-to follow (lines, symbol outlines, text). <em>rgb</em> is a triplet of red,
-green and blue values in the range 0.0 through 1.0. Set the red
-color to -3.0 and the green color to the pattern number returned by
-<strong>PSL_setpattern</strong> to select a pattern as current paint color. For
-PDF transparency, set <em>rgb</em>[3] to a value between 0 (opaque) and 1
-(fully transparent).</div></blockquote>
-<p><strong>long PSL_setpattern</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>long</strong>
-<em>image_no</em>, <strong>char</strong> <em>*imagefile</em>, <strong>long</strong> <em>dpi</em>, <strong>double</strong>
-<em>f_rgb</em>[], <strong>double</strong> <em>b_rgb</em>[])</p>
-<blockquote>
-<div>Sets up the specified image pattern as the fill to use for polygons
-and symbols. Here, <em>image_no</em> is the number of the standard PSL
-fill patterns (1-90; use a negative number when you specify an image
-<em>filename</em> instead. The scaling (i.e., resolution in dots per inch)
-of the pattern is controlled by the image <em>dpi</em>; if set to 0 it will
-be plotted at the device resolution. The two remaining settings
-apply to 1-bit images only and are otherwise ignored: You may
-replace the foreground color (the set bits) with the <em>f_rgb</em> color
-and the background color (the unset bits) with <em>b_rgb</em>.
-Alternatively, pass either color with the red component set to -1.0
-and we will instead issue an image mask that is see-through for the
-specified fore- or background component. To subsequently use the
-pattern as a pen or fill color, use <strong>PSL_setcolor</strong> or
-DB(PSL_setfill) with the a color <em>rgb</em> code made up of <em>r</em> = -3,
-and <em>b</em> = the pattern number returned by <strong>PSL_setpattern</strong>.</div></blockquote>
-<p><strong>long PSL_setdash</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>char</strong> <em>*pattern</em>,
-<strong>double</strong> <em>offset</em>)</p>
-<blockquote>
-<div><p>Changes the current pen style attributes. The character string
-<em>pattern</em> contains the desired pattern using a series of lengths in
-points specifying the alternating lengths of dashes and gaps in
-points. E.g., “4 2” and <em>offset</em> = 1 will plot like</p>
-<blockquote>
-<div>x —- —- —-</div></blockquote>
-<p>where x is starting point of a line (The x is not plotted). That is,
-the line is made up of a repeating pattern of a 4 points long solid
-line and a 2 points long gap, starting 1 point after the x. To reset
-to solid line, specify <em>pattern</em> = NULL (“”) and <em>offset</em> = 0.</p>
-</div></blockquote>
-<p><strong>long PSL_setfill</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>double</strong> <em>rgb</em>[],
-<strong>long</strong> <em>outline</em>)</p>
-<blockquote>
-<div>Sets the current fill color and whether or not outline is needed for
-symbols. Special cases are handled by passing the red color as -1.0
-(no fill), -2.0 (do not change the outline setting) or -3.0 (select
-the image pattern indicated by the second (green) element of <em>rgb</em>).
-For PDF transparency, set <em>rgb</em>[3] to a value between 0 (opaque)
-and 1 (fully transparent). Set outline to PSL_OUTLINE
-(1) to draw the outlines of polygons and symbols using the current pen.</div></blockquote>
-<p><strong>long PSL_setfont</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>long</strong> <em>fontnr</em>)</p>
-<blockquote>
-<div>Changes the current font number to <em>fontnr</em>. The fonts available
-are: 0 = Helvetica, 1 = H. Bold, 2 = H. Oblique, 3 = H.
-Bold-Oblique, 4 = Times, 5 = T. Bold, 6 = T. Italic, 7 = T. Bold
-Italic, 8 = Courier, 9 = C. Bold, 10 = C Oblique, 11 = C Bold
-Oblique, 12 = Symbol, 13 = AvantGarde-Book, 14 = A.-BookOblique, 15
-= A.-Demi, 16 = A.-DemiOblique, 17 = Bookman-Demi, 18 =
-B.-DemiItalic, 19 = B.-Light, 20 = B.-LightItalic, 21 =
-Helvetica-Narrow, 22 = H-N-Bold, 23 = H-N-Oblique, 24 =
-H-N-BoldOblique, 25 = NewCenturySchlbk-Roman, 26 = N.-Italic, 27 =
-N.-Bold, 28 = N.-BoldItalic, 29 = Palatino-Roman, 30 = P.-Italic, 31
-= P.-Bold, 32 = P.-BoldItalic, 33 = ZapfChancery-MediumItalic, 34 =
-ZapfDingbats, 35 = Ryumin-Light-EUC-H, 36 = Ryumin-Light-EUC-V, 37 =
-GothicBBB-Medium-EUC-H, and 38 = GothicBBB-Medium-EUC-V. If <em>fontnr</em>
-is outside this range, it is reset to 0.</div></blockquote>
-<p><strong>long PSL_setfontdims</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>double</strong> <em>supsub</em>,
-<strong>double</strong> <em>scaps</em>, <strong>double</strong> <em>sup</em>, <strong>double</strong> <em>sdown</em>)</p>
-<blockquote>
-<div>Changes the settings for a variety of relative font sizes and shifts
-pertaining to sub-scripts, super-scripts, and small caps. Default
-settings are given in brackets. Here, <em>supsub</em> sets the relative size
-of sub- and super-scripts [0.58], <em>scaps</em> sets the relative size of
-small caps [0.8], <em>sup</em> indicates the upward baseline shift for placement
-of super-scripts [0.33], while <em>sdown</em> sets the downward baseline shift
-for sub-scripts [0.33].</div></blockquote>
-<p><strong>long PSL_setformat</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>long</strong> <em>n_decimals</em>)</p>
-<blockquote>
-<div>Sets the number of decimals to be used when writing color or gray
-values. The default setting of 3 gives 1000 choices per red, green,
-and blue value, which is more than the 255 choices offered by most
-24-bit platforms. Choosing a lower value will make the output file
-smaller at the expense of less color resolution. Still, a value of 2
-gives 100 x 100 x 100 = 1 million colors, more than most eyes can
-distinguish. For a setting of 1, you will have 10 nuances per
-primary color and a total of 1000 unique combinations.</div></blockquote>
-<p><strong>long PSL_setlinewidth</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>double</strong>
-<em>linewidth</em>)</p>
-<blockquote>
-<div>Changes the current line width in points. Specifying 0 gives the
-thinnest line possible, but this is implementation-dependent (seems
-to work fine on most PostScript printers).</div></blockquote>
-<p><strong>long PSL_setlinecap</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>long</strong> <em>cap</em>)</p>
-<blockquote>
-<div>Changes the current line cap, i.e., what happens at the beginning
-and end of a line segment. PSL_BUTT_CAP (0) gives butt line caps
-[Default], PSL_ROUND_CAP (1) selects round
-caps, while PSL_SQUARE_CAP (2) results
-in square caps. THus, the two last options will visually lengthen a
-straight line-segment by half the line width at either end.</div></blockquote>
-<p><strong>long PSL_setlinejoin</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>long</strong> <em>join</em>)</p>
-<blockquote>
-<div>Changes the current linejoin setting, which handles how lines of
-finite thickness are joined together when the meet at different
-angles. PSL_MITER_JOIN (0) gives a mitered joint [Default],
-PSL_ROUND_JOIN (1) makes them round,
-while PSL_BEVEL_JOIN (2) produces bevel joins.</div></blockquote>
-<p><strong>long PSL_setmiterlimit</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>long</strong> <em>limit</em>)</p>
-<blockquote>
-<div>Changes the current miter limit used for mitered joins.
-PSL_MITER_DEFAULT (35) gives the default PS miter; other values
-are interpreted as the cutoff acute angle (in degrees) when mitering
-becomes active.</div></blockquote>
-<p><strong>long PSL_settransparencymode</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>char</strong>
-<em>*mode</em>)</p>
-<blockquote>
-<div>Changes the current PDF transparency rendering mode [Default is
-Normal]. Choose among Color, ColorBurn, ColorDodge, Darken,
-Difference, Exclusion, HardLight, Hue, Lighten, Luminosity,
-Multiply, Normal, Overlay, Saturation, SoftLight, and Screen.</div></blockquote>
-<p><strong>long PSL_setdefaults</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>double</strong>
-<em>xyscales</em>[], <strong>double</strong> <em>pagergb</em>[], <strong>char</strong> <em>*encoding</em>)</p>
-<blockquote>
-<div>Allows changes to the PSL session settings and should be called
-immediately after <strong>PSL_beginsession</strong>. The <em>xyscales</em> array affect
-an overall magnification of your plot [1,1]. This can be useful if
-you design a page-sized plot but would then like to magnify (or
-shrink) it by a given factor. Change the default paper media color
-[white; 1/1/1] by specifying an alternate page color. Passing zero
-(or NULL for <em>pagergb</em>) will leave the setting unchanged. Finally,
-pass the name of the character set encoding (if NULL we select
-Standard).</div></blockquote>
-<p><strong>long PSL_defunits</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>char</strong> <em>*name</em>,
-<strong>double</strong> <em>value</em>)</p>
-<blockquote>
-<div>Creates a PostScript variable called <em>name</em> and initializes it to
-the equivalent of <em>value</em> user units.</div></blockquote>
-<p><strong>long PSL_defpoints</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>char</strong> <em>*name</em>,
-<strong>double</strong> <em>fontsize</em>)</p>
-<blockquote>
-<div>Creates a PostScript variable called <em>name</em> and initializes it to
-the value that corresponds to the font size (in points) given by
-<em>fontsize</em>.</div></blockquote>
-</div>
-<div class="section" id="id2">
-<h2><a class="reference external" href="#toc7">Plotting Lines And Polygons</a><a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h2>
-<p>Here are functions used to plot lines and closed polygons, which may
-optionally be filled. The attributes used for drawing and filling are
-set prior to calling these functions; see CHANGING SETTINGS above.</p>
-<p><strong>long PSL_plotarc</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>double</strong> <em>x</em>,
-<strong>double</strong> <em>y</em>, <strong>double</strong> <em>radius</em>, <strong>double</strong> <em>angle1</em>, <strong>double</strong>
-<em>angle2</em>, <strong>long</strong> <em>type</em>)</p>
-<blockquote>
-<div>Draws a circular arc with its center at plot coordinates (<em>x</em>, <em>y</em>),
-starting from angle <em>angle1</em> and end at <em>angle2</em>. Angles must be
-given in decimal degrees. If <em>angle1</em> > <em>angle2</em>, a negative arc is
-drawn. The <em>radius</em> is in user units. The <em>type</em> determines how the
-arc is interpreted: PSL_MOVE (1) means set new
-anchor point, PSL_STROKE (2) means stroke
-the arc, PSL_MOVE + PSL_STROKE (3) means
-both, whereas PSL_DRAW (0) justs adds to arc path to the current
-path.</div></blockquote>
-<p><strong>long PSL_plotline</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>double</strong> <em>x</em>,
-<strong>double</strong> <em>y</em>, <strong>long</strong> <em>n</em>, <strong>long</strong> <em>type</em>)</p>
-<blockquote>
-<div>Assemble a continuous line through <em>n</em> points whose the plot
-coordinates are in the <em>x</em>, <em>y</em> arrays. To continue an existing
-line, use <em>type</em> = PSL_DRAW (0), or if this is the first segment in
-a multisegment path, set <em>type</em> = PSL_MOVE (1).
-To end the segments and draw the lines, add PSL_STROKE
-(2). Thus, for a single segment, <em>type</em> must
-be PSL_MOVE + PSL_STROKE (3). The line is
-drawn using the current pen attributes. Add PSL_CLOSE
-(8) to <em>type</em> to close the first and last point
-by the PostScript operators; this is done automatically if the
-first and last point are equal.</div></blockquote>
-<p><strong>long PSL_plotpoint</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>double</strong> <em>x</em>,
-<strong>double</strong> <em>y</em>, <strong>long</strong> <em>type</em>)</p>
-<blockquote>
-<div>Moves the pen from the current to the specified plot coordinates
-(<em>x</em>, <em>y</em>) and optionally draws and strokes the line, depending on
-<em>type</em>. Specify <em>type</em> as either a move (PSL_MOVE, 1), or draw
-(PSL_DRAW, 2), or draw and stroke (PSL_DRAW + PSL_STOKE, 3) using
-current pen attributes. It the coordinates are relative to the
-current point add PSL_REL (4) to <em>type</em>.</div></blockquote>
-<p><strong>long PSL_plotbox</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>double</strong> <em>x0</em>,
-<strong>double</strong> <em>y0</em>, <strong>double</strong> <em>x1</em>, <strong>double</strong> <em>y1</em>)</p>
-<blockquote>
-<div>Creates a closed box with opposite corners at plot coordinates
-(<em>x0</em>,<em>y1</em>) and (<em>x1</em>,<em>y1</em>). The box may be filled and its
-outline stroked depending on the current settings for fill and pen
-attributes.</div></blockquote>
-<p><strong>long PSL_plotpolygon</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>double</strong> <em>x</em>,
-<strong>double</strong> <em>y</em>, <strong>long</strong> <em>n</em>)</p>
-<blockquote>
-<div>Creates a closed polygon through <em>n</em> points whose plot coordinates
-are in the <em>x</em>, <em>y</em> arrays. The polygon may be filled and its
-outline stroked depending on the current settings for fill and pen
-attributes.</div></blockquote>
-<p><strong>long PSL_plotsegment</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>double</strong> <em>x0</em>,
-<strong>double</strong> <em>y0</em>, <strong>double</strong> <em>x1</em>, <strong>double</strong> <em>y1</em>)</p>
-<blockquote>
-<div>Draws a line segment between the two points (plot coordinates) using
-the current pen attributes.</div></blockquote>
-</div>
-<div class="section" id="id3">
-<h2><a class="reference external" href="#toc8">Plotting Symbols</a><a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h2>
-<p>Here are functions used to plot various geometric symbols or constructs.</p>
-<p><strong>long PSL_plotaxis</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>double</strong>
-<em>tickval</em>, <strong>char</strong> <em>*label</em>, <strong>double</strong> <em>fontsize</em>, <strong>long</strong> <em>side</em>)</p>
-<blockquote>
-<div>Plots a basic axis with tick marks, annotations, and label. Assumes
-that <strong>PSL_beginaxes</strong> has been called to set up positioning and
-user data ranges. Annotations will be set using the <em>fontsize</em> in
-points. <em>side</em> can be 0, 1, 2, or 3, which selects lower x-axis,
-right y-axis, upper x-axis, or left y-axis, respectively. The
-<em>label</em> font size is set to 1.5 times the <em>fontsize</em>.</div></blockquote>
-<p><strong>long PSL_plotsymbol</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>double</strong> <em>x</em>,
-<strong>double</strong> <em>y</em>, <strong>double</strong> <em>size</em>[], <strong>long</strong> <em>symbol</em>)</p>
-<blockquote>
-<div>Plots a simple geometric symbol centered on plot coordinates (<em>x</em>,
-<em>y</em>). The argument <em>symbol</em> selects the geometric symbol to use.
-Most symbols are scaled to fit inside a circle of diameter given as
-<em>size</em>[0], but some symbols take additional parameters. Choose
-from these 1-parameter symbols using the predefined self-explanatory
-integer values PSL_CIRCLE, PSL_DIAMOND, PSL_HEXAGON,
-PSL_INVTRIANGLE, PSL_OCTAGON, PSL_PENTAGON, PSL_SQUARE,
-PSL_STAR, and PSL_TRIANGLE; these may all be filled and stroked if
-<strong>PSL_setfill</strong> has been called first. In addition, you can choose
-several line-only symbols that cannot be filled. They are
-PSL_CROSS, PSL_DOT, PSL_PLUS, PSL_XDASH, and PSL_YDASH.
-Finally, more complicated symbols require more than one parameter to
-be passed via <em>size</em>. These are PSL_ELLIPSE (<em>size</em> is expected to
-contain the three parameter <em>angle</em>, <em>major</em>, and <em>minor</em> axes,
-which defines an ellipse with its major axis rotated by <em>angle</em>
-degrees), PSL_MANGLE (<em>size</em> is expected to contain the 8
-parameters <em>radius</em>, <em>angle1</em>, and <em>angle2</em> for the math angle
-specification, followed by <em>tailwidth</em>, <em>headlength</em>, <em>headwidth</em>,
-<em>shape</em>, and <em>status</em> (see PSL_VECTOR below for explanation),
-PSL_WEDGE (<em>size</em> is expected to contain the three parameter
-<em>radius</em>, <em>angle1</em>, and <em>angle2</em> for the sector specification),
-PSL_RECT (<em>size</em> is expected to contain the two dimensions <em>width</em>
-and <em>height</em>), PSL_RNDRECT (<em>size</em> is expected to contain the two
-dimensions <em>width</em> and <em>height</em> and the <em>radius</em> of the corners),
-PSL_ROTRECT (<em>size</em> is expected to contain the three parameter
-<em>angle</em>, <em>width</em>, and <em>height</em>, with rotation relative to the
-horizontal), and PSL_VECTOR (<em>size</em> is expected to contain the 7
-parameters <em>x_tip</em>, <em>y_tip</em>, <em>tailwidth</em>, <em>headlength</em>,
-<em>headwidth</em>, <em>shape</em>, and <em>status</em>. Here (<em>x_tip</em>,<em>y_tip</em>) are
-the coordinates to the head of the vector, while (<em>x</em>, <em>y</em>) are
-those of the tail. <em>shape</em> can take on values from 0-1 and specifies
-how far the intersection point between the base of a straight vector
-head and the vector line is moved toward the tip. 0.0 gives a
-triangular head, 1.0 gives an arrow shaped head. The <em>status</em> value
-is a bit-flag being the sum of several possible contributions:
-PSL_VEC_RIGHT (2) = only draw right half
-of vector head, PSL_VEC_BEGIN (4) =
-place vector head at beginning of vector,
-PSL_VEC_END (8) = place vector head at end of vector,
-PSL_VEC_JUST_B (0) = align vector beginning at (x,y),
-PSL_VEC_JUST_C (16) = align vector center at (x,y),
-PSL_VEC_JUST_E (32) = align vector end at (x,y),
-PSL_VEC_JUST_S (64) = align vector center at (x,y),
-PSL_VEC_OUTLINE (128) = draw vector head outline using default
-pen, PSL_VEC_FILL (512) = fill vector head using default fill,
-PSL_VEC_MARC90 (2048) = if angles subtend 90, draw straight angle
-symbol (PSL_MANGLE only). The symbol may be filled and its outline
-stroked depending on the current settings for fill and pen
-attributes.</div></blockquote>
-</div>
-<div class="section" id="id4">
-<h2><a class="reference external" href="#toc9">Plotting Images</a><a class="headerlink" href="#id4" title="Permalink to this headline">¶</a></h2>
-<p>Here are functions used to read and plot various images.</p>
-<p><strong>long PSL_plotbitimage</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>double</strong> <em>x</em>,
-<strong>double</strong> <em>y</em>, <strong>double</strong> <em>xsize</em>, <strong>double</strong> <em>ysize</em>, <strong>int</strong>
-<em>justify</em>, <strong>unsigned char</strong> <em>buffer</em>, <strong>long</strong> <em>nx</em>, <strong>long</strong> <em>ny</em>,
-<strong>double</strong> <em>f_rgb</em>[], <strong>double</strong> <em>b_rgb</em>[])</p>
-<blockquote>
-<div>Plots a 1-bit image image at plot coordinates (<em>x</em>, <em>y</em>) justified
-as per the argument <em>justify</em> (see <strong>JUSTIFICATION</strong> for details).
-The target size of the image is given by <em>xsize</em> and <em>ysize</em> in user
-units. If one of these is specified as zero, the corresponding size
-is adjusted to the other such that the aspect ratio of the original
-image is retained. <em>buffer</em> is an unsigned character array in
-scanline orientation with 8 pixels per byte. <em>nx</em>, <em>ny</em> refers to
-the number of pixels in the image. The rowlength of <em>buffer</em> must be
-an integral number of 8; pad with zeros. <em>buffer</em>[0] is upper left
-corner. You may replace the foreground color (the set bits) with the
-<em>f_rgb</em> color and the background color (the unset bits) with
-<em>b_rgb</em>. Alternatively, pass either color with the red component
-set to -1.0 and we will instead issue an image mask that is
-see-through for the specified fore- or background component. See the
-Adobe Systems PostScript Reference Manual for more details.</div></blockquote>
-<p><strong>long PSL_plotcolorimage</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>double</strong>
-<em>x</em>, <strong>double</strong> <em>y</em>, <strong>double</strong> <em>xsize</em>, <strong>double</strong> <em>ysize</em>, <strong>int</strong>
-<em>justify</em>, <strong>unsigned char</strong> <em>*buffer</em>, <strong>long</strong> <em>nx</em>, <strong>long</strong> <em>ny</em>,
-<strong>long</strong> <em>depth</em>)</p>
-<blockquote>
-<div>Plots a 1-, 2-, 4-, 8-, or 24-bit deep image at plot coordinates
-(<em>x</em>, <em>y</em>) justified as per the argument <em>justify</em> (see
-<strong>JUSTIFICATION</strong> for details). The target size of the image is
-given by <em>xsize</em> and <em>ysize</em> in user units. If one of these is
-specified as zero, the corresponding size is adjusted to the other
-such that the aspect ratio of the original image is retained. This
-functions sets up a call to the PostScript colorimage or image
-operators. The pixel values are stored in <em>buffer</em>, an unsigned
-character array in scanline orientation with gray shade or r/g/b
-values (0-255). <em>buffer</em>[0] is the upper left corner. <em>depth</em> is
-number of bits per pixel (24, 8, 4, 2, or 1). <em>nx</em>, <em>ny</em> refers to
-the number of pixels in image. The rowlength of <em>buffer</em> must be an
-integral number of 8/<em>Idepth</em>. E.g. if <em>depth</em> = 4, then
-<em>buffer</em>[j]/16 gives shade for pixel[2j-1] and <em>buffer</em>[j%16
-(mod 16) gives shade for pixel[2j]. When <em>-depth</em> is passed instead
-then “hardware” interpolation of the image is requested (this is
-implementation dependent). If <em>-nx</em> is passed with 8- (or 24-) bit
-images then the first one (or three) bytes of <em>buffer</em> holds the
-gray (or r/g/b) color for pixels that are to be masked out using the
-PS Level 3 Color Mask method. See the Adobe Systems PostScript
-Reference Manual for more details.</div></blockquote>
-<p><strong>long PSL_plotepsimage</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>double</strong> <em>x</em>,
-<strong>double</strong> <em>y</em>, <strong>double</strong> <em>xsize</em>, <strong>double</strong> <em>ysize</em>, <strong>int</strong>
-<em>justify</em>, <strong>unsigned char</strong> <em>*buffer</em>, <strong>long</strong> <em>size</em>, <strong>long</strong> <em>nx</em>,
-<strong>long</strong> <em>ny</em>, <strong>long</strong> <em>ox</em>, <strong>long</strong> <em>oy</em>)</p>
-<blockquote>
-<div>Plots an Encapsulated PostScript (EPS) image at plot coordinates
-(<em>x</em>, <em>y</em>) justified as per the argument <em>justify</em> (see
-<strong>JUSTIFICATION</strong> for details). The target size of the image is
-given by <em>xsize</em> and <em>ysize</em> in user units. If one of these is
-specified as zero, the corresponding size is adjusted to the other
-such that the aspect ratio of the original image is retained. The
-EPS file is stored in <em>buffer</em> and has <em>size</em> bytes. This function
-simply includes the image in the PostScript output stream within
-an appropriate wrapper. Specify position of lower left corner and
-size of image. <em>nx</em>, <em>ny</em>, <em>ox</em>, <em>oy</em> refers to the width, height
-and origin (lower left corner) of the BoundingBox in points.</div></blockquote>
-<p><strong>long PSL_loadimage</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>FILE</strong> <em>*fp</em>,
-<strong>struct imageinfo</strong> <em>*header</em>, <strong>unsigned char</strong> <em>**image</em>)</p>
-<blockquote>
-<div>Reads the image contents of the EPS file or a raster image pointed
-to by the open file pointer <em>fp</em>. The routine can handle
-Encapsulated PostScript files or 1-, 8-, 24-, or 32-bit raster
-images in old, standard, run-length encoded, or RGB-style Sun
-format. Non-Sun rasters are automatically reformatted to Sun rasters
-via a system call to GraphicsMagick’s or ImageMagick’s <strong>convert</strong>, if installed. The
-image is returned via the <em>image</em> pointer.</div></blockquote>
-</div>
-<div class="section" id="plotting-text">
-<h2>Plotting Text<a class="headerlink" href="#plotting-text" title="Permalink to this headline">¶</a></h2>
-<p>Here are functions used to read and plot text strings and paragraphs.
-This can be somewhat complicated since we rely on the PostScript
-interpreter to determine the exact dimensions of text items given the
-font chosen. For perfect alignment you may have to resort to calculate
-offsets explicitly using <strong>long PSL_deftextdim</strong>, <strong>PSL_set_height</strong>
-and others and issue calculations with <strong>PSL_setcommand</strong>.</p>
-<p><strong>long PSL_plottext</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>double</strong> <em>x</em>,
-<strong>double</strong> <em>y</em>, <strong>double</strong> <em>fontsize</em>, <strong>char</strong> <em>*text</em>, <strong>double</strong>
-<em>angle</em>, <strong>long</strong> <em>justify</em>, <strong>long</strong> <em>mode</em>)</p>
-<blockquote>
-<div>The <em>text</em> is plotted starting at plot coordinates (<em>x</em>, <em>y</em>) and
-will make an <em>angle</em> with the horizontal. The point (<em>x</em>, <em>y</em>) maps
-onto different points of the text-string by giving various values
-for <em>justify</em> (see <strong>JUSTIFICATION</strong> for details). If <em>justify</em> is
-negative, then all leading and trailing blanks are stripped before
-plotting. Certain character sequences (flags) have special meaning
-to <strong>PSL_plottext</strong>. @~ toggles between current font and the
-Mathematical Symbols font. @%<em>no</em>% selects font <em>no</em> while @%%
-resets to the previous font. @- turns subscript on/off, @+ turns
-superscript on/off, @# turns small caps on/off, and @\ will make a
-composite character of the following two character. @;<em>r/g/b</em>;
-changes the font color while @;; resets it [optionally append
-=<em>transparency</em> to change the transparency (0–100) of the text
-(the Default is opaque or 0)], @:<em>size</em>: changes the font size
-(@:: resets it), and @_ toggles underline on/off. If <em>text</em> is NULL
-then we assume <strong>PSL_plottextbox</strong> was called first. Give
-<em>fontsize</em> in points. Normally, the text is typed using solid
-characters in the current color (set by <strong>PSL_setcolor</strong>). To draw
-outline characters, set <em>mode</em> == 1; the outline will get the
-current color and the text is filled with the current fill color
-(set by <strong>PSL_setfill</strong>). Use <em>mode</em> == 2 if the current fill is a
-pattern. If <em>fontsize</em> is negative it means that the current point
-has already been set before <strong>PSL_plottext</strong> was called and that
-(<em>x</em>, <em>y</em>) should be ignored.</div></blockquote>
-<p><strong>long PSL_plottextbox</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>double</strong> <em>x</em>,
-<strong>double</strong> <em>y</em>, <strong>double</strong> <em>fontsize</em>, <strong>char</strong> <em>*text</em>, <strong>double</strong>
-<em>angle</em>, <strong>long</strong> <em>justify</em>, <strong>double</strong> <em>offset</em>[], <strong>long</strong> <em>mode</em>)</p>
-<blockquote>
-<div>This function is used in conjugation with <strong>PSL_plottext</strong> when a
-box surrounding the text string is desired. Taking most of the
-arguments of <strong>PSL_plottext</strong>, the user must also specify <em>mode</em> to
-indicate whether the box needs rounded (PSL_YES = 1) or straight
-(PSL_NO = 0) corners. The box will be colored with the current fill
-style set by <strong>PSL_setfill</strong>. That means, if an outline is desired,
-and the color of the inside of the box should be set with that
-routine. The outline will be drawn with the current pen color (and
-width). The <em>offset</em> array holds the horizontal and vertical
-distance gaps between text and the surrounding text box in distance
-units. The smaller of the two determined the radius of the rounded
-corners (if requested).</div></blockquote>
-<p><strong>long PSL_deftextdim</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>char</strong>
-<em>*prefix</em>, <strong>double</strong> <em>fontsize</em>, <strong>char</strong> <em>*text</em>)</p>
-<blockquote>
-<div>Computes the dimensions (width and height) required by the selected
-<em>text</em> given the current font and its <em>fontsize</em> (in points). The
-values are stored as PostScript variables called <em>prefix</em>_w and
-<em>prefix</em>_h, respectively. This function can be used to compute
-dimensions and, via BF(PSL_setcommand), calculate chances to
-position a particular item should be plotted. For instance, if you
-compute a position this way and wish to plot the text there, pass
-the coordinates to <strong>PSL_plottext</strong> as NaNs. If <em>prefix</em> is BF(-w),
-BF(-h), BF(-d) or BF(-b), no PostScript variables will be
-assigned, but the values of width, height, depth, or both width and
-height will be left on the PostScript stack.</div></blockquote>
-<p><strong>long PSL_setparagraph</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>double</strong>
-<em>line_space</em>, <strong>double</strong> <em>par_width</em>, <strong>long</strong> <em>par_just</em>)</p>
-<blockquote>
-<div>Initialize common settings to be used when typesetting paragraphs of
-text with <strong>PSL_plotparagraph</strong>. Specify the line spacing (1 equals
-the font size) and paragraph width (in distance units). Text can be
-aligned left (PSL_BL), centered (PSL_BC), right (PSL_BR), or
-justified (PSL_JUST) and is controlled by <em>par_just</em>.</div></blockquote>
-<p><strong>long PSL_plotparagraphbox</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>,
-<strong>double</strong> <em>x</em>, <strong>double</strong> <em>y</em>, <strong>double</strong> <em>fontsize</em>, <strong>char</strong>
-<em>*text</em>, <strong>double</strong> <em>angle</em>, <strong>long</strong> <em>justify</em>, <strong>double</strong>
-<em>offset</em>[], <strong>long</strong> <em>mode</em>)</p>
-<blockquote>
-<div>Computes and plots the text rectangle for a paragraph using the
-specified <em>fontsize</em> (in points). Here, <em>text</em> is an array of
-the text to be typeset, using the settings initialized by
-<strong>PSL_setparagraph</strong>. The escape sequences described for
-<strong>PSL_plottext</strong> can be used to modify the text. Separate text
-into several paragraphs by appending \r to the last item in a
-paragraph. The whole text block is positioned at plot
-coordinates <em>x</em>, <em>y</em>, which is mapped to a point on the block
-specified by <em>justify</em> (see <strong>JUSTIFICATION</strong> for details). The
-whole block is then shifted by the amounts <em>shift</em>[]. The box
-will be plotted using the current fill and outline settings. The
-<em>offset</em> array holds the horizontal and vertical distance gaps
-between text and the surrounding text box in distance units. Use
-<em>mode</em> to indicate whether the box should be straight
-(PSL_RECT_STRAIGHT = 0), rounded (PSL_RECT_ROUNDED = 1),
-convex (PSL_RECT_CONVEX = 2) or concave (PSL_RECT_CONCAVE = 3).</div></blockquote>
-<p><strong>long PSL_plotparagraph</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>double</strong>
-<em>x</em>, <strong>double</strong> <em>y</em>, <strong>double</strong> <em>fontsize</em>, <strong>char</strong> <em>*text</em>,
-<strong>double</strong> <em>angle</em>, <strong>long</strong> <em>justify</em>, <strong>long</strong> <em>mode</em>)</p>
-<blockquote>
-<div>Typesets paragraphs of text using the specified <em>fontsize</em> (in
-points). Here, <em>text</em> is an array of the text to be typeset,
-using the settings initialized by <strong>PSL_setparagraph</strong>. The
-escape sequences described for <strong>PSL_plottext</strong> can be used to
-modify the text. Separate text into several paragraphs by
-appending \r to the last item in a paragraph. The whole text
-block is positioned at plot coordinates <em>x</em>, <em>y</em>, which is
-mapped to a point on the block specified by <em>justify</em> (see
-<strong>JUSTIFICATION</strong> for details). See <strong>PSL_plotparagraphbox</strong>
-for laying down the surrounding text rectangle first.</div></blockquote>
-<p><strong>long PSL_plottextline</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>double</strong>
-<em>*xpath</em>, <strong>double</strong> <em>*ypath</em>, <strong>long</strong> <em>*np</em>, <strong>long</strong> <em>nseg</em>,
-<strong>void</strong> <em>*arg1</em>, <strong>void</strong> <em>*arg2</em>, <strong>char</strong> <em>*text</em>[],
-<strong>double</strong> <em>angle</em>[], <strong>long</strong> <em>n_per_seg</em>[], <strong>double</strong> <em>fontsize,
-***long*</em> <em>justify</em>, <strong>double</strong> <em>offset</em>[], <strong>long</strong> <em>mode</em>)</p>
-<blockquote>
-<div>Please text along one or more path segments. The function does
-different things depending on the bit flags in <em>mode</em>. A key
-distinction occurs if the bit flag contains the bit PSL_TXT_CURVED
-(64) which means we wish to typeset the text along a variable and curved
-baseline given by the segments in <em>xpath, ypath</em>; otherwise we set
-straight text (possibly at an angle) and the <em>xpath, ypath</em> are
-not considered for text placement [If no line drawing is desired
-then these two arrays may be NULL]. We will describe the action
-taken for each bit value. Multiple values may be passed at the
-same time and we processes from low to hight bit.
-PSL_TXT_INIT: When mode contains this bit (1) we will initialize
-all the required variables and store them in the PostScript file.
-PSL_TXT_SHOW: We wish to see the text strings (otherwise they may
-only serve as guides to set up clip paths).
-PSL_TXT_CLIP_ON: Use the text and the paths to set up clip paths.
-PSL_TXT_DRAW: Draw the lines defined by the <em>xpath, ypath</em> arrays.
-PSL_TXT_CLIP_OFF: Turn the text path clipping off.
-We pass the text strings via <em>text</em>. The locations of text plotting
-depends on whether PSL_TXT_CURVED is selected. If it is then
-you must pass as <em>arg1</em> the <em>node</em> array indicating at which
-node in the <em>xpath, ypath</em> array the text will be plotted; let
-<em>arg2</em> be NULL. For
-straight baselines you must instead pass another set of x,y
-coordinates with the locations of the text label placements
-via <em>arg1, arg2</em>.
-Each label has its own entry in the
-<em>angle</em> array. The <em>text</em> is an array of text pointers to the
-individual text items. The
-<em>offset</em> array holds the x and y distance gaps between text and
-the surrounding text box in user units (the clip path is the
-combination of all these text boxes). Use <em>justify</em> to specify
-how the text string relates to the coordinates (see
-BF(JUSTIFICATION) for details).
-PSL_TXT_FILLBOX (128) will fill the text box (this requires you
-to first define the text box rgb color with <strong>PSL_define_rgb</strong>
-by setting a local PostScript variable that must be called PSL_setboxrgb).
-PSL_TXT_DRAWBOX (256) will draw the text box outlines (this requires
-you to first define the text box pen with <strong>PSL_define_pen</strong> by setting a local
-PostScript variable that must be called PSL_setboxpen). Before
-calling this function you must also initialize a PSL array for
-line pens and text fonts.</div></blockquote>
-</div>
-<div class="section" id="clipping">
-<h2>Clipping<a class="headerlink" href="#clipping" title="Permalink to this headline">¶</a></h2>
-<p>Here are functions used to activate and deactivate clipping regions.</p>
-<p><strong>long PSL_beginclipping</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>double</strong> <em>x</em>,
-<strong>double</strong> <em>y</em>, <strong>long</strong> <em>n</em>, <strong>double</strong> <em>rgb</em>[], <strong>long</strong> <em>flag</em>)</p>
-<blockquote>
-<div>Sets up a user-definable clip path as a series on <em>n</em> points with
-plot coordinates (<em>x</em>, <em>y</em>). Plotting outside this polygon will be
-clipped until <strong>PSL_endclipping</strong> is called. If <em>rgb</em>[0] = -1 the
-inside of the path is left empty, otherwise it is filled with the
-specified color. <em>flag</em> is used to create complex clip paths
-consisting of several disconnected regions, and takes on values 0-3.
-<em>flag</em> = PSL_PEN_MOVE_ABS (1) means
-this is the first path in a multisegment clip path. <em>flag</em> =
-PSL_PEN_DRAW_ABS (2) means this is
-the last segment. Thus, for a single path, <em>flag</em> =
-PSL_PEN_DRAW_AND_STROKE_ABS (3).</div></blockquote>
-<p><strong>long PSL_endclipping</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>long</strong> <em>mode</em>)</p>
-<blockquote>
-<div>Depending on the <em>mode</em> it restores the clip path. The <em>mode</em> values
-can be: -<em>n</em> will restore <em>n</em> levels of text-based clipping, <em>n</em>
-will restore <em>n</em> levels of polygon clipping, PSL_ALL_CLIP_TXT
-will undo all levels of text-based clipping, and PSL_ALL_CLIP_POL
-will undo all levels of polygon-based clipping.</div></blockquote>
-</div>
-<div class="section" id="id5">
-<h2><a class="reference external" href="#toc12">Miscellaneous Functions</a><a class="headerlink" href="#id5" title="Permalink to this headline">¶</a></h2>
-<p>Here are functions used to issue comments or to pass custom PostScript
-commands directly to the output PostScript file. In C these functions
-are declared as macros and they can accept a variable number of
-arguments. However, from FORTRAN only a single text argument may be
-passed.</p>
-<dl class="docutils">
-<dt><strong>long PSL_setcommand</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>char</strong> <em>*text</em>)</dt>
-<dd>Writes a raw PostScript command to the PostScript output file,
-e.g., “1 setlinejoin0.</dd>
-<dt><strong>long PSL_comment</strong> (<strong>struct PSL_CTRL</strong> <em>*P</em>, <strong>char</strong> <em>*text</em>)</dt>
-<dd>Writes a comment (<em>text</em>) to the PostScript output file, e.g.,
-“Start of graph 20. The comment are prefixed with with %% .</dd>
-</dl>
-</div>
-<div class="section" id="authors">
-<h2>Authors<a class="headerlink" href="#authors" title="Permalink to this headline">¶</a></h2>
-<p>Paul Wessel, School of Ocean and Earth Science and Technology,
-<a class="reference external" href="http://www.soest.hawaii.edu.">http://www.soest.hawaii.edu.</a></p>
-<p>Remko Scharroo, EUMETSAT, Darmstadt, Germany,
-<a class="reference external" href="http://www.eumetsat.int.">http://www.eumetsat.int.</a></p>
-</div>
-<div class="section" id="bugs">
-<h2>Bugs<a class="headerlink" href="#bugs" title="Permalink to this headline">¶</a></h2>
-<p>Caveat Emptor: The authors are <strong>not</strong> responsible for any disasters,
-suicide attempts, or ulcers caused by correct <strong>or</strong> incorrect use of
-PSL. If you find bugs, please report them to the authors by
-electronic mail. Be sure to provide enough detail so that we can
-recreate the problem.</p>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>Adobe Systems Inc., 1990, PostScript language reference manual, 2nd
-edition, Addison-Wesley, (ISBN 0-201-18127-4).</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">pslib</a><ul>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#units">Units</a></li>
-<li><a class="reference internal" href="#color">Color</a></li>
-<li><a class="reference internal" href="#justification">Justification</a></li>
-<li><a class="reference internal" href="#initialization">Initialization</a></li>
-<li><a class="reference internal" href="#id1">Changing Settings</a></li>
-<li><a class="reference internal" href="#id2">Plotting Lines And Polygons</a></li>
-<li><a class="reference internal" href="#id3">Plotting Symbols</a></li>
-<li><a class="reference internal" href="#id4">Plotting Images</a></li>
-<li><a class="reference internal" href="#plotting-text">Plotting Text</a></li>
-<li><a class="reference internal" href="#clipping">Clipping</a></li>
-<li><a class="reference internal" href="#id5">Miscellaneous Functions</a></li>
-<li><a class="reference internal" href="#authors">Authors</a></li>
-<li><a class="reference internal" href="#bugs">Bugs</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="pslegend.html"
- title="previous chapter">pslegend</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="psmask.html"
- title="next chapter">psmask</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/pslib.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="psmask.html" title="psmask"
- >next</a> </li>
- <li class="right" >
- <a href="pslegend.html" title="pslegend"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" >PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/psmask.html b/doc_release/html/psmask.html
deleted file mode 100644
index 74f392c..0000000
--- a/doc_release/html/psmask.html
+++ /dev/null
@@ -1,392 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>psmask — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="PS" href="PS.html" />
- <link rel="next" title="psrose" href="psrose.html" />
- <link rel="prev" title="pslib" href="pslib.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="psrose.html" title="psrose"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="pslib.html" title="pslib"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" accesskey="U">PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="psmask">
-<span id="index-0"></span><h1>psmask<a class="headerlink" href="#psmask" title="Permalink to this headline">¶</a></h1>
-<p>psmask - Use data tables to clip or mask map areas with no coverage</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>psmask</strong> [ <em>table</em> ]
-<strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]
-<strong>-J</strong><em>parameters</em>
-<strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>]
-[ <strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> ]
-[ <strong>-D</strong><em>dumpfile</em> ]
-[ <strong>-G</strong><em>fill</em> ] [ <strong>-Jz</strong>|<strong>Z</strong><em>parameters</em> ] [ <strong>-K</strong> ]
-[ <strong>-N</strong> ] [ <strong>-O</strong> ] [ <strong>-P</strong> ] [ <strong>-Q</strong><em>cut</em> ]
-[ <strong>-S</strong><em>search_radius</em>[<em>unit</em>] ] [ <strong>-T</strong> ]
-[ <strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] ]
-[ <strong>-bi</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-c</strong><em>copies</em> ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] ]
-[ <strong>-r</strong> ]
-[ <strong>-t</strong>[<em>transp</em>] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>psmask</strong> <strong>-C</strong> [ <strong>-K</strong> ] [ <strong>-O</strong> ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>psmask</strong> reads a (<em>x</em>,<em>y</em>,<em>z</em>) file [or standard input] and uses
-this information to find out which grid cells are reliable. Only grid
-cells which have one or more data points are considered reliable. As an
-option, you may specify a radius of influence. Then, all grid cells that
-are within <em>radius</em> of a data point are considered reliable.
-Furthermore, an option is provided to reverse the sense of the test.
-Having found the reliable/not reliable points, <strong>psmask</strong> will either
-paint tiles to mask these nodes (with the <strong>-T</strong> switch), or use
-contouring to create polygons that will clip out regions of no interest.
-When clipping is initiated, it will stay in effect until turned off by a
-second call to <strong>psmask</strong> using the <strong>-C</strong> option.</p>
-</div>
-<div class="section" id="required">
-<h2>Required<a class="headerlink" href="#required" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]</dt>
-<dd><em>x_inc</em> [and optionally <em>y_inc</em>] is the grid spacing. Optionally,
-append a suffix modifier. <strong>Geographical (degrees) coordinates</strong>: Append
-<strong>m</strong> to indicate arc minutes or <strong>s</strong> to indicate arc seconds. If one
-of the units <strong>e</strong>, <strong>f</strong>, <strong>k</strong>, <strong>M</strong>, <strong>n</strong> or <strong>u</strong> is appended
-instead, the increment is assumed to be given in meter, foot, km, Mile,
-nautical mile or US survey foot, respectively, and will be converted to
-the equivalent degrees longitude at the middle latitude of the region
-(the conversion depends on <a class="reference internal" href="gmt.conf.html#projection-parameters"><em>PROJ_ELLIPSOID</em></a>). If /<em>y_inc</em> is given
-but set to 0 it will be reset equal to <em>x_inc</em>; otherwise it will be
-converted to degrees latitude. <strong>All coordinates</strong>: If <strong>=</strong> is appended
-then the corresponding max <em>x</em> (<em>east</em>) or <em>y</em> (<em>north</em>) may be slightly
-adjusted to fit exactly the given increment [by default the increment
-may be adjusted slightly to fit the given domain]. Finally, instead of
-giving an increment you may specify the <em>number of nodes</em> desired by
-appending <strong>+</strong> to the supplied integer argument; the increment is then
-recalculated from the number of nodes and the domain. The resulting
-increment value depends on whether you have selected a
-gridline-registered or pixel-registered grid; see <a class="reference internal" href="GMT_Docs.html#app-file-formats"><em>B. GMT File Formats</em></a> for
-details. Note: if <strong>-R</strong><em>grdfile</em> is used then the grid spacing has
-already been initialized; use <strong>-I</strong> to override the values.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-J</strong><em>parameters</em> <a class="reference internal" href="gmt.html#j-full"><em>(more ...)</em></a></dt>
-<dd>Select map projection.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-</dl>
-<p>For perspective view <strong>p</strong>, optionally append /<em>zmin</em>/<em>zmax</em>. <a class="reference internal" href="gmt.html#rz-full"><em>(more ...)</em></a> </p>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>[<em>ncols</em>][<em>type</em>]) data
-table file(s) holding a number of data columns. If no tables are given
-then we read from standard input. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> <a class="reference internal" href="gmt.html#b-full"><em>(more ...)</em></a></dt>
-<dd>Set map boundary intervals.</dd>
-<dt><strong>-C</strong></dt>
-<dd>Mark end of existing clip path. No input file is needed. Implicitly
-sets <strong>-O</strong>. Also supply <strong>-X</strong> and <strong>-Y</strong> settings if you have
-moved since the clip started.</dd>
-<dt><strong>-D</strong><em>dumpfile</em></dt>
-<dd>Dump the (x,y) coordinates of each clipping polygon to one or more
-output files (or <em>stdout</em> if <em>template</em> is not given). No plotting
-will take place. If <em>template</em> contains the C-format specifier %d
-(including modifications like %05d) then polygons will be written to
-different files; otherwise all polygons are written to the specified
-file (<em>template</em>). The files are ASCII unless
-<strong>-bo</strong> is used. See <strong>-Q</strong> to exclude small
-polygons from consideration.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] <a class="reference internal" href="gmt.html#perspective-full"><em>(more ...)</em></a></dt>
-<dd>Select perspective view. </dd>
-<dt><strong>-G</strong><em>fill</em></dt>
-<dd>Paint the clip polygons (or tiles) with a selected fill [Default is no fill].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-Jz</strong>|<strong>Z</strong><em>parameters</em> <a class="reference internal" href="gmt.html#jz-full"><em>(more ...)</em></a></dt>
-<dd>Set z-axis scaling; same syntax as <strong>-Jx</strong>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-K</strong> <a class="reference internal" href="gmt.html#k-full"><em>(more ...)</em></a></dt>
-<dd>Do not finalize the PostScript plot.</dd>
-<dt><strong>-N</strong></dt>
-<dd>Invert the sense of the test, i.e., clip regions where there is data coverage.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-O</strong> <a class="reference internal" href="gmt.html#o-full"><em>(more ...)</em></a></dt>
-<dd>Append to existing PostScript plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-P</strong> <a class="reference internal" href="gmt.html#p-full"><em>(more ...)</em></a></dt>
-<dd>Select “Portrait” plot orientation.</dd>
-<dt><strong>-Q</strong></dt>
-<dd>Do not dump polygons with less than <em>cut</em> number of points [Dumps
-all polygons]. Only applicable if <strong>-D</strong> has been specified.</dd>
-<dt><strong>-S</strong><em>search_radius</em>[<em>unit</em>]</dt>
-<dd>Sets radius of influence. Grid nodes within <em>radius</em> of a data point
-are considered reliable. [Default is 0, which means that only grid
-cells with data in them are reliable]. Append the distance unit (see
-UNITS).</dd>
-<dt><strong>-T</strong></dt>
-<dd>Plot tiles instead of clip polygons. Use <strong>-G</strong> to set tile color or
-pattern. Cannot be used with <strong>-D</strong>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] <a class="reference internal" href="gmt.html#u-full"><em>(more ...)</em></a></dt>
-<dd>Draw GMT time stamp logo on plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<p><strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]]</p>
-<dl class="docutils">
-<dt><strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] <a class="reference internal" href="gmt.html#xy-full"><em>(more ...)</em></a></dt>
-<dd>Shift plot origin.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 2 input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-c</strong><em>copies</em> <a class="reference internal" href="gmt.html#c-full"><em>(more ...)</em></a></dt>
-<dd>Specify number of plot copies [Default is 1].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). Not used with binary data.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] <a class="reference internal" href="gmt.html#perspective-full"><em>(more ...)</em></a></dt>
-<dd>Select perspective view. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-r</strong> <a class="reference internal" href="gmt.html#nodereg-full"><em>(more ...)</em></a></dt>
-<dd>Set pixel node registration [gridline]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-t</strong>[<em>transp</em>] <a class="reference internal" href="gmt.html#t-full"><em>(more ...)</em></a></dt>
-<dd>Set PDF transparency level in percent.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc9">Units</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>For map distance unit, append <em>unit</em> <strong>d</strong> for arc degree, <strong>m</strong> for arc
-minute, and <strong>s</strong> for arc second, or <strong>e</strong> for meter [Default], <strong>f</strong>
-for foot, <strong>k</strong> for km, <strong>M</strong> for statute mile, <strong>n</strong> for nautical mile,
-and <strong>u</strong> for US survey foot. By default we compute such distances using
-a spherical approximation with great circles. Prepend <strong>-</strong> to a
-distance (or the unit is no distance is given) to perform “Flat Earth”
-calculations (quicker but less accurate) or prepend <strong>+</strong> to perform
-exact geodesic calculations (slower but more accurate).</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To make an overlay PostScript file that will mask out the regions of a
-contour map where there is no control data using clip polygons, use:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psmask africa_grav.xyg -R20/40/20/40 -I5m -JM10i -O -K > mask.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>We do it again, but this time we wish to save the clipping polygons to
-file all_pols.txt:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psmask africa_grav.xyg -R20/40/20/40 -I5m -Dall_pols.txt
-</pre></div>
-</div>
-</div></blockquote>
-<p>A repeat of the first example but this time we use white tiling:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psmask africa_grav.xyg -R20/40/20/40 -I5m -JM10i -T -O -K -Gwhite > mask.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="gmtcolors.html"><em>gmtcolors</em></a>,
-<a class="reference internal" href="grdmask.html"><em>grdmask</em></a>, <a class="reference internal" href="surface.html"><em>surface</em></a>,
-<a class="reference internal" href="psbasemap.html"><em>psbasemap</em></a>, <a class="reference internal" href="psclip.html"><em>psclip</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">psmask</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required">Required</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#id1">Units</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="pslib.html"
- title="previous chapter">pslib</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="psrose.html"
- title="next chapter">psrose</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/psmask.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="psrose.html" title="psrose"
- >next</a> </li>
- <li class="right" >
- <a href="pslib.html" title="pslib"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" >PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/psrose.html b/doc_release/html/psrose.html
deleted file mode 100644
index 7984baf..0000000
--- a/doc_release/html/psrose.html
+++ /dev/null
@@ -1,411 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>psrose — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="PS" href="PS.html" />
- <link rel="next" title="psscale" href="psscale.html" />
- <link rel="prev" title="psmask" href="psmask.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="psscale.html" title="psscale"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="psmask.html" title="psmask"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" accesskey="U">PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="psrose">
-<span id="index-0"></span><h1>psrose<a class="headerlink" href="#psrose" title="Permalink to this headline">¶</a></h1>
-<p>psrose - Plot a polar histogram (rose, sector, windrose diagrams)</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>psrose</strong> [ <em>table</em> ] [ <strong>-A</strong>[<strong>r</strong>]*sector_width* ]
-[ <strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> ]
-[ <strong>-C</strong>[<em>mode_file</em>] ]
-[ <strong>-D</strong> ] [ <strong>-I</strong> ] [ <strong>-G</strong><em>fill</em> ] [ <strong>-I</strong> ] [ <strong>-K</strong> ]
-[ <strong>-L</strong>[<em>wlabel</em>/<em>elabel</em>/<em>slabel</em>/<em>nlabel</em>] ] [ <strong>-M</strong><em>parameters</em> ]
-[ <strong>-O</strong> ] [ <strong>-P</strong> ]
-[ <strong>-R</strong><em>r0</em>/<em>r1</em>/<em>az_0</em>/<em>az_1</em> ]
-[ <strong>-S</strong>[<strong>n</strong>]*radial_scale* ] [ <strong>-T</strong> ]
-[ <strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W</strong>[<strong>v</strong>]<em>pen</em> ]
-[ <strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Z</strong><strong>u</strong>|<em>scale</em> ]
-[ <strong>-bi</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-c</strong><em>copies</em> ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] ]
-[ <strong>-t</strong>[<em>transp</em>] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>psrose</strong> reads (length,azimuth) pairs from <em>file</em> [or standard input]
-and generates PostScript code that will plot a windrose diagram.
-Optionally (with <strong>-A</strong>), polar histograms may be drawn (sector diagram
-or rose diagram). Options include full circle and half circle plots. The
-PostScript code is written to standard output. The outline of the
-windrose is drawn with the same color as <strong>MAP_DEFAULT_PEN</strong>.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<p>None.</p>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>[<em>ncols</em>][<em>type</em>]) data
-table file(s) holding a number of data columns. If no tables are given
-then we read from standard input. If a file with only
-azimuths are given, use <strong>-i</strong> to indicate the single column with
-azimuths; then all lengths are set to unity (see <strong>-Zu</strong> to set
-actual lengths to unity as well).</dd>
-<dt><strong>-A</strong>[<strong>r</strong>]*sector_width*</dt>
-<dd>Gives the sector width in degrees for sector and rose diagram.
-[Default 0 means windrose diagram]. Use <strong>-Ar</strong> to draw rose
-diagram instead of sector diagram.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> <a class="reference internal" href="gmt.html#b-full"><em>(more ...)</em></a></dt>
-<dd>Set map boundary intervals.</dd>
-</dl>
-<div class="line-block">
-<div class="line"><br /></div>
-<div class="line-block">
-<div class="line">Remember that “x” here is</div>
-<div class="line">radial distance and “y” is azimuth. The ylabel may be used to plot a figure caption.</div>
-</div>
-</div>
-<dl class="docutils">
-<dt><strong>-C</strong>[<em>mode_file</em>]</dt>
-<dd>Plot vectors showing the principal directions given in the <em>modes</em>
-file. If no file is given, compute and plot mean direction. See
-<strong>-M</strong> to control vector attributes.</dd>
-<dt><strong>-D</strong></dt>
-<dd>Shift sectors so that they are centered on the bin interval (e.g.,
-first sector is centered on 0 degrees).</dd>
-<dt><strong>-F</strong></dt>
-<dd>Do not draw the scale length bar [Default plots scale in lower right
-corner]</dd>
-<dt><strong>-G</strong><em>fill</em></dt>
-<dd>Selects shade, color or pattern for filling the sectors [Default is
-no fill].</dd>
-<dt><strong>-I</strong></dt>
-<dd>Inquire. Computes statistics needed to specify useful <strong>-R</strong>. No
-plot is generated.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-K</strong> <a class="reference internal" href="gmt.html#k-full"><em>(more ...)</em></a></dt>
-<dd>Do not finalize the PostScript plot.</dd>
-<dt><strong>-L</strong>[<em>wlabel</em>/<em>elabel</em>/<em>slabel</em>/<em>nlabel</em>]</dt>
-<dd>Specify labels for the 0, 90, 180, and 270 degree marks. For
-full-circle plot the default is WEST/EAST/SOUTH/NORTH and for
-half-circle the default is 90W/90E/-/0. A - in any entry disables
-that label. Use <strong>-L</strong> with no argument to disable all four labels</dd>
-<dt><strong>-M</strong><em>parameters</em></dt>
-<dd>Used with <strong>-C</strong> to modify vector parameters. For vector heads,
-append vector head <em>size</em> [Default is 0, i.e., a line]. See VECTOR
-ATTRIBUTES for specifying additional attributes.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-O</strong> <a class="reference internal" href="gmt.html#o-full"><em>(more ...)</em></a></dt>
-<dd>Append to existing PostScript plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-P</strong> <a class="reference internal" href="gmt.html#p-full"><em>(more ...)</em></a></dt>
-<dd>Select “Portrait” plot orientation.</dd>
-<dt><strong>-R</strong><em>r0</em>/<em>r1</em>/<em>az_0</em>/<em>az_1</em></dt>
-<dd>Specifies the ‘region’ of interest in (r,azimuth) space. r0 is 0, r1
-is max length in units. For azimuth, specify either -90/90 or 0/180
-for half circle plot or 0/360 for full circle.</dd>
-<dt><strong>-S</strong>[<strong>n</strong>]*radial_scale*</dt>
-<dd>Specifies radius of circle. Use <strong>-Sn</strong> to normalize input radii to
-go from 0 to 1.</dd>
-<dt><strong>-T</strong></dt>
-<dd>Specifies that the input data is orientation data (has a 180 degree
-ambiguity) instead of true 0-360 degree directions [Default].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] <a class="reference internal" href="gmt.html#u-full"><em>(more ...)</em></a></dt>
-<dd>Draw GMT time stamp logo on plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong><em>pen</em></dt>
-<dd>Set pen attributes for sector outline or rose plot. [Default is no
-outline]. Use <strong>-Wv</strong><em>pen</em> to change pen used to draw vector
-(requires <strong>-C</strong>) [Default is same as sector outline].</dd>
-</dl>
-<p><strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]]</p>
-<dl class="docutils">
-<dt><strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] <a class="reference internal" href="gmt.html#xy-full"><em>(more ...)</em></a></dt>
-<dd>Shift plot origin.</dd>
-<dt><strong>-Z</strong><em>scale</em></dt>
-<dd>Multiply the data radii by <em>scale</em>. E.g., use <strong>-Z</strong>0.001 to
-convert your data from m to km. To exclude the radii from
-consideration, set them all to unity with <strong>-Zu</strong> [Default is no
-scaling].</dd>
-<dt><strong>-:</strong></dt>
-<dd>Input file has (azimuth,radius) pairs rather than the expected
-(radius,azimuth).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 2 input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-c</strong><em>copies</em> <a class="reference internal" href="gmt.html#c-full"><em>(more ...)</em></a></dt>
-<dd>Specify number of plot copies [Default is 1].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] <a class="reference internal" href="gmt.html#perspective-full"><em>(more ...)</em></a></dt>
-<dd>Select perspective view. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-t</strong>[<em>transp</em>] <a class="reference internal" href="gmt.html#t-full"><em>(more ...)</em></a></dt>
-<dd>Set PDF transparency level in percent.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc15">Vector Attributes</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>Several modifiers may be appended to the vector-producing options to
-specify the placement of vector heads, their shapes, and the
-justification of the vector. Below, left and right refers to the
-side of the vector line when viewed from the start point to the
-end point of the segment:</p>
-<blockquote>
-<div><p><strong>+a</strong><em>angle</em> sets the angle of the vector head apex [30].</p>
-<p><strong>+b</strong> places a vector head at the beginning of the vector path [none].
-Append <strong>l</strong>|<strong>r</strong> to only draw the left or right side of this head
-[both sides].</p>
-<p><strong>+e</strong> places a vector head at the end of the vector path [none].
-Append <strong>l</strong>|<strong>r</strong> to only draw the left or right side of this head
-[both sides].</p>
-<p><strong>+g</strong>-|<em>fill</em> turns off vector head fill (if -) or sets the vector
-head fill [Default fill is used, which may be no fill].</p>
-<p><strong>+l</strong> draws half-arrows, using only the left side of specified heads [both sides].</p>
-<p><strong>+n</strong><em>norm</em> scales down vector attributes (pen thickness, head size)
-with decreasing length, where vectors shorter than <em>norm</em> will have
-their attributes scaled by length/<em>norm</em> [arrow attributes remains
-invariant to length].</p>
-<p><strong>+o</strong><em>plon</em>/<em>plat</em> specifies the oblique pole for the great or
-small circles. Only needed for great circles if <strong>+q</strong> is given.</p>
-<p><strong>+p</strong>[-][<em>pen</em>] sets the vector pen attributes. If <em>pen</em> has a
-leading - then the head outline is not drawn. [Default pen is used, and
-head outline is drawn]</p>
-<p><strong>+q</strong> means the input <em>angle</em>, <em>length</em> data instead represent the <em>start</em> and <em>stop</em>
-opening angles of the arc segment relative to the given point.</p>
-<p><strong>+r</strong> draws half-arrows, using only the right side of specified heads [both sides].</p>
-</div></blockquote>
-<p>In addition, all but circular vectors may take these modifiers:</p>
-<blockquote>
-<div><p><strong>+j</strong><em>just</em> determines how the input <em>x</em>,<em>y</em> point relates to the
-vector. Choose from <strong>b</strong>eginning [default], <strong>e</strong>nd, or <strong>c</strong>enter.</p>
-<p><strong>+s</strong> means the input <em>angle</em>, <em>length</em> is instead the <em>x</em>, <em>y</em>
-coordinates of the vector end point.</p>
-</div></blockquote>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To plot a half circle rose diagram of the data in the file
-fault_segments.az_r (containing pairs of (azimuth, length in meters),
-using a 10 degree bin sector width, on a circle of radius = 3 inch, grid
-going out to radius = 150 km in steps of 25 km with a 30 degree sector
-interval, radial direction annotated every 50 km, using a light blue
-shading outlined by a solid red pen (width = 0.75 points), draw the mean
-azimuth, and shown in Portrait orientation, use:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psrose fault_segments.az_r -R0/150/-90/90 -B50g25:"Fault
- length":/g30:."Rose diagram":-S3i -Ar10 -Glightblue
- -W0.75p,red -Z0.001 -C -P -T -: > half_rose.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>To plot a full circle wind rose diagram of the data in the file
-lines.r_az, on a circle of radius = 5 cm, grid going out to radius =
-500 units in steps of 100 with a 45 degree sector interval, using a
-solid pen (width = 0.5 point, and shown in landscape [Default]
-orientation with UNIX timestamp and command line plotted, use:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psrose lines.az_r -R0/500/0/360 -S5c -Bg100/g45:."Windrose diagram": -W0.5p -Uc | lpr
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="bugs">
-<h2>Bugs<a class="headerlink" href="#bugs" title="Permalink to this headline">¶</a></h2>
-<p>No default radial scale and grid settings for polar histograms. User
-must run <strong>psrose</strong> <strong>-I</strong> to find max length in binned data set.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>,
-<a class="reference internal" href="gmtcolors.html"><em>gmtcolors</em></a>, <a class="reference internal" href="pshistogram.html"><em>pshistogram</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">psrose</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#id1">Vector Attributes</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#bugs">Bugs</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="psmask.html"
- title="previous chapter">psmask</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="psscale.html"
- title="next chapter">psscale</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/psrose.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="psscale.html" title="psscale"
- >next</a> </li>
- <li class="right" >
- <a href="psmask.html" title="psmask"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" >PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/psscale.html b/doc_release/html/psscale.html
deleted file mode 100644
index 17163a0..0000000
--- a/doc_release/html/psscale.html
+++ /dev/null
@@ -1,395 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>psscale — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="PS" href="PS.html" />
- <link rel="next" title="pstext" href="pstext.html" />
- <link rel="prev" title="psrose" href="psrose.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="pstext.html" title="pstext"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="psrose.html" title="psrose"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" accesskey="U">PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="psscale">
-<span id="index-0"></span><h1>psscale<a class="headerlink" href="#psscale" title="Permalink to this headline">¶</a></h1>
-<p>psscale - Plot a gray or color scale-bar on maps</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>psscale</strong> <strong>-D</strong><em>xpos</em>/<em>ypos</em>/<em>length</em>/<em>width</em>[<strong>h</strong>]
-[ <strong>-A</strong>[<strong>a</strong>|<strong>l</strong>|<strong>c</strong>] ]
-[ <strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> ]
-[ <strong>-C</strong><em>cpt_file</em> ]
-[ <strong>-E</strong>[<strong>b</strong>|<strong>f</strong>][<em>length</em>][<strong>+n</strong>[<em>text</em>]] ]
-[ <strong>-G</strong><em>zlo</em>/<em>zhi</em> ]
-[ <strong>-I</strong>[<em>max_intens</em>|<em>low_i</em>/<em>high_i</em>] ]
-[ <strong>-J</strong><em>parameters</em> ]
-[ <strong>-Jz</strong>|<strong>Z</strong><em>parameters</em> ] [ <strong>-K</strong> ]
-[ <strong>-L</strong>[<strong>i</strong>][<em>gap</em>] ] [ <strong>-M</strong> ] [ <strong>-N</strong>[<strong>p</strong>|<em>dpi</em> ]] [ <strong>-O</strong> ]
-[ <strong>-P</strong> ] [ <strong>-Q</strong> ]
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ]
-[ <strong>-S</strong> ]
-[ <strong>-T</strong>[<strong>+p</strong><em>pen</em>][<strong>+g</strong><em>fill</em>][<strong>+l</strong>|<strong>r</strong>|<strong>b</strong>|<strong>t</strong><em>off</em>] ]
-[ <strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Z</strong><em>zfile</em> ]
-[ <strong>-c</strong><em>copies</em> ]
-[ <strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] ]
-[ <strong>-t</strong>[<em>transp</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>psscale</strong> plots gray scales or color scales on maps. Both horizontal
-and vertical scales are supported. For cpt_files with gradational
-colors (i.e., the lower and upper boundary of an interval have different
-colors) <strong>psscale</strong> will interpolate to give a continuous scale.
-Variations in intensity due to shading/illumination may be displayed by
-setting the option <strong>-I</strong>. Colors may be spaced according to a linear
-scale, all be equal size, or by providing a file with individual tile
-widths. The font used for the annotations along the scale and optional
-units is specified by <a class="reference internal" href="gmt.conf.html#font-annot-primary"><em>FONT_ANNOT_PRIMARY</em></a>. If a label is requested,
-it is plotted with <strong>FONT_LABEL</strong></p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-D</strong><em>xpos</em>/<em>ypos</em>/<em>length</em>/<em>width</em>[<strong>h</strong>]</dt>
-<dd>Defines the position of the center/top (for horizontal scale) or
-center/left (for vertical scale) and the dimensions of the scale.
-Give a negative length to reverse the scalebar. Append <em>h</em> to get a
-horizontal scale [Default is vertical].</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong>[<strong>a</strong>|<strong>l</strong>|<strong>c</strong>]</dt>
-<dd>Place annotations and labels above (instead of below) horizontal
-scalebars and to the left (instead of the right) of vertical
-scalebars. Append <strong>a</strong> or <strong>l</strong> to move only the annotations or the
-label to the other side. Append <strong>c</strong> if you want to print a
-vertical label as a column of characters (does not work with special characters).</dd>
-<dt><strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em></dt>
-<dd>Set annotation, tick, and gridline interval for the colorbar. The
-x-axis label will plot beneath a horizontal bar (or vertically to
-the right of a vertical bar), except when using <strong>-A</strong>. As an
-option, use the y-axis label to plot the data unit to the right of a
-horizontal bar (and above a vertical bar). When using <strong>-Ba</strong> or
-<strong>-Baf</strong> annotation and/or minor tick intervals are chosen
-automatically. If <strong>-B</strong> is omitted, or no annotation intervals are
-provided, the default is to annotate every color level based on the
-numerical entries in the cpt file (which may be overridden by ULB
-flags in the cpt file). To specify custom text annotations for
-intervals, you must append ;<em>annotation</em> to each z-slice in the cpt file.</dd>
-<dt><strong>-C</strong><em>cpt_file</em></dt>
-<dd><em>cpt_file</em> is the color palette file to be used. By default all
-color changes are annotated. To use a subset, add an extra column to
-the cpt-file with a L, U, or B to annotate Lower, Upper, or Both
-color segment boundaries (but see <strong>-B</strong>). If not given, <strong>psscale</strong>
-will read stdin. Like <strong>grdview</strong>, <strong>psscale</strong> can understand
-pattern specifications in the cpt file. For CPT files where the
-<em>z</em> range is in meters, it may be useful to change to another unit
-when plotting. To do so, append <strong>+U</strong><em>unit</em> to the file name.
-Likewise, if the CPT file uses another unit than meter and you wish
-to plot the CPT versus meters, append <strong>+u</strong><em>unit</em>.</dd>
-<dt><strong>-E</strong>[<strong>b</strong>|<strong>f</strong>][<em>length</em>][<strong>+n</strong>[<em>text</em>]]</dt>
-<dd>Add sidebar triangles for <strong>b</strong>ack- and/or <strong>f</strong>oreground
-colors. Add <strong>f</strong> or <strong>b</strong> for only one sidebar triangle [Default
-gives both]. Optionally, append triangle height [Default is half the
-barwidth]. Finally, you can plot a rectangle with the NaN color at
-the start of the bar, labeled with <em>text</em> [NaN].</dd>
-<dt><strong>-G</strong><em>zlo</em>/<em>zhi</em></dt>
-<dd>Truncate the incoming CPT so that the lowest and highest z-levels
-are to <em>zlo</em> and <em>zhi</em>. If one of these equal NaN then
-we leave that end of the CPT alone. The truncation takes place
-before the plotting.</dd>
-<dt><strong>-I</strong>[<em>max_intens</em>|<em>low_i</em>/<em>high_i</em>]</dt>
-<dd>Add illumination effects. Optionally, set the range of intensities
-from - to + <em>max_intens</em>. If not specified, 1 is used.
-Alternatively, append <em>low/high</em> intensities to specify an
-asymmetric range [Default is no illumination].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-J</strong><em>parameters</em> <a class="reference internal" href="gmt.html#j-full"><em>(more ...)</em></a></dt>
-<dd>Select map projection.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-Jz</strong>|<strong>Z</strong><em>parameters</em> <a class="reference internal" href="gmt.html#jz-full"><em>(more ...)</em></a></dt>
-<dd>Set z-axis scaling; same syntax as <strong>-Jx</strong>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-K</strong> <a class="reference internal" href="gmt.html#k-full"><em>(more ...)</em></a></dt>
-<dd>Do not finalize the PostScript plot.</dd>
-<dt><strong>-L</strong>[<strong>i</strong>][<em>gap</em>]</dt>
-<dd>Gives equal-sized color rectangles. Default scales rectangles
-according to the z-range in the cpt-file (Also see <strong>-Z</strong>). If set,
-any equal interval annotation set with <strong>-B</strong> will be ignored. If
-<em>gap</em> is appended and the cpt table is discrete we will center each
-annotation on each rectangle, using the lower boundary z-value for
-the annotation. If <strong>i</strong> is prepended we annotate the interval range
-instead. If <strong>-I</strong> is used then each rectangle will have its
-constant color modified by the specified intensity.</dd>
-<dt><strong>-M</strong></dt>
-<dd>Force a monochrome graybar using the (television) YIQ transformation.</dd>
-<dt><strong>-N</strong>[<strong>p</strong>|<em>dpi</em>]</dt>
-<dd>Controls how the color scale is represented by the PostScript language.
-To preferentially draw color rectangles (e.g., for discrete colors), append <strong>p</strong>.
-Otherwise we will preferentially draw images (e.g., for continuous colors).
-Optionally append effective dots-per-inch for rasterization of color scales [600].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-O</strong> <a class="reference internal" href="gmt.html#o-full"><em>(more ...)</em></a></dt>
-<dd>Append to existing PostScript plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-P</strong> <a class="reference internal" href="gmt.html#p-full"><em>(more ...)</em></a></dt>
-<dd>Select “Portrait” plot orientation.</dd>
-<dt><strong>-Q</strong></dt>
-<dd>Select logarithmic scale and power of ten annotations. All z-values
-in the cpt file will be converted to p = log10(z) and only integer p
-values will be annotated using the 10^p format [Default is linear
-scale].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]</dt>
-<dd><em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> specify the region of interest,
-and you may specify them in decimal degrees or in
-[+-]dd:mm[:ss.xxx][W|E|S|N] format. Append <strong>r</strong> if lower left
-and upper right map coordinates are given instead of w/e/s/n. The
-two shorthands <strong>-Rg</strong> and <strong>-Rd</strong> stand for global domain (0/360
-and -180/+180 in longitude respectively, with -90/+90 in latitude).
-Alternatively, specify the name of an existing grid file and the
-<strong>-R</strong> settings (and grid spacing, if applicable) are copied from
-the grid. Using <strong>-R</strong><em>unit</em> expects projected (Cartesian)
-coordinates compatible with chosen <strong>-J</strong> and we inversely project
-to determine actual rectangular geographic region.
-For perspective view (<strong>-p</strong>), optionally append /<em>zmin</em>/<em>zmax</em>.
-In case of perspective view (<strong>-p</strong>), a z-range (<em>zmin</em>, <em>zmax</em>)
-can be appended to indicate the third dimension. This needs to be
-done only when using the <strong>-Jz</strong> option, not when using only the
-<strong>-p</strong> option. In the latter case a perspective view of the plane is
-plotted, with no third dimension. </dd>
-</dl>
-<p>For perspective view <strong>p</strong>, optionally append /<em>zmin</em>/<em>zmax</em>. <a class="reference internal" href="gmt.html#rz-full"><em>(more ...)</em></a> </p>
-<dl class="docutils">
-<dt><strong>-S</strong></dt>
-<dd>Do not separate different color intervals with black grid lines.</dd>
-<dt><strong>-T</strong>[<strong>+p</strong><em>pen</em>][<strong>+g</strong><em>fill</em>][<strong>+l</strong>|<strong>r</strong>|<strong>b</strong>|<strong>t</strong><em>off</em>]</dt>
-<dd>Place a rectangle as background to the color scale. You must specify
-either a pen outline (with modifier <strong>+p</strong><em>pen</em>) or a fill (with
-modifier <strong>+g</strong><em>fill</em>), or both. The size of the rectangle is
-computed from <strong>-D</strong> and the current fontsize and offset parameters.
-You can add (or remove) additional space on any side by appending
-<strong>+s</strong><em>off</em>, where <strong>s</strong> is one of <strong>l</strong>eft, <strong>r</strong>ight,
-<strong>b</strong>ottom, or <strong>t</strong>op.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] <a class="reference internal" href="gmt.html#u-full"><em>(more ...)</em></a></dt>
-<dd>Draw GMT time stamp logo on plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<p><strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]]</p>
-<dl class="docutils">
-<dt><strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] <a class="reference internal" href="gmt.html#xy-full"><em>(more ...)</em></a></dt>
-<dd>Shift plot origin.</dd>
-<dt><strong>-Z</strong><em>zfile</em></dt>
-<dd>File with colorbar-width per color entry. By default, width of entry
-is scaled to color range, i.e., z = 0-100 gives twice the width as z
-= 100-150 (Also see <strong>-L</strong>).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-c</strong><em>copies</em> <a class="reference internal" href="gmt.html#c-full"><em>(more ...)</em></a></dt>
-<dd>Specify number of plot copies [Default is 1].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] <a class="reference internal" href="gmt.html#perspective-full"><em>(more ...)</em></a></dt>
-<dd>Select perspective view. (Required <strong>-R</strong> and <strong>-J</strong> for proper functioning).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-t</strong>[<em>transp</em>] <a class="reference internal" href="gmt.html#t-full"><em>(more ...)</em></a></dt>
-<dd>Set PDF transparency level in percent.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To append a vertical color scale (7.5 cm long; 1.25 cm wide) to the
-right of a plot that is 6 inch wide and 4 inch high, using illumination,
-and show back- and foreground colors, and annotating every 5 units, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psscale -D6.5i/2i/7.5c/1.25c -O -Ccolors.cpt -I -E -B5:BATHYMETRY:/:m: > map.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="notes">
-<h2>Notes<a class="headerlink" href="#notes" title="Permalink to this headline">¶</a></h2>
-<p>When the cpt file is discrete and no illumination is specified, the
-color bar will be painted using polygons. For all other cases we must
-paint with an image. Some color printers may give slightly different
-colors for the two methods given identical RGB values.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="makecpt.html"><em>makecpt</em></a>, <a class="reference internal" href="grd2cpt.html"><em>grd2cpt</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">psscale</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#notes">Notes</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="psrose.html"
- title="previous chapter">psrose</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="pstext.html"
- title="next chapter">pstext</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/psscale.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="pstext.html" title="pstext"
- >next</a> </li>
- <li class="right" >
- <a href="psrose.html" title="psrose"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" >PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/pstext.html b/doc_release/html/pstext.html
deleted file mode 100644
index 8478d46..0000000
--- a/doc_release/html/pstext.html
+++ /dev/null
@@ -1,461 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>pstext — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="PS" href="PS.html" />
- <link rel="next" title="pswiggle" href="pswiggle.html" />
- <link rel="prev" title="psscale" href="psscale.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="pswiggle.html" title="pswiggle"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="psscale.html" title="psscale"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" accesskey="U">PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="pstext">
-<span id="index-0"></span><h1>pstext<a class="headerlink" href="#pstext" title="Permalink to this headline">¶</a></h1>
-<p>pstext - Plot or typeset text on maps</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>pstext</strong> [ <em>textfiles</em> ] <strong>-J</strong><em>parameters</em>
-<strong>-R</strong><em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]
-[ <strong>-A</strong> ]
-<strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em>
-[ <strong>-D</strong>[<strong>j</strong>|<strong>J</strong>]<em>dx</em>[/<em>dy</em>][<strong>v</strong>[<em>pen</em>]] ]
-[ <strong>-F</strong>[<strong>+a</strong>[<em>angle</em>]][<strong>+c</strong>[<em>justify</em>]][<strong>+f</strong>[<em>font</em>]][<strong>+h</strong>][<strong>+j</strong>[<em>justify</em>]][<strong>+l</strong>] ]
-[ <strong>-G</strong><em>color</em> ] [ <strong>-Jz</strong>|<strong>Z</strong><em>parameters</em> ] [ <strong>-K</strong> ]
-[ <strong>-L</strong> ] [ <strong>-M</strong> ] [ <strong>-N</strong> ] [ <strong>-O</strong> ] [ <strong>-P</strong> ] [
-<strong>-Q</strong><strong>l</strong>|<strong>u</strong> ] [
-<strong>-T</strong><strong>o</strong>|<strong>O</strong>|<strong>c</strong>|<strong>C</strong> ] [
-[ <strong>-W</strong><em>pen</em> ]
-[ <strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] ]
-[ <strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] ]
-[ <strong>-Z</strong> ] [ <strong>-a</strong><em>col</em>=<em>name</em>[...] ]
-[ <strong>-c</strong><em>copies</em> ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] ]
-[ <strong>-t</strong>[<em>transp</em>] ]
-[ <strong>-o</strong><em>cols</em>[,...] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>pstext</strong> plots text strings of variable size, font type, and
-orientation. Various map projections are provided, with the option to
-draw and annotate the map boundaries. PostScript code is written to
-standard output. Greek characters, subscript, superscript, and small
-caps are supported as follows: The sequence @~ toggles between the
-selected font and Greek (Symbol). @%<em>no</em>% sets the font to <em>no</em>; @%%
-resets the font to the starting font, @- toggles subscripts on/off, @+
-toggles superscript on/off, @# toggles small caps on/off, @;<em>color</em>;
-changes the font color (@;; resets it), @:<em>size</em>: changes the font
-size (@:: resets it), and @_ toggles underline on/off. @@ prints the @
-sign. @e, @o, @a, @E, @O, @A give the accented Scandinavian characters.
-Composite characters (overstrike) may be indicated with the
-@!<char1><char2> sequence, which will print the two characters on top of
-each other. To learn the octal codes for symbols not available on the
-keyboard and some accented European characters, see Section 4.16 and
-Appendix F in the GMT Technical Reference and Cookbook. Note that
-<a class="reference internal" href="gmt.conf.html#ps-char-encoding"><em>PS_CHAR_ENCODING</em></a> must be set to an extended character set in your
-<a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file in order to use the accented characters. Using the
-<strong>-G</strong> or <strong>-W</strong> options, a rectangle underlying the text may be plotted
-(does not work for strings with sub/super scripts, symbols, or composite
-characters, except in paragraph mode (<strong>-M</strong>)).</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-J</strong><em>parameters</em> <a class="reference internal" href="gmt.html#j-full"><em>(more ...)</em></a></dt>
-<dd>Select map projection.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-</dl>
-<p>For perspective view <strong>p</strong>, optionally append /<em>zmin</em>/<em>zmax</em>. <a class="reference internal" href="gmt.html#rz-full"><em>(more ...)</em></a> </p>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>textfiles</em></dt>
-<dd>This is one or more files containing 1 or more records with (<em>x</em>,
-<em>y</em>[, <em>font</em>, <em>angle</em>, <em>justify</em>], <em>text</em>). The attributes in
-brackets can alternatively be set directly via <strong>-F</strong>. If no files
-are given, <strong>pstext</strong> will read standard input. <em>font</em> is a font
-specification with format [<em>size</em>,][<em>font</em>,][<em>color</em>] where
-<em>size</em> is text size in points, <em>font</em> is the font to use, and
-<em>color</em> sets the font color. To draw outline fonts you append
-=<em>pen</em> to the font specification. The <em>angle</em> is measured in degrees
-counter-clockwise from horizontal, and <em>justify</em> sets the alignment.
-If <em>font</em> is not an integer, then it is taken to be a text string
-with the desired fontname (see <strong>-L</strong> for available fonts). The
-alignment refers to the part of the text string that will be mapped
-onto the (<em>x</em>,<em>y</em>) point. Choose a 2 character combination of L,
-C, R (for left, center, or right) and T, M, B for top, middle, or
-bottom. e.g., BL for lower left.</dd>
-<dt><strong>-A</strong></dt>
-<dd>Angles are given as azimuths; convert them to directions using the
-current projection.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> <a class="reference internal" href="gmt.html#b-full"><em>(more ...)</em></a></dt>
-<dd>Set map boundary intervals.</dd>
-<dt><strong>-C</strong><em>dx/dy</em></dt>
-<dd>Sets the clearance between the text and the surrounding box [15%].
-Only used if <strong>-W</strong> or <strong>-G</strong> are specified. Append the unit you
-want (<strong>c</strong>m, <strong>i</strong>nch, or <strong>p</strong>oint; if not given we consult
-<a class="reference internal" href="gmt.conf.html#proj-length-unit"><em>PROJ_LENGTH_UNIT</em></a>) or % for a percentage of the font size.</dd>
-<dt><strong>-D</strong>[<strong>j</strong>|<strong>J</strong>]<em>dx</em>[/<em>dy</em>][<strong>v</strong>[<em>pen</em>]]</dt>
-<dd>Offsets the text from the projected (<em>x</em>,<em>y</em>) point by <em>dx</em>,<em>dy</em>
-[0/0]. If <em>dy</em> is not specified then it is set equal to <em>dx</em>. Use
-<strong>-Dj</strong> to offset the text away from the point instead (i.e., the
-text justification will determine the direction of the shift). Using
-<strong>-DJ</strong> will shorten diagonal offsets at corners by
-sqrt(2). Optionally, append <strong>v</strong> which will draw
-a line from the original point to the shifted point; append a <em>pen</em>
-to change the attributes for this line.</dd>
-<dt><strong>-F</strong>[<strong>+a</strong>[<em>angle</em>]][<strong>+c</strong>[<em>justify</em>]][<strong>+f</strong>[<em>font</em>]][<strong>+h</strong>][<strong>+j</strong>[<em>justify</em>]][<strong>+l</strong>]</dt>
-<dd>By default, text will be placed horizontally, using the primary
-annotation font attributes (<a class="reference internal" href="gmt.conf.html#font-annot-primary"><em>FONT_ANNOT_PRIMARY</em></a>), and centered
-on the data point. Use this option to override these defaults by
-specifying up to three text attributes (font, angle, and
-justification) directly on the command line. Use <strong>+f</strong> to set the
-font (size,fontname,color); if no font info is given then the input
-file must have this information in one of its columns. Use <strong>+a</strong> to
-set the angle; if no angle is given then the input file must have
-this as a column. Use <strong>+j</strong> to set the justification; if no
-justification is given then the input file must have this as a
-column. Items read from the data file should be in the same order as
-specified with the <strong>-F</strong> option. Example:
-<strong>-F</strong><strong>+f</strong>12p,Helvetica-Bold,red<strong>+j+a</strong> selects a 12p red
-Helvetica-Bold font and expects to read the justification and angle
-from the file, in that order, after <em>x</em>, <em>y</em> and before <em>text</em>.
-In addition, the <strong>+c</strong> justification lets us use x,y coordinates extracted from the
-<strong>-R</strong> string instead of providing them in the input file. For example <strong>-F+c</strong>TL
-gets the <em>x_min</em>, <em>y_max</em> from the <strong>-R</strong> string and plots the text
-at the Upper Left corner of the map. Normally, the text to be plotted
-comes from the data record. Instead, use <strong>+h</strong> or <strong>+l</strong> to select the
-text as the most recent segment header or segment label, respectively in
-a multisegment input file.</dd>
-<dt><strong>-G</strong><em>color</em></dt>
-<dd>Sets the shade or color used for filling the text box [Default is no
-fill]. Alternatively, use <strong>-Gc</strong> to plot the text and then use the
-text dimensions (and <strong>-C</strong>) to build clip paths and turn clipping on.
-This clipping can then be turned off later with psclip <strong>-C</strong>.
-To <strong>not</strong> plot the text but activate clipping, use <strong>-GC</strong> instead.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-Jz</strong>|<strong>Z</strong><em>parameters</em> <a class="reference internal" href="gmt.html#jz-full"><em>(more ...)</em></a></dt>
-<dd>Set z-axis scaling; same syntax as <strong>-Jx</strong>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-K</strong> <a class="reference internal" href="gmt.html#k-full"><em>(more ...)</em></a></dt>
-<dd>Do not finalize the PostScript plot.</dd>
-<dt><strong>-L</strong></dt>
-<dd>Lists the font-numbers and font-names available, then exits.</dd>
-<dt><strong>-M</strong></dt>
-<dd>Paragraph mode. Files must be multiple segment files. Segments are
-separated by a special record whose first character must be <em>flag</em>
-[Default is <strong>></strong>]. Starting in the 3rd column, we expect to find
-information pertaining to the typesetting of a text paragraph (the
-remaining lines until next segment header). The information expected
-is (<em>x y</em> [<em>font angle justify</em>] <em>linespace parwidth parjust</em>),
-where <em>x y font angle justify</em> are defined above (<em>font</em>, <em>angle</em>,
-and <em>justify</em> can be set via <strong>-F</strong>), while <em>linespace</em> and
-<em>parwidth</em> are the linespacing and paragraph width, respectively.
-The justification of the text paragraph is governed by <em>parjust</em>
-which may be <strong>l</strong>(eft), <strong>c</strong>(enter), <strong>r</strong>(ight), or
-<strong>j</strong>(ustified). The segment header is followed by one or more
-lines with paragraph text. Text may contain the escape sequences
-discussed above. Separate paragraphs with a blank line. Note that
-here, the justification set via <strong>-F+j</strong> applies to the box alignment
-since the text justification is set by <em>parjust</em>.</dd>
-<dt><strong>-N</strong></dt>
-<dd>Do NOT clip text at map boundaries [Default will clip].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-O</strong> <a class="reference internal" href="gmt.html#o-full"><em>(more ...)</em></a></dt>
-<dd>Append to existing PostScript plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-P</strong> <a class="reference internal" href="gmt.html#p-full"><em>(more ...)</em></a></dt>
-<dd>Select “Portrait” plot orientation.</dd>
-<dt><strong>-Q</strong></dt>
-<dd>Change all text to either <strong>l</strong>ower or <strong>u</strong>pper case [Default
-leaves all text as is].</dd>
-<dt><strong>-T</strong></dt>
-<dd>Specify the shape of the textbox when using <strong>-G</strong> and/or <strong>-W</strong>.
-Choose lower case <strong>o</strong> to get a straight rectangle [Default].
-Choose upper case <strong>O</strong> to get a rounded rectangle. In paragraph
-mode (<strong>-M</strong>) you can also choose lower case <strong>c</strong> to get a concave
-rectangle or upper case <strong>C</strong> to get a convex rectangle.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] <a class="reference internal" href="gmt.html#u-full"><em>(more ...)</em></a></dt>
-<dd>Draw GMT time stamp logo on plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong><em>pen</em></dt>
-<dd>Sets the pen used to draw a rectangle around the text string (see
-<strong>-T</strong>) [Default is width = default, color = black, style = solid].</dd>
-</dl>
-<p><strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]]</p>
-<dl class="docutils">
-<dt><strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] <a class="reference internal" href="gmt.html#xy-full"><em>(more ...)</em></a></dt>
-<dd>Shift plot origin.</dd>
-<dt><strong>-Z</strong></dt>
-<dd>For 3-D projections: expect each item to have its own level given in
-the 3rd column, and <strong>-N</strong> is implicitly set. (Not implemented for
-paragraph mode).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-a</strong><em>col</em>=<em>name</em>[<em>...</em>] <a class="reference internal" href="gmt.html#aspatial-full"><em>(more ...)</em></a></dt>
-<dd>Set aspatial column associations <em>col</em>=<em>name</em>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-c</strong><em>copies</em> <a class="reference internal" href="gmt.html#c-full"><em>(more ...)</em></a></dt>
-<dd>Specify number of plot copies [Default is 1].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] <a class="reference internal" href="gmt.html#perspective-full"><em>(more ...)</em></a></dt>
-<dd>Select perspective view. (Not implemented for paragraph mode).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-t</strong>[<em>transp</em>] <a class="reference internal" href="gmt.html#t-full"><em>(more ...)</em></a></dt>
-<dd>Set PDF transparency level in percent.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To plot just the red outlines of the (lon at text strings) stored in the
-file text.d on a Mercator plot with the given specifications, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt pstext text.d -R-30/30/-10/20 -Jm0.1i -P -F+f18p,Helvetica,-=0.5p,red -B5 > plot.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>To plot a text at the upper left corner of a 10 cm map</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>echo TopLeft | gmt pstext -R1/10/1/10 -JX10 -F+cTL -P > plot.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>To add a typeset figure caption for a 3-inch wide illustration, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt pstext -R0/3/0/5 -JX3i -O -H -M -N << EOF >> figure.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>This is an optional header record</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>> 0 -0.5 12 0 4 LT 13p 3i j
-@%5%Figure 1.@%% This illustration shows nothing useful, but it still needs
-a figure caption. Highlighted in @;255/0/0;red@;; you can see the locations
-of cities where it is @\_impossible@\_ to get any good Thai food; these are to be avoided.
-EOF
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="windows-remarks">
-<h2>Windows Remarks<a class="headerlink" href="#windows-remarks" title="Permalink to this headline">¶</a></h2>
-<p>Note that under Windows, the percent sign (%) is a variable indicator
-(like $ under Unix). To indicate a plain percentage sign in a batch
-script you need to repeat it (%%); hence the font switching mechanism
-(@%*font*% and @%%) may require twice the number of percent signs.
-This only applies to text inside a script or that otherwise is processed
-by DOS. Data files that are opened and read by <strong>pstext</strong> do not need
-such duplication.</p>
-</div>
-<div class="section" id="limitations">
-<h2>Limitations<a class="headerlink" href="#limitations" title="Permalink to this headline">¶</a></h2>
-<p>In paragraph mode, the presence of composite characters and other escape
-sequences may lead to unfortunate word splitting. Also, if a font is
-requested with an outline pen it will not be used in paragraph mode.
-Note if any single word is wider than your chosen paragraph width then
-the paragraph width is automatically enlarged to fit the widest word.</p>
-<p>The <strong>-N</strong> option does not adjust the BoundingBox information so you may
-have to post-process the PostScript output with ps2raster to obtain a
-correct BoundingBox.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>,
-<a class="reference internal" href="gmtcolors.html"><em>gmtcolors</em></a>,
-<a class="reference internal" href="ps2raster.html"><em>ps2raster</em></a>,
-<a class="reference internal" href="psbasemap.html"><em>psbasemap</em></a>,
-<a class="reference internal" href="pslegend.html"><em>pslegend</em></a>, <a class="reference internal" href="psxy.html"><em>psxy</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">pstext</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#windows-remarks">Windows Remarks</a></li>
-<li><a class="reference internal" href="#limitations">Limitations</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="psscale.html"
- title="previous chapter">psscale</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="pswiggle.html"
- title="next chapter">pswiggle</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/pstext.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="pswiggle.html" title="pswiggle"
- >next</a> </li>
- <li class="right" >
- <a href="psscale.html" title="psscale"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" >PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/pswiggle.html b/doc_release/html/pswiggle.html
deleted file mode 100644
index 67f7d5b..0000000
--- a/doc_release/html/pswiggle.html
+++ /dev/null
@@ -1,363 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>pswiggle — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="PS" href="PS.html" />
- <link rel="next" title="psxy" href="psxy.html" />
- <link rel="prev" title="pstext" href="pstext.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="psxy.html" title="psxy"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="pstext.html" title="pstext"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" accesskey="U">PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="pswiggle">
-<span id="index-0"></span><h1>pswiggle<a class="headerlink" href="#pswiggle" title="Permalink to this headline">¶</a></h1>
-<p>pswiggle - Plot z = f(x,y) anomalies along tracks</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>pswiggle</strong> [ <em>table</em> ] <strong>-J</strong><em>parameters</em>
-<strong>-R</strong><em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]
-[ <strong>-Z</strong><em>scale</em> [ <strong>-A</strong><em>azimuth</em> ]
-[ <strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> ]
-[ <strong>-C</strong><em>center</em> ]
-[ <strong>-G</strong>[<strong>+</strong>|<strong>-</strong>|<strong>=</strong>]<em>fill</em> ]
-[ <strong>-Jz</strong>|<strong>Z</strong><em>parameters</em> ] [ <strong>-I</strong><em>fix_az</em> ] [ <strong>-K</strong> ]
-[ <strong>-O</strong> ] [ <strong>-P</strong> ]
-[ <strong>-S</strong>[<strong>x</strong>]<em>lon0</em>/<em>lat0</em>/<em>length</em>[/<em>units</em>] ] [ <strong>-T</strong><em>pen</em> ]
-[ <strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W</strong><em>pen</em> ] [
-[ <strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] ]
-[ <strong>-bi</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-c</strong><em>copies</em> ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] ]
-[ <strong>-t</strong>[<em>transp</em>] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>pswiggle</strong> reads (<em>x</em>,<em>y</em>,<em>z</em>) triplets from files [or standard
-input] and plots z as a function of distance along track. This means
-that two consecutive (<em>x</em>,<em>y</em>) points define the local distance axis,
-and the local <em>z</em> axis is then perpendicular to the distance axis. The
-user may set a preferred positive anomaly plot direction, and if the
-positive normal is outside the plus/minus 90 degree window around the
-preferred direction, then 180 degrees are added to the direction. Either
-the positive or the negative wiggle may be shaded. The resulting
-PostScript code is written to standard output.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-J</strong><em>parameters</em> <a class="reference internal" href="gmt.html#j-full"><em>(more ...)</em></a></dt>
-<dd>Select map projection.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-</dl>
-<p>For perspective view <strong>p</strong>, optionally append /<em>zmin</em>/<em>zmax</em>. <a class="reference internal" href="gmt.html#rz-full"><em>(more ...)</em></a> </p>
-<dl class="docutils">
-<dt><strong>-Z</strong><em>scale</em></dt>
-<dd>Gives anomaly scale in data-units/distance-unit.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>[<em>ncols</em>][<em>type</em>]) data
-table file(s) holding a number of data columns. If no tables are given
-then we read from standard input. </dd>
-<dt><strong>-A</strong><em>azimuth</em></dt>
-<dd>Sets the preferred positive azimuth. Positive wiggles will
-“gravitate” towards that direction.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> <a class="reference internal" href="gmt.html#b-full"><em>(more ...)</em></a></dt>
-<dd>Set map boundary intervals.</dd>
-<dt><strong>-C</strong><em>center</em></dt>
-<dd>Subtract <em>center</em> from the data set before plotting [0].</dd>
-<dt><strong>-G</strong>[<strong>+</strong>|<strong>-</strong>|<strong>=</strong>]<em>fill</em></dt>
-<dd>Set fill shade, color or pattern for positive and/or negative
-wiggles [Default is no fill]. Optionally, prepend <strong>+</strong> to fill
-positive areas (this is the default behavior). Prepend <strong>-</strong> to fill
-negative areas. Prepend <strong>=</strong> to fill both positive and negative
-areas with the same fill.</dd>
-<dt><strong>-I</strong><em>fix_az</em></dt>
-<dd>Set a fixed azimuth projection for wiggles [Default uses track
-azimuth, but see <strong>-A</strong>].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-Jz</strong>|<strong>Z</strong><em>parameters</em> <a class="reference internal" href="gmt.html#jz-full"><em>(more ...)</em></a></dt>
-<dd>Set z-axis scaling; same syntax as <strong>-Jx</strong>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-K</strong> <a class="reference internal" href="gmt.html#k-full"><em>(more ...)</em></a></dt>
-<dd>Do not finalize the PostScript plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-O</strong> <a class="reference internal" href="gmt.html#o-full"><em>(more ...)</em></a></dt>
-<dd>Append to existing PostScript plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-P</strong> <a class="reference internal" href="gmt.html#p-full"><em>(more ...)</em></a></dt>
-<dd>Select “Portrait” plot orientation.</dd>
-<dt><strong>-S</strong>[<strong>x</strong>]<em>lon0</em>/<em>lat0</em>/<em>length</em>[/<em>units</em>]</dt>
-<dd>Draws a simple vertical scale centered on <em>lon0/lat0</em>. Use <strong>-Sx</strong>
-to specify cartesian coordinates instead. <em>length</em> is in z units,
-append unit name for labeling. <strong>FONT_ANNOT_PRIMARY</strong> is used as
-font.</dd>
-<dt><strong>-T</strong><em>pen</em></dt>
-<dd>Draw track [Default is no track]. Append pen attributes to use
-[Defaults: width = 0.25p, color = black, style = solid].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] <a class="reference internal" href="gmt.html#u-full"><em>(more ...)</em></a></dt>
-<dd>Draw GMT time stamp logo on plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<p><strong>-W</strong><em>pen</em></p>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 3 input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-c</strong><em>copies</em> <a class="reference internal" href="gmt.html#c-full"><em>(more ...)</em></a></dt>
-<dd>Specify number of plot copies [Default is 1].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] <a class="reference internal" href="gmt.html#g-full"><em>(more ...)</em></a></dt>
-<dd>Determine data gaps and line breaks. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] <a class="reference internal" href="gmt.html#perspective-full"><em>(more ...)</em></a></dt>
-<dd>Select perspective view. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-t</strong>[<em>transp</em>] <a class="reference internal" href="gmt.html#t-full"><em>(more ...)</em></a></dt>
-<dd>Set PDF transparency level in percent.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To plot the magnetic anomaly stored in the file track.xym along track @
-1000 nTesla/cm (after removing a mean value of 32000 nTesla), using a
-15-cm-wide Polar Stereographic map ticked every 5 degrees in Portrait
-mode, with positive anomalies in red on a blue track of width 0.25
-points, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt pswiggle track.xym -R-20/10/-80/-60 -JS0/90/15c -Z1000 -B5 \
- -C32000 -P -Gred -T0.25p,blue -S1000 -V > track_xym.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="bugs">
-<h2>Bugs<a class="headerlink" href="#bugs" title="Permalink to this headline">¶</a></h2>
-<p>Sometimes the (x,y) coordinates are not printed with enough significant
-digits, so the local perpendicular to the track swings around a lot. To
-see if this is the problem, you should do this:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>awk '{ if (NR > 1) print atan2(y-$1, x-$2); y=$1; x=$2; }' yourdata.xyz | more
-</pre></div>
-</div>
-</div></blockquote>
-<p>(note that output is in radians; on some machines you need “nawk” to do
-this). Then if these numbers jump around a lot, you may do this:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>awk '{ print NR, $0 }' yourdata.xyz | filter1d -Fb5 -N4/0 \
---FORMAT_FLOAT_OUT=%.12g > smoothed.xyz
-</pre></div>
-</div>
-</div></blockquote>
-<p>and plot this data set instead.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="gmtcolors.html"><em>gmtcolors</em></a>,
-<a class="reference internal" href="filter1d.html"><em>filter1d</em></a>,
-<a class="reference internal" href="psbasemap.html"><em>psbasemap</em></a>,
-<a class="reference internal" href="splitxyz.html"><em>splitxyz</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">pswiggle</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#bugs">Bugs</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="pstext.html"
- title="previous chapter">pstext</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="psxy.html"
- title="next chapter">psxy</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/pswiggle.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="psxy.html" title="psxy"
- >next</a> </li>
- <li class="right" >
- <a href="pstext.html" title="pstext"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" >PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/psxy.html b/doc_release/html/psxy.html
deleted file mode 100644
index 5255160..0000000
--- a/doc_release/html/psxy.html
+++ /dev/null
@@ -1,792 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>psxy — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="PS" href="PS.html" />
- <link rel="next" title="psxyz" href="psxyz.html" />
- <link rel="prev" title="pswiggle" href="pswiggle.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="psxyz.html" title="psxyz"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="pswiggle.html" title="pswiggle"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" accesskey="U">PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="psxy">
-<span id="index-0"></span><h1>psxy<a class="headerlink" href="#psxy" title="Permalink to this headline">¶</a></h1>
-<p>psxy - Plot lines, polygons, and symbols on maps</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>psxy</strong> [ <em>table</em> ] <strong>-J</strong><em>parameters</em>
-<strong>-R</strong><em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]
-[ <strong>-A</strong>[<strong>m</strong>|<strong>p</strong>] ]
-[ <strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> ]
-[ <strong>-C</strong><em>cptfile</em> ] [ <strong>-D</strong><em>dx</em>/<em>dy</em> ]
-[ <strong>-E</strong>[<strong>x</strong>|<strong>y</strong>|<strong>X</strong>|<strong>Y</strong>][<strong>n</strong>][<em>cap</em>][/[<strong>-</strong>|<strong>+</strong>]<em>pen</em>] ]
-[ <strong>-G</strong><em>fill</em> ] [ <strong>-I</strong><em>intens</em> ]
-[ <strong>-Jz</strong>|<strong>Z</strong><em>parameters</em> ] [ <strong>-K</strong> ] [ <strong>-L</strong> ] [ <strong>-N</strong> ]
-[ <strong>-O</strong> ] [ <strong>-P</strong> ]
-[ <strong>-S</strong>[<em>symbol</em>][<em>size</em>[<strong>u</strong>] ]
-[ <strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W</strong>[<strong>-</strong>|<strong>+</strong>][<em>pen</em>] ]
-[ <strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] ]
-[ <strong>-a</strong><em>col</em>=<em>name</em>[<em>...</em>] ]
-[ <strong>-bi</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-c</strong><em>copies</em> ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] ]
-[ <strong>-t</strong>[<em>transp</em>] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>psxy</strong> reads (<em>x</em>,<em>y</em>) pairs from <em>files</em> [or standard input] and
-generates PostScript code that will plot lines, polygons, or symbols
-at those locations on a map. If a symbol is selected and no symbol size
-given, then <strong>psxy</strong> will interpret the third column of the input data
-as symbol size. Symbols whose <em>size</em> is <= 0 are skipped. If no symbols
-are specified then the symbol code (see <strong>-S</strong> below) must be present as
-last column in the input. If <strong>-S</strong> is not used, a line connecting the
-data points will be drawn instead. To explicitly close polygons, use
-<strong>-L</strong>. Select a fill with <strong>-G</strong>. If <strong>-G</strong> is set, <strong>-W</strong> will control
-whether the polygon outline is drawn or not. If a symbol is selected,
-<strong>-G</strong> and <strong>-W</strong> determines the fill and outline/no outline,
-respectively. The PostScript code is written to standard output.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-J</strong><em>parameters</em> <a class="reference internal" href="gmt.html#j-full"><em>(more ...)</em></a></dt>
-<dd>Select map projection.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-</dl>
-<p>For perspective view <strong>p</strong>, optionally append /<em>zmin</em>/<em>zmax</em>. <a class="reference internal" href="gmt.html#rz-full"><em>(more ...)</em></a> </p>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>[<em>ncols</em>][<em>type</em>]) data
-table file(s) holding a number of data columns. If no tables are given
-then we read from standard input. Use <strong>-T</strong> to ignore all input files, including standard input (see below).</dd>
-<dt><strong>-A</strong>[<strong>m</strong>|<strong>p</strong>]</dt>
-<dd>By default line segments are drawn as great circle arcs. To draw them as
-straight lines, use the <strong>-A</strong> flag. Alternatively, add <strong>m</strong> to draw
-the line by first following a meridian, then a parallel. Or append <strong>p</strong>
-to start following a parallel, then a meridian. (This can be practical
-to draw a line along parallels, for example).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> <a class="reference internal" href="gmt.html#b-full"><em>(more ...)</em></a></dt>
-<dd>Set map boundary intervals.</dd>
-<dt><strong>-C</strong><em>cptfile</em></dt>
-<dd>Give a color palette file. If <strong>-S</strong> is set, let symbol fill color be
-determined by the z-value in the third column. Additional fields are
-shifted over by one column (optional size would be 4th rather than 3rd
-field, etc.). If <strong>-S</strong> is not set, then <strong>psxy</strong> expects the user to
-supply a multisegment file where each segment header contains a
-<strong>-Z</strong><em>val</em> string. The <em>val</em> will control the color of the line or
-polygon (if <strong>-L</strong> is set) via the cpt file.</dd>
-<dt><strong>-D</strong><em>dx</em>/<em>dy</em></dt>
-<dd>Offset the plot symbol or line locations by the given amounts <em>dx/dy</em>
-[Default is no offset]. If <em>dy</em> is not given it is set equal to <em>dx</em>.</dd>
-<dt><strong>-E</strong>[<strong>x</strong>|<strong>y</strong>|<strong>X</strong>|<strong>Y</strong>][<strong>n</strong>][<em>cap</em>][/[<strong>-</strong>|<strong>+</strong>]<em>pen</em>]</dt>
-<dd>Draw error bars. Append <strong>x</strong> and/or <strong>y</strong> to indicate which bars you
-want to draw (Default is both x and y). The x and/or y errors must be
-stored in the columns after the (x,y) pair [or (x,y,size) triplet]. The
-<em>cap</em> parameter indicates the length of the end-cap on the error bars
-[7<strong>p</strong>]. Pen attributes for error bars may also be set [Defaults: width
-= default, color = black, style = solid]. A leading <strong>+</strong> will use the
-lookup color (via <strong>-C</strong>) for both symbol fill and error pen color,
-while a leading <strong>-</strong> will set error pen color and turn off symbol fill.
-If upper case <strong>X</strong> and/or <strong>Y</strong> is used we will instead draw
-“box-and-whisker” (or “stem-and-leaf”) symbols. The x (or y) coordinate
-is then taken as the median value, and 4 more columns are expected to
-contain the minimum (0% quantile), the 25% quantile, the 75% quantile,
-and the maximum (100% quantile) values. The 25-75% box may be filled by
-using <strong>-G</strong>. If <strong>n</strong> is appended to <strong>X</strong> (or <strong>Y</strong>) we draw a notched
-“box-and-whisker” symbol where the notch width reflects the uncertainty
-in the median. Then a 5th extra data column is expected to contain the
-number of points in the distribution.</dd>
-<dt><strong>-G</strong><em>fill</em></dt>
-<dd>Select color or pattern for filling of symbols or polygons [Default is no fill].
-Note that <strong>psxy</strong> will search for <strong>-G</strong> and <strong>-W</strong> strings in all the
-segment headers and let any values thus found over-ride the command line settings.</dd>
-<dt><strong>-I</strong><em>intens</em></dt>
-<dd>Use the supplied <em>intens</em> value (nominally in the -1 to + 1 range) to
-modulate the fill color by simulating illumination [none].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-Jz</strong>|<strong>Z</strong><em>parameters</em> <a class="reference internal" href="gmt.html#jz-full"><em>(more ...)</em></a></dt>
-<dd>Set z-axis scaling; same syntax as <strong>-Jx</strong>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-K</strong> <a class="reference internal" href="gmt.html#k-full"><em>(more ...)</em></a></dt>
-<dd>Do not finalize the PostScript plot.</dd>
-<dt><strong>-L</strong></dt>
-<dd>Force closed polygons: connect the endpoints of the line-segment(s) and
-draw polygons. Also, in concert with <strong>-C</strong> and any <strong>-Z</strong> settings in
-the headers will use the implied color for polygon fill [Default is
-polygon pen color].</dd>
-<dt><strong>-N</strong></dt>
-<dd>Do NOT skip symbols that fall outside map border [Default plots points
-inside border only]. The option does not apply to lines and polygons
-which are always clipped to the map region.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-O</strong> <a class="reference internal" href="gmt.html#o-full"><em>(more ...)</em></a></dt>
-<dd>Append to existing PostScript plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-P</strong> <a class="reference internal" href="gmt.html#p-full"><em>(more ...)</em></a></dt>
-<dd>Select “Portrait” plot orientation.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-S</strong>[<em>symbol</em>][<em>size</em>[<strong>u</strong>]]</dt>
-<dd><p class="first">Plot symbols. If present, <em>size</em> is symbol size in the unit set in
-<a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> (unless <strong>c</strong>, <strong>i</strong>, or <strong>p</strong> is appended). If the symbol
-code (see below) is not given it will be read from the last column in
-the input data; this cannot be used in conjunction with binary input.
-Optionally, append <strong>c</strong>, <strong>i</strong>, or
-<strong>p</strong> to indicate that the size information in the input data is in
-units of cm, inch, or point, respectively [Default is
-<a class="reference internal" href="gmt.conf.html#proj-length-unit"><em>PROJ_LENGTH_UNIT</em></a>]. Note: if you provide <em>both</em> size and symbol via the
-input file you must use <a class="reference internal" href="gmt.conf.html#proj-length-unit"><em>PROJ_LENGTH_UNIT</em></a> to indicate the unit
-used for the symbol size or append the units to the sizes in the file.
-If symbol sizes are expected via the third data column then you may convert
-those values to suitable symbol sizes via the <strong>-i</strong> mechanism.</p>
-<p>The uppercase symbols <strong>A</strong>, <strong>C</strong>, <strong>D</strong>, <strong>G</strong>, <strong>H</strong>, <strong>I</strong>, <strong>N</strong>,
-<strong>S</strong>, <strong>T</strong> are normalized to have the same area as a circle with
-diameter <em>size</em>, while the size of the corresponding lowercase symbols
-refers to the diameter of a circumscribed circle.</p>
-<p>You can change symbols by adding the required <strong>-S</strong> option to any of
-your multisegment headers.</p>
-<p>Choose between these symbol codes:</p>
-<dl class="last docutils">
-<dt><strong>-S-</strong></dt>
-<dd>x-dash (-). <em>size</em> is the length of a short horizontal (x-dir) line segment.</dd>
-<dt><strong>-S+</strong></dt>
-<dd>plus (+). <em>size</em> is diameter of circumscribing circle.</dd>
-<dt><strong>-Sa</strong></dt>
-<dd>st<strong>a</strong>r. <em>size</em> is diameter of circumscribing circle.</dd>
-<dt><strong>-Sb</strong>[<em>size</em>[<strong>c</strong>|<strong>i</strong>|<strong>p</strong>|<strong>u</strong>]][<strong>b</strong>[<em>base</em>]]</dt>
-<dd>Vertical <strong>b</strong>ar extending from <em>base</em> to y. <em>size</em> is bar width.
-Append <strong>u</strong> if <em>size</em> is in x-units [Default is plot-distance units].
-By default, <em>base</em> = ymin. Append <strong>b</strong>[<em>base</em>] to change this
-value. If <em>base</em> is not appended then we read it from the last input
-data column.</dd>
-<dt><strong>-SB</strong>[<em>size</em>[<strong>c</strong>|<strong>i</strong>|<strong>p</strong>|<strong>u</strong>]][<strong>b</strong>[<em>base</em>]]</dt>
-<dd>Horizontal <strong>b</strong>ar extending from <em>base</em> to x. <em>size</em> is bar width.
-Append <strong>u</strong> if <em>size</em> is in y-units [Default is plot-distance units].
-By default, <em>base</em> = xmin. Append <strong>b</strong>[<em>base</em>] to change this
-value. If <em>base</em> is not appended then we read it from the last input
-data column.</dd>
-<dt><strong>-Sc</strong></dt>
-<dd><strong>c</strong>ircle. <em>size</em> is diameter of circle.</dd>
-<dt><strong>-Sd</strong></dt>
-<dd><strong>d</strong>iamond. <em>size</em> is diameter of circumscribing circle.</dd>
-<dt><strong>-Se</strong></dt>
-<dd><strong>e</strong>llipse. Direction (in degrees counter-clockwise from horizontal),
-major_axis, and minor_axis must be found in columns 3, 4, and 5.</dd>
-<dt><strong>-SE</strong></dt>
-<dd>Same as <strong>-Se</strong>, except azimuth (in degrees east of north) should be
-given instead of direction. The azimuth will be mapped into an angle
-based on the chosen map projection (<strong>-Se</strong> leaves the directions
-unchanged.) Furthermore, the axes lengths must be given in km instead of
-plot-distance units. An exception occurs for a linear projection in
-which we assume the ellipse axes are given in the same units as <strong>-R</strong>.
-For degenerate ellipses (circles) with diameter given in km, use <strong>-SE-</strong>.</dd>
-<dt><strong>-Sf</strong><em>gap</em>[/<em>size</em>][<strong>+l</strong>|<strong>+r</strong>][<strong>+b+c+f+s+t</strong>][<strong>+o</strong><em>offset</em>].</dt>
-<dd>Draw a <strong>f</strong>ront. Supply distance gap between symbols and symbol size. If <em>gap</em> is
-negative, it is interpreted to mean the number of symbols along the
-front instead. If <em>size</em> is missing it is set to 30% of the <em>gap</em>, except
-when <em>gap</em> is negative and <em>size</em> is thus required. Append <strong>+l</strong> or
-<strong>+r</strong> to plot symbols on the left or
-right side of the front [Default is centered]. Append <strong>+</strong><em>type</em> to
-specify which symbol to plot: <strong>b</strong>ox, <strong>c</strong>ircle, <strong>f</strong>ault,
-<strong>s</strong>lip, or <strong>t</strong>riangle. [Default is <strong>f</strong>ault]. Slip means
-left-lateral or right-lateral strike-slip arrows (centered is not an
-option). Append <strong>+o</strong><em>offset</em> to offset the first symbol from the
-beginning of the front by that amount [0]. Note: By placing <strong>-Sf</strong>
-options in the segment header you can change the front types on a
-segment-by-segment basis.</dd>
-<dt><strong>-Sg</strong></dt>
-<dd>octa<strong>g</strong>on. <em>size</em> is diameter of circumscribing circle.</dd>
-<dt><strong>-Sh</strong></dt>
-<dd><strong>h</strong>exagon. <em>size</em> is diameter of circumscribing circle.</dd>
-<dt><strong>-Si</strong></dt>
-<dd><strong>i</strong>nverted triangle. <em>size</em> is diameter of circumscribing circle.</dd>
-<dt><strong>-Sj</strong></dt>
-<dd>Rotated rectangle. Direction (in degrees counter-clockwise from
-horizontal), x-dimension, and y-dimension must be found in columns 3, 4,
-and 5.</dd>
-<dt><strong>-SJ</strong></dt>
-<dd>Same as <strong>-Sj</strong>, except azimuth (in degrees east of north) should be
-given instead of direction. The azimuth will be mapped into an angle
-based on the chosen map projection (<strong>-Sj</strong> leaves the directions
-unchanged.) Furthermore, the dimensions must be given in km instead of
-plot-distance units. An exception occurs for a linear projection in
-which we assume the dimensions are given in the same units as <strong>-R</strong>.</dd>
-<dt><strong>-Sk</strong></dt>
-<dd><strong>k</strong>ustom symbol. Append <em>name</em>/<em>size</em>, and we will look for a
-definition file called <em>name</em>.def in (1) the current
-directory or (2) in ~/.gmt or (3) in
-<strong>$GMT_SHAREDIR</strong>/custom. The symbol as defined in that file is of size
-1.0 by default; the appended <em>size</em> will scale symbol accordingly. Users
-may add their own custom *.def files; see CUSTOM SYMBOLS below.</dd>
-<dt><strong>-Sl</strong></dt>
-<dd><strong>l</strong>etter or text string (less than 256 characters). Give size, and
-append <strong>+t</strong><em>string</em> after the size. Note that the size is only approximate;
-no individual scaling is done for different characters. Remember to
-escape special characters like *. Optionally, you may append <strong>+f</strong><em>font</em>
-to select a particular font [Default is <a class="reference internal" href="gmt.conf.html#font-annot-primary"><em>FONT_ANNOT_PRIMARY</em></a>] and
-<strong>+j</strong><em>justify</em> to change justification [CM].</dd>
-<dt><strong>-Sm</strong></dt>
-<dd><strong>m</strong>ath angle arc, optionally with one or two arrow heads [Default is
-no arrow heads]. The <em>size</em> is the length of the vector head. Arc width
-is set by <strong>-W</strong>. The radius of the arc and its start and stop
-directions (in degrees counter-clockwise from horizontal) must be given
-in columns 3-5. See VECTOR ATTRIBUTES for specifying other attributes.</dd>
-<dt><strong>-SM</strong></dt>
-<dd>Same as <strong>-Sm</strong> but switches to straight angle symbol if angles subtend
-90 degrees exactly.</dd>
-<dt><strong>-Sn</strong></dt>
-<dd>pe<strong>n</strong>tagon. <em>size</em> is diameter of circumscribing circle.</dd>
-<dt><strong>-Sp</strong></dt>
-<dd><strong>p</strong>oint. No size needs to be specified (1 pixel is used).</dd>
-<dt><strong>-Sq</strong></dt>
-<dd><p class="first"><strong>q</strong>uoted line, i.e., lines with annotations such as contours. Append
-[<strong>d</strong>|<strong>D</strong>|<strong>f</strong>|<strong>l</strong>|<strong>L</strong>|<strong>n</strong>|<strong>x</strong>|<strong>X</strong>]<em>info</em>[:<em>labelinfo</em>].
-The required argument controls the placement of labels along the quoted
-lines. Choose among five controlling algorithms:</p>
-<blockquote>
-<div><dl class="docutils">
-<dt><strong>d</strong><em>dist</em>[<strong>c</strong>|<strong>i</strong>|<strong>p</strong>] or <strong>D</strong><em>dist</em>[<strong>d</strong>|<strong>e</strong>|<strong>f</strong>|<strong>k</strong>|<strong>m</strong>|<strong>M</strong>|<strong>n</strong>|<strong>s</strong>]</dt>
-<dd>For lower case <strong>d</strong>, give distances between labels on the plot in
-your preferred measurement unit <strong>c</strong> (cm), <strong>i</strong> (inch), or <strong>p</strong>
-(points), while for upper case <strong>D</strong>, specify distances in map units
-and append the unit; choose among <strong>e</strong> (m), <strong>f</strong> (foot), <strong>k</strong>
-(km), <strong>M</strong> (mile), <strong>n</strong> (nautical mile) or <strong>u</strong> (US survey foot),
-and <strong>d</strong> (arc degree), <strong>m</strong> (arc minute), or <strong>s</strong> (arc second).
-[Default is 10<strong>c</strong> or 4<strong>i</strong>]. As an option, you can append
-/<em>fraction</em> which is used to place the very first label for each
-contour when the cumulative along-contour distance equals <em>fraction
-* dist</em> [0.25].</dd>
-<dt><strong>f</strong><em>ffile.d</em></dt>
-<dd>Reads the ascii file <em>ffile.d</em> and places labels at locations in the
-file that matches locations along the quoted lines. Inexact matches
-and points outside the region are skipped.</dd>
-<dt><strong>l</strong>|<strong>L</strong><em>line1</em>[,<em>line2</em>,...]</dt>
-<dd>Give the coordinates of the end points for one or more comma-separated straight line segments.
-Labels will be placed where these lines intersect the quoted lines.
-The format of each <em>line</em> specification is <em>start_lon</em>/<em>start_lat</em>/<em>stop_lon</em>/<em>stop_lat</em>.
-Both <em>start_lon</em>/<em>start_lat</em> and <em>stop_lon</em>/<em>stop_lat</em> can be replaced by a 2-character key
-that uses the justification format employed in <strong>pstext</strong> to indicate a point on the frame or
-center of the map, given as [LCR][BMT].
-<strong>L</strong> will interpret the point pairs as defining great circles [Default is straight line].</dd>
-<dt><strong>n</strong>|<strong>N</strong><em>n_label</em></dt>
-<dd>Specifies the number of equidistant labels for quoted lines line
-[1]. Upper case <strong>N</strong> starts labeling exactly at the start of the
-line [Default centers them along the line]. <strong>N</strong>-1 places one
-justified label at start, while <strong>N</strong>+1 places one justified label
-at the end of quoted lines. Optionally, append
-/<em>min_dist</em>[<strong>c</strong>|<strong>i</strong>|<strong>p</strong>] to enforce that a
-minimum distance separation between successive labels is enforced.</dd>
-<dt><strong>x</strong>|<strong>X</strong><em>xfile.d</em></dt>
-<dd>Reads the multisegment file <em>xfile.d</em> and places labels at the
-intersections between the quoted lines and the lines in <em>xfile.d</em>.
-<strong>X</strong> will resample the lines first along great-circle arcs.
-In addition, you may optionally append
-<strong>+r</strong><em>radius</em>[<strong>c</strong>|<strong>i</strong>|<strong>p</strong>] to set a minimum
-label separation in the x-y plane [no limitation].</dd>
-</dl>
-<p>The optional <em>labelinfo</em> controls the specifics of the label
-formatting and consists of a concatenated string made up of any of
-the following control arguments:</p>
-<dl class="docutils">
-<dt><strong>+a</strong><em>angle</em></dt>
-<dd>For annotations at a fixed angle, <strong>+an</strong> for line-normal, or
-<strong>+ap</strong> for line-parallel [Default].</dd>
-<dt><strong>+c</strong><em>dx</em>[/<em>dy</em>]</dt>
-<dd>Sets the clearance between label and optional text box. Append
-<strong>c</strong>|<strong>i</strong>|<strong>p</strong> to specify the unit or % to indicate a
-percentage of the label font size [15%].</dd>
-<dt><strong>+d</strong></dt>
-<dd>Turns on debug which will draw helper points and lines to illustrate
-the workings of the quoted line setup.</dd>
-<dt><strong>+e</strong></dt>
-<dd>Delay the plotting of the text. This is used to build a clip path
-based on the text, then lay down other overlays while that clip path
-is in effect, then turning of clipping with psclip <strong>-Cs</strong> which
-finally plots the original text.</dd>
-<dt><strong>+f</strong><em>font</em></dt>
-<dd>Sets the desired font [Default <a class="reference internal" href="gmt.conf.html#font-annot-primary"><em>FONT_ANNOT_PRIMARY</em></a> with its
-size changed to 9p].</dd>
-<dt><strong>+g</strong>[<em>color</em>]</dt>
-<dd>Selects opaque text boxes [Default is transparent]; optionally
-specify the color [Default is <a class="reference internal" href="gmt.conf.html#ps-page-color"><em>PS_PAGE_COLOR</em></a>].</dd>
-<dt><strong>+j</strong><em>just</em></dt>
-<dd>Sets label justification [Default is MC]. Ignored when
-<strong>-SqN</strong>|<strong>n</strong>+|-1 is used.</dd>
-<dt><strong>+l</strong><em>label</em></dt>
-<dd>Sets the constant label text.</dd>
-<dt><strong>+L</strong><em>flag</em></dt>
-<dd><p class="first">Sets the label text according to the specified flag:</p>
-<p class="last"><strong>+Lh</strong>
-Take the label from the current segment header (first scan for
-an embedded <strong>-L</strong><em>label</em> option, if not use the first word
-following the segment flag). For multiple-word labels, enclose
-entire label in double quotes.
-<strong>+Ld</strong>
-Take the Cartesian plot distances along the line as the label;
-append <strong>c</strong>|<strong>i</strong>|<strong>p</strong> as the unit [Default is
-<a class="reference internal" href="gmt.conf.html#proj-length-unit"><em>PROJ_LENGTH_UNIT</em></a>].
-<strong>+LD</strong>
-Calculate actual map distances; append
-<strong>d|e|f|k|n|M|n|s</strong> as the unit [Default is
-<strong>d</strong>(egrees), unless label placement was based on map
-distances along the lines in which case we use the same unit
-specified for that algorithm]. Requires a map projection to be
-used.
-<strong>+Lf</strong>
-Use text after the 2nd column in the fixed label location file
-as the label. Requires the fixed label location setting.
-<strong>+Lx</strong>
-As <strong>+Lh</strong> but use the headers in the <em>xfile.d</em> instead.
-Requires the crossing file option.</p>
-</dd>
-<dt><strong>+n</strong><em>dx</em>[/<em>dy</em>]</dt>
-<dd>Nudges the placement of labels by the specified amount (append
-<strong>c</strong>|<strong>i</strong>|<strong>p</strong> to specify the units). Increments
-are considered in the coordinate system defined by the
-orientation of the line; use <strong>+N</strong> to force increments in the
-plot x/y coordinates system [no nudging]. Not allowed with <strong>+v</strong>.</dd>
-<dt><strong>+o</strong></dt>
-<dd>Selects rounded rectangular text box [Default is rectangular].
-Not applicable for curved text (<strong>+v</strong>) and only makes sense for
-opaque text boxes.</dd>
-<dt><strong>+p</strong>[<em>pen</em>]</dt>
-<dd>Draws the outline of text boxes [Default is no outline];
-optionally specify pen for outline [Default is width = 0.25p,
-color = black, style = solid].</dd>
-<dt><strong>+r</strong><em>min_rad</em></dt>
-<dd>Will not place labels where the line’s radius of curvature is
-less than <em>min_rad</em> [Default is 0].</dd>
-<dt><strong>+t</strong>[<em>file</em>]</dt>
-<dd>Saves line label x, y, and text to <em>file</em> [Line_labels.txt].
-Use <strong>+T</strong> to save x, y, angle, text instead.</dd>
-<dt><strong>+u</strong><em>unit</em></dt>
-<dd>Appends <em>unit</em> to all line labels. If <em>unit</em> starts with a
-leading hyphen (-) then there will be no space between label
-value and the unit. [Default is no unit].</dd>
-<dt><strong>+v</strong></dt>
-<dd>Specifies curved labels following the path [Default is straight
-labels].</dd>
-<dt><strong>+w</strong></dt>
-<dd>Specifies how many (<em>x</em>,<em>y</em>) points will be used to estimate
-label angles [Default is 10].</dd>
-<dt><strong>+=</strong><em>prefix</em></dt>
-<dd>Prepends <em>prefix</em> to all line labels. If <em>prefix</em> starts with a
-leading hyphen (-) then there will be no space between label
-value and the prefix. [Default is no prefix].</dd>
-</dl>
-</div></blockquote>
-<p class="last">Note: By placing <strong>-Sq</strong> options in the segment header you can change
-the quoted text attributes on a segment-by-segment basis.</p>
-</dd>
-<dt><strong>-Sr</strong></dt>
-<dd><strong>r</strong>ectangle. No size needs to be specified, but the x- and
-y-dimensions must be found in columns 3 and 4.</dd>
-<dt><strong>-SR</strong></dt>
-<dd><strong>R</strong>ounded rectangle. No size needs to be specified, but the x-
-and y-dimensions and corner radius must be found in columns 3, 4,
-and 5.</dd>
-<dt><strong>-Ss</strong></dt>
-<dd><strong>s</strong>quare. <em>size</em> is diameter of circumscribing circle.</dd>
-<dt><strong>-St</strong></dt>
-<dd><strong>t</strong>riangle. <em>size</em> is diameter of circumscribing circle.</dd>
-<dt><strong>-Sv</strong></dt>
-<dd><strong>v</strong>ector. Direction (in degrees counter-clockwise from
-horizontal) and length must be found in columns 3 and 4. The <em>size</em>
-is the length of the vector head. Vector width is set by <strong>-W</strong>. See
-VECTOR ATTRIBUTES for specifying other attributes.</dd>
-<dt><strong>-SV</strong></dt>
-<dd>Same as <strong>-Sv</strong>, except azimuth (in degrees east of north) should be
-given instead of direction. The azimuth will be mapped into an angle
-based on the chosen map projection (<strong>-Sv</strong> leaves the directions
-unchanged.) See VECTOR ATTRIBUTES for specifying other attributes.</dd>
-<dt><strong>-Sw</strong></dt>
-<dd>pie <strong>w</strong>edge. Start and stop directions (in degrees
-counter-clockwise from horizontal) for pie slice must be found in
-columns 3 and 4.</dd>
-<dt><strong>-SW</strong></dt>
-<dd>Same as <strong>-Sw</strong>, except azimuths (in degrees east of north) should
-be given instead of the two directions. The azimuths will be mapped
-into angles based on the chosen map projection (<strong>-Sw</strong> leaves the
-directions unchanged.)</dd>
-<dt><strong>-Sx</strong></dt>
-<dd>cross (x). <em>size</em> is diameter of circumscribing circle.</dd>
-<dt><strong>-Sy</strong></dt>
-<dd>y-dash (|). <em>size</em> is the length of a short vertical (y-dir) line
-segment.</dd>
-<dt><strong>-S=</strong></dt>
-<dd>geovector. Azimuth (in degrees east from north) and length (in km)
-must be found in columns 3 and 4. The <em>size</em> is the length of the
-vector head. Vector width is set by <strong>-W</strong>. See VECTOR ATTRIBUTES
-for specifying attributes.</dd>
-</dl>
-</dd>
-<dt><strong>-T</strong></dt>
-<dd>Ignore all input files, including standard input. This is the same
-as specifying /dev/null (or NUL for Windows users) as input file.
-Use this to activate only the options that are not related to
-plotting of lines or symbols, such as <strong>psxy</strong> <strong>-R</strong> <strong>-J</strong> <strong>-O</strong>
-<strong>-T</strong> to terminate a sequence of GMT plotting commands without
-producing any plotting output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] <a class="reference internal" href="gmt.html#u-full"><em>(more ...)</em></a></dt>
-<dd>Draw GMT time stamp logo on plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong>[<strong>-</strong>|<strong>+</strong>][<em>pen</em>] <a class="reference internal" href="GMT_Docs.html#wpen-attrib"><em>(more ...)</em></a></dt>
-<dd>Set pen attributes for lines or the outline of symbols [Defaults:
-width = default, color = black, style = solid]. A leading <strong>+</strong> will
-use the lookup color (via <strong>-C</strong>) for both symbol fill and outline
-pen color, while a leading <strong>-</strong> will set outline pen color and turn
-off symbol fill.</dd>
-</dl>
-<p><strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]]</p>
-<dl class="docutils">
-<dt><strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] <a class="reference internal" href="gmt.html#xy-full"><em>(more ...)</em></a></dt>
-<dd>Shift plot origin.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is the required number of columns given the chosen settings].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-a</strong><em>col</em>=<em>name</em>[<em>...</em>] <a class="reference internal" href="gmt.html#aspatial-full"><em>(more ...)</em></a></dt>
-<dd>Set aspatial column associations <em>col</em>=<em>name</em>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-c</strong><em>copies</em> <a class="reference internal" href="gmt.html#c-full"><em>(more ...)</em></a></dt>
-<dd>Specify number of plot copies [Default is 1].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] <a class="reference internal" href="gmt.html#g-full"><em>(more ...)</em></a></dt>
-<dd>Determine data gaps and line breaks. The <strong>-g</strong> option is ignored if <strong>-S</strong> is set.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] <a class="reference internal" href="gmt.html#perspective-full"><em>(more ...)</em></a></dt>
-<dd>Select perspective view. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-t</strong>[<em>transp</em>] <a class="reference internal" href="gmt.html#t-full"><em>(more ...)</em></a></dt>
-<dd>Set PDF transparency level in percent.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc15">Vector Attributes</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>Several modifiers may be appended to the vector-producing options to
-specify the placement of vector heads, their shapes, and the
-justification of the vector. Below, left and right refers to the
-side of the vector line when viewed from the start point to the
-end point of the segment:</p>
-<blockquote>
-<div><p><strong>+a</strong><em>angle</em> sets the angle of the vector head apex [30].</p>
-<p><strong>+b</strong> places a vector head at the beginning of the vector path [none].
-Append <strong>l</strong>|<strong>r</strong> to only draw the left or right side of this head
-[both sides].</p>
-<p><strong>+e</strong> places a vector head at the end of the vector path [none].
-Append <strong>l</strong>|<strong>r</strong> to only draw the left or right side of this head
-[both sides].</p>
-<p><strong>+g</strong>-|<em>fill</em> turns off vector head fill (if -) or sets the vector
-head fill [Default fill is used, which may be no fill].</p>
-<p><strong>+l</strong> draws half-arrows, using only the left side of specified heads [both sides].</p>
-<p><strong>+n</strong><em>norm</em> scales down vector attributes (pen thickness, head size)
-with decreasing length, where vectors shorter than <em>norm</em> will have
-their attributes scaled by length/<em>norm</em> [arrow attributes remains
-invariant to length].</p>
-<p><strong>+o</strong><em>plon</em>/<em>plat</em> specifies the oblique pole for the great or
-small circles. Only needed for great circles if <strong>+q</strong> is given.</p>
-<p><strong>+p</strong>[-][<em>pen</em>] sets the vector pen attributes. If <em>pen</em> has a
-leading - then the head outline is not drawn. [Default pen is used, and
-head outline is drawn]</p>
-<p><strong>+q</strong> means the input <em>angle</em>, <em>length</em> data instead represent the <em>start</em> and <em>stop</em>
-opening angles of the arc segment relative to the given point.</p>
-<p><strong>+r</strong> draws half-arrows, using only the right side of specified heads [both sides].</p>
-</div></blockquote>
-<p>In addition, all but circular vectors may take these modifiers:</p>
-<blockquote>
-<div><p><strong>+j</strong><em>just</em> determines how the input <em>x</em>,<em>y</em> point relates to the
-vector. Choose from <strong>b</strong>eginning [default], <strong>e</strong>nd, or <strong>c</strong>enter.</p>
-<p><strong>+s</strong> means the input <em>angle</em>, <em>length</em> is instead the <em>x</em>, <em>y</em>
-coordinates of the vector end point.</p>
-</div></blockquote>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To plot solid red circles (diameter = 0.25 cm) at the positions listed
-in the file DSDP.xy on a Mercator map at 5 cm/degree of the area 150E to
-154E, 18N to 23N, with tickmarks every 1 degree and gridlines every 15
-minutes, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psxy DSDP.xy R150/154/18/23 -Jm5c -Sc0.25c -Gred -B1g15m > map.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>To plot the xyz values in the file quakes.xyzm as circles with size
-given by the magnitude in the 4th column and color based on the depth in
-the third using the color palette cpt on a linear map, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psxy quakes.xyzm -R0/1000/0/1000 -JX6i -Sc -Ccpt -B200 > map.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>To plot the file trench.xy on a Mercator map, with white triangles with
-sides 0.25 inch on the left side of the line, spaced every 0.8 inch, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psxy trench.xy -R150/200/20/50 -Jm0.15i -Sf0.8i/0.1i+l+t -Gwhite -W -B10 > map.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>To plot the data in the file misc.d as symbols determined by the code in
-the last column, and with size given by the magnitude in the 4th column,
-and color based on the third column via the color palette cpt on a
-linear map, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psxy misc.d -R0/100/-50/100 -JX6i -S -Ccpt -B20 > map.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="segment-header-parsing">
-<h2>Segment Header Parsing<a class="headerlink" href="#segment-header-parsing" title="Permalink to this headline">¶</a></h2>
-<p>Segment header records may contain one of more of the following options:</p>
-<dl class="docutils">
-<dt><strong>-G</strong><em>fill</em></dt>
-<dd>Use the new <em>fill</em> and turn filling on</dd>
-<dt><strong>-G-</strong></dt>
-<dd>Turn filling off</dd>
-<dt><strong>-G</strong></dt>
-<dd>Revert to default fill (none if not set on command line)</dd>
-<dt><strong>-W</strong><em>pen</em></dt>
-<dd>Use the new <em>pen</em> and turn outline on</dd>
-<dt><strong>-W</strong></dt>
-<dd>Revert to default pen <a class="reference internal" href="gmt.conf.html#map-default-pen"><em>MAP_DEFAULT_PEN</em></a>
-(if not set on command line)</dd>
-<dt><strong>-W-</strong></dt>
-<dd>Turn outline off</dd>
-<dt><strong>-Z</strong><em>zval</em></dt>
-<dd>Obtain fill via cpt lookup using z-value <em>zval</em></dd>
-<dt><strong>-Z</strong><em>NaN</em></dt>
-<dd>Get the NaN color from the cpt file</dd>
-</dl>
-</div>
-<div class="section" id="custom-symbols">
-<h2>Custom Symbols<a class="headerlink" href="#custom-symbols" title="Permalink to this headline">¶</a></h2>
-<p><strong>psxy</strong> allows users to define and plot their own custom symbols. This
-is done by encoding the symbol using our custom symbol macro code
-described in Appendix N. Put all the macro codes for your new symbol in
-a file whose extension must be .def; you may then address the symbol
-without giving the extension (e.g., the symbol file tsunami.def is used
-by specifying <strong>-Sk</strong><em>tsunami/size</em>. The definition file can contain
-any number of plot code records, as well as blank lines and comment
-lines (starting with #). <strong>psxy</strong> will look for the definition files in
-(1) the current directory, (2) the ~/.gmt directory, and
-(3) the <strong>$GMT_SHAREDIR</strong>/custom directory, in that order.
-Freeform polygons (made up of straight line segments and arcs of
-circles) can be designed - these polygons can be painted and filled with
-a pattern. Other standard geometric symbols can also be used. See Appendix
-<a class="reference internal" href="GMT_Docs.html#app-custom-symbols"><em>M. Custom Plot Symbols</em></a> for macro definitions.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>,
-<a class="reference internal" href="gmtcolors.html"><em>gmtcolors</em></a>,
-<a class="reference internal" href="psbasemap.html"><em>psbasemap</em></a>, <a class="reference internal" href="psxyz.html"><em>psxyz</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">psxy</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#id1">Vector Attributes</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#segment-header-parsing">Segment Header Parsing</a></li>
-<li><a class="reference internal" href="#custom-symbols">Custom Symbols</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="pswiggle.html"
- title="previous chapter">pswiggle</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="psxyz.html"
- title="next chapter">psxyz</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/psxy.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="psxyz.html" title="psxyz"
- >next</a> </li>
- <li class="right" >
- <a href="pswiggle.html" title="pswiggle"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" >PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/psxyz.html b/doc_release/html/psxyz.html
deleted file mode 100644
index 95c1a15..0000000
--- a/doc_release/html/psxyz.html
+++ /dev/null
@@ -1,765 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>psxyz — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="PS" href="PS.html" />
- <link rel="next" title="S" href="S.html" />
- <link rel="prev" title="psxy" href="psxy.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="S.html" title="S"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="psxy.html" title="psxy"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" accesskey="U">PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="psxyz">
-<span id="index-0"></span><h1>psxyz<a class="headerlink" href="#psxyz" title="Permalink to this headline">¶</a></h1>
-<p>psxyz - Plot lines, polygons, and symbols in 3-D</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>psxyz</strong> [ <em>table</em> ] <strong>-J</strong><em>parameters</em>
-<strong>-Jz</strong>|<strong>Z</strong><em>parameters</em>
-<strong>-R</strong><em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]
-[ <strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> ]
-[ <strong>-D</strong><em>dx</em>/<em>dy</em>[/<em>dz</em>] ] [ <strong>-G</strong><em>fill</em> ] [ <strong>-I</strong><em>intens</em> ]
-[ <strong>-K</strong> ] [ <strong>-L</strong> ] [ <strong>-N</strong> ] [ <strong>-O</strong> ] [ <strong>-P</strong> ] [ <strong>-Q</strong> ]
-[ <strong>-S</strong>[<em>symbol</em>][<em>size</em>[<strong>unit</strong>]][/<em>size_y</em>] ]
-[ <strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W</strong>[<strong>-</strong>|<strong>+</strong>][<em>pen</em>] ]
-[ <strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] ]
-[ <strong>-a</strong><em>col</em>=<em>name</em>[<em>...</em>] ]
-[ <strong>-bi</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-c</strong><em>copies</em> ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] ]
-[ <strong>-t</strong>[<em>transp</em>] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>psxyz</strong> reads (x,y,z) triplets from <em>files</em> [or standard input] and
-generates PostScript code that will plot lines, polygons, or symbols
-at those locations in 3-D. If a symbol is selected and no symbol size
-given, then <strong>psxyz</strong> will interpret the fourth column of the input data
-as symbol size. Symbols whose <em>size</em> is <= 0 are skipped. If no symbols
-are specified then the symbol code (see <strong>-S</strong> below) must be present as
-last column in the input. If <strong>-S</strong> is not used, a line connecting the
-data points will be drawn instead. To explicitly close polygons, use
-<strong>-L</strong>. Select a fill with <strong>-G</strong>. If <strong>-G</strong> is set, <strong>-W</strong> will control
-whether the polygon outline is drawn or not. If a symbol is selected,
-<strong>-G</strong> and <strong>-W</strong> determines the fill and outline/no outline,
-respectively. The PostScript code is written to standard output.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-J</strong><em>parameters</em> <a class="reference internal" href="gmt.html#j-full"><em>(more ...)</em></a></dt>
-<dd>Select map projection.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-Jz</strong>|<strong>Z</strong><em>parameters</em> <a class="reference internal" href="gmt.html#jz-full"><em>(more ...)</em></a></dt>
-<dd>Set z-axis scaling; same syntax as <strong>-Jx</strong>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-</dl>
-<p>For perspective view <strong>p</strong>, optionally append /<em>zmin</em>/<em>zmax</em>. <a class="reference internal" href="gmt.html#rz-full"><em>(more ...)</em></a> </p>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>[<em>ncols</em>][<em>type</em>]) data
-table file(s) holding a number of data columns. If no tables are given
-then we read from standard input. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> <a class="reference internal" href="gmt.html#b-full"><em>(more ...)</em></a></dt>
-<dd>Set map boundary intervals.</dd>
-<dt><strong>-C</strong><em>cptfile</em></dt>
-<dd>Give a color palette file. If <strong>-S</strong> is set, let symbol fill color be
-determined by the t-value in the fourth column. Additional fields are
-shifted over by one column (optional size would be in 5th rather than
-4th field, etc.). If <strong>-S</strong> is not set, then <strong>psxyz</strong> expects the user
-to supply a multisegment file (where each segment header contains a
-<strong>-Z</strong><em>val</em> string. The <em>val</em> will control the color of the line or
-polygon (if <strong>-L</strong> is set) via the cpt file.</dd>
-<dt><strong>-D</strong><em>dx</em>/<em>dy</em>[/<em>dz</em>]</dt>
-<dd>Offset the plot symbol or line locations by the given amounts
-<em>dx/dy</em>[<em>dz</em>] [Default is no offset].</dd>
-<dt><strong>-G</strong><em>fill</em></dt>
-<dd>Select color or pattern for filling of symbols or polygons [Default is no fill].
-Note that <strong>psxyz</strong> will search for <strong>-G</strong> and <strong>-W</strong> strings in all the
-segment headers and let any values thus found over-ride the command line settings.</dd>
-<dt><strong>-I</strong><em>intens</em></dt>
-<dd>Use the supplied <em>intens</em> value (nominally in the -1 to + 1 range) to
-modulate the fill color by simulating illumination [none].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-K</strong> <a class="reference internal" href="gmt.html#k-full"><em>(more ...)</em></a></dt>
-<dd>Do not finalize the PostScript plot.</dd>
-<dt><strong>-L</strong></dt>
-<dd>Force closed polygons: connect the endpoints of the line-segment(s) and
-draw polygons. Also, in concert with <strong>-C</strong> and any <strong>-Z</strong> settings in
-the headers will use the implied color for polygon fill [Default is
-polygon pen color]. <strong>-N</strong> Do NOT skip symbols that fall outside map
-border [Default plots points inside border only].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-O</strong> <a class="reference internal" href="gmt.html#o-full"><em>(more ...)</em></a></dt>
-<dd>Append to existing PostScript plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-P</strong> <a class="reference internal" href="gmt.html#p-full"><em>(more ...)</em></a></dt>
-<dd>Select “Portrait” plot orientation.</dd>
-<dt><strong>-Q</strong></dt>
-<dd>Turn off the automatic sorting of items based on their distance from the
-viewer. The default is to sort the items so that items in the foreground
-are plotted after items in the background.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-S</strong>[<em>symbol</em>][<em>size</em>[<strong>u</strong>]][/<em>size_y</em>]</dt>
-<dd><p class="first">Plot symbols. If present, <em>size</em> is symbol size in the unit set in
-<a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> (unless <strong>c</strong>, <strong>i</strong>, or <strong>p</strong> is appended). If the symbol
-code (see below) is not given it will be read from the last column in
-the input data; this cannot be used in conjunction with binary input.
-Optionally, append <strong>c</strong>, <strong>i</strong>, or
-<strong>p</strong> to indicate that the size information in the input data is in
-units of cm, inch, or point, respectively [Default is
-<strong>PROJ_LENGTH_UNIT</strong>]. Note: if you give <em>both</em> size and symbol via the
-input file you must use <strong>PROJ_LENGTH_UNIT</strong> to indicate the units
-used for the symbol size or append the units to the size in the file.
-Some 2-dimensional symbols optionally take a second size via <em>size_y</em>.
-If symbol sizes are expected via the fourth data column then you may convert
-those values to suitable symbol sizes via the <strong>-i</strong> mechanism.</p>
-<p>The uppercase symbols <strong>A</strong>, <strong>C</strong>, <strong>D</strong>, <strong>G</strong>, <strong>H</strong>, <strong>I</strong>, <strong>N</strong>,
-<strong>S</strong>, <strong>T</strong> are normalized to have the same area as a circle with
-diameter <em>size</em>, while the size of the corresponding lowercase symbols
-refers to the diameter of a circumscribed circle.</p>
-<p>You can change symbols by adding the required <strong>-S</strong> option to any of
-your multisegment headers.</p>
-<p>Choose between these symbol codes:</p>
-<dl class="last docutils">
-<dt><strong>-S-</strong></dt>
-<dd>x-dash (-). <em>size</em> is the length of a short horizontal (x-dir) line segment.</dd>
-<dt><strong>-S+</strong></dt>
-<dd>plus (+). <em>size</em> is diameter of circumscribing circle.</dd>
-<dt><strong>-Sa</strong></dt>
-<dd>st<strong>a</strong>r. <em>size</em> is diameter of circumscribing circle.</dd>
-<dt><strong>-Sb</strong></dt>
-<dd>Vertical <strong>b</strong>ar extending from <em>base</em> to y. <em>size</em> is bar width.
-Append <strong>u</strong> if <em>size</em> is in x-units [Default is plot-distance units].
-By default, <em>base</em> = ymin. Append <strong>b</strong>[<em>base</em>] to change this
-value. If <em>base</em> is not appended then we read it from the last input
-data column.</dd>
-<dt><strong>-SB</strong></dt>
-<dd>Horizontal <strong>b</strong>ar extending from <em>base</em> to x. <em>size</em> is bar width.
-Append <strong>u</strong> if <em>size</em> is in y-units [Default is plot-distance units].
-By default, <em>base</em> = xmin. Append <strong>b</strong>[<em>base</em>] to change this
-value. If <em>base</em> is not appended then we read it from the last input
-data column.</dd>
-<dt><strong>-Sc</strong></dt>
-<dd><strong>c</strong>ircle. <em>size</em> is diameter of circle.</dd>
-<dt><strong>-Sd</strong></dt>
-<dd><strong>d</strong>iamond. <em>size</em> is diameter of circumscribing circle.</dd>
-<dt><strong>-Se</strong></dt>
-<dd><strong>e</strong>llipse. Direction (in degrees counter-clockwise from horizontal),
-major_axis, and minor_axis must be found in columns 4, 5, and 6.</dd>
-<dt><strong>-SE</strong></dt>
-<dd>Same as <strong>-Se</strong>, except azimuth (in degrees east of north) should be
-given instead of direction. The azimuth will be mapped into an angle
-based on the chosen map projection (<strong>-Se</strong> leaves the directions
-unchanged.) Furthermore, the axes lengths must be given in km instead of
-plot-distance units. An exception occurs for a linear projection in
-which we assume the ellipse axes are given in the same units as <strong>-R</strong>.
-For degenerate ellipses (circles) with diameter given in km, use <strong>-SE-</strong>.</dd>
-<dt><strong>-Sf</strong></dt>
-<dd><strong>f</strong>ront.
-<strong>-Sf</strong><em>gap</em>[/<em>size</em>][<strong>+l</strong>|<strong>+r</strong>][<strong>+b+c+f+s+t</strong>][<strong>+o</strong><em>offset</em>].
-Supply distance gap between symbols and symbol size. If <em>gap</em> is
-negative, it is interpreted to mean the number of symbols along the
-front instead. If <em>size</em> is missing it is set to 30% of the <em>gap</em>, except
-when <em>gap</em> is negative and <em>size</em> is thus required. Append <strong>+l</strong> or
-<strong>+r</strong> to plot symbols on the left or
-right side of the front [Default is centered]. Append <strong>+</strong><em>type</em> to
-specify which symbol to plot: <strong>b</strong>ox, <strong>c</strong>ircle, <strong>f</strong>ault,
-<strong>s</strong>lip, or <strong>t</strong>riangle. [Default is <strong>f</strong>ault]. Slip means
-left-lateral or right-lateral strike-slip arrows (centered is not an
-option). Append <strong>+o</strong><em>offset</em> to offset the first symbol from the
-beginning of the front by that amount [0]. Note: By placing <strong>-Sf</strong>
-options in the segment header you can change the front types on a
-segment-by-segment basis.</dd>
-<dt><strong>-Sg</strong></dt>
-<dd>octa<strong>g</strong>on. <em>size</em> is diameter of circumscribing circle.</dd>
-<dt><strong>-Sh</strong></dt>
-<dd><strong>h</strong>exagon. <em>size</em> is diameter of circumscribing circle.</dd>
-<dt><strong>-Si</strong></dt>
-<dd><strong>i</strong>nverted triangle. <em>size</em> is diameter of circumscribing circle.</dd>
-<dt><strong>-Sj</strong></dt>
-<dd>Rotated rectangle. Direction (in degrees counter-clockwise from
-horizontal), x-dimension, and y-dimension must be found in columns 4, 5, and 6.</dd>
-<dt><strong>-SJ</strong></dt>
-<dd>Same as <strong>-Sj</strong>, except azimuth (in degrees east of north) should be
-given instead of direction. The azimuth will be mapped into an angle
-based on the chosen map projection (<strong>-Sj</strong> leaves the directions
-unchanged.) Furthermore, the dimensions must be given in km instead of
-plot-distance units. An exception occurs for a linear projection in
-which we assume the dimensions are given in the same units as <strong>-R</strong>.</dd>
-<dt><strong>-Sk</strong></dt>
-<dd><strong>k</strong>ustom symbol. Append <name>/<em>size</em>, and we will look for a
-definition file called <name>.def in (1) the current
-directory or (2) in ~/.gmt or (3) in
-<strong>$GMT_SHAREDIR</strong>/custom. The symbol as defined in that file is of size
-1.0 by default; the appended <em>size</em> will scale symbol accordingly.
-The symbols are plotted in the <em>x-y</em> plane. Users
-may add their own custom *.def files; see CUSTOM SYMBOLS below.</dd>
-<dt><strong>-Sl</strong></dt>
-<dd><strong>l</strong>etter or text string (less than 64 characters). Give size, and
-append /<em>string</em> after the size. Note that the size is only approximate;
-no individual scaling is done for different characters. Remember to
-escape special characters like *. Optionally, you may append %<em>font</em>
-to select a particular font [Default is <strong>FONT_ANNOT_PRIMARY</strong>].</dd>
-<dt><strong>-Sm</strong></dt>
-<dd><strong>m</strong>ath angle arc, optionally with one or two arrow heads [Default is
-no arrow heads]. The <em>size</em> is the length of the vector head. Arc width
-is set by <strong>-W</strong>. The radius of the arc and its start and stop
-directions (in degrees counter-clockwise from horizontal) must be given
-in columns 4-6. See VECTOR ATTRIBUTES for specifying attributes.</dd>
-<dt><strong>-SM</strong></dt>
-<dd>Same as <strong>-Sm</strong> but switches to straight angle symbol if angles subtend
-90 degrees exactly.</dd>
-<dt><strong>-Sn</strong></dt>
-<dd>pe<strong>n</strong>tagon. <em>size</em> is diameter of circumscribing circle.</dd>
-<dt><strong>-So</strong></dt>
-<dd>c<strong>o</strong>lumn (3-D) extending from <em>base</em> to z. The <em>size</em> sets base width
-(Use <em>xsize/ysize</em> if not the same). Append <strong>u</strong> if <em>size</em> is in x-units
-[Default is plot-distance units]. If no <em>size</em> is given we expect both <em>xsize</em>
-and <em>ysize</em> as two extra data columns. By default, <em>base</em> = 0. Append
-<strong>b</strong><em>base</em> to change this value. The facet colors will be modified to
-simulate shading. Use <strong>-SO</strong> to disable such 3-D illumination.
-If <em>base</em> is not appended then we read it from the last input data column.</dd>
-<dt><strong>-Sp</strong></dt>
-<dd><strong>p</strong>oint. No size needs to be specified (1 pixel is used).</dd>
-<dt><strong>-Sq</strong></dt>
-<dd><p class="first"><strong>q</strong>uoted line, i.e., lines with annotations such as contours.
-It is assumed that each individual line has a constant <em>z</em> level
-(i.e., each line must lie in the <em>x-y</em> plane). Append
-[<strong>d</strong>|<strong>D</strong>|<strong>f</strong>|<strong>l</strong>|<strong>L</strong>|<strong>n</strong>|<strong>x</strong>|<strong>X</strong>]<em>info</em>[:<em>labelinfo</em>].
-The required argument controls the placement of labels along the quoted
-lines. Choose among five controlling algorithms:</p>
-<blockquote>
-<div><p><strong>d</strong><em>dist</em>[<strong>c</strong>|<strong>i</strong>|<strong>p</strong>] or
-<strong>D</strong><em>dist</em>[<strong>d</strong>|<strong>e</strong>|<strong>f</strong>|<strong>k</strong>|<strong>m</strong>|<strong>M</strong>|<strong>n</strong>|<strong>s</strong>]
-For lower case <strong>d</strong>, give distances between labels on the plot in
-your preferred measurement unit <strong>c</strong> (cm), <strong>i</strong> (inch), or <strong>p</strong>
-(points), while for upper case <strong>D</strong>, specify distances in map units
-and append the unit; choose among <strong>e</strong> (m), <strong>f</strong> (foot), <strong>k</strong>
-(km), <strong>M</strong> (mile), <strong>n</strong> (nautical mile) or <strong>u</strong> (US survey foot),
-and <strong>d</strong> (arc degree), <strong>m</strong> (arc minute), or <strong>s</strong> (arc second).
-[Default is 10<strong>c</strong> or 4<strong>i</strong>]. As an option, you can append
-/<em>fraction</em> which is used to place the very first label for each
-contour when the cumulative along-contour distance equals <em>fraction
-* dist</em> [0.25].
-<strong>f</strong><em>ffile.d</em>
-Reads the ascii file <em>ffile.d</em> and places labels at locations in the
-file that matches locations along the quoted lines. Inexact matches
-and points outside the region are skipped.
-<strong>l|L</strong><em>line1</em>[,*line2*,...]
-Give <em>start</em> and <em>stop</em> coordinates for one or more comma-separated
-straight line segments. Labels will be placed where these lines
-intersect the quoted lines. The format of each <em>line</em> specification
-is <em>start/stop</em>, where <em>start</em> and <em>stop</em> are either a specified
-point <em>lon/lat</em> or a 2-character <strong>XY</strong> key that uses the
-justification format employed in <strong>pstext</strong> to indicate a point on
-the map, given as [LCR][BMT]. <strong>L</strong> will interpret the point pairs
-as defining great circles [Default is straight line].
-<strong>n</strong><em>n_label</em>
-Specifies the number of equidistant labels for quoted lines line
-[1]. Upper case <strong>N</strong> starts labeling exactly at the start of the
-line [Default centers them along the line]. <strong>N</strong>-1 places one
-justified label at start, while <strong>N</strong>+1 places one justified label
-at the end of quoted lines. Optionally, append
-/<em>min_dist</em>[<strong>c</strong>|<strong>i</strong>|<strong>p</strong>] to enforce that a
-minimum distance separation between successive labels is enforced.
-<strong>x|X</strong><em>xfile.d</em>
-Reads the multisegment file <em>xfile.d</em> and places labels at the
-intersections between the quoted lines and the lines in <em>xfile.d</em>.
-<strong>X</strong> will resample the lines first along great-circle arcs.
-In addition, you may optionally append
-<strong>+r</strong><em>radius</em>[<strong>c</strong>|<strong>i</strong>|<strong>p</strong>] to set a minimum
-label separation in the x-y plane [no limitation].</p>
-<p>The optional <em>labelinfo</em> controls the specifics of the label
-formatting and consists of a concatenated string made up of any of
-the following control arguments:</p>
-<dl class="docutils">
-<dt><strong>+a</strong><em>angle</em></dt>
-<dd>For annotations at a fixed angle, <strong>+an</strong> for line-normal, or
-<strong>+ap</strong> for line-parallel [Default].</dd>
-<dt><strong>+c</strong><em>dx</em>[/<em>dy</em>]</dt>
-<dd>Sets the clearance between label and optional text box. Append
-<strong>c</strong>|<strong>i</strong>|<strong>p</strong> to specify the unit or % to indicate a
-percentage of the label font size [15%].</dd>
-<dt><strong>+d</strong></dt>
-<dd>Turns on debug which will draw helper points and lines to illustrate
-the workings of the quoted line setup.</dd>
-<dt><strong>+e</strong></dt>
-<dd>Delay the plotting of the text. This is used to build a clip path
-based on the text, then lay down other overlays while that clip path
-is in effect, then turning of clipping with psclip <strong>-Cs</strong> which
-finally plots the original text.</dd>
-<dt><strong>+f</strong><em>font</em></dt>
-<dd>Sets the desired font [Default <strong>FONT_ANNOT_PRIMARY</strong> with its
-size changed to 9p].</dd>
-<dt><strong>+g</strong>[<em>color</em>]</dt>
-<dd>Selects opaque text boxes [Default is transparent]; optionally
-specify the color [Default is <strong>PS_PAGE_COLOR</strong>].</dd>
-<dt><strong>+j</strong><em>just</em></dt>
-<dd>Sets label justification [Default is MC]. Ignored when
-<strong>-SqN</strong>|<strong>n</strong>+|-1 is used.</dd>
-<dt><strong>+l</strong><em>label</em></dt>
-<dd>Sets the constant label text.</dd>
-<dt><strong>+L</strong><em>flag</em></dt>
-<dd><p class="first">Sets the label text according to the specified flag:</p>
-<p class="last"><strong>+Lh</strong>
-Take the label from the current segment header (first scan for
-an embedded <strong>-L</strong><em>label</em> option, if not use the first word
-following the segment flag). For multiple-word labels, enclose
-entire label in double quotes.
-<strong>+Ld</strong>
-Take the Cartesian plot distances along the line as the label;
-append <strong>c</strong>|<strong>i</strong>|<strong>p</strong> as the unit [Default is
-<strong>PROJ_LENGTH_UNIT</strong>].
-<strong>+LD</strong>
-Calculate actual map distances; append
-<strong>d|e|f|k|n|M|n|s</strong> as the unit [Default is
-<strong>d</strong>(egrees), unless label placement was based on map
-distances along the lines in which case we use the same unit
-specified for that algorithm]. Requires a map projection to be
-used.
-<strong>+Lf</strong>
-Use text after the 2nd column in the fixed label location file
-as the label. Requires the fixed label location setting.
-<strong>+Lx</strong>
-As <strong>+Lh</strong> but use the headers in the <em>xfile.d</em> instead.
-Requires the crossing file option.</p>
-</dd>
-<dt><strong>+n</strong><em>dx</em>[/<em>dy</em>]</dt>
-<dd>Nudges the placement of labels by the specified amount (append
-<strong>c</strong>|<strong>i</strong>|<strong>p</strong> to specify the units). Increments
-are considered in the coordinate system defined by the
-orientation of the line; use <strong>+N</strong> to force increments in the
-plot x/y coordinates system [no nudging]. Not allowed with <strong>+v</strong>.</dd>
-<dt><strong>+o</strong></dt>
-<dd>Selects rounded rectangular text box [Default is rectangular].
-Not applicable for curved text (<strong>+v</strong>) and only makes sense for
-opaque text boxes.</dd>
-<dt><strong>+p</strong>[<em>pen</em>]</dt>
-<dd>Draws the outline of text boxes [Default is no outline];
-optionally specify pen for outline [Default is width = 0.25p,
-color = black, style = solid].</dd>
-<dt><strong>+r</strong><em>min_rad</em></dt>
-<dd>Will not place labels where the line’s radius of curvature is
-less than <em>min_rad</em> [Default is 0].</dd>
-<dt><strong>+t</strong>[<em>file</em>]</dt>
-<dd>Saves line label x, y, and text to <em>file</em> [Line_labels.txt].
-Use <strong>+T</strong> to save x, y, angle, text instead.</dd>
-<dt><strong>+u</strong><em>unit</em></dt>
-<dd>Appends <em>unit</em> to all line labels. If <em>unit</em> starts with a
-leading hyphen (-) then there will be no space between label
-value and the unit. [Default is no unit].</dd>
-<dt><strong>+v</strong></dt>
-<dd>Specifies curved labels following the path [Default is straight labels].</dd>
-<dt><strong>+w</strong></dt>
-<dd>Specifies how many (<em>x</em>,<em>y</em>) points will be used to estimate
-label angles [Default is 10].</dd>
-<dt><strong>+=</strong><em>prefix</em></dt>
-<dd>Prepends <em>prefix</em> to all line labels. If <em>prefix</em> starts with a
-leading hyphen (-) then there will be no space between label
-value and the prefix. [Default is no prefix].</dd>
-</dl>
-</div></blockquote>
-<p class="last">Note: By placing <strong>-Sq</strong> options in the segment header you can change
-the quoted text attributes on a segment-by-segment basis.</p>
-</dd>
-<dt><strong>-Sr</strong></dt>
-<dd><strong>r</strong>ectangle. No size needs to be specified, but the x- and
-y-dimensions must be found in columns 4 and 5.</dd>
-<dt><strong>-SR</strong></dt>
-<dd><strong>R</strong>ounded rectangle. No size needs to be specified, but the x-
-and y-dimensions and corner radius must be found in columns 4, 5, and 6.</dd>
-<dt><strong>-Ss</strong></dt>
-<dd><strong>s</strong>quare. <em>size</em> is diameter of circumscribing circle.</dd>
-<dt><strong>-St</strong></dt>
-<dd><strong>t</strong>riangle. <em>size</em> is diameter of circumscribing circle.</dd>
-<dt><strong>-Su</strong></dt>
-<dd>c<strong>u</strong>be (3-D). The <em>size)</em> sets length of all sides. Append
-<strong>u</strong> if <em>size</em> is in x-units [Default is plot-distance units].
-The facet colors will be modified to simulate shading.
-Use <strong>-SU</strong> to disable such 3-D illumination.</dd>
-<dt><strong>-Sv</strong></dt>
-<dd><strong>v</strong>ector. Direction (in degrees counter-clockwise from
-horizontal) and length must be found in columns 4 and 5. The <em>size</em>
-is the length of the vector head. Vector width is set by <strong>-W</strong>. See
-VECTOR ATTRIBUTES for specifying attributes.</dd>
-<dt><strong>-SV</strong></dt>
-<dd>Same as <strong>-Sv</strong>, except azimuth (in degrees east of north) should be
-given instead of direction. The azimuth will be mapped into an angle
-based on the chosen map projection (<strong>-Sv</strong> leaves the directions
-unchanged.) See VECTOR ATTRIBUTES for specifying attributes.</dd>
-<dt><strong>-Sw</strong></dt>
-<dd>pie <strong>w</strong>edge. Start and stop directions (in degrees
-counter-clockwise from horizontal) for pie slice must be found in
-columns 4 and 5.</dd>
-<dt><strong>-SW</strong></dt>
-<dd>Same as <strong>-Sw</strong>, except azimuths (in degrees east of north) should
-be given instead of the two directions. The azimuths will be mapped
-into angles based on the chosen map projection (<strong>-Sw</strong> leaves the
-directions unchanged.)</dd>
-<dt><strong>-Sx</strong></dt>
-<dd>cross (x). <em>size</em> is diameter of circumscribing circle.</dd>
-<dt><strong>-Sy</strong></dt>
-<dd>y-dash (|). <em>size</em> is the length of a short horizontal (y-dir) line segment.</dd>
-<dt><strong>-S=</strong></dt>
-<dd>geovector. Azimuth (in degrees east from north) and length (in km)
-must be found in columns 4 and 5. The <em>size</em> is the length of the
-vector head. Vector width is set by <strong>-W</strong>. See VECTOR ATTRIBUTES
-for specifying attributes.</dd>
-</dl>
-</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] <a class="reference internal" href="gmt.html#u-full"><em>(more ...)</em></a></dt>
-<dd>Draw GMT time stamp logo on plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong>[<strong>-</strong>|<strong>+</strong>][<em>pen</em>] <a class="reference internal" href="GMT_Docs.html#wpen-attrib"><em>(more ...)</em></a></dt>
-<dd>Set pen attributes for lines or the outline of symbols [Defaults:
-width = default, color = black, style = solid]. A leading <strong>+</strong> will
-use the lookup color (via <strong>-C</strong>) for both symbol fill and outline
-pen color, while a leading <strong>-</strong> will set outline pen color and turn
-off symbol fill.</dd>
-</dl>
-<p><strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]]</p>
-<dl class="docutils">
-<dt><strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] <a class="reference internal" href="gmt.html#xy-full"><em>(more ...)</em></a></dt>
-<dd>Shift plot origin.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-a</strong><em>col</em>=<em>name</em>[<em>...</em>] <a class="reference internal" href="gmt.html#aspatial-full"><em>(more ...)</em></a></dt>
-<dd>Set aspatial column associations <em>col</em>=<em>name</em>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is the required number of columns given the chosen settings].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-c</strong><em>copies</em> <a class="reference internal" href="gmt.html#c-full"><em>(more ...)</em></a></dt>
-<dd>Specify number of plot copies [Default is 1].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] <a class="reference internal" href="gmt.html#g-full"><em>(more ...)</em></a></dt>
-<dd>Determine data gaps and line breaks. The <strong>-g</strong> option is ignored if <strong>-S</strong> is set.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-<dt><strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] (*)</dt>
-<dd>Select perspective view.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-t</strong>[<em>transp</em>] <a class="reference internal" href="gmt.html#t-full"><em>(more ...)</em></a></dt>
-<dd>Set PDF transparency level in percent.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc15">Vector Attributes</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>Several modifiers may be appended to the vector-producing options to
-specify the placement of vector heads, their shapes, and the
-justification of the vector. Below, left and right refers to the
-side of the vector line when viewed from the start point to the
-end point of the segment:</p>
-<blockquote>
-<div><p><strong>+a</strong><em>angle</em> sets the angle of the vector head apex [30].</p>
-<p><strong>+b</strong> places a vector head at the beginning of the vector path [none].
-Append <strong>l</strong>|<strong>r</strong> to only draw the left or right side of this head
-[both sides].</p>
-<p><strong>+e</strong> places a vector head at the end of the vector path [none].
-Append <strong>l</strong>|<strong>r</strong> to only draw the left or right side of this head
-[both sides].</p>
-<p><strong>+g</strong>-|<em>fill</em> turns off vector head fill (if -) or sets the vector
-head fill [Default fill is used, which may be no fill].</p>
-<p><strong>+l</strong> draws half-arrows, using only the left side of specified heads [both sides].</p>
-<p><strong>+n</strong><em>norm</em> scales down vector attributes (pen thickness, head size)
-with decreasing length, where vectors shorter than <em>norm</em> will have
-their attributes scaled by length/<em>norm</em> [arrow attributes remains
-invariant to length].</p>
-<p><strong>+o</strong><em>plon</em>/<em>plat</em> specifies the oblique pole for the great or
-small circles. Only needed for great circles if <strong>+q</strong> is given.</p>
-<p><strong>+p</strong>[-][<em>pen</em>] sets the vector pen attributes. If <em>pen</em> has a
-leading - then the head outline is not drawn. [Default pen is used, and
-head outline is drawn]</p>
-<p><strong>+q</strong> means the input <em>angle</em>, <em>length</em> data instead represent the <em>start</em> and <em>stop</em>
-opening angles of the arc segment relative to the given point.</p>
-<p><strong>+r</strong> draws half-arrows, using only the right side of specified heads [both sides].</p>
-</div></blockquote>
-<p>In addition, all but circular vectors may take these modifiers:</p>
-<blockquote>
-<div><p><strong>+j</strong><em>just</em> determines how the input <em>x</em>,<em>y</em> point relates to the
-vector. Choose from <strong>b</strong>eginning [default], <strong>e</strong>nd, or <strong>c</strong>enter.</p>
-<p><strong>+s</strong> means the input <em>angle</em>, <em>length</em> is instead the <em>x</em>, <em>y</em>
-coordinates of the vector end point.</p>
-</div></blockquote>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To plot blue columns (width = 1.25 cm) at the positions listed in the
-file heights.xyz on a 3-D projection of the space (0-10), (0-10),
-(0-100), with tickmarks every 2, 2, and 10, viewing it from the
-southeast at 30 degree elevation, use:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psxyz heights.xyz -R0/10/0/10/0/100 -Jx1.25c -Jz0.125c -So1.25c \
- -Gblue -B2:XLABEL:/2:YLABEL:/10:ZLABEL::."3-D PLOT":15 -p135/30 \
- -Uc -W -P > heights.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="segment-header-parsing">
-<h2>Segment Header Parsing<a class="headerlink" href="#segment-header-parsing" title="Permalink to this headline">¶</a></h2>
-<p>Segment header records may contain one of more of the following options:</p>
-<dl class="docutils">
-<dt><strong>-G</strong><em>fill</em></dt>
-<dd>Use the new <em>fill</em> and turn filling on</dd>
-<dt><strong>-G-</strong></dt>
-<dd>Turn filling off</dd>
-<dt><strong>-G</strong></dt>
-<dd>Revert to default fill (none if not set on command line)</dd>
-<dt><strong>-W</strong><em>pen</em></dt>
-<dd>Use the new <em>pen</em> and turn outline on</dd>
-<dt><strong>-W</strong></dt>
-<dd>Revert to default pen <a class="reference internal" href="gmt.conf.html#map-default-pen"><em>MAP_DEFAULT_PEN</em></a>
-(if not set on command line)</dd>
-<dt><strong>-W-</strong></dt>
-<dd>Turn outline off</dd>
-<dt><strong>-Z</strong><em>zval</em></dt>
-<dd>Obtain fill via cpt lookup using z-value <em>zval</em></dd>
-<dt><strong>-Z</strong><em>NaN</em></dt>
-<dd>Get the NaN color from the cpt file</dd>
-</dl>
-</div>
-<div class="section" id="custom-symbols">
-<h2>Custom Symbols<a class="headerlink" href="#custom-symbols" title="Permalink to this headline">¶</a></h2>
-<p><strong>psxyz</strong> allows users to define and plot their own custom symbols. This
-is done by encoding the symbol using our custom symbol macro code
-described in Appendix N. Put all the macro codes for your new symbol in
-a file whose extension must be .def; you may then address the symbol
-without giving the extension (e.g., the symbol file tsunami.def is used
-by specifying <strong>-Sk</strong><em>tsunami/size</em>. The definition file can contain
-any number of plot code records, as well as blank lines and comment
-lines (starting with #). <strong>psxyz</strong> will look for the definition files
-in (1) the current directory, (2) the ~/.gmt directory,
-and (3) the <strong>$GMT_SHAREDIR</strong>/custom directory, in that
-order. Freeform polygons (made up of straight line segments and arcs of
-circles) can be designed - these polygons can be painted and filled with
-a pattern. Other standard geometric symbols can also be used. See Appendix
-<a class="reference internal" href="GMT_Docs.html#app-custom-symbols"><em>M. Custom Plot Symbols</em></a> for macro definitions.</p>
-</div>
-<div class="section" id="bugs">
-<h2>Bugs<a class="headerlink" href="#bugs" title="Permalink to this headline">¶</a></h2>
-<p>No hidden line removal is employed for polygons and lines. Symbols,
-however, are first sorted according to their distance from the viewpoint
-so that nearby symbols will overprint more distant ones should they
-project to the same x,y position.</p>
-<p><strong>psxyz</strong> cannot handle filling of polygons that contain the south or
-north pole. For such a polygon, make a copy and split it into two and
-make each explicitly contain the polar point. The two polygons will
-combine to give the desired effect when filled; to draw outline use the
-original polygon.</p>
-<p>The <strong>-N</strong> option does not adjust the BoundingBox information so you may
-have to post-process the PostScript output with <a class="reference internal" href="ps2raster.html"><em>ps2raster</em></a> <strong>-A</strong>
-to obtain the correct BoundingBox.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>,
-<a class="reference internal" href="gmtcolors.html"><em>gmtcolors</em></a>,
-<a class="reference internal" href="psbasemap.html"><em>psbasemap</em></a>, <a class="reference internal" href="psxy.html"><em>psxy</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">psxyz</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#id1">Vector Attributes</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#segment-header-parsing">Segment Header Parsing</a></li>
-<li><a class="reference internal" href="#custom-symbols">Custom Symbols</a></li>
-<li><a class="reference internal" href="#bugs">Bugs</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="psxy.html"
- title="previous chapter">psxy</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="S.html"
- title="next chapter">S</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/psxyz.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="S.html" title="S"
- >next</a> </li>
- <li class="right" >
- <a href="psxy.html" title="psxy"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="PS.html" >PS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/sample1d.html b/doc_release/html/sample1d.html
deleted file mode 100644
index 999ca23..0000000
--- a/doc_release/html/sample1d.html
+++ /dev/null
@@ -1,359 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>sample1d — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="S" href="S.html" />
- <link rel="next" title="spectrum1d" href="spectrum1d.html" />
- <link rel="prev" title="S" href="S.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="spectrum1d.html" title="spectrum1d"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="S.html" title="S"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="S.html" accesskey="U">S</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="sample1d">
-<span id="index-0"></span><h1>sample1d<a class="headerlink" href="#sample1d" title="Permalink to this headline">¶</a></h1>
-<p>sample1d - Resample 1-D table data using splines</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>sample1d</strong> [ <em>table</em> ]
-[ <strong>-A</strong><strong>f</strong>|<strong>p</strong>|<strong>m</strong>|<strong>r</strong>|<strong>R</strong>[<strong>+l</strong>] ]
-[ <strong>-Fl</strong>|<strong>a</strong>|<strong>c</strong>|<strong>n</strong> ] [ <strong>-I</strong><em>inc</em>[<em>unit</em>] ]
-[ <strong>-N</strong><em>knotfile</em> ] [ <strong>-S</strong><em>start</em>[/<em>stop</em>] ] [ <strong>-T</strong><em>col</em> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-b</strong>[<strong>i</strong>|<strong>o</strong>][<em>ncol</em>][<strong>type</strong>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-o</strong><em>cols</em>[,...] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>sample1d</strong> reads a multi-column ASCII [or binary] data set from file
-[or standard input] and interpolates the timeseries/profile at locations
-where the user needs the values. The user must provide the column number
-of the independent (monotonically increasing <strong>or</strong> decreasing)
-variable. Equidistant or arbitrary sampling can be selected. All columns
-are resampled based on the new sampling interval. Several interpolation
-schemes are available. Extrapolation outside the range of the input data
-is not supported.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<p>None.</p>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>This is one or more ASCII [of binary, see
-<strong>-bi</strong>] files with one column containing the
-independent variable (which must be monotonically in/de-creasing)
-and the remaining columns holding other data values. If no file is
-provided, <strong>sample1d</strong> reads from standard input.</dd>
-<dt><strong>-A</strong><strong>f</strong>|<strong>p</strong>|<strong>m</strong>|<strong>r</strong>|<strong>R</strong></dt>
-<dd>For track resampling (if <strong>-T</strong>...<em>unit</em> is set) we can select how
-this is to be performed. Append <strong>f</strong> to keep original points, but
-add intermediate points if needed; note this selection does not
-necessarily yield equidistant points [Default], <strong>m</strong> as <strong>f</strong>, but
-first follow meridian (along y) then parallel (along x), <strong>p</strong> as
-<strong>f</strong>, but first follow parallel (along y) then meridian (along x),
-<strong>r</strong> to resample at equidistant locations; input points are not
-necessarily included in the output, and <strong>R</strong> as <strong>r</strong>, but adjust
-given spacing to fit the track length exactly. Finally, append
-<strong>+l</strong> if distances should be measured along rhumb lines (loxodromes).</dd>
-<dt><strong>-Fl</strong>|<strong>a</strong>|<strong>c</strong>|<strong>n</strong></dt>
-<dd>Choose from <strong>l</strong> (Linear), <strong>a</strong> (Akima spline), <strong>c</strong> (natural
-cubic spline), and <strong>n</strong> (no interpolation: nearest point) [Default
-is <strong>-Fa</strong>]. You may change the default interpolant; see
-<a class="reference internal" href="gmt.conf.html#gmt-interpolant"><em>GMT_INTERPOLANT</em></a> in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file.</dd>
-<dt><strong>-I</strong><em>inc</em>[<em>unit</em>]</dt>
-<dd><em>inc</em> defines the sampling interval [Default is the separation
-between the first and second abscissa point in the <em>infile</em>]. Append
-a distance unit (see UNITS) to indicate that the first two columns
-contain longitude, latitude and you wish to resample this path with
-a spacing of <em>inc</em> in the chosen units. For sampling of (x, y)
-Cartesian tracks, specify the unit as c. Use <strong>-A</strong> to control how
-path resampling is performed.</dd>
-<dt><strong>-N</strong><em>knotfile</em></dt>
-<dd><em>knotfile</em> is an optional ASCII file with the x locations where the
-data set will be resampled in the first column. Note: If <strong>-H</strong> is
-selected it applies to both <em>infile</em> and <em>knotfile</em>. Also note that
-<strong>-i</strong> never applies to <em>knotfile</em> since we always consider the
-first column only.</dd>
-<dt><strong>-S</strong><em>start</em>[<em>stop</em>]</dt>
-<dd>For equidistant sampling, <em>start</em> indicates the location of the
-first output value. [Default is the smallest even multiple of <em>inc</em>
-inside the range of <em>infile</em>]. Optionally, append /<em>stop</em> to
-indicate the location of the last output value [Default is the
-largest even multiple of <em>inc</em> inside the range of <em>infile</em>].</dd>
-<dt><strong>-T</strong><em>col</em></dt>
-<dd>Sets the column number of the independent variable [Default is 0
-(first)].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 2 (or at least the number of columns implied by <strong>-T</strong>)].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. [Default is same as input].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] <a class="reference internal" href="gmt.html#g-full"><em>(more ...)</em></a></dt>
-<dd>Determine data gaps and line breaks. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-o</strong><em>cols</em>[,...] <a class="reference internal" href="gmt.html#ocols-full"><em>(more ...)</em></a></dt>
-<dd>Select output columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc9">Units</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>For map distance unit, append <em>unit</em> <strong>d</strong> for arc degree, <strong>m</strong> for arc
-minute, and <strong>s</strong> for arc second, or <strong>e</strong> for meter [Default], <strong>f</strong>
-for foot, <strong>k</strong> for km, <strong>M</strong> for statute mile, <strong>n</strong> for nautical mile,
-and <strong>u</strong> for US survey foot. By default we compute such distances using
-a spherical approximation with great circles. Prepend <strong>-</strong> to a
-distance (or the unit is no distance is given) to perform “Flat Earth”
-calculations (quicker but less accurate) or prepend <strong>+</strong> to perform
-exact geodesic calculations (slower but more accurate).</p>
-</div>
-<div class="section" id="ascii-format-precision">
-<h2>Ascii Format Precision<a class="headerlink" href="#ascii-format-precision" title="Permalink to this headline">¶</a></h2>
-<p>The ASCII output formats of numerical data are controlled by parameters
-in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file. Longitude and latitude are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>, whereas other values are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>. Be aware that the format in effect
-can lead to loss of precision in the output, which can lead to various
-problems downstream. If you find the output is not written with enough
-precision, consider switching to binary output (<strong>-bo</strong> if available) or
-specify more decimals using the <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> setting.</p>
-</div>
-<div class="section" id="calendar-time-sampling">
-<h2>Calendar Time Sampling<a class="headerlink" href="#calendar-time-sampling" title="Permalink to this headline">¶</a></h2>
-<p>If the abscissa are calendar times then you must use the <strong>-f</strong> option
-to indicate this. Furthermore, <strong>-I</strong> then expects an increment in the
-current <a class="reference internal" href="gmt.conf.html#time-unit"><em>TIME_UNIT</em></a> units. There is not yet support for variable
-intervals such as months.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To resample the file profiles.tdgmb, which contains
-(time,distance,gravity,magnetics,bathymetry) records, at 1km equidistant
-intervals using Akima’s spline, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt sample1d profiles.tdgmb -I1 -Fa -T1 > profiles_equi_d.tdgmb
-</pre></div>
-</div>
-</div></blockquote>
-<p>To resample the file depths.dt at positions listed in the file
-grav_pos.dg, using a cubic spline for the interpolation, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt sample1d depths.dt -Ngrav_pos.dg -Fc > new_depths.dt
-</pre></div>
-</div>
-</div></blockquote>
-<p>To resample the file track.txt which contains lon, lat, depth every 2
-nautical miles, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt sample1d track.txt -I2n -AR > new_track.dt
-</pre></div>
-</div>
-</div></blockquote>
-<p>To do approximately the same, but make sure the original points are
-included, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt sample1d track.txt -I2n -Af > new_track.dt
-</pre></div>
-</div>
-</div></blockquote>
-<p>To obtain a rhumb line (loxodrome) sampled every 5 km instead, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt sample1d track.txt -I5k -AR+l > new_track.dt
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a>,
-<a class="reference internal" href="greenspline.html"><em>greenspline</em></a>,
-<a class="reference internal" href="filter1d.html"><em>filter1d</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">sample1d</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#id1">Units</a></li>
-<li><a class="reference internal" href="#ascii-format-precision">Ascii Format Precision</a></li>
-<li><a class="reference internal" href="#calendar-time-sampling">Calendar Time Sampling</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="S.html"
- title="previous chapter">S</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="spectrum1d.html"
- title="next chapter">spectrum1d</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/sample1d.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="spectrum1d.html" title="spectrum1d"
- >next</a> </li>
- <li class="right" >
- <a href="S.html" title="S"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="S.html" >S</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/search.html b/doc_release/html/search.html
deleted file mode 100644
index c6f2b2d..0000000
--- a/doc_release/html/search.html
+++ /dev/null
@@ -1,141 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>Search — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <script type="text/javascript">
- jQuery(function() { Search.loadIndex("searchindex.js"); });
- </script>
-
- <script type="text/javascript" id="searchindexloader"></script>
-
-
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <h1 id="search-documentation">Search</h1>
- <div id="fallback" class="admonition warning">
- <script type="text/javascript">$('#fallback').hide();</script>
- <p>
- Please activate JavaScript to enable the search
- functionality.
- </p>
- </div>
- <p>
- From here you can search these documents. Enter your search
- words into the box below and click "search". Note that the search
- function will automatically search for all of the words. Pages
- containing fewer words won't appear in the result list.
- </p>
- <form action="" method="get">
- <input type="text" name="q" value="" />
- <input type="submit" value="search" />
- <span id="search-progress" style="padding-left: 10px"></span>
- </form>
-
- <div id="search-results">
-
- </div>
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/searchindex.js b/doc_release/html/searchindex.js
deleted file mode 100644
index 48f3a16..0000000
--- a/doc_release/html/searchindex.js
+++ /dev/null
@@ -1 +0,0 @@
-Search.setIndex({envversion:42,terms:{grdedit:[173,21,103,42,138,65,19],pac_ag:55,orthogon:[103,14,100,172],yellow:[182,160,49,103,67,80,81,83,42],interchang:[88,103,90,205,179],four:[115,45,96,117,167,191,56,201,103,16,51,40,29,92,8,54,65,165],grey60:49,prefix:[72,59,124,118,14,165,60,144,103,129,78,152,81,141,111,112,56,19],grey62:49,netcdf:56,grey64:49,grey67:49,grey66:49,grey69:49,grey68:49,reshuffl:93,projectspec:103,usepackag:103,n40e:18,digit:[58,200,195,14,5,131,132,103,191,1,141 [...]
\ No newline at end of file
diff --git a/doc_release/html/spectrum1d.html b/doc_release/html/spectrum1d.html
deleted file mode 100644
index 3330002..0000000
--- a/doc_release/html/spectrum1d.html
+++ /dev/null
@@ -1,414 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>spectrum1d — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="S" href="S.html" />
- <link rel="next" title="sph2grd" href="sph2grd.html" />
- <link rel="prev" title="sample1d" href="sample1d.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="sph2grd.html" title="sph2grd"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="sample1d.html" title="sample1d"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="S.html" accesskey="U">S</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="spectrum1d">
-<span id="index-0"></span><h1>spectrum1d<a class="headerlink" href="#spectrum1d" title="Permalink to this headline">¶</a></h1>
-<p>spectrum1d - Compute auto- [and cross- ] spectra from one [or two] time-series</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>spectrum1d</strong> [ <em>table</em> ] <strong>-S</strong><em>segment_size</em>] [
-<strong>-C</strong>[<strong>xycnpago</strong>] ] [ <strong>-D</strong><em>dt</em> ] [ <strong>-L</strong>[<strong>h</strong>|<strong>m</strong>]
-] [ <strong>-N</strong>[<strong>+</strong>]<em>name_stem</em> ] [ <strong>-b</strong>[<strong>i</strong>|<strong>o</strong>][<em>ncol</em>][<strong>type</strong>][w][<strong>+L</strong>|<strong>+B</strong>] ] [ <strong>-W</strong> ]
-[ <strong>-b</strong>[<strong>i</strong>|<strong>o</strong>][<em>ncol</em>][<strong>type</strong>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>spectrum1d</strong> reads X [and Y] values from the first [and second]
-columns on standard input [or <em>x[y]file</em>]. These values are treated as
-timeseries X(t) [Y(t)] sampled at equal intervals spaced <em>dt</em> units
-apart. There may be any number of lines of input. <strong>spectrum1d</strong> will
-create file[s] containing auto- [and cross- ] spectral density estimates
-by Welch’s method of ensemble averaging of multiple overlapped windows,
-using standard error estimates from Bendat and Piersol.</p>
-<p>The output files have 3 columns: f or w, p, and e. f or w is the
-frequency or wavelength, p is the spectral density estimate, and e is
-the one standard deviation error bar size. These files are named based
-on <em>name_stem</em>. If the <strong>-C</strong> option is used, up to eight files are
-created; otherwise only one (xpower) is written. The files (which are
-ASCII unless <strong>-bo</strong> is set) are as follows:</p>
-<dl class="docutils">
-<dt><em>name_stem</em>.xpower</dt>
-<dd>Power spectral density of X(t). Units of X * X * <em>dt</em>.</dd>
-<dt><em>name_stem</em>.ypower</dt>
-<dd>Power spectral density of Y(t). Units of Y * Y * <em>dt</em>.</dd>
-<dt><em>name_stem</em>.cpower</dt>
-<dd>Power spectral density of the coherent output. Units same as ypower.</dd>
-<dt><em>name_stem</em>.npower</dt>
-<dd>Power spectral density of the noise output. Units same as ypower.</dd>
-<dt><em>name_stem</em>.gain</dt>
-<dd>Gain spectrum, or modulus of the transfer function. Units of (Y /
-X).</dd>
-<dt><em>name_stem</em>.phase</dt>
-<dd>Phase spectrum, or phase of the transfer function. Units are
-radians.</dd>
-<dt><em>name_stem</em>.admit</dt>
-<dd>Admittance spectrum, or real part of the transfer function. Units of
-(Y / X).</dd>
-<dt><em>name_stem</em>.coh</dt>
-<dd>(Squared) coherency spectrum, or linear correlation coefficient as a
-function of frequency. Dimensionless number in [0, 1]. The
-Signal-to-Noise-Ratio (SNR) is coh / (1 - coh). SNR = 1 when coh = 0.5.</dd>
-</dl>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-S</strong><em>segment_size</em>]</dt>
-<dd><em>segment_size</em> is a radix-2 number of samples per window for
-ensemble averaging. The smallest frequency estimated is
-1.0/(<em>segment_size</em> * <em>dt</em>), while the largest is 1.0/(2 *
-<em>dt</em>). One standard error in power spectral density is approximately
-1.0 / sqrt(<em>n_data</em> / <em>segment_size</em>), so if <em>segment_size</em> =
-256, you need 25,600 data to get a one standard error bar of 10%.
-Cross-spectral error bars are larger and more complicated, being a
-function also of the coherency.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>)
-files holding X(t) [Y(t)] samples in the first 1 [or 2] columns. If
-no files are specified, <strong>spectrum1d</strong> will read from standard input.</dd>
-<dt><strong>-C</strong>[<strong>xycnpago</strong>]</dt>
-<dd>Read the first two columns of input as samples of two time-series,
-X(t) and Y(t). Consider Y(t) to be the output and X(t) the input in
-a linear system with noise. Estimate the optimum frequency response
-function by least squares, such that the noise output is minimized
-and the coherent output and the noise output are uncorrelated.
-Optionally specify up to 8 letters from the set { <strong>x y c n p a g
-o</strong> } in any order to create only those output files instead of the
-default [all]. <strong>x</strong> = xpower, <strong>y</strong> = ypower, <strong>c</strong> = cpower, <strong>n</strong>
-= npower, <strong>p</strong> = phase, <strong>a</strong> = admit, <strong>g</strong> = gain, <strong>o</strong> = coh.</dd>
-<dt><strong>-D</strong><em>dt</em></dt>
-<dd><em>dt</em> Set the spacing between samples in the time-series [Default = 1].</dd>
-<dt><strong>-L</strong></dt>
-<dd>Leave trend alone. By default, a linear trend will be removed prior
-to the transform. Alternatively, append <strong>m</strong> to just remove the
-mean value or <strong>h</strong> to remove the mid-value.</dd>
-<dt><strong>-N</strong>[<strong>+</strong>]<em>name_stem</em></dt>
-<dd><em>name_stem</em> Supply the name stem to be used for output files
-[Default = “spectrum”]. To place all the computed output columns in
-a single table, use <strong>-N+</strong>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong></dt>
-<dd>Write Wavelength rather than frequency in column 1 of the output
-file[s] [Default = frequency, (cycles / <em>dt</em>)].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 2 input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. [Default is 2 output columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] <a class="reference internal" href="gmt.html#g-full"><em>(more ...)</em></a></dt>
-<dd>Determine data gaps and line breaks. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="ascii-format-precision">
-<h2>Ascii Format Precision<a class="headerlink" href="#ascii-format-precision" title="Permalink to this headline">¶</a></h2>
-<p>The ASCII output formats of numerical data are controlled by parameters
-in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file. Longitude and latitude are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>, whereas other values are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>. Be aware that the format in effect
-can lead to loss of precision in the output, which can lead to various
-problems downstream. If you find the output is not written with enough
-precision, consider switching to binary output (<strong>-bo</strong> if available) or
-specify more decimals using the <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> setting.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>Suppose data.g is gravity data in mGal, sampled every 1.5 km. To write
-its power spectrum, in mGal**2-km, to the file data.xpower, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt spectrum1d data.g -S256 -D1.5 -Ndata
-</pre></div>
-</div>
-</div></blockquote>
-<p>Suppose in addition to data.g you have data.t, which is topography in
-meters sampled at the same points as data.g. To estimate various
-features of the transfer function, considering data.t as input and
-data.g as output, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>paste data.t data.g | gmt spectrum1d -S256 -D1.5 -Ndata -C
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="tutorial">
-<h2>Tutorial<a class="headerlink" href="#tutorial" title="Permalink to this headline">¶</a></h2>
-<p>The output of spectrum1d is in units of power spectral density, and so to get units
-of data-squared you must divide by delta_t, where delta_t is the sample spacing.
-(There may be a factor of 2 pi somewhere, also. If you want to be sure of the
-normalization, you can determine a scale factor from Parseval’s theorem: the sum of
-the squares of your input data should equal the sum of the squares of the outputs
-from spectrum1d, if you are simply trying to get a periodogram. [See below.])</p>
-<p>Suppose we simply take a data set, x(t), and compute the discrete Fourier transform
-(DFT) of the entire data set in one go. Call this X(f). Then suppose we form X(f)
-times the complex conjugate of X(f).</p>
-<p>P_raw(f) = X(f) * X’(f), where the ‘ indicates complex conjugation.</p>
-<p>P_raw is called the periodogram. The sum of the samples of the periodogram equals the
-sum of the samples of the squares of x(t), by Parseval’s theorem. (If you use a DFT
-subroutine on a computer, usually the sum of P_raw equals the sum of x-squared, times M,
-where M is the number of samples in x(t).)</p>
-<p>Each estimate of X(f) is now formed by a weighted linear combination of all of the
-x(t) values. (The weights are sometimes called “twiddle factors” in the DFT literature.)
-So, no matter what the probability distribution for the x(t) values is, the probability
-distribution for the X(f) values approaches [complex] Gaussian, by the Central Limit
-Theorem. This means that the probability distribution for P_raw(f) approaches chi-squared
-with two degrees of freedom. That reduces to an exponential distribution, and the
-variance of the estimate of P_raw is proportional to the square of the mean, that is,
-the expected value of P_raw.</p>
-<p>In practice if we form P_raw, the estimates are hopelessly noisy. Thus P_raw is not useful,
-and we need to do some kind of smoothing or averaging to get a useful estimate, P_useful(f).</p>
-<p>There are several different ways to do this in the literature. One is to form P_raw and
-then smooth it. Another is to form the auto-covariance function of x(t), smooth, taper and
-shape it, and then take the Fourier transform of the smoothed, tapered and shaped auto-covariance.
-Another is to form a parametric model for the auto-correlation structure in x(t), then compute
-the spectrum of that model. This last approach is what is done in what is called the
-“maximum entropy” or “Berg” or “Box-Jenkins” or “ARMA” or “ARIMA” methods.</p>
-<p>Welch’s method is a tried-and-true method. In his method, you choose a segment length,
-<strong>-S</strong><em>N</em>, so that estimates will be made from segments of length <em>N</em>. The frequency samples
-(in cycles per delta_t unit) of your P_useful will then be at <em>k</em> /(<em>N</em> * <em>delta_t</em>),
-where <em>k</em> is an integer, and you will get <em>N</em> samples (since the spectrum is an even
-function of <em>f</em>, only <em>N</em>/2 of them are really useful). If the length of your entire
-data set, x(t), is <em>M</em> samples long, then the variance in your P_useful will decrease
-in proportion to <em>N/M</em>. Thus you need to choose <em>N</em> << <em>M</em> to get very low noise and
-high confidence in P_useful. There is a trade-off here; see below.</p>
-<p>There is an additional reduction in variance in that Welch’s method uses a Von Hann
-spectral window on each sample of length <em>N</em>. This reduces side lobe leakage and has
-the effect of smoothing the (<em>N</em> segment) periodogram as if the X(f) had been
-convolved with [1/4, 1/2, 1/4] prior to forming P_useful. But this slightly widens
-the spectral bandwidth of each estimate, because the estimate at frequency sample <em>k</em>
-is now a little correlated with the estimate at frequency sample k+1. (Of course this
-would also happen if you simply formed P_raw and then smoothed it.)</p>
-<p>Finally, Welch’s method also uses overlapped processing. Since the Von Hann window is
-large in the middle and tapers to near zero at the ends, only the middle of the segment
-of length <em>N</em> contributes much to its estimate. Therefore in taking the next segment
-of data, we move ahead in the x(t) sequence only <em>N</em>/2 points. In this way, the next
-segment gets large weight where the segments on either side of it will get little weight,
-and vice versa. This doubles the smoothing effect and ensures that (if <em>N</em> << <em>M</em>)
-nearly every point in x(t) contributes with nearly equal weight in the final answer.</p>
-<p>Welch’s method of spectral estimation has been widely used and widely studied. It is very
-reliable and its statistical properties are well understood. It is highly recommended in
-such textbooks as “Random Data: Analysis and Measurement Procedures” by Bendat and Piersol.</p>
-<p>In all problems of estimating parameters from data, there is a classic trade-off between
-resolution and variance. If you want to try to squeeze more resolution out of your data
-set, then you have to be willing to accept more noise in the estimates. The same trade-off
-is evident here in Welch’s method. If you want to have very low noise in the spectral
-estimates, then you have to choose <em>N</em> << <em>M</em>, and this means that you get only <em>N</em>
-samples of the spectrum, and the longest period that you can resolve is only <em>N</em> * <em>delta_t</em>.
-So you see that reducing the noise lowers the number of spectral samples and lowers the
-longest period. Conversely, if you choose <em>N</em> approaching <em>M</em>, then you approach the
-periodogram with its very bad statistical properties, but you get lots of samples and
-a large fundamental period.</p>
-<p>The other spectral estimation methods also can do a good job. Welch’s method was selected
-because the way it works, how one can code it, and its effects on statistical distributions,
-resolution, side-lobe leakage, bias, variance, etc. are all easily understood. Some of the
-other methods (e.g. Maximum Entropy) tend to hide where some of these trade-offs are
-happening inside a “black box”.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>, <a class="reference internal" href="grdfft.html"><em>grdfft</em></a></p>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>Bendat, J. S., and A. G. Piersol, 1986, Random Data, 2nd revised ed.,
-John Wiley & Sons.</p>
-<p>Welch, P. D., 1967, The use of Fast Fourier Transform for the estimation
-of power spectra: a method based on time averaging over short, modified
-periodograms, IEEE Transactions on Audio and Electroacoustics, Vol
-AU-15, No 2.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">spectrum1d</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#ascii-format-precision">Ascii Format Precision</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#tutorial">Tutorial</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="sample1d.html"
- title="previous chapter">sample1d</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="sph2grd.html"
- title="next chapter">sph2grd</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/spectrum1d.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="sph2grd.html" title="sph2grd"
- >next</a> </li>
- <li class="right" >
- <a href="sample1d.html" title="sample1d"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="S.html" >S</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/sph2grd.html b/doc_release/html/sph2grd.html
deleted file mode 100644
index 2d2b5c6..0000000
--- a/doc_release/html/sph2grd.html
+++ /dev/null
@@ -1,346 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>sph2grd — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="S" href="S.html" />
- <link rel="next" title="sphdistance" href="sphdistance.html" />
- <link rel="prev" title="spectrum1d" href="spectrum1d.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="sphdistance.html" title="sphdistance"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="spectrum1d.html" title="spectrum1d"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="S.html" accesskey="U">S</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="sph2grd">
-<span id="index-0"></span><h1>sph2grd<a class="headerlink" href="#sph2grd" title="Permalink to this headline">¶</a></h1>
-<p>sph2grd - Compute grid from spherical harmonic coefficients</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>sph2grd</strong> [ <em>table</em> ] <strong>-G</strong><em>grdfile</em>
-<strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]
-<strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>]
-[ <strong>-D</strong>[<strong>g</strong>|<strong>n</strong>] ]
-[ <strong>-E</strong> ] [ <strong>-F</strong>[<strong>k</strong>]<em>filter</em> ] [ <strong>-N</strong>[<em>norm</em>] ] [ <strong>-Q</strong> ] [ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-bi</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-r</strong> ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>sph2grd</strong> reads a spherical harmonics coefficient table with records of
-L, M, C[L,M], S[L,M] and evaluates the spherical harmonic model on the specified grid.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-G</strong><em>grdfile</em></dt>
-<dd><em>grdfile</em> is the name of the binary output grid file. (See GRID FILE FORMAT below.)</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]</dt>
-<dd><em>x_inc</em> [and optionally <em>y_inc</em>] is the grid spacing. Optionally,
-append a suffix modifier. <strong>Geographical (degrees) coordinates</strong>: Append
-<strong>m</strong> to indicate arc minutes or <strong>s</strong> to indicate arc seconds. If one
-of the units <strong>e</strong>, <strong>f</strong>, <strong>k</strong>, <strong>M</strong>, <strong>n</strong> or <strong>u</strong> is appended
-instead, the increment is assumed to be given in meter, foot, km, Mile,
-nautical mile or US survey foot, respectively, and will be converted to
-the equivalent degrees longitude at the middle latitude of the region
-(the conversion depends on <a class="reference internal" href="gmt.conf.html#projection-parameters"><em>PROJ_ELLIPSOID</em></a>). If /<em>y_inc</em> is given
-but set to 0 it will be reset equal to <em>x_inc</em>; otherwise it will be
-converted to degrees latitude. <strong>All coordinates</strong>: If <strong>=</strong> is appended
-then the corresponding max <em>x</em> (<em>east</em>) or <em>y</em> (<em>north</em>) may be slightly
-adjusted to fit exactly the given increment [by default the increment
-may be adjusted slightly to fit the given domain]. Finally, instead of
-giving an increment you may specify the <em>number of nodes</em> desired by
-appending <strong>+</strong> to the supplied integer argument; the increment is then
-recalculated from the number of nodes and the domain. The resulting
-increment value depends on whether you have selected a
-gridline-registered or pixel-registered grid; see <a class="reference internal" href="GMT_Docs.html#app-file-formats"><em>B. GMT File Formats</em></a> for
-details. Note: if <strong>-R</strong><em>grdfile</em> is used then the grid spacing has
-already been initialized; use <strong>-I</strong> to override the values.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII [or binary, see <strong>-bi</strong>]
-files holding the spherical harmonic coefficients. We expect the
-first four columns to hold the degree L, the order M, followed by
-the cosine and sine coefficients.</dd>
-<dt><strong>-D</strong>[<strong>g</strong>|<strong>n</strong>]</dt>
-<dd>Will evaluate a derived field from a geopotential model. Choose
-between <strong>Dg</strong> which will compute the gravitational field or <strong>Dn</strong>
-to compute the geoid [Add <strong>-E</strong> for anomalies on the ellipsoid].</dd>
-<dt><strong>-E</strong></dt>
-<dd>Evaluate expansion on the current ellipsoid [Default is sphere].</dd>
-<dt><strong>-F</strong>[<strong>d</strong>]<em>filter</em></dt>
-<dd>Filter coefficients according to one of two kinds of filter
-specifications:. Select <strong>-Fk</strong> if values are given in km
-[Default is coefficient harmonic degree L]. a) Cosine band-pass: Append
-four wavelengths <em>lc/lp/hp/hc</em>. Coefficients outside <em>lc/hc</em> are
-cut; those inside <em>lp/hp</em> are passed, while the rest are tapered.
-Replace wavelength by - to skip, e.g., <strong>-F</strong>-/-/50/75 is a
-low-pass filter. b) Gaussian band-pass: Append two wavelengths
-<em>lo/hi</em> where filter amplitudes = 0.5. Replace wavelength by -
-to skip, e.g., <strong>-F</strong>70/- is a high-pass Gaussian filter.</dd>
-<dt><strong>-N</strong>[<em>norm</em>]</dt>
-<dd>Normalization used for coefficients. Choose among <strong>m</strong>: Mathematical
-normalization - inner products summed over surface equal 1 [Default].
-<strong>g</strong> Geodesy normalization - inner products summed over surface
-equal 4pi. <strong>s</strong>: Schmidt normalization - as used in geomagnetism.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 4 input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). Not used with binary data.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-r</strong> <a class="reference internal" href="gmt.html#nodereg-full"><em>(more ...)</em></a></dt>
-<dd>Set pixel node registration [gridline]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="grid-values-precision">
-<h2>Grid Values Precision<a class="headerlink" href="#grid-values-precision" title="Permalink to this headline">¶</a></h2>
-<p>Regardless of the precision of the input data, GMT programs that create
-grid files will internally hold the grids in 4-byte floating point
-arrays. This is done to conserve memory and furthermore most if not all
-real data can be stored using 4-byte floating point values. Data with
-higher precision (i.e., double precision values) will lose that
-precision once GMT operates on the grid or writes out new grids. To
-limit loss of precision when processing data you should always consider
-normalizing the data prior to processing.</p>
-</div>
-<div class="section" id="grid-file-formats">
-<h2>Grid File Formats<a class="headerlink" href="#grid-file-formats" title="Permalink to this headline">¶</a></h2>
-<p>By default GMT writes out grid as single precision floats in a
-COARDS-complaint netCDF file format. However, GMT is able to produce
-grid files in many other commonly used grid file formats and also
-facilitates so called “packing” of grids, writing out floating point
-data as 1- or 2-byte integers. To specify the precision, scale and
-offset, the user should add the suffix
-<strong>=</strong><em>id</em>[<strong>/</strong><em>scale</em><strong>/</strong><em>offset</em>[<strong>/</strong><em>nan</em>]], where
-<em>id</em> is a two-letter identifier of the grid type and precision, and
-<em>scale</em> and <em>offset</em> are optional scale factor and offset to be applied
-to all grid values, and <em>nan</em> is the value used to indicate missing
-data. See <a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section
-<a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a>
-of the GMT Technical Reference and Cookbook for more information.</p>
-<p>When writing a netCDF file, the grid is stored by default with the
-variable name “z”. To specify another variable name <em>varname</em>, append
-<strong>?</strong><em>varname</em> to the file name. Note that you may need to escape the
-special meaning of <strong>?</strong> in your shell program by putting a backslash in
-front of it, or by placing the filename and suffix between quotes or
-double quotes.</p>
-</div>
-<div class="section" id="geographical-and-time-coordinates">
-<h2>Geographical And Time Coordinates<a class="headerlink" href="#geographical-and-time-coordinates" title="Permalink to this headline">¶</a></h2>
-<p>When the output grid type is netCDF, the coordinates will be labeled
-“longitude”, “latitude”, or “time” based on the attributes of the input
-data or grid (if any) or on the <strong>-f</strong> or <strong>-R</strong> options. For example,
-both <strong>-f0x</strong> <strong>-f1t</strong> and <strong>-R</strong>90w/90e/0t/3t will result in a
-longitude/time grid. When the x, y, or z coordinate is time, it will be
-stored in the grid as relative time since epoch as specified by
-<a class="reference internal" href="gmt.conf.html#time-unit"><em>TIME_UNIT</em></a> and <a class="reference internal" href="gmt.conf.html#time-epoch"><em>TIME_EPOCH</em></a> in the
-<a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file or on the
-command line. In addition, the <strong>unit</strong> attribute of the time variable
-will indicate both this unit and epoch.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To create a 1 x 1 degree global grid file from the ASCII
-coefficients in EGM96_to_360.txt, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt sph2grd EGM96_to_360.txt -GEGM96_to_360.nc -Rg -I1 -V
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="reference">
-<h2>Reference<a class="headerlink" href="#reference" title="Permalink to this headline">¶</a></h2>
-<p>Holmes, S. A., and Featherstone, W. E., 2002, A unified approach to
-the Clenshaw summation and the recursive computation of very high
-degree and order normalized associated Legendre functions:
-<em>J. Geodesy, v. 76, p. 279–299</em>.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="grdfft.html"><em>grdfft</em></a>,
-<a class="reference internal" href="grdmath.html"><em>grdmath</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">sph2grd</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#grid-values-precision">Grid Values Precision</a></li>
-<li><a class="reference internal" href="#grid-file-formats">Grid File Formats</a></li>
-<li><a class="reference internal" href="#geographical-and-time-coordinates">Geographical And Time Coordinates</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#reference">Reference</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="spectrum1d.html"
- title="previous chapter">spectrum1d</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="sphdistance.html"
- title="next chapter">sphdistance</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/sph2grd.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="sphdistance.html" title="sphdistance"
- >next</a> </li>
- <li class="right" >
- <a href="spectrum1d.html" title="spectrum1d"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="S.html" >S</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/sphdistance.html b/doc_release/html/sphdistance.html
deleted file mode 100644
index db6fdda..0000000
--- a/doc_release/html/sphdistance.html
+++ /dev/null
@@ -1,361 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>sphdistance — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="S" href="S.html" />
- <link rel="next" title="sphinterpolate" href="sphinterpolate.html" />
- <link rel="prev" title="sph2grd" href="sph2grd.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="sphinterpolate.html" title="sphinterpolate"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="sph2grd.html" title="sph2grd"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="S.html" accesskey="U">S</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="sphdistance">
-<span id="index-0"></span><h1>sphdistance<a class="headerlink" href="#sphdistance" title="Permalink to this headline">¶</a></h1>
-<p>sphdistance - Make grid of distances to nearest points on a sphere</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>sphdistance</strong> [ <em>table</em> ] <strong>-G</strong><em>grdfile</em> [ <strong>-C</strong> ] [ <strong>-E</strong> ]
-[ <strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]] ]
-[ <strong>-L</strong><em>unit</em> ] [ <strong>-Q</strong><em>voronoi.txt</em> ]
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-b</strong>[<strong>i</strong>|<strong>o</strong>][<em>ncol</em>][<strong>type</strong>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-r</strong> ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>sphdistance</strong> reads one or more ASCII [or binary] files (or standard
-input) containing lon, lat and performs the construction of Voronoi
-polygons. These polygons are then processed to calculate the nearest
-distance to each node of the lattice and written to the specified grid.
-The Voronoi algorithm used is STRIPACK. As an option, you may provide
-pre-calculated Voronoi polygon file in the format written by
-<a class="reference internal" href="sphtriangulate.html"><em>sphtriangulate</em></a>, thus bypassing the memory- and time-consuming
-triangularization.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-G</strong><em>grdfile</em></dt>
-<dd>Name of the output grid to hold the computed distances.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>[<em>ncols</em>][<em>type</em>]) data
-table file(s) holding a number of data columns. If no tables are given
-then we read from standard input. </dd>
-<dt><strong>-C</strong></dt>
-<dd>For large data sets you can save some memory (at the expense of more
-processing) by only storing one form of location coordinates
-(geographic or Cartesian 3-D vectors) at any given time, translating
-from one form to the other when necessary [Default keeps both arrays
-in memory]. Not applicable with <strong>-Q</strong>.</dd>
-<dt><strong>-E</strong></dt>
-<dd>Instead of computing distances, return the ID numbers of the Voronoi
-polygons that each grid node is inside [Default computes distances].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]</dt>
-<dd><em>x_inc</em> [and optionally <em>y_inc</em>] is the grid spacing. Optionally,
-append a suffix modifier. <strong>Geographical (degrees) coordinates</strong>: Append
-<strong>m</strong> to indicate arc minutes or <strong>s</strong> to indicate arc seconds. If one
-of the units <strong>e</strong>, <strong>f</strong>, <strong>k</strong>, <strong>M</strong>, <strong>n</strong> or <strong>u</strong> is appended
-instead, the increment is assumed to be given in meter, foot, km, Mile,
-nautical mile or US survey foot, respectively, and will be converted to
-the equivalent degrees longitude at the middle latitude of the region
-(the conversion depends on <a class="reference internal" href="gmt.conf.html#projection-parameters"><em>PROJ_ELLIPSOID</em></a>). If /<em>y_inc</em> is given
-but set to 0 it will be reset equal to <em>x_inc</em>; otherwise it will be
-converted to degrees latitude. <strong>All coordinates</strong>: If <strong>=</strong> is appended
-then the corresponding max <em>x</em> (<em>east</em>) or <em>y</em> (<em>north</em>) may be slightly
-adjusted to fit exactly the given increment [by default the increment
-may be adjusted slightly to fit the given domain]. Finally, instead of
-giving an increment you may specify the <em>number of nodes</em> desired by
-appending <strong>+</strong> to the supplied integer argument; the increment is then
-recalculated from the number of nodes and the domain. The resulting
-increment value depends on whether you have selected a
-gridline-registered or pixel-registered grid; see <a class="reference internal" href="GMT_Docs.html#app-file-formats"><em>B. GMT File Formats</em></a> for
-details. Note: if <strong>-R</strong><em>grdfile</em> is used then the grid spacing has
-already been initialized; use <strong>-I</strong> to override the values.</dd>
-<dt><strong>-L</strong><em>unit</em></dt>
-<dd>Specify the unit used for distance calculations. Choose among <strong>d</strong>
-(spherical degree), <strong>e</strong> (m), <strong>f</strong> (feet), <strong>k</strong> (km), <strong>M</strong>
-(mile), <strong>n</strong> (nautical mile) or <strong>u</strong> survey foot. A spherical
-approximation is used unless <a class="reference internal" href="gmt.conf.html#projection-parameters"><em>PROJ_ELLIPSOID</em></a> is set to an actual
-ellipsoid.</dd>
-<dt><strong>-N</strong></dt>
-<dd>Read the information pertaining to each Voronoi
-polygon (the unique node lon, lat and polygon area) from a separate
-file [Default acquires this information from the ASCII segment
-headers of the output file]. Required if binary input via <strong>-Q</strong> is used.</dd>
-<dt><strong>-Q</strong><em>voronoi.txt</em></dt>
-<dd>Append the name of a file with pre-calculated Voronoi polygons
-[Default performs the Voronoi construction on input data]. For
-binary data <strong>-bi</strong> you must specify the node
-information separately (via <strong>-N</strong>).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]</dt>
-<dd><em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> specify the region of interest,
-and you may specify them in decimal degrees or in
-[+-]dd:mm[:ss.xxx][W|E|S|N] format. Append <strong>r</strong> if lower left
-and upper right map coordinates are given instead of w/e/s/n. The
-two shorthands <strong>-Rg</strong> and <strong>-Rd</strong> stand for global domain (0/360
-and -180/+180 in longitude respectively, with -90/+90 in latitude).
-Alternatively, specify the name of an existing grid file and the
-<strong>-R</strong> settings (and grid spacing, if applicable) are copied from
-the grid. Using <strong>-R</strong><em>unit</em> expects projected (Cartesian)
-coordinates compatible with chosen <strong>-J</strong> and we inversely project
-to determine actual rectangular geographic region.
-For perspective view (<strong>-p</strong>), optionally append /<em>zmin</em>/<em>zmax</em>.
-In case of perspective view (<strong>-p</strong>), a z-range (<em>zmin</em>, <em>zmax</em>)
-can be appended to indicate the third dimension. This needs to be
-done only when using the <strong>-Jz</strong> option, not when using only the
-<strong>-p</strong> option. In the latter case a perspective view of the plane is
-plotted, with no third dimension. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 2 input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. [Default is same as input].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-r</strong> <a class="reference internal" href="gmt.html#nodereg-full"><em>(more ...)</em></a></dt>
-<dd>Set pixel node registration [gridline]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="ascii-format-precision">
-<h2>Ascii Format Precision<a class="headerlink" href="#ascii-format-precision" title="Permalink to this headline">¶</a></h2>
-<p>The ASCII output formats of numerical data are controlled by parameters
-in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file. Longitude and latitude are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>, whereas other values are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>. Be aware that the format in effect
-can lead to loss of precision in the output, which can lead to various
-problems downstream. If you find the output is not written with enough
-precision, consider switching to binary output (<strong>-bo</strong> if available) or
-specify more decimals using the <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> setting.</p>
-</div>
-<div class="section" id="grid-values-precision">
-<h2>Grid Values Precision<a class="headerlink" href="#grid-values-precision" title="Permalink to this headline">¶</a></h2>
-<p>Regardless of the precision of the input data, GMT programs that create
-grid files will internally hold the grids in 4-byte floating point
-arrays. This is done to conserve memory and furthermore most if not all
-real data can be stored using 4-byte floating point values. Data with
-higher precision (i.e., double precision values) will lose that
-precision once GMT operates on the grid or writes out new grids. To
-limit loss of precision when processing data you should always consider
-normalizing the data prior to processing.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To construct Voronoi polygons from the points in the file testdata.txt
-and then calculate distances from the data to a global 1x1 degree grid, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt sphdistance testdata.txt -Rg -I1 -Gglobedist.nc
-</pre></div>
-</div>
-</div></blockquote>
-<p>To generate the same grid in two steps using <strong>sphtriangulate</strong> separately, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt sphtriangulate testdata.txt -Qv > voronoi.txt
-gmt sphdistance -Qvoronoi.txt -Rg -I1 -Gglobedist.nc
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="sphtriangulate.html"><em>sphtriangulate</em></a>,
-<a class="reference internal" href="triangulate.html"><em>triangulate</em></a></p>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>Renka, R, J., 1997, Algorithm 772: STRIPACK: Delaunay Triangulation and
-Voronoi Diagram on the Surface of a Sphere, <em>AMC Trans. Math. Software</em>,
-<strong>23</strong>(3), 416-434.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">sphdistance</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#ascii-format-precision">Ascii Format Precision</a></li>
-<li><a class="reference internal" href="#grid-values-precision">Grid Values Precision</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="sph2grd.html"
- title="previous chapter">sph2grd</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="sphinterpolate.html"
- title="next chapter">sphinterpolate</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/sphdistance.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="sphinterpolate.html" title="sphinterpolate"
- >next</a> </li>
- <li class="right" >
- <a href="sph2grd.html" title="sph2grd"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="S.html" >S</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/sphinterpolate.html b/doc_release/html/sphinterpolate.html
deleted file mode 100644
index 8401a46..0000000
--- a/doc_release/html/sphinterpolate.html
+++ /dev/null
@@ -1,342 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>sphinterpolate — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="S" href="S.html" />
- <link rel="next" title="sphtriangulate" href="sphtriangulate.html" />
- <link rel="prev" title="sphdistance" href="sphdistance.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="sphtriangulate.html" title="sphtriangulate"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="sphdistance.html" title="sphdistance"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="S.html" accesskey="U">S</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="sphinterpolate">
-<span id="index-0"></span><h1>sphinterpolate<a class="headerlink" href="#sphinterpolate" title="Permalink to this headline">¶</a></h1>
-<p>sphinterpolate - Spherical gridding in tension of data on a sphere</p>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc1">Synopsis</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p><strong>sphinterpolate</strong> [ <em>table</em> ] <strong>-G</strong><em>grdfile</em>
-[ <strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]] ]
-[ <strong>-Q</strong><em>mode</em>[/<em>options</em>] ]
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-Z</strong> ]
-[ <strong>-b</strong>[<strong>i</strong>|<strong>o</strong>][<em>ncol</em>][<strong>type</strong>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-r</strong> ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>sphinterpolate</strong> reads one or more ASCII [or binary] files (or
-standard input) containing lon, lat, f and performs a Delaunay
-triangulation to set up a spherical interpolation in tension. The final
-grid is saved to the specified file. Several options may be used to
-affect the outcome, such as choosing local versus global gradient
-estimation or optimize the tension selection to satisfy one of four
-criteria.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-G</strong><em>grdfile</em></dt>
-<dd>Name of the output grid to hold the interpolation.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>[<em>ncols</em>][<em>type</em>]) data
-table file(s) holding a number of data columns. If no tables are given
-then we read from standard input. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]</dt>
-<dd><em>x_inc</em> [and optionally <em>y_inc</em>] is the grid spacing. Optionally,
-append a suffix modifier. <strong>Geographical (degrees) coordinates</strong>: Append
-<strong>m</strong> to indicate arc minutes or <strong>s</strong> to indicate arc seconds. If one
-of the units <strong>e</strong>, <strong>f</strong>, <strong>k</strong>, <strong>M</strong>, <strong>n</strong> or <strong>u</strong> is appended
-instead, the increment is assumed to be given in meter, foot, km, Mile,
-nautical mile or US survey foot, respectively, and will be converted to
-the equivalent degrees longitude at the middle latitude of the region
-(the conversion depends on <a class="reference internal" href="gmt.conf.html#projection-parameters"><em>PROJ_ELLIPSOID</em></a>). If /<em>y_inc</em> is given
-but set to 0 it will be reset equal to <em>x_inc</em>; otherwise it will be
-converted to degrees latitude. <strong>All coordinates</strong>: If <strong>=</strong> is appended
-then the corresponding max <em>x</em> (<em>east</em>) or <em>y</em> (<em>north</em>) may be slightly
-adjusted to fit exactly the given increment [by default the increment
-may be adjusted slightly to fit the given domain]. Finally, instead of
-giving an increment you may specify the <em>number of nodes</em> desired by
-appending <strong>+</strong> to the supplied integer argument; the increment is then
-recalculated from the number of nodes and the domain. The resulting
-increment value depends on whether you have selected a
-gridline-registered or pixel-registered grid; see <a class="reference internal" href="GMT_Docs.html#app-file-formats"><em>B. GMT File Formats</em></a> for
-details. Note: if <strong>-R</strong><em>grdfile</em> is used then the grid spacing has
-already been initialized; use <strong>-I</strong> to override the values.</dd>
-<dt><strong>-Q</strong><em>mode</em>[/<em>options</em>]</dt>
-<dd>Specify one of four ways to calculate tension factors to preserve
-local shape properties or satisfy arc constraints [Default is no
-tension].</dd>
-<dt><strong>-Q</strong>0</dt>
-<dd>Piecewise linear interpolation; no tension is applied.</dd>
-<dt><strong>-Q</strong>1</dt>
-<dd>Smooth interpolation with local gradient estimates.</dd>
-<dt><strong>-Q</strong>2</dt>
-<dd>Smooth interpolation with global gradient estimates. You may
-optionally append /<em>N</em>/<em>M</em>/<em>U</em>, where <em>N</em> is the number of
-iterations used to converge at solutions for gradients when variable
-tensions are selected (e.g., <strong>-T</strong> only) [3], <em>M</em> is the number of
-Gauss-Seidel iterations used when determining the global gradients
-[10], and <em>U</em> is the maximum change in a gradient at the last
-iteration [0.01].</dd>
-<dt><strong>-Q</strong>3</dt>
-<dd>Smoothing. Optionally append <em>/E/U</em> [/0/0], where <em>E</em> is Expected
-squared error in a typical (scaled) data value, and <em>U</em> is Upper
-bound on weighted sum of squares of deviations from data.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]</dt>
-<dd><em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> specify the region of interest,
-and you may specify them in decimal degrees or in
-[+-]dd:mm[:ss.xxx][W|E|S|N] format. Append <strong>r</strong> if lower left
-and upper right map coordinates are given instead of w/e/s/n. The
-two shorthands <strong>-Rg</strong> and <strong>-Rd</strong> stand for global domain (0/360
-and -180/+180 in longitude respectively, with -90/+90 in latitude).
-Alternatively, specify the name of an existing grid file and the
-<strong>-R</strong> settings (and grid spacing, if applicable) are copied from
-the grid. Using <strong>-R</strong><em>unit</em> expects projected (Cartesian)
-coordinates compatible with chosen <strong>-J</strong> and we inversely project
-to determine actual rectangular geographic region.
-For perspective view (<strong>-p</strong>), optionally append /<em>zmin</em>/<em>zmax</em>.
-In case of perspective view (<strong>-p</strong>), a z-range (<em>zmin</em>, <em>zmax</em>)
-can be appended to indicate the third dimension. This needs to be
-done only when using the <strong>-Jz</strong> option, not when using only the
-<strong>-p</strong> option. In the latter case a perspective view of the plane is
-plotted, with no third dimension. </dd>
-<dt><strong>-T</strong></dt>
-<dd>Use variable tension (ignored with <strong>-Q</strong>0 [constant]</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-Z</strong></dt>
-<dd>Before interpolation, scale data by the maximum data range [no
-scaling].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 3 input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. [Default is same as input].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-r</strong> <a class="reference internal" href="gmt.html#nodereg-full"><em>(more ...)</em></a></dt>
-<dd>Set pixel node registration [gridline]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="ascii-format-precision">
-<h2>Ascii Format Precision<a class="headerlink" href="#ascii-format-precision" title="Permalink to this headline">¶</a></h2>
-<p>The ASCII output formats of numerical data are controlled by parameters
-in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file. Longitude and latitude are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>, whereas other values are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>. Be aware that the format in effect
-can lead to loss of precision in the output, which can lead to various
-problems downstream. If you find the output is not written with enough
-precision, consider switching to binary output (<strong>-bo</strong> if available) or
-specify more decimals using the <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> setting.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To interpolate the points in the file testdata.txt on a global 1x1
-degree grid with no tension, use</p>
-<blockquote>
-<div>sphinterpolate testdata.txt -Rg -I1 -Gsolution.nc</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="greenspline.html"><em>greenspline</em></a>,
-<a class="reference internal" href="nearneighbor.html"><em>nearneighbor</em></a>,
-<a class="reference internal" href="sphdistance.html"><em>sphdistance</em></a>,
-<a class="reference internal" href="sphtriangulate.html"><em>sphtriangulate</em></a>,
-<a class="reference internal" href="surface.html"><em>surface</em></a>,
-<a class="reference internal" href="triangulate.html"><em>triangulate</em></a></p>
-</div>
-<div class="section" id="id2">
-<h2><a class="reference external" href="#toc10">References</a><a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h2>
-<p>Renka, R, J., 1997, Algorithm 772: STRIPACK: Delaunay Triangulation and
-Voronoi Diagram on the Surface of a Sphere, <em>AMC Trans. Math. Software</em>,
-<strong>23</strong>(3), 416-434.</p>
-<p>Renka, R, J,, 1997, Algorithm 773: SSRFPACK: Interpolation of scattered
-data on the Surface of a Sphere with a surface under tension, <em>AMC
-Trans. Math. Software</em>, <strong>23</strong>(3), 435-442.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">sphinterpolate</a><ul>
-<li><a class="reference internal" href="#id1">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#ascii-format-precision">Ascii Format Precision</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-<li><a class="reference internal" href="#id2">References</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="sphdistance.html"
- title="previous chapter">sphdistance</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="sphtriangulate.html"
- title="next chapter">sphtriangulate</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/sphinterpolate.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="sphtriangulate.html" title="sphtriangulate"
- >next</a> </li>
- <li class="right" >
- <a href="sphdistance.html" title="sphdistance"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="S.html" >S</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/sphtriangulate.html b/doc_release/html/sphtriangulate.html
deleted file mode 100644
index eb0eef3..0000000
--- a/doc_release/html/sphtriangulate.html
+++ /dev/null
@@ -1,306 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>sphtriangulate — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="S" href="S.html" />
- <link rel="next" title="splitxyz" href="splitxyz.html" />
- <link rel="prev" title="sphinterpolate" href="sphinterpolate.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="splitxyz.html" title="splitxyz"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="sphinterpolate.html" title="sphinterpolate"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="S.html" accesskey="U">S</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="sphtriangulate">
-<span id="index-0"></span><h1>sphtriangulate<a class="headerlink" href="#sphtriangulate" title="Permalink to this headline">¶</a></h1>
-<p>sphtriangulate - Delaunay or Voronoi construction of spherical lon,lat data</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>sphtriangulate</strong> [ <em>table</em> ] [ <strong>-A</strong> ] [ <strong>-C</strong> ] [ <strong>-D</strong> ]
-[ <strong>-L</strong><em>unit</em> ] [ <strong>-N</strong><em>nfile</em> ] [ <strong>-Q</strong><strong>d</strong>|<strong>v</strong> ]
-[ <strong>-T</strong> ] [ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-b</strong>[<strong>i</strong>|<strong>o</strong>][<em>ncol</em>][<strong>type</strong>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>sphtriangulate</strong> reads one or more ASCII [or binary] files (or
-standard input) containing lon, lat and performs a spherical Delaunay
-triangulation, i.e., it find how the points should be connected to give
-the most equilateral triangulation possible on the sphere. Optionally,
-you may choose <strong>-Qv</strong> which will do further processing to obtain the
-Voronoi polygons. Normally, either set of polygons will be written as
-fillable segment output; use <strong>-T</strong> to write unique arcs instead. As an
-option, compute the area of each triangle or polygon. The algorithm used
-is STRIPACK.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<p>None.</p>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>[<em>ncols</em>][<em>type</em>]) data
-table file(s) holding a number of data columns. If no tables are given
-then we read from standard input. </dd>
-<dt><strong>-A</strong></dt>
-<dd>Compute the area of the spherical triangles (<strong>-Qd</strong>) or polygons
-(<strong>-Qv</strong>) and write the areas (in chosen units; see <strong>-L</strong>) in the
-output segment headers [no areas calculated].</dd>
-<dt><strong>-C</strong></dt>
-<dd>For large data set you can save some memory (at the expense of more
-processing) by only storing one form of location coordinates
-(geographic or Cartesian 3-D vectors) at any given time, translating
-from one form to the other when necessary [Default keeps both arrays in memory].</dd>
-<dt><strong>-D</strong></dt>
-<dd>Used with <strong>-m</strong> to skip the last (repeated) input vertex at the end
-of a closed segment if it equals the first point in the segment.
-Requires <strong>-m</strong> [Default uses all points].</dd>
-<dt><strong>-L</strong><em>unit</em></dt>
-<dd>Specify the unit used for distance and area calculations. Choose
-among <strong>e</strong> (m), <strong>f</strong> (foot), <strong>k</strong> (km), <strong>m</strong> (mile), <strong>n</strong>
-(nautical mile), <strong>u</strong> (survey foot), or <strong>d</strong> (spherical degree). A
-spherical approximation is used unless <a class="reference internal" href="gmt.conf.html#proj-ellipsoid"><em>PROJ_ELLIPSOID</em></a> is set to
-an actual ellipsoid, in which case we convert latitudes to authalic
-latitudes before calculating areas. When degree is selected the
-areas are given in steradians.</dd>
-<dt><strong>-N</strong><em>nfile</em></dt>
-<dd>Write the information pertaining to each polygon (for Delaunay: the
-three node number and the triangle area (if <strong>-A</strong> was set); for
-Voronoi the unique node lon, lat and polygon area (if <strong>-A</strong> was
-set)) to a separate file. This information is also encoded in the
-segment headers of ASCII output files]. Required if binary output is needed.</dd>
-<dt><strong>d</strong>|<strong>v</strong></dt>
-<dd>Select between <strong>d</strong>elaunay or <strong>v</strong>oronoi mode [Delaunay].</dd>
-<dt><strong>-T</strong></dt>
-<dd>Write the unique arcs of the construction [Default writes fillable
-triangles or polygons]. When used with <strong>-A</strong> we store arc lenght in
-the segment header in chosen unit (see <strong>-L</strong>).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 2 input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. [Default is same as input].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-r</strong> <a class="reference internal" href="gmt.html#nodereg-full"><em>(more ...)</em></a></dt>
-<dd>Set pixel node registration [gridline]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="ascii-format-precision">
-<h2>Ascii Format Precision<a class="headerlink" href="#ascii-format-precision" title="Permalink to this headline">¶</a></h2>
-<p>The ASCII output formats of numerical data are controlled by parameters
-in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file. Longitude and latitude are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>, whereas other values are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>. Be aware that the format in effect
-can lead to loss of precision in the output, which can lead to various
-problems downstream. If you find the output is not written with enough
-precision, consider switching to binary output (<strong>-bo</strong> if available) or
-specify more decimals using the <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> setting.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To triangulate the points in the file testdata.txt, and make a Voronoi
-diagram via <a class="reference internal" href="psxy.html"><em>psxy</em></a>, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt sphtriangulate testdata.txt -Qv | psxy -Rg -JG30/30/6i -L -P -W1p -B0g30 | gv -
-</pre></div>
-</div>
-</div></blockquote>
-<p>To compute the optimal Delaunay triangulation network based on the
-multiple segment file globalnodes.d and save the area of each triangle
-in the header record, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt sphtriangulate globalnodes.d -Qd -A > global_tri.d
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="triangulate.html"><em>triangulate</em></a>,
-<a class="reference internal" href="sphdistance.html"><em>sphdistance</em></a></p>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>Renka, R, J., 1997, Algorithm 772: STRIPACK: Delaunay Triangulation and
-Voronoi Diagram on the Surface of a Sphere, <em>AMC Trans. Math. Software</em>,
-<strong>23</strong>(3), 416-434.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">sphtriangulate</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#ascii-format-precision">Ascii Format Precision</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="sphinterpolate.html"
- title="previous chapter">sphinterpolate</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="splitxyz.html"
- title="next chapter">splitxyz</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/sphtriangulate.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="splitxyz.html" title="splitxyz"
- >next</a> </li>
- <li class="right" >
- <a href="sphinterpolate.html" title="sphinterpolate"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="S.html" >S</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/splitxyz.html b/doc_release/html/splitxyz.html
deleted file mode 100644
index 2bb9501..0000000
--- a/doc_release/html/splitxyz.html
+++ /dev/null
@@ -1,349 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>splitxyz — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="S" href="S.html" />
- <link rel="next" title="surface" href="surface.html" />
- <link rel="prev" title="sphtriangulate" href="sphtriangulate.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="surface.html" title="surface"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="sphtriangulate.html" title="sphtriangulate"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="S.html" accesskey="U">S</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="splitxyz">
-<span id="index-0"></span><h1>splitxyz<a class="headerlink" href="#splitxyz" title="Permalink to this headline">¶</a></h1>
-<p>splitxyz - Split xyz[dh] data tables into individual segments</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>splitxyz</strong> [ <em>table</em> ]
-[ <strong>-A</strong><em>azimuth</em>/<em>tolerance</em> ] [<strong>-C</strong><em>course_change</em>] [ <strong>-D</strong><em>minimum_distance</em> ]
-[ <strong>-F</strong><em>xy_filter</em>/<em>z_filter</em> ] [ <strong>-N</strong><em>template</em> ]
-[ <strong>-Q</strong><em>flags</em> ] [ <strong>-S</strong> ] [ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-b</strong>[<strong>i</strong>|<strong>o</strong>][<em>ncol</em>][<strong>type</strong>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>splitxyz</strong> reads a series of (x,y[,z]) records [or optionally
-(x,y,z,d,h); see <strong>-S</strong> option] from standard input [or <em>xyz[dh]file</em>]
-and splits this into separate lists of (x,y[,z]) series, such that each
-series has a nearly constant azimuth through the x,y plane. There are
-options to choose only those series which have a certain orientation, to
-set a minimum length for series, and to high- or low-pass filter the z
-values and/or the x,y values. <strong>splitxyz</strong> is a useful filter between
-data extraction and <a class="reference internal" href="pswiggle.html"><em>pswiggle</em></a> plotting, and can also be used to
-divide a large x,y[,z] dataset into segments.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<p>none.</p>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII [or binary, see <strong>-bi</strong>]
-files with 2, 3, or 5 columns holding (x,y,[z[,d,h]])
-data values. To use (x,y,z,d,h) input, sorted so that d is
-non-decreasing, specify the <strong>-S</strong> option; default expects (x,y,z)
-only. If no files are specified, <strong>splitxyz</strong> will read from
-standard input.</dd>
-<dt><strong>-A</strong><em>azimuth</em>/<em>tolerance</em></dt>
-<dd>Write out only those segments which are within +/- <em>tolerance</em>
-degrees of <em>azimuth</em> in heading, measured clockwise from North, [0 -
-360]. [Default writes all acceptable segments, regardless of
-orientation].</dd>
-<dt><strong>-C</strong><em>course_change</em></dt>
-<dd>Terminate a segment when a course change exceeding <em>course_change</em>
-degrees of heading is detected [ignore course changes].</dd>
-<dt><strong>-D</strong><em>minimum_distance</em></dt>
-<dd>Do not write a segment out unless it is at least <em>minimum_distance</em>
-units long [0]</dd>
-<dt><strong>-F</strong><em>xy_filter</em>/<em>z_filter</em></dt>
-<dd>Filter the z values and/or the x,y values, assuming these are
-functions of d coordinate. <em>xy_filter</em> and <em>z_filter</em> are filter
-widths in distance units. If a filter width is zero, the filtering
-is not performed. The absolute value of the width is the full width
-of a cosine-arch low-pass filter. If the width is positive, the data
-are low-pass filtered; if negative, the data are high-pass filtered
-by subtracting the low-pass value from the observed value. If
-<em>z_filter</em> is non-zero, the entire series of input z values is
-filtered before any segmentation is performed, so that the only edge
-effects in the filtering will happen at the beginning and end of the
-complete data stream. If <em>xy_filter</em> is non-zero, the data is first
-divided into segments and then the x,y values of each segment are
-filtered separately. This may introduce edge effects at the ends of
-each segment, but prevents a low-pass x,y filter from rounding off
-the corners of track segments. [Default = no filtering].</dd>
-<dt><strong>-N</strong><em>template</em></dt>
-<dd>Write each segment to a separate output file [Default writes a
-multiple segment file to stdout]. Append a format template for the
-individual file names; this template <strong>must</strong> contain a C format
-specifier that can format an integer argument (the running segment
-number across all tables); this is usually %d but could be %08d
-which gives leading zeros, etc. [Default is
-splitxyz_segment_%d.{txt|bin}, depending on
-<strong>-bo</strong>]. Alternatively, give a template with
-two C format specifiers and we will supply the table number and the
-segment number within the table to build the file name.</dd>
-<dt><strong>-Q</strong><em>flags</em></dt>
-<dd>Specify your desired output using any combination of <em>xyzdh</em>, in any
-order. Do not space between the letters. Use lower case. The output
-will be ASCII (or binary, see <strong>-bo</strong>)
-columns of values corresponding to <em>xyzdh</em> [Default is
-<strong>-Q</strong><em>xyzdh</em> (<strong>-Q</strong><em>xydh</em> if only 2 input columns)].</dd>
-<dt><strong>-S</strong></dt>
-<dd>Both d and h are supplied. In this case, input contains x,y,z,d,h.
-[Default expects (x,y,z) input, and d,h are computed from delta x,
-delta y. Use <strong>-fg</strong> to indicate map data; then x,y are assumed to
-be in degrees of longitude, latitude, distances are considered to be
-in kilometers, and angles are actually azimuths. Otherwise,
-distances are Cartesian in same units as x,y and angles are
-counter-clockwise from horizontal].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 2, 3, or 5 input columns as set by <strong>-S</strong>].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. [Default is 1-5 output columns as set by <strong>-Q</strong>].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-g</strong>[<strong>a</strong>]<strong>x</strong>|<strong>y</strong>|<strong>d</strong>|<strong>X</strong>|<strong>Y</strong>|<strong>D</strong>|[<em>col</em>]<strong>z</strong>[+|-]<em>gap</em>[<strong>u</strong>] <a class="reference internal" href="gmt.html#g-full"><em>(more ...)</em></a></dt>
-<dd>Determine data gaps and line breaks. Do not let a segment have a gap exceeding <em>gap</em>; instead, split it into two segments. [Default ignores gaps].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="ascii-format-precision">
-<h2>Ascii Format Precision<a class="headerlink" href="#ascii-format-precision" title="Permalink to this headline">¶</a></h2>
-<p>The ASCII output formats of numerical data are controlled by parameters
-in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file. Longitude and latitude are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>, whereas other values are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>. Be aware that the format in effect
-can lead to loss of precision in the output, which can lead to various
-problems downstream. If you find the output is not written with enough
-precision, consider switching to binary output (<strong>-bo</strong> if available) or
-specify more decimals using the <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> setting.</p>
-</div>
-<div class="section" id="distance-calculations">
-<h2>Distance Calculations<a class="headerlink" href="#distance-calculations" title="Permalink to this headline">¶</a></h2>
-<p>The type of input data is dictated by the <strong>-f</strong> option. If <strong>-fg</strong> is
-given then x,y are in degrees of longitude, latitude, distances are in
-kilometers, and angles are azimuths. Otherwise, distances are Cartesian
-in same units as x,y and angles are counter-clockwise from horizontal.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>Suppose you want to make a wiggle plot of magnetic anomalies on segments
-oriented approximately east-west from a NGDC-supplied cruise called JA020015 in the
-region <strong>-R</strong>300/315/12/20. You want to use a 100 km low-pass filter to
-smooth the tracks and a 500km high-pass filter to detrend the magnetic
-anomalies. Try this:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mgd77list JA020015 -R300/315/12/20 -Flon,lat,mag,dist,azim | gmt splitxyz -A90/15 -F100/-500 \
- -D100 -S -V -fg | gmt pswiggle -R300/315/12/20 -Jm0.6i -Baf -B+tJA020015 -T1 \
- -W0.75p -Ggray -Z200 > JA020015_wiggles.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>MGD-77 users: For this application we recommend that you extract dist,azim
-from <a class="reference internal" href="supplements/mgd77/mgd77list.html"><em>mgd77list</em></a> rather than have
-<strong>splitxyz</strong> compute them separately.</p>
-<p>Suppose you have been given a binary, double-precision file containing
-lat, lon, gravity values from a survey, and you want to split it into
-profiles named <em>survey</em>_<em>###.txt</em> (when gap exceeds 100 km). Try this:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt splitxyz survey.bin -Nsurvey_%03d.txt -V -gd100k -D100 -: -fg -bi3d
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="filter1d.html"><em>filter1d</em></a>,
-<a class="reference internal" href="supplements/mgd77/mgd77list.html"><em>mgd77list</em></a>,
-<a class="reference internal" href="pswiggle.html"><em>pswiggle</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">splitxyz</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#ascii-format-precision">Ascii Format Precision</a></li>
-<li><a class="reference internal" href="#distance-calculations">Distance Calculations</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="sphtriangulate.html"
- title="previous chapter">sphtriangulate</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="surface.html"
- title="next chapter">surface</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/splitxyz.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="surface.html" title="surface"
- >next</a> </li>
- <li class="right" >
- <a href="sphtriangulate.html" title="sphtriangulate"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="S.html" >S</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/gshhg/gshhg.html b/doc_release/html/supplements/gshhg/gshhg.html
deleted file mode 100644
index 4808943..0000000
--- a/doc_release/html/supplements/gshhg/gshhg.html
+++ /dev/null
@@ -1,322 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>gshhg — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="GSHHG" href="../../SUP_GSHHS.html" />
- <link rel="next" title="IMGSRC" href="../../SUP_IMGSRC.html" />
- <link rel="prev" title="GSHHG" href="../../SUP_GSHHS.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="../../SUP_IMGSRC.html" title="IMGSRC"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="../../SUP_GSHHS.html" title="GSHHG"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_GSHHS.html" accesskey="U">GSHHG</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gshhg">
-<span id="index-0"></span><h1>gshhg<a class="headerlink" href="#gshhg" title="Permalink to this headline">¶</a></h1>
-<p>gshhg - Extract data tables from binary GSHHG or WDBII data files</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>gshhg</strong> <em>binaryfile.b</em> [ <strong>-A</strong><em>min</em> ] [ <strong>-G</strong> ] [ <strong>-I</strong><em>id</em> ]
-[ <strong>-L</strong> ] [ <strong>-N</strong><em>level</em> ] [ <strong>-Qe</strong>|<strong>i</strong> ]
-[ <strong>-bo</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-o</strong><em>cols</em>[,...] ] > <em>asciifile.txt</em></p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>gshhg</strong> reads the binary coastline (GSHHG) or political boundary or
-river (WDBII) files and extracts an ASCII listing. It automatically
-handles byte-swabbing between different architectures. Optionally, only
-segment header info can be displayed. The header info has the format <em>ID
-npoints hierarchical-level source area f_area west east south north
-container ancestor</em>, where hierarchical levels for coastline polygons go
-from 1 (shoreline) to 4 (lake inside island inside lake inside land).
-Source is either W (World Vector Shoreline) or C (CIA World Data Bank
-II); lower case is used if a lake is a river-lake. The <em>west east south
-north</em> is the enclosing rectangle, <em>area</em> is the polygon area in km^2
-while <em>f_area</em> is the actual area of the ancestor polygon, <em>container</em>
-is the ID of the polygon that contains this polygon (-1 if none), and
-<em>ancestor</em> is the ID of the polygon in the full resolution set that was
-reduced to yield this polygon (-1 if full resolution since there is no
-ancestor). For line data the header is simply <em>ID npoints
-hierarchical-level source west east south north</em>. For more information
-about the file formats, see TECHNICAL INFORMATION below.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>binaryfile.b</em></dt>
-<dd>GSHHG or WDBII binary data file as distributed with the GSHHG data
-supplement. Any of the 5 standard resolutions (full, high,
-intermediate, low, crude) can be used.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong><em>min</em></dt>
-<dd>Only output information for the polygon if its area equals or
-exceeds <em>min</em> [Default outputs all polygons].</dd>
-<dt><strong>-G</strong></dt>
-<dd>Write output that can be imported into GNU Octave or Matlab by
-ending segments with a NaN-record.</dd>
-<dt><strong>-I</strong><em>id</em></dt>
-<dd>Only output information for the polygon that matches <em>id</em>. Use
-<strong>-Ic</strong> to get all the continents only [Default outputs all
-polygons].</dd>
-<dt><strong>-L</strong></dt>
-<dd>Only output a listing of polygon or line segment headers [Default
-outputs headers and data records].</dd>
-<dt><strong>-N</strong></dt>
-<dd>Only output features whose level matches the given <em>level</em> [Default
-will output all levels].</dd>
-<dt><strong>-Qe</strong>|<strong>i</strong></dt>
-<dd>Control what to do with river-lakes (river sections large enough to
-be stored as closed polygons). Use <strong>-Qe</strong> to exclude them and
-<strong>-Qi</strong> to exclude everything else instead [Default outputs all
-polygons].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="../../gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-o</strong><em>cols</em>[,...] <a class="reference internal" href="../../gmt.html#ocols-full"><em>(more ...)</em></a></dt>
-<dd>Select output columns (0 is first column).</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To convert the entire intermediate GSHHG binary data to ASCII files for
-Octave/Mathlab, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gshhg gshhs_i.b --IO_SEGMENT_MARKER=N > gshhs_i.txt
-</pre></div>
-</div>
-</div></blockquote>
-<p>To only get a listing of the headers for the river data set at full
-resolution, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gshhg wdb_rivers_f.b -L > riverlisting.txt
-</pre></div>
-</div>
-</div></blockquote>
-<p>To only extract lakes, excluding river-lakes, from the high resolution
-file, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gshhg gshhs_h.b -Ee -N2 > all_lakes.txt
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="technical-information">
-<h2>Technical Information<a class="headerlink" href="#technical-information" title="Permalink to this headline">¶</a></h2>
-<p>Users who wish to access the GSHHG or WDBII data directly from their
-custom programs should consult the gshhg.c and gshhg.h source code and
-familiarize themselves with the data format and how various information
-flags are packed into a single 4-byte integer. While we do not maintain
-any Octave/Matlab code to read these files we are aware that both
-Mathworks and IDL have made such tools available to their users.
-However, they tend not to update their code and our file structure has
-evolved considerably over time, breaking their code. Here, some general
-technical comments on the binary data files are given.
-<strong>GSHHG</strong>: These files contain completely closed polygons of continents
-and islands (level 1), lakes (level 2), islands-in-lakes (level 3) and
-ponds-in-islands-in-lakes (level 4); a particular level can be extracted
-using the <strong>-N</strong> option. Continents are identified as the first 6
-polygons and can be extracted via the <strong>-Ic</strong> option. The IDs for the
-continents are Eurasia (0), Africa (1), North America
-(2), South America (3), Antarctica (4), and Australia
-(5). Files are sorted on area from large to small.
-There are two sub-groups for level 2: Regular lakes and the so-called
-“river-lakes”, the latter being sections of a river that are so wide to
-warrant a polygon representation. These river-lakes are flagged in the
-header (also see <strong>-Q</strong>). All five resolutions are free of
-self-intersections. Areas of all features have been computed using a
-Lambert azimuthal equal-area projection centered on the polygon
-centroids, using WGS-84 as the ellipsoid. GMT use the GSHHG as a
-starting point but then partition the polygons into pieces using a
-resolution-dependent binning system; parts of the world are then rebuilt
-into closed polygons on the fly as needed. For more information on GSHHG
-processing, see Wessel and Smith (1996).
-<strong>WDBII</strong>. These files contain sets of line segments not necessarily in
-any particular order. Thus, it is not possible to extract information
-pertaining to just one river or one country. Furthermore, the 4 lower
-resolutions derive directly from the full resolution by application of
-the Douglas-Peucker algorithm (see gshhg_dp), hence self-intersections
-are increasingly likely as the resolution is degraded. Note that the
-river-lakes included in GSHHG are also duplicated in the WDBII river
-files so that each data set can be a stand-alone representation. Users
-who wish to access both data sets can recognize the river-lakes features
-by examining the header structure (see the source code for details);
-they are also the only closed polygons in the WDBII river file. There
-are many levels (classes) in the river file: River-lakes (0), Permanent
-major rivers (1), Additional major rivers
-(2), Additional rivers (3), Minor rivers (4), Intermittent rivers – major
-(6), Intermittent rivers – additional (7), Intermittent rivers – minor
-(8), Major canals (10), Canals of lesser importance
-(11), and Canals – irrigation type (12). For the border file there are
-three levels: National boundaries (1), Internal
-domestic boundaries (2), and international
-maritime boundaries (3). Individual levels or
-classes may be extracted via <strong>-N</strong>.</p>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>Douglas, D. H., and T. K. Peucker, 1973, Algorithms for the reduction of
-the number of points required to represent a digitized line of its
-caricature, <em>Can. Cartogr., 10</em>, 112-122.</p>
-<p>Gorny, A. J., 1977, <em>World Data Bank II General User GuideRep. PB
-271869</em>, 10pp, Central Intelligence Agency, Washington, DC.</p>
-<p>Soluri, E. A., and V. A. Woodson, 1990, World Vector Shoreline, <em>Int.
-Hydrograph. Rev., LXVII(1), 27-35.</em></p>
-<p>Wessel, P., and W. H. F. Smith, 1996, A global, self-consistent,
-hierarchical, high-resolution shoreline database, <em>J. Geophys. Res.,
-101(B4)</em>, 8741-8743.*</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="../../gmt.html"><em>gmt</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">gshhg</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#technical-information">Technical Information</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="../../SUP_GSHHS.html"
- title="previous chapter">GSHHG</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="../../SUP_IMGSRC.html"
- title="next chapter">IMGSRC</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/gshhg/gshhg.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="../../SUP_IMGSRC.html" title="IMGSRC"
- >next</a> </li>
- <li class="right" >
- <a href="../../SUP_GSHHS.html" title="GSHHG"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_GSHHS.html" >GSHHG</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/img/img2google.html b/doc_release/html/supplements/img/img2google.html
deleted file mode 100644
index 96f950c..0000000
--- a/doc_release/html/supplements/img/img2google.html
+++ /dev/null
@@ -1,287 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>img2google — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="IMGSRC" href="../../SUP_IMGSRC.html" />
- <link rel="next" title="MECA" href="../../SUP_MECA.html" />
- <link rel="prev" title="img2grd" href="img2grd.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="../../SUP_MECA.html" title="MECA"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="img2grd.html" title="img2grd"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_IMGSRC.html" accesskey="U">IMGSRC</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="img2google">
-<span id="index-0"></span><h1>img2google<a class="headerlink" href="#img2google" title="Permalink to this headline">¶</a></h1>
-<p>img2google - Create Google Earth KML overlay tiles from bathymetry
-Mercator img grid</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>img2google</strong>
-<strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>]
-[ <em>imgfile</em> ]
-[ <strong>-A</strong><em>mode</em>[<em>altitude</em>] ] [ <strong>-C</strong> ]
-[ <strong>-F</strong><em>fademin/fademax</em> ] [ <strong>-G</strong><em>prefix</em> ]
-[ <strong>-L</strong><em>LODmin/LODmax</em> ] [ <strong>-N</strong><em>layername</em> ] [ <strong>-T</strong><em>doctitle</em> ]
-[ <strong>-U</strong><em>URL</em> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-Z</strong> ]</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>img2google</strong> is a shell script that reads a 1x1 minute Mercator surface relief img file and
-creates a Google Earth overlay KML file and associated PNG tile for the
-specified region. If no input file is given we use topo.11.1.img.</p>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]</dt>
-<dd><em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> specify the region of interest,
-and you may specify them in decimal degrees or in
-[+-]dd:mm[:ss.xxx][W|E|S|N] format. Append <strong>r</strong> if lower left
-and upper right map coordinates are given instead of w/e/s/n. The
-two shorthands <strong>-Rg</strong> and <strong>-Rd</strong> stand for global domain (0/360
-and -180/+180 in longitude respectively, with -90/+90 in latitude).
-Alternatively, specify the name of an existing grid file and the
-<strong>-R</strong> settings (and grid spacing, if applicable) are copied from
-the grid. Using <strong>-R</strong><em>unit</em> expects projected (Cartesian)
-coordinates compatible with chosen <strong>-J</strong> and we inversely project
-to determine actual rectangular geographic region.
-For perspective view (<strong>-p</strong>), optionally append /<em>zmin</em>/<em>zmax</em>.
-In case of perspective view (<strong>-p</strong>), a z-range (<em>zmin</em>, <em>zmax</em>)
-can be appended to indicate the third dimension. This needs to be
-done only when using the <strong>-Jz</strong> option, not when using only the
-<strong>-p</strong> option. In the latter case a perspective view of the plane is
-plotted, with no third dimension. </dd>
-</dl>
-</div>
-<div class="section" id="options">
-<h2>Options<a class="headerlink" href="#options" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>imgfile</em></dt>
-<dd>An img format bathymetry/topography file such as those created by
-Sandwell and Smith. If this files does not exist in the current
-directory and the user has set the environment variable
-<strong>$GMT_DATADIR</strong>, then <a class="reference internal" href="img2grd.html"><em>img2grd</em></a> will try
-to find <em>imgfile</em> in <strong>$GMT_DATADIR</strong>.</dd>
-<dt><strong>-A</strong></dt>
-<dd>Selects one of 5 altitude modes recognized by Google Earth that
-determines the altitude (in m) of the image: <strong>G</strong> clamped to the
-ground, <strong>g</strong> append altitude relative to ground, <strong>a</strong> append absolute
-altitude, <strong>s</strong> append altitude relative to seafloor, and <strong>S</strong> clamp it
-to the seafloor [Default].</dd>
-<dt><strong>-C</strong></dt>
-<dd>Turn on clipping so that only portions below sea level will be visible
-in the image [no clipping].</dd>
-<dt><strong>-F</strong></dt>
-<dd>Sets the distance over which the geometry fades, from fully opaque to
-fully transparent. These ramp values, expressed in screen pixels, are
-applied at the minimum and maximum end of the LOD (visibility) limits,
-respectively. [no fading (0/0)].</dd>
-<dt><strong>-G</strong></dt>
-<dd>Specify the prefix for the output image file (the extensions are set
-automatically). Default uses the naming
-topoN|S<em><north></em>E|W<<em>west</em>>.</dd>
-<dt><strong>-L</strong></dt>
-<dd>Measurement in screen pixels that represents the minimum limit of the
-visibility range for a given Region Google Earth calculates the size of
-the Region when projected onto screen space. Then it computes the square
-root of the Region’s area (if, for example, the Region is square and the
-viewpoint is directly above the Region, and the Region is not tilted,
-this measurement is equal to the width of the projected Region). If this
-measurement falls within the limits defined by <em>LODmin</em> and <em>LODmax</em>
-(and if the region is in view), the Region is active. If this limit is
-not reached, the associated geometry is considered to be too far from
-the user’s viewpoint to be drawn. <em>LODmax</em> represents the maximum limit
-of the visibility range for a given Region. A value of â1, the default,
-indicates “active to infinite size.” [always active].</dd>
-<dt><strong>-N</strong></dt>
-<dd>Append the layername of the image (use quotes if strings contain spaces)
-[topoN|S<<em>north</em>>E|W<<em>west</em>>].</dd>
-<dt><strong>-T</strong></dt>
-<dd>Append the document title (use quotes if strings contain spaces)
-[“Predicted bathymetry”].</dd>
-<dt><strong>-U</strong></dt>
-<dd>By default, images are referenced locally relative to the KML file.
-Specify an URL to prepend a server address to the image name reference
-[local].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-Z</strong></dt>
-<dd>Uses zip (which must be installed) to create a *.kmz file for easy
-distribution; append <strong>+</strong> to delete the KML and PNG file after zipping
-[No zipping].</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To create a 10x10 degree Google Earth KML tile for the region
-<strong>-R</strong>170/180/20/30 using the default <em>topo.11.1.img</em> and output
-naming convention, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre><span class="n">img2google</span> <span class="o">-</span><span class="n">R170</span><span class="o">/</span><span class="mi">180</span><span class="o">/</span><span class="mi">20</span><span class="o">/</span><span class="mi">30</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>To make the same tile with the previous <em>topo.10.1.img</em>, run in verbose
-mode, clip so only oceanic areas are visible, name the output oldimage,
-specify the KML metadata directly (including setting the image altitude
-to 10 km), and make a single *.kmz file, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>img2google topo.10.1.img -R170/180/20/30 -Aa10000 -C -Goldimage \
--N"My KML title" -T"My KML title" -Uhttp://my.server.com/images -V -Z
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="data-sets">
-<h2>DATA SETS<a class="headerlink" href="#data-sets" title="Permalink to this headline">¶</a></h2>
-<p>For topo.11.1.img and other Sandwell/Smith altimetry-derived Mercator
-grids, visit <a class="reference external" href="http://topex.ucsd.edu">http://topex.ucsd.edu</a>.</p>
-</div>
-<div class="section" id="see-also">
-<h2>SEE ALSO<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="../../gmt.html"><em>gmt</em></a>
-<a class="reference internal" href="img2grd.html"><em>img2grd</em></a>,
-<a class="reference internal" href="../../ps2raster.html"><em>ps2raster</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">img2google</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#options">Options</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#data-sets">DATA SETS</a></li>
-<li><a class="reference internal" href="#see-also">SEE ALSO</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="img2grd.html"
- title="previous chapter">img2grd</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="../../SUP_MECA.html"
- title="next chapter">MECA</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/img/img2google.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="../../SUP_MECA.html" title="MECA"
- >next</a> </li>
- <li class="right" >
- <a href="img2grd.html" title="img2grd"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_IMGSRC.html" >IMGSRC</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/img/img2grd.html b/doc_release/html/supplements/img/img2grd.html
deleted file mode 100644
index 95eb924..0000000
--- a/doc_release/html/supplements/img/img2grd.html
+++ /dev/null
@@ -1,424 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>img2grd — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="IMGSRC" href="../../SUP_IMGSRC.html" />
- <link rel="next" title="img2google" href="img2google.html" />
- <link rel="prev" title="IMGSRC" href="../../SUP_IMGSRC.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="img2google.html" title="img2google"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="../../SUP_IMGSRC.html" title="IMGSRC"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_IMGSRC.html" accesskey="U">IMGSRC</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="img2grd">
-<span id="index-0"></span><h1>img2grd<a class="headerlink" href="#img2grd" title="Permalink to this headline">¶</a></h1>
-<p>img2grd - Extract subset of img file in Mercator or Geographic format</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>img2grd</strong> <em>imgfile</em> <strong>-G</strong><em>grdfile</em>
-<strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>]
-<strong>-T</strong><em>type</em> [ <strong>-C</strong> ]
-[ <strong>-D</strong>[<em>minlat/maxlat</em>] ] [ <strong>-E</strong> ] [ <strong>-I</strong><em>minutes</em> ]
-[ <strong>-M</strong> ] [ <strong>-N</strong><em>navg</em> ] [ <strong>-S</strong>[<em>scale</em>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W</strong><em>maxlon</em> ]
-[ <strong>-n</strong>[<strong>b</strong>|<strong>c</strong>|<strong>l</strong>|<strong>n</strong>][<strong>+a</strong>][<strong>+b</strong><em>BC</em>][<strong>+t</strong><em>threshold</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>img2grd</strong> reads an img format file, extracts a subset, and writes it
-to a grid file. The <strong>-M</strong> option dictates whether or not the Spherical
-Mercator projection of the img file is preserved or if a Geographic grid
-should be written by undoing the Mercator projection. If geographic grid
-is selected you can also request a resampling onto the exact <strong>-R</strong> given.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>imgfile</em></dt>
-<dd>A Mercator img format file such as the marine gravity or seafloor
-topography fields estimated from satellite altimeter data by
-Sandwell and Smith. If the user has set an environment variable
-<strong>$GMT_DATADIR</strong>, then <strong>img2grd</strong> will try to find <em>imgfile</em> in
-<strong>$GMT_DATADIR</strong>; else it will try to open <em>imgfile</em> directly.</dd>
-<dt><strong>-G</strong><em>grdfile</em></dt>
-<dd><em>grdfile</em> is the name of the output grid file.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]</dt>
-<dd><em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> specify the region of interest,
-and you may specify them in decimal degrees or in
-[+-]dd:mm[:ss.xxx][W|E|S|N] format. Append <strong>r</strong> if lower left
-and upper right map coordinates are given instead of w/e/s/n. The
-two shorthands <strong>-Rg</strong> and <strong>-Rd</strong> stand for global domain (0/360
-and -180/+180 in longitude respectively, with -90/+90 in latitude).
-Alternatively, specify the name of an existing grid file and the
-<strong>-R</strong> settings (and grid spacing, if applicable) are copied from
-the grid. Using <strong>-R</strong><em>unit</em> expects projected (Cartesian)
-coordinates compatible with chosen <strong>-J</strong> and we inversely project
-to determine actual rectangular geographic region.
-For perspective view (<strong>-p</strong>), optionally append /<em>zmin</em>/<em>zmax</em>.
-In case of perspective view (<strong>-p</strong>), a z-range (<em>zmin</em>, <em>zmax</em>)
-can be appended to indicate the third dimension. This needs to be
-done only when using the <strong>-Jz</strong> option, not when using only the
-<strong>-p</strong> option. In the latter case a perspective view of the plane is
-plotted, with no third dimension. </dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-C</strong></dt>
-<dd>Set the x and y Mercator coordinates relative to projection center
-[Default is relative to lower left corner of grid]. Requires <strong>-M</strong>.</dd>
-<dt><strong>-D</strong>[<em>minlat/maxlat</em>]</dt>
-<dd>Use the extended latitude range -80.738/+80.738. Alternatively,
-append <em>minlat/maxlat</em> as the latitude extent of the input img file.
-[Default is -72.006/72.006]. Not usually required since we can
-determine the extent from inspection of the file size.</dd>
-<dt><strong>-E</strong></dt>
-<dd>Can be used when <strong>-M</strong> is not set to force the final grid to have
-the exact same region as requested with <strong>-R</strong>. By default, the
-final region is a direct projection of the original Mercator region
-and will typically extend slightly beyond the requested latitude
-range, and furthermore the grid increment in latitude does not match
-the longitude increment. However, the extra resampling introduces
-small interpolation errors and should only be used if the output
-grid must match the requested region and have x_inc = y_inc. In
-this case the region set by <strong>-R</strong> must be given in multiples of the
-increment (.e.g, <strong>-R</strong>0/45/45/72).</dd>
-<dt><strong>-I</strong></dt>
-<dd>Indicate <em>minutes</em> as the width of an input img pixel in minutes of
-longitude. [Default is 2.0]. Not usually required since we can
-determine the pixel size from inspection of the size.</dd>
-<dt><strong>-M</strong></dt>
-<dd>Output a Spherical Mercator grid [Default is a geographic lon/lat
-grid]. The Spherical Mercator projection of the img file is
-preserved, so that the region <strong>-R</strong> set by the user is modified
-slightly; the modified region corresponds to the edges of pixels [or
-groups of <em>navg</em> pixels]. The grid file header is set so that the x
-and y axis lengths represent distance from the west and south edges
-of the image, measured in user default units, with <strong>-Jm</strong>1 and
-the adjusted <strong>-R</strong>. By setting the default <strong>PROJ_ ELLIPSOID</strong> =
-Sphere, the user can make overlays with the adjusted <strong>-R</strong> so that
-they match. See <strong>EXAMPLES</strong> below. The adjusted <strong>-R</strong> is also
-written in the grdheader remark, so it can be found later. See
-<strong>-C</strong> to set coordinates relative to projection center.</dd>
-<dt><strong>-N</strong><em>navg</em></dt>
-<dd>Average the values in the input img pixels into <em>navg</em> by <em>navg</em>
-squares, and create one output pixel for each such square. If used
-with <strong>-T</strong><em>3</em> it will report an average constraint between 0 and
-1. If used with <strong>-T</strong><em>2</em> the output will be average data value or
-NaN according to whether average constraint is > 0.5. <em>navg</em> must
-evenly divide into the dimensions of the imgfile in pixels. [Default
-<em>1</em> does no averaging].</dd>
-<dt><strong>-S</strong>[<em>scale</em>]</dt>
-<dd>Multiply the img file values by <em>scale</em> before storing in grid file.
-[Default is 1.0]. For recent img files: img topo files are stored in
-(corrected) meters [<strong>-S</strong>1]; free-air gravity files in mGal*10
-[<strong>-S</strong>0.1 to get mGal]; vertical deflection files in
-microradians*10 [<strong>-S</strong>0.1 to get microradians], vertical gravity
-gradient files in Eotvos*50 [<strong>-S</strong>0.02 to get Eotvos, or
-<strong>-S</strong>0.002 to get mGal/km]). If no <em>scale</em> is given we try to
-determine the scale by examining the file name for clues.</dd>
-<dt><strong>-T</strong><em>type</em></dt>
-<dd><em>type</em> handles the encoding of constraint information. <em>type</em> = 0
-indicates that no such information is encoded in the img file (used
-for pre-1995 versions of the gravity data) and gets all data. <em>type</em>
-> 0 indicates that constraint information is encoded (1995 and later
-(current) versions of the img files) so that one may produce a grid
-file as follows: <strong>-T</strong><em>1</em> gets data values at all points,
-<strong>-T</strong><em>2</em> gets data values at constrained points and NaN at
-interpolated points; <strong>-T</strong><em>3</em> gets 1 at constrained points and 0
-at interpolated points [Default is 1].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. Particularly recommended here, as it is
-helpful to see how the coordinates are adjusted.</dd>
-<dt><strong>-W</strong><em>maxlon</em></dt>
-<dd>Indicate <em>maxlon</em> as the maximum longitude extent of the input img
-file. Versions since 1995 have had <em>maxlon</em> = 360.0, while some
-earlier files had <em>maxlon</em> = 390.0. [Default is 360.0].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="geographic-examples">
-<h2>Geographic Examples<a class="headerlink" href="#geographic-examples" title="Permalink to this headline">¶</a></h2>
-<p>The <strong>-M</strong> option should be excluded if you need the output grid to be
-in geographic coordinates. To extract data in the region
-<strong>-R</strong>-40/40/-70/-30 from <em>world_grav.img.7.2</em> and reproject to yield
-geographic coordinates, you can try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>img2grd world_grav.img.16.1 -Gmerc_grav.nc -R-40/40/-70/-30 -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>Because the latitude spacing in the img file is equidistant in Mercator
-units, the resulting grid will not match the specified <strong>-R</strong> exactly,
-and the latitude spacing will not equal the longitude spacing. If you
-need an exact match with your <strong>-R</strong> and the same spacing in longitude
-and latitude, use the <strong>-E</strong> option:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>img2grd world_grav.img.16.1 -Gmerc_grav.nc -R-40/40/-70/-30 -E -V
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="mercator-examples">
-<h2>Mercator Examples<a class="headerlink" href="#mercator-examples" title="Permalink to this headline">¶</a></h2>
-<p>Since the img files are in a Mercator projection, you should NOT extract
-a geographic grid if your plan is to make a Mercator map. If you did
-that you end of projecting and reprojection the grid, loosing
-short-wavelength detail. Better to use <strong>-M</strong> and plot the grid using a
-linear projection with the same scale as the desired Mercator projection
-(see GMT Example 29).
-To extract data in the region <strong>-R</strong>-40/40/-70/-30 from
-<em>world_grav.img.7.2</em>, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt img2grd -M world_grav.img.7.2 -Gmerc_grav.nc -R-40/40/-70/-30 -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>Note that the <strong>-V</strong> option tells us that the range was adjusted to
-<strong>-R</strong>-40/40/-70.0004681551/-29.9945810754. We can also use <a class="reference internal" href="../../grdinfo.html"><em>grdinfo</em></a>
-to find that the grid file header shows its region to be
-<strong>-R</strong>0/80/0/67.9666667 This is the range of x,y we will get from a
-Spherical Mercator projection using
-<strong>-R</strong>-40/40/-70.0004681551/-29.9945810754 and <strong>-Jm</strong>1. Thus, to take
-ship.lonlatgrav and use it to sample the merc_grav.nc, we can do this:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt set PROJ_ELLIPSOID Sphere
-
-gmt mapproject -R-40/40/-70.0004681551/-29.9945810754 -Jm1i ship.lonlatgrav | \
- gmt grdtrack -Gmerc_grav.nc | gmt mapproject \
- -R-40/40/-70.0004681551/-29.9945810754 -Jm1i -I > ship.lonlatgravsat
-</pre></div>
-</div>
-</div></blockquote>
-<p>It is recommended to use the above method of projecting and unprojecting
-the data in such an application, because then there is only one
-interpolation step (in <a class="reference internal" href="../../grdtrack.html"><em>grdtrack</em></a>). If one first tries to convert the
-grid file to lon,lat and then sample it, there are two interpolation
-steps (in conversion and in sampling).</p>
-<p>To make a lon,lat grid from the above grid we can use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdproject merc_grav.nc -R-40/40/-70.0004681551/-29.9945810754 -Jm1i -I -D2m -Ggrav.nc
-</pre></div>
-</div>
-</div></blockquote>
-<p>In some cases this will not be easy as the <strong>-R</strong> in the two coordinate
-systems may not align well. When this happens, we can also use (in fact,
-it may be always better to use)</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grd2xyz merc_grav.nc | gmt mapproject \
- -R-40/40/-70.0004681551/-29.994581075 -Jm1i -I | \
- gmt surface -R-40/40/-70/70 -I2m -Ggrav.nc
-</pre></div>
-</div>
-</div></blockquote>
-<p>To make a Mercator map of the above region, suppose our gmt.conf value
-for <a class="reference internal" href="../../gmt.conf.html#proj-length-unit"><em>PROJ_LENGTH_UNIT</em></a> is inch. Then since the above merc_grav.nc
-file is projected with <strong>-Jm</strong>1i it is 80 inches wide. We can make a
-map 8 inches wide by using <strong>-Jx</strong>0.1i on any map programs applied to
-this grid (e.g., <a class="reference internal" href="../../grdcontour.html"><em>grdcontour</em></a>,
-<a class="reference internal" href="../../grdimage.html"><em>grdimage</em></a>, <a class="reference internal" href="../../grdview.html"><em>grdview</em></a>), and then
-for overlays which work in lon,lat (e.g., <a class="reference internal" href="../../psxy.html"><em>psxy</em></a>, <a class="reference internal" href="../../pscoast.html"><em>pscoast</em></a>) we can
-use the above adjusted <strong>-R</strong> and <strong>-Jm</strong>0.1 to get the two systems to
-match up.</p>
-<p>However, we can be smarter than this. Realizing that the input img file
-had pixels 2.0 minutes wide (or checking the nx and ny with grdinfo
-merc_grav.nc) we realize that merc_grav.nc used the full resolution of
-the img file and it has 2400 by 2039 pixels, and at 8 inches wide this
-is 300 pixels per inch. We decide we do not need that many and we will be
-satisfied with 100 pixels per inch, so we want to average the data into
-3 by 3 squares. (If we want a contour plot we will probably choose to
-average the data much more (e.g., 6 by 6) to get smooth contours.) Since
-2039 isn’t divisible by 3 we will get a different adjusted <strong>-R</strong> this time:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt img2grd -M world_grav.img.7.2 -Gmerc_grav_2.nc -R-40/40/-70/-30 -N3 -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>This time we find the adjusted region is
-<strong>-R</strong>-40/40/-70.023256525/-29.9368261101 and the output is 800 by 601
-pixels, a better size for us. Now we can create an artificial
-illumination file for this using <a class="reference internal" href="../../grdgradient.html"><em>grdgradient</em></a>:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdgradient merc_grav_2.nc -Gillum.nc -A0/270 -Ne0.6
-</pre></div>
-</div>
-</div></blockquote>
-<p>and if we also have a cpt file called “grav.cpt” we can create a color
-shaded relief map like this:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdimage merc_grav_2.nc -Iillum.nc -Cgrav.cpt -Jx0.1i -K > map.ps
-gmt psbasemap -R-40/40/-70.023256525/-29.9368261101 -Jm0.1i -Ba10 -O >> map.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>Suppose you want to obtain only the constrained data values from an img
-file, in lat/lon coordinates. Then run <strong>img2grd</strong> with the <strong>-T</strong>2
-option, use <a class="reference internal" href="../../grd2xyz.html"><em>grd2xyz</em></a> to dump the values, pipe through grep -v NaN to
-eliminate NaNs, and pipe through <a class="reference internal" href="../../mapproject.html"><em>mapproject</em></a> with the inverse projection as above.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="../../gmt.html"><em>gmt</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">img2grd</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#geographic-examples">Geographic Examples</a></li>
-<li><a class="reference internal" href="#mercator-examples">Mercator Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="../../SUP_IMGSRC.html"
- title="previous chapter">IMGSRC</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="img2google.html"
- title="next chapter">img2google</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/img/img2grd.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="img2google.html" title="img2google"
- >next</a> </li>
- <li class="right" >
- <a href="../../SUP_IMGSRC.html" title="IMGSRC"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_IMGSRC.html" >IMGSRC</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/meca/pscoupe.html b/doc_release/html/supplements/meca/pscoupe.html
deleted file mode 100644
index 42483e2..0000000
--- a/doc_release/html/supplements/meca/pscoupe.html
+++ /dev/null
@@ -1,562 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>pscoupe — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="MECA" href="../../SUP_MECA.html" />
- <link rel="next" title="psmeca" href="psmeca.html" />
- <link rel="prev" title="MECA" href="../../SUP_MECA.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="psmeca.html" title="psmeca"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="../../SUP_MECA.html" title="MECA"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_MECA.html" accesskey="U">MECA</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="pscoupe">
-<span id="index-0"></span><h1>pscoupe<a class="headerlink" href="#pscoupe" title="Permalink to this headline">¶</a></h1>
-<p>pscoupe - Plot cross-sections of focal mechanisms</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>pscoupe</strong> [ <em>files</em> ] <strong>-J</strong><em>parameters</em>
-<strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <strong>-A</strong><em>parameters</em>
-[ <strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> ] [ <strong>-E</strong><em>fill</em> ]
-[ <strong>-F</strong><em>mode</em>[<em>args</em>] ]
-[ <strong>-G</strong><em>fill</em> ] [ <strong>-K</strong> ] [ <strong>-L</strong><em>[pen]</em> ] [ <strong>-M</strong> ] [ <strong>-N</strong> ]
-[ <strong>-O</strong> ] [ <strong>-Q</strong> ]
-[ <strong>-S</strong><em><symbol><scale></em>[/<strong>d</strong>] ]
-[ <strong>-T</strong><em>n</em> ]
-[ <strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] ] [ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W</strong><em>pen</em> ]
-[ <strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Z</strong><em>cpt</em> ] [ <strong>-c</strong><em>copies</em> ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc2">Description</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p><strong>pscoupe</strong> reads data values from <em>files</em> [or standard input] and
-generates PostScript code that will plot symbols, lines or polygons on
-a cross-section. Focal mechanisms may be specified and require
-additional columns of data. The PostScript code is written to standard
-output.</p>
-<p>Unless <strong>-Q</strong> is used, new file is created with the new coordinates
-(<strong>x</strong>, <strong>y</strong>) and the mechanism (from lower focal half-sphere for
-horizontal plane, to half-sphere behind a vertical plane). When the
-plane is not horizontal,
-- north direction becomes upwards steepest descent direction of the plane (u)
-- east direction becomes strike direction of the plane (s)
-- down direction (= north^east) becomes u^s
-Axis angles are defined in the same way as in horizontal plane in the new system.
-Moment tensor (initially in r, t, f system that is up, south, east) is
-defined in (-u^s, -u, s) system.</p>
-</div>
-<div class="section" id="id2">
-<h2><a class="reference external" href="#toc4">Required Arguments</a><a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>[<em>ncols</em>][<em>type</em>]) data
-table file(s) holding a number of data columns. If no tables are given
-then we read from standard input. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-J</strong><em>parameters</em> <a class="reference internal" href="../../gmt.html#j-full"><em>(more ...)</em></a></dt>
-<dd>Select map projection.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]</dt>
-<dd><em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> specify the region of interest,
-and you may specify them in decimal degrees or in
-[+-]dd:mm[:ss.xxx][W|E|S|N] format. Append <strong>r</strong> if lower left
-and upper right map coordinates are given instead of w/e/s/n. The
-two shorthands <strong>-Rg</strong> and <strong>-Rd</strong> stand for global domain (0/360
-and -180/+180 in longitude respectively, with -90/+90 in latitude).
-Alternatively, specify the name of an existing grid file and the
-<strong>-R</strong> settings (and grid spacing, if applicable) are copied from
-the grid. Using <strong>-R</strong><em>unit</em> expects projected (Cartesian)
-coordinates compatible with chosen <strong>-J</strong> and we inversely project
-to determine actual rectangular geographic region.
-For perspective view (<strong>-p</strong>), optionally append /<em>zmin</em>/<em>zmax</em>.
-In case of perspective view (<strong>-p</strong>), a z-range (<em>zmin</em>, <em>zmax</em>)
-can be appended to indicate the third dimension. This needs to be
-done only when using the <strong>-Jz</strong> option, not when using only the
-<strong>-p</strong> option. In the latter case a perspective view of the plane is
-plotted, with no third dimension. If frame is defined from cross-section parameters
-(see <strong>-A</strong> this option is not taken into account, but must be present.</dd>
-<dt><strong>-A</strong></dt>
-<dd>selects the cross-section.</dd>
-<dt><strong>-Aa</strong><em>lon1/lat1/lon2/lat2/dip/p_width/dmin/dmax</em>[<strong>f</strong>]</dt>
-<dd><em>lon</em> and <em>lat</em> are the longitude and latitude of points 1 and 2
-limiting the length of the cross-section. <em>dip</em> is the dip of the plane
-on which the cross-section is made. <em>p_width</em> is the width of the
-cross-section on each side of a vertical plane or above and under an
-oblique plane. <em>dmin</em> and <em>dmax</em> are the distances min and max from
-horizontal plane, along steepest descent direction. Add <strong>f</strong> to get the
-frame from the cross-section parameters.</dd>
-<dt><strong>-Ab</strong><em>lon1/lat1/strike/p_length/dip/p_width/dmin/dmax</em>[<strong>f</strong>]</dt>
-<dd><em>lon1</em> and <em>lat1</em> are the longitude and latitude of the beginning of the
-cross-section. <em>strike</em> is the azimuth of the direction of the
-cross-section. <em>p_length</em> is the length along which the cross-section
-is made. The other parameters are the same as for <strong>-Aa</strong> option.</dd>
-<dt><strong>-Ac</strong><em>x1/y1/x2/y2/dip/p_width/dmin/dmax</em>[<strong>f</strong>]</dt>
-<dd>The same as <strong>-Aa</strong> option with <em>x</em> and <em>y</em> cartesian coordinates.</dd>
-<dt><strong>-Ad</strong><em>x1/y1/strike/p_length/dip/p_width/dmin/dmax</em>[<strong>f</strong>]</dt>
-<dd>The same as <strong>-Ab</strong> option with <em>x</em> and <em>y</em> cartesian coordinates.</dd>
-<dt><strong>-S</strong></dt>
-<dd>selects the meaning of the columns in the data file and the figure to be plotted.</dd>
-<dt><strong>-Sa</strong><em>scale[/fontsize[/offset</em>[<strong>u</strong>]]]</dt>
-<dd><p class="first">Focal mechanisms in Aki and Richards convention. <em>scale</em> adjusts the
-scaling of the radius of the “beach ball”, which will be proportional to
-the magnitude. The <em>scale</em> is the size for magnitude = 5 in
-<strong>PROJ_LENGTH_UNIT</strong> (unless <strong>c</strong>, <strong>i</strong>, <strong>m</strong>, or <strong>p</strong> is appended
-to indicate that the size information is in units of cm, inches, meters,
-or points, respectively). Use the <strong>-T</strong> option to render the beach ball
-transparent by drawing only the nodal planes and the circumference. The
-color or shade of the compressive quadrants can be specified with the
-<strong>-G</strong> option. The color or shade of the extensive quadrants can be
-specified with the <strong>-E</strong> option. Parameters are expected to be in the
-following columns:</p>
-<blockquote class="last">
-<div><dl class="docutils">
-<dt><strong>1</strong>,<strong>2</strong>:</dt>
-<dd>longitude, latitude of event (<strong>-:</strong> option interchanges order)</dd>
-<dt><strong>3</strong>:</dt>
-<dd>depth of event in kilometers</dd>
-<dt><strong>4</strong>,<strong>5</strong>,<strong>6</strong>:</dt>
-<dd>strike, dip and rake</dd>
-<dt><strong>7</strong>:</dt>
-<dd>magnitude</dd>
-<dt><strong>8</strong>,<strong>9</strong>:</dt>
-<dd>not used; can be 0 0; allows use of the psmeca file format</dd>
-<dt><strong>10</strong>:</dt>
-<dd>text string to appear above the beach ball (default) or under (add <strong>u</strong>).</dd>
-</dl>
-</div></blockquote>
-</dd>
-<dt><strong>-Sc</strong><em>scale</em></dt>
-<dd><p class="first">Focal mechanisms in Harvard CMT convention. <em>scale</em> adjusts the scaling
-of the radius of the “beach ball”, which will be proportional to the
-magnitude. The <em>scale</em> is the size for magnitude = 5 (that is M0 = 4E+23
-dynes-cm.) in <strong>PROJ_LENGTH_UNIT</strong> (unless <strong>c</strong>, <strong>i</strong>, <strong>m</strong>, or
-<strong>p</strong> is appended to indicate that the size information is in units of
-cm, inches, meters, or points, respectively). Use the <strong>-T</strong> option to
-render the beach ball transparent by drawing only the nodal planes and
-the circumference. The color or shade of the compressive quadrants can
-be specified with the <strong>-G</strong> option. The color or shade of the extensive
-quadrants can be specified with the <strong>-E</strong> option. Parameters are
-expected to be in the following columns:</p>
-<blockquote class="last">
-<div><dl class="docutils">
-<dt><strong>1</strong>,<strong>2</strong>:</dt>
-<dd>longitude, latitude of event (<strong>-:</strong> option interchanges order)</dd>
-<dt><strong>3</strong>:</dt>
-<dd>depth of event in kilometers</dd>
-<dt><strong>4</strong>,<strong>5</strong>,<strong>6</strong>:</dt>
-<dd>strike, dip, and slip of plane 1</dd>
-<dt><strong>7</strong>,<strong>8</strong>,<strong>9</strong>:</dt>
-<dd>strike, dip, and slip of plane 2</dd>
-<dt><strong>10</strong>,<strong>11</strong>:</dt>
-<dd>mantissa and exponent of moment in dyne-cm (if magnitude is uses
-instead of scalar moment, magnitude is in column 10 and 0 must be in column 11)</dd>
-<dt><strong>12</strong>,<strong>13</strong>:</dt>
-<dd>not used; can be 0 0; allows use of the psmeca file format</dd>
-<dt><strong>14</strong>:</dt>
-<dd>text string to appear above the beach ball (default) or under (add <strong>u</strong>).</dd>
-</dl>
-</div></blockquote>
-</dd>
-<dt><strong>-Sp</strong><em>scale[/fontsize[/offset</em>[<strong>u</strong>]]]</dt>
-<dd><p class="first">Focal mechanisms given with partial data on both planes. <em>scale</em> adjusts
-the scaling of the radius of the “beach ball”, which will be
-proportional to the magnitude. The <em>scale</em> is the size for magnitude = 5
-in <strong>PROJ_LENGTH_UNIT</strong> (unless <strong>c</strong>, <strong>i</strong>, <strong>m</strong>, or <strong>p</strong> is
-appended to indicate that the size information is in units of cm,
-inches, meters, or points, respectively). The color or shade of the
-compressive quadrants can be specified with the <strong>-G</strong> option. The color
-or shade of the extensive quadrants can be specified with the <strong>-E</strong>
-option. Parameters are expected to be in the following columns:</p>
-<blockquote class="last">
-<div><dl class="docutils">
-<dt><strong>1</strong>,<strong>2</strong>:</dt>
-<dd>longitude, latitude of event (<strong>-:</strong> option interchanges order)</dd>
-<dt><strong>3</strong>:</dt>
-<dd>depth</dd>
-<dt><strong>4</strong>,<strong>5</strong>:</dt>
-<dd>strike, dip of plane 1</dd>
-<dt><strong>6</strong>:</dt>
-<dd>strike of plane 2</dd>
-<dt><strong>7</strong>:</dt>
-<dd>must be -1/+1 for a normal/inverse fault</dd>
-<dt><strong>8</strong>:</dt>
-<dd>magnitude</dd>
-<dt><strong>9</strong>,<strong>10</strong>:</dt>
-<dd>not used; can be 0 0; allows use of the psmeca file format</dd>
-<dt><strong>11</strong>:</dt>
-<dd>text string to appear above the beach ball (default) or under (add <strong>u</strong>).</dd>
-</dl>
-</div></blockquote>
-</dd>
-<dt><strong>-Sm|d|z</strong><em>scale[/fontsize[/offset</em>[<strong>u</strong>]]]</dt>
-<dd>Seismic moment tensor (Harvard CMT, with zero trace). <em>scale</em> adjusts
-the scaling of the radius of the “beach ball”, which will be
-proportional to the magnitude. The <em>scale</em> is the size for magnitude = 5
-(that is seismic scalar moment = 4E+23 dynes-cm) in
-<strong>PROJ_LENGTH_UNIT</strong> (unless <strong>c</strong>, <strong>i</strong>, <strong>m</strong>, or <strong>p</strong> is appended
-to indicate that the size information is in units of cm, inches, meters,
-or points, respectively). (<strong>-T</strong><em>0</em> option overlays best double
-couple transparently.)</dd>
-<dt><strong>-Sd</strong><em>scale[/fontsize[/offset</em>[<strong>u</strong>]]]</dt>
-<dd>to plot the only double couple part of moment tensor.</dd>
-<dt><strong>-Sz</strong><em>scale[/fontsize[/offset</em>[<strong>u</strong>]]]</dt>
-<dd><p class="first">to plot anisotropic part
-of moment tensor (zero trace). The color or shade of the compressive
-quadrants can be specified with the <strong>-G</strong> option. The color or shade of
-the extensive quadrants can be specified with the <strong>-E</strong> option.
-Parameters are expected to be in the following columns:</p>
-<blockquote class="last">
-<div><dl class="docutils">
-<dt><strong>1</strong>,<strong>2</strong>:</dt>
-<dd>longitude, latitude of event (<strong>-:</strong> option interchanges order)</dd>
-<dt><strong>3</strong>:</dt>
-<dd>depth of event in kilometers</dd>
-<dt><strong>4</strong>,<strong>5</strong>,<strong>6</strong>,<strong>7</strong>,<strong>8</strong>,<strong>9</strong>:</dt>
-<dd>mrr, mtt, mff, mrt, mrf, mtf in 10*exponent dynes-cm</dd>
-<dt><strong>10</strong>:</dt>
-<dd>exponent</dd>
-<dt><strong>11</strong>,<strong>12</strong>:</dt>
-<dd>Not used; can be 0 0; allows use of the psmeca file format</dd>
-<dt><strong>13</strong>:</dt>
-<dd>Text string to appear above the beach ball (default) or under (add <strong>u</strong>).</dd>
-</dl>
-</div></blockquote>
-</dd>
-<dt><strong>-Sx</strong><em>scale[/fontsize[/offset</em>[<strong>u</strong>]]]</dt>
-<dd>Principal axis. <em>scale</em> adjusts the scaling of the radius of the “beach
-ball”, which will be proportional to the magnitude. The <em>scale</em> is the
-size for magnitude = 5 (that is seismic scalar moment = 4*10e+23
-dynes-cm) in <strong>PROJ_LENGTH_UNIT</strong> (unless <strong>c</strong>, <strong>i</strong>, <strong>m</strong>, or
-<strong>p</strong> is appended to indicate that the size information is in units of
-cm, inches, meters, or points, respectively). (<strong>-T0</strong> option overlays
-best double couple transparently.)</dd>
-<dt><strong>-Sy</strong><em>scale[/fontsize[/offset</em>[<strong>u</strong>]]]</dt>
-<dd>to plot the only double couple part of moment tensor.</dd>
-<dt><strong>-St</strong><em>scale[/fontsize[/offset</em>[<strong>u</strong>]]]</dt>
-<dd><p class="first">to plot anisotropic part
-of moment tensor (zero trace). The color or shade of the compressive
-quadrants can be specified with the <strong>-G</strong> option. The color or shade of
-the extensive quadrants can be specified with the <strong>-E</strong> option.
-Parameters are expected to be in the following columns:</p>
-<blockquote class="last">
-<div><dl class="docutils">
-<dt><strong>1</strong>,<strong>2</strong>:</dt>
-<dd>longitude, latitude of event (<strong>-:</strong> option interchanges order)</dd>
-<dt><strong>3</strong>:</dt>
-<dd>depth of event in kilometers</dd>
-<dt><strong>4</strong>,<strong>5</strong>,<strong>6</strong>,<strong>7</strong>,<strong>8</strong>,<strong>9</strong>,<strong>10</strong>,<strong>11</strong>,<strong>12</strong>:</dt>
-<dd>value (in 10*exponent dynes-cm), azimuth, plunge of the T, N, and P axes.</dd>
-<dt><strong>13</strong>:</dt>
-<dd>exponent</dd>
-<dt><strong>14</strong>,<strong>15</strong>:</dt>
-<dd>longitude, latitude at which to place beach ball. Entries in these
-columns are necessary with the <strong>-C</strong> option. Using 0,0 in columns 9
-and 10 will plot the beach ball at the longitude, latitude given in
-columns 1 and 2. The <strong>-:</strong> option will interchange the order of
-columns (1,2) and (9,10).</dd>
-<dt><strong>16</strong>:</dt>
-<dd>Text string to appear above the beach ball (optional).</dd>
-</dl>
-</div></blockquote>
-</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> <a class="reference internal" href="../../gmt.html#b-full"><em>(more ...)</em></a></dt>
-<dd>Set map boundary intervals.</dd>
-<dt><strong>-E</strong><em>fill</em></dt>
-<dd>Sets color or fill pattern for extensive quadrants [Default is white].</dd>
-<dt><strong>-F</strong><em>mode</em>[<em>args</em>]</dt>
-<dd>Sets one or more attributes; repeatable. The various combinations are</dd>
-<dt><strong>-Fs</strong><em>symbol[size[/fontsize[/offset</em>[<strong>u</strong>]]]</dt>
-<dd><p class="first">selects a symbol instead of mechanism. Choose from the following:
-(<strong>c</strong>) circle, (<strong>d</strong>) diamond, (<strong>i</strong>) itriangle, (<strong>s</strong>) square,
-(<strong>t</strong>) triangle, (<strong>x</strong>) cross. <em>size</em> is the symbol size in
-<strong>PROJ_LENGTH_UNIT</strong> (unless <strong>c</strong>, <strong>i</strong>, <strong>m</strong>, or <strong>p</strong> is appended
-to indicate that the size information is in units of cm, inches, meters,
-or points, respectively). If <em>size</em> must be read, it must be in column 4
-and the text string will start in column 5. Parameters are expected to
-be in the following columns:</p>
-<blockquote class="last">
-<div><dl class="docutils">
-<dt><strong>1</strong>,<strong>2</strong>:</dt>
-<dd>longitude, latitude of event (<strong>-:</strong> option interchanges order)</dd>
-<dt><strong>3</strong>:</dt>
-<dd>depth of event in kilometers</dd>
-<dt><strong>4</strong>:</dt>
-<dd>Text string to appear above the beach ball (default) or under (add <strong>u</strong>).</dd>
-</dl>
-</div></blockquote>
-</dd>
-<dt><strong>-Fa</strong>[<em>size</em>][/<em>P_symbol</em>[/<em>T_symbol</em>]]</dt>
-<dd>Computes and plots P and T axes with symbols. Optionally specify
-<em>size</em> and (separate) P and T axis symbols from the following:
-(<strong>c</strong>) circle, (<strong>d</strong>) diamond, (<strong>h</strong>) hexagon, (<strong>i</strong>) inverse
-triangle, (<strong>p</strong>) point, (<strong>s</strong>) square, (<strong>t</strong>) triangle, (<strong>x</strong>)
-cross. [Default: 6<strong>p</strong>/<strong>cc</strong>]</dd>
-<dt><strong>-Fe</strong><em>fill</em></dt>
-<dd>Sets the color or fill pattern for the T axis symbol. [Default as set by <strong>-E</strong>]</dd>
-<dt><strong>-Fg</strong><em>fill</em></dt>
-<dd>Sets the color or fill pattern for the P axis symbol. [Default as set by <strong>-G</strong>]</dd>
-<dt><strong>-Fp</strong>[<em>pen</em>]</dt>
-<dd>Draws the P axis outline using current pen (see <strong>-W</strong>), or sets pen attributes.</dd>
-<dt><strong>-Fr</strong>[<em>fill</em>]</dt>
-<dd>Draw a box behind the label (if any). [Default fill is white]</dd>
-<dt><strong>-Ft</strong>[<em>pen</em>]</dt>
-<dd>Draws the T axis outline using current pen (see <strong>-W</strong>), or sets pen attributes.</dd>
-<dt><strong>-G</strong><em>fill</em></dt>
-<dd>Sets color or fill pattern for compressional quadrants [Default is black].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-K</strong> <a class="reference internal" href="../../gmt.html#k-full"><em>(more ...)</em></a></dt>
-<dd>Do not finalize the PostScript plot.</dd>
-<dt><strong>-L</strong>[<em>pen</em>]</dt>
-<dd>Draws the “beach ball” outline using current pen (see <strong>-W</strong>) or
-sets pen attributes.</dd>
-<dt><strong>-M</strong></dt>
-<dd>Same size for any magnitude.</dd>
-<dt><strong>-N</strong></dt>
-<dd>Does <strong>not</strong> skip symbols that fall outside map border [Default
-plots points inside border only].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-O</strong> <a class="reference internal" href="../../gmt.html#o-full"><em>(more ...)</em></a></dt>
-<dd>Append to existing PostScript plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-P</strong> <a class="reference internal" href="../../gmt.html#p-full"><em>(more ...)</em></a></dt>
-<dd>Select “Portrait” plot orientation.</dd>
-<dt><strong>-Q</strong></dt>
-<dd>Suppress the production of files with cross-section and mechanism information.</dd>
-<dt><strong>-T</strong>[<em>num_of_planes</em>]</dt>
-<dd>Plots the nodal planes and outlines the bubble which is transparent.
-If <em>num_of_planes</em> is
-<em>0</em>: both nodal planes are plotted;
-<em>1</em>: only the first nodal plane is plotted;
-<em>2</em>: only the second nodal plane is plotted
-[Default: 0].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] <a class="reference internal" href="../../gmt.html#u-full"><em>(more ...)</em></a></dt>
-<dd>Draw GMT time stamp logo on plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong></dt>
-<dd>set pen attributes for text string or default pen attributes for
-fault plane edges. [Defaults: width = default, color = black, style = solid].</dd>
-</dl>
-<p><strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]]</p>
-<dl class="docutils">
-<dt><strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] <a class="reference internal" href="../../gmt.html#xy-full"><em>(more ...)</em></a></dt>
-<dd>Shift plot origin.</dd>
-<dt><strong>-Z</strong>cptfile</dt>
-<dd>Give a color palette file and let compressive part color be
-determined by the z-value in the third column.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-c</strong><em>copies</em> <a class="reference internal" href="../../gmt.html#c-full"><em>(more ...)</em></a></dt>
-<dd>Specify number of plot copies [Default is 1].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="../../gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="../../gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="../../gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="../../gmt.html"><em>gmt</em></a>, <a class="reference internal" href="../../psbasemap.html"><em>psbasemap</em></a>,
-<a class="reference internal" href="psmeca.html"><em>psmeca</em></a>, <a class="reference internal" href="../../psxy.html"><em>psxy</em></a></p>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>Bomford, G., Geodesy, 4th ed., Oxford University Press, 1980.</p>
-<p>Aki, K. and P. Richards, Quantitative Seismology, Freeman, 1980.</p>
-<p>F. A. Dahlen and Jeroen Tromp, Theoretical Seismology, Princeton, 1998,
-p.167. Definition of scalar moment.</p>
-<p>Cliff Frohlich, Cliff’s Nodes Concerning Plotting Nodal Lines for P, Sh and Sv</p>
-<p>Seismological Research Letters, Volume 67, Number 1, January-February, 1996</p>
-<p>Thorne Lay, Terry C. Wallace, Modern Global Seismology, Academic Press, 1995, p.384.</p>
-<p>W.H. Press, S.A. Teukolsky, W.T. Vetterling, B.P. Flannery, Numerical
-Recipes in C, Cambridge University press (routine jacobi)</p>
-</div>
-<div class="section" id="author">
-<h2>Author<a class="headerlink" href="#author" title="Permalink to this headline">¶</a></h2>
-<p>Genevieve Patau, <cite>Laboratory of Seismogenesis <http://www.ipgp.fr/rech/sismogenese/></cite>,
-Institut de Physique du Globe de Paris, Departement de Sismologie, Paris, France</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">pscoupe</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#id1">Description</a></li>
-<li><a class="reference internal" href="#id2">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-<li><a class="reference internal" href="#author">Author</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="../../SUP_MECA.html"
- title="previous chapter">MECA</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="psmeca.html"
- title="next chapter">psmeca</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/meca/pscoupe.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="psmeca.html" title="psmeca"
- >next</a> </li>
- <li class="right" >
- <a href="../../SUP_MECA.html" title="MECA"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_MECA.html" >MECA</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/meca/psmeca.html b/doc_release/html/supplements/meca/psmeca.html
deleted file mode 100644
index cf9eb84..0000000
--- a/doc_release/html/supplements/meca/psmeca.html
+++ /dev/null
@@ -1,542 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>psmeca — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="MECA" href="../../SUP_MECA.html" />
- <link rel="next" title="pspolar" href="pspolar.html" />
- <link rel="prev" title="pscoupe" href="pscoupe.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="pspolar.html" title="pspolar"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="pscoupe.html" title="pscoupe"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_MECA.html" accesskey="U">MECA</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="psmeca">
-<span id="index-0"></span><h1>psmeca<a class="headerlink" href="#psmeca" title="Permalink to this headline">¶</a></h1>
-<p>psmeca - Plot focal mechanisms on maps</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p>psmeca [ <em>table</em> ] <strong>-J</strong><em>parameters</em>
-<strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>]
-[ <strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> ]
-[ <strong>-C</strong>[<em>pen</em>][<strong>P</strong><em>pointsize</em>] ] [ <strong>-D</strong><em>depmin</em>/<em>depmax</em> ]
-[ <strong>-E</strong><em>fill</em>] [ <strong>-F</strong><em>mode</em>[<em>args</em>] ] [ <strong>-G</strong><em>fill</em>] [ <strong>-K</strong> ] [ <strong>-L</strong>[<em>pen</em>] ]
-[ <strong>-M</strong> ] [ <strong>-N</strong> ] [ <strong>-O</strong> ] [ <strong>-P</strong> ]
-[ <strong>-S</strong><em><format><scale></em>[/<strong>d</strong>]]
-[ <strong>-T</strong><em>num_of_plane</em>[<em>pen</em>] ]
-[ <strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W</strong><em>pen</em> ]
-[ <strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Z</strong><em>cptfile</em>]
-[ <strong>-c</strong><em>copies</em> ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>psmeca</strong> reads data values from <em>files</em> [or standard input] and
-generates PostScript code that will plot focal mechanisms on a map.
-Most options are the same as for <strong>psxy</strong>. The PostScript code is
-written to standard output.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>[<em>ncols</em>][<em>type</em>]) data
-table file(s) holding a number of data columns. If no tables are given
-then we read from standard input. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-J</strong><em>parameters</em> <a class="reference internal" href="../../gmt.html#j-full"><em>(more ...)</em></a></dt>
-<dd>Select map projection.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]</dt>
-<dd><em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> specify the region of interest,
-and you may specify them in decimal degrees or in
-[+-]dd:mm[:ss.xxx][W|E|S|N] format. Append <strong>r</strong> if lower left
-and upper right map coordinates are given instead of w/e/s/n. The
-two shorthands <strong>-Rg</strong> and <strong>-Rd</strong> stand for global domain (0/360
-and -180/+180 in longitude respectively, with -90/+90 in latitude).
-Alternatively, specify the name of an existing grid file and the
-<strong>-R</strong> settings (and grid spacing, if applicable) are copied from
-the grid. Using <strong>-R</strong><em>unit</em> expects projected (Cartesian)
-coordinates compatible with chosen <strong>-J</strong> and we inversely project
-to determine actual rectangular geographic region.
-For perspective view (<strong>-p</strong>), optionally append /<em>zmin</em>/<em>zmax</em>.
-In case of perspective view (<strong>-p</strong>), a z-range (<em>zmin</em>, <em>zmax</em>)
-can be appended to indicate the third dimension. This needs to be
-done only when using the <strong>-Jz</strong> option, not when using only the
-<strong>-p</strong> option. In the latter case a perspective view of the plane is
-plotted, with no third dimension. </dd>
-</dl>
-<p><strong>-S</strong><em><format><scale></em>[/<strong>d</strong>]</p>
-<p>Selects the meaning of the columns in the data file . In order to use
-the same file to plot cross-sections, depth is in third column.
-Nevertheless, it is possible to use “old style” <strong>psvelomeca</strong> input
-files without depth in third column using the <strong>-o</strong> option.</p>
-<p><strong>-Sa</strong><em>scale[/fontsize[/offset</em>[<strong>u</strong>]]]</p>
-<p>Focal mechanisms in Aki and Richards convention. <em>scale</em> adjusts the
-scaling of the radius of the “beach ball”, which will be proportional to
-the magnitude. Scale is the size for magnitude = 5 in inch (unless
-<strong>c</strong>, <strong>i</strong>, <strong>m</strong>, or <strong>p</strong> is appended). Use the <strong>-T</strong> option to
-render the beach ball transparent by drawing only the nodal planes and
-the circumference. The color or shade of the compressive quadrants can
-be specified with the <strong>-G</strong> option. The color or shade of the extensive
-quadrants can be specified with the <strong>-E</strong> option. Append <strong>u</strong> to have
-the text appear below the beach ball (default is above). Parameters are
-expected to be in the following columns:</p>
-<blockquote>
-<div><strong>1</strong>,<strong>2</strong>:
-longitude, latitude of event (<strong>-:</strong> option interchanges order)
-<strong>3</strong>:
-depth of event in kilometers
-<strong>4</strong>,<strong>5</strong>,<strong>6</strong>:
-strike, dip and rake in degrees
-<strong>7</strong>:
-magnitude
-<strong>8</strong>,<strong>9</strong>:
-longitude, latitude at which to place beach ball. Entries in these
-columns are necessary with the <strong>-C</strong> option. Using 0,0 in columns 8
-and 9 will plot the beach ball at the longitude, latitude given in
-columns 1 and 2. The <strong>-:</strong> option will interchange the order of
-columns (1,2) and (8,9).
-<strong>10</strong>:
-Text string to appear above or below the beach ball (optional).</div></blockquote>
-<p><strong>-Sc</strong><em>scale[/fontsize[/offset</em>[<strong>u</strong>]]]</p>
-<p>Focal mechanisms in Harvard CMT convention. <em>scale</em> adjusts the scaling
-of the radius of the “beach ball”, which will be proportional to the
-magnitude. Scale is the size for magnitude = 5 (that is M0 = 4.0E23
-dynes-cm) in inch (unless <strong>c</strong>, <strong>i</strong>, <strong>m</strong>, or <strong>p</strong> is appended).
-Use the <strong>-T</strong> option to render the beach ball transparent by drawing
-only the nodal planes and the circumference. The color or shade of the
-compressive quadrants can be specified with the <strong>-G</strong> option. The color
-or shade of the extensive quadrants can be specified with the <strong>-E</strong>
-option. Append <strong>u</strong> to have the text appear below the beach ball
-(default is above). Parameters are expected to be in the following
-columns:</p>
-<blockquote>
-<div><strong>1</strong>,<strong>2</strong>:
-longitude, latitude of event (<strong>-:</strong> option interchanges order)
-<strong>3</strong>:
-depth of event in kilometers
-<strong>4</strong>,<strong>5</strong>,<strong>6</strong>:
-strike, dip, and rake of plane 1
-<strong>7</strong>,<strong>8</strong>,<strong>9</strong>:
-strike, dip, and rake of plane 2
-<strong>10</strong>,<strong>11</strong>:
-mantissa and exponent of moment in dyne-cm
-<strong>12</strong>,<strong>13</strong>:
-longitude, latitude at which to place beach ball. Entries in these
-columns are necessary with the <strong>-C</strong> option. Using (0,0) in columns
-12 and 13 will plot the beach ball at the longitude, latitude given
-in columns 1 and 2. The <strong>-:</strong> option will interchange the order of
-columns (1,2) and (12,13).
-<strong>14</strong>:
-Text string to appear above or below the beach ball (optional).</div></blockquote>
-<p><strong>-Sm|d|z</strong><em>scale[/fontsize[/offset</em>[<strong>u</strong>]]]</p>
-<p>Seismic moment tensor (Harvard CMT, with zero trace). <em>scale</em> adjusts
-the scaling of the radius of the “beach ball”, which will be
-proportional to the magnitude. Scale is the size for magnitude = 5 (that
-is scalar seismic moment = 4.0E23 dynes-cm) in inch (unless <strong>c</strong>,
-<strong>i</strong>, <strong>m</strong>, or <strong>p</strong> is appended). (<strong>-T</strong><em>0</em> option overlays best
-double couple transparently.) Use <strong>-Sm</strong> to plot the Harvard CMT
-seismic moment tensor with zero trace. Use <strong>-Sd</strong> to plot only the
-double couple part of moment tensor. Use <strong>-Sz</strong> to plot the anisotropic
-part of moment tensor (zero trace). The color or shade of the
-compressive quadrants can be specified with the <strong>-G</strong> option. The color
-or shade of the extensive quadrants can be specified with the <strong>-E</strong>
-option. Append <strong>u</strong> to have the text appear below the beach ball
-(default is above). Parameters are expected to be in the following
-columns:</p>
-<blockquote>
-<div><strong>1</strong>,<strong>2</strong>:
-longitude, latitude of event (<strong>-:</strong> option interchanges order)
-<strong>3</strong>:
-depth of event in kilometers
-<strong>4</strong>,<strong>5</strong>,<strong>6</strong>,<strong>7</strong>,<strong>8</strong>,<strong>9</strong>:
-mrr, mtt, mff, mrt, mrf, mtf in 10*exponent dynes-cm
-<strong>10</strong>:
-exponent
-<strong>11</strong>,<strong>12</strong>:
-longitude, latitude at which to place beach ball. Entries in these
-columns are necessary with the <strong>-C</strong> option. Using (0,0) in columns
-11 and 12 will plot the beach ball at the longitude, latitude given
-in columns 1 and 2. The <strong>-:</strong> option will interchange the order of
-columns (1,2) and (11,12).
-<strong>13</strong>:
-Text string to appear above or below the beach ball (optional).</div></blockquote>
-<p><strong>-Sp</strong><em>scale[/fontsize[/offset</em>[<strong>u</strong>]]]</p>
-<p>Focal mechanisms given with partial data on both planes. <em>scale</em> adjusts
-the scaling of the radius of the “beach ball”, which will be
-proportional to the magnitude. Scale is the size for magnitude = 5 in
-inch (unless <strong>c</strong>, <strong>i</strong>, <strong>m</strong>, or <strong>p</strong> is appended). The color or
-shade of the compressive quadrants can be specified with the <strong>-G</strong>
-option. The color or shade of the extensive quadrants can be specified
-with the <strong>-E</strong> option. Append <strong>u</strong> to have the text appear below the
-beach ball (default is above). Parameters are expected to be in the
-following columns:</p>
-<blockquote>
-<div><strong>1</strong>,<strong>2</strong>:
-longitude, latitude of event (<strong>-:</strong> option interchanges order)
-<strong>3</strong>:
-depth of event in kilometers
-<strong>4</strong>,<strong>5</strong>:
-strike, dip of plane 1
-<strong>6</strong>:
-strike of plane 2
-<strong>7</strong>:
-must be -1/+1 for a normal/inverse fault
-<strong>8</strong>:
-magnitude
-<strong>9</strong>,<strong>10</strong>:
-longitude, latitude at which to place beach ball. Entries in these
-columns are necessary with the <strong>-C</strong> option. Using (0,0) in columns
-9 and 10 will plot the beach ball at the longitude, latitude given
-in columns 1 and 2. The <strong>-:</strong> option will interchange the order of
-columns (1,2) and (9,10).
-<strong>11</strong>:
-Text string to appear above or below the beach ball (optional).</div></blockquote>
-<p><strong>-Sx|y|t</strong><em>scale[/fontsize[/offset</em>[<strong>u</strong>]]]</p>
-<p>Principal axis. <em>scale</em> adjusts the scaling of the radius of the “beach
-ball”, which will be proportional to the magnitude. Scale is the size
-for magnitude = 5 (that is seismic scalar moment = 4*10e+23 dynes-cm)
-in inch (unless <strong>c</strong>, <strong>i</strong>, <strong>m</strong>, or <strong>p</strong> is appended). (<strong>-T</strong><em>0</em>
-option overlays best double couple transparently.) Use <strong>-Sx</strong> to plot
-standard Harvard CMT. Use <strong>-Sy</strong> to plot only the double couple part of
-moment tensor. Use <strong>-St</strong> to plot zero trace moment tensor. The color
-or shade of the compressive quadrants can be specified with the <strong>-G</strong>
-option. The color or shade of the extensive quadrants can be specified
-with the <strong>-E</strong> option. Append <strong>u</strong> to have the text appear below the
-beach ball (default is above). Parameters are expected to be in the
-following columns:</p>
-<blockquote>
-<div><strong>1</strong>,<strong>2</strong>:
-longitude, latitude of event (<strong>-:</strong> option interchanges order)
-<strong>3</strong>:
-depth of event in kilometers
-<strong>4</strong>,<strong>5</strong>,<strong>6</strong>,<strong>7</strong>,<strong>8</strong>,<strong>9</strong>,<strong>10</strong>,<strong>11</strong>,<strong>12</strong>:
-value (in 10*exponent dynes-cm), azimuth, plunge of T, N, P axis.
-<strong>13</strong>:
-exponent
-<strong>14</strong>,<strong>15</strong>:
-longitude, latitude at which to place beach ball. Entries in these
-columns are necessary with the <strong>-C</strong> option. Using (0,0) in columns
-14 and 15 will plot the beach ball at the longitude, latitude given
-in columns 1 and 2. The <strong>-:</strong> option will interchange the order of
-columns (1,2) and (14,15).
-<strong>16</strong>:
-Text string to appear above or below the beach ball (optional).</div></blockquote>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc5">Optional Arguments</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> <a class="reference internal" href="../../gmt.html#b-full"><em>(more ...)</em></a></dt>
-<dd>Set map boundary intervals.</dd>
-<dt><strong>-C</strong>[<em>pen</em>][<strong>P</strong><em>pointsize</em>]</dt>
-<dd>Offsets focal mechanisms to the longitude, latitude specified in the
-last two columns of the input file before the (optional) text
-string. A small circle is plotted at the initial location and a line
-connects the beachball to the circle. Specify <em>pen</em> and/or
-<em>pointsize</em> to change the line style and/or size of the circle.
-[Defaults: <em>pen</em> as given by <strong>-W</strong>; <em>pointsize</em> 0].</dd>
-<dt><strong>-D</strong><em>depmin/depmax</em></dt>
-<dd>Plots events between depmin and depmax.</dd>
-<dt><strong>-E</strong><em>fill</em></dt>
-<dd>Selects filling of extensive quadrants. Usually white. Set the color
-[Default is white].</dd>
-<dt><strong>-F</strong><em>mode</em>[<em>args</em>]</dt>
-<dd>Sets one or more attributes; repeatable. The various combinations are</dd>
-<dt><strong>-Fa</strong>[<em>size</em>][/<em>P_axis_symbol</em>[<em>T_axis_symbol</em>]]</dt>
-<dd>Computes and plots P and T axes with symbols. Optionally specify
-<em>size</em> and (separate) P and T axis symbols from the following:
-(<strong>c</strong>) circle, (<strong>d</strong>) diamond, (<strong>h</strong>) hexagon, (<strong>i</strong>) inverse
-triangle, (<strong>p</strong>) point, (<strong>s</strong>) square, (<strong>t</strong>) triangle, (<strong>x</strong>)
-cross. [Default: 6<strong>p</strong>/<strong>cc</strong>]</dd>
-<dt><strong>-Fe</strong><em>fill</em></dt>
-<dd>Sets the color or fill pattern for the T axis symbol. [Default as
-set by <strong>-E</strong>]</dd>
-<dt><strong>-Fg</strong><em>fill</em></dt>
-<dd>Sets the color or fill pattern for the P axis symbol. [Default as
-set by <strong>-G</strong>]</dd>
-<dt><strong>-Fo</strong></dt>
-<dd>Use the <strong>psvelomeca</strong> input format without depth in the third column.</dd>
-<dt><strong>-Fp</strong>[<em>pen</em>]</dt>
-<dd>Draws the P axis outline using default pen (see <strong>-W</strong>), or sets pen attributes.</dd>
-<dt><strong>-Fr</strong>[<em>fill</em>]</dt>
-<dd>Draw a box behind the label (if any). [Default fill is white]</dd>
-<dt><strong>-Ft</strong>[<em>pen</em>]</dt>
-<dd>Draws the T axis outline using default pen (see <strong>-W</strong>), or sets pen
-attributes.</dd>
-<dt><strong>-Fz</strong>[<em>pen</em>]</dt>
-<dd>Overlay zero trace moment tensor using default pen (see <strong>-W</strong>), or
-sets pen attributes.</dd>
-<dt><strong>-G</strong><em>fill</em></dt>
-<dd>Selects filling of focal mechanisms. By convention, the
-compressional quadrants of the focal mechanism beach balls are
-shaded. Set the color [Default is black].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-K</strong> <a class="reference internal" href="../../gmt.html#k-full"><em>(more ...)</em></a></dt>
-<dd>Do not finalize the PostScript plot.</dd>
-<dt><strong>-L</strong><em>pen</em></dt>
-<dd>Draws the “beach ball” outline with <em>pen</em> attributes instead of with
-the default pen set by <strong>-W</strong>.</dd>
-<dt><strong>-M</strong></dt>
-<dd>Use the same size for any magnitude. Size is given with <strong>-S</strong>.</dd>
-<dt><strong>-N</strong></dt>
-<dd>Does <strong>not</strong> skip symbols that fall outside frame boundary specified
-by <strong>-R</strong> [Default plots symbols inside frame only].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-O</strong> <a class="reference internal" href="../../gmt.html#o-full"><em>(more ...)</em></a></dt>
-<dd>Append to existing PostScript plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-P</strong> <a class="reference internal" href="../../gmt.html#p-full"><em>(more ...)</em></a></dt>
-<dd>Select “Portrait” plot orientation.</dd>
-<dt><strong>-T</strong>[<em>num_of_planes</em>][<strong>/</strong><em>pen</em>]</dt>
-<dd><p class="first">Plots the nodal planes and outlines the bubble which is transparent.
-If <em>num_of_planes</em> is</p>
-<p><em>0</em>: both nodal planes are plotted;</p>
-<p><em>1</em>: only the first nodal plane is plotted;</p>
-<p><em>2</em>: only the second nodal plane is plotted.</p>
-<p class="last">Append <strong>/</strong><em>pen</em> to set the pen attributes for this feature.
-Default pen is as set by <strong>-W</strong>.</p>
-</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] <a class="reference internal" href="../../gmt.html#u-full"><em>(more ...)</em></a></dt>
-<dd>Draw GMT time stamp logo on plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong><em>pen</em></dt>
-<dd>Set pen attributes for all lines and the outline of symbols
-[Defaults: width = default, color = black, style = solid]. This
-setting applies to <strong>-C</strong>, <strong>-L</strong>, <strong>-T</strong>, <strong>-p</strong>, <strong>-t</strong>, and
-<strong>-z</strong>, unless overruled by options to those arguments.</dd>
-</dl>
-<p><strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]]</p>
-<dl class="docutils">
-<dt><strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] <a class="reference internal" href="../../gmt.html#xy-full"><em>(more ...)</em></a></dt>
-<dd>Shift plot origin.</dd>
-<dt><strong>-Z</strong><em>cptfile</em></dt>
-<dd>Give a color palette file and let compressive part color be
-determined by the z-value in the third column.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-c</strong><em>copies</em> <a class="reference internal" href="../../gmt.html#c-full"><em>(more ...)</em></a></dt>
-<dd>Specify number of plot copies [Default is 1].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="../../gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="../../gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="../../gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>The following file should give a normal-faulting CMT mechanism:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psmeca -R239/240/34/35.2 -Jm4c -Sc0.4 -h1 << END > test.ps
-lon lat depth str dip slip st dip slip mant exp plon plat
-239.384 34.556 12. 180 18 -88 0 72 -90 5.5 0 0 0
-END
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="../../gmt.html"><em>gmt</em></a>, <a class="reference internal" href="../../psbasemap.html"><em>psbasemap</em></a>, <a class="reference internal" href="../../psxy.html"><em>psxy</em></a></p>
-</div>
-<div class="section" id="id2">
-<h2><a class="reference external" href="#toc8">References</a><a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h2>
-<p>Bomford, G., Geodesy, 4th ed., Oxford University Press, 1980.</p>
-<p>Aki, K. and P. Richards, Quantitative Seismology, Freeman, 1980.</p>
-<p>F. A. Dahlen and Jeroen Tromp, Theoretical Seismology, Princeton, 1998,
-p.167.</p>
-<p>Cliff Frohlich, Cliff’s Nodes Concerning Plotting Nodal Lines for P, Sh
-and Sv</p>
-<p>Seismological Research Letters, Volume 67, Number 1, January-February,
-1996</p>
-<p>Thorne Lay, Terry C. Wallace, Modern Global Seismology, Academic Press,
-1995, p.384.</p>
-<p>W.H. Press, S.A. Teukolsky, W.T. Vetterling, B.P. Flannery, Numerical
-Recipes in C, Cambridge University press (routine jacobi)</p>
-</div>
-<div class="section" id="id3">
-<h2><a class="reference external" href="#toc9">Authors</a><a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h2>
-<p>Genevieve Patau, <cite>Laboratory of Seismogenesis <http://www.ipgp.fr/rech/sismogenese/></cite>,
-Institut de Physique du Globe de Paris, Departement de Sismologie, Paris, France</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">psmeca</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#id1">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-<li><a class="reference internal" href="#id2">References</a></li>
-<li><a class="reference internal" href="#id3">Authors</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="pscoupe.html"
- title="previous chapter">pscoupe</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="pspolar.html"
- title="next chapter">pspolar</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/meca/psmeca.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="pspolar.html" title="pspolar"
- >next</a> </li>
- <li class="right" >
- <a href="pscoupe.html" title="pscoupe"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_MECA.html" >MECA</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/meca/pspolar.html b/doc_release/html/supplements/meca/pspolar.html
deleted file mode 100644
index 40ceb1b..0000000
--- a/doc_release/html/supplements/meca/pspolar.html
+++ /dev/null
@@ -1,382 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>pspolar — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="MECA" href="../../SUP_MECA.html" />
- <link rel="next" title="psvelo" href="psvelo.html" />
- <link rel="prev" title="psmeca" href="psmeca.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="psvelo.html" title="psvelo"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="psmeca.html" title="psmeca"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_MECA.html" accesskey="U">MECA</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="pspolar">
-<span id="index-0"></span><h1>pspolar<a class="headerlink" href="#pspolar" title="Permalink to this headline">¶</a></h1>
-<p>pspolar - Plot polarities on the inferior focal half-sphere on maps</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p>pspolar [ <em>table</em> ] <strong>-J</strong><em>parameters</em>
-<strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>]
-<strong>-M</strong><em>size</em> <strong>-S</strong><em><symbol><size></em>
-[ <strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> ]
-[ <strong>-C</strong><em>lon</em>/<em>lat</em>[/<em>dash_width</em>/<em>pointsize</em>] ] [ <strong>-F</strong><em>color</em> ]
-[ <strong>-G</strong><em>fill</em> ] [ <strong>-K</strong> ] [ <strong>-L</strong> ] [ <strong>-N</strong> ]
-[ <strong>-O</strong> ] [ <strong>-Q</strong><em>mode</em>[<em>args</em>] ]
-[ <strong>-T</strong><em>angle</em>/<em>form</em>/<em>justify</em>/<em>fontsize</em> ]
-[ <strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W</strong><em>pen</em> ]
-[ <strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] ]
-[ <strong>-c</strong><em>copies</em> ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>pspolar</strong> reads data values from <em>files</em> [or standard input] and
-generates PostScript code that will plot stations on focal mechanisms
-on a map. The PostScript code is written to standard output.</p>
-<p>Parameters are expected to be in the following columns:</p>
-<blockquote>
-<div><dl class="docutils">
-<dt><strong>1</strong>,<strong>2</strong>,<strong>3</strong>:</dt>
-<dd>station_code, azimuth, take-off angle</dd>
-<dt><strong>4</strong>:</dt>
-<dd><p class="first">polarity:</p>
-<ul class="last simple">
-<li>compression can be c,C,u,U,+</li>
-<li>rarefaction can be d,D,r,R,-</li>
-<li>not defined is anything else</li>
-</ul>
-</dd>
-</dl>
-</div></blockquote>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>[<em>ncols</em>][<em>type</em>]) data
-table file(s) holding a number of data columns. If no tables are given
-then we read from standard input. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-J</strong><em>parameters</em> <a class="reference internal" href="../../gmt.html#j-full"><em>(more ...)</em></a></dt>
-<dd>Select map projection.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]</dt>
-<dd><em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> specify the region of interest,
-and you may specify them in decimal degrees or in
-[+-]dd:mm[:ss.xxx][W|E|S|N] format. Append <strong>r</strong> if lower left
-and upper right map coordinates are given instead of w/e/s/n. The
-two shorthands <strong>-Rg</strong> and <strong>-Rd</strong> stand for global domain (0/360
-and -180/+180 in longitude respectively, with -90/+90 in latitude).
-Alternatively, specify the name of an existing grid file and the
-<strong>-R</strong> settings (and grid spacing, if applicable) are copied from
-the grid. Using <strong>-R</strong><em>unit</em> expects projected (Cartesian)
-coordinates compatible with chosen <strong>-J</strong> and we inversely project
-to determine actual rectangular geographic region.
-For perspective view (<strong>-p</strong>), optionally append /<em>zmin</em>/<em>zmax</em>.
-In case of perspective view (<strong>-p</strong>), a z-range (<em>zmin</em>, <em>zmax</em>)
-can be appended to indicate the third dimension. This needs to be
-done only when using the <strong>-Jz</strong> option, not when using only the
-<strong>-p</strong> option. In the latter case a perspective view of the plane is
-plotted, with no third dimension. </dd>
-<dt><strong>-D</strong>longitude/latitude)</dt>
-<dd>Maps the bubble at given longitude and latitude point.</dd>
-<dt><strong>-M</strong>size)</dt>
-<dd>Sets the size of the beach ball to plot polarities in. <em>Size</em> is in
-inch (unless <strong>c</strong>, <strong>i</strong>, <strong>m</strong>, or <strong>p</strong> is appended).</dd>
-<dt><strong>-S</strong><symbol_type><size>)</dt>
-<dd>Selects <em>symbol_type</em> and symbol <em>size</em>. Size is in inch (unless
-<strong>c</strong>, <strong>i</strong>, <strong>m</strong>, or <strong>p</strong> is appended). Choose symbol type from
-st(<em>a</em>)r, (<em>c</em>)ircle, (<em>d</em>)iamond, (<em>h</em>)exagon, (<em>i</em>)nverted
-triangle, (<em>p</em>)oint, (<em>s</em>)quare, (<em>t</em>)riangle, (<em>x</em>)cross.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> <a class="reference internal" href="../../gmt.html#b-full"><em>(more ...)</em></a></dt>
-<dd>Set map boundary intervals.</dd>
-<dt><strong>-C</strong></dt>
-<dd>Offsets focal mechanisms to the latitude and longitude specified in
-the last two columns of the input file.</dd>
-<dt><strong>-E</strong>fill)</dt>
-<dd>Selects filling of symbols for stations in extensive quadrants. Set
-the color [Default is 250]. If <strong>-E</strong><em>fill</em> is the same as
-<strong>-F</strong><em>fill</em>, use <strong>-e</strong> to outline.</dd>
-<dt><strong>-F</strong><em>fill</em></dt>
-<dd>Sets background color of the beach ball. Default is no fill.</dd>
-<dt><strong>-G</strong><em>fill</em></dt>
-<dd>Selects filling of symbols for stations in compressional quadrants.
-Set the color [Default is black].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-K</strong> <a class="reference internal" href="../../gmt.html#k-full"><em>(more ...)</em></a></dt>
-<dd>Do not finalize the PostScript plot.</dd>
-<dt><strong>-N</strong></dt>
-<dd>Does <strong>not</strong> skip symbols that fall outside map border [Default
-plots points inside border only].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-O</strong> <a class="reference internal" href="../../gmt.html#o-full"><em>(more ...)</em></a></dt>
-<dd>Append to existing PostScript plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-P</strong> <a class="reference internal" href="../../gmt.html#p-full"><em>(more ...)</em></a></dt>
-<dd>Select “Portrait” plot orientation.</dd>
-<dt><strong>-Q</strong><em>mode</em>[<em>args</em>]</dt>
-<dd>Sets one or more attributes; repeatable. The various combinations are</dd>
-<dt><strong>-Qe</strong>[pen])</dt>
-<dd>Outline symbols in extensive quadrants using <em>pen</em> or the default
-pen (see <strong>-W</strong>).</dd>
-<dt><strong>-Qf</strong>[pen])</dt>
-<dd>Outline the beach ball using <em>pen</em> or the default pen (see <strong>-W</strong>).</dd>
-<dt><strong>-Qg</strong>[pen])</dt>
-<dd>Outline symbols in compressional quadrants using <em>pen</em> or the
-default pen (see <strong>-W</strong>).</dd>
-<dt><strong>-Qh</strong></dt>
-<dd>Use special format derived from HYPO71 output</dd>
-<dt><strong>-Qs</strong><em>half-size</em>/[<strong>V</strong>[<em>v_width/h_length/h_width/shape</em>]][<strong>G</strong><em>color</em>][<strong>L</strong>]</dt>
-<dd>Plots S polarity azimuth. S polarity is in last column. It may be a
-vector (<strong>V</strong> option) or a segment. Give
-half-size,v_width,h_length,h_width in inch (unless <strong>c</strong>, <strong>i</strong>,
-<strong>m</strong>, or <strong>p</strong> is appended). [<strong>L</strong>] option is for outline.</dd>
-<dt><strong>-Qt</strong><em>pen</em></dt>
-<dd>Set pen color to write station code. Default uses the default pen
-(see <strong>-W</strong>).</dd>
-<dt><strong>-T</strong><em>angle/form/justify/fontsize in points</em></dt>
-<dd>To write station code. [Default is 0.0/0/5/12].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] <a class="reference internal" href="../../gmt.html#u-full"><em>(more ...)</em></a></dt>
-<dd>Draw GMT time stamp logo on plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong><em>pen</em></dt>
-<dd>Set current pen attributes [Defaults: width = default, color = black, style = solid].</dd>
-</dl>
-<p><strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]]</p>
-<dl class="docutils">
-<dt><strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] <a class="reference internal" href="../../gmt.html#xy-full"><em>(more ...)</em></a></dt>
-<dd>Shift plot origin.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-c</strong><em>copies</em> <a class="reference internal" href="../../gmt.html#c-full"><em>(more ...)</em></a></dt>
-<dd>Specify number of plot copies [Default is 1].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="../../gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="../../gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt pspolar -R239/240/34/35.2 -JM8c -N -Sc0.4 -h1 -D39.5/34.5 -M5 << END > test.ps
-#stat azim ih pol
-0481 11 147 c
-6185 247 120 d
-0485 288 114 +
-0490 223 112 -
-0487 212 109 .
-END
-</pre></div>
-</div>
-</div></blockquote>
-<p>or</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt pspolar -R239/240/34/35.2 -JM8c -N -Sc0.4 -h1 -D239.5/34.5 -M5 <<END > test.ps
-#Date Or. time stat azim ih
-910223 1 22 0481 11 147 ipu0
-910223 1 22 6185 247 120 ipd0
-910223 1 22 0485 288 114 epu0
-910223 1 22 0490 223 112 epd0
-910223 1 22 0487 212 109 epu0
-END
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="../../gmt.html"><em>gmt</em></a>, <a class="reference internal" href="../../psbasemap.html"><em>psbasemap</em></a>, <a class="reference internal" href="../../psxy.html"><em>psxy</em></a></p>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>Bomford, G., Geodesy, 4th ed., Oxford University Press, 1980.</p>
-<p>Aki, K. and P. Richards, Quantitative Seismology, Freeman, 1980.</p>
-</div>
-<div class="section" id="authors">
-<h2>Authors<a class="headerlink" href="#authors" title="Permalink to this headline">¶</a></h2>
-<p>Genevieve Patau, <cite>Laboratory of Seismogenesis <http://www.ipgp.fr/rech/sismogenese/></cite>,
-Institut de Physique du Globe de Paris, Departement de Sismologie, Paris, France</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">pspolar</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-<li><a class="reference internal" href="#authors">Authors</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="psmeca.html"
- title="previous chapter">psmeca</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="psvelo.html"
- title="next chapter">psvelo</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/meca/pspolar.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="psvelo.html" title="psvelo"
- >next</a> </li>
- <li class="right" >
- <a href="psmeca.html" title="psmeca"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_MECA.html" >MECA</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/meca/psvelo.html b/doc_release/html/supplements/meca/psvelo.html
deleted file mode 100644
index 3eaa69b..0000000
--- a/doc_release/html/supplements/meca/psvelo.html
+++ /dev/null
@@ -1,496 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>psvelo — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="MECA" href="../../SUP_MECA.html" />
- <link rel="next" title="MGD77" href="../../SUP_MGD77.html" />
- <link rel="prev" title="pspolar" href="pspolar.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="../../SUP_MGD77.html" title="MGD77"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="pspolar.html" title="pspolar"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_MECA.html" accesskey="U">MECA</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="psvelo">
-<span id="index-0"></span><h1>psvelo<a class="headerlink" href="#psvelo" title="Permalink to this headline">¶</a></h1>
-<p>psvelo - Plot velocity vectors, crosses, and wedges on maps</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>psvelo</strong> [ <em>table</em> ] <strong>-J</strong><em>parameters</em>
-<strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>]
-[ <strong>-A</strong><em>parameters</em> ]
-[ <strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> ]
-[ <strong>-F</strong><em>color</em> ] [ <strong>-E</strong><em>color</em> ] [ <strong>-G</strong><em>fill</em> ] [ <strong>-K</strong> ]
-[ <strong>-L</strong> ] [ <strong>-N</strong> ] [ <strong>-O</strong> ] [ <strong>-P</strong> ]
-[ <strong>-S</strong><em>symbol</em>/<em>scale</em>/<em>conf</em>/<em>font_size</em> ] [
-[ <strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W</strong><em>pen</em> ]
-[ <strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] ]
-[ <strong>-c</strong><em>copies</em> ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>psvelo</strong> reads data values from <em>files</em> [or standard input] and
-generates PostScript code that will plot velocity arrows on a map.
-Most options are the same as for <a class="reference internal" href="../../psxy.html"><em>psxy</em></a>, except <strong>-S</strong>. The
-PostScript code is written to standard output. The previous version
-(<strong>psvelomeca</strong>) is now obsolete. It has been replaced by <strong>psvelo</strong> and
-<a class="reference internal" href="psmeca.html"><em>psmeca</em></a>.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>[<em>ncols</em>][<em>type</em>]) data
-table file(s) holding a number of data columns. If no tables are given
-then we read from standard input. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-J</strong><em>parameters</em> <a class="reference internal" href="../../gmt.html#j-full"><em>(more ...)</em></a></dt>
-<dd>Select map projection.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]</dt>
-<dd><em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> specify the region of interest,
-and you may specify them in decimal degrees or in
-[+-]dd:mm[:ss.xxx][W|E|S|N] format. Append <strong>r</strong> if lower left
-and upper right map coordinates are given instead of w/e/s/n. The
-two shorthands <strong>-Rg</strong> and <strong>-Rd</strong> stand for global domain (0/360
-and -180/+180 in longitude respectively, with -90/+90 in latitude).
-Alternatively, specify the name of an existing grid file and the
-<strong>-R</strong> settings (and grid spacing, if applicable) are copied from
-the grid. Using <strong>-R</strong><em>unit</em> expects projected (Cartesian)
-coordinates compatible with chosen <strong>-J</strong> and we inversely project
-to determine actual rectangular geographic region.
-For perspective view (<strong>-p</strong>), optionally append /<em>zmin</em>/<em>zmax</em>.
-In case of perspective view (<strong>-p</strong>), a z-range (<em>zmin</em>, <em>zmax</em>)
-can be appended to indicate the third dimension. This needs to be
-done only when using the <strong>-Jz</strong> option, not when using only the
-<strong>-p</strong> option. In the latter case a perspective view of the plane is
-plotted, with no third dimension. </dd>
-</dl>
-<p><strong>-S</strong></p>
-<p>Selects the meaning of the columns in the data file and the figure to be
-plotted.</p>
-<p><strong>-Se</strong><em>velscale/confidence/fontsize</em>.</p>
-<p>Velocity ellipses in (N,E) convention. <em>Vscale</em> sets the scaling of the
-velocity arrows. This scaling gives inches (unless <strong>c</strong>, <strong>i</strong>, <strong>m</strong>,
-or <strong>p</strong> is appended). <em>Confidence</em> sets the 2-dimensional confidence
-limit for the ellipse, e.g., 0.95 for 95% confidence ellipse. <em>Fontsize</em>
-sets the size of the text in points. The ellipse will be filled with the
-color or shade specified by the <strong>-G</strong> option [default transparent]. The
-arrow and the circumference of the ellipse will be drawn with the pen
-attributes specified by the <strong>-W</strong> option. Parameters are expected to be
-in the following columns:</p>
-<blockquote>
-<div><strong>1</strong>,<strong>2</strong>:
-longitude, latitude of station (<strong>-:</strong> option interchanges order)
-<strong>3</strong>,<strong>4</strong>:
-eastward, northward velocity (<strong>-:</strong> option interchanges order)
-<strong>5</strong>,<strong>6</strong>:
-uncertainty of eastward, northward velocities (1-sigma) (<strong>-:</strong>
-option interchanges order)
-<strong>7</strong>:
-correlation between eastward and northward components
-<strong>8</strong>:
-name of station (optional).</div></blockquote>
-<p><strong>-Sn</strong><em>barscale.</em></p>
-<p>Anisotropy bars. <em>Barscale</em> sets the scaling of the bars This scaling
-gives inches (unless <strong>c</strong>, <strong>i</strong>, <strong>m</strong>, or <strong>p</strong> is appended).
-Parameters are expected to be in the following columns:</p>
-<blockquote>
-<div><strong>1</strong>,<strong>2</strong>:
-longitude, latitude of station (<strong>-:</strong> option interchanges order)
-<strong>3</strong>,<strong>4</strong>:
-eastward, northward components of anisotropy vector (<strong>-:</strong> option
-interchanges order)</div></blockquote>
-<p><strong>-Sr</strong><em>velscale/confidence/fontsize</em></p>
-<p>Velocity ellipses in rotated convention. <em>Vscale</em> sets the scaling of
-the velocity arrows. This scaling gives inches (unless <strong>c</strong>, <strong>i</strong>,
-<strong>m</strong>, or <strong>p</strong> is appended). <em>Confidence</em> sets the 2-dimensional
-confidence limit for the ellipse, e.g., 0.95 for 95% confidence ellipse.
-<em>Fontsize</em> sets the size of the text in points. The ellipse will be
-filled with the color or shade specified by the <strong>-G</strong> option [default
-transparent]. The arrow and the circumference of the ellipse will be
-drawn with the pen attributes specified by the <strong>-W</strong> option. Parameters
-are expected to be in the following columns:</p>
-<blockquote>
-<div><strong>1</strong>,<strong>2</strong>:
-longitude, latitude, of station (<strong>-:</strong> option interchanges order)
-<strong>3</strong>,<strong>4</strong>:
-eastward, northward velocity (<strong>-:</strong> option interchanges order)
-<strong>5</strong>,<strong>6</strong>:
-semi-major, semi-minor axes
-<strong>7</strong>:
-counter-clockwise angle, in degrees, from horizontal axis to major
-axis of ellipse.
-<strong>8</strong>:
-name of station (optional)</div></blockquote>
-<p><strong>-Sw</strong><em>wedge_scale/wedge_mag</em>.</p>
-<p>Rotational wedges. <em>Wedge_scale</em> sets the size of the wedges in inches
-(unless <strong>c</strong>, <strong>i</strong>, <strong>m</strong>, or <strong>p</strong> is appended). Values are
-multiplied by <em>Wedge_mag</em> before plotting. For example, setting
-<em>Wedge_mag</em> to 1.e7 works well for rotations of the order of 100
-nanoradians/yr. Use <strong>-G</strong> to set the fill color or shade for the wedge,
-and <strong>-E</strong> to set the color or shade for the uncertainty. Parameters are
-expected to be in the following columns:</p>
-<blockquote>
-<div><strong>1</strong>,<strong>2</strong>:
-longitude, latitude, of station (<strong>-:</strong> option interchanges order)
-<strong>3</strong>:
-rotation in radians
-<strong>4</strong>:
-rotation uncertainty in radians</div></blockquote>
-<p><strong>-Sx</strong><em>cross_scale</em></p>
-<p>gives Strain crosses. <em>Cross_scale</em> sets the size of the cross in
-inches (unless <strong>c</strong>, <strong>i</strong>, <strong>m</strong>, or <strong>p</strong> is appended). Parameters
-are expected to be in the following columns:</p>
-<blockquote>
-<div><strong>1</strong>,<strong>2</strong>:
-longitude, latitude, of station (<strong>-:</strong> option interchanges order)
-<strong>3</strong>:
-eps1, the most extensional eigenvalue of strain tensor, with
-extension taken positive.
-<strong>4</strong>:
-eps2, the most compressional eigenvalue of strain tensor, with
-extension taken positive.
-<strong>5</strong>:
-azimuth of eps2 in degrees CW from North.</div></blockquote>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong><em>parameters</em></dt>
-<dd>Modify vector parameters. For vector heads, append vector head
-<em>size</em> [Default is 9p]. See VECTOR ATTRIBUTES for specifying
-additional attributes.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> <a class="reference internal" href="../../gmt.html#b-full"><em>(more ...)</em></a></dt>
-<dd>Set map boundary intervals.</dd>
-<dt><strong>-D</strong><em>Sigma_scale</em></dt>
-<dd>can be used to rescale the uncertainties of velocities (<strong>-Se</strong> and
-<strong>-Sr</strong>) and rotations (<strong>-Sw</strong>). Can be combined with the <em>confidence</em> variable.</dd>
-<dt><strong>-F</strong><em>fill</em></dt>
-<dd>Sets the color or shade used for frame and annotation. [Default is black]</dd>
-<dt><strong>-E</strong><em>fill</em></dt>
-<dd>Sets the color or shade used for filling uncertainty wedges
-(<strong>-Sw</strong>) or velocity error ellipses (<strong>-Se</strong> or <strong>-Sr</strong>). [If
-<strong>-E</strong> is not specified, the uncertainty regions will be transparent.]</dd>
-<dt><strong>-G</strong><em>fill</em></dt>
-<dd>Specify color (for symbols/polygons) or pattern (for polygons)
-[Default is black]. Optionally, specify
-<strong>-Gp</strong><em>icon_size/pattern</em>, where <em>pattern</em> gives the number of
-the image pattern (1-90) OR the name of a icon-format file.
-<em>icon_size</em> sets the unit size in inches. To invert black and white
-pixels, use <strong>-GP</strong> instead of <strong>-Gp</strong>. See <strong>pspatterns</strong> for
-information on individual patterns.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-K</strong> <a class="reference internal" href="../../gmt.html#k-full"><em>(more ...)</em></a></dt>
-<dd>Do not finalize the PostScript plot.</dd>
-<dt><strong>-L</strong></dt>
-<dd>Draw lines. Ellipses and fault planes will have their outlines drawn
-using current pen (see <strong>-W</strong>).</dd>
-<dt><strong>-N</strong></dt>
-<dd>Do <strong>NOT</strong> skip symbols that fall outside the frame boundary
-specified by <strong>-R</strong>. [Default plots symbols inside frame only].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-O</strong> <a class="reference internal" href="../../gmt.html#o-full"><em>(more ...)</em></a></dt>
-<dd>Append to existing PostScript plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-P</strong> <a class="reference internal" href="../../gmt.html#p-full"><em>(more ...)</em></a></dt>
-<dd>Select “Portrait” plot orientation.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] <a class="reference internal" href="../../gmt.html#u-full"><em>(more ...)</em></a></dt>
-<dd>Draw GMT time stamp logo on plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong></dt>
-<dd>Set pen attributes for velocity arrows, ellipse circumference and
-fault plane edges. [Defaults: width = default, color = black, style = solid].</dd>
-</dl>
-<p><strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]]</p>
-<dl class="docutils">
-<dt><strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] <a class="reference internal" href="../../gmt.html#xy-full"><em>(more ...)</em></a></dt>
-<dd>Shift plot origin.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-c</strong><em>copies</em> <a class="reference internal" href="../../gmt.html#c-full"><em>(more ...)</em></a></dt>
-<dd>Specify number of plot copies [Default is 1].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="../../gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="../../gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="../../gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc15">Vector Attributes</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>Several modifiers may be appended to the vector-producing options to
-specify the placement of vector heads, their shapes, and the
-justification of the vector. Below, left and right refers to the
-side of the vector line when viewed from the start point to the
-end point of the segment:</p>
-<blockquote>
-<div><p><strong>+a</strong><em>angle</em> sets the angle of the vector head apex [30].</p>
-<p><strong>+b</strong> places a vector head at the beginning of the vector path [none].
-Append <strong>l</strong>|<strong>r</strong> to only draw the left or right side of this head
-[both sides].</p>
-<p><strong>+e</strong> places a vector head at the end of the vector path [none].
-Append <strong>l</strong>|<strong>r</strong> to only draw the left or right side of this head
-[both sides].</p>
-<p><strong>+g</strong>-|<em>fill</em> turns off vector head fill (if -) or sets the vector
-head fill [Default fill is used, which may be no fill].</p>
-<p><strong>+l</strong> draws half-arrows, using only the left side of specified heads [both sides].</p>
-<p><strong>+n</strong><em>norm</em> scales down vector attributes (pen thickness, head size)
-with decreasing length, where vectors shorter than <em>norm</em> will have
-their attributes scaled by length/<em>norm</em> [arrow attributes remains
-invariant to length].</p>
-<p><strong>+o</strong><em>plon</em>/<em>plat</em> specifies the oblique pole for the great or
-small circles. Only needed for great circles if <strong>+q</strong> is given.</p>
-<p><strong>+p</strong>[-][<em>pen</em>] sets the vector pen attributes. If <em>pen</em> has a
-leading - then the head outline is not drawn. [Default pen is used, and
-head outline is drawn]</p>
-<p><strong>+q</strong> means the input <em>angle</em>, <em>length</em> data instead represent the <em>start</em> and <em>stop</em>
-opening angles of the arc segment relative to the given point.</p>
-<p><strong>+r</strong> draws half-arrows, using only the right side of specified heads [both sides].</p>
-</div></blockquote>
-<p>In addition, all but circular vectors may take these modifiers:</p>
-<blockquote>
-<div><p><strong>+j</strong><em>just</em> determines how the input <em>x</em>,<em>y</em> point relates to the
-vector. Choose from <strong>b</strong>eginning [default], <strong>e</strong>nd, or <strong>c</strong>enter.</p>
-<p><strong>+s</strong> means the input <em>angle</em>, <em>length</em> is instead the <em>x</em>, <em>y</em>
-coordinates of the vector end point.</p>
-</div></blockquote>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>The following should make big red arrows with green ellipses, outlined
-in red. Note that the 39% confidence scaling will give an ellipse which
-fits inside a rectangle of dimension Esig by Nsig.</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psvelo << END -h2 -R-10/10/-10/10 -W0.25p,red -Ggreen -L -Se0.2/0.39/18 \
- -B1g1 -Jx0.4/0.4 -A0.3p -P -V > test.ps
-#Long. Lat. Evel Nvel Esig Nsig CorEN SITE
-#(deg) (deg) (mm/yr) (mm/yr)
-0. -8. 0.0 0.0 4.0 6.0 0.500 4x6
--8. 5. 3.0 3.0 0.0 0.0 0.500 3x3
-0. 0. 4.0 6.0 4.0 6.0 0.500
--5. -5. 6.0 4.0 6.0 4.0 0.500 6x4
-5. 0. -6.0 4.0 6.0 4.0 -0.500 -6x4
-0. -5. 6.0 -4.0 6.0 4.0 -0.500 6x-4
-END
-</pre></div>
-</div>
-</div></blockquote>
-<p>This example should plot some residual rates of rotation in the Western
-Transverse Ranges, California. The wedges will be dark gray, with light
-gray wedges to represent the 2-sigma uncertainties.</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt psvelo << END -Sw0.4/1.e7 -W0.75p -Gdarkgray -Elightgray -h1 -D2 -Jm2.2 \
- -R240./243./32.5/34.75 -Bf10ma60m/WeSn -P > test.ps
-#lon lat spin(rad/yr) spin_sigma (rad/yr)
-241.4806 34.2073 5.65E-08 1.17E-08
-241.6024 34.4468 -4.85E-08 1.85E-08
-241.0952 34.4079 4.46E-09 3.07E-08
-241.2542 34.2581 1.28E-07 1.59E-08
-242.0593 34.0773 -6.62E-08 1.74E-08
-241.0553 34.5369 -2.38E-07 4.27E-08
-241.1993 33.1894 -2.99E-10 7.64E-09
-241.1084 34.2565 2.17E-08 3.53E-08
-END
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="../../gmt.html"><em>gmt</em></a>, <a class="reference internal" href="../../psbasemap.html"><em>psbasemap</em></a>, <a class="reference internal" href="../../psxy.html"><em>psxy</em></a></p>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>Bomford, G., Geodesy, 4th ed., Oxford University Press, 1980.</p>
-</div>
-<div class="section" id="authors">
-<h2>Authors<a class="headerlink" href="#authors" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference external" href="http://www.geology.wisc.edu/~feigl/">Kurt L. Feigl</a>, Department of Geology and
-Geophysics at University of Wisconsin-Madison, Madison, Wisconsin, USA</p>
-<p>Genevieve Patau, <a class="reference external" href="http://www.ipgp.fr/rech/sismogenese/">Laboratory of Seismogenesis</a>,
-Institut de Physique du Globe de Paris, Departement de Sismologie, Paris, France</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">psvelo</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#id1">Vector Attributes</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-<li><a class="reference internal" href="#authors">Authors</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="pspolar.html"
- title="previous chapter">pspolar</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="../../SUP_MGD77.html"
- title="next chapter">MGD77</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/meca/psvelo.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="../../SUP_MGD77.html" title="MGD77"
- >next</a> </li>
- <li class="right" >
- <a href="pspolar.html" title="pspolar"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_MECA.html" >MECA</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/mgd77/mgd77convert.html b/doc_release/html/supplements/mgd77/mgd77convert.html
deleted file mode 100644
index 6fd3e87..0000000
--- a/doc_release/html/supplements/mgd77/mgd77convert.html
+++ /dev/null
@@ -1,328 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>mgd77convert — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="MGD77" href="../../SUP_MGD77.html" />
- <link rel="next" title="mgd77info" href="mgd77info.html" />
- <link rel="prev" title="MGD77" href="../../SUP_MGD77.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="mgd77info.html" title="mgd77info"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="../../SUP_MGD77.html" title="MGD77"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_MGD77.html" accesskey="U">MGD77</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="mgd77convert">
-<span id="index-0"></span><h1>mgd77convert<a class="headerlink" href="#mgd77convert" title="Permalink to this headline">¶</a></h1>
-<p>mgd77convert - Convert MGD77 data to other file formats</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>mgd77convert</strong> <em>NGDC-ids</em> <strong>-Fa</strong>|<strong>c</strong>|<strong>m</strong> |<strong>t</strong>
-<strong>-T</strong>[<strong>+</strong>]<strong>a</strong>|<strong>c</strong>|<strong>m</strong>|<strong>t</strong>
-[ <strong>-C</strong> ]
-[ <strong>-D</strong> ]
-[ <strong>-L</strong>[<strong>w</strong>][<strong>e</strong>][<strong>+</strong>] ]
-[ <strong>-V</strong>[<em>level</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>mgd77convert</strong> reads versions of MGD77 files and writes the same data
-in (probably) another format to a new file in the current directory.
-Both pre- and post-Y2K MGD77 formats can be processed.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>NGDC-ids</em></dt>
-<dd><p class="first">Can be one or more of five kinds of specifiers:</p>
-<ol class="arabic simple">
-<li>8-character NGDC IDs, e.g., 01010083, JA010010etc., etc.</li>
-<li>2-character <agency> codes which will return all cruises from each agency.</li>
-<li>4-character <agency><vessel> codes, which will return all cruises from those vessels.</li>
-<li>=<list>, where <list> is a table with NGDC IDs, one per line.</li>
-<li>If nothing is specified we return all cruises in the data base.</li>
-</ol>
-<p class="last">(See mgd77info <strong>-L</strong> for agency and vessel codes). The ”.mgd77” or
-”.nc” extensions will automatically be appended, if needed (use
-<strong>-I</strong> to ignore certain file types). Cruise files will be looked
-for first in the current directory and second in all directories
-listed in <strong>$MGD77_HOME</strong>/mgd77_paths.txt [If <strong>$MGD77_HOME</strong> is
-not set it will default to <strong>$GMT_SHAREDIR</strong>/mgd77].</p>
-</dd>
-<dt><strong>-Fa</strong>|<strong>c</strong>|<strong>m</strong> |<strong>t</strong></dt>
-<dd>Specifies the format of the input (From) files. Choose from <strong>a</strong>
-for standard MGD77 ASCII table (with extension .mgd77), <strong>c</strong> for
-the new MGD77+ netCDF format (with extension .nc), <strong>m</strong> for the
-new MGD77 t format (extension .m77t) and <strong>t</strong> for a
-plain ASCII tab-separated table dump (with extension .dat). Use
-<strong>-FC</strong> to recover the original MGD77 setting from the MGD77+ file
-[Default will apply any E77 corrections encoded in the file].</dd>
-<dt><strong>-T</strong>[<strong>+</strong>]<strong>a</strong>|<strong>c</strong>|<strong>m</strong> |<strong>t</strong></dt>
-<dd>Specifies the format of the output (To) files. Choose from <strong>a</strong> for
-standard MGD77 ASCII table (with extension .mgd77), <strong>c</strong> for the
-new MGD77+ netCDF format (with extension .nc), <strong>m</strong> for the
-new MGD77 t format (extension .m77t) and <strong>t</strong> for a plain
-ASCII tab-separated table dump (with extension .dat). We will refuse
-to create the file(s) if they already exist in the current
-directory. Prepend <strong>+</strong> to override this policy.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-C</strong></dt>
-<dd>Convert from NGDC two-file data sets *.h77, *.a77 to single file
-*.mgd77. No other options (except <strong>-V</strong>) are allowed. Give one or
-more names of *.h77 files, *.a77 files, or just the file prefixes.</dd>
-<dt><strong>-D</strong></dt>
-<dd>By default, the storage types used in a MGD77+ netCDF file greatly
-exceed the precision imposed by the ASCII MGD77 format. However, for
-the five items <strong>faa</strong>, <strong>eot</strong>, <strong>mag</strong>, <strong>diur</strong> and <strong>msd</strong> we
-use 2-byte integers with implied precisions of 0.1 mGal, 0.1 nTesla,
-and 1 m as in the MGD77 format. It is possible that at some point
-these items will need to be stored as 4-byte ints which would allow
-precisions of 10 fTesla, 1 nGal, and 0.01 mm, respectively. This
-option activates such storage [Default uses 2-byte integers].</dd>
-<dt><strong>-L</strong>[<strong>w</strong>][<strong>e</strong>][<strong>+</strong>]</dt>
-<dd>Set the level of verification reporting [none] and where to send
-such reports [stderr]. Append a combination of <strong>w</strong> for warnings,
-<strong>e</strong> for errors, and <strong>+</strong> to send such log information to stdout.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To convert a large set of a77,h77 pairs to proper mgd77 files, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mgd77convert -C *.h77
-</pre></div>
-</div>
-</div></blockquote>
-<p>To convert 01010047.mgd77 and 01010008.mgd77 to new netCDF .nc files,
-and capture all verification messages, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mgd77convert 01010047 01010008 -Fa -Tc -V -Lew+ > log.lis
-</pre></div>
-</div>
-</div></blockquote>
-<p>To convert 01010047.nc back to MGD77 ASCII and make sure it is identical
-to the original file, try (Bourne shell syntax)</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>orig=`gmt mgd77path 01010047 -Ic`
-gmt mgd77convert 01010047 -Fc -Ta -V
-diff $orig 01010047.mgd77
-</pre></div>
-</div>
-</div></blockquote>
-<p>To convert 01010047.nc to a plain ASCII table for manual editing,
-overwriting any existing table, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mgd77convert 01010047 -Fc -T+t -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>To recover the original NGDC MGD77 version of 01020051.nc and ignore any
-E77 corrections, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mgd77convert 01020051 -FC -Ta -V
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="file-formats">
-<h2>File Formats<a class="headerlink" href="#file-formats" title="Permalink to this headline">¶</a></h2>
-<p><strong>mgd77convert</strong> handles three different formats. (1) The MGD77 ASCII
-tables are the established standard for distribution of underway
-geophysical data to and from the NGDC data center. Normally, only the
-ship-operations people and the cruise PI might be involved in <em>making</em>
-an MGD77 ASCII file for transmission to NGDC; users are more interested
-in <em>reading</em> such files. (2) The MGD77+ netCDF format was developed to
-fascilitate the use of MGD77 data by scientists. It contains all the
-information of the original MGD77 file and if you convert back and forth
-you end up with the original. However, file sizes are typically ~30% of
-the original ASCII format and is much faster to operate on. (3) The
-plain ASCII tab-separated dump is available for users who need to
-manually edit the content of a MGD77 file. This is usually easier to do
-when the columns are tab-separated than when they are all crunched
-together in the MGD77 punch-card format.</p>
-</div>
-<div class="section" id="other-tools">
-<h2>Other Tools<a class="headerlink" href="#other-tools" title="Permalink to this headline">¶</a></h2>
-<p>The MGD77+ netCDF files are CF-1.0 and COARDS compliant and can be
-examined with general-purpose tools such as ncBrowse and ncView.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="mgd77manage.html"><em>mgd77manage</em></a>,
-<a class="reference internal" href="mgd77list.html"><em>mgd77list</em></a>,
-<a class="reference internal" href="mgd77info.html"><em>mgd77info</em></a>,
-<a class="reference internal" href="mgd77track.html"><em>mgd77track</em></a>
-<a class="reference internal" href="../x2sys/x2sys_init.html"><em>x2sys_init</em></a></p>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>ncBrowse, see <a class="reference external" href="http://www.epic.noaa.gov/java/ncBrowse/">http://www.epic.noaa.gov/java/ncBrowse/</a>
-ncView, see <a class="reference external" href="http://meteora.ucsd.edu/~pierce/ncview_home_page/">http://meteora.ucsd.edu/~pierce/ncview_home_page/</a>
-The Marine Geophysical Data Exchange Format - “MGD77”, see
-<a class="reference external" href="http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt">http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt</a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">mgd77convert</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#file-formats">File Formats</a></li>
-<li><a class="reference internal" href="#other-tools">Other Tools</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="../../SUP_MGD77.html"
- title="previous chapter">MGD77</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="mgd77info.html"
- title="next chapter">mgd77info</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/mgd77/mgd77convert.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="mgd77info.html" title="mgd77info"
- >next</a> </li>
- <li class="right" >
- <a href="../../SUP_MGD77.html" title="MGD77"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_MGD77.html" >MGD77</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/mgd77/mgd77info.html b/doc_release/html/supplements/mgd77/mgd77info.html
deleted file mode 100644
index 35fbaaf..0000000
--- a/doc_release/html/supplements/mgd77/mgd77info.html
+++ /dev/null
@@ -1,321 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>mgd77info — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="MGD77" href="../../SUP_MGD77.html" />
- <link rel="next" title="mgd77list" href="mgd77list.html" />
- <link rel="prev" title="mgd77convert" href="mgd77convert.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="mgd77list.html" title="mgd77list"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="mgd77convert.html" title="mgd77convert"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_MGD77.html" accesskey="U">MGD77</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="mgd77info">
-<span id="index-0"></span><h1>mgd77info<a class="headerlink" href="#mgd77info" title="Permalink to this headline">¶</a></h1>
-<p>mgd77info - Extract information about MGD77 files</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>mgd77info</strong> <em>NGDC-ids</em>
-[ <strong>-C</strong>[<strong>m</strong>|<strong>e</strong>] ]
-[ <strong>-E</strong>[<strong>m</strong>|<strong>e</strong>] ] [ <strong>-I</strong><em>ignore</em> ]
-[ <strong>-Mf</strong>[<em>item</em>]|<strong>r</strong>|<strong>e</strong>|<strong>h</strong> ]
-[ <strong>-L</strong>[<strong>v</strong>] ]
-[ <strong>-V</strong>[<em>level</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>mgd77info</strong> reads <legid>.[mgd77|nc] files and produces a single
-record of information about each cruise specified. The information
-includes beginning and end times, total track distances in km, longitude
-and latitude range, and the total number of geophysical observations.
-Optionally, choose instead to see the original MGD77 header meta-data
-section or its individual members.</p>
-<p>If you need to know which tracks are crossing through a given region and
-what kinds of geophysical observations are available, consider using the
-x2sys tools to set up a tracks index data base (see <strong>x2sys_init</strong> for
-more information).</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>NGDC-ids</em></dt>
-<dd><p class="first">Can be one or more of five kinds of specifiers:</p>
-<ol class="arabic simple">
-<li>8-character NGDC IDs, e.g., 01010083, JA010010etc., etc.</li>
-<li>2-character <agency> codes which will return all cruises from each agency.</li>
-<li>4-character <agency><vessel> codes, which will return all cruises from those vessels.</li>
-<li>=<list>, where <list> is a table with NGDC IDs, one per line.</li>
-<li>If nothing is specified we return all cruises in the data base.</li>
-</ol>
-<p class="last">(See mgd77info <strong>-L</strong> for agency and vessel codes). The ”.mgd77” or
-”.nc” extensions will automatically be appended, if needed (use
-<strong>-I</strong> to ignore certain file types). Cruise files will be looked
-for first in the current directory and second in all directories
-listed in <strong>$MGD77_HOME</strong>/mgd77_paths.txt [If <strong>$MGD77_HOME</strong> is
-not set it will default to <strong>$GMT_SHAREDIR</strong>/mgd77].</p>
-</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-C</strong>[<strong>m</strong>|<strong>e</strong>]</dt>
-<dd>List abbreviations for all columns present in the MGD77[+] files.
-Append <strong>m</strong> or <strong>e</strong> to limit the display to the MGD77 standard or
-MGD77+ extended set only.</dd>
-<dt><strong>-E</strong>[<strong>m</strong>|<strong>e</strong>]</dt>
-<dd>Give a one-line summary for each cruise listed.</dd>
-<dt><strong>-Mf</strong>[<em>item</em>]|<strong>r</strong>|<strong>e</strong>|<strong>h</strong></dt>
-<dd>List the meta-data (header) and (if present) the MGD77+ history for
-each cruise. Append <strong>f</strong> for a formatted display. This will list
-individual parameters and their values, one entry per output line,
-in a format that can be searched using standard UNIX text tools.
-Alternatively, append the name of a particular parameter (you only
-need to give enough characters - starting at the beginning - to
-uniquely identify the item). Give - to display the list of all
-parameter names. You may also specify the number of a parameter. For
-the raw, punchcard-formatted MGD77 original header block, append
-<strong>r</strong> instead. For the MGD77+ E77 status, append <strong>e</strong> instead.
-Finally, for the MGD77+ history, append <strong>h</strong> instead.</dd>
-<dt><strong>-I</strong><em>ignore</em></dt>
-<dd>Ignore certain data file formats from consideration. Append
-<strong>a|c|t</strong> to ignore MGD77 ASCII, MGD77+ netCDF, or plain
-tab-separated ASCII table files, respectively. The option may be
-repeated to ignore more than one format. [Default ignores none].</dd>
-<dt><strong>-L</strong>[<strong>v</strong>]</dt>
-<dd>No cruise information is listed. Instead, we just display a list of
-the GEODAS institution 2-character codes and their names.
-Optionally, append <strong>v</strong> to also display the vessels and their
-4-character codes for each institution. The following is the list of
-institutions:
-(01) LAMONT (LDEO), (02) WOODS HOLE O.I., (03) NOAA, (04) US ARMY,
-(05) NEW ZEALAND, (06) US GEOL. SURVEY, (07) OREGON ST. UNIV, (08)
-U.HAWAII SOEST, (09) US NAVY, (10) UNIV OF TEXAS, (11) RICE UNIV.,
-(12) CANADA, (13) UNIV OF CONN., (14) U.MIAMI (RSMAS), (15) SCRIPPS
-INST.OC, (16) CHINA, (17) U RHODE ISLAND, (18) DUKE UNIVERSITY, (19)
-UNITED KINGDOM, (20) U.WASHINGTON, (22) WESTERN GEOPHY., (23) TEXAS
-A&M UNIV., (24) AUSTRALIA, (25) MONACO, (29) RUSSIA, (30) SPAIN,
-(35) NIMA, (58) NETHERLANDS, (60) MIN MGMT SVC, (63) ISRAEL, (67)
-FRANCE, (71) SOUTH AFRICA, (75) US COAST GUARD, (76) BRAZIL, (77)
-INT. GRAV. BUR, (83) GERMANY, (84) ORSTOM NEW CAL, (86) CUBA, (87)
-ARGENTINA, (88) US NSF, (89) INDIA, (90) PORTUGAL, (92) FINLAND,
-(93) CHILE, (J1) HYDR DEPT JAPAN, (J2) GEOL SRVY JAPAN, (J4) UNIV
-TOKYO, (J5) KOBE UNIV, (J7) UNIV OF RYUKYUS, (J8) J.O.D.C. JAPAN,
-(J9) CHIBA UNIV, (JA) INST.POLAR RES., (ZZ) INST NOT CODED.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To get one-line summary information about the cruises 01010047.mgd77 and
-01010008.mgd77, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mgd77info 01010047 01010008 -E > listing.lis
-</pre></div>
-</div>
-</div></blockquote>
-<p>To see the original raw MGD77 header meta-data for cruise 01010047.mgd77, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mgd77info 01010047 -Mr
-</pre></div>
-</div>
-</div></blockquote>
-<p>To determine all the parameters related to Gravity during cruise 01010047.mgd77, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mgd77info 01010047 -Mf | grep Gravity
-</pre></div>
-</div>
-</div></blockquote>
-<p>To determine the Magnetic sampling rate used during cruise 01010047.mgd77, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mgd77info 01010047 -MfMagnetics_Sampling_Rate
-</pre></div>
-</div>
-</div></blockquote>
-<p>To see all the columns that the MGD77+ cruise 01010047.nc contains, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mgd77info 01010047 -C
-</pre></div>
-</div>
-</div></blockquote>
-<p>To see the E77 status of all MGD77+ cruises collected by the University
-of Hawaii (institution 08), run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mgd77info 08 -Ia -Me
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="mgd77list.html"><em>mgd77list</em></a>,
-<a class="reference internal" href="mgd77manage.html"><em>mgd77manage</em></a>,
-<a class="reference internal" href="mgd77path.html"><em>mgd77path</em></a>,
-<a class="reference internal" href="mgd77track.html"><em>mgd77track</em></a>,
-<a class="reference internal" href="../x2sys/x2sys_init.html"><em>x2sys_init</em></a></p>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>The Marine Geophysical Data Exchange Format - MGD77, see
-<a class="reference external" href="http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt.">http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt.</a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">mgd77info</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="mgd77convert.html"
- title="previous chapter">mgd77convert</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="mgd77list.html"
- title="next chapter">mgd77list</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/mgd77/mgd77info.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="mgd77list.html" title="mgd77list"
- >next</a> </li>
- <li class="right" >
- <a href="mgd77convert.html" title="mgd77convert"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_MGD77.html" >MGD77</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/mgd77/mgd77list.html b/doc_release/html/supplements/mgd77/mgd77list.html
deleted file mode 100644
index c14c8f8..0000000
--- a/doc_release/html/supplements/mgd77/mgd77list.html
+++ /dev/null
@@ -1,741 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>mgd77list — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="MGD77" href="../../SUP_MGD77.html" />
- <link rel="next" title="mgd77magref" href="mgd77magref.html" />
- <link rel="prev" title="mgd77info" href="mgd77info.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="mgd77magref.html" title="mgd77magref"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="mgd77info.html" title="mgd77info"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_MGD77.html" accesskey="U">MGD77</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="mgd77list">
-<span id="index-0"></span><h1>mgd77list<a class="headerlink" href="#mgd77list" title="Permalink to this headline">¶</a></h1>
-<p>mgd77list - Extract data from MGD77 files</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>mgd77list</strong> <em>NGDC-ids</em> <strong>-F</strong><em>columns</em>[,<em>logic</em>][:<em>bittests</em>]
-[ <strong>-A</strong>[<strong>+</strong>]<strong>c</strong>|<strong>d</strong>|<strong>f</strong>|<strong>m</strong>|<strong>t</strong><em>code</em> ]
-[ <strong>-C</strong><strong>f</strong>|<strong>g</strong>|<strong>e</strong> ]
-[ <strong>-D</strong><strong>A</strong>|<strong>a</strong><em>startdate</em> ]
-[ <strong>-D</strong><strong>B</strong>|<strong>b</strong><em>stopdate</em> ] [ <strong>-E</strong> ] [ <strong>-Ga</strong><em>startrec</em> ]
-[ <strong>-Gb</strong><em>stoprec</em> ] [ <strong>-I</strong><em>ignore</em> ] [ <strong>-L</strong>[<em>corrtable</em>] ]
-[ <strong>-Nd</strong>|<strong>s</strong><em>unit</em> ]
-[ <strong>-Q</strong><strong>a</strong>|<strong>c</strong>|<strong>v</strong><em>min</em>/<em>max</em> ]
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ]
-[ <strong>-Sa</strong><em>startdist</em>[unit] ] [ <strong>-Sb</strong><em>stopdist</em>[unit] ]
-[ <strong>-T</strong>[<strong>m</strong>|<strong>e</strong>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W</strong><em>weight</em> ]
-[ <strong>-Z</strong><em>+</em>|<strong>-</strong> ]
-[ <strong>-bo</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>mgd77list</strong> reads <NGDC-id>.[mgd77|nc] files and produces an ASCII
-[or binary] table. The <NGDC-id>.[mgd77|nc] files contain track
-information such as leg-id, time and position, geophysical observables
-such as gravity, magnetics, and bathymetry, and control codes and
-corrections such as Eotvos and diurnal corrections. The MGD77+ extended
-netCDF files may also contain additional user columns (for a listing of
-available columns, use <a class="reference internal" href="mgd77info.html"><em>mgd77info</em></a> <strong>-C</strong>, and to learn how to add
-your own custom columns, see <a class="reference internal" href="mgd77manage.html"><em>mgd77manage</em></a>). The user may extract any
-combination of these parameters, any of 8 computed quantities (distance,
-heading, course-change, velocity, Carter correction, Eotvos correction
-and gravity and magnetic global reference fields), calendar sub-units of
-time (year, month, day, hour, min, sec), the NGDC id, and finally a
-preset weight (see <strong>-W</strong>). A sub-section can be specified by passing
-time- or distance-intervals along track or by selecting a geographical
-region. Finally, each output record may be required to pass any number
-of logical tests involving data values or bit flags. If multiple cruises
-are requested then they are separated by segment headers.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>NGDC-ids</em></dt>
-<dd><p class="first">Can be one or more of five kinds of specifiers:</p>
-<ol class="arabic simple">
-<li>8-character NGDC IDs, e.g., 01010083, JA010010etc., etc.</li>
-<li>2-character <agency> codes which will return all cruises from each agency.</li>
-<li>4-character <agency><vessel> codes, which will return all cruises from those vessels.</li>
-<li>=<list>, where <list> is a table with NGDC IDs, one per line.</li>
-<li>If nothing is specified we return all cruises in the data base.</li>
-</ol>
-<p class="last">(See mgd77info <strong>-L</strong> for agency and vessel codes). The ”.mgd77” or
-”.nc” extensions will automatically be appended, if needed (use
-<strong>-I</strong> to ignore certain file types). Cruise files will be looked
-for first in the current directory and second in all directories
-listed in <strong>$MGD77_HOME</strong>/mgd77_paths.txt [If <strong>$MGD77_HOME</strong> is
-not set it will default to <strong>$GMT_SHAREDIR</strong>/mgd77].</p>
-</dd>
-<dt><strong>-F</strong><em>columns</em>[,<em>logic</em>][:<em>bittests</em>]</dt>
-<dd><p class="first">The required <em>columns</em> string must be a comma-separated list of
-parameter abbreviations given in the desired output order. Any
-parameters given in UPPER case must not be NaN in a record for
-output to occur. Unless specified separately, the output format (if
-ASCII) is controlled by the GMT parameter <a class="reference internal" href="../../gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>.
-The available column abbreviations for information stored in the
-files (some columns may be NaN) are:</p>
-<dl class="docutils">
-<dt><strong>recno</strong></dt>
-<dd>The record number counter.</dd>
-<dt><strong>drt</strong></dt>
-<dd>The digital record type, usually 3 or 5 (for Y2K-compliant cruises).</dd>
-<dt><strong>id</strong></dt>
-<dd>The survey ID string (leg name).</dd>
-<dt><strong>ngdcid</strong></dt>
-<dd>The 8-character NGDC cruise ID string (usually the file prefix).</dd>
-<dt><strong>time</strong></dt>
-<dd>Choose between Absolute calendar time (<strong>atime</strong>, the default) in
-the format dictated by the GMT parameters <a class="reference internal" href="../../gmt.conf.html#format-date-out"><em>FORMAT_DATE_OUT</em></a> and
-<a class="reference internal" href="../../gmt.conf.html#format-clock-out"><em>FORMAT_CLOCK_OUT</em></a>, Relative time (<strong>rtime</strong>) in the format
-dictated by the GMT parameters <a class="reference internal" href="../../gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> and
-<a class="reference internal" href="../../gmt.conf.html#time-system"><em>TIME_SYSTEM</em></a> (or <a class="reference internal" href="../../gmt.conf.html#time-epoch"><em>TIME_EPOCH</em></a> and <a class="reference internal" href="../../gmt.conf.html#time-unit"><em>TIME_UNIT</em></a>)), or
-Fractional year (<strong>ytime</strong>) in the format dictated by
-<a class="reference internal" href="../../gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>.</dd>
-<dt><strong>lon</strong></dt>
-<dd>Longitude in the format dictated by the GMT parameter
-<a class="reference internal" href="../../gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>.</dd>
-<dt><strong>lat</strong></dt>
-<dd>Longitude in the format dictated by the GMT parameter
-<a class="reference internal" href="../../gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>.</dd>
-<dt><strong>twt</strong></dt>
-<dd>Two-Way Travel time (in s).</dd>
-<dt><strong>depth</strong></dt>
-<dd>Corrected bathymetry (in m, positive below sealevel).</dd>
-<dt><strong>mtf1</strong></dt>
-<dd>Magnetic Total Field intensity from sensor 1 (in nTesla).</dd>
-<dt><strong>mtf2</strong></dt>
-<dd>Magnetic Total Field intensity from sensor 2 (in nTesla).</dd>
-<dt><strong>mag</strong></dt>
-<dd>Residual magnetic anomaly (in nTesla).</dd>
-<dt><strong>gobs</strong></dt>
-<dd>Observed gravity (in mGal).</dd>
-<dt><strong>faa</strong></dt>
-<dd>Free-air gravity anomaly (in mGal).</dd>
-<dt><strong>ptc</strong></dt>
-<dd>Position Type Code (1 = fix, 3 = interpolated, 9 = unspecified).</dd>
-<dt><strong>bcc</strong></dt>
-<dd>Bathymetric Correction Code, indicating the procedure used to
-convert travel time to depth. (01-55 = Matthews’ zone used to
-correct the depth, 59 = Matthews’ corrections used but the zones is
-unspecified in the data record, 60 = S. Kuwahara formula for T-S, 61
-= Wilson formula for T-S, 62 = Del Grosso formula for T-S, 63 =
-Carter’s tables, 88 = Other, described in header sections, 99 =
-unspecified).</dd>
-<dt><strong>btc</strong></dt>
-<dd>Bathymetric Type Code, indicating how the bathymetry value was
-obtained (1 = observed, 3 = interpolated, 9 = unspecified).</dd>
-<dt><strong>msens</strong></dt>
-<dd>Magnetic sensor for used to evaluate the residual field (1 = 1st or
-leading sensor, 2 = 2nd or trailing sensor, 9 = unspecified).</dd>
-<dt><strong>msd</strong></dt>
-<dd>Depth (or altitude) of the magnetic sensor (in m, positive below
-sealevel).</dd>
-<dt><strong>diur</strong></dt>
-<dd>Magnetic diurnal correction (in nTesla).</dd>
-<dt><strong>eot</strong></dt>
-<dd>Eotvos correction (in mGal).</dd>
-<dt><strong>sln</strong></dt>
-<dd>Seismic Line Number string.</dd>
-<dt><strong>sspn</strong></dt>
-<dd>Seismic Shot Point Number string.</dd>
-<dt><strong>nqc</strong></dt>
-<dd>Navigation Quality Code (5 = suspected, by source institution, 6 =
-suspected, by NGDC, 9 = no problems identified).</dd>
-</dl>
-<p>In addition, the following derived navigational quantities can be requested:</p>
-<dl class="docutils">
-<dt><strong>year</strong></dt>
-<dd>The year of each record.</dd>
-<dt><strong>month</strong></dt>
-<dd>The month of each record.</dd>
-<dt><strong>day</strong></dt>
-<dd>The day of the month of each record.</dd>
-<dt><strong>hour</strong></dt>
-<dd>The hour of each record.</dd>
-<dt><strong>min</strong></dt>
-<dd>The minutes of each record.</dd>
-<dt><strong>sec</strong></dt>
-<dd>The decimal seconds of each record.</dd>
-<dt><strong>dist</strong></dt>
-<dd>Along-track distance from start of leg. For method of calculation,
-see <strong>-C</strong> [spherical great circle distances], and for distance
-units, see <strong>-N</strong> [km].</dd>
-<dt><strong>az</strong></dt>
-<dd>Ship azimuth (heading) measured clockwise from north (in degrees).</dd>
-<dt><strong>cc</strong></dt>
-<dd>Ship course change (change in heading) measured clockwise from north
-(in degrees).</dd>
-<dt><strong>vel</strong></dt>
-<dd>Ship speed; see <strong>-N</strong> for units [m/s].</dd>
-</dl>
-<p>Finally, the following computed quantities can be requested:</p>
-<dl class="docutils">
-<dt><strong>weight</strong></dt>
-<dd>Weight assigned to this data set (see <strong>-W</strong>).</dd>
-<dt><strong>carter</strong></dt>
-<dd>Carter depth correction, if <strong>twt</strong> is present in file (in m). Sign:
-Correction is to be added to uncorrected depths to yield a corrected
-depth.</dd>
-<dt><strong>igrf</strong></dt>
-<dd>International geomagnetic reference field (total field) (in nTesla).</dd>
-<dt><strong>ngrav</strong></dt>
-<dd>International Gravity reference Field (“normal gravity”) (in mGal).
-Field is selected based on the parameter Gravity Theoretical Formula
-Code in the cruise’s MGD77 header. If this is not set or is invalid
-we default to the IGF 1980. Alternatively, specify the field
-directly using <strong>-Af</strong> (see that option for more details).</dd>
-<dt><strong>ceot</strong></dt>
-<dd>Calculated Eotvos correction from navigation, using E =
-7.5038 * V * cos(lat) * sin(az) + 0.004154 * V^2
-(in mGal). Sign: Correction is to be added to uncorrected faa to
-yield a corrected faa.</dd>
-</dl>
-<p>The following short-hand flags are also recognized:</p>
-<dl class="docutils">
-<dt><strong>mgd77</strong></dt>
-<dd>This results in all 27 MGD77 fields being written out in the offical MGD77 order.</dd>
-<dt><strong>mgd77t</strong></dt>
-<dd>The full set of all 26 columns in the MGD77T specification.</dd>
-<dt><strong>geo</strong></dt>
-<dd>This limits the output to 10 fields (<strong>time</strong>, <strong>lon</strong>, <strong>lat</strong> plus
-the seven geophysical observations <strong>twt</strong>, <strong>depth</strong>, <strong>mtf1</strong>,
-<strong>mtf2</strong>, <strong>mag</strong>, <strong>gobs</strong>, and <strong>faa</strong>). By appending <strong>+</strong> to
-either of these set we will also append <strong>dist</strong>, <strong>azim</strong>, <strong>cc</strong>,
-<strong>vel</strong>, and <strong>weight</strong> as listed above.</dd>
-<dt><strong>all</strong></dt>
-<dd>This returns all data columns in the file.</dd>
-<dt><strong>allt</strong></dt>
-<dd>As mgd77t but with time items written as a date-time string.</dd>
-</dl>
-<p>As an option, logical tests may be added for any of the observations
-by appending ,<em>logic</em>, which is itself composed of one or more
-comma-separated instructions of the form <em>par</em><strong>OP</strong><em>value</em>,
-where <em>par</em> is one of the parameters listed above, <strong>OP</strong> is a
-logical operator (<, <=, =, !=, >=, >, |), and <em>value</em> is a
-constant used in the comparison. Floating point parameters are
-compared numerically; character parameters are compared lexically
-(after leading and trailing blanks have been removed). The bit
-comparison (|) means that at least one of the bits in <em>value</em> must
-be turned on in <em>par</em>. At least one of the tests must be true for
-the record to be output, except for tests using UPPER case
-parameters which all must be true for output to occur. Note that
-specifying a test does not imply that the corresponding column will
-be included in the output stream; it must be present in <em>columns</em>
-for that to occur. Note: some of the operators are special UNIX
-characters and you are advised to place quotes around the entire
-argument to <strong>-F</strong>.</p>
-<p class="last">Finally, for MGD77+ files you may optionally append :<em>bittests</em>
-which is : (a colon) followed by one or more comma-separated +-<em>col</em>
-terms. This compares specific bitflags only for each listed column.
-Here, + means the chosen bit must be 1 (ON) whereas - means it must
-be 0 (OFF). All bit tests given must be passed. By default, MGD77+
-files that have the special <strong>MGD77_flags</strong> column present will use
-those flags, and observations associated with ON-bits (meaning they
-are flagged as bad) will be set to NaN; append : with no trailing
-information to turn this behavior off (i.e., no bit flags will be
-consulted).</p>
-</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong>[<strong>+</strong>]<strong>c</strong>|<strong>d</strong>|<strong>f</strong>|<strong>m</strong>|<strong>t</strong><em>code</em></dt>
-<dd>By default, corrected depth (<strong>depth</strong>), magnetic residual anomaly
-(<strong>mag</strong>), free-air gravity anomaly (<strong>faa</strong>), and the derived
-quantity Carter depth correction (<strong>carter</strong>) are all output as is
-(if selected in <strong>-F</strong>); this option adjusts that behavior. For each
-of these columns there are 2-4 ways to adjust the data. Append
-<strong>c</strong>(arter), <strong>d</strong>(epth), <strong>f</strong>(aa), or <strong>m</strong>(ag) and
-select the <em>code</em> for the procedure you want applied. You may select
-more than one procedure for a data column by summing their numerical
-<em>code</em>s (1, 2, 4, and 8). E.g., <strong>-Ac</strong>3 will first try method
-<strong>-Ac</strong>1 to estimate a Carter correction but if <strong>depth</strong> is NaN
-we will next try <strong>-Ac</strong>2 which only uses <strong>twt</strong>. In all cases,
-if any of the values required by an adjustment procedure is NaN then
-the result will be NaN. This is also true if the original anomaly is
-NaN. Specify <strong>-A+</strong> to recalculate anomalies even if the anomaly in
-the file is NaN. Additionally, you can use <strong>-At</strong> to create fake
-times for cruises that has no time; these are based on distances and
-cruise duration.</dd>
-<dt><strong>-Ac</strong></dt>
-<dd><p class="first">Determines how the <strong>carter</strong> correction term is calculated. Below,
-C(<strong>twt</strong>) stands for the Carter-corrected depth (it also depends
-on <strong>lon</strong>, <strong>lat</strong>), U(<strong>twt</strong>, <em>v</em>) is the uncorrected depth (=
-<strong>twt</strong> * <em>v</em> / 2) using as <em>v</em> the “Assumed Sound Velocity”
-parameter in the MGD77 header (if it is a valid velocity, otherwise
-we default to 1500 m/s); alternatively, append your preferred
-velocity <em>v</em> in m/s, TU(<strong>depth</strong>, <em>v</em>) is the 2-way travel time
-estimated from the (presumably) uncorrected <strong>depth</strong>, and
-TC(<strong>depth</strong>) is the 2-way travel time obtained by inverting the
-(presumably) corrected <strong>depth</strong> using the Carter correction
-formula. Select from</p>
-<p><strong>-Ac1</strong>[,<em>v</em>] returns difference between U(<strong>twt</strong>, <em>v</em>) and <strong>depth</strong> [Default].</p>
-<p><strong>-Ac2</strong>[,<em>v</em>] returns difference between U(<strong>twt</strong>, <em>v</em>) and Carter (<strong>twt</strong>).</p>
-<p><strong>-Ac4</strong>[,<em>v</em>] returns difference between (assumed uncorrected) <strong>depth</strong> and Carter (TU(<strong>depth</strong>)).</p>
-<p class="last"><strong>-Ac8</strong>[,<em>v</em>] returns difference between U(TC(<strong>depth</strong>), <em>v</em>) and <strong>depth</strong>.</p>
-</dd>
-<dt><strong>-Ad</strong></dt>
-<dd><p class="first">Determines how the <strong>depth</strong> column output is obtained:</p>
-<p><strong>-Ad1</strong> returns <strong>depth</strong> as stored in the data set [Default].</p>
-<p><strong>-Ad2</strong>[,<em>v</em>] returns calculated uncorrected depth U(<strong>twt</strong>, <em>v</em>).</p>
-<p class="last"><strong>-Ad4</strong> returns calculated corrected depth C(<strong>twt</strong>).</p>
-</dd>
-<dt><strong>-Af</strong></dt>
-<dd><p class="first">Determines how the <strong>faa</strong> column output is obtained. If <strong>ngrav</strong>
-(i.e., the International Gravity reference Field (IGF), or “normal
-gravity”) is required it is selected based on the MGD77 header
-parameter “Theoretical Gravity Formula Code”; if this code is not
-present or is invalid we default to 4. Alternatively, append the
-preferred <em>field</em> (1-4) to select 1 (Heiskanen 1924), 2 (IGF 1930),
-3 (IGF 1967) or 4 (IGF 1980). Select from</p>
-<p><strong>-Af1</strong>[,<em>field</em>] returns <strong>faa</strong> as stored in the data set
-[Default]. Optionally, sets the IGF <em>field</em> to use if you also have
-requested <strong>ngrav</strong> as an output column in <strong>-F</strong>.</p>
-<p><strong>-Af2</strong>[,<em>field</em>] returns the difference between <strong>gobs</strong> and
-<strong>ngrav</strong> (with optional <em>field</em> directive).</p>
-<p><strong>-Af4</strong>[,<em>field</em>] returns the combination of <strong>gobs</strong> + <strong>eot</strong> -
-<strong>ngrav</strong> (with optional <em>field</em> directive).</p>
-<p class="last"><strong>-Af8</strong>[,<em>field</em>] returns the combination of <strong>gobs</strong> +
-<strong>pred_eot</strong> - <strong>ngrav</strong> (with optional <em>field</em> directive).</p>
-</dd>
-<dt><strong>-Am</strong></dt>
-<dd><p class="first">Determines how the <strong>mag</strong> column output is obtained. There may be
-one or two total field measurements in the file (<strong>mtf1</strong> and
-<strong>mtf2</strong>), and the column <strong>msens</strong> may state which one is the
-leading sensor (1 or 2; it may also be undefined). Select from</p>
-<p><strong>-Am1</strong> returns <strong>mag</strong> as stored in the data set [Default].</p>
-<p><strong>-Am2</strong> returns the difference between <strong>mgfx</strong> and <strong>igrf</strong>, where
-<strong>x</strong> is the leading sensor (<strong>1</strong> or <strong>2</strong>) indicated by the
-<strong>msens</strong> data field (defaults to <strong>1</strong> if unspecified).</p>
-<p><strong>-Am4</strong> returns the difference between <strong>mgfx</strong> and <strong>igrf</strong>, where
-<strong>x</strong> is the sensor (<strong>2</strong> or <strong>1</strong>) <em>not</em> indicated by the
-<strong>msens</strong> data field (defaults to <strong>2</strong> if unspecified).</p>
-<p class="last"><strong>-Amc<offset>[unit]</strong> Apply a correction that tries to compensate
-the fact that the magnetic field was not acquired at the same
-position as the navigation refer (ship’s position). This is
-accomplished by reinterpolating the total magnetic field to what it
-would have had if it was measured at the ship’s position (remember,
-it probably was measured <offset> meters behind). Due to this
-interpolation step, bad navigation, namely too many repeated points,
-may cause troubles. Measures are taken to minimize this effect but
-they aren’t 100% full prof. The interpolation method is controlled
-by the gmtdefaults GMT_INTERPOLANT. Append <strong>e</strong> for meter, <strong>f</strong>
-for feet, <strong>k</strong> for km, <strong>m</strong> for miles, <strong>n</strong> for nautical miles,
-or <strong>u</strong> for survey feet [Default is e (meters)].</p>
-</dd>
-<dt><strong>-C</strong><strong>f</strong>|<strong>g</strong>|<strong>e</strong></dt>
-<dd><p class="first">Append a one-letter code to select the procedure for along-track
-distance calculation (see <strong>-N</strong> for selecting units):</p>
-<p><strong>f</strong> Flat Earth distances.</p>
-<p><strong>g</strong> Great circle distances [Default].</p>
-<p class="last"><strong>e</strong> Geodesic distances on current GMT ellipsoid.</p>
-</dd>
-<dt><strong>-Da</strong><em>startdate</em></dt>
-<dd>Do not list data collected before <em>startdate</em>
-(yyyy-mm-ddBD(T)[hh:mm:ss]) [Default is start of cruise]. Use
-<strong>-DA</strong> to exclude records whose time is undefined (i.e., NaN).
-[Default reports those records].</dd>
-<dt><strong>-Db</strong><em>stopdate</em></dt>
-<dd>Do not list data collected on or after <em>stopdate</em>
-(yyyy-mm-ddBD(T)[hh:mm:ss]). [Default is end of cruise]. Use <strong>-DB</strong>
-to exclude records whose time is undefined (i.e., NaN). [Default
-reports those records].</dd>
-<dt><strong>-E</strong></dt>
-<dd>Exact match: Only output records that match all the requested
-geophysical columns [Default outputs records that matches at least
-one of the observed columns].</dd>
-<dt><strong>-Ga</strong><em>startrec</em></dt>
-<dd>Do not list records before <em>startrec</em> [Default is 0, the first
-record].</dd>
-<dt><strong>-Gb</strong><em>stoprec</em></dt>
-<dd>Do not list data after <em>stoprec</em>. [Default is the last record].</dd>
-<dt><strong>-I</strong><em>ignore</em></dt>
-<dd>Ignore certain data file formats from consideration. Append
-<strong>a|c|t</strong> to ignore MGD77 ASCII, MGD77+ netCDF, or plain
-tab-separated ASCII table files, respectively. The option may be
-repeated to ignore more than one format. [Default ignores none].</dd>
-<dt><strong>-L</strong>[<em>corrtable</em>]</dt>
-<dd>Apply optimal corrections to columns where such corrections are
-available. Append the correction table to use [Default uses the
-correction table mgd77_corrections.txt in the <strong>$MGD77_HOME</strong>
-directory]. For the format of this file, see CORRECTIONS below.</dd>
-<dt><strong>-n</strong></dt>
-<dd>Issue a segment header record with cruise ID for each cruise.</dd>
-<dt><strong>-Nd</strong>|<strong>s</strong><em>unit</em></dt>
-<dd>Append <strong>d</strong> for distance or <strong>s</strong> for speed, then give the desired
-<em>unit</em> as <strong>e</strong> (meter or m/s), <strong>f</strong> (feet or feet/s), <strong>k</strong> (km or
-km/hr), <strong>m</strong> (miles or miles/hr), <strong>n</strong> (nautical miles or knots),
-or <strong>u</strong> (survey feet or sfeet/s). [Default is <strong>-Ndk</strong> <strong>-Nse</strong> (km
-and m/s)].</dd>
-<dt><strong>-Qa</strong><em>min</em>/<em>max</em></dt>
-<dd>Specify an accepted range (<em>min</em>/<em>max</em>) of azimuths. Records whose
-track azimuth falls outside this range are ignored [0/360].</dd>
-<dt><strong>-Qc</strong><em>min</em>/<em>max</em></dt>
-<dd>Specify an accepted range (<em>min</em>/<em>max</em>) of course changes. Records
-whose track course change falls outside this range are ignored
-[-360/+360]. Use <strong>-QC</strong> to take the absolute value of the course
-change before the test [Default uses signed course changes].</dd>
-<dt><strong>-Qv</strong><em>min</em>/<em>max</em></dt>
-<dd>Specify an accepted range (<em>min</em>/<em>max</em>; or just <em>min</em> if there is no
-upper limit) of velocities. Records whose track speed falls outside
-this range are ignored [0/infinity].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]</dt>
-<dd><em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> specify the region of interest,
-and you may specify them in decimal degrees or in
-[+-]dd:mm[:ss.xxx][W|E|S|N] format. Append <strong>r</strong> if lower left
-and upper right map coordinates are given instead of w/e/s/n. The
-two shorthands <strong>-Rg</strong> and <strong>-Rd</strong> stand for global domain (0/360
-and -180/+180 in longitude respectively, with -90/+90 in latitude).
-Alternatively, specify the name of an existing grid file and the
-<strong>-R</strong> settings (and grid spacing, if applicable) are copied from
-the grid. Using <strong>-R</strong><em>unit</em> expects projected (Cartesian)
-coordinates compatible with chosen <strong>-J</strong> and we inversely project
-to determine actual rectangular geographic region.
-For perspective view (<strong>-p</strong>), optionally append /<em>zmin</em>/<em>zmax</em>.
-In case of perspective view (<strong>-p</strong>), a z-range (<em>zmin</em>, <em>zmax</em>)
-can be appended to indicate the third dimension. This needs to be
-done only when using the <strong>-Jz</strong> option, not when using only the
-<strong>-p</strong> option. In the latter case a perspective view of the plane is
-plotted, with no third dimension. </dd>
-<dt><strong>-Sa</strong><em>startdist</em>[unit]</dt>
-<dd>Do not list data that are less than <em>startdist</em> meter along track
-from port of departure. Append <strong>e</strong> for meter, <strong>f</strong> for feet,
-<strong>k</strong> for km, <strong>m</strong> for miles, <strong>n</strong> for nautical miles, or <strong>u</strong>
-for survey feet [Default is 0e (meters)].</dd>
-<dt><strong>-Sb</strong><em>stopdist</em>[unit]</dt>
-<dd>Do not list data that are <em>stopdist</em> or more meters along track from
-port of departure. Append <strong>e</strong> for meter, <strong>f</strong> for feet, <strong>k</strong> for
-km, <strong>m</strong> for miles, <strong>n</strong> for nautical miles, or <strong>u</strong> for survey
-feet [Default is end of track].</dd>
-<dt><strong>-T</strong>[<strong>m</strong>|<strong>e</strong>]</dt>
-<dd>Turns OFF the otherwise automatic adjustment of values based on
-correction terms that are stored in the MGD77+ file and used to
-counteract such things as wrong units used by the source institution
-when creating the original MGD77 file from which the MGD77+ file
-derives (the option has no effect on plain MGD77 ASCII files).
-Append <strong>m</strong> or <strong>e</strong> to limit the option to the MGD77 or extended
-columns set only [Default applies to both].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong><em>weight</em></dt>
-<dd>Set the weight for these data. Weight output option must be set in
-<strong>-F</strong>. This is useful if the data are to be processed with the
-weighted averaging techniques offered by <strong>blockmean</strong>,
-<strong>blockmedian</strong>, and <strong>blockmode</strong> [1].</dd>
-<dt><strong>-Z</strong><em>+</em>|<strong>-</strong></dt>
-<dd>Append the sign you want for <strong>depth</strong>, <strong>carter</strong>, and <strong>msd</strong>
-values below sea level (<strong>-Z-</strong> gives negative bathymetry) [Default
-is positive down].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="../../gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. ignored if <strong>-bo</strong> is selected. Likewise,
-string-fields cannot be selected. Note that if time is one of the
-binary output columns it will be stored as Unix-time (seconds since
-1970). To read this information in GMT to obtain absolute calendar
-time will require you to use <strong>-</strong><strong>-TIME_SYSTEM=1</strong>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="../../gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To get a (distance, heading, gravity, bathymetry) listing from
-01010047.mgd77, starting at June 3 1971 20:45 and ending at distance =
-5000 km, use the following command:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mgd77list 01010047 -Da1971-06-03T20:45 -Sb5000 -Fdist,azim,faa,depth > myfile.d
-</pre></div>
-</div>
-</div></blockquote>
-<p>To make input for <strong>blockmean</strong> and <strong>surface</strong> using free-air anomalies
-from all the cruises listed in the file cruises.lis, but only the data
-that are inside the specified area, and make the output binary:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mgd77list `cat cruises.lis` -Flon,lat,faa -R-40/-30/25/35 -bo > allgrav.b
-</pre></div>
-</div>
-</div></blockquote>
-<p>To extract the locations of depths exceeding 9000 meter that were not
-interpolated (<strong>btc</strong> != 1) from all the cruises listed in the file
-cruises.lis:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mgd77list ‘cat cruises.lis‘ -F"depth,DEPTH>9000,BTC!=1" > really_deep.d
-</pre></div>
-</div>
-</div></blockquote>
-<p>To extract dist, faa, and grav12_2 from records whose depths are
-shallower than 3 km and where none of the requested fields are NaN, from
-all the MGD77+ netCDF files whose cruise ids are listed in the file
-cruises.lis, we try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mgd77list ‘cat cruises.lis‘ -E -Ia -F"dist,faa,grav12_2,depth<3000" > \
- shallow_grav.d
-</pre></div>
-</div>
-</div></blockquote>
-<p>To extract dist, faa, and grav12_2 from all the MGD77+ netCDF files
-whose cruise ids are listed in the file cruises.lis, but only retrieve
-records whose bitflag for faa indicates BAD values, we try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mgd77list ‘cat cruises.lis‘ -E -Ia -F"dist,faa,grav12_2:+faa" > bad_grav.d
-</pre></div>
-</div>
-</div></blockquote>
-<p>To output lon, lat, mag, and faa from all the cruises listed in the file
-cruises.lis, but recalculate the two residuals based on the latest
-reference fields, try:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mgd77list ‘cat cruises.lis‘ -Flon,lat,mag,faa -Af2,4 -Am2 > data.d
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="recalculated-anomalies">
-<h2>Recalculated Anomalies<a class="headerlink" href="#recalculated-anomalies" title="Permalink to this headline">¶</a></h2>
-<p>When recalculated anomalies are requested (either explicitly via the
-<strong>-A</strong> option or implicitly via E77 metadata in the MGD77+ file) we only
-do so for the records whose original anomaly was not a NaN. This
-restriction is implemented since many anomaly columns contains
-corrections, usually in the form of hand-edited changes, that cannot be
-duplicated from the corresponding observation.</p>
-</div>
-<div class="section" id="igrf">
-<h2>Igrf<a class="headerlink" href="#igrf" title="Permalink to this headline">¶</a></h2>
-<p>The IGRF calculations are based on a Fortran program written by Susan
-Macmillan, British Geological Survey, translated to C via f2c by Joaquim
-Luis, U Algarve, and adapted to GMT-style by Paul Wessel.</p>
-</div>
-<div class="section" id="igf">
-<h2>Igf<a class="headerlink" href="#igf" title="Permalink to this headline">¶</a></h2>
-<p>The equations used are reproduced here using coefficients extracted
-directly from the source code (let us know if you find errors):</p>
-<p>(1) g = 978052.0 * [1 + 0.005285 * sin^2(lat) - 7e-6 * sin^2(2*lat)
-+ 27e-6 * cos^2(lat) * cos^2(lon-18)]</p>
-<p>(2) g = 978049.0 * [1 + 0.0052884 * sin^2(lat) - 0.0000059 *
-sin^2(2*lat)]</p>
-<p>(3) g = 978031.846 * [1 + 0.0053024 * sin^2(lat) - 0.0000058 *
-sin^2(2*lat)]</p>
-<p>(4) g = 978032.67714 * [(1 + 0.00193185138639 * sin^2(lat)) / sqrt (1
-- 0.00669437999013 * sin^2(lat))]</p>
-</div>
-<div class="section" id="corrections">
-<h2>Corrections<a class="headerlink" href="#corrections" title="Permalink to this headline">¶</a></h2>
-<p>The correction table is an ASCII file with coefficients and parameters
-needed to carry out corrections. Comment records beginning with # are
-allowed. All correction records are of the form</p>
-<p><em>cruiseID observation correction</em></p>
-<p>where <em>cruiseID</em> is a NGDC prefix, <em>observation</em> is one of the
-abbreviations for geophysical observations listed under <strong>-F</strong> above,
-and <em>correction</em> consists of one or more <em>term</em>s that will be summed
-up and then <strong>subtracted</strong> from the observation before output. Each
-<em>term</em> must have this exact syntax:</p>
-<p><em>factor</em>[*[<em>function</em>]([<em>scale</em>](<em>abbrev</em>[-<em>origin</em>]))[^<em>power</em>]]</p>
-<p>where terms in brackets are optional (the brackets themselves are not
-used but regular parentheses must be used as indicated). No spaces are
-allowed except between <em>term</em>s. The <em>factor</em> is the amplitude of the
-basis function, while the optional <em>function</em> can be one of sin, cos, or
-exp. The optional <em>scale</em> and <em>origin</em> can be used to translate the
-argument (before giving it to the optional function). The argument
-<em>abbrev</em> is one of the abbreviations for observations listed above. If
-<em>origin</em> is given as <strong>T</strong> it means that we should replace it with the
-value of <em>abbrev</em> for the very first record in the file (this is usually
-only done for <em>time</em>). If the first record entry is NaN we revert
-<em>origin</em> to zero. Optionally, raise the entire expression to the given
-<em>power</em>, before multiplying by the amplitude. The following is an
-example of fictitious corrections to the cruise 99999999, implying the
-<strong>depth</strong> should have the Carter correction removed, <strong>faa</strong> should have
-a linear trend removed, the magnetic anomaly (<strong>mag</strong>) should be
-corrected by a strange dependency on ship heading and latitude, and
-<strong>gob</strong>s needs to have 10 mGal added (hence given as -10):</p>
-<p>99999999 depth 1.0*((carter))</p>
-<p>99999999 faa 14.1 1e-5*((time-T))</p>
-<p>99999999 mag 0.5*cos(0.5*(azim-19))^2 1.0*exp(-1e-3(lat))^1.5</p>
-<p>99999999 gobs -10</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="mgd77convert.html"><em>mgd77convert</em></a>,
-<a class="reference internal" href="mgd77info.html"><em>mgd77info</em></a>,
-<a class="reference internal" href="mgd77manage.html"><em>mgd77manage</em></a>,
-<a class="reference internal" href="mgd77track.html"><em>mgd77track</em></a></p>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>The Marine Geophysical Data Exchange Format - MGD77, see
-<a class="reference external" href="http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt">http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt</a></p>
-<p>IGRF, see <a class="reference external" href="http://www.ngdc.noaa.gov/IAGA/vmod/igrf/">http://www.ngdc.noaa.gov/IAGA/vmod/igrf/</a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">mgd77list</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#recalculated-anomalies">Recalculated Anomalies</a></li>
-<li><a class="reference internal" href="#igrf">Igrf</a></li>
-<li><a class="reference internal" href="#igf">Igf</a></li>
-<li><a class="reference internal" href="#corrections">Corrections</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="mgd77info.html"
- title="previous chapter">mgd77info</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="mgd77magref.html"
- title="next chapter">mgd77magref</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/mgd77/mgd77list.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="mgd77magref.html" title="mgd77magref"
- >next</a> </li>
- <li class="right" >
- <a href="mgd77info.html" title="mgd77info"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_MGD77.html" >MGD77</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/mgd77/mgd77magref.html b/doc_release/html/supplements/mgd77/mgd77magref.html
deleted file mode 100644
index 8238f87..0000000
--- a/doc_release/html/supplements/mgd77/mgd77magref.html
+++ /dev/null
@@ -1,360 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>mgd77magref — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="MGD77" href="../../SUP_MGD77.html" />
- <link rel="next" title="mgd77manage" href="mgd77manage.html" />
- <link rel="prev" title="mgd77list" href="mgd77list.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="mgd77manage.html" title="mgd77manage"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="mgd77list.html" title="mgd77list"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_MGD77.html" accesskey="U">MGD77</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="mgd77magref">
-<span id="index-0"></span><h1>mgd77magref<a class="headerlink" href="#mgd77magref" title="Permalink to this headline">¶</a></h1>
-<p>mgd77magref - Evaluate the IGRF or CM4 magnetic field models</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>mgd77magref</strong> [ <em>inputfile</em> ]
-[ <strong>-A</strong>[<strong>+a</strong><em>alt</em><strong>+t</strong><em>date</em><strong>+y</strong>] ] [ <strong>-C</strong><em>cm4file</em> ]
-[ <strong>-D</strong><em>Dstfile</em> ] [ <strong>-E</strong><em>f107file</em> ] [ <strong>-F</strong><em>flags</em> ]
-[ <strong>-G</strong> ] [ <strong>-Sc</strong>|<strong>l</strong><em>low/high</em> ] [ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-b</strong>[<strong>i</strong>|<strong>o</strong>][<em>ncol</em>][<strong>type</strong>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>mgd77magref</strong> will evaluate the IGRF or the CM4 geomagnetic models at
-the specified locations and times.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<p>None.</p>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>inputfile</em></dt>
-<dd>Contains the moments in space-time where we want to evaluate the
-magnetic reference field. The first two columns must contain
-longitude and latitude (however, see <strong>-:</strong> for latitude and
-longitude instead). Normally, the third and fourth columns must
-contain altitude (in km) and time, respectively, but if one or both
-of these are constant for all records they can be supplied via the
-<strong>-A</strong> option instead and are thus not expected in the input file.
-If no input file is given we read <em>stdin</em>. <br />
-A note about the CM4
-validity domain. The core field of CM4 is valid from 1960-2002.5 but
-the ionospheric and magnetospheric fields are computed after the
-<em>Dst</em> and <em>F10.7</em> coefficient files. We extended here those
-coefficient files up to 2006, which means that one can compute
-external contributions up until 2006 but the Secular Variation will
-be biased (non reliable). New indices files may be retrieved from
-from:ftp://ftp.ngdc.noaa.gov/STP/GEOMAGNETIC_DATA/INDICES/DST/ (the
-<em>Dst</em> coefficients) and
-<a class="reference external" href="http://umbra.nascom.nasa.gov/sdb/yohkoh/ys_dbase/indices_flux_raw/Penticton_Absolute/monthly/MONTHPLT.ABS">http://umbra.nascom.nasa.gov/sdb/yohkoh/ys_dbase/indices_flux_raw/Penticton_Absolute/monthly/MONTHPLT.ABS</a>
-(The <em>F10.7</em> index file is a MONTHPLT.ABS). NOTE: since the <em>Dst</em> files
-in the .../DST/ directory are still only up to 2006, for GMT4.5.3 and after
-we extended the <em>Dst</em> until August 2009 by reformatting the data in the
-preliminary file Est_Ist_index_0_mean.pli, which is at
-<a class="reference external" href="ftp://ftp.ngdc.noaa.gov/STP/GEOMAGNETIC_DATA/INDICES/EST_IST/">ftp://ftp.ngdc.noaa.gov/STP/GEOMAGNETIC_DATA/INDICES/EST_IST/</a>. But since
-this site is now also outdated, we now get the DST indices from
-<a class="reference external" href="http://wdc.kugi.kyoto-u.ac.jp/dstae/index.html">http://wdc.kugi.kyoto-u.ac.jp/dstae/index.html</a> However, for the most recent
-dates those indices are “Quick Look” (the best are the “Definitive” type).
-Because the <em>F10.7</em> from the MONTHPLT.ABS file mentioned above are apparently
-no being updated, we found another place where they are, which is:
-<a class="reference external" href="ftp://ftp.ngdc.noaa.gov/STP/space-weather/solar-data/solar-features/">ftp://ftp.ngdc.noaa.gov/STP/space-weather/solar-data/solar-features/</a>
-solar-radio/noontime-flux/penticton/penticton_absolute/listings/
-listing_drao_noontime-flux-absolute_monthly.txt</dd>
-<dt><strong>-A</strong>[<strong>+a</strong><em>alt</em><strong>+t</strong><em>date</em><strong>+y</strong>]</dt>
-<dd>Adjusts how the input record is interpreted. Append <strong>+a</strong> to set a
-fixed <em>altitude</em> (in km) that should apply to all data records
-[Default expects <em>altitude</em> to be in the 3rd column of all records].
-Append <strong>+t</strong> to set a fixed <em>time</em> that should apply to all data
-records [Default expects <em>time</em> to be in the 4th column of all
-records]. Finally, append <strong>+y</strong> to indicate that all times are
-specified as decimal years [Default is ISO <em>date</em>T<em>colck</em> format, see
-<a class="reference internal" href="../../gmt.conf.html#time-epoch"><em>TIME_EPOCH</em></a>].</dd>
-<dt><strong>-C</strong><em>cm4file</em></dt>
-<dd>Specify an alternate CM4 coefficient file [umdl.CM4].</dd>
-<dt><strong>-D</strong><em>Dstfile</em></dt>
-<dd>Specify an alternate file with hourly means of the Dst index for CM4
-[Dst_all.wdc]. Alternatively, simply specify a single index to
-apply for all records.</dd>
-<dt><strong>-E</strong><em>f107file</em></dt>
-<dd>Specify an alternate file with monthly means of absolute F10.7 solar
-radio flux for CM4 [F107_mon.plt]. Alternatively, simply specify a
-single flux to apply for all records.</dd>
-<dt><strong>-F</strong><em>flags</em></dt>
-<dd><p class="first">Selects output items; <em>flags</em> is a string made up of one or more of
-these characters:</p>
-<p><strong>r</strong> means output all input columns before adding the items below</p>
-<p><strong>t</strong> means list total field (nT).</p>
-<p><strong>h</strong> means list horizontal field (nT).</p>
-<p><strong>x</strong> means list X component (nT, positive north).</p>
-<p><strong>y</strong> means list Y component (nT, positive east).</p>
-<p><strong>z</strong> means list Z component (nT, positive down).</p>
-<p><strong>d</strong> means list declination (deg, clockwise from north).</p>
-<p><strong>i</strong> means list inclination (deg, positive down).</p>
-<p>Append one or more number to indicate the requested field contribution(s):</p>
-<p><strong>0</strong> means IGRF field (no combinations allowed)</p>
-<p><strong>1</strong> means CM4 Core field</p>
-<p><strong>2</strong> means CM4 Lithospheric field</p>
-<p><strong>3</strong> means CM4 Primary Magnetospheric field</p>
-<p><strong>4</strong> means CM4 Induced Magnetospheric field</p>
-<p><strong>5</strong> means CM4 Primary ionospheric field</p>
-<p><strong>6</strong> means CM4 Induced ionospheric field</p>
-<p><strong>7</strong> means CM4 Toroidal field</p>
-<p><strong>9</strong> means Core field from IGRF and other contributions from CM4.
-DO NOT USE BOTH 0 AND 9.</p>
-<p class="last">Appending several numbers (1-7) will add up the different
-contributions. For example <strong>-Ft</strong>/<strong>12</strong> computes the total field
-due to Core and Lithospheric sources. Two special cases are allowed,
-which mix which Core field from IGRF and other sources from CM4.
-<strong>-Ft</strong>/<strong>934</strong> computes Core field due to IGRF plus terms 3 and 4
-from CM4 (but you can add others). <strong>-Ft</strong>/<strong>934</strong> the same as above
-but output the field components. The data is written out in the
-order they appear in <em>flags</em> [Default is <strong>-Frthxyzdi</strong>/<strong>1</strong>].</p>
-</dd>
-<dt><strong>-G</strong></dt>
-<dd>Specifies that coordinates are geocentric [geodetic].</dd>
-<dt><strong>-L</strong></dt>
-<dd><p class="first">Computes J field vectors from certain external sources.</p>
-<p><strong>r</strong> means output all input columns before adding the items below (all in Ampers/m).</p>
-<p><strong>t</strong> means list magnitude field.</p>
-<p><strong>x</strong> means list X component.</p>
-<p><strong>y</strong> means list Y component.</p>
-<p><strong>z</strong> means list Z or current function Psi.</p>
-<p>Append a number to indicate the requested J contribution:</p>
-<p><strong>1</strong> means Induced Magnetospheric field.</p>
-<p><strong>2</strong> means Primary ionospheric field.</p>
-<p><strong>3</strong> means Induced ionospheric field.</p>
-<p class="last"><strong>4</strong> means Poloidal field.</p>
-</dd>
-<dt><strong>-Sc</strong><em>low/high</em></dt>
-<dd>Limits the wavelengths of the core field contribution to the band
-indicated by the low and high spherical harmonic order [1/13].</dd>
-<dt><strong>-Sl</strong><em>low/high</em></dt>
-<dd>Limits the wavelengths of the lithosphere field contribution to the
-band indicated by the low and high spherical harmonic order [14/65].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="../../gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 4 input columns unless <strong>-A</strong> is used].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="../../gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. [Default is reflected by <strong>-F</strong>].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="../../gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="../../gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="time-settings">
-<h2>Time Settings<a class="headerlink" href="#time-settings" title="Permalink to this headline">¶</a></h2>
-<p>If binary input files are used then absolute time are stored as time
-relative to the selected epoch. However, since the epoch used is not
-stored in the data files there can be problems decoding the correct
-time. The mgd77 supplement uses the Unix time system as its default;
-thus you should make sure that binary data files with time uses the same
-system (see the GMT default TIME_SYSTEM).</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To get the CM4 Total field, Declination and Inclination due to all but
-lithospheric and toroidal field at a one point location and decimal time
-2000.0, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>echo -28 38 0 2000.0 | gmt mgd77magref -A+y -Ftdi/13456
-</pre></div>
-</div>
-</div></blockquote>
-<p>To do the same as above but at noon (Universal Time) of first May 2001, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>echo -28 38 0 2001-05-01T12:00:00 | gmt mgd77magref -Ftdi/13456
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="../../gmt.html"><em>gmt</em></a>, <a class="reference internal" href="mgd77info.html"><em>mgd77info</em></a>,
-<a class="reference internal" href="mgd77list.html"><em>mgd77list</em></a>, <a class="reference internal" href="mgd77manage.html"><em>mgd77manage</em></a>,
-<a class="reference internal" href="mgd77track.html"><em>mgd77track</em></a>, <a class="reference internal" href="../../gmt.conf.html"><em>gmt.conf</em></a></p>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>Comprehensive Modeling of the Geomagnetic Field, see
-<a class="reference external" href="http://denali.gsfc.nasa.gov/cm/">http://denali.gsfc.nasa.gov/cm/</a></p>
-<p>The International Geomagnetic Reference Field (IGRF), see
-<a class="reference external" href="http://www.iugg.org/IAGA/iaga_pages/pubs_prods/igrf.htm">http://www.iugg.org/IAGA/iaga_pages/pubs_prods/igrf.htm</a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">mgd77magref</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#time-settings">Time Settings</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="mgd77list.html"
- title="previous chapter">mgd77list</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="mgd77manage.html"
- title="next chapter">mgd77manage</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/mgd77/mgd77magref.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="mgd77manage.html" title="mgd77manage"
- >next</a> </li>
- <li class="right" >
- <a href="mgd77list.html" title="mgd77list"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_MGD77.html" >MGD77</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/mgd77/mgd77manage.html b/doc_release/html/supplements/mgd77/mgd77manage.html
deleted file mode 100644
index d2eeb7e..0000000
--- a/doc_release/html/supplements/mgd77/mgd77manage.html
+++ /dev/null
@@ -1,552 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>mgd77manage — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="MGD77" href="../../SUP_MGD77.html" />
- <link rel="next" title="mgd77path" href="mgd77path.html" />
- <link rel="prev" title="mgd77magref" href="mgd77magref.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="mgd77path.html" title="mgd77path"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="mgd77magref.html" title="mgd77magref"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_MGD77.html" accesskey="U">MGD77</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="mgd77manage">
-<span id="index-0"></span><h1>mgd77manage<a class="headerlink" href="#mgd77manage" title="Permalink to this headline">¶</a></h1>
-<p>mgd77manage - Manage the content of MGD77+ files</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>mgd77manage</strong> <em>NGDC-ids</em>
-[ <strong>-A</strong>[<strong>+</strong>]<strong>a</strong>|<strong>c</strong>|<strong>d</strong>|<strong>D</strong>|<strong>e</strong>|<strong>E</strong>|<strong>g</strong>|<strong>i</strong>|<strong>n</strong>|<strong>t</strong>|<strong>T</strong><em>fileinfo</em> ]
-[ <strong>-C</strong><strong>f</strong>|<strong>g</strong>|<strong>e</strong> ]
-[ <strong>-D</strong><em>abbrev1</em>,<em>abbrev2</em>,...) ] [ <strong>-E</strong><em>empty</em> ] [ <strong>-F</strong> ]
-[ <strong>-I</strong><em>abbrev</em>/<em>name</em>/<em>unit</em>/<strong>t</strong>/<em>scale</em>/<em>offset</em>/<em>comment</em> ]
-[ <strong>-N</strong><em>unit</em> ]
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-bi</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-n</strong>[<strong>b</strong>|<strong>c</strong>|<strong>l</strong>|<strong>n</strong>][<strong>+a</strong>][<strong>+b</strong><em>BC</em>][<strong>+t</strong><em>threshold</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>mgd77manage</strong> deals with maintaining extra custom columns in MGD77+
-netCDF files. You can either delete one or more columns, add a new
-column, update an existing column with new data, or supply error
-correction information (*.e77 files). New data may come from a table
-(ASCII unless <strong>-bi</strong> is used), be based on
-existing columns and certain theoretical expressions, or they may be
-obtained by sampling a grid (choose between GMT grid or a Sandwell/Smith
-Mercator *.img grid) along track. The new data will be appended to the
-MGD77+ file in the form of an extra data column of specified type. The
-data file will be modified; no new file will be created. For the big
-issues, see the DISCUSSION section below.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>NGDC-ids</em></dt>
-<dd><p class="first">Can be one or more of five kinds of specifiers:</p>
-<ol class="arabic simple">
-<li>8-character NGDC IDs, e.g., 01010083, JA010010etc., etc.</li>
-<li>2-character <agency> codes which will return all cruises from each agency.</li>
-<li>4-character <agency><vessel> codes, which will return all cruises from those vessels.</li>
-<li>=<list>, where <list> is a table with NGDC IDs, one per line.</li>
-<li>If nothing is specified we return all cruises in the data base.</li>
-</ol>
-<p class="last">(See mgd77info <strong>-L</strong> for agency and vessel codes). The ”.mgd77” or
-”.nc” extensions will automatically be appended, if needed (use
-<strong>-I</strong> to ignore certain file types). Cruise files will be looked
-for first in the current directory and second in all directories
-listed in <strong>$MGD77_HOME</strong>/mgd77_paths.txt [If <strong>$MGD77_HOME</strong> is
-not set it will default to <strong>$GMT_SHAREDIR</strong>/mgd77].</p>
-</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong>[<strong>+</strong>]<strong>a</strong>|<strong>c</strong>|<strong>d</strong>|<strong>D</strong>|<strong>e</strong>|<strong>E</strong>|<strong>g</strong>|<strong>i</strong>|<strong>n</strong>|<strong>t</strong>|<strong>T</strong><em>fileinfo</em></dt>
-<dd><p class="first">Add a new data column. If an existing column with the same
-abbreviation already exists in the file we will cowardly refuse to
-update the file. Specifying <strong>-A+</strong> overcomes this reluctance
-(However, sometimes an existing column cannot be upgraded without
-first deleting it; if so you will be warned). Select a column source
-code among <strong>a</strong>, <strong>c</strong>, <strong>d</strong>, <strong>D</strong>, <strong>e</strong>, <strong>g</strong>, <strong>i</strong>, <strong>n</strong>,
-<strong>t</strong>, or <strong>T</strong>; detailed descriptions for each choice follow:</p>
-<p><strong>a</strong> Append filename of a single column table to add. File must
-have the same number of rows as the MGD77+ file. If no file is given
-we read from stdin instead.</p>
-<p><strong>c</strong> Create a new column that derives from existing data or
-formulas for corrections and reference fields. Append <strong>c</strong> for the
-Carter corrections subtracted from uncorrected depths, <strong>g</strong> for the
-IGF gravity reference field (a.k.a “normal gravity”), <strong>m</strong> for the
-IGRF total field magnetic reference field, and <strong>r</strong> for recomputed
-magnetic anomaly (append 1 or 2 to specify which total field column
-to use [1]). For gravity we choose the reference field based on the
-parameter Gravity Theoretical Formula Code in the cruise’s MGD77
-header. If this is not set or is invalid we default to the IGF 1980.
-You can override this behaviour by appending the desired code: 1 =
-Heiskanen 1924, 2 = International 1930, 3 = IGF1967, or 4 = IGF1980.</p>
-<p><strong>d</strong> Append filename of a two-column table with the first column
-holding distances along track and the second column holding data
-values. If no file is given we read from stdin instead. Records with
-matching distances in the MGD77+ file will be assigned the new
-values; at other distances we set them to NaN. Alternatively, give
-upper case <strong>D</strong> instead and we will interpolate the column at all
-record distances. See <strong>-N</strong> for choosing distance units and <strong>-C</strong>
-for choosing how distances are calculated.</p>
-<p><strong>e</strong> Expects to find an e77 error/correction log from
-<strong>mgd77sniffer</strong> with the name <em>NGDC_ID</em>.e77 in the current
-directory or in $MGD77_HOME/E77; this file will examined and used
-to make modifications to the header values, specify a systematic
-correction for certain columns (such as scale and offset), specify
-that a certain anomaly should be recalculated from the observations
-(e.g., recalculate mag from mtf1 and the latest IGRF), and add or
-update the special column <strong>flag</strong> which may hold bitflags (0 =
-GOOD, 1 = BAD) for each data field in the standard MGD77 data set.
-Any fixed correction terms found (such as needing to scale a field
-by 0.1 or 10 because the source agency used incorrect units) will be
-written as attributes to the netCDF MGD77+ file and applied when the
-data are read by <strong>mgd77list</strong>. Ephemeral corrections such as those
-determined by crossover analysis are not kept in the data files but
-reside in correction tables (see <strong>mgd77list</strong> for details). By
-default, the first character of each header line in the e77 file
-(which is ?, Y or N) will be consulted to see if the corresponding
-adjustment should be applied. If any undecided settings are found
-(i.i, ?) we will abort and make no changes. Only records marked Y
-will be processed. You can override this behavior by appending one
-or more modifiers to the <strong>-Ae</strong> command: <strong>h</strong> will ignore all
-header corrections, <strong>f</strong> will ignore all fixed systematic trend
-corrections, <strong>n</strong>, <strong>v</strong>, and <strong>s</strong> will ignore bitflags pertaining
-to navigation, data values, and data slopes, respectively. Use
-<strong>-A+e</strong> to replace any existing E77 corrections in the file with
-the new values. Finally, e77 corrections will not be applied if the
-E77 file has not been verified. Use <strong>-AE</strong> to ignore the
-verification status.</p>
-<p><strong>g</strong> Sample a GMT geographic (lon, lat) grid along the track given
-by the MGD77+ file using bicubic interpolation (however, see
-<strong>-n</strong>). Append name of a GMT grid file.</p>
-<p><strong>i</strong> Sample a Sandwell/Smith Mercator *.img grid along the track
-given by the MGD77+ file using bicubic interpolation (however, see
-<strong>-n</strong>). Append the img grid filename, followed by the
-comma-separated data scale (typically 1 or 0.1), the IMG file mode
-(0-3), and optionally the img grid max latitude [80.738]. The modes
-stand for the following: (0) Img files with no constraint code,
-returns data at all points, (1) Img file with constraints coded,
-return data at all points, (2) Img file with constraints coded,
-return data only at constrained points and NaN elsewhere, and
-(3) Img file with constraints coded, return 1 at constraints and 0 elsewhere.</p>
-<p><strong>n</strong> Append filename of a two-column table with the first column
-holding the record number (0 to nrows - 1) and the second column
-holding data values. If no file is given we read from stdin instead.
-Records with matching record numbers in the MGD77+ file will be
-assigned the new values; at other records we set them to NaN.</p>
-<p class="last"><strong>t</strong> Append filename of a two-column table with the first column
-holding absolute times along track and the second column holding
-data values. If no file is given we read from stdin instead. Records
-with matching times in the MGD77+ file will be assigned the new
-values; at other times we set them to NaN. Alternatively, give upper
-case <strong>T</strong> instead and we will interpolate the column at all record
-times.</p>
-</dd>
-<dt><strong>-C</strong><strong>f</strong>|<strong>g</strong>|<strong>e</strong></dt>
-<dd><p class="first">Append a one-letter code to select the procedure for along-track
-distance calculation when using <strong>-Ad</strong>|<strong>D</strong> (see <strong>-N</strong> for
-selecting distance units):</p>
-<p><strong>f</strong> Flat Earth distances.</p>
-<p><strong>g</strong> Great circle distances [Default].</p>
-<p class="last"><strong>e</strong> Geodesic distances on current GMT ellipsoid.</p>
-</dd>
-<dt><strong>-D</strong><em>abbrev1</em>,<em>abbrev2</em>,...)</dt>
-<dd>Give a comma-separated list of column abbreviations that you want to
-delete from the MGD77+ files. Do NOT use this option to remove
-columns that you are replacing with new data (use <strong>-A+</strong> instead).
-Because we cannot remove variables from netCDF files we must create
-a new file without the columns to be deleted. Once the file is
-successfully created we temporarily rename the old file, change the
-new filename to the old filename, and finally remove the old,
-renamed file.</dd>
-<dt><strong>-E</strong><em>empty</em></dt>
-<dd>Give a single character that will be repeated to fill empty string
-values, e.g., “9” will yield a string like “99999...” [9].</dd>
-<dt><strong>-F</strong></dt>
-<dd>Force mode. When this mode is active you are empowered to delete or
-replace even the standard MGD77 set of columns. You better know what
-you are doing!</dd>
-<dt><strong>-I</strong><em>abbrev</em>/<em>name</em>/<em>unit</em>/<strong>t</strong>/<em>scale</em>/<em>offset</em>/<em>comment</em></dt>
-<dd>In addition to file information we must specify additional
-information about the extra column. Specify a short (16 char or
-less, using lower case letters, digits, or underscores only)
-abbreviation for the selected data, its more descriptive name, the
-data unit, the data type 1-character code (<strong>b</strong>yte, <strong>s</strong>hort,
-<strong>f</strong>loat, <strong>i</strong>nt, <strong>d</strong>ouble, or <strong>t</strong>ext) you want used
-for storage in the netCDF file, any scale and offset we should apply
-to the data to make them fit inside the range implied by the chosen
-storage type, and a general comment (< 128 characters) regarding
-what these data represent. Note: If text data type is selected then
-the terms “values” in the <strong>-A</strong> discussion refer to your text data.
-Furthermore, the discussion on interpolation does not apply and the
-NaN value becomes a “no string” value (see <strong>-E</strong> for what this is).
-Place quotes around terms with more than one word (e.g., “Corrected Depth”).</dd>
-<dt><strong>-N</strong><em>unit</em></dt>
-<dd>Append the distance unit (see UNITS). [Default is <strong>-Nk</strong> (km)].
-Only relevant when <strong>-Ag</strong>|<strong>i</strong> is selected.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="../../gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. Only relevant when <strong>-Ag</strong>|<strong>i</strong> is selected.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="../../gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. This applies to the input 1- or 2-column data files specified under some
-of the <strong>-A</strong> options. The binary input option is only available for
-numerical data columns.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-n</strong>[<strong>b</strong>|<strong>c</strong>|<strong>l</strong>|<strong>n</strong>][<strong>+a</strong>][<strong>+b</strong><em>BC</em>][<strong>+c</strong>][<strong>+t</strong><em>threshold</em>] <a class="reference internal" href="../../gmt.html#n-full"><em>(more ...)</em></a></dt>
-<dd>Select interpolation mode for grids.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc9">Units</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>For map distance unit, append <em>unit</em> <strong>d</strong> for arc degree, <strong>m</strong> for arc
-minute, and <strong>s</strong> for arc second, or <strong>e</strong> for meter [Default], <strong>f</strong>
-for foot, <strong>k</strong> for km, <strong>M</strong> for statute mile, <strong>n</strong> for nautical mile,
-and <strong>u</strong> for US survey foot. By default we compute such distances using
-a spherical approximation with great circles. Prepend <strong>-</strong> to a
-distance (or the unit is no distance is given) to perform “Flat Earth”
-calculations (quicker but less accurate) or prepend <strong>+</strong> to perform
-exact geodesic calculations (slower but more accurate).</p>
-</div>
-<div class="section" id="consequences-of-grid-resampling">
-<h2>Consequences of grid resampling<a class="headerlink" href="#consequences-of-grid-resampling" title="Permalink to this headline">¶</a></h2>
-<p>Resample or sampling of grids will use various algorithms (see <strong>-n</strong>) that may lead
-to possible distortions or unexpected results in the resampled values.
-One expected effect of resampling with splines is the tendency for the new
-resampled values to slightly exceed the global min/max limits of the original
-grid. If this is unacceptable, you can impose clipping of the resampled values
-values so they do not exceed the input min/max values by adding <strong>+c</strong> to
-your <strong>-n</strong> option.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To append Geosat/ERS-1 gravity version 11.2 as an extra data column in
-the cruises 01010047.nc and 01010008.nc, storing the values as mGal*10
-in a 2-byte short integer, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mgd77manage 01010047 01010008 -Ai10/1/grav.11.2.img \
- -Isatgrav/"Geosat/ERS-1 gravity"/"mGal"/s/10/0/"Sandwell/Smith version 11.2" -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>To append a filtered version of magnetics as an extra data column of
-type float for the cruise 01010047.nc, and interpolate the filtered data
-at the times given in the MGD77+ file, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mgd77manage 01010047 -ATmymag.tm -Ifiltmag/"Intermediate-wavelength \
- magnetic residuals"/"nTesla"/f/1/0/"Useful for looking for isochrons" -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>To delete the existing extra columns satfaa, coastdist, and satvgg from
-all MGD77+ files, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mgd77manage =allmgd77.lis -Dsatfaa,coastdist,satvgg -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>To create a 4-byte float column with the correct IGRF reference field in
-all MGD77+ files, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mgd77manage =allmgd77.lis -Acm -Iigrf/"IGRF reference \
- field"/"nTesla"/f/1/0/"IGRF version 10 for 1990-2010" -V
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="discussion">
-<h2>Discussion<a class="headerlink" href="#discussion" title="Permalink to this headline">¶</a></h2>
-<p><strong>1. Preamble</strong></p>
-<p>The mgd77 supplement is an attempt to (1) improve on the
-limited functionality of the existing mgg supplement, (2) incorporate
-some of the ideas from Scripps’ gmt+ supplement by allowing extra data
-columns, and (3) add new capabilities for managing marine
-geophysical trackline data stored in an architecture-independent CF-1.0-
-and COARDS-compliant netCDF file format. Here are some of the underlying
-ideas and steps you need to take to maintain your files.</p>
-<p><strong>2. Introduction</strong></p>
-<p>Our starting point is the MGD77 ASCII data files distributed from NGDC
-on CD-ROMS, DVD-ROMS, and via FTP. Using Geodas to install the files
-locally we choose the “Carter corrected depth” option which will fill in
-the depth column using the two-way traveltimes and the Carter tables if
-twt is present. This step yields ~5000 individual cruise files. Place
-these in one or more sub-directories of your choice, list these
-sub-directories (one per line) in the file mgd77_paths.txt, and place
-that file in the directory pointed to by <strong>$MGD77_HOME</strong>; if not set
-this variable defaults to <strong>$GMT_SHAREDIR</strong>/mgd77.</p>
-<p><strong>3. Conversion</strong></p>
-<p>Convert the ASCII MGD77 files to the new netCDF MGD77+ format using
-<strong>mgd77convert</strong>. Typically, you will make a list of all the cruises to
-be converted (with or without extension), and you then run</p>
-<blockquote>
-<div>mgd77convert =cruises.lis -Fa -Tc -V -Lwe+ > log.txt</div></blockquote>
-<p>The verbose settings will ensure that all problems found during
-conversion will be reported. The new *.nc files may also be placed in
-one or more separate sub-directories and these should also be listed in
-the mgd77_paths.txt file. We suggest you place the directories with
-*.nc files ahead of the *.mgd77 directories. When you later want to
-limit a search to files of a certain extension you should use the <strong>-I</strong>
-option.</p>
-<p><strong>4. Adding new columns</strong></p>
-<p><strong>mgd77manage</strong> will allow you to add additional data columns to your
-*.nc files. These can be anything, including text strings, but most
-likely are numerical values sampled along the track from a supplied grid
-or an existing column that have been filtered or manipulated for a
-particular purpose. The format supports up to 32 such extra columns. See
-this man page for how to add columns. You may later decide to remove
-some of these columns or update the data associated with a certain
-column. Data extraction tools such as <a class="reference internal" href="mgd77list.html"><em>mgd77list</em></a> can be used to
-extract a mix of standard MGD77 columns (navigation, time, and the usual
-geophysical observations) and your custom columns.</p>
-<p><strong>5. Error sources</strong></p>
-<p>Before we discuss how to correct errors we will first list the different
-classes of errors associated with MGD77 data: (1) Header record errors
-occur when some of the information fields in the header do not comply
-with the MGD77 specification or required information is missing.
-<strong>mgd77convert</strong> will list these errors when the extended verbose
-setting is selected. These errors typically do not affect the data and
-are instead errors in the <em>meta-data</em> (2). Fixed
-systematic errors occur when a particular data column, despite the MGD77
-specification, has been encoded incorrectly. This usually means the data
-will be off by a constant factor such as 10 or 0.1, or in some cases
-even 1.8288 which converts fathoms to meters. (3) Unknown systematic
-errors occur when the instrument that recorded the data or the
-processing that followed introduced signals that appear to be systematic
-functions of time along track, latitude, heading, or some other
-combination of terms that have a physical or logical explanation. These
-terms may sometimes be resolved by data analysis techniques such as
-along-track and across-track investigations, and will result in
-correction terms that when applied to the data will remove these
-unwanted signals in an optimal way. Because these correction terms may
-change when new data are considered in their determination, such
-corrections are considered to be ephemeral. (4) Individual data points
-or sequences of data may violate rules such as being outside of possible
-ranges or in other ways violate sanity. Furthermore, sequences of points
-that may be within valid ranges may give rise to data gradients that are
-unreasonable. The status of every point can therefore be determined and
-this gives rise to bitflags GOOD or BAD. Our policy is that error
-sources 1, 2, and 4 will be corrected by supplying the information as
-meta-data in the relevant *.nc files, whereas the corrections for error
-source 3 (because they will constantly be improved) will be maintained
-in a separate list of corrections.</p>
-<p><strong>6. Finding errors</strong></p>
-<p>The <strong>mgd77sniffer</strong> is a tool that does a thorough along-track sanity
-check of the original MGD77 ASCII files and produces a corresponding
-*.e77 error log. All problems found are encoded in the error log, and
-recommended fixed correction terms are given, if needed. An analyst may
-verify that the suggested corrections are indeed valid (we only want to
-correct truly obvious unit errors), edit these error logs and modify
-such correction terms and activate them by changing the relevant code
-key (see <strong>mgd77sniffer</strong> for more details). <strong>mgd77manage</strong> can ingest
-these error logs and (1) correct bad header records given
-the suggestions in the log, (2) insert scale/offset correction terms to
-be used when reading certain columns, and (3) insert any
-bit-flags found. Rerun this step if you later find other problems as all
-E77 settings or flags will be recreated based on the latest E77 log.</p>
-<p><strong>7. Error corrections</strong></p>
-<p>The extraction program <a class="reference internal" href="mgd77list.html"><em>mgd77list</em></a> allows for corrections to be
-applied on-the-fly when data are requested. First, data with BAD
-bitflags are suppressed. Second, data with fixed systematic correction
-terms are corrected accordingly. Third, data with ephemeral correction
-terms will have those corrections applied (if a correction table is
-supplied). All of these steps require the presence of the relevant
-meta-data and all can be overruled by the user. In addition, users may
-add their own bitflags as separate data columns and use
-<strong>mgd77list</strong>‘s logical tests to further dictate which data are
-suppressed from output.</p>
-</div>
-<div class="section" id="credits">
-<h2>Credits<a class="headerlink" href="#credits" title="Permalink to this headline">¶</a></h2>
-<p>The IGRF calculations are based on a Fortran program written by Susan
-Macmillan, British Geological Survey, translated to C via f2c by Joaquim
-Luis, and adapted to GMT style by Paul Wessel.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="mgd77convert.html"><em>mgd77convert</em></a>,
-<a class="reference internal" href="mgd77list.html"><em>mgd77list</em></a>,
-<a class="reference internal" href="mgd77info.html"><em>mgd77info</em></a>,
-<a class="reference internal" href="mgd77sniffer.html"><em>mgd77sniffer</em></a>
-<a class="reference internal" href="mgd77track.html"><em>mgd77track</em></a>
-<a class="reference internal" href="../x2sys/x2sys_init.html"><em>x2sys_init</em></a></p>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>The Marine Geophysical Data Exchange Format - MGD77, see
-<a class="reference external" href="http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt">http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt</a></p>
-<p>IGRF, see <a class="reference external" href="http://www.ngdc.noaa.gov/IAGA/vmod/igrf.html">http://www.ngdc.noaa.gov/IAGA/vmod/igrf.html</a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">mgd77manage</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#id1">Units</a></li>
-<li><a class="reference internal" href="#consequences-of-grid-resampling">Consequences of grid resampling</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#discussion">Discussion</a></li>
-<li><a class="reference internal" href="#credits">Credits</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="mgd77magref.html"
- title="previous chapter">mgd77magref</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="mgd77path.html"
- title="next chapter">mgd77path</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/mgd77/mgd77manage.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="mgd77path.html" title="mgd77path"
- >next</a> </li>
- <li class="right" >
- <a href="mgd77magref.html" title="mgd77magref"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_MGD77.html" >MGD77</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/mgd77/mgd77path.html b/doc_release/html/supplements/mgd77/mgd77path.html
deleted file mode 100644
index 6f0ebb2..0000000
--- a/doc_release/html/supplements/mgd77/mgd77path.html
+++ /dev/null
@@ -1,259 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>mgd77path — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="MGD77" href="../../SUP_MGD77.html" />
- <link rel="next" title="mgd77sniffer" href="mgd77sniffer.html" />
- <link rel="prev" title="mgd77manage" href="mgd77manage.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="mgd77sniffer.html" title="mgd77sniffer"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="mgd77manage.html" title="mgd77manage"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_MGD77.html" accesskey="U">MGD77</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="mgd77path">
-<span id="index-0"></span><h1>mgd77path<a class="headerlink" href="#mgd77path" title="Permalink to this headline">¶</a></h1>
-<p>mgd77path - Return paths to MGD77 cruises and directories</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>mgd77path</strong> <em>NGDC-ids</em> [ <strong>-A</strong>[<strong>-</strong>] ] [ <strong>-D</strong> ]
-[ <strong>-I</strong><em>ignore</em> ]
-[ <strong>-V</strong>[<em>level</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>mgd77path</strong> returns the full pathname to one or more MGD77 files. The
-pathname returned for a given cruise may change with time due to
-reshuffling of disks/subdirectories.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>NGDC-ids</em></dt>
-<dd><p class="first">Can be one or more of five kinds of specifiers:</p>
-<ol class="arabic simple">
-<li>8-character NGDC IDs, e.g., 01010083, JA010010etc., etc.</li>
-<li>2-character <agency> codes which will return all cruises from each agency.</li>
-<li>4-character <agency><vessel> codes, which will return all cruises from those vessels.</li>
-<li>=<list>, where <list> is a table with NGDC IDs, one per line.</li>
-<li>If nothing is specified we return all cruises in the data base.</li>
-</ol>
-<p class="last">(See mgd77info <strong>-L</strong> for agency and vessel codes). The ”.mgd77” or
-”.nc” extensions will automatically be appended, if needed (use
-<strong>-I</strong> to ignore certain file types). Cruise files will be looked
-for first in the current directory and second in all directories
-listed in <strong>$MGD77_HOME</strong>/mgd77_paths.txt [If <strong>$MGD77_HOME</strong> is
-not set it will default to <strong>$GMT_SHAREDIR</strong>/mgd77].</p>
-</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong>[<strong>-</strong>]</dt>
-<dd>Display the full path to each cruise [Default]. Optionally, append
-<strong>-</strong> which will list just the cruise IDs instead.</dd>
-<dt><strong>-D</strong></dt>
-<dd>Instead of cruise listings, just show the directory paths currently
-used in the search.</dd>
-<dt><strong>-I</strong><em>ignore</em></dt>
-<dd>Ignore certain data file formats from consideration. Append
-<strong>a|c|t</strong> to ignore MGD77 ASCII, MGD77+ netCDF, or plain
-tab-separated ASCII table files, respectively. The option may be
-repeated to ignore more than one format. [Default ignores none].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. Reports the total number of cruises found.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To obtain pathnames for cruises 01010008 and 01010007, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mgd77path 01010008 01010007
-</pre></div>
-</div>
-</div></blockquote>
-<p>To obtain pathnames for cruises 01010008 and 01010007, but only if there
-are MGD77+ version in netCDF, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mgd77path 01010008 01010007 -Ia -It
-</pre></div>
-</div>
-</div></blockquote>
-<p>To see the list of active directories where MGD77 files might be stored, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mgd77path -D
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="../../gmt.html"><em>gmt</em></a> <a class="reference internal" href="mgd77info.html"><em>mgd77info</em></a>
-<a class="reference internal" href="mgd77list.html"><em>mgd77list</em></a>
-<a class="reference internal" href="mgd77manage.html"><em>mgd77manage</em></a>
-<a class="reference internal" href="mgd77track.html"><em>mgd77track</em></a></p>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc8">References</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>The Marine Geophysical Data Exchange Format - MGD77, see
-<a class="reference external" href="http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt.">*http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt*.</a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">mgd77path</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-<li><a class="reference internal" href="#id1">References</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="mgd77manage.html"
- title="previous chapter">mgd77manage</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="mgd77sniffer.html"
- title="next chapter">mgd77sniffer</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/mgd77/mgd77path.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="mgd77sniffer.html" title="mgd77sniffer"
- >next</a> </li>
- <li class="right" >
- <a href="mgd77manage.html" title="mgd77manage"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_MGD77.html" >MGD77</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/mgd77/mgd77sniffer.html b/doc_release/html/supplements/mgd77/mgd77sniffer.html
deleted file mode 100644
index d17ab08..0000000
--- a/doc_release/html/supplements/mgd77/mgd77sniffer.html
+++ /dev/null
@@ -1,671 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>mgd77sniffer — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="MGD77" href="../../SUP_MGD77.html" />
- <link rel="next" title="mgd77track" href="mgd77track.html" />
- <link rel="prev" title="mgd77path" href="mgd77path.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="mgd77track.html" title="mgd77track"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="mgd77path.html" title="mgd77path"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_MGD77.html" accesskey="U">MGD77</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="mgd77sniffer">
-<span id="index-0"></span><h1>mgd77sniffer<a class="headerlink" href="#mgd77sniffer" title="Permalink to this headline">¶</a></h1>
-<p>mgd77sniffer - Along-track quality control of MGD77 cruises</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>mgd77sniffer</strong> <em>NGDC-ids</em> [ <strong>-A</strong><em>fieldabbrev</em>,<em>scale</em>,<em>offset</em> ]
-[ <strong>-C</strong><em>maxspd</em> ]
-[ <strong>-D</strong><strong>d</strong>|<strong>e</strong>|<strong>E</strong>|<strong>f</strong>|<strong>l</strong>|<strong>m</strong>|<strong>s</strong>|<strong>v</strong>[<em>r</em>] ]
-[ <strong>-G</strong><em>fieldabbrev</em>,<em>imggrid</em>,<em>scale</em>,<em>mode</em> or
-<strong>-G</strong><em>fieldabbrev</em>,<em>grid</em> ] [ <strong>-H</strong> ]
-[ <strong>-I</strong><em>fieldabbrev</em>,<em>rec1</em>,<em>recN</em> ] [ <strong>-K</strong> ]
-[ <strong>-L</strong><em>custom-limits-file</em> ] [ <strong>-N</strong> ]
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ]
-[ <strong>-S</strong><strong>d</strong>|<strong>s</strong>|<strong>t</strong> ] [ <strong>-T</strong><em>gap</em> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W</strong><strong>c</strong>|<strong>g</strong>|<strong>o</strong>|<strong>s</strong>|<strong>t</strong>|<strong>v</strong>|<strong>x</strong> ]
-[ <strong>-bo</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-n</strong>[<strong>b</strong>|<strong>c</strong>|<strong>l</strong>|<strong>n</strong>][<strong>+a</strong>][<strong>+b</strong><em>BC</em>][<strong>+t</strong><em>threshold</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>mgd77sniffer</strong> scans old (pre-Y2K) and new format ASCII MGD77 files
-for errors using point-by-point sanity checking, along-track detection
-of excessive slopes, and optional comparison of cruise data with global
-gravity and predicted bathymetry grids. Detected data problems are
-output by default as verbose descriptions of each detected error, often
-resulting in multiple messages per scanned record. Data problems are
-optionally output (<strong>-De</strong> option) using a computer-parseable format
-(see E77 ERROR FORMAT description below). Default error thresholds are
-derived from histograms of all MGD77 geophysical data collected between
-1952 and January, 2006. Thresholds are adjustable with the <strong>-L</strong>
-option.</p>
-</div>
-<div class="section" id="requirements">
-<h2>Requirements<a class="headerlink" href="#requirements" title="Permalink to this headline">¶</a></h2>
-<p>The mgd77sniffer links with Generic Mapping Tools 4.0 or later along
-with the supplemental GMT packages x2sys and mgd77. See
-<a class="reference external" href="http://gmt.soest.hawaii.edu">http://gmt.soest.hawaii.edu</a> for GMT
-details. Grids for comparison with cruise data may be downloaded via the web.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>NGDC-ids</em></dt>
-<dd><p class="first">Can be one or more of five kinds of specifiers:</p>
-<ol class="arabic simple">
-<li>8-character NGDC IDs, e.g., 01010083, JA010010etc., etc.</li>
-<li>2-character <agency> codes which will return all cruises from each agency.</li>
-<li>4-character <agency><vessel> codes, which will return all cruises from those vessels.</li>
-<li>=<list>, where <list> is a table with NGDC IDs, one per line.</li>
-<li>If nothing is specified we return all cruises in the data base.</li>
-</ol>
-<p class="last">(See mgd77info <strong>-L</strong> for agency and vessel codes). The ”.mgd77” or
-”.nc” extensions will automatically be appended, if needed (use
-<strong>-I</strong> to ignore certain file types). Cruise files will be looked
-for first in the current directory and second in all directories
-listed in <strong>$MGD77_HOME</strong>/mgd77_paths.txt [If <strong>$MGD77_HOME</strong> is
-not set it will default to <strong>$GMT_SHAREDIR</strong>/mgd77].</p>
-</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong><em>fieldabbrev</em>,<em>scale</em>,<em>offset</em></dt>
-<dd>Apply scale factor and DC adjustment to specified data field. Allows
-adjustment of cruise data prior to along-track analysis. CAUTION:
-data must be thoroughly examined before applying these global data
-adjustments. May not be used for multiple cruises.</dd>
-<dt><strong>-C</strong><em>maxspd</em></dt>
-<dd>Set maximum ship speed in m/s, or knots with <strong>-N</strong> option. Ship
-speeds exceeding 10 m/s (~20 knots) are flagged as excessive by default.</dd>
-<dt><strong>-D</strong><strong>d</strong>|<strong>e</strong>|<strong>E</strong>|<strong>f</strong>|<strong>l</strong>|<strong>m</strong>|<strong>s</strong>|<strong>v</strong>[<em>r</em>]</dt>
-<dd><p class="first">Suppress default warning output and only dump cruise data row-by-row
-such as values, gradients, grid-cruise differences, E77 error
-summaries for each record, re-created MGD77 records or sniffer
-limits. Append r to include all records (default omits records where
-navigation errors were detected).</p>
-<p><strong>-Dd</strong> output differences between cruise and grid data. Requires
-<strong>-G</strong> option. Output columns include:</p>
-<p><em>lat lon dist cruiseZ gridZ diff [cruiseZ2 gridZ2 diff2 ...]</em></p>
-<p>Note: grid values are subtracted from cruise data so a positive
-difference implies cruise > grid. For multiple grid comparison,
-<em>cruiseZ gridZ diff</em> are repeated for each grid comparison in
-command line order.</p>
-<p><strong>-De</strong> output E77 error classification format. Error output is
-divided into (1) a header containing information
-globally applicable to the cruise and (2) individual
-error records summarizing all errors encountered in each cruise
-record. mgd77sniffer writes E77 directly to <ngdc_id.e77> file
-handle. See <strong>E77 ERROR FORMAT</strong> below for additional details.</p>
-<p><strong>-DE</strong> Same as <strong>-De</strong> but no regression tests will be carried out.</p>
-<p><strong>-Df</strong> output delta Z (change in geophysical field) column and
-delta S (change in distance) for each geophysical field. Distance
-between observations often differ for different fields depending on
-instrument sampling rate, so ds is included for each geophysical
-observation. Output columns include:</p>
-<p><em>d[twt] ds d[depth] ds d[mtf1] ds d[mtf2] ds d[mag] ds d[diur] ds
-d[msd] ds d[gobs] ds d[eot] ds d[faa] ds</em></p>
-<p><strong>-Dl</strong> display mgd77sniffer limits. Customize this output to create
-a custom limits file for the <strong>-L</strong> option. No additional arguments
-are required. Output columns include:</p>
-<p><em>fieldabbrev min max maxSlope maxArea</em></p>
-<p><strong>-Dm</strong> output MGD77 format records in Y2K-compliant MGD77 format</p>
-<p><strong>-Dn</strong> output distance to coast for each record. Requires the <strong>-Gnav</strong>
-option. Output columns include:</p>
-<p><em>lat lon dist distToCoast</em></p>
-<p><strong>-Ds</strong> output calculated gradients for speed and geophysical
-fields. Gradients correspond to the gradient type selected in the
-<strong>-S</strong> option (spatial derivatives by default). Output columns include:</p>
-<p><em>speed d[twt] d[depth] d[mtf1] d[mtf2] d[mag] d[diur] d[msd] d[gobs] d[eot] d[faa]</em></p>
-<p>See <strong>MGD77 FIELD INFO</strong> below for field and abbreviations descriptions.</p>
-<p><strong>-Dv</strong> display values for the twelve position and geophysical
-fields for each MGD77 data record (in this order):</p>
-<p><em>lat lon twt depth mtf1 mtf2 mag diur msens gobs eot faa</em></p>
-<p class="last">See below for <strong>MGD77 FIELD INFO</strong>.</p>
-</dd>
-<dt><strong>-G</strong><em>information</em></dt>
-<dd><p class="first">Compare cruise data to GMT or IMG grids. Use one of the formats below.
-<strong>-G</strong><em>fieldabbrev</em>,<em>imggrid</em>,<em>scale</em>,<em>mode</em>
-Compare cruise data to the specified grid in Sandwell/Smith Mercator
-format. Requires a valid MGD77 field abbreviation (see <strong>MGD77 FIELD
-INFO</strong> below) followed by a comma, the path (if not in current
-directory) and grid filename, a scale to multiply the data (1 or
-0.1), and mode which stand for the following: (0) Img files with no
-constraint code, returns data at all points, (1) Img file with
-constraints coded, return data at all points, (2) Img file with
-constraints coded, return data only at constrained points and NaN
-elsewhere, and (3) Img file with constraints coded,
-return 1 at constraints and 0 elsewhere.
-<strong>-G</strong><em>fieldabbrev</em>,<em>grid</em>
-Compare cruise data to the specified grid. Requires a valid MGD77
-field abbreviation (see <strong>MGD77 FIELD INFO</strong> below) followed by a
-comma, then the path (if not in current directory) and grid
-filename. Multiple grid comparison is supported by using separate
-<strong>-G</strong> calls for each grid. See <strong>GRID FILE INFO</strong> below.</p>
-<p class="last">Grid comparison activates several additional error checks. (1)
-Re-weighted Least Squares Regression of ship versus grid data
-determines slope and DC shift, which when differing from expected 1
-and 0, respectively, may indicate incorrectly scaled ship data,
-including incorrect units or instrument drift as well as erroneous
-gravity tie-in. (2) Accumulated ship grid offsets are computed
-along-track and excessive offsets are flagged according to <em>maxArea</em>
-threshold (use <strong>-L</strong> option to adjust <em>maxArea</em>). Warning:
-predicted bathymetry grids are constrained by cruise data so grids
-and cruise data are not always independent. Comparison of cruise
-bathymetry with predicted bathymetry grids also activates a
-“navigation crossing over land” check.</p>
-</dd>
-<dt><strong>-H</strong></dt>
-<dd><p class="first">(with <strong>-G</strong>|<strong>g</strong> only) disable (or force) decimation during
-RLS analysis of ship and gridded data. By default mgd77sniffer
-analyses both the full and decimated data sets then reports RLS
-statistics for the higher correlation regression.</p>
-<p><strong>-Hb</strong> analyze both (default), report better of two.</p>
-<p><strong>-Hd</strong> to disable data decimation (equivalent to -H with no argument).</p>
-<p class="last"><strong>-Hf</strong> to force data decimation.</p>
-</dd>
-<dt><strong>-I</strong><em>fieldabbrev</em>,<em>rec1</em>,<em>recN</em></dt>
-<dd>Append a field abbreviation and the first and last record in a range
-of records that should be flagged as bad (and set to NaN prior to
-the analysis). Repeat as many times as needed. May not be used for
-multiple cruises.</dd>
-<dt><strong>-K</strong></dt>
-<dd>Reverse navigation quality flags (good to bad and vice versa). May
-be necessary when a majority of navigation fixes are erroneously
-flagged bad, which can happen when a cruise’s first navigation fix
-is extremely erroneous. Caution! This will affect sniffer output and
-should only be attempted after careful manual navigation review.</dd>
-<dt><strong>-L</strong><em>custom-limits-file</em></dt>
-<dd><p class="first">Override mgd77sniffer default error detection limits. Supply path
-and filename to the custom limits file. Rows not beginning with a
-valid MGD77 field abbreviation are ignored. Field abbreviations are
-listed below in exact form under MGD77 FIELD INFO. Multiple field
-limits may be modified using one default file, one field per line.
-Field min, max, max slope and max area may be changed for each
-field. Max slope pertains to the gradient type selected using the
-<strong>-S</strong> option. Max area is used by the <strong>-G</strong> option as the
-threshold for flagging excessive offsets from the specified grid.
-Dump defaults <strong>-Dl</strong> to view syntax or to quickly create an
-editable custom limits file.</p>
-<p>Example custom default file contents (see below for units):</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="26%" />
-<col width="15%" />
-<col width="17%" />
-<col width="22%" />
-<col width="20%" />
-</colgroup>
-<tbody valign="top">
-<tr class="row-odd"><td># abbrev</td>
-<td>min</td>
-<td>max</td>
-<td>maxSlope</td>
-<td>maxArea</td>
-</tr>
-<tr class="row-even"><td>twt</td>
-<td>0</td>
-<td>15</td>
-<td>1</td>
-<td>0</td>
-</tr>
-<tr class="row-odd"><td>depth</td>
-<td>0</td>
-<td>11000</td>
-<td>500</td>
-<td>5000</td>
-</tr>
-<tr class="row-even"><td>mag</td>
-<td>-800</td>
-<td>800</td>
-<td>–</td>
-<td>–</td>
-</tr>
-<tr class="row-odd"><td>faa</td>
-<td>-300</td>
-<td>300</td>
-<td>100</td>
-<td>2500</td>
-</tr>
-</tbody>
-</table>
-<p class="last">Use a dash ‘-‘ to retain a default limit. Hint: to test your custom
-limits, try: mgd77sniffer <strong>-Dl</strong> <strong>-L</strong><yourlimitsfile></p>
-</dd>
-<dt><strong>-N</strong></dt>
-<dd>Use nautical units.</dd>
-<dt><strong>-P</strong></dt>
-<dd>Flag regression statistics that are outside the specified confidence
-level. (i.e., -P5 flags coefficients m, b, rms, and r that fall
-outside 95%.)</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]</dt>
-<dd><em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> specify the region of interest,
-and you may specify them in decimal degrees or in
-[+-]dd:mm[:ss.xxx][W|E|S|N] format. Append <strong>r</strong> if lower left
-and upper right map coordinates are given instead of w/e/s/n. The
-two shorthands <strong>-Rg</strong> and <strong>-Rd</strong> stand for global domain (0/360
-and -180/+180 in longitude respectively, with -90/+90 in latitude).
-Alternatively, specify the name of an existing grid file and the
-<strong>-R</strong> settings (and grid spacing, if applicable) are copied from
-the grid. Using <strong>-R</strong><em>unit</em> expects projected (Cartesian)
-coordinates compatible with chosen <strong>-J</strong> and we inversely project
-to determine actual rectangular geographic region.
-For perspective view (<strong>-p</strong>), optionally append /<em>zmin</em>/<em>zmax</em>.
-In case of perspective view (<strong>-p</strong>), a z-range (<em>zmin</em>, <em>zmax</em>)
-can be appended to indicate the third dimension. This needs to be
-done only when using the <strong>-Jz</strong> option, not when using only the
-<strong>-p</strong> option. In the latter case a perspective view of the plane is
-plotted, with no third dimension. </dd>
-<dt><strong>-S</strong><strong>d</strong>|<strong>s</strong>|<strong>t</strong></dt>
-<dd>Specify gradient type for along-track excessive slope checking.
-<strong>-Sd</strong> Calculate change in z values along track (dz). Output is
-given in geophysical units, e.g., mGal.
-<strong>-Ss</strong> Calculate spatial gradients (dz/ds). Output is given in
-geophysical units per km along the survey track, e.g., mGal/km.
-<strong>-St</strong> Calculate time gradients (dz/dt) [default]. Output is given
-in geophysical units per second along the survey track, e.g., mGal/sec.</dd>
-<dt><strong>-T</strong><em>gap</em></dt>
-<dd>Adjusts mgd77sniffer gap handling. By default, data gaps greater
-than 5 km are skipped. Set to zero to de-activate gap skipping.</dd>
-<dt><strong>-W</strong><strong>c</strong>|<strong>g</strong>|<strong>o</strong>|<strong>s</strong>|<strong>t</strong>|<strong>v</strong>|<strong>x</strong></dt>
-<dd>Print out only certain warning types for verbose error messages.
-Comma delimit any combination of <strong>c|g|o|s|t|v|x</strong>: where
-(<strong>c</strong>) type code warnings, (<strong>g</strong>)radient out of range,
-(<strong>o</strong>)ffsets from grid (requires <strong>-G</strong>|<strong>g</strong>), (<strong>s</strong>)peed
-out of range, (<strong>t</strong>)ime warnings, (<strong>v</strong>)alue out of range, (<strong>x</strong>)
-warning summaries. By default ALL warning messages are printed.Not
-compatible with any <strong>-D</strong> options.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="../../gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. Output binary data for <strong>-D</strong>d|f|s|v option.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-n</strong>[<strong>b</strong>|<strong>c</strong>|<strong>l</strong>|<strong>n</strong>][<strong>+a</strong>][<strong>+b</strong><em>BC</em>][<strong>+c</strong>][<strong>+t</strong><em>threshold</em>] <a class="reference internal" href="../../gmt.html#n-full"><em>(more ...)</em></a></dt>
-<dd>Select interpolation mode for grids.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="consequences-of-grid-resampling">
-<h2>Consequences of grid resampling<a class="headerlink" href="#consequences-of-grid-resampling" title="Permalink to this headline">¶</a></h2>
-<p>Resample or sampling of grids will use various algorithms (see <strong>-n</strong>) that may lead
-to possible distortions or unexpected results in the resampled values.
-One expected effect of resampling with splines is the tendency for the new
-resampled values to slightly exceed the global min/max limits of the original
-grid. If this is unacceptable, you can impose clipping of the resampled values
-values so they do not exceed the input min/max values by adding <strong>+c</strong> to
-your <strong>-n</strong> option.</p>
-</div>
-<div class="section" id="mgd77-field-info">
-<h2>Mgd77 Field Info<a class="headerlink" href="#mgd77-field-info" title="Permalink to this headline">¶</a></h2>
-<table border="1" class="docutils">
-<colgroup>
-<col width="30%" />
-<col width="41%" />
-<col width="30%" />
-</colgroup>
-<tbody valign="top">
-<tr class="row-odd"><td><em>Field</em></td>
-<td><em>Abbreviation</em></td>
-<td><em>Units</em></td>
-</tr>
-<tr class="row-even"><td>Two-way</td>
-<td>Travel</td>
-<td>Time</td>
-</tr>
-<tr class="row-odd"><td>Corrected</td>
-<td>Depth</td>
-<td>depth</td>
-</tr>
-<tr class="row-even"><td>Mag</td>
-<td>Total</td>
-<td>Field1</td>
-</tr>
-<tr class="row-odd"><td>Mag</td>
-<td>Total</td>
-<td>Field2</td>
-</tr>
-<tr class="row-even"><td>Residual</td>
-<td>Magnetic</td>
-<td>mag</td>
-</tr>
-<tr class="row-odd"><td>Diurnal</td>
-<td>Correction</td>
-<td>diur</td>
-</tr>
-<tr class="row-even"><td>Mag</td>
-<td>Sensor</td>
-<td>Depth/Alt</td>
-</tr>
-<tr class="row-odd"><td>Observed</td>
-<td>Gravity</td>
-<td>gobs</td>
-</tr>
-<tr class="row-even"><td>Eotvos</td>
-<td>Correction</td>
-<td>eot</td>
-</tr>
-<tr class="row-odd"><td>Free</td>
-<td>Air</td>
-<td>Anomaly</td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="section" id="grid-file-info">
-<h2>Grid File Info<a class="headerlink" href="#grid-file-info" title="Permalink to this headline">¶</a></h2>
-<p>For <strong>-G</strong> the grids must eitehr be in the format used by Sandwell & Smith,
-which is a spherical Mercator 2-byte grid with no header, or any grid type
-supported by GMT and therefore must
-contain a GMT header. A correctly formatted *.i2 grid file can be
-generated using grdraster as shown below.</p>
-<p>gmtset GRIDFILE_SHORTHAND TRUE</p>
-<p>Create/edit .gmt_io file to include the following rows:</p>
-<p># GMT I/O shorthand file</p>
-<p># suffix format_id scale offset NaN</p>
-<p>grd 0 - - - -</p>
-<p>i2 2 - - 32767</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdraster 1 -R0/359:55/-90/90 -Getopo5_hdr.i2
-</pre></div>
-</div>
-</div></blockquote>
-<p>The new grid, etopo5_hdr.i2 in this example, contains a GMT header and
-can be used in the <strong>-G</strong> option to compare cruise depth with grid values.</p>
-</div>
-<div class="section" id="e77-error-format">
-<h2>E77 Error Format<a class="headerlink" href="#e77-error-format" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>Header</strong></dt>
-<dd><p class="first">Information pertaining to an entire cruise, such as NGDC and survey
-institution identification codes, cruise examination time, two-way
-travel time corrector information, data precision warnings, as well
-as systematic scales, DC shifts and correlation coefficients from
-global grid comparisons are reported as E77 header information.</p>
-<p><strong>Sample</strong></p>
-<p># Cruise 08010039 ID 74010908 MGD77 FILE VERSION: 19801230 N_RECS: 3066</p>
-<p># Examined: Wed Oct 3 16:30:13 2007 by mtchandl</p>
-<p># Arguments: -De -Gdepth,/data/GRIDS/etopo5_hdr.i2</p>
-<p>N Errata table verification status</p>
-<p># mgd77manage applies corrections if the errata table is verified
-(toggle ‘N’ above to ‘Y’ after review)</p>
-<p># For instructions on E77 format and usage, see
-<a class="reference external" href="http://gmt.soest.hawaii.edu/mgd77/errata.php">http://gmt.soest.hawaii.edu/mgd77/errata.php</a></p>
-<p># Verified by:</p>
-<p># Comments:</p>
-<p># Errata: Header</p>
-<p>Y-E-08010039-H13-02: Invalid Magnetics Sampling Rate: (99) [ ]</p>
-<p>Y-W-08010039-H13-10: Survey year (1975) outside magnetic reference
-field IGRF 1965 time range (1965-1970)</p>
-<p>Y-I-08010039-depth-00: RLS m: 1.00053 b: 0 rms: 127.851 r: 0.973422
-significant: 1 decimation: 0</p>
-<p>Y-W-08010039-twt-09: More recent bathymetry correction table available</p>
-<p>Y-W-08010039-mtf1-10: Integer precision</p>
-<p class="last">Y-W-08010039-mag-10: Integer precision</p>
-</dd>
-<dt><strong>Error Record</strong></dt>
-<dd><p class="first">Individual error records have strict format. Included is a time or
-distance column followed by record number, a formatted error code
-string, and finally a verbose description of errors detected in the
-record. Three error classes are encoded into the error code string
-with different alphabetic characters representing unique error
-types. See below for error code format description.</p>
-<p><strong>Format</strong>
-<time/distance> <record number> <error code string> <description></p>
-<p><strong>Sample</strong></p>
-<p># Errata: Data</p>
-<p class="last">Y 08010039 1975-05-10T22:16:05.88 74 C-0-0 NAV: excessive speed</p>
-</dd>
-<dt><strong>Error Code Description</strong></dt>
-<dd><p class="first">Each of the three error classes is separated by a dash <strong>-</strong> and
-described by a combination of alphabetic characters or 0 signifying
-no detected problems.</p>
-<p>Error classes: NAV-VAL-GRAD</p>
-<p><strong>Error Class Descriptions</strong></p>
-<p>NAV (navigation):</p>
-<p>0 - fine</p>
-<p>A - time out of range</p>
-<p>B - time decreasing</p>
-<p>C - excessive speed</p>
-<p>D - above sea level</p>
-<p>E - lat undefined</p>
-<p>F - lon undefined</p>
-<p>VAL (value):</p>
-<p>0 - fine</p>
-<p>K - twt invalid</p>
-<p>L - depth invalid</p>
-<p>O - mtf1 invalid</p>
-<p>etc.</p>
-<p>GRAD (gradient):</p>
-<p>0 - fine</p>
-<p>K - d[twt] excessive</p>
-<p>L - d[depth] excessive</p>
-<dl class="docutils">
-<dt>O - d[mtf1] excessive</dt>
-<dd>etc.</dd>
-</dl>
-<p>The NAV error class has unique cases while VAL and GRAD classes are
-described by alphabetic characters for each of the 24 numeric fields
-in MGD77 format order.</p>
-<p>MGD77 bit-pattern w/ E77 alpha characters</p>
-<p>|————————————————-|———-|</p>
-<p>| X W V U T S R Q P O N M L K J I H G F E D C B A | E77 Code |</p>
-<p>| - - - - - - - - - - - - - - - - - - - - - - - - | - - - - -|</p>
-<p>| n f e g m d m m m m b b d t p l l m h d m y t d | F I |</p>
-<p>| q a o o s i s a t t t c e w t o a i o a o e z r | i D |</p>
-<p>| c a t b d u e g f f c c p t c n t n u y n a t | e |</p>
-<p>| s r n 2 1 t r t r | l |</p>
-<p>| s h h | d |</p>
-<p>| - - - - - - - - - - - - - - - - - - - - - - - - | - - - - -|</p>
-<p>| 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 | Bit place|</p>
-<p>| - G C G C C - G G G - - G G - - - T T T T T - - | Bit type |</p>
-<p>|————————————————-|———-|</p>
-<p class="last">Bit types: (G)eophysical, (C)orrection, (T)ime</p>
-</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To scan for excessive values or gradients, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mgd77sniffer 08010001
-</pre></div>
-</div>
-</div></blockquote>
-<p>To dump cruise gradients, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mgd77sniffer 08010001 -Ds
-</pre></div>
-</div>
-</div></blockquote>
-<p>To compare cruise depth with ETOPO5 bathymetry and gravity with
-Sandwell/Smith 2 min gravity version 11, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>mgd77sniffer 08010001 -Gdepth,/data/GRIDS/etopo5_hdr.i2 \
- -Gfaa,/data/GRIDS/grav.11.2.img,0.1,1
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="mgd77list.html"><em>mgd77list</em></a>,
-<a class="reference internal" href="mgd77track.html"><em>mgd77track</em></a>
-<a class="reference internal" href="../x2sys/x2sys_init.html"><em>x2sys_init</em></a></p>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>The Marine Geophysical Data Exchange Format - MGD77, see
-<a class="reference external" href="http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt.">http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt.</a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">mgd77sniffer</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#requirements">Requirements</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#consequences-of-grid-resampling">Consequences of grid resampling</a></li>
-<li><a class="reference internal" href="#mgd77-field-info">Mgd77 Field Info</a></li>
-<li><a class="reference internal" href="#grid-file-info">Grid File Info</a></li>
-<li><a class="reference internal" href="#e77-error-format">E77 Error Format</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="mgd77path.html"
- title="previous chapter">mgd77path</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="mgd77track.html"
- title="next chapter">mgd77track</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/mgd77/mgd77sniffer.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="mgd77track.html" title="mgd77track"
- >next</a> </li>
- <li class="right" >
- <a href="mgd77path.html" title="mgd77path"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_MGD77.html" >MGD77</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/mgd77/mgd77track.html b/doc_release/html/supplements/mgd77/mgd77track.html
deleted file mode 100644
index 28106ba..0000000
--- a/doc_release/html/supplements/mgd77/mgd77track.html
+++ /dev/null
@@ -1,379 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>mgd77track — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="MGD77" href="../../SUP_MGD77.html" />
- <link rel="next" title="MISC" href="../../SUP_MISC.html" />
- <link rel="prev" title="mgd77sniffer" href="mgd77sniffer.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="../../SUP_MISC.html" title="MISC"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="mgd77sniffer.html" title="mgd77sniffer"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_MGD77.html" accesskey="U">MGD77</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="mgd77track">
-<span id="index-0"></span><h1>mgd77track<a class="headerlink" href="#mgd77track" title="Permalink to this headline">¶</a></h1>
-<p>mgd77track - Plot track-line map of MGD77 cruises</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>mgd77track</strong> <em>NGDC-ids</em>
-<strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>]
-<strong>-J</strong><em>parameters</em>
-[ <strong>-A</strong>[<strong>c</strong>][<em>size</em>][,<em>spacing</em>] ]
-[ <strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> ]
-[ <strong>-C</strong><strong>f</strong>|<strong>g</strong>|<strong>e</strong> ] [ <strong>-Da</strong><em>startdate</em> ]
-[ <strong>-Db</strong><em>stopdate</em> ] [ <strong>-F</strong> ] [ <strong>-G</strong><strong>d</strong>|<strong>t</strong><em>gap</em> ]
-[ <strong>-I</strong><em>ignore</em> ] [ <strong>-K</strong> ] [ <strong>-L</strong><em>trackticks</em> ] [ <strong>-O</strong> ]
-[ <strong>-P</strong> ] [ <strong>-Sa</strong><em>startdist</em>[<strong>u</strong>] ]
-[ <strong>-Sb</strong><em>stopdist</em>[<strong>u</strong>] ]
-[ <strong>-TT</strong>|<strong>t</strong>|<strong>d</strong><em>ms</em>,<em>mc</em>,<em>mfs</em>,<em>mf</em>,<em>mfc</em> ]
-[ <strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W</strong>[<strong>-</strong>|<strong>+</strong>][<em>pen</em>] ]
-[ <strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] ]
-[ <strong>-c</strong><em>copies</em> ]
-[ <strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] ]
-[ <strong>-t</strong>[<em>transp</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>mgd77track</strong> reads NGDC MGD77 cruises and creates PostScript code
-that will plot one or more ship tracks on a map using the specified
-projection. The PostScript code is written to standard output.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>NGDC-ids</em></dt>
-<dd><p class="first">Can be one or more of five kinds of specifiers:</p>
-<ol class="arabic simple">
-<li>8-character NGDC IDs, e.g., 01010083, JA010010etc., etc.</li>
-<li>2-character <agency> codes which will return all cruises from each agency.</li>
-<li>4-character <agency><vessel> codes, which will return all cruises from those vessels.</li>
-<li>=<list>, where <list> is a table with NGDC IDs, one per line.</li>
-<li>If nothing is specified we return all cruises in the data base.</li>
-</ol>
-<p class="last">(See mgd77info <strong>-L</strong> for agency and vessel codes). The ”.mgd77” or
-”.nc” extensions will automatically be appended, if needed (use
-<strong>-I</strong> to ignore certain file types). Cruise files will be looked
-for first in the current directory and second in all directories
-listed in <strong>$MGD77_HOME</strong>/mgd77_paths.txt [If <strong>$MGD77_HOME</strong> is
-not set it will default to <strong>$GMT_SHAREDIR</strong>/mgd77].</p>
-</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-J</strong><em>parameters</em> <a class="reference internal" href="../../gmt.html#j-full"><em>(more ...)</em></a></dt>
-<dd>Select map projection.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]</dt>
-<dd><em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> specify the region of interest,
-and you may specify them in decimal degrees or in
-[+-]dd:mm[:ss.xxx][W|E|S|N] format. Append <strong>r</strong> if lower left
-and upper right map coordinates are given instead of w/e/s/n. The
-two shorthands <strong>-Rg</strong> and <strong>-Rd</strong> stand for global domain (0/360
-and -180/+180 in longitude respectively, with -90/+90 in latitude).
-Alternatively, specify the name of an existing grid file and the
-<strong>-R</strong> settings (and grid spacing, if applicable) are copied from
-the grid. Using <strong>-R</strong><em>unit</em> expects projected (Cartesian)
-coordinates compatible with chosen <strong>-J</strong> and we inversely project
-to determine actual rectangular geographic region.
-For perspective view (<strong>-p</strong>), optionally append /<em>zmin</em>/<em>zmax</em>.
-In case of perspective view (<strong>-p</strong>), a z-range (<em>zmin</em>, <em>zmax</em>)
-can be appended to indicate the third dimension. This needs to be
-done only when using the <strong>-Jz</strong> option, not when using only the
-<strong>-p</strong> option. In the latter case a perspective view of the plane is
-plotted, with no third dimension. </dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong>[<strong>c</strong>][<em>size</em>][,<em>spacing</em>]</dt>
-<dd>Append <strong>c</strong> to annotate using the MGD77 cruise ID [Default uses the
-filename prefix]. Optional <em>size</em> is the font size in points. The
-leg annotation font is controlled by <a class="reference internal" href="../../gmt.conf.html#font-label"><em>FONT_LABEL</em></a>. By default,
-each leg is annotated every time it enters the map region.
-Alternatively, append ,<em>spacing</em> to place this label every
-<em>spacing</em> units apart along the track. Append one of the units <strong>k</strong>
-(km), <strong>n</strong> (nautical mile), <strong>d</strong> (day), or <strong>h</strong> (hour).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-B</strong>[<strong>p</strong>|<strong>s</strong>]<em>parameters</em> <a class="reference internal" href="../../gmt.html#b-full"><em>(more ...)</em></a></dt>
-<dd>Set map boundary intervals.</dd>
-<dt><strong>-C</strong><strong>f</strong>|<strong>g</strong>|<strong>e</strong></dt>
-<dd><dl class="first last docutils">
-<dt>Select procedure for along-track distance calculation:</dt>
-<dd><strong>f</strong> Flat Earth distances.
-<strong>g</strong> Great circle distances [Default].
-<strong>e</strong> Geodesic distances on current GMT ellipsoid.</dd>
-</dl>
-</dd>
-<dt><strong>-Da</strong><em>startdate</em></dt>
-<dd>Do not plot data collected before <em>startdate</em>
-(yyyy-mm-ddBD(T)[hh:mm:ss]) [Default is first day].</dd>
-<dt><strong>-Db</strong><em>stopdate</em></dt>
-<dd>Do not plot data collected after <em>stopdate</em>
-(yyyy-mm-ddBD(T)[hh:mm:ss]). [Default is last day].</dd>
-<dt><strong>-F</strong></dt>
-<dd>Do not apply the error bit flags if present in a MGD77+ file
-[Default will apply these flags upon reading the data].</dd>
-<dt><strong>-G</strong><strong>d</strong>|<strong>t</strong><em>gap</em></dt>
-<dd>Let successive point separations exceeding <strong>d</strong><em>gap</em> (km) or
-<strong>t</strong><em>gap</em> (minutes) indicate a break in the track where we should
-not draw a line [no gaps recognized]. Repeat to use both types of
-gap checking.</dd>
-<dt><strong>-I</strong><em>ignore</em></dt>
-<dd>Ignore certain data file formats from consideration. Append
-<strong>a|c|t</strong> to ignore MGD77 ASCII, MGD77+ netCDF, or plain table
-files, respectively. The option may be repeated to ignore more than
-one format. [Default ignores none].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-K</strong> <a class="reference internal" href="../../gmt.html#k-full"><em>(more ...)</em></a></dt>
-<dd>Do not finalize the PostScript plot.</dd>
-<dt><strong>-L</strong><em>trackticks</em></dt>
-<dd>To put time/distance log-marks on the track. E.g.
-<strong>a</strong>500<strong>ka</strong>24<strong>ht</strong>6<strong>h</strong> means (<strong>a</strong>)nnotate every
-500 km (<strong>k</strong>) and 24 <strong>h</strong>(ours), with
-(<strong>t</strong>)ickmarks every 500 km and 6 hours. Alternatively you may use
-the modifiers <strong>d</strong> (days) and <strong>n</strong> (nautical miles).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-O</strong> <a class="reference internal" href="../../gmt.html#o-full"><em>(more ...)</em></a></dt>
-<dd>Append to existing PostScript plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-P</strong> <a class="reference internal" href="../../gmt.html#p-full"><em>(more ...)</em></a></dt>
-<dd>Select “Portrait” plot orientation.</dd>
-<dt><strong>-Sa</strong><em>startdist</em>[<strong>u</strong>]</dt>
-<dd>Do not plot data that are less than <em>startdist</em> meter along track
-from port of departure. Append <strong>k</strong> for km, <strong>m</strong> for miles, or
-<strong>n</strong> for nautical miles [Default is 0 meters].</dd>
-<dt><strong>-Sb</strong><em>stopdist</em>[<strong>u</strong>]</dt>
-<dd>Do not plot data that are more than <em>stopdist</em> meter along track
-from port of departure. Append <strong>k</strong> for km, <strong>m</strong> for miles, or
-<strong>n</strong> for nautical miles [Default is end of track].</dd>
-<dt><strong>-TT</strong>|<strong>t</strong>|<strong>d</strong><em>ms</em>,<em>mc</em>,<em>mfs</em>,<em>mf</em>,<em>mfc</em></dt>
-<dd>Controls the attributes of the three kinds of markers (<strong>T</strong> for the
-first time marker in a new day, <strong>t</strong> for additional time markers in
-the same day, and <strong>d</strong> for distance markers). For each of these you
-can specify the 5 comma-separated attributes <em>markersize</em>,
-<em>markercolor</em>, <em>markerfontsize</em>, <em>markerfont</em>, and
-<em>markerfontcolor</em>. Repeat the <strong>-T</strong> option for each marker type.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] <a class="reference internal" href="../../gmt.html#u-full"><em>(more ...)</em></a></dt>
-<dd>Draw GMT time stamp logo on plot.</dd>
-<dt><strong>-W</strong>[<strong>-</strong>|<strong>+</strong>][<em>pen</em>]</dt>
-<dd>Append <em>pen</em> used for the trackline. [Defaults:
-width = default, color = black, style = solid]. A leading <strong>+</strong> will
-use the lookup color (via <strong>-C</strong>) for both symbol fill and outline
-pen color, while a leading <strong>-</strong> will set outline pen color and turn
-off symbol fill.</dd>
-</dl>
-<p><strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]]</p>
-<dl class="docutils">
-<dt><strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] <a class="reference internal" href="../../gmt.html#xy-full"><em>(more ...)</em></a></dt>
-<dd>Shift plot origin.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-c</strong><em>copies</em> <a class="reference internal" href="../../gmt.html#c-full"><em>(more ...)</em></a></dt>
-<dd>Specify number of plot copies [Default is 1].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] <a class="reference internal" href="../../gmt.html#perspective-full"><em>(more ...)</em></a></dt>
-<dd>Select perspective view. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-t</strong>[<em>transp</em>] <a class="reference internal" href="../../gmt.html#t-full"><em>(more ...)</em></a></dt>
-<dd>Set PDF transparency level in percent.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To generate a Mercator plot of the track of the cruise 01010007 in the
-area 70W to 20E, 40S to 20N, using a Mercator scale of 0.1inch/degree,
-label the tracks with 10 points characters, annotate the boundaries
-every 10 degrees, draw gridlines every 5 degrees, and mark the track
-every day and 1000 km, with ticks every 6 hours and 250 km, and send the
-plot to the default printer, enter the following command:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt mgd77track 01010007 -R70W/20E/40S/20N -Jm0.1 -B10g5 -A10 \
- -La1da1000kf6hf250k \| lpr
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="mgd77info.html"><em>mgd77info</em></a>,
-<a class="reference internal" href="../../psbasemap.html"><em>psbasemap</em></a>,
-<a class="reference internal" href="mgd77list.html"><em>mgd77list</em></a></p>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>The Marine Geophysical Data Exchange Format - MGD77, see
-<a class="reference external" href="http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt">http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt</a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">mgd77track</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="mgd77sniffer.html"
- title="previous chapter">mgd77sniffer</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="../../SUP_MISC.html"
- title="next chapter">MISC</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/mgd77/mgd77track.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="../../SUP_MISC.html" title="MISC"
- >next</a> </li>
- <li class="right" >
- <a href="mgd77sniffer.html" title="mgd77sniffer"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_MGD77.html" >MGD77</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/misc/dimfilter.html b/doc_release/html/supplements/misc/dimfilter.html
deleted file mode 100644
index 3f8067e..0000000
--- a/doc_release/html/supplements/misc/dimfilter.html
+++ /dev/null
@@ -1,404 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>dimfilter — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="MISC" href="../../SUP_MISC.html" />
- <link rel="next" title="POTENTIAL" href="../../SUP_POTENTIAL.html" />
- <link rel="prev" title="MISC" href="../../SUP_MISC.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="../../SUP_POTENTIAL.html" title="POTENTIAL"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="../../SUP_MISC.html" title="MISC"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_MISC.html" accesskey="U">MISC</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="dimfilter">
-<span id="index-0"></span><h1>dimfilter<a class="headerlink" href="#dimfilter" title="Permalink to this headline">¶</a></h1>
-<p>dimfilter - Directional filtering of 2-D gridded files in the space (or time) domain</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>dimfilter</strong> <em>input_file.nc</em> <strong>-D</strong><em>distance_flag</em>
-<strong>-F</strong><em><filtertype><width></em>[<em>mode</em>] <strong>-G</strong><em>output_file.nc</em>
-<strong>-N</strong><em><filtertype><n_sectors></em> [ <strong>-Q</strong><em>cols</em> ]
-[ <strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]] ]
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ]
-[ <strong>-T</strong> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>dimfilter</strong> will filter a <em>.nc</em> file in the space (or time) domain by
-dividing the given filter circle into <em>n_sectors</em>, applying one of the
-selected primary convolution or non-convolution filters to each sector,
-and choosing the final outcome according to the selected secondary
-filter. It computes distances using Cartesian or Spherical geometries.
-The output <em>.nc</em> file can optionally be generated as a subregion of the
-input and/or with a new <strong>-I</strong>ncrement. In this way, one may have
-“extra space” in the input data so that there will be no edge effects
-for the output grid. If the filter is low-pass, then the output may be
-less frequently sampled than the input. <strong>-Q</strong> is for the error analysis
-mode and only requires the total number of columns in the input file,
-which contains the filtered depths. Finally, one should know that
-<strong>dimfilter</strong> will not produce a smooth output as other spatial filters
-do because it returns a minimum median out of <em>N</em> medians of <em>N</em>
-sectors. The output can be rought unless the input data is noise-free.
-Thus, an additional filtering (e.g., Gaussian via <strong>grdfilter</strong>) of the
-DiM-filtered data is generally recommended.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>input_file.nc</em></dt>
-<dd>The data grid to be filtered.</dd>
-<dt><strong>-D</strong><em>distance_flag</em></dt>
-<dd><p class="first">Distance <em>flag</em> tells how grid (x,y) relates to filter <em>width</em>, as follows:</p>
-<p><em>flag</em> = 0: grid (x,y) same units as <em>width</em>, Cartesian distances.
-<em>flag</em> = 1: grid (x,y) in degrees, <em>width</em> in kilometers, Cartesian distances.
-<em>flag</em> = 2: grid (x,y) in degrees, <em>width</em> in km, dx scaled by
-cos(middle y), Cartesian distances.</p>
-<p>The above options are fastest because they allow weight matrix to be
-computed only once. The next three options are slower because they
-recompute weights for each latitude.</p>
-<p><em>flag</em> = 3: grid (x,y) in degrees, <em>width</em> in km, dx scaled by
-cosine(y), Cartesian distance calculation.</p>
-<p class="last"><em>flag</em> = 4: grid (x,y) in degrees, <em>width</em> in km, Spherical distance
-calculation.</p>
-</dd>
-<dt><strong>-F</strong><em><filtertype><width></em>[<em>mode</em>]</dt>
-<dd><p class="first">Sets the primary filter type. Choose among convolution and
-non-convolution filters. Append the filter code followed by the full
-diameter <em>width</em>. Available convolution filters are:</p>
-<p>(<strong>b</strong>) Boxcar: All weights are equal.</p>
-<p>(<strong>c</strong>) Cosine Arch: Weights follow a cosine arch curve.</p>
-<p>(<strong>g</strong>) Gaussian: Weights are given by the Gaussian function.</p>
-<p>Non-convolution filters are:</p>
-<p>(<strong>m</strong>) Median: Returns median value.</p>
-<p class="last">(<strong>p</strong>) Maximum likelihood probability (a mode estimator): Return
-modal value. If more than one mode is found we return their average
-value. Append - or + to the filter width if you rather want to
-return the smallest or largest of the modal values.</p>
-</dd>
-<dt><strong>-N</strong><em><filtertype><n_sectors></em></dt>
-<dd><p class="first">Sets the secondary filter type and the number of bow-tie sectors.
-<em>n_sectors</em> must be integer and larger than 0. When <em>n_sectors</em> is
-set to 1, the secondary filter is not effective. Available secondary
-filters are:</p>
-<p>(<strong>l</strong>) Lower: Return the minimum of all filtered values.</p>
-<p>(<strong>u</strong>) Upper: Return the maximum of all filtered values.</p>
-<p>(<strong>a</strong>) Average: Return the mean of all filtered values.</p>
-<p>(<strong>m</strong>) Median: Return the median of all filtered values.</p>
-<p class="last">(<strong>p</strong>) Mode: Return the mode of all filtered values.</p>
-</dd>
-<dt><strong>-G</strong><em>output_file.nc</em></dt>
-<dd><em>output_file.nc</em> is the output of the filter.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-I</strong></dt>
-<dd><em>x_inc</em> [and optionally <em>y_inc</em>] is the output Increment. Append
-<strong>m</strong> to indicate minutes, or <strong>c</strong> to indicate seconds. If the new
-<em>x_inc</em>, <em>y_inc</em> are NOT integer multiples of the old ones (in the
-input data), filtering will be considerably slower. [Default: Same
-as input.]</dd>
-<dt><strong>-R</strong></dt>
-<dd><em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> defines the Region of the
-output points. [Default: Same as input.]</dd>
-<dt><strong>-T</strong></dt>
-<dd>Toggle the node registration for the output grid so as to become the
-opposite of the input grid [Default gives the same registration as
-the input grid].</dd>
-<dt><strong>-Q</strong><em>cols</em></dt>
-<dd><em>cols</em> is the total number of columns in the input text table file.
-For this mode, it expects to read depths consisted of several
-columns. Each column represents a filtered grid with a filter width,
-which can be obtained by <strong>grd2xyz -Z</strong>. The outcome will be median,
-MAD, and mean. So, the column with the medians is used to generate
-the regional component and the column with the MADs is used to
-conduct the error analysis.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="../../gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="grid-file-formats">
-<h2>Grid File Formats<a class="headerlink" href="#grid-file-formats" title="Permalink to this headline">¶</a></h2>
-<p>By default GMT writes out grid as single precision floats in a
-COARDS-complaint netCDF file format. However, GMT is able to produce
-grid files in many other commonly used grid file formats and also
-facilitates so called “packing” of grids, writing out floating point
-data as 1- or 2-byte integers. To specify the precision, scale and
-offset, the user should add the suffix
-<strong>=</strong><em>id</em>[<strong>/</strong><em>scale</em><strong>/</strong><em>offset</em>[<strong>/</strong><em>nan</em>]], where
-<em>id</em> is a two-letter identifier of the grid type and precision, and
-<em>scale</em> and <em>offset</em> are optional scale factor and offset to be applied
-to all grid values, and <em>nan</em> is the value used to indicate missing
-data. When reading grids, the format is generally automatically
-recognized. If not, the same suffix can be added to input grid file
-names. See <a class="reference internal" href="../../grdreformat.html"><em>grdreformat</em></a> and Section
-<a class="reference internal" href="../../GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a>
-of the GMT Technical Reference and Cookbook for more information.</p>
-<p>When reading a netCDF file that contains multiple grids, GMT will
-read, by default, the first 2-dimensional grid that can find in that
-file. To coax GMT into reading another multi-dimensional variable in
-the grid file, append <strong>?</strong><em>varname</em> to the file name, where <em>varname</em>
-is the name of the variable. Note that you may need to escape the
-special meaning of <strong>?</strong> in your shell program by putting a backslash in
-front of it, or by placing the filename and suffix between quotes or
-double quotes. The <strong>?</strong><em>varname</em> suffix can also be used for output
-grids to specify a variable name different from the default: “z”. See
-<a class="reference internal" href="../../grdreformat.html"><em>grdreformat</em></a> and Section <a class="reference internal" href="../../GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a> of the GMT
-Technical Reference and Cookbook for more information, particularly on
-how to read splices of 3-, 4-, or 5-dimensional grids.</p>
-</div>
-<div class="section" id="geographical-and-time-coordinates">
-<h2>Geographical And Time Coordinates<a class="headerlink" href="#geographical-and-time-coordinates" title="Permalink to this headline">¶</a></h2>
-<p>When the output grid type is netCDF, the coordinates will be labeled
-“longitude”, “latitude”, or “time” based on the attributes of the input
-data or grid (if any) or on the <strong>-f</strong> or <strong>-R</strong> options. For example,
-both <strong>-f0x</strong> <strong>-f1t</strong> and <strong>-R</strong>90w/90e/0t/3t will result in a
-longitude/time grid. When the x, y, or z coordinate is time, it will be
-stored in the grid as relative time since epoch as specified by
-<a class="reference internal" href="../../gmt.conf.html#time-unit"><em>TIME_UNIT</em></a> and <a class="reference internal" href="../../gmt.conf.html#time-epoch"><em>TIME_EPOCH</em></a> in the
-<a class="reference internal" href="../../gmt.conf.html"><em>gmt.conf</em></a> file or on the
-command line. In addition, the <strong>unit</strong> attribute of the time variable
-will indicate both this unit and epoch.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>Suppose that north_pacific_dbdb5.nc is a file of 5 minute bathymetry
-from 140E to 260E and 0N to 50N, and you want to find the medians of
-values within a 300km radius (600km full width) of the output points,
-which you choose to be from 150E to 250E and 10N to 40N, and you want
-the output values every 0.5 degree. To prevent the medians from being
-biased by the sloping plane, you want to divide the filter circle into 6
-sectors and to choose the lowest value among 6 medians. Using spherical
-distance calculations, you need:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt dimfilter north_pacific_dbdb5.nc -Gfiltered_pacific.nc -Fm600 -D4 \
- -Nl6 -R150/250/10/40 -I0.5 -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>Suppose that cape_verde.nc is a file of 0.5 minute bathymetry from 32W
-to 15W and 8N to 25N, and you want to remove small-length-scale features
-in order to define a swell in an area extending from 27.5W to 20.5W and
-12.5N to 19.5N, and you want the output value every 2 minute. Using
-cartesian distance calculations, you need:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt dimfilter cape_verde.nc -Gt.nc -Fm220 -Nl8 -D2 -R-27.5/-20.5/12.5/19.5 -I2m -V
-gmt grdfilter t.nc -Gcape_swell.nc -Fg50 -D2 -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>Suppose that you found a range of filter widths for a given area, and
-you filtered the given bathymetric data using the range of filter widths
-(e.g., <em>f100.nc f110.nc f120.nc f130.nc</em>), and you want to define a
-regional trend using the range of filter widths, and you want to obtain
-median absolute deviation (MAD) estimates at each data point. Then, you
-will need to do:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grd2xyz f100.nc -Z > f100.d
-gmt grd2xyz f110.nc -Z > f110.d
-gmt grd2xyz f120.nc -Z > f120.d
-gmt grd2xyz f130.nc -Z > f130.d
-paste f100.d f110.d f120.d f130.d > depths.d
-gmt dimfilter depths.d -Q4 > output.z
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="limitations">
-<h2>Limitations<a class="headerlink" href="#limitations" title="Permalink to this headline">¶</a></h2>
-<p>When working with geographic (lat, lon) grids, all three convolution
-filters (boxcar, cosine arch, and gaussian) will properly normalize the
-filter weights for the variation in gridbox size with latitude, and
-correctly determine which nodes are needed for the convolution when the
-filter “circle” crosses a periodic (0-360) boundary or contains a
-geographic pole. However, the spatial filters, such as median and mode
-filters, do not use weights and thus should only be used on Cartesian
-grids (or at very low latitudes) only. If you want to apply such spatial
-filters you should project your data to an equal-area projection and run
-dimfilter on the resulting Cartesian grid.</p>
-</div>
-<div class="section" id="script-template">
-<h2>Script Template<a class="headerlink" href="#script-template" title="Permalink to this headline">¶</a></h2>
-<p>The dim.template.sh is a skeleton shell script that can be used to set
-up a complete DiM analysis, including the MAD analysis.</p>
-</div>
-<div class="section" id="reference">
-<h2>Reference<a class="headerlink" href="#reference" title="Permalink to this headline">¶</a></h2>
-<p>Kim, S.-S., and Wessel, P. (2008), Directional Median Filtering for
-Regional-Residual Separation of Bathymetry, <em>Geochem. Geophys.
-Geosyst.</em>, <strong>9</strong>, Q03005, doi:10.1029/2007GC001850.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="../../gmt.html"><em>gmt</em></a>, <a class="reference internal" href="../../grdfilter.html"><em>grdfilter</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">dimfilter</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#grid-file-formats">Grid File Formats</a></li>
-<li><a class="reference internal" href="#geographical-and-time-coordinates">Geographical And Time Coordinates</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#limitations">Limitations</a></li>
-<li><a class="reference internal" href="#script-template">Script Template</a></li>
-<li><a class="reference internal" href="#reference">Reference</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="../../SUP_MISC.html"
- title="previous chapter">MISC</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="../../SUP_POTENTIAL.html"
- title="next chapter">POTENTIAL</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/misc/dimfilter.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="../../SUP_POTENTIAL.html" title="POTENTIAL"
- >next</a> </li>
- <li class="right" >
- <a href="../../SUP_MISC.html" title="MISC"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_MISC.html" >MISC</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/potential/gmtgravmag3d.html b/doc_release/html/supplements/potential/gmtgravmag3d.html
deleted file mode 100644
index 333bb43..0000000
--- a/doc_release/html/supplements/potential/gmtgravmag3d.html
+++ /dev/null
@@ -1,285 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>gmtgravmag3d — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="POTENTIAL" href="../../SUP_POTENTIAL.html" />
- <link rel="next" title="gravfft" href="gravfft.html" />
- <link rel="prev" title="POTENTIAL" href="../../SUP_POTENTIAL.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="gravfft.html" title="gravfft"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="../../SUP_POTENTIAL.html" title="POTENTIAL"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_POTENTIAL.html" accesskey="U">POTENTIAL</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gmtgravmag3d">
-<span id="index-0"></span><h1>gmtgravmag3d<a class="headerlink" href="#gmtgravmag3d" title="Permalink to this headline">¶</a></h1>
-<p>gmtgravmag3d - Compute the gravity/magnetic effect of a body by the method of Okabe</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmtgravmag3d</strong> [ <strong>-C</strong><em>density</em> ] [ <strong>-D</strong> ] [ <strong>-E</strong><em>thickness</em> ]
-[ <strong>-F</strong><em>xy_file</em> ]
-[ <strong>-G</strong><em>outputgrid.nc</em> ]
-[ <strong>-H</strong><em>f_dec</em>/<em>f_dip</em>/<em>m_int</em>/<em>m_dec</em>/<em>m_dip</em> ]
-[ <strong>-L</strong><em>z_observation</em> ]
-<strong>-V</strong>[<em>level</em>]
-[ <strong>-S</strong><em>radius</em> ]
-[ <strong>-T</strong>[[<em>d</em>]<em>xyz_file</em>/<em>vert_file</em>[<em>/m</em>]]|[<em>r|s</em>]<em>raw_file</em> ]
-[ <strong>-Z</strong><em>level</em> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-fg</strong>]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>gmtgravmag3d</strong> will compute the gravity or magnetic anomaly of a body
-described by a set of triangles. The output can either be along a given
-set of xy locations or on a grid. This method is not particularly fast
-but allows computing the anomaly of arbitrarily complex shapes.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-C</strong><em>density</em></dt>
-<dd>Sets body density in SI. This option is mutually exclusive with <strong>-H</strong>.</dd>
-<dt><strong>-H</strong><em>f_dec</em>/<em>f_dip</em>/<em>m_int</em>/<em>m_dec</em>/<em>m_dip</em></dt>
-<dd>Sets parameters for computing a magnetic anomally. Use
-<em>f_dec</em>/<em>f_dip</em> to set the geomagnetic declination/inclination in
-degrees. <em>m_int</em>/<em>m_dec</em>/<em>m_dip</em> are the body magnetic intensity
-declination and inclination.</dd>
-<dt><strong>-F</strong><em>xy_file</em></dt>
-<dd>Provide locations where the anomaly will be computed. Note this
-option is mutually exlusive with <strong>-G</strong>.</dd>
-<dt><strong>-G</strong><em>outgrid.nc</em></dt>
-<dd>Output the gravity or magnetic anomaly at nodes of this grid file.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="../../gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-E</strong>[<em>thickness</em>]</dt>
-<dd>give layer thickness in m [Default = 0 m]. Use this option only when
-the triangles describe a non-closed surface and you want the anomaly
-of a constant thickness layer.</dd>
-<dt><strong>-L</strong>[<em>z_observation</em>]</dt>
-<dd>sets level of observation [Default = 0]. That is the height (z) at
-which anomalies are computed.</dd>
-<dt><strong>-S</strong><em>radius</em></dt>
-<dd>search radius in km. Triangle centroids that are further away than
-<em>radius</em> from current output point will not be taken into account.
-Use this option to speed up computation at expenses of a less
-accurate result.</dd>
-<dt><strong>-T</strong>[[<em>d</em>]<em>xyz_file</em>/<em>vert_file</em>[<em>/m</em>]]|[<em>r|s</em>]<em>raw_file</em>]</dt>
-<dd>Give either names of xyz[m] and <em>vertex</em> files or of a <em>raw</em> or
-<em>stl</em> file defining a close surface. In the first case append a <em>d</em>
-imediatly after <strong>-T</strong> and optionaly a <em>/m</em> after the vertex file
-name. In the second case append a <em>r</em> or a <em>s</em> imediatly after
-<strong>-T</strong> and before the file name. A <em>vertex</em> file is a file with N
-rows (one per triangle) and 3 columns with integers defining the
-order by which the points in the <em>xyz</em> file are to be connected to
-form a triangle. The output of the program triangulate comes in this
-format. The optional <em>/m</em> instructs the program that the xyzm file
-has four columns and that the fourth column contains the
-magnetization intensity (plus signal), which needs not to be
-constant. In this case the third argument of the <strong>-H</strong> option is
-ignored. A <em>raw</em> format (selected by the <strong>r</strong> flag is a file with N
-rows (one per triangle) and 9 columns corresponding to the x,y,x
-coordinates of each of the three vertex of each triangle.
-Alternatively, the <strong>s</strong> flag indicates that the surface file is in
-the ascii STL (Stereo Lithographic) format. These two type of files
-are used to provide a closed surface.</dd>
-<dt><strong>-Z</strong>[<em>level</em>]</dt>
-<dd>level of reference plane [Default = 0]. Use this option when the
-triangles describe a non-closed surface and the volume is deffined
-from each triangle and this reference level. An example will be the
-whater depth to compute a Bouguer anomaly.</dd>
-<dt><strong>-fg</strong></dt>
-<dd>Geographic grids (dimensions of longitude, latitude) will be converted to
-meters via a “Flat Earth” approximation using the current ellipsoid parameters.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="grid-distance-units">
-<h2>Grid Distance Units<a class="headerlink" href="#grid-distance-units" title="Permalink to this headline">¶</a></h2>
-<p>If the grid does not have meter as the horizontal unit, append <strong>+u</strong><em>unit</em> to the input file name to convert from the
-specified unit to meter. If your grid is geographic, convert distances to meters by supplying <strong>-fg</strong> instead.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>Suppose you ...</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gmtgravmag3d ...
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="../../gmt.html"><em>gmt</em></a>, <a class="reference internal" href="grdgravmag3d.html"><em>grdgravmag3d</em></a></p>
-</div>
-<div class="section" id="reference">
-<h2>Reference<a class="headerlink" href="#reference" title="Permalink to this headline">¶</a></h2>
-<p>Okabe, M., Analytical expressions for gravity anomalies due to
-polyhedral bodies and translation into magnetic anomalies, <em>Geophysics</em>,
-44, (1979), p 730-741.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">gmtgravmag3d</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#grid-distance-units">Grid Distance Units</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-<li><a class="reference internal" href="#reference">Reference</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="../../SUP_POTENTIAL.html"
- title="previous chapter">POTENTIAL</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="gravfft.html"
- title="next chapter">gravfft</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/potential/gmtgravmag3d.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="gravfft.html" title="gravfft"
- >next</a> </li>
- <li class="right" >
- <a href="../../SUP_POTENTIAL.html" title="POTENTIAL"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_POTENTIAL.html" >POTENTIAL</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/potential/gravfft.html b/doc_release/html/supplements/potential/gravfft.html
deleted file mode 100644
index 5ee46f9..0000000
--- a/doc_release/html/supplements/potential/gravfft.html
+++ /dev/null
@@ -1,514 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>gravfft — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="POTENTIAL" href="../../SUP_POTENTIAL.html" />
- <link rel="next" title="grdgravmag3d" href="grdgravmag3d.html" />
- <link rel="prev" title="gmtgravmag3d" href="gmtgravmag3d.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grdgravmag3d.html" title="grdgravmag3d"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="gmtgravmag3d.html" title="gmtgravmag3d"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_POTENTIAL.html" accesskey="U">POTENTIAL</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="gravfft">
-<span id="index-0"></span><h1>gravfft<a class="headerlink" href="#gravfft" title="Permalink to this headline">¶</a></h1>
-<p>gravfft - Compute gravitational attraction of 3-D surfaces in the wavenumber (or frequency) domain</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>gravfft</strong> <em>ingrid</em> [ <em>ingrid2</em> ] <strong>-G</strong><em>outfile</em>
-[ <strong>-C</strong><em>n/wavelength/mean_depth/tbw</em> ] [ <strong>-D</strong><em>density</em> ] [ <strong>-E</strong><em>n_terms</em> ]
-[ <strong>-F</strong>[<strong>f</strong>|<strong>g</strong>|<strong>v</strong>|<strong>n</strong>|<strong>e</strong>] ] [ <strong>-I</strong><strong>w</strong>|<strong>b</strong>|<strong>c</strong>|<strong>t</strong> |<strong>k</strong> ]
-<strong>-N</strong>[<strong>f</strong>|<strong>q</strong>|<strong>s</strong>|<em>nx/ny</em>][<strong>+a</strong>|<strong>d</strong>|<strong>h</strong> |<strong>l</strong>][<strong>+e</strong>|<strong>n</strong>|<strong>m</strong>][<strong>+t</strong><em>width</em>][<strong>+w</strong>[<em>suffix</em>]][<strong>+z</strong>[<strong>p</strong>]]
-[ <strong>-Q</strong> ] [ <strong>-T</strong><em>te/rl/rm/rw</em>[<strong>+m</strong>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-Z</strong><em>zm</em>[<em>zl</em>] ]
-[ <strong>-fg</strong> ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>gravfft</strong> can be used into two main modes. First one computes the
-gravity/geoid response of a bathymetry file. It will take the 2-D
-forward FFT of a bathymetry grid and compute it’s gravity/geoid response
-using full Parker’s method applied to the chosen model. The available
-models are the “loading from top”, or elastic plate model, and the
-“loading from below” which accounts for the plate’s response to a
-sub-surface load (appropriate for hot spot modeling - if you believe
-them). In both cases, the model parameters are set with <strong>-T</strong> and
-<strong>-Z</strong> options. Second mode computes the admittance or coherence between
-two grids. The output is the average in the radial direction.
-Optionally, the model admittance may also be calculated. The horizontal
-dimensions of the grdfiles are assumed to be in meters. Geographical
-grids may be used by specifying the <strong>-fg</strong> option that scales degrees
-to meters. If you have grids with dimensions in km, you could change
-this to meters using <a class="reference internal" href="../../grdedit.html"><em>grdedit</em></a> or scale the output with
-<a class="reference internal" href="../../grdmath.html"><em>grdmath</em></a>.
-Given the number of choices this program offers, is difficult to state
-what are options and what are required arguments. It depends on what you
-are doing.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>ingrid</em></dt>
-<dd>2-D binary grid file to be operated on. (See GRID FILE FORMATS below).
-For cross-spectral operations, also give the second grid file <em>ingrd2</em>.</dd>
-<dt><strong>-G</strong><em>outfile</em></dt>
-<dd>Specify the name of the output grid file or the 1-D spectrum table
-(see <strong>-E</strong>). (See GRID FILE FORMATS below).</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-C</strong><em>n/wavelength/mean_depth/tbw</em></dt>
-<dd>Compute only the theoretical admittance curves of the selected model
-and exit. <em>n</em> and <em>wavelength</em> are used to compute (n * wavelength)
-the total profile length in meters. <em>mean_depth</em> is the mean water
-depth. Append dataflags (one or two) of <em>tbw</em> in any order. <em>t</em> =
-use “from top” model, <em>b</em> = use “from below” model. Optionally
-specify <em>w</em> to write wavelength instead of frequency.</dd>
-<dt><strong>-D</strong><em>density</em></dt>
-<dd>Sets density contrast across surface. Used, for example, to compute
-the gravity attraction of the water layer that can later be combined
-with the free-air anomaly to get the Bouguer anomaly. In this case
-do not use <strong>-T</strong>. It also implicitly sets <strong>-N+h</strong>.</dd>
-<dt><strong>-E</strong><em>n_terms</em></dt>
-<dd>Number of terms used in Parker expansion (limit is 10, otherwise
-terms depending on n will blow out the program) [Default = 3]</dd>
-<dt><strong>-F</strong>[<strong>f</strong>|<strong>g</strong>|<strong>v</strong>|<strong>n</strong>|<strong>e</strong>]</dt>
-<dd><p class="first">Specify desired geopotential field: compute geoid rather than gravity</p>
-<blockquote class="last">
-<div><p><strong>f</strong> = Free-air anomalies (mGal) [Default].</p>
-<p><strong>g</strong> = Geoid anomalies (m).</p>
-<p><strong>v</strong> = Vertical Gravity Gradient (VGG; 1 Eovtos = 0.1 mGal/km).</p>
-<p><strong>e</strong> = East deflections of the vertical (micro-radian).</p>
-<p><strong>n</strong> = North deflections of the vertical (micro-radian).</p>
-</div></blockquote>
-</dd>
-<dt><strong>-I</strong><strong>w</strong>|<strong>b</strong>|<strong>c</strong>|<strong>t</strong> |<strong>k</strong></dt>
-<dd>Use <em>ingrd2</em> and <em>ingrd1</em> (a grid with topography/bathymetry) to estimate admittance|coherence and
-write it to stdout (<strong>-G</strong> ignored if set). This grid should contain
-gravity or geoid for the same region of <em>ingrd1</em>. Default
-computes admittance. Output contains 3 or 4 columns. Frequency
-(wavelength), admittance (coherence) one sigma error bar and,
-optionally, a theoretical admittance. Append dataflags (one to
-three) from <strong>w</strong>|<strong>b</strong>|<strong>c</strong>|<strong>t</strong>.
-<strong>w</strong> writes wavelength instead of wavenumber, <strong>k</strong>
-selects km for wavelength unit [m], <strong>c</strong> computes coherence instead of
-admittance, <strong>b</strong> writes a forth column with “loading from below”
-theoretical admittance, and <strong>t</strong> writes a forth column with “elastic
-plate” theoretical admittance.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-N</strong>[<strong>f</strong>|<strong>q</strong>|<strong>s</strong>|<em>nx/ny</em>][<strong>+a</strong>|[<strong>+d</strong>|<strong>h</strong>|<strong>l</strong>][<strong>+e</strong>|<strong>n</strong>|<strong>m</strong>][<strong>+t</strong><em>width</em>][<strong>+w</strong>[<em>suffix</em>]][<strong>+z</strong>[<strong>p</strong>]]</dt>
-<dd><p class="first">Choose or inquire about suitable grid dimensions for FFT and set
-optional parameters. Control the FFT dimension:</p>
-<blockquote>
-<div><p><strong>-Nf</strong> will force the FFT to use the actual dimensions of the data.</p>
-<p><strong>-Nq</strong> will inQuire about more suitable dimensions, report those, then continue.</p>
-<p><strong>-Ns</strong> will present a list of optional dimensions, then exit.</p>
-<p><strong>-N</strong><em>nx/ny</em> will do FFT on array size <em>nx/ny</em> (must be >= grid file size). Default chooses
-dimensions >= data which optimize speed and accuracy of FFT. If FFT
-dimensions > grid file dimensions, data are extended and tapered to zero.</p>
-</div></blockquote>
-<p>Control detrending of data: Append modifiers for removing a linear trend:</p>
-<blockquote>
-<div><p><strong>+d</strong>: Detrend data, i.e. remove best-fitting linear trend [Default].</p>
-<p><strong>+a</strong>: Only remove mean value.</p>
-<p><strong>+h</strong>: Only remove mid value, i.e. 0.5 * (max + min).</p>
-<p><strong>+l</strong>: Leave data alone.</p>
-</div></blockquote>
-<p>Control extension and tapering of data:
-Use modifiers to control how the extension and tapering are to be performed:</p>
-<blockquote>
-<div><p><strong>+e</strong> extends the grid by imposing edge-point symmetry [Default],</p>
-<p><strong>+m</strong> extends the grid by imposing edge mirror symmetry</p>
-<p><strong>+n</strong> turns off data extension.</p>
-<p>Tapering is performed from the data edge to the FFT grid edge [100%].
-Change this percentage via <strong>+t</strong><em>width</em>. When <strong>+n</strong> is in effect,
-the tapering is applied instead to the data margins as no extension is
-available [0%].</p>
-</div></blockquote>
-<p class="last">Control writing of temporary results:
-For detailed investigation you can write the intermediate grid being passed
-to the forward FFT; this is likely to have been detrended, extended by
-point-symmetry along all edges, and tapered. Append <strong>+w</strong>[<em>suffix</em>] from
-which output file name(s) will be created (i.e., <em>ingrid_prefix.ext</em>)
-[tapered], where <em>ext</em> is your file extension. Finally, you may save
-the complex grid produced by the forward FFT by appending <strong>+z</strong>. By
-default we write the real and imaginary components to
-<em>ingrid</em>_*real* <em>ext</em> and <em>ingrid</em>_imag.<em>ext</em>. Append
-<strong>p</strong> to save instead the polar form of magnitude and phase to files
-<em>ingrid</em>_mag.<em>ext</em> and <em>ingrid</em>_phase.<em>ext</em>.</p>
-</dd>
-<dt><strong>-Q</strong></dt>
-<dd>Writes out a grid with the flexural topography (with z positive up)
-whose average was set by <strong>-Z</strong><em>zm</em> and model parameters by <strong>-T</strong>
-(and output by <strong>-G</strong>). That is the “gravimetric Moho”. <strong>-Q</strong>
-implicitly sets <strong>-N+h</strong></dd>
-<dt><strong>-S</strong></dt>
-<dd>Computes predicted gravity or geoid grid due to a subplate load
-produced by the current bathymetry and the theoretical model. The
-necessary parameters are set within <strong>-T</strong> and <strong>-Z</strong> options. The
-number of powers in Parker expansion is restricted to 1.
-See an example further down.</dd>
-<dt><strong>-T</strong><em>te/rl/rm/rw</em>[<strong>+m</strong>]</dt>
-<dd>Compute the isostatic compensation from the topography load (input grid file) on
-an elastic plate of thickness <em>te</em>. Also append densities for load, mantle, and
-water in SI units. Give average mantle depth via <strong>-Z</strong>. If the elastic thickness
-is > 1e10 it will be interpreted as the flexural rigidity (by default it is
-computed from <em>te</em> and Young modulus). Optionally, append <em>+m</em> to write a grid
-with the Moho’s geopotential effect (see <strong>-F</strong>) from model selected by <strong>-T</strong>.
-If <em>te</em> = 0 then the Airy response is returned. <strong>-T+m</strong> implicitly sets <strong>-N+h</strong></dd>
-<dt><strong>-Z</strong><em>zm</em>[<em>zl</em>]</dt>
-<dd>Moho [and swell] average compensation depths. For the “load from
-top” model you only have to provide <em>zm</em>, but for the “loading from
-below” don’t forget <em>zl</em>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-fg</strong></dt>
-<dd>Geographic grids (dimensions of longitude, latitude) will be converted to
-meters via a “Flat Earth” approximation using the current ellipsoid parameters.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="grid-file-formats">
-<h2>Grid File Formats<a class="headerlink" href="#grid-file-formats" title="Permalink to this headline">¶</a></h2>
-<p>By default GMT writes out grid as single precision floats in a
-COARDS-complaint netCDF file format. However, GMT is able to produce
-grid files in many other commonly used grid file formats and also
-facilitates so called “packing” of grids, writing out floating point
-data as 1- or 2-byte integers. To specify the precision, scale and
-offset, the user should add the suffix
-<strong>=</strong><em>id</em>[<strong>/</strong><em>scale</em><strong>/</strong><em>offset</em>[<strong>/</strong><em>nan</em>]], where
-<em>id</em> is a two-letter identifier of the grid type and precision, and
-<em>scale</em> and <em>offset</em> are optional scale factor and offset to be applied
-to all grid values, and <em>nan</em> is the value used to indicate missing
-data. When reading grids, the format is generally automatically
-recognized. If not, the same suffix can be added to input grid file
-names. See <a class="reference internal" href="../../grdreformat.html"><em>grdreformat</em></a> and Section
-<a class="reference internal" href="../../GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a>
-of the GMT Technical Reference and Cookbook for more information.</p>
-<p>When reading a netCDF file that contains multiple grids, GMT will
-read, by default, the first 2-dimensional grid that can find in that
-file. To coax GMT into reading another multi-dimensional variable in
-the grid file, append <strong>?</strong><em>varname</em> to the file name, where <em>varname</em>
-is the name of the variable. Note that you may need to escape the
-special meaning of <strong>?</strong> in your shell program by putting a backslash in
-front of it, or by placing the filename and suffix between quotes or
-double quotes. The <strong>?</strong><em>varname</em> suffix can also be used for output
-grids to specify a variable name different from the default: “z”. See
-<a class="reference internal" href="../../grdreformat.html"><em>grdreformat</em></a> and Section <a class="reference internal" href="../../GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a> of the GMT
-Technical Reference and Cookbook for more information, particularly on
-how to read splices of 3-, 4-, or 5-dimensional grids.</p>
-</div>
-<div class="section" id="grid-distance-units">
-<h2>Grid Distance Units<a class="headerlink" href="#grid-distance-units" title="Permalink to this headline">¶</a></h2>
-<p>If the grid does not have meter as the horizontal unit, append <strong>+u</strong><em>unit</em>
-to the input file name to convert from the specified unit to meter. If your
-grid is geographic, convert distances to meters by supplying <strong>-fg</strong> instead.</p>
-</div>
-<div class="section" id="considerations">
-<h2>Considerations<a class="headerlink" href="#considerations" title="Permalink to this headline">¶</a></h2>
-<p>netCDF COARDS grids will automatically be recognized as geographic. For
-other grids geographical grids were you want to convert degrees into
-meters, select <strong>-fg</strong>. If the data are close to either pole, you should
-consider projecting the grid file onto a rectangular coordinate system
-using <a class="reference internal" href="../../grdproject.html"><em>grdproject</em></a>.</p>
-</div>
-<div class="section" id="plate-flexure">
-<h2>Plate Flexure<a class="headerlink" href="#plate-flexure" title="Permalink to this headline">¶</a></h2>
-<p>The FFT solution to elastic plate flexure requires the infill density to equal
-the load density. This is typically only true directly beneath the load; beyond the load
-the infill tends to be lower-density sediments or even water (or air). Wessel [2001]
-proposed an approximation that allows for the specification of an infill density
-different from the load density while still allowing for an FFT solution. Basically,
-the plate flexure is solved for using the infill density as the effective load density but
-the amplitudes are adjusted by a factor <em>A</em> = sqrt ((rm - ri)/(rm - rl)), which is
-the theoretical difference in amplitude due to a point load using the two different
-load densities. The approximation is very good but breaks down for large
-loads on weak plates, a fairy uncommon situation.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To compute the effect of the water layer above the bat.grd bathymetry
-using 2700 and 1035 for the densities of crust and water and writing the
-result on water_g.grd (computing up to the fourth power of bathymetry
-in Parker expansion):</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gravfft bat.grd -D1665 -Gwater_g.grd -E4
-</pre></div>
-</div>
-</div></blockquote>
-<p>Now subtract it to your free-air anomaly faa.grd and you will get the
-Bouguer anomaly. You may wonder why we are subtracting and not adding.
-After all the Bouger anomaly pretends to correct the mass deficiency
-presented by the water layer, so we should add because water is less
-dense than the rocks below. The answer relyies on the way gravity
-effects are computed by the Parker’s method and practical aspects of
-using the FFT.</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdmath faa.grd water_g.grd SUB = bouguer.grd
-</pre></div>
-</div>
-</div></blockquote>
-<p>Want an MBA anomaly? Well compute the crust mantle contribution and add
-it to the sea-bottom anomaly. Assuming a 6 km thick crust of density
-2700 and a mantle with 3300 density we could repeat the command used to
-compute the water layer anomaly, using 600 (3300 - 2700) as the density
-contrast. But we now have a problem because we need to know the mean
-moho depth. That is when the scale/offset that can be appended to the grid’s name
-comes in hand. Notice that we didn’t need to do that before because mean water
-depth was computed directly from data. (notice also the negative sign of the
-offset due to the fact that <em>z</em> is positive up):</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gravfft bat.grd=nf/1/-6000 -D600 -Gmoho_g.grd
-</pre></div>
-</div>
-</div></blockquote>
-<p>Now, subtract it to the sea-bottom anomaly to obtain the MBA anomaly. That is:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdmath water_g.grd moho_g.grd SUB = mba.grd
-</pre></div>
-</div>
-</div></blockquote>
-<p>To compute the Moho gravity effect of an elastic plate bat.grd with Te =
-7 km, density of 2700, over a mantle of density 3300, at an averge depth
-of 9 km</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gravfft bat.grd -Gelastic.grd -T7000/2700/3300/1035+m -Z9000
-</pre></div>
-</div>
-</div></blockquote>
-<p>If you add now the sea-bottom and Moho’s effects, you will get the full
-gravity response of your isostatic model. We will use here only the
-first term in Parker expansion.</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gravfft bat.grd -D1665 -Gwater_g.grd -E1
-gmt gravfft bat.grd -Gelastic.grd -T7000/2700/3300/1035+m -Z9000 -E1
-gmt grdmath water_g.grd elastic.grd ADD = model.grd
-</pre></div>
-</div>
-</div></blockquote>
-<p>The same result can be obtained directly by the next command. However,
-PAY ATTENTION to the following. I don’t yet know if it’s because of a
-bug or due to some limitation, but the fact is that the following and
-the previous commands only give the same result if <strong>-E</strong>1 is used.
-For higher powers of bathymetry in Parker expansion,
-only the above example seams to give the correct result.</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gravfft bat.grd -Gmodel.grd -T7000/2700/3300/1035 -Z9000 -E1
-</pre></div>
-</div>
-</div></blockquote>
-<p>And what would be the geoid anomaly produced by a load at 50 km depth,
-below the a region whose bathymetry is given by bat.grd, a Moho at 9 km
-depth and the same densities as before?</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gravfft topo.grd -Gswell_geoid.grd -T7000/2700/3300/1035 -Fg -Z9000/50000 -S -E1
-</pre></div>
-</div>
-</div></blockquote>
-<p>To compute the admittance between the topo.grd bathymetry and faa.grd
-free-air anomaly grid using the elastic plate model of a crust of 6 km
-mean thickness with 10 km efective elastic thickness in a region of 3 km
-mean water depth:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gravfft topo.grd faa.grd -It -T10000/2700/3300/1035 -Z9000
-</pre></div>
-</div>
-</div></blockquote>
-<p>To compute the admittance between the topo.grd bathymetry and geoid.grd
-geoid grid with the “loading from below” (LFB) model with the same as
-above and sub-surface load at 40 km, but assuming now the grids are in
-geographic and we want wavelengths instead of frequency:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gravfft topo.grd geoid.grd -Ibw -T10000/2700/3300/1035 -Z9000/40000 -fg
-</pre></div>
-</div>
-</div></blockquote>
-<p>To compute the gravity theoretical admittance of a LFB along a 2000 km
-long profile using the same parameters as above</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt gravfft -C400/5000/3000/b -T10000/2700/3300/1035 -Z9000/40000
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>Luis, J.F. and M.C. Neves. 2006, The isostatic compensation of the
-Azores Plateau: a 3D admittance and coherence analysis. J. Geotermal
-Vulc. Res. Volume 156, Issues 1-2, Pages 10-22,
-<a class="reference external" href="http://dx.doi.org/10.1016/j.jvolgeores.2006.03.010">http://dx.doi.org/10.1016/j.jvolgeores.2006.03.010</a>
-Wessel. P., 2001, Global distribution of seamounts inferred from gridded Geosat/ERS-1 altimetry,
-J. Geophys. Res., 106(B9), 19,431-19,441,
-<a class="reference external" href="http://dx.doi.org/110.1029/2000JB000083">http://dx.doi.org/10.1029/2000JB000083</a></p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="../../gmt.html"><em>gmt</em></a>, <a class="reference internal" href="../../grdfft.html"><em>grdfft</em></a>,
-<a class="reference internal" href="../../grdmath.html"><em>grdmath</em></a>, <a class="reference internal" href="../../grdproject.html"><em>grdproject</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">gravfft</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#grid-file-formats">Grid File Formats</a></li>
-<li><a class="reference internal" href="#grid-distance-units">Grid Distance Units</a></li>
-<li><a class="reference internal" href="#considerations">Considerations</a></li>
-<li><a class="reference internal" href="#plate-flexure">Plate Flexure</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="gmtgravmag3d.html"
- title="previous chapter">gmtgravmag3d</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grdgravmag3d.html"
- title="next chapter">grdgravmag3d</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/potential/gravfft.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grdgravmag3d.html" title="grdgravmag3d"
- >next</a> </li>
- <li class="right" >
- <a href="gmtgravmag3d.html" title="gmtgravmag3d"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_POTENTIAL.html" >POTENTIAL</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/potential/grdgravmag3d.html b/doc_release/html/supplements/potential/grdgravmag3d.html
deleted file mode 100644
index 7ef62f5..0000000
--- a/doc_release/html/supplements/potential/grdgravmag3d.html
+++ /dev/null
@@ -1,288 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grdgravmag3d — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="POTENTIAL" href="../../SUP_POTENTIAL.html" />
- <link rel="next" title="grdredpol" href="grdredpol.html" />
- <link rel="prev" title="gravfft" href="gravfft.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grdredpol.html" title="grdredpol"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="gravfft.html" title="gravfft"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_POTENTIAL.html" accesskey="U">POTENTIAL</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grdgravmag3d">
-<span id="index-0"></span><h1>grdgravmag3d<a class="headerlink" href="#grdgravmag3d" title="Permalink to this headline">¶</a></h1>
-<p>grdgravmag3d - Compute the gravity effect of a grid by the method of Okabe</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdgravmag3d</strong> <em>grdfile_top</em> [<em>grdfile_bot</em>] [ <strong>-C</strong><em>density</em> ]
-[ <strong>-D</strong> ] [ <strong>-F</strong><em>xy_file</em> ]
-[ <strong>-G</strong><em>outgrid</em> ]
-[ <strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]] ]
-[ <strong>-L</strong><em>z_obs</em> ]
-[ <strong>-Q</strong>[<strong>n</strong><em>n_pad</em>]|[<em>pad_dist</em>]|[<w/e/s/n>] ]
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-Z</strong><em>level</em> ]
-[ <strong>-fg</strong> ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdgravmag3d</strong> will compute the gravity anomaly of a body described by
-one or (optionally) two grids The output can either be along a given set
-of xy locations or on a grid. This method is not particularly fast but
-allows computing the anomaly of arbitrarily complex shapes.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>grdfile_top</em> [<em>grdfile_bot</em>]</dt>
-<dd>Grid file whose gravity efect is going to be computed. If two grids are
-provided then the gravity/magnetic efect of the volume between them is computed.</dd>
-<dt><strong>-C</strong><em>density</em></dt>
-<dd>Sets body density in SI.</dd>
-<dt><strong>-F</strong><em>xy_file</em></dt>
-<dd>Provide locations where the anomaly will be computed. Note this
-option is mutually exlusive with <strong>-G</strong>.</dd>
-<dt><strong>-G</strong><em>outgrid</em></dt>
-<dd>Output the gravity anomaly at nodes of this grid file.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]</dt>
-<dd><em>x_inc</em> [and optionally <em>y_inc</em>] is the grid spacing. Optionally,
-append a suffix modifier. <strong>Geographical (degrees) coordinates</strong>: Append
-<strong>m</strong> to indicate arc minutes or <strong>s</strong> to indicate arc seconds. If one
-of the units <strong>e</strong>, <strong>f</strong>, <strong>k</strong>, <strong>M</strong>, <strong>n</strong> or <strong>u</strong> is appended
-instead, the increment is assumed to be given in meter, foot, km, Mile,
-nautical mile or US survey foot, respectively, and will be converted to
-the equivalent degrees longitude at the middle latitude of the region
-(the conversion depends on <a class="reference internal" href="../../gmt.conf.html#projection-parameters"><em>PROJ_ELLIPSOID</em></a>). If /<em>y_inc</em> is given
-but set to 0 it will be reset equal to <em>x_inc</em>; otherwise it will be
-converted to degrees latitude. <strong>All coordinates</strong>: If <strong>=</strong> is appended
-then the corresponding max <em>x</em> (<em>east</em>) or <em>y</em> (<em>north</em>) may be slightly
-adjusted to fit exactly the given increment [by default the increment
-may be adjusted slightly to fit the given domain]. Finally, instead of
-giving an increment you may specify the <em>number of nodes</em> desired by
-appending <strong>+</strong> to the supplied integer argument; the increment is then
-recalculated from the number of nodes and the domain. The resulting
-increment value depends on whether you have selected a
-gridline-registered or pixel-registered grid; see <a class="reference internal" href="../../GMT_Docs.html#app-file-formats"><em>B. GMT File Formats</em></a> for
-details. Note: if <strong>-R</strong><em>grdfile</em> is used then the grid spacing has
-already been initialized; use <strong>-I</strong> to override the values.</dd>
-<dt><strong>-L</strong><em>z_obs</em></dt>
-<dd>Sets level of observation [Default = 0]. That is the height (z) at
-which anomalies are computed.</dd>
-<dt><strong>-Q</strong>[<strong>n</strong><em>n_pad</em>]|[<em>pad_dist</em>]|[<w/e/s/n>]</dt>
-<dd><dl class="first last docutils">
-<dt>Extend the domain of computation with respect to output <strong>-R</strong> region.</dt>
-<dd><p class="first"><strong>-Qn</strong><em>n_pad</em> artifficially extends the width of the outer rim of
-cells to have a fake width of <em>n_pad</em> * dx[/dy].</p>
-<p><strong>-Q</strong><em>pad_dist</em> extend the region by west-pad, east+pad, etc.</p>
-<p class="last"><strong>-Q</strong><em>region</em> Same sintax as <strong>-R</strong>.</p>
-</dd>
-</dl>
-</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="../../gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. Note: this overrides the source grid region (Default: use same region as input)</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-Z</strong><em>level</em></dt>
-<dd>level of reference plane [Default = 0]. Use this option when the
-triangles describe a non-closed surface and the volume is deffined
-from each triangle and this reference level. An example will be the
-whater depth to compute a Bouguer anomaly.</dd>
-<dt><strong>-fg</strong></dt>
-<dd>Geographic grids (dimensions of longitude, latitude) will be converted to
-meters via a “Flat Earth” approximation using the current ellipsoid parameters.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="grid-distance-units">
-<h2>Grid Distance Units<a class="headerlink" href="#grid-distance-units" title="Permalink to this headline">¶</a></h2>
-<p>If the grid does not have meter as the horizontal unit, append <strong>+u</strong><em>unit</em> to the input file name to convert from the
-specified unit to meter. If your grid is geographic, convert distances to meters by supplying <strong>-fg</strong> instead.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>Suppose you want to compute the gravity effect of the phantom “Sandy
-Island” together with its not phantom seamount</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdgravmag3d sandy_bat.grd -C1700 -Z-4300 -M -I1m -Gsandy_okb.grd -V
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="../../gmt.html"><em>gmt</em></a>, <a class="reference internal" href="gmtgravmag3d.html"><em>gmtgravmag3d</em></a></p>
-</div>
-<div class="section" id="reference">
-<h2>Reference<a class="headerlink" href="#reference" title="Permalink to this headline">¶</a></h2>
-<p>Okabe, M., Analytical expressions for gravity anomalies due to
-polyhedral bodies and translation into magnetic anomalies, <em>Geophysics</em>,
-44, (1979), p 730-741.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grdgravmag3d</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#grid-distance-units">Grid Distance Units</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-<li><a class="reference internal" href="#reference">Reference</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="gravfft.html"
- title="previous chapter">gravfft</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grdredpol.html"
- title="next chapter">grdredpol</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/potential/grdgravmag3d.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grdredpol.html" title="grdredpol"
- >next</a> </li>
- <li class="right" >
- <a href="gravfft.html" title="gravfft"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_POTENTIAL.html" >POTENTIAL</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/potential/grdredpol.html b/doc_release/html/supplements/potential/grdredpol.html
deleted file mode 100644
index a67af49..0000000
--- a/doc_release/html/supplements/potential/grdredpol.html
+++ /dev/null
@@ -1,270 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grdredpol — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="POTENTIAL" href="../../SUP_POTENTIAL.html" />
- <link rel="next" title="grdseamount" href="grdseamount.html" />
- <link rel="prev" title="grdgravmag3d" href="grdgravmag3d.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grdseamount.html" title="grdseamount"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grdgravmag3d.html" title="grdgravmag3d"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_POTENTIAL.html" accesskey="U">POTENTIAL</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grdredpol">
-<span id="index-0"></span><h1>grdredpol<a class="headerlink" href="#grdredpol" title="Permalink to this headline">¶</a></h1>
-<p>grdredpol - Compute the Continuous Reduction To the Pole, AKA differential RTP.</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdredpol</strong> <em>anom_grd</em> <strong>-G</strong><em>rtp_grd</em> [<strong>-C</strong><em>dec/dip</em>]
-[<strong>-E</strong><em>dec_grd/dipgrd</em>] [<strong>-F</strong><em><m/n></em>] [<strong>-M</strong><em>m|r</em>]
-[<strong>-N</strong> ] [<strong>-W</strong><em>win_width</em>]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-T</strong><em>year</em> ]
-[ <strong>-Z</strong><em>filtergrd</em> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-n</strong>[<strong>b</strong>|<strong>c</strong>|<strong>l</strong>|<strong>n</strong>][<strong>+a</strong>][<strong>+b</strong><em>BC</em>][<strong>+t</strong><em>threshold</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdredpol</strong> will take a <em>.nc</em> file with a magnetic anomaly and compute
-the reduction to the pole (RTP) anomaly. This anomaly is the one that
-would have been produce if the bodies were magnetized vertically and the
-anomalies were observed at the geomagnetic pole. Standard RTP procedure
-assumes the direction of magnetization to be uniform throughout the
-causative body, and the geomagnetic field to be uniform in direction
-throughout the study region. Although these assumptions are reasonable
-for small areas, they do not hold for large areas.</p>
-<p>In the method used here computations are carried out in both the
-frequency and the space domains. The idea is that a large area may be
-decomposed in small size windows where both the ambient field and the
-magnetization vector change by a very small amount. Inside each of those
-windows, or bins, a set of filter coefficients are calculate and
-reconstruct for each individual point the component filter using a first
-order Taylor series expansion.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>anom_grd</em></dt>
-<dd>The anomaly grid to be converted.</dd>
-<dt><strong>-G</strong><em>rtp_grd</em></dt>
-<dd>is the filename for output grdfile with the RTP solution</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-C</strong><em>dec/dip</em></dt>
-<dd>Use this (constant) declination and inclination angles for both
-field and magnetization. This option consists in the classical RTP
-procedure.</dd>
-<dt><strong>-E</strong><em>dip_grd/dec_grd</em></dt>
-<dd>Get magnetization DIP & DEC from these grids [default: use IGRF].
-Note that these two grids do not need to have the same resolution as
-the anomaly grid. They can be coarser.</dd>
-<dt><strong>-F</strong><em>m/n</em></dt>
-<dd>The filter window size in terms of row/columns. The default value is 25x25.</dd>
-<dt><strong>-M</strong><em>m|r</em></dt>
-<dd>Set boundary conditions. m|r stands for mirror or replicate edges
-(Default is zero padding).</dd>
-<dt><strong>-N</strong></dt>
-<dd>Do NOT use Taylor expansion.</dd>
-<dt><strong>-R</strong><em>west</em>/<em>east</em>/<em>south</em>/<em>north</em></dt>
-<dd>defines the Region of the output points. [Default: Same as input.]</dd>
-<dt><strong>-T</strong><em>year</em></dt>
-<dd>Decimal year used by the IGRF routine to compute the declination and
-inclination at each point [default: 2000]</dd>
-<dt><strong>-W</strong><em>width</em></dt>
-<dd>The size of the moving window in degrees [5].</dd>
-<dt><strong>-Z</strong><em>filter_grd</em></dt>
-<dd>Write the filter file to disk.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-n</strong>[<strong>b</strong>|<strong>c</strong>|<strong>l</strong>|<strong>n</strong>][<strong>+a</strong>][<strong>+b</strong><em>BC</em>][<strong>+c</strong>][<strong>+t</strong><em>threshold</em>] <a class="reference internal" href="../../gmt.html#n-full"><em>(more ...)</em></a></dt>
-<dd>Select interpolation mode for grids.</dd>
-</dl>
-</div>
-<div class="section" id="consequences-of-grid-resampling">
-<h2>Consequences of grid resampling<a class="headerlink" href="#consequences-of-grid-resampling" title="Permalink to this headline">¶</a></h2>
-<p>Resample or sampling of grids will use various algorithms (see <strong>-n</strong>) that may lead
-to possible distortions or unexpected results in the resampled values.
-One expected effect of resampling with splines is the tendency for the new
-resampled values to slightly exceed the global min/max limits of the original
-grid. If this is unacceptable, you can impose clipping of the resampled values
-values so they do not exceed the input min/max values by adding <strong>+c</strong> to
-your <strong>-n</strong> option.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>Suppose that <em>anom.grd</em> is a file with the magnetic anomaly reduced to
-the 2010 epoch and that the <em>dec.grd</em> and <em>dip.grd</em> contain the
-magnetization declination and inclination respectively for an area that
-encloses that of the <em>anom.grd</em>, compute the <em>RTP</em> using bins of 2
-degrees and a filter of 45 coefficients.</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdredpol anom.grd -Grtp.grd -W2 -F45/45 -T2010 -Edec.grd/dip.grd -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>To compute the same <em>RTP</em> but now with the field and magnetization
-vectors collinear and computed from IGRF :</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdredpol anom.grd -Grtp.grd -W2 -F45/45 -T2010 -V
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="reference">
-<h2>Reference<a class="headerlink" href="#reference" title="Permalink to this headline">¶</a></h2>
-<p>Luis, J.L. and Miranda, J.M. (2008), Reevaluation of magnetic chrons in
-the North Atlantic between 35N and 47N: Implications for the formation
-of the Azores Triple Junction and associated plateau. <em>JGR</em>, VOL.
-<strong>113</strong>, B10105, doi:10.1029/2007JB005573</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grdredpol</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#consequences-of-grid-resampling">Consequences of grid resampling</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#reference">Reference</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grdgravmag3d.html"
- title="previous chapter">grdgravmag3d</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grdseamount.html"
- title="next chapter">grdseamount</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/potential/grdredpol.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grdseamount.html" title="grdseamount"
- >next</a> </li>
- <li class="right" >
- <a href="grdgravmag3d.html" title="grdgravmag3d"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_POTENTIAL.html" >POTENTIAL</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/potential/grdseamount.html b/doc_release/html/supplements/potential/grdseamount.html
deleted file mode 100644
index 00e40b3..0000000
--- a/doc_release/html/supplements/potential/grdseamount.html
+++ /dev/null
@@ -1,289 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grdseamount — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="POTENTIAL" href="../../SUP_POTENTIAL.html" />
- <link rel="next" title="SEGY" href="../../SUP_SEGY.html" />
- <link rel="prev" title="grdredpol" href="grdredpol.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="../../SUP_SEGY.html" title="SEGY"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grdredpol.html" title="grdredpol"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_POTENTIAL.html" accesskey="U">POTENTIAL</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grdseamount">
-<span id="index-0"></span><h1>grdseamount<a class="headerlink" href="#grdseamount" title="Permalink to this headline">¶</a></h1>
-<p>grdseamount - Compute synthetic seamount (Gaussian or cone, circular or elliptical) bathymetry</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdseamount</strong> [ <em>intable</em> ]
-<strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]
-<strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>]
-[ <strong>-A</strong>[<em>out/in</em>] ] [ <strong>-C</strong> ] [ <strong>-E</strong> ] [ <strong>-G</strong><em>grdfile</em> ] [ <strong>-L</strong>[<em>cut</em>] ]
-[ <strong>-N</strong><em>norm</em> ] [ <strong>-S</strong><em>scale</em> ] [ <strong>-T</strong>[<em>flattening</em>] ] [ <strong>-Z</strong><em>level</em> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-bi</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-fg</strong> ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-r</strong> ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdseamount</strong> will compute the bathymetry for synthetic seamounts given their shape
-parameters. We read a list with seamount locations and sizes and can evaluate either
-Gaussian or conical shapes, which may be circular or elliptical, and optionally truncated.
-Various scaling options are available to modify the result, including an option to add in
-a background depth. The input must contain <em>lon, lat, radius, height</em> for each seamount.
-For elliptical features (<strong>-E</strong>) we expect <em>lon, lat, azimuth, semi-major, semi-minor,
-radius, height</em> instead. If flattening is specified (<strong>-T</strong>) then a final column with
-flattening is expected.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]</dt>
-<dd><em>x_inc</em> [and optionally <em>y_inc</em>] is the grid spacing. Optionally,
-append a suffix modifier. <strong>Geographical (degrees) coordinates</strong>: Append
-<strong>m</strong> to indicate arc minutes or <strong>s</strong> to indicate arc seconds. If one
-of the units <strong>e</strong>, <strong>f</strong>, <strong>k</strong>, <strong>M</strong>, <strong>n</strong> or <strong>u</strong> is appended
-instead, the increment is assumed to be given in meter, foot, km, Mile,
-nautical mile or US survey foot, respectively, and will be converted to
-the equivalent degrees longitude at the middle latitude of the region
-(the conversion depends on <a class="reference internal" href="../../gmt.conf.html#projection-parameters"><em>PROJ_ELLIPSOID</em></a>). If /<em>y_inc</em> is given
-but set to 0 it will be reset equal to <em>x_inc</em>; otherwise it will be
-converted to degrees latitude. <strong>All coordinates</strong>: If <strong>=</strong> is appended
-then the corresponding max <em>x</em> (<em>east</em>) or <em>y</em> (<em>north</em>) may be slightly
-adjusted to fit exactly the given increment [by default the increment
-may be adjusted slightly to fit the given domain]. Finally, instead of
-giving an increment you may specify the <em>number of nodes</em> desired by
-appending <strong>+</strong> to the supplied integer argument; the increment is then
-recalculated from the number of nodes and the domain. The resulting
-increment value depends on whether you have selected a
-gridline-registered or pixel-registered grid; see <a class="reference internal" href="../../GMT_Docs.html#app-file-formats"><em>B. GMT File Formats</em></a> for
-details. Note: if <strong>-R</strong><em>grdfile</em> is used then the grid spacing has
-already been initialized; use <strong>-I</strong> to override the values.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="../../gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong>[<em>out/in</em>]</dt>
-<dd>Build a mask grid, append outside/inside values [1/NaN].
-Here, height is ignored and <strong>-L</strong>, <strong>-N</strong> and <strong>-Z</strong> are disallowed</dd>
-<dt><strong>-C</strong></dt>
-<dd>Cone model [Default is Gaussian].</dd>
-<dt><strong>-E</strong></dt>
-<dd>Elliptical data format [Default is Circular]. Read lon, lat, azimuth,
-major, minor, height (m) for each seamount.</dd>
-<dt><strong>-G</strong><em>outgrid</em></dt>
-<dd>Sets name of output gridfile.</dd>
-<dt><strong>-L</strong>[<em>cut</em>]</dt>
-<dd>List area, volume, and mean height for each seamount; NO grid is created.
-Optionally, append the noise-floor cutoff level [0].</dd>
-<dt><strong>-N</strong><em>norm</em></dt>
-<dd>Normalize grid so maximum grid height equals <em>norm</em>.</dd>
-<dt><strong>-S</strong><em>scale</em></dt>
-<dd>Sets optional scale factor for radii [1].</dd>
-<dt><strong>-T</strong>[<em>flattening</em>]</dt>
-<dd>Seamounts are to be truncated. Append <em>flattening</em>, otherwise we expect
-it in last input column [no truncation].</dd>
-<dt><strong>-Z</strong><em>level</em></dt>
-<dd>Add in background depth [0].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="../../gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 3 input columns]. This option only applies
-to xyz input files; see <strong>-Z</strong> for z tables.</dd>
-<dt><strong>-fg</strong></dt>
-<dd>Geographic grids (dimensions of longitude, latitude) will be converted to
-km via a “Flat Earth” approximation using the current ellipsoid parameters.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="../../gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). Not used with binary data.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="../../gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-r</strong> <a class="reference internal" href="../../gmt.html#nodereg-full"><em>(more ...)</em></a></dt>
-<dd>Set pixel node registration [gridline]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="../../gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To be added.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="../../gmt.conf.html"><em>gmt.conf</em></a>, <a class="reference internal" href="../../gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="../../grdmath.html"><em>grdmath</em></a>, <a class="reference internal" href="gravfft.html"><em>gravfft</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grdseamount</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grdredpol.html"
- title="previous chapter">grdredpol</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="../../SUP_SEGY.html"
- title="next chapter">SEGY</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/potential/grdseamount.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="../../SUP_SEGY.html" title="SEGY"
- >next</a> </li>
- <li class="right" >
- <a href="grdredpol.html" title="grdredpol"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_POTENTIAL.html" >POTENTIAL</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/segy/pssegy.html b/doc_release/html/supplements/segy/pssegy.html
deleted file mode 100644
index 4065c98..0000000
--- a/doc_release/html/supplements/segy/pssegy.html
+++ /dev/null
@@ -1,357 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>pssegy — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="SEGY" href="../../SUP_SEGY.html" />
- <link rel="next" title="pssegyz" href="pssegyz.html" />
- <link rel="prev" title="SEGY" href="../../SUP_SEGY.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="pssegyz.html" title="pssegyz"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="../../SUP_SEGY.html" title="SEGY"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_SEGY.html" accesskey="U">SEGY</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="pssegy">
-<span id="index-0"></span><h1>pssegy<a class="headerlink" href="#pssegy" title="Permalink to this headline">¶</a></h1>
-<p>pssegy - Plot a SEGY file on a map</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>pssegy</strong> <em>SEGYfile</em> <strong>-J</strong><em>parameters</em>
-<strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>]
-<strong>-D</strong><em>deviation</em>
-<strong>-F</strong>[<em>rgb</em>|<em>gray</em>] <strong>-W</strong>
-[ <strong>-B</strong><em>bias</em> ]
-[ <strong>-C</strong><em>clip</em> ]
-[ <strong>-E</strong><em>error</em> ] [ <strong>-I</strong> ] [ <strong>-K</strong> ] [ <strong>-L</strong><em>nsamp</em> ]
-[ <strong>-M</strong><em>ntrace</em> ] [ <strong>-N</strong> ] [ <strong>-O</strong> ] [ <strong>-P</strong> ]
-[ <strong>-Q</strong><em><mode><value></em> ]
-[ <strong>-S</strong><em>header</em> ]
-[ <strong>-T</strong><em>filename</em> ]
-[ <strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] ]
-[ <strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] ]
-[ <strong>-t</strong>[<em>transp</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>pssegy</strong> reads a native (IEEE) format SEGY file and produces a
-PostScript image of the seismic data. The <em>imagemask</em> operator is used
-so that the seismic data are plotted as a 1-bit deep bitmap in a single
-(user-specified) color or gray shade, with a transparent background. The
-bitmap resolution is taken from the current GMT defaults. The
-seismic traces may be plotted at their true locations using information
-in the trace headers (in which case order of the traces in the file is
-not significant). Standard GMT geometry routines are used so that in
-principle any map projection may be used, however it is likely that the
-geographic projections will lead to unexpected results. Beware also that
-some parameters have non-standard meanings.</p>
-<p>Note that the order of operations before the seismic data are plotted is
-deviation*[clip]([bias]+[normalize](sample value)). Deviation
-determines how far <em>in the plot coordinates</em> a
-[normalized][biased][clipped] sample value of 1 plots from the trace
-location.</p>
-<p>The SEGY file should be a disk image of the tape format (ie 3200 byte
-text header, which is ignored, 400 byte binary reel header, and 240 byte
-header for each trace) with samples as native real*4 (IEEE real on all
-the platforms to which I have access)</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>SEGYfile</em></dt>
-<dd>Seismic data set to be imaged</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-J</strong><em>parameters</em> <a class="reference internal" href="../../gmt.html#j-full"><em>(more ...)</em></a></dt>
-<dd>Select map projection.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]</dt>
-<dd><em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> specify the region of interest,
-and you may specify them in decimal degrees or in
-[+-]dd:mm[:ss.xxx][W|E|S|N] format. Append <strong>r</strong> if lower left
-and upper right map coordinates are given instead of w/e/s/n. The
-two shorthands <strong>-Rg</strong> and <strong>-Rd</strong> stand for global domain (0/360
-and -180/+180 in longitude respectively, with -90/+90 in latitude).
-Alternatively, specify the name of an existing grid file and the
-<strong>-R</strong> settings (and grid spacing, if applicable) are copied from
-the grid. Using <strong>-R</strong><em>unit</em> expects projected (Cartesian)
-coordinates compatible with chosen <strong>-J</strong> and we inversely project
-to determine actual rectangular geographic region.
-For perspective view (<strong>-p</strong>), optionally append /<em>zmin</em>/<em>zmax</em>.
-In case of perspective view (<strong>-p</strong>), a z-range (<em>zmin</em>, <em>zmax</em>)
-can be appended to indicate the third dimension. This needs to be
-done only when using the <strong>-Jz</strong> option, not when using only the
-<strong>-p</strong> option. In the latter case a perspective view of the plane is
-plotted, with no third dimension. </dd>
-<dt><strong>-D</strong><em>deviation</em></dt>
-<dd>gives the deviation in X units of the plot for 1.0 on the scaled
-trace.</dd>
-<dt><strong>-F</strong>[<em>rgb</em>|<em>gray</em>]</dt>
-<dd>Fill trace (variable area, defaults to filling positive). rgb or
-gray gives the color with which the imagemask is filled.</dd>
-<dt><strong>-W</strong></dt>
-<dd>Draw wiggle trace.</dd>
-</dl>
-<p>You <em>must</em> specify at least one of <strong>-W</strong> and <strong>-F</strong>.</p>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong></dt>
-<dd>Flip the default byte-swap state (default assumes data have a
-bigendian byte-order).</dd>
-<dt><strong>-C</strong><em>clip</em></dt>
-<dd>Sample value at which to clip data (clipping is applied to both
-positive and negative values).</dd>
-<dt><strong>-E</strong><em>error</em></dt>
-<dd>Allow <em>error</em> difference between requested and actual trace
-locations when using <strong>-T</strong> option.</dd>
-<dt><strong>-I</strong></dt>
-<dd>Fill negative rather than positive excursions.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-K</strong> <a class="reference internal" href="../../gmt.html#k-full"><em>(more ...)</em></a></dt>
-<dd>Do not finalize the PostScript plot.</dd>
-<dt><strong>-L</strong></dt>
-<dd>Override number of samples per trace in reel header (program
-attempts to determine number of samples from each trace header if
-possible to allow for variable length traces).</dd>
-<dt><strong>-M</strong></dt>
-<dd>Override number of traces specified in reel header. Program detects
-end of file (relatively) gracefully, but this parameter limits
-number of traces that the program attempts to read.</dd>
-<dt><strong>-N</strong></dt>
-<dd>Normalize trace by dividing by rms amplitude over full trace length.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-O</strong> <a class="reference internal" href="../../gmt.html#o-full"><em>(more ...)</em></a></dt>
-<dd>Append to existing PostScript plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-P</strong> <a class="reference internal" href="../../gmt.html#p-full"><em>(more ...)</em></a></dt>
-<dd>Select “Portrait” plot orientation.</dd>
-<dt><strong>-Q</strong><em><mode><value></em></dt>
-<dd><dl class="first last docutils">
-<dt>Can be used to change 4 different settings:</dt>
-<dd><p class="first"><strong>-Qb</strong><em><bias></em> to bias scaled traces (-B-0.1 subtracts 0.1 from values)</p>
-<p><strong>-Qu</strong><em><redvel></em> to apply reduction velocity (-ve removes reduction already present)</p>
-<p><strong>-Qx</strong><em><mult></em> to multiply trace locations by <em>mult</em></p>
-<p class="last"><strong>-Qy</strong><em><dy></em> to override sample interval in reel header.</p>
-</dd>
-</dl>
-</dd>
-<dt><strong>-S</strong><em>header</em></dt>
-<dd>Read trace locations from trace headers: header is either c for CDP,
-o for offset, or b<num> to read a long starting at byte <num> in the
-header (first byte corresponds to num=0). Default has location given
-by trace number.</dd>
-<dt><strong>-T</strong><em>filename</em></dt>
-<dd>Plot only traces whose location corresponds to a list given in
-<em>filename</em>. Order in which traces are listed is not significant -
-the entire space is checked for each trace.</dd>
-<dt><strong>-U</strong><em>redvel</em></dt>
-<dd>Apply reduction velocity by shifting traces <em>upwards</em> by
-redvel/|offset|. Negative velocity removes existing reduction.
-Units should be consistent with offset in trace header and sample
-interval.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<p><strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]]</p>
-<dl class="docutils">
-<dt><strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] <a class="reference internal" href="../../gmt.html#xy-full"><em>(more ...)</em></a></dt>
-<dd>Shift plot origin.</dd>
-<dt><strong>-Z</strong></dt>
-<dd>Do not plot traces with zero rms amplitude.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] <a class="reference internal" href="../../gmt.html#perspective-full"><em>(more ...)</em></a></dt>
-<dd>Select perspective view. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-t</strong>[<em>transp</em>] <a class="reference internal" href="../../gmt.html#t-full"><em>(more ...)</em></a></dt>
-<dd>Set PDF transparency level in percent.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To plot the SEGY file wa1.segy with normalized traces plotted at true
-offset locations, clipped at +-3 and with wiggle trace and positive
-variable area shading in black, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt pssegy wa1.segy -JX5i/-5i -R0/100/0/10 -D1 -C3 -N -So -W -Fblack > segy.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>To plot the SEGY file wa1.segy with traces plotted at true cdp*0.1,
-clipped at +-3, with bias -1 and negative variable area shaded red, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt pssegy wa1.segy -JX5i/-5i -R0/100/0/10 -D1 -C3 -Sc -X0.1 -Fred -B-1 -I > segy.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="../../gmt.html"><em>gmt</em></a>, <a class="reference internal" href="pssegyz.html"><em>pssegyz</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">pssegy</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="../../SUP_SEGY.html"
- title="previous chapter">SEGY</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="pssegyz.html"
- title="next chapter">pssegyz</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/segy/pssegy.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="pssegyz.html" title="pssegyz"
- >next</a> </li>
- <li class="right" >
- <a href="../../SUP_SEGY.html" title="SEGY"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_SEGY.html" >SEGY</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/segy/pssegyz.html b/doc_release/html/supplements/segy/pssegyz.html
deleted file mode 100644
index 41f72ce..0000000
--- a/doc_release/html/supplements/segy/pssegyz.html
+++ /dev/null
@@ -1,355 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>pssegyz — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="SEGY" href="../../SUP_SEGY.html" />
- <link rel="next" title="segy2grd" href="segy2grd.html" />
- <link rel="prev" title="pssegy" href="pssegy.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="segy2grd.html" title="segy2grd"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="pssegy.html" title="pssegy"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_SEGY.html" accesskey="U">SEGY</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="pssegyz">
-<span id="index-0"></span><h1>pssegyz<a class="headerlink" href="#pssegyz" title="Permalink to this headline">¶</a></h1>
-<p>pssegyz - Create imagemasked postscript from SEGY file</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>pssegyz</strong> <em>SEGYfile</em> <strong>-J</strong><em>parameters</em>
-<strong>-Jz</strong>|<strong>Z</strong><em>parameters</em>
-<strong>-R</strong><em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]
-<strong>-D</strong><em>deviation</em> <strong>-F</strong>[<em>rgb</em>|<em>gray</em>] <strong>-W</strong>
-[ <strong>-B</strong><em>bias</em> ]
-[ <strong>-C</strong><em>clip</em> ] [ <strong>-I</strong> ] [ <strong>-K</strong> ] [ <strong>-L</strong><em>nsamp</em> ]
-[ <strong>-M</strong><em>ntrace</em> ] [ <strong>-N</strong> ] [ <strong>-O</strong> ] [ <strong>-P</strong> ]
-[ <strong>-Q</strong><em><mode><value></em> ]
-[ <strong>-S</strong><em>header_x</em>/<em>header_y</em> ]
-[ <strong>-U</strong>[<em>just</em>/<em>dx</em>/<em>dy</em>/][<strong>c</strong>|<em>label</em>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] ]
-[ <strong>-Z</strong> ]
-[ <strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] ]
-[ <strong>-t</strong>[<em>transp</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>pssegyz</strong> reads a native (IEEE) format SEGY file and produces a
-PostScript image of the seismic data. The <em>imagemask</em> operator is used
-so that the seismic data are plotted as a 1-bit deep bitmap in a single
-(user-specified) color or gray shade, with a transparent background. The
-bitmap resolution is taken from the current GMT defaults. The
-seismic traces may be plotted at their true locations using information
-in the trace headers (in which case order of the traces in the file is
-not significant). Standard GMT geometry routines are used so that in
-principle any map projection may be used, however it is likely that the
-geographic projections will lead to unexpected results. Beware also that
-some parameters have non-standard meanings, and a couple of the options
-for <strong>pssegy</strong> are not available in <strong>pssegyz</strong>.</p>
-<p>Note that the order of operations before the seismic data are plotted is
-deviation*[clip]([bias]+[normalize](sample value)). Deviation
-determines how far <em>in the plot coordinates</em> a
-[normalized][biased][clipped] sample value of 1 plots from the trace
-location.</p>
-<p>The SEGY file should be a disk image of the tape format (ie 3200 byte
-text header, which is ignored, 400 byte binary reel header, and 240 byte
-header for each trace) with samples as native real*4 (IEEE real on all
-the platforms to which I have access)</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>SEGYfile</em></dt>
-<dd>Seismic data set to be imaged</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-J</strong><em>parameters</em> <a class="reference internal" href="../../gmt.html#j-full"><em>(more ...)</em></a></dt>
-<dd>Select map projection.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]</dt>
-<dd><em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> specify the region of interest,
-and you may specify them in decimal degrees or in
-[+-]dd:mm[:ss.xxx][W|E|S|N] format. Append <strong>r</strong> if lower left
-and upper right map coordinates are given instead of w/e/s/n. The
-two shorthands <strong>-Rg</strong> and <strong>-Rd</strong> stand for global domain (0/360
-and -180/+180 in longitude respectively, with -90/+90 in latitude).
-Alternatively, specify the name of an existing grid file and the
-<strong>-R</strong> settings (and grid spacing, if applicable) are copied from
-the grid. Using <strong>-R</strong><em>unit</em> expects projected (Cartesian)
-coordinates compatible with chosen <strong>-J</strong> and we inversely project
-to determine actual rectangular geographic region.
-For perspective view (<strong>-p</strong>), optionally append /<em>zmin</em>/<em>zmax</em>.
-In case of perspective view (<strong>-p</strong>), a z-range (<em>zmin</em>, <em>zmax</em>)
-can be appended to indicate the third dimension. This needs to be
-done only when using the <strong>-Jz</strong> option, not when using only the
-<strong>-p</strong> option. In the latter case a perspective view of the plane is
-plotted, with no third dimension. </dd>
-<dt><strong>-D</strong><em>deviation</em></dt>
-<dd>gives the deviation in X units of the plot for 1.0 on the scaled
-trace, This may be a single number (applied equally in X and Y
-directions) or devX/devY</dd>
-<dt><strong>-F</strong>[<em>rgb</em>|<em>gray</em>]</dt>
-<dd>Fill trace (variable area, defaults to filling positive). rgb or
-gray gives the color with which the imagemask is filled.</dd>
-<dt><strong>-W</strong></dt>
-<dd>Draw wiggle trace.</dd>
-</dl>
-<p>You <em>must</em> specify at least one of <strong>-W</strong> and <strong>-F</strong>.</p>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong></dt>
-<dd>Flip the default byte-swap state (default assumes data have a
-bigendian byte-order).</dd>
-<dt><strong>-C</strong><em>clip</em></dt>
-<dd>Sample value at which to clip data (clipping is applied to both
-positive and negative values).</dd>
-<dt><strong>-I</strong></dt>
-<dd>Fill negative rather than positive excursions.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-K</strong> <a class="reference internal" href="../../gmt.html#k-full"><em>(more ...)</em></a></dt>
-<dd>Do not finalize the PostScript plot.</dd>
-<dt><strong>-L</strong><em>nsamp</em></dt>
-<dd>Override number of samples per trace in reel header (program
-attempts to determine number of samples from each trace header if
-possible to allow for variable length traces).</dd>
-<dt><strong>-M</strong><em>ntrace</em></dt>
-<dd>Override number of traces specified in reel header. Program detects
-end of file (relatively) gracefully, but this parameter limits
-number of traces that the program attempts to read.</dd>
-<dt><strong>-N</strong></dt>
-<dd>Normalize trace by dividing by rms amplitude over full trace length.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-O</strong> <a class="reference internal" href="../../gmt.html#o-full"><em>(more ...)</em></a></dt>
-<dd>Append to existing PostScript plot.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-P</strong> <a class="reference internal" href="../../gmt.html#p-full"><em>(more ...)</em></a></dt>
-<dd>Select “Portrait” plot orientation.</dd>
-<dt><strong>-Q</strong><em><mode><value></em></dt>
-<dd><dl class="first last docutils">
-<dt>Can be used to change 4 different settings:</dt>
-<dd><p class="first"><strong>-Qb</strong><em><bias></em> to bias scaled traces (-B-0.1 subtracts 0.1 from values)</p>
-<p><strong>-Qu</strong><em><redvel></em> to apply reduction velocity (-ve removes reduction already present)</p>
-<p><strong>-Qx</strong><em><mult></em> to multiply trace locations by <em>mult</em></p>
-<p class="last"><strong>-Qy</strong><em><dy></em> to override sample interval in reel header.</p>
-</dd>
-</dl>
-</dd>
-<dt><strong>-S</strong><em>header_x</em>/<em>header_y</em></dt>
-<dd>Read trace locations from trace headers: header is either c for CDP,
-o for offset, b<num> to read a long starting at byte <num> in the
-header (first byte corresponds to num=0), or a number to fix the
-location. First parameter for x, second for y. Default has X and Y
-given by trace number.</dd>
-<dt><strong>-U</strong><em>redvel</em></dt>
-<dd>Apply reduction velocity by shifting traces <em>upwards</em> by
-redvel/|offset|. Negative velocity removes existing reduction.
-Units should be consistent with offset in trace header and sample
-interval.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<p><strong>-X</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>x-shift</em>[<strong>u</strong>]]</p>
-<dl class="docutils">
-<dt><strong>-Y</strong>[<strong>a</strong>|<strong>c</strong>|<strong>f</strong>|<strong>r</strong>][<em>y-shift</em>[<strong>u</strong>]] <a class="reference internal" href="../../gmt.html#xy-full"><em>(more ...)</em></a></dt>
-<dd>Shift plot origin.</dd>
-<dt><strong>-Z</strong></dt>
-<dd>Do not plot traces with zero rms amplitude.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-p</strong>[<strong>x</strong>|<strong>y</strong>|<strong>z</strong>]<em>azim</em>/<em>elev</em>[/<em>zlevel</em>][<strong>+w</strong><em>lon0</em>/<em>lat0</em>[/<em>z0</em>]][<strong>+v</strong><em>x0</em>/<em>y0</em>] <a class="reference internal" href="../../gmt.html#perspective-full"><em>(more ...)</em></a></dt>
-<dd>Select perspective view. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-t</strong>[<em>transp</em>] <a class="reference internal" href="../../gmt.html#t-full"><em>(more ...)</em></a></dt>
-<dd>Set PDF transparency level in percent.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To plot the SEGY file wa1.segy with normalized traces plotted at true
-offset locations, clipped at +-3 and with wiggle trace and positive
-variable area shading in black, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>pssegyz wa1.segy -JX5i/-5i -D1 -Jz0.05i -E180/5 -R0/100/0/10/0/10 \
- -C3 -N -So -W -Fblack > segy.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="bugs">
-<h2>Bugs<a class="headerlink" href="#bugs" title="Permalink to this headline">¶</a></h2>
-<p>Variable area involves filling four-sided figures of distressing
-generality. I <em>know</em> that some of the more complex degenerate cases are
-not dealt with correctly or at all; the incidence of such cases
-increases as viewing angles become more oblique, and particularly as the
-viewing elevation increases. Wiggle-trace plotting is not affected.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="../../gmt.html"><em>gmt</em></a>, <a class="reference internal" href="pssegy.html"><em>pssegy</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">pssegyz</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#bugs">Bugs</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="pssegy.html"
- title="previous chapter">pssegy</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="segy2grd.html"
- title="next chapter">segy2grd</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/segy/pssegyz.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="segy2grd.html" title="segy2grd"
- >next</a> </li>
- <li class="right" >
- <a href="pssegy.html" title="pssegy"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_SEGY.html" >SEGY</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/segy/segy2grd.html b/doc_release/html/supplements/segy/segy2grd.html
deleted file mode 100644
index b913281..0000000
--- a/doc_release/html/supplements/segy/segy2grd.html
+++ /dev/null
@@ -1,290 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>segy2grd — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="SEGY" href="../../SUP_SEGY.html" />
- <link rel="next" title="SPOTTER" href="../../SUP_SPOTTER.html" />
- <link rel="prev" title="pssegyz" href="pssegyz.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="../../SUP_SPOTTER.html" title="SPOTTER"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="pssegyz.html" title="pssegyz"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_SEGY.html" accesskey="U">SEGY</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="segy2grd">
-<span id="index-0"></span><h1>segy2grd<a class="headerlink" href="#segy2grd" title="Permalink to this headline">¶</a></h1>
-<p>segy2grd - Converting SEGY data to a GMT grid</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>segy2grd</strong> <em>segyfile</em> <strong>-G</strong><em>grdfile</em>
-<strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]
-<strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>]
-[ <strong>-A</strong>[<strong>n</strong>|<strong>z</strong>] ]
-[ <strong>-D</strong><em>xname</em>/<em>yname</em>/<em>zname</em>/<em>scale</em>/<em>offset</em>/<em>title</em>/<em>remark</em> ]
-[ <strong>-M</strong>[<em>flags</em>] ] [ <strong>-N</strong><em>nodata</em> ] [ <strong>-S</strong>[<em>zfile</em>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-bi</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>segy2grd</strong> reads an IEEE SEGY file and creates a binary grid file.
-Either a simple mapping (equivalent to xyz2grd -Z) or a more complicated
-averaging where a particular grid cell includes values from more than
-one sample in the SEGY file can be done. <strong>segy2grd</strong> will report if
-some of the nodes are not filled in with data. Such unconstrained nodes
-are set to a value specified by the user [Default is NaN]. Nodes with
-more than one value will be set to the average value.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<p><em>segyfile</em> is an IEEE floating point SEGY file. Traces are all assumed to start at 0 time/depth.</p>
-<dl class="docutils">
-<dt><strong>-G</strong><em>grdfile</em></dt>
-<dd><em>grdfile</em> is the name of the binary output grid file.</dd>
-<dt><strong>-I</strong></dt>
-<dd><em>x_inc</em> [and optionally <em>y_inc</em>] is the grid spacing. Append <strong>m</strong>
-to indicate minutes or <strong>c</strong> to indicate seconds.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]</dt>
-<dd><em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> specify the region of interest,
-and you may specify them in decimal degrees or in
-[+-]dd:mm[:ss.xxx][W|E|S|N] format. Append <strong>r</strong> if lower left
-and upper right map coordinates are given instead of w/e/s/n. The
-two shorthands <strong>-Rg</strong> and <strong>-Rd</strong> stand for global domain (0/360
-and -180/+180 in longitude respectively, with -90/+90 in latitude).
-Alternatively, specify the name of an existing grid file and the
-<strong>-R</strong> settings (and grid spacing, if applicable) are copied from
-the grid. Using <strong>-R</strong><em>unit</em> expects projected (Cartesian)
-coordinates compatible with chosen <strong>-J</strong> and we inversely project
-to determine actual rectangular geographic region.
-For perspective view (<strong>-p</strong>), optionally append /<em>zmin</em>/<em>zmax</em>.
-In case of perspective view (<strong>-p</strong>), a z-range (<em>zmin</em>, <em>zmax</em>)
-can be appended to indicate the third dimension. This needs to be
-done only when using the <strong>-Jz</strong> option, not when using only the
-<strong>-p</strong> option. In the latter case a perspective view of the plane is
-plotted, with no third dimension. </dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong>[<strong>n</strong>|<strong>z</strong>]</dt>
-<dd>Add up multiple values that belong to the same node (same as
-<strong>-Az</strong>). Append <strong>n</strong> to simply count the number of data points
-that were assigned to each node. [Default (no <strong>-A</strong> option) will
-calculate mean value]. Not used for simple mapping.</dd>
-<dt><strong>-D</strong><em>xname</em>/<em>yname</em>/<em>zname</em>/<em>scale</em>/<em>offset</em>/<em>title</em>/<em>remark</em></dt>
-<dd>Give values for <em>xname</em>, <em>yname</em>, <em>zname</em>, <em>scale</em>, <em>offset</em>,
-<em>title</em>, and <em>remark</em>. To leave some of these values untouched,
-specify = as the value.</dd>
-<dt><strong>-M</strong>[<em>flags</em>]</dt>
-<dd>Fix number of traces to read in. Default tries to read 10000 traces.
-<strong>-M</strong>0 will read number in binary header, <strong>-M</strong><em>n</em> will
-attempt to read only <em>n</em> traces.</dd>
-<dt><strong>-N</strong><em>nodata</em></dt>
-<dd>No data. Set nodes with no input sample to this value [Default is
-NaN].</dd>
-<dt><strong>-S</strong>[<em>zfile</em>]</dt>
-<dd>set variable spacing <em>header</em> is c for cdp, o for offset, b<number>
-for 4-byte float starting at byte number If -S not set, assumes even
-spacing of samples at the dx, dy supplied with -I</dd>
-<dt><strong>-L</strong></dt>
-<dd>Override number of samples in each trace</dd>
-<dt><strong>-X</strong></dt>
-<dd>applies scalar <em>x-scale</em> to coordinates in trace header to match the
-coordinates specified in -R</dd>
-<dt><strong>-Y</strong></dt>
-<dd>Specifies sample interval as <em>s_int</em> if incorrect in the SEGY file</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-r</strong> <a class="reference internal" href="../../gmt.html#nodereg-full"><em>(more ...)</em></a></dt>
-<dd>Set pixel node registration [gridline]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To create a grid file from an even spaced SEGY file test.segy, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt segy2grd test.segy -I0.1/0.1 -Gtest.nc -R198/208/18/25 -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>Note that this will read in 18-25s (or km) on each trace, but the
-first trace will be assumed to be at X=198</p>
-<p>To create a grid file from the SEGY file test.segy, locating traces
-according to the CDP number, where there are 10 CDPs per km and the
-sample interval is 0.1, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt segy2grd test.segy -Gtest.nc -R0/100/0/10 -I0.5/0.2 -V -X0.1 -Y0.1
-</pre></div>
-</div>
-</div></blockquote>
-<p>Because the grid interval is larger than the SEGY file sampling, the
-individual samples will be averaged in bins</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="../../gmt.html"><em>gmt</em></a>, <a class="reference internal" href="../../grd2xyz.html"><em>grd2xyz</em></a>,
-<a class="reference internal" href="../../grdedit.html"><em>grdedit</em></a>, <a class="reference internal" href="pssegy.html"><em>pssegy</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">segy2grd</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="pssegyz.html"
- title="previous chapter">pssegyz</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="../../SUP_SPOTTER.html"
- title="next chapter">SPOTTER</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/segy/segy2grd.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="../../SUP_SPOTTER.html" title="SPOTTER"
- >next</a> </li>
- <li class="right" >
- <a href="pssegyz.html" title="pssegyz"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_SEGY.html" >SEGY</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/spotter/backtracker.html b/doc_release/html/supplements/spotter/backtracker.html
deleted file mode 100644
index 9205f00..0000000
--- a/doc_release/html/supplements/spotter/backtracker.html
+++ /dev/null
@@ -1,370 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>backtracker — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="SPOTTER" href="../../SUP_SPOTTER.html" />
- <link rel="next" title="grdpmodeler" href="grdpmodeler.html" />
- <link rel="prev" title="SPOTTER" href="../../SUP_SPOTTER.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grdpmodeler.html" title="grdpmodeler"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="../../SUP_SPOTTER.html" title="SPOTTER"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_SPOTTER.html" accesskey="U">SPOTTER</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="backtracker">
-<span id="index-0"></span><h1>backtracker<a class="headerlink" href="#backtracker" title="Permalink to this headline">¶</a></h1>
-<p>backtracker - Generate forward and backward flowlines and hotspot tracks</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>backtracker</strong> [ <em>table</em> ] <strong>-E</strong><em>rot_file</em>|<em>lon</em>/<em>lat</em>/<em>angle</em>
-[ <strong>-A</strong>[<em>young</em>/<em>old</em>] ] [
-<strong>-Df</strong>|<strong>b</strong> ] [ <strong>-F</strong><em>drift.txt</em> ] [
-<strong>-Lf</strong>|<strong>b</strong><em>step</em> ] [ <strong>-N</strong><em>upper_age</em> ] [
-<strong>-Q</strong><em>fixed_age</em> ] [ <strong>-S</strong><em>filestem</em> ] [ <strong>-T</strong><em>zero_age</em> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W</strong>[<strong>a</strong>|<strong>t</strong>] ]
-[ <strong>-b</strong>[<strong>i</strong>|<strong>o</strong>][<em>ncol</em>][<strong>type</strong>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-o</strong><em>cols</em>[,...] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>backtracker</strong> reads (longitude, latitude, age) positions from
-<em>infiles</em> [or standard input] and computes rotated (x,y,t) coordinates
-using the specified rotation parameters. It can either calculate final
-positions [Default] or create a sampled track (flowline or hotspot
-track) between the initial and final positions. The former mode allows
-additional data fields after the first 3 columns which must have
-(longitude,latitude,age). See option <strong>-:</strong> on how to read
-(latitude,longitude,age) files.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-E</strong><em>rotfile</em></dt>
-<dd><p class="first">Give file with rotation parameters. This file must contain one
-record for each rotation; each record must be of the following
-format:</p>
-<p><em>lon lat tstart [tstop] angle</em> [ <em>khat a b c d e f g df</em> ]</p>
-<p class="last">where <em>tstart</em> and <em>tstop</em> are in Myr and <em>lon lat angle</em> are in
-degrees. <em>tstart</em> and <em>tstop</em> are the ages of the old and young ends
-of a stage. If <em>tstop</em> is not present in the record then a total
-reconstruction rotation is expected and <em>tstop</em> is implicitly set to
-0 and should not be specified for any of the records in the file. If
-a covariance matrix <strong>C</strong> for the rotation is available it must be
-specified in a format using the nine optional terms listed in
-brackets. Here, <strong>C</strong> = (<em>g</em>/<em>khat</em>)*[ <em>a b d; b c e; d e f</em> ]
-which shows <strong>C</strong> made up of three row vectors. If the degrees of
-freedom (<em>df</em>) in fitting the rotation is 0 or not given it is set
-to 10000. Blank lines and records whose first column contains # will
-be ignored. You may prepend a leading + to the filename to indicate
-you wish to invert the rotations.
-Alternative 1: Give the filename composed of two plate IDs
-separated by a hyphen (e.g., PAC-MBL) and we will instead extract
-that rotation from the GPlates rotation database. We return an error
-if the rotation cannot be found.
-Alternative 2: Specify <em>lon</em>/<em>lat</em>/<em>angle</em>, i.e., the longitude,
-latitude, and opening angle (all in degrees and separated by /) for
-a single total reconstruction rotation.</p>
-</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>[<em>ncols</em>][<em>type</em>]) data
-table file(s) holding a number of data columns. If no tables are given
-then we read from standard input. </dd>
-<dt><strong>-A</strong>[<em>young</em>/<em>old</em>]</dt>
-<dd>Used in conjunction with <strong>-Lb</strong>|<strong>f</strong> to limit the track
-output to those sections whose predicted ages lie between the
-specified <em>young</em> and <em>old</em> limits. If <strong>-LB</strong>|<strong>F</strong> is used
-instead then the limits apply to the stage ids (id 1 is the youngest
-stage). If no limits are specified then individual limits for each
-record are expected in columns 4 and 5 of the input file.</dd>
-<dt><strong>-Df</strong>|<strong>b</strong></dt>
-<dd>Set the direction to go: <strong>-Df</strong> will go backward in time (from
-younger to older positions), while <strong>-Db</strong> will go forward in time
-(from older to younger positions) [Default]. Note: For <strong>-Db</strong> you
-are specifying the age at the given location, whereas for <strong>-Df</strong>
-you are not; instead you specify the age at the reconstructed point.</dd>
-<dt><strong>-F</strong><em>drift.txt</em></dt>
-<dd>Supply a file with lon, lat, age records that describe the history
-of hotspot motion for the current hotspot. The reconstructions will
-only use the 3rd data input column (i.e., the age) to obtain the
-location of the hotspot at that time, via an interpolation of the
-hotspot motion history. This adjusted location is then used to
-reconstruct the point or path [No drift].</dd>
-<dt><strong>-Lf</strong>|<strong>b</strong><em>step</em></dt>
-<dd>Specify a sampled path between initial and final position: <strong>-Lf</strong>
-will draw particle flowlines, while <strong>-Lb</strong> will draw backtrack
-(hotspot track) paths. Append sampling interval in km. If <em>step</em> < 0
-then only the rotation times will be returned. When <strong>-LF</strong> or
-<strong>-LB</strong> is used, the third output column will contain the stage id
-(1 is youngest) [Default is along-track predicted ages]. You can
-control the direction of the paths by using <strong>-D</strong>.</dd>
-<dt><strong>-N</strong><em>upper_age</em></dt>
-<dd>Set the maximum age to extend the oldest stage rotation back in time
-[Default is no extension].</dd>
-<dt><strong>-Q</strong><em>fixed_age</em></dt>
-<dd>Assign a fixed age to all positions. Only lon, lat input is expected
-[Default expects longitude, latitude, age]. Useful when the input
-are points defining isochrons.</dd>
-<dt><strong>-S</strong><em>filestem</em></dt>
-<dd>When <strong>-L</strong> is set, the tracks are normally written to <em>stdout</em> as a
-multisegment file. Specify a <em>filestem</em> to have each track written
-to <em>filestem.#</em>, where <em>#</em> is the track number. The track number is
-also copied to the 4th output column.</dd>
-<dt><strong>-T</strong><em>zero_age</em></dt>
-<dd>Set the current time [Default is 0 Ma].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong>[<strong>a</strong>|<strong>t</strong>]</dt>
-<dd>Rotates the given input (lon,lat,t) and calculates the confidence
-ellipse for the projected point. The input point <em>must</em> have a time
-coordinate that exactly matches a particular total reconstruction
-rotation time, otherwise the point will be skipped. Append <strong>t</strong> or
-<strong>a</strong> to output time or angle, respectively, after the projected
-lon, lat. After these 2-3 items, we write azimuth, major, minor (in
-km) for the 95% confidence ellipse. See <strong>-D</strong> for the direction of
-rotation.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="../../gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 3 input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="../../gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. [Default is same as input].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="../../gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="../../gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-o</strong><em>cols</em>[,...] <a class="reference internal" href="../../gmt.html#ocols-full"><em>(more ...)</em></a></dt>
-<dd>Select output columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="../../gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc11">Geodetic versus Geocentric Coordiinates</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>All spherical rotations are applied to geocentric coordinates.
-This means that incoming data points and grids are considered
-to represent geodetic coordinates and must first
-be converted to geocentric coordinates. Rotations are then applied, and the
-final reconstructed points are converted back to geodetic
-coordinates. This default behavior can be bypassed if the
-ellipsoid setting <a class="reference internal" href="../../gmt.conf.html#projection-parameters"><em>PROJ_ELLIPSOID</em></a>
-is changed to Sphere.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To backtrack the (x,y,t) points in the file seamounts.d to their origin
-(presumably the hotspot), using the DC85.d Euler poles, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt backtracker seamounts.d -Db -EDC85.d > newpos.d
-</pre></div>
-</div>
-</div></blockquote>
-<p>To project flowlines forward from the (x,y,t) points stored in several
-3-column, binary, double precision files, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt backtracker points.gmt \* -Df -EDC85.d -Lf25 -bo -bi3 > lines.b
-</pre></div>
-</div>
-</div></blockquote>
-<p>This file can then be plotted with <strong>psxy</strong>.
-To compute the predicted Hawaiian hotspot track from 0 to 80 Ma every 1
-Ma, given a history of hotspot motion file (HIdrift.txt) and a set of
-total reconstruction rotations for the plate (PAC_APM.d), try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>echo 204 19 80 | gmt backtracker -Df -EPAC_APM.d -Lb1 > path.d
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="../../gmt.html"><em>gmt</em></a> ,
-<a class="reference internal" href="../../project.html"><em>project</em></a> ,
-<a class="reference internal" href="grdrotater.html"><em>grdrotater</em></a>,
-<a class="reference internal" href="grdspotter.html"><em>grdspotter</em></a>,
-<a class="reference internal" href="../../mapproject.html"><em>mapproject</em></a>,
-<a class="reference internal" href="hotspotter.html"><em>hotspotter</em></a>,
-<a class="reference internal" href="originator.html"><em>originator</em></a></p>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>Wessel, P., 1999, “Hotspotting” tools released, EOS Trans. AGU, 80 (29),
-p. 319.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">backtracker</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#id1">Geodetic versus Geocentric Coordiinates</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="../../SUP_SPOTTER.html"
- title="previous chapter">SPOTTER</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grdpmodeler.html"
- title="next chapter">grdpmodeler</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/spotter/backtracker.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grdpmodeler.html" title="grdpmodeler"
- >next</a> </li>
- <li class="right" >
- <a href="../../SUP_SPOTTER.html" title="SPOTTER"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_SPOTTER.html" >SPOTTER</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/spotter/grdpmodeler.html b/doc_release/html/supplements/spotter/grdpmodeler.html
deleted file mode 100644
index a9e22ae..0000000
--- a/doc_release/html/supplements/spotter/grdpmodeler.html
+++ /dev/null
@@ -1,317 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grdpmodeler — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="SPOTTER" href="../../SUP_SPOTTER.html" />
- <link rel="next" title="grdrotater" href="grdrotater.html" />
- <link rel="prev" title="backtracker" href="backtracker.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grdrotater.html" title="grdrotater"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="backtracker.html" title="backtracker"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_SPOTTER.html" accesskey="U">SPOTTER</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grdpmodeler">
-<span id="index-0"></span><h1>grdpmodeler<a class="headerlink" href="#grdpmodeler" title="Permalink to this headline">¶</a></h1>
-<p>grdpmodeler - Evaluate a plate model on a geographic grid</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdpmodeler</strong> <em>agegrdfile</em> <strong>-E</strong><em>rot_file</em> <strong>-G</strong><em>outgrdfile</em>
-<strong>-S</strong><strong>a</strong>|<strong>d</strong>|<strong>r</strong>|<strong>w</strong>|<strong>x</strong>|<strong>y</strong>|<strong>X</strong>|<strong>Y</strong>
-[ <strong>-F</strong><em>polygonfile</em> ] [ <strong>-T</strong><em>age</em> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-b</strong>[<strong>i</strong>|<strong>o</strong>][<em>ncol</em>][<strong>type</strong>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdpmodeler</strong> reads a geographical age grid and a plate motion model
-and evaluates one of several model predictions. Optionally, the user may
-supply a clipping polygon in multiple-segment format; then, only the
-part of the grid inside the polygon is used to determine the model
-prediction; the remainder of the grid is set to NaN.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>ingrdfile</em></dt>
-<dd>Name of a grid file in geographical (lon, lat) coordinates with ages
-in Myr.</dd>
-<dt><strong>-E</strong><em>rotfile</em></dt>
-<dd><p class="first">Give file with rotation parameters. This file must contain one
-record for each rotation; each record must be of the following
-format:</p>
-<p><em>lon lat tstart [tstop] angle</em> [ <em>khat a b c d e f g df</em> ]</p>
-<p class="last">where <em>tstart</em> and <em>tstop</em> are in Myr and <em>lon lat angle</em> are in
-degrees. <em>tstart</em> and <em>tstop</em> are the ages of the old and young ends
-of a stage. If <em>tstop</em> is not present in the record then a total
-reconstruction rotation is expected and <em>tstop</em> is implicitly set to
-0 and should not be specified for any of the records in the file. If
-a covariance matrix <strong>C</strong> for the rotation is available it must be
-specified in a format using the nine optional terms listed in
-brackets. Here, <strong>C</strong> = (<em>g</em>/<em>khat</em>)*[ <em>a b d; b c e; d e f</em> ]
-which shows <strong>C</strong> made up of three row vectors. If the degrees of
-freedom (<em>df</em>) in fitting the rotation is 0 or not given it is set
-to 10000. Blank lines and records whose first column contains # will
-be ignored. You may prepend a leading + to the filename to indicate
-you wish to invert the rotations.
-Alternatively, give the filename composed of two plate IDs
-separated by a hyphen (e.g., PAC-MBL) and we will instead extract
-that rotation from the GPlates rotation database. We return an error
-if the rotation cannot be found.</p>
-</dd>
-<dt><strong>-G</strong><em>outgrdfile</em></dt>
-<dd>Name of output grid. This is the grid with the model predictions
-given the specified rotations.</dd>
-<dt><strong>-S</strong><strong>a</strong>|<strong>d</strong>|<strong>r</strong>|<strong>w</strong>|<strong>x</strong>|<strong>y</strong>|<strong>X</strong>|<strong>Y</strong></dt>
-<dd>Type of model prediction. Choose from <strong>a</strong> for plate motion
-azimuth, <strong>d</strong> for distance between current locations and their
-origin at the ridge (in km), <strong>r</strong> for plate motion rate (in mm/yr),
-<strong>w</strong> for plate rotation rate (degree/Myr), <strong>x</strong> change in
-longitude relative to location of crust formation, <strong>y</strong> change in
-latitude relative to location of crust formation, <strong>X</strong> longitude of
-crust formation, and <strong>Y</strong> latitude of crust formation.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-F</strong><em>polygonfile</em></dt>
-<dd>Specify a multisegment closed polygon file that describes the inside
-area of the grid where the model should be evaluated; the outside
-will be set to NaN [Default evaluates model on the entire grid].</dd>
-<dt><strong>-T</strong><em>age</em></dt>
-<dd>Use a fixed age for model evaluation (i.e., override the ages in the
-age grid). This lets you evaluate the model at a snapshot in time.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="../../gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 2 input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="../../gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="../../gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc11">Geodetic versus Geocentric Coordiinates</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>All spherical rotations are applied to geocentric coordinates.
-This means that incoming data points and grids are considered
-to represent geodetic coordinates and must first
-be converted to geocentric coordinates. Rotations are then applied, and the
-final reconstructed points are converted back to geodetic
-coordinates. This default behavior can be bypassed if the
-ellipsoid setting <a class="reference internal" href="../../gmt.conf.html#projection-parameters"><em>PROJ_ELLIPSOID</em></a>
-is changed to Sphere.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>We will use a grid with Pacific crust ages (pac_age.nc), a plate motion
-model (Pac_APM.d), and a polygon that contains the outline of the
-present Pacific plate (pac_clip_path.d). To evaluate the plate motion
-azimuths at the present time for the Pacific, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdpmodeler pac_age.nc -EPac_APM.d -V -Fpac_clip_path.d \
- -Gpac_dir_0.nc -Sa -T0
-</pre></div>
-</div>
-</div></blockquote>
-<p>To determine the changes in latitude since crust formation for the
-entire Pacific, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdpmodeler pac_age.nc -EPac_APM.d -V -Fpac_clip_path.d \
- -Gpac_dlat.nc -Sy
-</pre></div>
-</div>
-</div></blockquote>
-<p>To determine the plate motion rates in effect when the Pacific crust was
-formed, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdpmodeler pac_age.nc -EPac_APM.d -V -Fpac_clip_path.d \
- -Gpac_vel.nc -Sr
-</pre></div>
-</div>
-</div></blockquote>
-<p>To determine how far the crust has moved since formation, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdpmodeler pac_age.nc -EPac_APM.d -V -Fpac_clip_path.d \
- -Gpac_dist.nc -Sd
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="backtracker.html"><em>backtracker</em></a>,
-<a class="reference internal" href="grdrotater.html"><em>grdrotater</em></a>,
-<a class="reference internal" href="grdspotter.html"><em>grdspotter</em></a>,
-<a class="reference internal" href="hotspotter.html"><em>hotspotter</em></a>,
-<a class="reference internal" href="originator.html"><em>originator</em></a>,
-<a class="reference internal" href="rotconverter.html"><em>rotconverter</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grdpmodeler</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#id1">Geodetic versus Geocentric Coordiinates</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="backtracker.html"
- title="previous chapter">backtracker</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grdrotater.html"
- title="next chapter">grdrotater</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/spotter/grdpmodeler.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grdrotater.html" title="grdrotater"
- >next</a> </li>
- <li class="right" >
- <a href="backtracker.html" title="backtracker"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_SPOTTER.html" >SPOTTER</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/spotter/grdrotater.html b/doc_release/html/supplements/spotter/grdrotater.html
deleted file mode 100644
index 9339a04..0000000
--- a/doc_release/html/supplements/spotter/grdrotater.html
+++ /dev/null
@@ -1,363 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grdrotater — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="SPOTTER" href="../../SUP_SPOTTER.html" />
- <link rel="next" title="grdspotter" href="grdspotter.html" />
- <link rel="prev" title="grdpmodeler" href="grdpmodeler.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="grdspotter.html" title="grdspotter"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grdpmodeler.html" title="grdpmodeler"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_SPOTTER.html" accesskey="U">SPOTTER</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grdrotater">
-<span id="index-0"></span><h1>grdrotater<a class="headerlink" href="#grdrotater" title="Permalink to this headline">¶</a></h1>
-<p>grdrotater - Finite rotation reconstruction of geographic grid</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdrotate</strong> <em>ingrdfile</em> <strong>-E</strong><em>rot_file</em>|<em>lon</em>/<em>lat</em>/<em>angle</em>
-<strong>-G</strong><em>outgrdfile</em> [ <strong>-F</strong><em>polygonfile</em> ]
-[ <strong>-N</strong> ]
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ]
-[ <strong>-S</strong> ] [ <strong>-T</strong><em>age</em> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-b</strong>[<strong>i</strong>|<strong>o</strong>][<em>ncol</em>][<strong>type</strong>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-n</strong>[<strong>b</strong>|<strong>c</strong>|<strong>l</strong>|<strong>n</strong>][<strong>+a</strong>][<strong>+b</strong><em>BC</em>][<strong>+t</strong><em>threshold</em>] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdrotater</strong> reads a geographical grid and reconstructs it given a
-total reconstruction rotation. Optionally, the user may supply a
-clipping polygon in multiple-segment format; then, only the part of the
-grid inside the polygon is used to determine the return grid region. The
-outline of the projected region is returned on stdout provided the
-rotated region is not the entire globe.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>ingrdfile</em></dt>
-<dd>Name of a grid file in geographical (lon, lat) coordinates.</dd>
-<dt><strong>-E</strong><em>rotfile</em></dt>
-<dd><p class="first">Give file with rotation parameters. This file must contain one
-record for each rotation; each record must be of the following
-format:</p>
-<p><em>lon lat tstart [tstop] angle</em> [ <em>khat a b c d e f g df</em> ]</p>
-<p class="last">where <em>tstart</em> and <em>tstop</em> are in Myr and <em>lon lat angle</em> are in
-degrees. <em>tstart</em> and <em>tstop</em> are the ages of the old and young ends
-of a stage. If <em>tstop</em> is not present in the record then a total
-reconstruction rotation is expected and <em>tstop</em> is implicitly set to
-0 and should not be specified for any of the records in the file. If
-a covariance matrix <strong>C</strong> for the rotation is available it must be
-specified in a format using the nine optional terms listed in
-brackets. Here, <strong>C</strong> = (<em>g</em>/<em>khat</em>)*[ <em>a b d; b c e; d e f</em> ]
-which shows <strong>C</strong> made up of three row vectors. If the degrees of
-freedom (<em>df</em>) in fitting the rotation is 0 or not given it is set
-to 10000. Blank lines and records whose first column contains # will
-be ignored. You may prepend a leading + to the filename to indicate
-you wish to invert the rotations.
-Alternative 1: Give the filename composed of two plate IDs
-separated by a hyphen (e.g., PAC-MBL) and we will instead extract
-that rotation from the GPlates rotation database. We return an error
-if the rotation cannot be found.
-Alternative 2: Specify <em>lon</em>/<em>lat</em>/<em>angle</em>, i.e., the longitude,
-latitude, and opening angle (all in degrees and separated by /) for
-a single total reconstruction rotation.</p>
-</dd>
-<dt><strong>-G</strong><em>outgrdfile</em></dt>
-<dd>Name of output grid. This is the grid with the data reconstructed
-according to the specified rotation.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-F</strong><em>polygonfile</em></dt>
-<dd>Specify a multisegment closed polygon file that describes the inside
-area of the grid that should be projected [Default projects entire
-grid].</dd>
-<dt><strong>-N</strong></dt>
-<dd>Do Not output the rotated polygon outline [Default will write it to stdout].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]</dt>
-<dd><em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> specify the region of interest,
-and you may specify them in decimal degrees or in
-[+-]dd:mm[:ss.xxx][W|E|S|N] format. Append <strong>r</strong> if lower left
-and upper right map coordinates are given instead of w/e/s/n. The
-two shorthands <strong>-Rg</strong> and <strong>-Rd</strong> stand for global domain (0/360
-and -180/+180 in longitude respectively, with -90/+90 in latitude).
-Alternatively, specify the name of an existing grid file and the
-<strong>-R</strong> settings (and grid spacing, if applicable) are copied from
-the grid. Using <strong>-R</strong><em>unit</em> expects projected (Cartesian)
-coordinates compatible with chosen <strong>-J</strong> and we inversely project
-to determine actual rectangular geographic region.
-For perspective view (<strong>-p</strong>), optionally append /<em>zmin</em>/<em>zmax</em>.
-In case of perspective view (<strong>-p</strong>), a z-range (<em>zmin</em>, <em>zmax</em>)
-can be appended to indicate the third dimension. This needs to be
-done only when using the <strong>-Jz</strong> option, not when using only the
-<strong>-p</strong> option. In the latter case a perspective view of the plane is
-plotted, with no third dimension. </dd>
-<dt><strong>-S</strong></dt>
-<dd>Skip the rotation of the grid, just rotate the polygon outline
-(requires <strong>-F</strong>).</dd>
-<dt><strong>-T</strong><em>age</em></dt>
-<dd>Sets the desired age of reconstruction when <strong>-E</strong> is given.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="../../gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 2 input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="../../gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. [Default is same as input].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="../../gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="../../gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="../../gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-n</strong>[<strong>b</strong>|<strong>c</strong>|<strong>l</strong>|<strong>n</strong>][<strong>+a</strong>][<strong>+b</strong><em>BC</em>][<strong>+c</strong>][<strong>+t</strong><em>threshold</em>] <a class="reference internal" href="../../gmt.html#n-full"><em>(more ...)</em></a></dt>
-<dd>Select interpolation mode for grids.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="consequences-of-grid-resampling">
-<h2>Consequences of grid resampling<a class="headerlink" href="#consequences-of-grid-resampling" title="Permalink to this headline">¶</a></h2>
-<p>Resample or sampling of grids will use various algorithms (see <strong>-n</strong>) that may lead
-to possible distortions or unexpected results in the resampled values.
-One expected effect of resampling with splines is the tendency for the new
-resampled values to slightly exceed the global min/max limits of the original
-grid. If this is unacceptable, you can impose clipping of the resampled values
-values so they do not exceed the input min/max values by adding <strong>+c</strong> to
-your <strong>-n</strong> option.</p>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc11">Geodetic versus Geocentric Coordiinates</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>All spherical rotations are applied to geocentric coordinates.
-This means that incoming data points and grids are considered
-to represent geodetic coordinates and must first
-be converted to geocentric coordinates. Rotations are then applied, and the
-final reconstructed points are converted back to geodetic
-coordinates. This default behavior can be bypassed if the
-ellipsoid setting <a class="reference internal" href="../../gmt.conf.html#projection-parameters"><em>PROJ_ELLIPSOID</em></a>
-is changed to Sphere.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To rotate the data defined by grid topo.nc and the polygon outline
-clip_path.d, using a total reconstruction rotation with pole at (135.5,
--33.0) and a rotation angle of 37.3 degrees and bicubic interpolation, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdrotater topo.nc -E135.5/-33/37.3 -V -Fclip_path.d -Grot_topo.nc > rot_clip_path.d
-</pre></div>
-</div>
-</div></blockquote>
-<p>To rotate the entire grid faa.nc back to 32 Ma using the rotation file
-<em>rotations.txt</em> and a bilinear interpolation, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdrotater faa.nc -Erotations.txt -T32 -V -Grot_faa.nc -nl > rot_faa_path.d
-</pre></div>
-</div>
-</div></blockquote>
-<p>To just see how the outline of the grid large.nc will plot after the
-same rotation, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdrotater large.nc -Erotations.txt -T32 -V -S \| psxy -Rg -JH180/6i -B30 -W0.5p \| gv -
-</pre></div>
-</div>
-</div></blockquote>
-<p>Let say you have rotated gridA.nc and gridB.nc, restricting each
-rotation to nodes inside polygons polyA.d and polyB.d, respectively,
-using rotation A = (123W,22S,16,4) and rotation B = (108W, 16S, -14.5),
-yielding rotated grids rot_gridA.nc and rot_gridB.nc. To determine the
-region of overlap between the rotated grids, we use grdmath:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdmath 1 rot_gridA.nc ISNAN SUB 1 rot_gridB.nc ISNAN SUB 2 EQ = overlap.nc
-</pre></div>
-</div>
-</div></blockquote>
-<p>The grid overlap.nc now has 1s in the regions of overlap and 0
-elsewhere. You can use it as a mask or use grdcontour <strong>-D</strong> to extract
-a polygon (contour).</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="backtracker.html"><em>backtracker</em></a>,
-<a class="reference internal" href="grdspotter.html"><em>grdspotter</em></a>,
-<a class="reference internal" href="hotspotter.html"><em>hotspotter</em></a>,
-<a class="reference internal" href="originator.html"><em>originator</em></a>,
-<a class="reference internal" href="rotconverter.html"><em>rotconverter</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grdrotater</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#consequences-of-grid-resampling">Consequences of grid resampling</a></li>
-<li><a class="reference internal" href="#id1">Geodetic versus Geocentric Coordiinates</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grdpmodeler.html"
- title="previous chapter">grdpmodeler</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="grdspotter.html"
- title="next chapter">grdspotter</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/spotter/grdrotater.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="grdspotter.html" title="grdspotter"
- >next</a> </li>
- <li class="right" >
- <a href="grdpmodeler.html" title="grdpmodeler"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_SPOTTER.html" >SPOTTER</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/spotter/grdspotter.html b/doc_release/html/supplements/spotter/grdspotter.html
deleted file mode 100644
index 66e4ee2..0000000
--- a/doc_release/html/supplements/spotter/grdspotter.html
+++ /dev/null
@@ -1,373 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>grdspotter — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="SPOTTER" href="../../SUP_SPOTTER.html" />
- <link rel="next" title="hotspotter" href="hotspotter.html" />
- <link rel="prev" title="grdrotater" href="grdrotater.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="hotspotter.html" title="hotspotter"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grdrotater.html" title="grdrotater"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_SPOTTER.html" accesskey="U">SPOTTER</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="grdspotter">
-<span id="index-0"></span><h1>grdspotter<a class="headerlink" href="#grdspotter" title="Permalink to this headline">¶</a></h1>
-<p>grdspotter - Create CVA image from a gravity or topography grid</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdspotter</strong> [<em>grdfile</em>] <strong>-E</strong><em>rotfile</em> <strong>-G</strong><em>CVAgrid</em>
-<strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]
-<strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>]
-[ <strong>-A</strong><em>agegrid</em> ]
-[ <strong>-D</strong><em>DIgrid</em> ] [ <strong>-L</strong><em>IDgrid</em> ] [ <strong>-M</strong> ]
-[ <strong>-N</strong><em>upper_age</em> ] [ <strong>-P</strong><em>PAgrid</em> ] [ <strong>-Q</strong><em>IDinfo</em> ] [
-<strong>-S</strong> ] [ <strong>-T</strong><strong>t</strong>|<strong>u</strong><em>fixed_val</em> ] [
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W</strong><em>n_try</em> ]] [ <strong>-Z</strong><em>z_min</em>[/<em>z_max</em>[/<em>z_inc</em>]] ] [
-<strong>-r</strong> ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>grdspotter</strong> reads a grid file with residual bathymetry or gravity and
-calculates flowlines from each node that exceeds a minimum value using
-the specified rotations file. These flowlines are then convolved with
-the volume of the prism represented by each grid node and added up to
-give a Cumulative Volcano Amplitude grid (CVA).</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>grdfile</em></dt>
-<dd>Data grid to be processed, typically residual bathymetry or free-air anomalies.</dd>
-<dt><strong>-E</strong><em>rotfile</em></dt>
-<dd><p class="first">Give file with rotation parameters. This file must contain one
-record for each rotation; each record must be of the following
-format:</p>
-<p><em>lon lat tstart [tstop] angle</em> [ <em>khat a b c d e f g df</em> ]</p>
-<p class="last">where <em>tstart</em> and <em>tstop</em> are in Myr and <em>lon lat angle</em> are in
-degrees. <em>tstart</em> and <em>tstop</em> are the ages of the old and young ends
-of a stage. If <em>tstop</em> is not present in the record then a total
-reconstruction rotation is expected and <em>tstop</em> is implicitly set to
-0 and should not be specified for any of the records in the file. If
-a covariance matrix <strong>C</strong> for the rotation is available it must be
-specified in a format using the nine optional terms listed in
-brackets. Here, <strong>C</strong> = (<em>g</em>/<em>khat</em>)*[ <em>a b d; b c e; d e f</em> ]
-which shows <strong>C</strong> made up of three row vectors. If the degrees of
-freedom (<em>df</em>) in fitting the rotation is 0 or not given it is set
-to 10000. Blank lines and records whose first column contains # will
-be ignored. You may prepend a leading + to the filename to indicate
-you wish to invert the rotations.
-Alternatively, give the filename composed of two plate IDs
-separated by a hyphen (e.g., PAC-MBL) and we will instead extract
-that rotation from the GPlates rotation database. We return an error
-if the rotation cannot be found.</p>
-</dd>
-<dt><strong>-G</strong></dt>
-<dd>Specify name for output CVA grid file.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]</dt>
-<dd><em>x_inc</em> [and optionally <em>y_inc</em>] is the grid spacing. Optionally,
-append a suffix modifier. <strong>Geographical (degrees) coordinates</strong>: Append
-<strong>m</strong> to indicate arc minutes or <strong>s</strong> to indicate arc seconds. If one
-of the units <strong>e</strong>, <strong>f</strong>, <strong>k</strong>, <strong>M</strong>, <strong>n</strong> or <strong>u</strong> is appended
-instead, the increment is assumed to be given in meter, foot, km, Mile,
-nautical mile or US survey foot, respectively, and will be converted to
-the equivalent degrees longitude at the middle latitude of the region
-(the conversion depends on <a class="reference internal" href="../../gmt.conf.html#projection-parameters"><em>PROJ_ELLIPSOID</em></a>). If /<em>y_inc</em> is given
-but set to 0 it will be reset equal to <em>x_inc</em>; otherwise it will be
-converted to degrees latitude. <strong>All coordinates</strong>: If <strong>=</strong> is appended
-then the corresponding max <em>x</em> (<em>east</em>) or <em>y</em> (<em>north</em>) may be slightly
-adjusted to fit exactly the given increment [by default the increment
-may be adjusted slightly to fit the given domain]. Finally, instead of
-giving an increment you may specify the <em>number of nodes</em> desired by
-appending <strong>+</strong> to the supplied integer argument; the increment is then
-recalculated from the number of nodes and the domain. The resulting
-increment value depends on whether you have selected a
-gridline-registered or pixel-registered grid; see <a class="reference internal" href="../../GMT_Docs.html#app-file-formats"><em>B. GMT File Formats</em></a> for
-details. Note: if <strong>-R</strong><em>grdfile</em> is used then the grid spacing has
-already been initialized; use <strong>-I</strong> to override the values.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]</dt>
-<dd><em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> specify the region of interest,
-and you may specify them in decimal degrees or in
-[+-]dd:mm[:ss.xxx][W|E|S|N] format. Append <strong>r</strong> if lower left
-and upper right map coordinates are given instead of w/e/s/n. The
-two shorthands <strong>-Rg</strong> and <strong>-Rd</strong> stand for global domain (0/360
-and -180/+180 in longitude respectively, with -90/+90 in latitude).
-Alternatively, specify the name of an existing grid file and the
-<strong>-R</strong> settings (and grid spacing, if applicable) are copied from
-the grid. Using <strong>-R</strong><em>unit</em> expects projected (Cartesian)
-coordinates compatible with chosen <strong>-J</strong> and we inversely project
-to determine actual rectangular geographic region.
-For perspective view (<strong>-p</strong>), optionally append /<em>zmin</em>/<em>zmax</em>.
-In case of perspective view (<strong>-p</strong>), a z-range (<em>zmin</em>, <em>zmax</em>)
-can be appended to indicate the third dimension. This needs to be
-done only when using the <strong>-Jz</strong> option, not when using only the
-<strong>-p</strong> option. In the latter case a perspective view of the plane is
-plotted, with no third dimension. </dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong><em>agegrid</em></dt>
-<dd>Supply a crustal age grid that is co-registered with the input data
-grid. These ages become the upper ages to use when constructing
-flowlines [Default extend flowlines back to oldest age found in the
-rotation file; but see <strong>-N</strong>].</dd>
-<dt><strong>-D</strong><em>DIgrid</em></dt>
-<dd>Use flowlines to determine the maximum CVA encountered along each
-flowline and create a Data Importance (DI) grid with these values at
-the originating nodes.</dd>
-<dt><strong>-L</strong><em>IDgrid</em></dt>
-<dd>Supply a co-registered grid with seamount chain IDs for each node.
-This option requires that you also use <strong>-Q</strong>.</dd>
-<dt><strong>-M</strong></dt>
-<dd>Do not attempt to keep all flowlines in memory when using <strong>-D</strong>
-and/or <strong>-P</strong>. Should you run out of memory you can use this option
-to compute flowlines on-the-fly. It will be slower as we no longer
-can reuse the flowlines calculated for the CVA step. Cannot be used
-with <strong>-W</strong> or the multi-slice mode in <strong>-Z</strong>.</dd>
-<dt><strong>-N</strong><em>upper_age</em></dt>
-<dd>Set the upper age to assign to nodes whose crustal age is unknown
-(i.e., NaN) [no upper age]. Also see <strong>-A</strong>.</dd>
-<dt><strong>-P</strong><em>PAgrid</em></dt>
-<dd>Use flowlines to determine the flowline age at the CVA maximum for
-each node and create a Predicted Age (PA) grid with these values at
-the originating nodes.</dd>
-<dt><strong>-Q</strong><em>IDinfo</em></dt>
-<dd>Either give (1) a single ID to use or (2)
-the name of a file with a list of IDs to use
-[Default uses all IDs]. Each line would be TAG ID [w e s n]. The
-<em>w/e/s/n</em> zoom box is optional; if specified it means we only trace
-the flowline if inside this region [Default uses region set by
-<strong>-R</strong>]. Requires <strong>-L</strong>.</dd>
-<dt><strong>-S</strong></dt>
-<dd>Normalize the resulting CVA grid to percentages of the CVA maximum.
-This also normalizes the DI grid (if requested).</dd>
-<dt><strong>-T</strong><strong>t</strong>|<strong>u</strong><em>fixed_val</em></dt>
-<dd>Selects ways to adjust ages; repeatable. Choose from <strong>-Tt</strong> to
-truncate crustal ages given via the <strong>-A</strong> option that exceed the
-upper age set with <strong>-N</strong> [no truncation], or <strong>-Tu</strong><em>fixed_val</em>
-which means that after a node passes the test implied by <strong>-Z</strong>, we
-use this <em>fixed_val</em> instead in the calculations. [Default uses
-individual node values].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong><em>n_try</em></dt>
-<dd>Get <em>n_try</em> bootstrap estimates of the maximum CVA location; the
-longitude and latitude results are written to stdout [Default is no
-bootstrapping]. Cannot be used with <strong>-M</strong>.</dd>
-<dt><strong>-Z</strong><em>z_min</em>[/<em>z_max</em>[/<em>z_inc</em>]]</dt>
-<dd>Ignore nodes with z-values lower than <em>z_min</em> [0] and optionally
-larger than <em>z_max</em> [Inf]. Give <em>z_min/z_max/z_inc</em> to make
-separate CVA grids for each <em>z</em>-slice [Default makes one CVA grid].
-Multi-slicing cannot be used with <strong>-M</strong>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-r</strong> <a class="reference internal" href="../../gmt.html#nodereg-full"><em>(more ...)</em></a></dt>
-<dd>Set pixel node registration [gridline]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc11">Geodetic versus Geocentric Coordiinates</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>All spherical rotations are applied to geocentric coordinates.
-This means that incoming data points and grids are considered
-to represent geodetic coordinates and must first
-be converted to geocentric coordinates. Rotations are then applied, and the
-final reconstructed points are converted back to geodetic
-coordinates. This default behavior can be bypassed if the
-ellipsoid setting <a class="reference internal" href="../../gmt.conf.html#projection-parameters"><em>PROJ_ELLIPSOID</em></a>
-is changed to Sphere.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To create a CVA image from the Pacific topography grid
-Pac_res_topo.nc, using the DC85.d Euler poles, and only output a grid
-for the specified domain, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt grdspotter Pac_res_topo.nc -EDC85.d -GCVA.nc -R190/220/15/25 -I2m -N145 -Tt -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>This file can then be plotted with <a class="reference internal" href="../../grdimage.html"><em>grdimage</em></a>.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="../../gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="../../grdimage.html"><em>grdimage</em></a>,
-<a class="reference internal" href="../../project.html"><em>project</em></a>,
-<a class="reference internal" href="../../mapproject.html"><em>mapproject</em></a>,
-<a class="reference internal" href="backtracker.html"><em>backtracker</em></a>,
-<a class="reference internal" href="hotspotter.html"><em>hotspotter</em></a>,
-<a class="reference internal" href="originator.html"><em>originator</em></a></p>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>Wessel, P., 1999, “Hotspotting” tools released, EOS Trans. AGU, 80 (29), p. 319.</p>
-<p>Wessel, P., 2008, Hotspotting: Principles and properties of a plate
-tectonic Hough transform, Geochem. Geophys. Geosyst. 9(Q08004):
-doi:10.1029/2008GC002058.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">grdspotter</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#id1">Geodetic versus Geocentric Coordiinates</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grdrotater.html"
- title="previous chapter">grdrotater</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="hotspotter.html"
- title="next chapter">hotspotter</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/spotter/grdspotter.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="hotspotter.html" title="hotspotter"
- >next</a> </li>
- <li class="right" >
- <a href="grdrotater.html" title="grdrotater"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_SPOTTER.html" >SPOTTER</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/spotter/hotspotter.html b/doc_release/html/supplements/spotter/hotspotter.html
deleted file mode 100644
index c5cea0b..0000000
--- a/doc_release/html/supplements/spotter/hotspotter.html
+++ /dev/null
@@ -1,356 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>hotspotter — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="SPOTTER" href="../../SUP_SPOTTER.html" />
- <link rel="next" title="originator" href="originator.html" />
- <link rel="prev" title="grdspotter" href="grdspotter.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="originator.html" title="originator"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="grdspotter.html" title="grdspotter"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_SPOTTER.html" accesskey="U">SPOTTER</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="hotspotter">
-<span id="index-0"></span><h1>hotspotter<a class="headerlink" href="#hotspotter" title="Permalink to this headline">¶</a></h1>
-<p>hotspotter - Create CVA image from seamount locations</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>hotspotter</strong> [<em>table</em>] <strong>-E</strong><em>rotfile</em> <strong>-G</strong><em>CVAgrid</em>
-<strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]
-<strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>]
-[ <strong>-N</strong><em>upper_age</em> ] [ <strong>-S</strong> ] [ <strong>-T</strong> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-bi</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-o</strong><em>cols</em>[,...] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>hotspotter</strong> reads (longitude, latitude, amplitude, radius, age)
-records from <em>infiles</em> [or standard input] and calculates flowlines
-using the specified stage or total reconstruction rotations. These
-flowlines are convolved with the shape of the seamount (using a Gaussian
-shape given amplitude and radius = 6 sigma) and added up to give a
-Cumulative Volcano Amplitude grid (CVA). See option <strong>-:</strong> on how to
-read (latitude,longitude,...) files.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>[<em>ncols</em>][<em>type</em>]) data
-table file(s) holding a number of data columns. If no tables are given
-then we read from standard input. </dd>
-<dt><strong>-E</strong><em>rotfile</em></dt>
-<dd><p class="first">Give file with rotation parameters. This file must contain one
-record for each rotation; each record must be of the following format:</p>
-<p><em>lon lat tstart [tstop] angle</em> [ <em>khat a b c d e f g df</em> ]</p>
-<p class="last">where <em>tstart</em> and <em>tstop</em> are in Myr and <em>lon lat angle</em> are in
-degrees. <em>tstart</em> and <em>tstop</em> are the ages of the old and young ends
-of a stage. If <em>tstop</em> is not present in the record then a total
-reconstruction rotation is expected and <em>tstop</em> is implicitly set to
-0 and should not be specified for any of the records in the file. If
-a covariance matrix <strong>C</strong> for the rotation is available it must be
-specified in a format using the nine optional terms listed in
-brackets. Here, <strong>C</strong> = (<em>g</em>/<em>khat</em>)*[ <em>a b d; b c e; d e f</em> ]
-which shows <strong>C</strong> made up of three row vectors. If the degrees of
-freedom (<em>df</em>) in fitting the rotation is 0 or not given it is set
-to 10000. Blank lines and records whose first column contains # will
-be ignored. You may prepend a leading + to the filename to indicate
-you wish to invert the rotations.
-Alternatively, give the filename composed of two plate IDs
-separated by a hyphen (e.g., PAC-MBL) and we will instead extract
-that rotation from the GPlates rotation database. We return an error
-if the rotation cannot be found.</p>
-</dd>
-<dt><strong>-G</strong><em>CVAgrid</em></dt>
-<dd>Specify name for output grid file.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]</dt>
-<dd><em>x_inc</em> [and optionally <em>y_inc</em>] is the grid spacing. Optionally,
-append a suffix modifier. <strong>Geographical (degrees) coordinates</strong>: Append
-<strong>m</strong> to indicate arc minutes or <strong>s</strong> to indicate arc seconds. If one
-of the units <strong>e</strong>, <strong>f</strong>, <strong>k</strong>, <strong>M</strong>, <strong>n</strong> or <strong>u</strong> is appended
-instead, the increment is assumed to be given in meter, foot, km, Mile,
-nautical mile or US survey foot, respectively, and will be converted to
-the equivalent degrees longitude at the middle latitude of the region
-(the conversion depends on <a class="reference internal" href="../../gmt.conf.html#projection-parameters"><em>PROJ_ELLIPSOID</em></a>). If /<em>y_inc</em> is given
-but set to 0 it will be reset equal to <em>x_inc</em>; otherwise it will be
-converted to degrees latitude. <strong>All coordinates</strong>: If <strong>=</strong> is appended
-then the corresponding max <em>x</em> (<em>east</em>) or <em>y</em> (<em>north</em>) may be slightly
-adjusted to fit exactly the given increment [by default the increment
-may be adjusted slightly to fit the given domain]. Finally, instead of
-giving an increment you may specify the <em>number of nodes</em> desired by
-appending <strong>+</strong> to the supplied integer argument; the increment is then
-recalculated from the number of nodes and the domain. The resulting
-increment value depends on whether you have selected a
-gridline-registered or pixel-registered grid; see <a class="reference internal" href="../../GMT_Docs.html#app-file-formats"><em>B. GMT File Formats</em></a> for
-details. Note: if <strong>-R</strong><em>grdfile</em> is used then the grid spacing has
-already been initialized; use <strong>-I</strong> to override the values.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]</dt>
-<dd><em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> specify the region of interest,
-and you may specify them in decimal degrees or in
-[+-]dd:mm[:ss.xxx][W|E|S|N] format. Append <strong>r</strong> if lower left
-and upper right map coordinates are given instead of w/e/s/n. The
-two shorthands <strong>-Rg</strong> and <strong>-Rd</strong> stand for global domain (0/360
-and -180/+180 in longitude respectively, with -90/+90 in latitude).
-Alternatively, specify the name of an existing grid file and the
-<strong>-R</strong> settings (and grid spacing, if applicable) are copied from
-the grid. Using <strong>-R</strong><em>unit</em> expects projected (Cartesian)
-coordinates compatible with chosen <strong>-J</strong> and we inversely project
-to determine actual rectangular geographic region.
-For perspective view (<strong>-p</strong>), optionally append /<em>zmin</em>/<em>zmax</em>.
-In case of perspective view (<strong>-p</strong>), a z-range (<em>zmin</em>, <em>zmax</em>)
-can be appended to indicate the third dimension. This needs to be
-done only when using the <strong>-Jz</strong> option, not when using only the
-<strong>-p</strong> option. In the latter case a perspective view of the plane is
-plotted, with no third dimension. </dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-D</strong><em>factor</em></dt>
-<dd>Modify the sampling interval along flowlines. Default [0.5] gives
-approximately 2 points within each grid box. Smaller factors gives
-higher resolutions at the expense of longer processing time.</dd>
-<dt><strong>-N</strong><em>upper_age</em></dt>
-<dd>Set the upper age to assign seamounts whose crustal age is unknown
-(i.e., NaN) [no upper age].</dd>
-<dt><strong>-S</strong></dt>
-<dd>Normalize the resulting CVA grid to percentages of the CVA maximum.</dd>
-<dt><strong>-T</strong></dt>
-<dd>Truncate seamount ages exceeding the upper age set with <strong>-N</strong> [no
-truncation].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="../../gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 5 input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="../../gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-o</strong><em>cols</em>[,...] <a class="reference internal" href="../../gmt.html#ocols-full"><em>(more ...)</em></a></dt>
-<dd>Select output columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-r</strong> <a class="reference internal" href="../../gmt.html#nodereg-full"><em>(more ...)</em></a></dt>
-<dd>Set pixel node registration [gridline]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="../../gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc11">Geodetic versus Geocentric Coordiinates</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>All spherical rotations are applied to geocentric coordinates.
-This means that incoming data points and grids are considered
-to represent geodetic coordinates and must first
-be converted to geocentric coordinates. Rotations are then applied, and the
-final reconstructed points are converted back to geodetic
-coordinates. This default behavior can be bypassed if the
-ellipsoid setting <a class="reference internal" href="../../gmt.conf.html#projection-parameters"><em>PROJ_ELLIPSOID</em></a>
-is changed to Sphere.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To create a CVA image from the Pacific (x,y,z,r,t) data in the file
-seamounts.d, using the DC85.d Euler poles, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt hotspotter seamounts.d -EDC85.d -GCVA.nc -R130/260/-66/60 -I10m -N145 -T -V
-</pre></div>
-</div>
-</div></blockquote>
-<p>This file can then be plotted with <a class="reference internal" href="../../grdimage.html"><em>grdimage</em></a>.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="../../gmt.html"><em>gmt</em></a>, <a class="reference internal" href="../../grdimage.html"><em>grdimage</em></a>,
-<a class="reference internal" href="grdrotater.html"><em>grdrotater</em></a>,
-<a class="reference internal" href="grdspotter.html"><em>grdspotter</em></a>,
-<a class="reference internal" href="../../project.html"><em>project</em></a>,
-<a class="reference internal" href="../../mapproject.html"><em>mapproject</em></a>,
-<a class="reference internal" href="backtracker.html"><em>backtracker</em></a>,
-<a class="reference internal" href="originator.html"><em>originator</em></a></p>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>Wessel, P., 1999, “Hotspotting” tools released, EOS Trans. AGU, 80 (29), p. 319.</p>
-<p>Wessel, P., 2008, Hotspotting: Principles and properties of a plate
-tectonic Hough transform, Geochem. Geophys. Geosyst. 9(Q08004):
-doi:10.1029/2008GC002058.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">hotspotter</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#id1">Geodetic versus Geocentric Coordiinates</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="grdspotter.html"
- title="previous chapter">grdspotter</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="originator.html"
- title="next chapter">originator</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/spotter/hotspotter.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="originator.html" title="originator"
- >next</a> </li>
- <li class="right" >
- <a href="grdspotter.html" title="grdspotter"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_SPOTTER.html" >SPOTTER</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/spotter/originator.html b/doc_release/html/supplements/spotter/originator.html
deleted file mode 100644
index ddb4888..0000000
--- a/doc_release/html/supplements/spotter/originator.html
+++ /dev/null
@@ -1,363 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>originator — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="SPOTTER" href="../../SUP_SPOTTER.html" />
- <link rel="next" title="rotconverter" href="rotconverter.html" />
- <link rel="prev" title="hotspotter" href="hotspotter.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="rotconverter.html" title="rotconverter"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="hotspotter.html" title="hotspotter"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_SPOTTER.html" accesskey="U">SPOTTER</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="originator">
-<span id="index-0"></span><h1>originator<a class="headerlink" href="#originator" title="Permalink to this headline">¶</a></h1>
-<p>originator - Associate seamounts with nearest hotspot point sources</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>originator</strong> [ <em>table</em> ] <strong>-E</strong>[<strong>+</strong>]<em>rotfile</em>
-<strong>-F</strong>[<strong>+</strong>]<em>hs_file</em> [ <strong>-D</strong><em>d_km</em> ] [ <strong>-L</strong>[<em>flag</em>] ]
-[ <strong>-N</strong><em>upper_age</em> ] [ <strong>-Q</strong><em>r/t</em> ] [ <strong>-S</strong>[<em>n_hs</em>] ]
-[ <strong>-T</strong> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W</strong><em>maxdist</em> ]
-[ <strong>-Z</strong> ]
-[ <strong>-bi</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>originator</strong> reads (longitude, latitude, height, radius, crustal_age)
-records from <em>infiles</em> [or standard input] and uses the given Absolute
-Plate Motion (APM) stage or total reconstruction rotation file and the
-list of hotspot locations to determine the most likely origin (hotspot)
-for each seamount. It does so by calculating flowlines back in time and
-determining the closest approach to all hotspots. The output consists of
-the input records with four additional fields added for each of the
-<em>n_hs</em> closest hotspots. The four fields are the hotspot id (e.g.,
-HWI), the stage id of the flowline segment that came closest, the
-pseudo-age of the seamount, and the closest distance to the hotspot (in
-km). See option <strong>-:</strong> on how to read (latitude, longitude,height,
-radius, crustal_age) files.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-E</strong><em>rotfile</em></dt>
-<dd><p class="first">Give file with rotation parameters. This file must contain one
-record for each rotation; each record must be of the following
-format:</p>
-<p><em>lon lat tstart [tstop] angle</em> [ <em>khat a b c d e f g df</em> ]</p>
-<p class="last">where <em>tstart</em> and <em>tstop</em> are in Myr and <em>lon lat angle</em> are in
-degrees. <em>tstart</em> and <em>tstop</em> are the ages of the old and young ends
-of a stage. If <em>tstop</em> is not present in the record then a total
-reconstruction rotation is expected and <em>tstop</em> is implicitly set to
-0 and should not be specified for any of the records in the file. If
-a covariance matrix <strong>C</strong> for the rotation is available it must be
-specified in a format using the nine optional terms listed in
-brackets. Here, <strong>C</strong> = (<em>g</em>/<em>khat</em>)*[ <em>a b d; b c e; d e f</em> ]
-which shows <strong>C</strong> made up of three row vectors. If the degrees of
-freedom (<em>df</em>) in fitting the rotation is 0 or not given it is set
-to 10000. Blank lines and records whose first column contains # will
-be ignored. You may prepend a leading + to the filename to indicate
-you wish to invert the rotations.
-Alternatively, give the filename composed of two plate IDs
-separated by a hyphen (e.g., PAC-MBL) and we will instead extract
-that rotation from the GPlates rotation database. We return an error
-if the rotation cannot be found. Prepend <strong>+</strong> if you want to invert
-the rotations prior to use.</p>
-</dd>
-<dt><strong>-F</strong><em>file</em></dt>
-<dd><p class="first">Give file with hotspot locations. This file must contain one record
-for each hotspot to be considered; each record must be of the
-following format:</p>
-<p>lon lat hs_abbrev hs_id r t_off t_on create fit plot name</p>
-<p>E.g., for Hawaii this may look like</p>
-<p>205 20 HWI 1 25 0 90 Y Y Y Hawaii</p>
-<p class="last">Most applications only need the first 4 columns which thus
-represents the minimal hotspot information record type. The
-abbreviation may be maximum 3 characters long. The id must be an
-integer from 1-32. The positional uncertainty of the hotspot is
-given by r (in km). The t_off and t_on variables are used to
-indicate the active time-span of the hotspot. The create, fit, and
-plot indicators are either Y or N and are used by some programs to
-indicate if the hotspot is included in the ID-grids used to
-determine rotations, if the hotspot chain will be used to determine
-rotations, and if the hotspot should be included in various plots.
-The name is a 32-character maximum text string with the full hotspot
-name. Blank lines and records whose first column contains # will be
-ignored. Prepend <strong>+</strong> if we should look for hotspot drift tables
-whose name must be <em>hs_abbrev</em>_drift.txt. Such files may be
-located in the current directory, the same directory as <em>hs_file</em>,
-or in the directories pointed to by GMT_DATADIR. If found then we
-interpolate to get hotspot location as a function of time [fixed].</p>
-</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>[<em>ncols</em>][<em>type</em>]) data
-table file(s) holding a number of data columns. If no tables are given
-then we read from standard input. </dd>
-<dt><strong>-D</strong><em>d_km</em></dt>
-<dd>Sets the flowline sampling interval in km. [Default is 5].</dd>
-<dt><strong>-L</strong>[<em>flag</em>]</dt>
-<dd>Output closest approach for nearest hotspot only (ignores <strong>-S</strong>).
-Choose <strong>-Lt</strong> for (<em>time</em>, <em>dist</em>, <em>z</em>) [Default], <strong>-Lw</strong> for
-(<em>omega</em>, <em>dist</em>, <em>z</em>), and <strong>-Ll</strong> for (lon, lat, time, dist, z).
-Normally, <em>dist</em> is in km; use upper case modifiers <strong>TWL</strong> to get
-<em>dist</em> in spherical degrees.</dd>
-<dt><strong>-N</strong><em>upper_age</em></dt>
-<dd>Set the maximum age to extend the oldest stage back in time [no extension].</dd>
-<dt><strong>-Q</strong><em>r/t</em></dt>
-<dd>Input files only has (<em>x</em>,<em>y</em>,<em>z</em>); specify constant values for <em>r</em>,<em>t</em> that
-will be implied for each record.</dd>
-<dt><strong>-S</strong>[<em>n_hs</em>]</dt>
-<dd>Set the number of closest hotspots to report [Default is 1].</dd>
-<dt><strong>-T</strong></dt>
-<dd>Truncate seamount ages exceeding the upper age set with <strong>-N</strong> [no truncation].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong><em>maxdist</em></dt>
-<dd>Only report those seamounts whose flowlines came within <em>maxdist</em> to
-any hotspot [Default reports all seamounts].</dd>
-<dt><strong>-Z</strong></dt>
-<dd>Use the hotspot ID number rather than the name tag in output records.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="../../gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 5 input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="../../gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="../../gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc11">Geodetic versus Geocentric Coordiinates</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p>All spherical rotations are applied to geocentric coordinates.
-This means that incoming data points and grids are considered
-to represent geodetic coordinates and must first
-be converted to geocentric coordinates. Rotations are then applied, and the
-final reconstructed points are converted back to geodetic
-coordinates. This default behavior can be bypassed if the
-ellipsoid setting <a class="reference internal" href="../../gmt.conf.html#projection-parameters"><em>PROJ_ELLIPSOID</em></a>
-is changed to Sphere.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To find the likely (hotspot) origins of the seamounts represented by the
-(x,y,z,r,tc) points in the file seamounts.d, using the DC85.d Euler
-poles and the pac_hs.d list of possible hotspots, and report the 2 most
-likely hotspot candidates for each seamount, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt originator seamounts.d -S2 -EDC85.d -Fpac_hs.d > origins.d
-</pre></div>
-</div>
-</div></blockquote>
-<p>To determine the predicted age of a seamount, distances to the closest
-hotspot, and echo the observed age given its location, observed age, and
-a rotation model, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>echo "1.55 -8.43 52.3" | gmt originator -FONeill_2005_hotspots.txt \
--EOMS2005_APM_fixed.txt -Q1/120 -Lt
-</pre></div>
-</div>
-</div></blockquote>
-<p>where 52.3 Ma is observed age. The output is 70 -95.486 52.3. To repeat
-the same exercise with a moving hotspot model, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>echo "1.55 -8.43 52.3" | gmt originator -F+ONeill_2005_hotspots.txt \
--EOMS2005_APM_smooth.txt -Q1/120 -Lt
-</pre></div>
-</div>
-</div></blockquote>
-<p>Now the output is 80 -213.135 52.3. Negative distances means the closest
-approach was east of the hotspot.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="../../gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="grdrotater.html"><em>grdrotater</em></a>,
-<a class="reference internal" href="grdspotter.html"><em>grdspotter</em></a>,
-<a class="reference internal" href="../../project.html"><em>project</em></a>,
-<a class="reference internal" href="../../mapproject.html"><em>mapproject</em></a>,
-<a class="reference internal" href="backtracker.html"><em>backtracker</em></a>,
-<a class="reference internal" href="hotspotter.html"><em>hotspotter</em></a></p>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>Wessel, P., 1999, “Hotspotting” tools released, EOS Trans. AGU, 80 (29), p. 319.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">originator</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#id1">Geodetic versus Geocentric Coordiinates</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="hotspotter.html"
- title="previous chapter">hotspotter</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="rotconverter.html"
- title="next chapter">rotconverter</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/spotter/originator.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="rotconverter.html" title="rotconverter"
- >next</a> </li>
- <li class="right" >
- <a href="hotspotter.html" title="hotspotter"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_SPOTTER.html" >SPOTTER</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/spotter/rotconverter.html b/doc_release/html/supplements/spotter/rotconverter.html
deleted file mode 100644
index 84e92d2..0000000
--- a/doc_release/html/supplements/spotter/rotconverter.html
+++ /dev/null
@@ -1,297 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>rotconverter — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="SPOTTER" href="../../SUP_SPOTTER.html" />
- <link rel="next" title="X2SYS" href="../../SUP_X2SYS.html" />
- <link rel="prev" title="originator" href="originator.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="../../SUP_X2SYS.html" title="X2SYS"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="originator.html" title="originator"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_SPOTTER.html" accesskey="U">SPOTTER</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="rotconverter">
-<span id="index-0"></span><h1>rotconverter<a class="headerlink" href="#rotconverter" title="Permalink to this headline">¶</a></h1>
-<p>rotconverter - Manipulate total reconstruction and stage rotations</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>rotconverter</strong> [ <strong>+</strong>|<strong>-</strong> ] <em>rotA</em> [ <strong>+</strong>|<strong>-</strong> <em>rotB</em> ]
-[ <strong>+</strong>|<strong>-</strong> <em>rotC</em> ] ... [ <strong>-A</strong> ] [ <strong>-D</strong> ] [
-<strong>-E</strong>[<em>fact</em>] ] [ <strong>-F</strong><em>out</em> ] [ <strong>-G</strong> ] [ <strong>-N</strong> ] [ <strong>-S</strong> ]
-[ <strong>-T</strong> ] [ <strong>-W</strong> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>rotconverter</strong> reads one or more plate motion models (stage or total
-reconstruction rotations) stored in the given files. If more than one
-plate motion model is given we will add or subtract them in the order
-they were listed. The minus sign means we should first transpose the
-rotation and then add it to the previous rotation. If a file cannot be
-opened we will attempt to decode the file name as a single rotation
-whose parameters are separated by slashes.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>rotX</em></dt>
-<dd>Name of a file with a plate motion model. Separate several files
-with desired operator (+ or -). The very first file may also have a
-leading minus operator to imply a transpose. We also recognize
-filenames of the form A-B, where both A and B are uppercase plate
-abbreviations as used by GPlates, to indicate we should look up the
-rotation between the two plates in the GPlates rotation file (e.g.,
-PAC-MBL). If any of the specified rotation models cannot be opened
-as a file, we will try to decode the file name as
-<em>lon/lat/tstart</em>[<em>/tstop</em>]/<em>angle</em> for a single rotation given
-on the command line. The <em>tstop</em> argument is required for stage
-poles only. For a single total reconstruction rotation without any
-time information, give <em>lon/lat/angle</em> only.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong></dt>
-<dd>Indicate that times are actually just opening angles [times in Myr].</dd>
-<dt><strong>-D</strong></dt>
-<dd>Report longitudes use the -180/+180 range [Default is 0/360].</dd>
-<dt><strong>-E</strong>[<em>fact</em>]</dt>
-<dd>Scale opening angles by <em>fact</em> on output [0.5].
-Typically used to get half-rates needed for flowlines.
-Requires stage pole output (see <strong>-F</strong>).</dd>
-<dt><strong>-F</strong><em>out</em></dt>
-<dd>Specify the output format for rotations. The <em>out</em> flag must be
-either <strong>t</strong> or <strong>s</strong> for total reconstruction or stage rotations,
-respectively. [Default is <strong>-Ft</strong> (output contains total
-reconstruction rotations)].</dd>
-<dt><strong>-G</strong></dt>
-<dd>Output final rotations in the Plates4 format used by GPlates [Default is spotter format].</dd>
-<dt><strong>-N</strong></dt>
-<dd>Place all output poles in the northern hemisphere [Default reports positive rotation angles].</dd>
-<dt><strong>-S</strong></dt>
-<dd>Place all output poles in the southern hemisphere [Default reports positive rotation angles].</dd>
-<dt><strong>-T</strong></dt>
-<dd>Transpose the final result, i.e., change the sign of the rotation angles.</dd>
-<dt><strong>-W</strong></dt>
-<dd>Ensure all output rotations have negative opening angles [Default reports positive rotation angles].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. Report statistics of extracted rotations.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="limitations">
-<h2>Limitations<a class="headerlink" href="#limitations" title="Permalink to this headline">¶</a></h2>
-<p>Note that only one of <strong>-N</strong>, <strong>-S</strong>, and <strong>-W</strong> can be used at the same time.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To convert the total reconstruction rotations in the file
-model_total_reconstruction.APM to stage poles, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt rotconverter model_total_reconstruction.APM -Fs > model_stages.APM
-</pre></div>
-</div>
-</div></blockquote>
-<p>To obtain Nazca motion relative to Pacific hotspots by adding the motion
-of Nazca relative to a fixed Pacific to the Pacific-Hotspot reference
-model DC85_stages.d, and report the result as total reconstruction
-reconstruction poles in the northern hemisphere, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt rotconverter DC85_stages.APM + Pac_Naz_stages.RPM -N -Ft > \
- Naz_HS_total reconstruction.APM
-</pre></div>
-</div>
-</div></blockquote>
-<p>To add the final rotations ROT(150.1, 70.5, -20.3) and ROT (145.0, 40.0, 11.4), try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt rotconverter 150.1/70.5/-20.3 + 145/40/11.4
-</pre></div>
-</div>
-</div></blockquote>
-<p>which prints out 157.32, -80.44, 11.97.</p>
-<p>To make stage rotations suitable for generating flowlines (fracture
-zones) from a model of relative plate motions PL1-PL2.RPM, assuming
-symmetric spreading, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt rotconverter PL1-PL2.RPM -E -Fs > PL1-PL2_half.RPM
-gmt rotconverter - PL1-PL2.RPM -E -Fs > PL2-PL1_half.RPM
-</pre></div>
-</div>
-</div></blockquote>
-<p>To compute rotations for India relative to a fixed Africa using the
-plate circuit India-Central Indian Basin-Antarctica-Africa, based on the
-GPlates rotations database, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt rotconverter IND-CIB CIB-ANT ANT-AFR > India_AFrica.RPM
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="backtracker.html"><em>backtracker</em></a>,
-<a class="reference internal" href="grdrotater.html"><em>grdrotater</em></a>,
-<a class="reference internal" href="grdspotter.html"><em>grdspotter</em></a>,
-<a class="reference internal" href="hotspotter.html"><em>hotspotter</em></a>,
-<a class="reference internal" href="originator.html"><em>originator</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">rotconverter</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#limitations">Limitations</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="originator.html"
- title="previous chapter">originator</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="../../SUP_X2SYS.html"
- title="next chapter">X2SYS</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/spotter/rotconverter.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="../../SUP_X2SYS.html" title="X2SYS"
- >next</a> </li>
- <li class="right" >
- <a href="originator.html" title="originator"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_SPOTTER.html" >SPOTTER</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/x2sys/x2sys_binlist.html b/doc_release/html/supplements/x2sys/x2sys_binlist.html
deleted file mode 100644
index 7475c9e..0000000
--- a/doc_release/html/supplements/x2sys/x2sys_binlist.html
+++ /dev/null
@@ -1,265 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>x2sys_binlist — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="X2SYS" href="../../SUP_X2SYS.html" />
- <link rel="next" title="x2sys_cross" href="x2sys_cross.html" />
- <link rel="prev" title="X2SYS" href="../../SUP_X2SYS.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="x2sys_cross.html" title="x2sys_cross"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="../../SUP_X2SYS.html" title="X2SYS"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_X2SYS.html" accesskey="U">X2SYS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="x2sys-binlist">
-<span id="index-0"></span><h1>x2sys_binlist<a class="headerlink" href="#x2sys-binlist" title="Permalink to this headline">¶</a></h1>
-<p>x2sys_binlist - Create bin index listing from track data files</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>x2sys_binlist</strong> <em>track(s)</em> <strong>-T</strong><em>TAG</em> [ <strong>-D</strong> ] [ <strong>-E</strong> ]
-[ <strong>-V</strong>[<em>level</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>x2sys_binlist</strong> reads one or more track data files and produces a
-multisegment ASCII track bin-index file (tbf) with the track name in the
-header and one data record per bin crossed; these records contain <em>lon</em>,
-<em>lat</em>, <em>index</em>, <em>flags</em>[, <em>dist</em>], where <em>lon</em>, <em>lat</em> are the
-coordinates of the center of the bin, the <em>index</em> is the 1-D number of
-the bin, and <em>flags</em> is a bitflag that describes which data fields were
-available in this bin. The optional <em>dist</em> requires <strong>-D</strong>. The input
-files can be of any format, which must be described and passed with the
-<strong>-T</strong> option. The bin-index listing is a crude representation of where
-the track goes and is used by the data archivist to build an x2sys track
-data base for miscellaneous track queries, such as when needing to
-determine which tracks should be compared in a crossover analysis. You
-must run <strong>x2sys_init</strong> to initialize the tag before you can run the
-indexing.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>tracks</em></dt>
-<dd>Can be one or more ASCII, native binary, or COARDS netCDF 1-D data
-files. To supply the data files via a text file with a list of
-tracks (one per record), specify the name of the track list after a
-leading equal-sign (e.g., =tracks.lis). If the names are missing
-their file extension we will append the suffix specified for this
-<em>TAG</em>. Track files will be searched for first in the current
-directory and second in all directories listed in
-<strong>$X2SYS_HOME</strong>/<em>TAG</em>/<em>TAG</em>_paths.txt (if it exists). [If
-<strong>$X2SYS_HOME</strong> is not set it will default to
-<strong>$GMT_SHAREDIR</strong>/x2sys]. (Note: MGD77 files will also be looked
-for via <strong>MGD77_HOME</strong>/mgd77_paths.txt and *.gmt files will be
-searched for via <strong>$GMT_SHAREDIR</strong>/mgg/gmtfile_paths).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-T</strong><em>TAG</em></dt>
-<dd>Specify the x2sys <em>TAG</em> which tracks the attributes of this data type.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-D</strong></dt>
-<dd>Calculate the length of trackline segments per bin [Default skips
-this step]. The length fragments are given as the 5th output column
-(after the <em>flags</em>). The length units are obtained via the TAB
-setting (see <strong>x2sys_init</strong>).</dd>
-<dt><strong>-E</strong></dt>
-<dd>Convert geographic data to a cylindrical equal-area projection prior
-to binning. Basically, we apply the projection
-<strong>-JY</strong><em>lon0</em>/37:04:17.166076/360, where <em>lon0</em> is the
-mid-longitude of the region. Requires <strong>-D</strong>, geographical data, and
-a global region (e.g., <strong>-Rg</strong> or <strong>-Rd</strong>). This option is useful
-for statistics related to trackline density but should not be used
-when preparing bin-index files for the x2sys track data bases.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To create a bin index file from the MGD77 file 01030061.mgd77 using the
-settings associated with the tag MGD77, do</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt x2sys_binlist 01030061.mgd77 -TMGD77 > 01030061.tbf
-</pre></div>
-</div>
-</div></blockquote>
-<p>To create a track bin index file of all MGD77+ files residing in the
-current directory using the settings associated with the tag MGD77+ and
-calculate track distances, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt x2sys_binlist *.nc -TMGD77+ -D > all.tbf
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="x2sys_cross.html"><em>x2sys_cross</em></a>,
-<a class="reference internal" href="x2sys_datalist.html"><em>x2sys_datalist</em></a>,
-<a class="reference internal" href="x2sys_get.html"><em>x2sys_get</em></a>,
-<a class="reference internal" href="x2sys_init.html"><em>x2sys_init</em></a>,
-<a class="reference internal" href="x2sys_put.html"><em>x2sys_put</em></a>,
-<a class="reference internal" href="x2sys_report.html"><em>x2sys_report</em></a>,
-<a class="reference internal" href="x2sys_solve.html"><em>x2sys_solve</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">x2sys_binlist</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="../../SUP_X2SYS.html"
- title="previous chapter">X2SYS</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="x2sys_cross.html"
- title="next chapter">x2sys_cross</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/x2sys/x2sys_binlist.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="x2sys_cross.html" title="x2sys_cross"
- >next</a> </li>
- <li class="right" >
- <a href="../../SUP_X2SYS.html" title="X2SYS"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_X2SYS.html" >X2SYS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/x2sys/x2sys_cross.html b/doc_release/html/supplements/x2sys/x2sys_cross.html
deleted file mode 100644
index 9723dda..0000000
--- a/doc_release/html/supplements/x2sys/x2sys_cross.html
+++ /dev/null
@@ -1,366 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>x2sys_cross — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="X2SYS" href="../../SUP_X2SYS.html" />
- <link rel="next" title="x2sys_datalist" href="x2sys_datalist.html" />
- <link rel="prev" title="x2sys_binlist" href="x2sys_binlist.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="x2sys_datalist.html" title="x2sys_datalist"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="x2sys_binlist.html" title="x2sys_binlist"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_X2SYS.html" accesskey="U">X2SYS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="x2sys-cross">
-<span id="index-0"></span><h1>x2sys_cross<a class="headerlink" href="#x2sys-cross" title="Permalink to this headline">¶</a></h1>
-<p>x2sys_cross - Calculate crossovers between track data files</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>x2sys_cross</strong> <em>track(s)</em> <strong>-T</strong><em>TAG</em> [ <strong>-A</strong><em>combi.lis</em> ]
-[ <strong>-C</strong>[<em>runtimes</em>] ] [ <strong>-Il</strong>|<strong>a</strong>|<strong>c</strong> ]
-[ <strong>-J</strong><em>parameters</em> ] [ <strong>-Qe</strong>|<strong>i</strong> ]
-[ <strong>-Sl</strong>|<strong>u</strong>|<strong>h</strong><em>speed</em> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W</strong><em>size</em> ] [ <strong>-Z</strong> ]
-[ <strong>-bo</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>x2sys_cross</strong> is used to determine all intersections between
-(“external cross-overs”) or within (“internal cross-overs”) tracks
-(Cartesian or geographic), and report the time, position, distance along
-track, heading and speed along each track segment, and the crossover
-error (COE) and mean values for all observables. The names of the tracks
-are passed on the command line. By default, <strong>x2sys_cross</strong> will look
-for both external and internal COEs. As an option, you may choose to
-project all data using one of the map-projections prior to calculating
-the COE.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>tracks</em></dt>
-<dd>Can be one or more ASCII, native binary, or COARDS netCDF 1-D data
-files. To supply the data files via a text file with a list of
-tracks (one per record), specify the name of the track list after a
-leading equal-sign (e.g., =tracks.lis). If the names are missing
-their file extension we will append the suffix specified for this
-<em>TAG</em>. Track files will be searched for first in the current
-directory and second in all directories listed in
-<strong>$X2SYS_HOME</strong>/<em>TAG</em>/<em>TAG</em>_paths.txt (if it exists). [If
-<strong>$X2SYS_HOME</strong> is not set it will default to
-<strong>$GMT_SHAREDIR</strong>/x2sys]. (Note: MGD77 files will also be looked
-for via <strong>MGD77_HOME</strong>/mgd77_paths.txt and *.gmt files will be
-searched for via <strong>$GMT_SHAREDIR</strong>/mgg/gmtfile_paths).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-T</strong><em>TAG</em></dt>
-<dd>Specify the x2sys <em>TAG</em> which tracks the attributes of this data type.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong><em>combi.lis</em></dt>
-<dd>Only process the pair-combinations found in the file <em>combi.lis</em>
-[Default process all possible combinations among the specified
-files]. The file <em>combi.lis</em> created by x2sys_get -L option</dd>
-<dt><strong>-C</strong>[<em>runtimes</em>]</dt>
-<dd>Compute and append the processing run-time for each pair to the
-progress message. Append a filename to save these run-times to file.
-The idea here is to use the knowledge of run-times to split the main
-process in a number of sub-processes that can each be launched in a
-different processor of your multi-core machine. See the MATLAB
-function <em>split_file4coes.m</em> that lives in the x2sys supplement
-source code.</dd>
-<dt><strong>-Il</strong>|<strong>a</strong>|<strong>c</strong></dt>
-<dd><p class="first">Sets the interpolation mode for estimating values at the crossover.
-Choose among:</p>
-<p><strong>l</strong> Linear interpolation [Default].</p>
-<p><strong>a</strong> Akima spline interpolation.</p>
-<p class="last"><strong>c</strong> Cubic spline interpolation.</p>
-</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-J</strong><em>parameters</em> <a class="reference internal" href="../../gmt.html#j-full"><em>(more ...)</em></a></dt>
-<dd>Select map projection.</dd>
-<dt><strong>-Qe</strong>|<strong>i</strong></dt>
-<dd>Append <strong>e</strong> for external COEs only, and <strong>i</strong> for internal COEs
-only [Default is all COEs].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]</dt>
-<dd><em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> specify the region of interest,
-and you may specify them in decimal degrees or in
-[+-]dd:mm[:ss.xxx][W|E|S|N] format. Append <strong>r</strong> if lower left
-and upper right map coordinates are given instead of w/e/s/n. The
-two shorthands <strong>-Rg</strong> and <strong>-Rd</strong> stand for global domain (0/360
-and -180/+180 in longitude respectively, with -90/+90 in latitude).
-Alternatively, specify the name of an existing grid file and the
-<strong>-R</strong> settings (and grid spacing, if applicable) are copied from
-the grid. Using <strong>-R</strong><em>unit</em> expects projected (Cartesian)
-coordinates compatible with chosen <strong>-J</strong> and we inversely project
-to determine actual rectangular geographic region.
-For perspective view (<strong>-p</strong>), optionally append /<em>zmin</em>/<em>zmax</em>.
-In case of perspective view (<strong>-p</strong>), a z-range (<em>zmin</em>, <em>zmax</em>)
-can be appended to indicate the third dimension. This needs to be
-done only when using the <strong>-Jz</strong> option, not when using only the
-<strong>-p</strong> option. In the latter case a perspective view of the plane is
-plotted, with no third dimension. For Cartesian
-data just give <em>xmin/xmax/ymin/ymax</em>. This option limits the COEs to
-those that fall inside the specified domain.</dd>
-<dt><strong>-Sl</strong>|<strong>u</strong>|<strong>h</strong><em>speed</em></dt>
-<dd><p class="first">Defines window of track speeds. If speeds are outside this window we
-do not calculate a COE. Specify</p>
-<p><strong>-Sl</strong> sets lower speed [Default is 0].</p>
-<p><strong>-Su</strong> sets upper speed [Default is Infinity].</p>
-<p class="last"><strong>-Sh</strong> does not limit the speed but sets a lower speed below which headings
-will not be computed (i.e., set to NaN) [Default calculates
-headings regardless of speed].</p>
-</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong><em>size</em></dt>
-<dd>Give the maximum number of data points on either side of the
-crossover to use in the spline interpolation [3].</dd>
-<dt><strong>-Z</strong></dt>
-<dd>Report the values of each track at the crossover [Default reports
-the crossover value and the mean value].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="../../gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="remarks">
-<h2>Remarks<a class="headerlink" href="#remarks" title="Permalink to this headline">¶</a></h2>
-<p>The COEs found are printed out to standard output in ASCII format
-(unless <strong>-bo</strong> is set). When ASCII is chosen,
-the output format depends on whether or not old-style XOVER output
-(<strong>-L</strong>) has been selected [See the <em class="manpage">x_over(1)</em> man page for more
-details]. If ASCII, then the first record contains the name of the tag
-used, the second records specifies the exact command line used for this
-run, and the third record contains the names of each column. For each
-track pair, there will be a segment header record containing the two
-file names and their start/stop/dist information (start/stop is absolute
-time or NaN if unavailable while dist is the total track length),
-whereas subsequent records have the data for each COE encountered. The
-fields written out are x, y, time along track #1 and #2, distance along
-track #1 and #2, heading along track #1 and #2, velocity along track #1
-and #2, and then pairs of columns for each selected observable. These
-are either pairs of (COE, average value) for each data type (or
-track-values #1 and #2; see <strong>-Z</strong>). It is recommended that the Akima
-spline is used instead of the natural cubic spline, since it is less
-sensitive to outliers that tend to introduce wild oscillations in the
-interpolation.</p>
-</div>
-<div class="section" id="sign-convention">
-<h2>Sign Convention<a class="headerlink" href="#sign-convention" title="Permalink to this headline">¶</a></h2>
-<p>If track_a and track_b are passed on the command line, then the COE
-value is Value (track_a) - Value (track_b).</p>
-</div>
-<div class="section" id="precision-and-format">
-<h2>Precision And Format<a class="headerlink" href="#precision-and-format" title="Permalink to this headline">¶</a></h2>
-<p>The output format of individual columns are controlled by
-<a class="reference internal" href="../../gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> except for geographic coordinates
-(<a class="reference internal" href="../../gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>) and absolute calendar time
-(<a class="reference internal" href="../../gmt.conf.html#format-date-out"><em>FORMAT_DATE_OUT</em></a>, <a class="reference internal" href="../../gmt.conf.html#format-clock-out"><em>FORMAT_CLOCK_OUT</em></a>).
-Make sure these are setto give you enough significant digits to achieve the desired precision.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To compute all internal crossovers in the gmt-formatted file c2104.gmt,
-and using the tag GMT, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt x2sys_cross c2104.gmt -TGMT > c2104.d
-</pre></div>
-</div>
-</div></blockquote>
-<p>To find the crossover locations with bathymetry between the two MGD77
-files A13232.mgd77 and A99938.mgd77, using the MGD77 tag, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt x2sys_cross A13232.mgd77 A99938.mgd77 -Qe -TMGD77 > crossovers.d
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>Wessel, P. (2010), Tools for analyzing intersecting tracks: the x2sys
-package. <em>Computers and Geosciences</em>, <strong>36</strong>, 348-354.</p>
-<p>Wessel, P. (1989), XOVER: A cross-over error detector for track data,
-<em>Computers and Geosciences</em>, <strong>15</strong>(3), 333-346.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="../../gmt.html"><em>gmt</em></a>, <a class="reference internal" href="x2sys_binlist.html"><em>x2sys_binlist</em></a>,
-<a class="reference internal" href="x2sys_init.html"><em>x2sys_init</em></a>,
-<a class="reference internal" href="x2sys_datalist.html"><em>x2sys_datalist</em></a>,
-<a class="reference internal" href="x2sys_get.html"><em>x2sys_get</em></a>,
-<a class="reference internal" href="x2sys_list.html"><em>x2sys_list</em></a>,
-<a class="reference internal" href="x2sys_put.html"><em>x2sys_put</em></a>,
-<a class="reference internal" href="x2sys_report.html"><em>x2sys_report</em></a>,
-<a class="reference internal" href="x2sys_solve.html"><em>x2sys_solve</em></a>,
-<em class="manpage">x_over(1)</em></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">x2sys_cross</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#remarks">Remarks</a></li>
-<li><a class="reference internal" href="#sign-convention">Sign Convention</a></li>
-<li><a class="reference internal" href="#precision-and-format">Precision And Format</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="x2sys_binlist.html"
- title="previous chapter">x2sys_binlist</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="x2sys_datalist.html"
- title="next chapter">x2sys_datalist</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/x2sys/x2sys_cross.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="x2sys_datalist.html" title="x2sys_datalist"
- >next</a> </li>
- <li class="right" >
- <a href="x2sys_binlist.html" title="x2sys_binlist"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_X2SYS.html" >X2SYS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/x2sys/x2sys_datalist.html b/doc_release/html/supplements/x2sys/x2sys_datalist.html
deleted file mode 100644
index 2270a97..0000000
--- a/doc_release/html/supplements/x2sys/x2sys_datalist.html
+++ /dev/null
@@ -1,350 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>x2sys_datalist — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="X2SYS" href="../../SUP_X2SYS.html" />
- <link rel="next" title="x2sys_get" href="x2sys_get.html" />
- <link rel="prev" title="x2sys_cross" href="x2sys_cross.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="x2sys_get.html" title="x2sys_get"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="x2sys_cross.html" title="x2sys_cross"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_X2SYS.html" accesskey="U">X2SYS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="x2sys-datalist">
-<span id="index-0"></span><h1>x2sys_datalist<a class="headerlink" href="#x2sys-datalist" title="Permalink to this headline">¶</a></h1>
-<p>x2sys_datalist - Extract content of track data files</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>x2sys_datalist</strong> <em>track(s)</em> <strong>-T</strong><em>TAG</em> [ <strong>-A</strong> ] [ <strong>-E</strong> ]
-[ <strong>-F</strong><em>name1</em>,<em>name2</em>,...) ] [ <strong>-I</strong>[<em>list</em>] ]
-[ <strong>-L</strong>[<em>corrtable</em>] ]
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ]
-[ <strong>-S</strong> ] [
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-bo</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>x2sys_datalist</strong> reads one or more files and produces a single ASCII
-[or binary] table. The files can be of any format, which must be
-described and passed with the <strong>-T</strong> option. You may limit the output to
-a geographic region, and insist that the output from several files be
-separated by a multiple segment header. Only the named data fields will
-be output [Default selects all columns].</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>tracks</em></dt>
-<dd>Can be one or more ASCII, native binary, or COARDS netCDF 1-D data
-files. To supply the data files via a text file with a list of
-tracks (one per record), specify the name of the track list after a
-leading equal-sign (e.g., =tracks.lis). If the names are missing
-their file extension we will append the suffix specified for this
-<em>TAG</em>. Track files will be searched for first in the current
-directory and second in all directories listed in
-<strong>$X2SYS_HOME</strong>/<em>TAG</em>/<em>TAG</em>_paths.txt (if it exists). [If
-<strong>$X2SYS_HOME</strong> is not set it will default to
-<strong>$GMT_SHAREDIR</strong>/x2sys]. (Note: MGD77 files will also be looked
-for via <strong>MGD77_HOME</strong>/mgd77_paths.txt and *.gmt files will be
-searched for via <strong>$GMT_SHAREDIR</strong>/mgg/gmtfile_paths).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-T</strong><em>TAG</em></dt>
-<dd>Specify the x2sys <em>TAG</em> which tracks the attributes of this data type.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong></dt>
-<dd>Eliminate COEs by distributing the COE between the two tracks in
-proportion to track weight. These (dist, adjustment) spline knots
-files for each track and data column are called <em>track.column</em>.adj
-and are expected to be in the <strong>$X2SYS_HOME</strong>/<em>TAG</em> directory. The
-adjustments are only applied if the corresponding adjust file can be
-found [No residual adjustments]</dd>
-<dt><strong>-E</strong></dt>
-<dd>Enhance ASCII output by writing GMT segment headers between data
-from each track [no segment headers].</dd>
-<dt><strong>-F</strong><em>name1</em>,<em>name2</em>,...)</dt>
-<dd>Give a comma-separated sub-set list of column names defined in the
-definition file. [Default selects all data columns].</dd>
-<dt><strong>-I</strong>[<em>list</em>]</dt>
-<dd>Name of ASCII file with a list of track names (one per record) that
-should be excluded from consideration [Default includes all tracks].</dd>
-<dt><strong>-L</strong>[<em>corrtable</em>]</dt>
-<dd>Apply optimal corrections to columns where such corrections are
-available. Append the correction table to use [Default uses the
-correction table <em>TAG</em>_corrections.txt which is expected to
-reside in the <strong>$X2SYS_HOME</strong>/<em>TAG</em> directory]. For the format of
-this file, see CORRECTIONS below.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]</dt>
-<dd><em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> specify the region of interest,
-and you may specify them in decimal degrees or in
-[+-]dd:mm[:ss.xxx][W|E|S|N] format. Append <strong>r</strong> if lower left
-and upper right map coordinates are given instead of w/e/s/n. The
-two shorthands <strong>-Rg</strong> and <strong>-Rd</strong> stand for global domain (0/360
-and -180/+180 in longitude respectively, with -90/+90 in latitude).
-Alternatively, specify the name of an existing grid file and the
-<strong>-R</strong> settings (and grid spacing, if applicable) are copied from
-the grid. Using <strong>-R</strong><em>unit</em> expects projected (Cartesian)
-coordinates compatible with chosen <strong>-J</strong> and we inversely project
-to determine actual rectangular geographic region.
-For perspective view (<strong>-p</strong>), optionally append /<em>zmin</em>/<em>zmax</em>.
-In case of perspective view (<strong>-p</strong>), a z-range (<em>zmin</em>, <em>zmax</em>)
-can be appended to indicate the third dimension. This needs to be
-done only when using the <strong>-Jz</strong> option, not when using only the
-<strong>-p</strong> option. In the latter case a perspective view of the plane is
-plotted, with no third dimension. For Cartesian
-data just give <em>xmin/xmax/ymin/ymax</em>. This option limits the COEs to
-those that fall inside the specified domain.</dd>
-<dt><strong>-S</strong></dt>
-<dd>Suppress output records where all the data columns are NaN [Default
-will output all records].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="../../gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="../../gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To extract all data from the old-style MGG supplement file c2104.gmt,
-recognized by the tag GMT:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt x2sys_datalist c2104.gmt -TGMT > myfile
-</pre></div>
-</div>
-</div></blockquote>
-<p>To make lon,lat, and depth input for <strong>blockmean</strong> and <strong>surface</strong> using
-all the files listed in the file tracks.lis and define by the tag TRK,
-but only the data that are inside the specified area, and make output
-binary, run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt x2sys_datalist =tracks.lis -TTRK -Fon,lat,depth -R40/-30/25/35 -bo > alltopo_bin.xyz
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="corrections">
-<h2>Corrections<a class="headerlink" href="#corrections" title="Permalink to this headline">¶</a></h2>
-<p>The correction table is an ASCII file with coefficients and parameters
-needed to carry out corrections. This table is usually produced by
-<strong>x2sys_solve</strong>. Comment records beginning with # are allowed. All
-correction records are of the form</p>
-<p><em>trackID observation correction</em></p>
-<p>where <em>trackID</em> is the track name, <em>observation</em> is one of the
-abbreviations for an observed field contained in files under this TAG,
-and <em>correction</em> consists of one or more white-space-separated <em>term</em>s
-that will be <strong>subtracted</strong> from the observation before output. Each
-<em>term</em> must have this exact syntax:</p>
-<p><em>factor</em>[*[<em>function</em>]([<em>scale</em>](<em>abbrev</em>[-<em>origin</em>]))[^<em>power</em>]]</p>
-<p>where terms in brackets are optional (the brackets themselves are not
-used but regular parentheses must be used exactly as indicated). No
-spaces are allowed except between <em>term</em>s. The <em>factor</em> is the
-amplitude of the basis function, while the optional <em>function</em> can be
-one of sin, cos, or exp. The optional <em>scale</em> and <em>origin</em> can be used
-to translate the argument (before giving it to the optional function).
-The argument <em>abbrev</em> is one of the abbreviations for columns known to
-this TAG. However, it can also be one of the three auxiliary terms
-<strong>dist</strong> (for along-track distances), <strong>azim</strong> for along-track azimuths,
-and <strong>vel</strong> (for along-track speed); these are all sensitive to the
-<strong>-C</strong> and <strong>-N</strong> settings used when defining the TAB; furthermore,
-<strong>vel</strong> requires <strong>time</strong> to be present in the data. If <em>origin</em> is
-given as <strong>T</strong> it means that we should replace it with the value of
-<em>abbrev</em> for the very first record in the file (this is usually only
-done for <em>time</em>). If the first data record entry is NaN we revert
-<em>origin</em> to zero. Optionally, raise the entire expression to the given
-<em>power</em>, before multiplying by <em>factor</em>. The following is an example of
-fictitious corrections to the track ABC, implying the <strong>z</strong> column
-should have a linear trend removed, the field <strong>obs</strong> should be
-corrected by a strange dependency on latitude, <strong>weight</strong> needs to have
-1 added (hence correction is given as -1), and <strong>fuel</strong> should be
-reduced by a linear distance term:</p>
-<p>ABC z 7.1 1e-4*((time-T))</p>
-<p>ABC obs 0.5*exp(-1e-3(lat))^1.5</p>
-<p>ABC weight -1</p>
-<p>ABC fuel 0.02*((dist))</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="../../blockmean.html"><em>blockmean</em></a>,
-<a class="reference internal" href="../../gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="../../surface.html"><em>surface</em></a>,
-<a class="reference internal" href="x2sys_init.html"><em>x2sys_init</em></a>,
-<a class="reference internal" href=""><em>x2sys_datalist</em></a>,
-<a class="reference internal" href="x2sys_get.html"><em>x2sys_get</em></a>,
-<a class="reference internal" href="x2sys_list.html"><em>x2sys_list</em></a>,
-<a class="reference internal" href="x2sys_put.html"><em>x2sys_put</em></a>,
-<a class="reference internal" href="x2sys_report.html"><em>x2sys_report</em></a>,
-<a class="reference internal" href="x2sys_solve.html"><em>x2sys_solve</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">x2sys_datalist</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#corrections">Corrections</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="x2sys_cross.html"
- title="previous chapter">x2sys_cross</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="x2sys_get.html"
- title="next chapter">x2sys_get</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/x2sys/x2sys_datalist.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="x2sys_get.html" title="x2sys_get"
- >next</a> </li>
- <li class="right" >
- <a href="x2sys_cross.html" title="x2sys_cross"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_X2SYS.html" >X2SYS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/x2sys/x2sys_get.html b/doc_release/html/supplements/x2sys/x2sys_get.html
deleted file mode 100644
index 0b341fd..0000000
--- a/doc_release/html/supplements/x2sys/x2sys_get.html
+++ /dev/null
@@ -1,295 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>x2sys_get — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="X2SYS" href="../../SUP_X2SYS.html" />
- <link rel="next" title="x2sys_init" href="x2sys_init.html" />
- <link rel="prev" title="x2sys_datalist" href="x2sys_datalist.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="x2sys_init.html" title="x2sys_init"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="x2sys_datalist.html" title="x2sys_datalist"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_X2SYS.html" accesskey="U">X2SYS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="x2sys-get">
-<span id="index-0"></span><h1>x2sys_get<a class="headerlink" href="#x2sys-get" title="Permalink to this headline">¶</a></h1>
-<p>x2sys_get - Get track listing from the x2sys track index databases</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>x2sys_get</strong> <strong>-T</strong><em>TAG</em> [ <strong>-C</strong> ] [ <strong>-F</strong><em>flags</em> ] [ <strong>-G</strong> ]
-[ <strong>-L</strong>[<strong>+</strong>][<em>list</em>] ] [ <strong>-N</strong><em>flags</em> ] [
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ]
-[ <strong>-V</strong>[<em>level</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>x2sys_get</strong> will return the names of the track data files in the
-x2sys data base for this TAG that match the given requirements. You may
-choose a specific region and optionally ask only for tracks that meet
-certain data criteria. Finally, you may select an option to list all
-possible pairs that might generate crossovers.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-T</strong><em>TAG</em></dt>
-<dd>Specify the x2sys <em>TAG</em> which tracks the attributes of this data type.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-C</strong></dt>
-<dd>Instead of reporting the track names, just output the coordinates of
-the center of each bin that has at least one track with the
-specified data.</dd>
-<dt><strong>-D</strong></dt>
-<dd>Only report the track names [Default adds the availability of data for each field].</dd>
-<dt><strong>-F</strong><em>flags</em></dt>
-<dd>Give a comma-separated list of column names (as described in the
-definition file) that should be present. [Default selects all data columns].</dd>
-<dt><strong>-G</strong></dt>
-<dd>Report data flags (Y or N) for the entire track rather than just for
-the portion that is inside the region set by <strong>-R</strong> [Default].</dd>
-<dt><strong>-L</strong>[<strong>+</strong>][<em>list</em>]</dt>
-<dd>Crossover mode. Return a list of track pairs that should be checked
-for possible crossovers. The list is determined from the bin-index
-data base on the assumption that tracks occupying the same bin are
-very likely to intersect. By default we return all possible pairs in
-the data base. Append the name of a file with a list of tracks if
-you want to limit the output to those pairs that involve at least
-one of the track names in your list. The output is suitable for the
-<strong>-A</strong> option in <strong>x2sys_cross</strong>. By default, only external
-crossover pairs are listed. Use <strong>-L+</strong> to include internal pairs in
-the list.</dd>
-<dt><strong>-N</strong><em>flags</em></dt>
-<dd>Give a comma-separated list of column names (as described in the
-definition file) that must be absent.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]</dt>
-<dd><em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> specify the region of interest,
-and you may specify them in decimal degrees or in
-[+-]dd:mm[:ss.xxx][W|E|S|N] format. Append <strong>r</strong> if lower left
-and upper right map coordinates are given instead of w/e/s/n. The
-two shorthands <strong>-Rg</strong> and <strong>-Rd</strong> stand for global domain (0/360
-and -180/+180 in longitude respectively, with -90/+90 in latitude).
-Alternatively, specify the name of an existing grid file and the
-<strong>-R</strong> settings (and grid spacing, if applicable) are copied from
-the grid. Using <strong>-R</strong><em>unit</em> expects projected (Cartesian)
-coordinates compatible with chosen <strong>-J</strong> and we inversely project
-to determine actual rectangular geographic region.
-For perspective view (<strong>-p</strong>), optionally append /<em>zmin</em>/<em>zmax</em>.
-In case of perspective view (<strong>-p</strong>), a z-range (<em>zmin</em>, <em>zmax</em>)
-can be appended to indicate the third dimension. This needs to be
-done only when using the <strong>-Jz</strong> option, not when using only the
-<strong>-p</strong> option. In the latter case a perspective view of the plane is
-plotted, with no third dimension. For Cartesian
-data just give <em>xmin/xmax/ymin/ymax</em>. This option limits the tracks
-to those that fall at least partly inside the specified domain.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To find all the tracks associated with the tag MGD77, restricted to
-occupy a certain region in the south Pacific, and have at least free air
-anomalies and bathymetry, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt x2sys_get -V -TMGD77 -R180/240/-60/-30 -Ffaa,depth
-</pre></div>
-</div>
-</div></blockquote>
-<p>To find all the tracks associated with the tag MGD77 that have depth but
-not twt, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt x2sys_get -V -TMGD77 -Fdepth -Nwt
-</pre></div>
-</div>
-</div></blockquote>
-<p>To find all the pairs associated with the tag MGD77 that might intersect
-each other, but only those pairs which involves tracks in your list
-new.lis, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt x2sys_get -V -TMGD77 -Lnew.lis > xpairs.lis
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="note">
-<h2>Note<a class="headerlink" href="#note" title="Permalink to this headline">¶</a></h2>
-<p>The tracks that are returned all have the requested data (<strong>-F</strong>) within
-the specified region (<strong>-R</strong>). Furthermore, the columns of Y and N for
-other data types also reflect the content of the track portion within
-the selected region, unless <strong>-G</strong> is set.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="x2sys_binlist.html"><em>x2sys_binlist</em></a>,
-<a class="reference internal" href="x2sys_cross.html"><em>x2sys_cross</em></a>
-<a class="reference internal" href="x2sys_datalist.html"><em>x2sys_datalist</em></a>,
-<a class="reference internal" href="x2sys_init.html"><em>x2sys_init</em></a>,
-<a class="reference internal" href="x2sys_list.html"><em>x2sys_list</em></a>,
-<a class="reference internal" href="x2sys_put.html"><em>x2sys_put</em></a>,
-<a class="reference internal" href="x2sys_report.html"><em>x2sys_report</em></a>,
-<a class="reference internal" href="x2sys_solve.html"><em>x2sys_solve</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">x2sys_get</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#note">Note</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="x2sys_datalist.html"
- title="previous chapter">x2sys_datalist</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="x2sys_init.html"
- title="next chapter">x2sys_init</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/x2sys/x2sys_get.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="x2sys_init.html" title="x2sys_init"
- >next</a> </li>
- <li class="right" >
- <a href="x2sys_datalist.html" title="x2sys_datalist"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_X2SYS.html" >X2SYS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/x2sys/x2sys_init.html b/doc_release/html/supplements/x2sys/x2sys_init.html
deleted file mode 100644
index 5851eed..0000000
--- a/doc_release/html/supplements/x2sys/x2sys_init.html
+++ /dev/null
@@ -1,690 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>x2sys_init — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="X2SYS" href="../../SUP_X2SYS.html" />
- <link rel="next" title="x2sys_list" href="x2sys_list.html" />
- <link rel="prev" title="x2sys_get" href="x2sys_get.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="x2sys_list.html" title="x2sys_list"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="x2sys_get.html" title="x2sys_get"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_X2SYS.html" accesskey="U">X2SYS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="x2sys-init">
-<span id="index-0"></span><h1>x2sys_init<a class="headerlink" href="#x2sys-init" title="Permalink to this headline">¶</a></h1>
-<p>x2sys_init - Initialize a new x2sys track database</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>x2sys_init</strong> <em>TAG</em> <strong>-D</strong><em>deffile</em>
-[ <strong>-Cc</strong>|<strong>f</strong>|<strong>g</strong>|<strong>e</strong> ] [ <strong>-E</strong><em>suffix</em> ] [ <strong>-F</strong> ]
-[ <strong>-Gd</strong>|<strong>g</strong> ] [ <strong>-I</strong><em>dx</em>[/<em>dy</em>] ]
-[ <strong>-Nd</strong>|<strong>s</strong><em>unit</em> ]
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-Wt</strong>|<strong>d</strong><em>gap</em> ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>x2sys_init</strong> is the starting point for anyone wishing to use x2sys;
-it initializes a set of data bases that are particular to one kind of
-track data. These data, their associated data bases, and key parameters
-are given a short-hand notation called an x2sys TAG. The TAG keeps track
-of settings such as file format, whether the data are geographic or not,
-and the binning resolution for track indices. Running <strong>x2sys_init</strong> is
-a prerequisite to running any of the other x2sys programs, such as
-<strong>x2sys_binlist</strong>, which will create a crude representation of where
-each data track go within the domain and which observations are
-available; this information serves as input to <strong>x2sys_put</strong> which
-updates the track data base. Then, <strong>x2sys_get</strong> can be used to find
-which tracks and data are available inside a given region. With that
-list of tracks you can use <strong>x2sys_cross</strong> to calculate track
-crossovers, use <strong>x2sys_report</strong> to report crossover statistics or
-<strong>x2sys_list</strong> to pull out selected crossover information that
-<strong>x2sys_solve</strong> can use to determine track-specific systematic
-corrections. These corrections may be used with <strong>x2sys_datalist</strong> to
-extract corrected data values for use in subsequent work. Because you
-can run <strong>x2sys_init</strong> you <em>must</em> set the environmental parameter
-X2SYS_HOME to a directory where you have write permission, which is
-where x2sys can keep track of your settings.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>TAG</em></dt>
-<dd>The unique name of this data type x2sys TAG.</dd>
-<dt><strong>-D</strong><em>deffile</em></dt>
-<dd>Definition file prefix for this data set [See DEFINITION FILES below
-for more information]. Specify full path if the file is not in the
-current directory.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-Cc</strong>|<strong>f</strong>|<strong>g</strong>|<strong>e</strong></dt>
-<dd><p class="first">Select procedure for along-track distance calculation when needed by other programs:</p>
-<p><strong>c</strong> Cartesian distances [Default, unless <strong>-G</strong> is set].</p>
-<p><strong>f</strong> Flat Earth distances.</p>
-<p><strong>g</strong> Great circle distances [Default if <strong>-G</strong> is set].</p>
-<p class="last"><strong>e</strong> Geodesic distances on current GMT ellipsoid.</p>
-</dd>
-<dt><strong>-E</strong><em>suffix</em></dt>
-<dd>Specifies the file extension (suffix) for these data files. If not
-given we use the definition file prefix as the suffix (see <strong>-D</strong>).</dd>
-<dt><strong>-F</strong></dt>
-<dd>Force creating new files if old ones are present [Default will abort
-if old TAG files are found].</dd>
-<dt><strong>-Gd</strong>|<strong>g</strong></dt>
-<dd>Selects geographical coordinates. Append <strong>d</strong> for discontinuity at
-the Dateline (makes longitude go from -180 to + 180) or <strong>g</strong> for
-discontinuity at Greenwich (makes longitude go from 0 to 360
-[Default]). If not given we assume the data are Cartesian.</dd>
-<dt><strong>-I</strong><em>dx</em>[/<em>dy</em>]</dt>
-<dd><em>x_inc</em> [and optionally <em>y_inc</em>] is the grid spacing. Append <strong>m</strong>
-to indicate minutes or <strong>c</strong> to indicate seconds for geographic
-data. These spacings refer to the binning used in the track
-bin-index data base.</dd>
-<dt><strong>-Nd</strong>|<strong>s</strong><em>unit</em></dt>
-<dd>Sets the units used for distance and speed when requested by other
-programs. Append <strong>d</strong> for distance or <strong>s</strong> for speed, then give
-the desired <em>unit</em> as <strong>c</strong> (Cartesian userdist or
-userdist/usertime), <strong>e</strong> (meters or m/s), <strong>f</strong> (feet or feet/s),
-<strong>k</strong> (km or kms/hr), <strong>m</strong> (miles or miles/hr), <strong>n</strong> (nautical
-miles or knots) or <strong>u</strong> (survey feet or survey feet/s). [Default is
-<strong>-Ndk</strong> <strong>-Nse</strong> (km and m/s) if <strong>-G</strong> is set and <strong>-Ndc</strong> and
-<strong>-Nsc</strong> otherwise (Cartesian units)].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]</dt>
-<dd><em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> specify the region of interest,
-and you may specify them in decimal degrees or in
-[+-]dd:mm[:ss.xxx][W|E|S|N] format. Append <strong>r</strong> if lower left
-and upper right map coordinates are given instead of w/e/s/n. The
-two shorthands <strong>-Rg</strong> and <strong>-Rd</strong> stand for global domain (0/360
-and -180/+180 in longitude respectively, with -90/+90 in latitude).
-Alternatively, specify the name of an existing grid file and the
-<strong>-R</strong> settings (and grid spacing, if applicable) are copied from
-the grid. Using <strong>-R</strong><em>unit</em> expects projected (Cartesian)
-coordinates compatible with chosen <strong>-J</strong> and we inversely project
-to determine actual rectangular geographic region.
-For perspective view (<strong>-p</strong>), optionally append /<em>zmin</em>/<em>zmax</em>.
-In case of perspective view (<strong>-p</strong>), a z-range (<em>zmin</em>, <em>zmax</em>)
-can be appended to indicate the third dimension. This needs to be
-done only when using the <strong>-Jz</strong> option, not when using only the
-<strong>-p</strong> option. In the latter case a perspective view of the plane is
-plotted, with no third dimension. For Cartesian
-data just give <em>xmin/xmax/ymin/ymax</em>. This option bases the
-statistics on those COE that fall inside the specified domain.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-Wt</strong>|<strong>d</strong><em>gap</em></dt>
-<dd>Give <strong>t</strong> or <strong>d</strong> and append the corresponding maximum time gap
-(in user units; this is typically seconds [Infinity]), or distance
-(for units, see <strong>-N</strong>) gap [Infinity]) allowed between the two data
-points immediately on either side of a crossover. If these limits
-are exceeded then a data gap is assumed and no COE will be determined.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="definition-files">
-<h2>Definition Files<a class="headerlink" href="#definition-files" title="Permalink to this headline">¶</a></h2>
-<p>These *.def files contain information about the data file format and
-have two sections: (1) header information and (2) column
-information. All header information starts with the character # in the
-first column, immediately followed by an upper-case directive. If the
-directive takes an argument it is separated by white-space. You may
-append a trailing # comments. Five directives are recognized:</p>
-<p><strong>ASCII</strong> states that the data files are in ASCII format.</p>
-<p><strong>BINARY</strong> states that the data files are native binary files.</p>
-<p><strong>NETCDF</strong> states that the data files are COARDS-compliant 1-D netCDF files.</p>
-<p><strong>SKIP</strong> takes an integer argument which is either the number of lines
-to skip (when reading ASCII files) or the number of bytes to skip (when
-reading native binary files). Not used with netCDF files.</p>
-<p><strong>GEO</strong> indicates that these files are geographic data sets, with
-periodicities in the <em>x</em>-coordinate (longitudes). Alternatively, use <strong>-G</strong>.</p>
-<p><strong>MULTISEG</strong> means each track consists of multiple segments separated by
-a GMT segment header (alternatively, use <strong>-m</strong> when defining the
-system TAG). Not used with netCDF files.</p>
-<p>The column information consists of one line per column in the order the
-columns appear in the data file. For each column you must provide seven
-attributes:</p>
-<p><em>name type NaN NaN-proxy scale offset oformat</em></p>
-<p><em>name</em> is the name of the column variable. It is expected that you will
-use the special names <em>lon</em> (or <em>x</em> if Cartesian) and <em>lat</em> (or <em>y</em>) for
-the two required coordinate columns, and <em>time</em> when optional time data
-are present.</p>
-<p><em>type</em> is always <strong>a</strong> for ASCII representations of numbers, whereas for
-binary files you may choose among <strong>c</strong> for signed 1-byte character
-(-127,+128), <strong>u</strong> for unsigned byte (0-255), <strong>h</strong> for signed 2-byte
-integers (-32768,+32767), <strong>i</strong> for signed 4-byte integers
-(-2,147,483,648,+2,147,483,647), <strong>f</strong> for 4-byte floating points and
-<strong>d</strong> for 8-byte double precision floating points. For netCDF, simply
-use <strong>d</strong> as netCDF will automatically handle type-conversions during reading.</p>
-<p><em>NaN</em> is Y if certain values (e.g, -9999) are to be replaced by NAN, and N otherwise.</p>
-<p><em>NaN-proxy</em> is that special value (e.g., -9999).</p>
-<p><em>scale</em> is used to multiply the data after reading.</p>
-<p><em>offset</em> is used to add to the scaled data.</p>
-<p><em>oformat</em> is a C-style format string used to print values from this column.</p>
-<p>If you give - as the <em>oformat</em> then GMT’s formatting machinery
-will be used instead (i.e., <a class="reference internal" href="../../gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>,
-<a class="reference internal" href="../../gmt.conf.html#format-geo-map"><em>FORMAT_GEO_MAP</em></a>, <a class="reference internal" href="../../gmt.conf.html#format-date-map"><em>FORMAT_DATE_MAP</em></a>,
-<a class="reference internal" href="../../gmt.conf.html#format-clock-map"><em>FORMAT_CLOCK_MAP</em></a>).
-Some file formats already have definition files premade. These include
-mgd77 (for plain ASCII MGD77 data files), mgd77+ (for enhanced MGD77+
-netCDF files), gmt (for old mgg supplement binary files), xy (for plain
-ASCII x, y tables), xyz (same, with one z-column), geo (for plain ASCII
-longitude, latitude files), and geoz (same, with one z-column).</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>If you have a large set of track data files you can organize them using
-the x2sys tools. Here we will outline the steps. Let us assume that your
-track data file format consist of 2 header records with text information
-followed by any number of identically formatted data records with 6
-columns (lat, lon, time, obs1, obs2, obs3) and that files are called
-*.trk. We will call this the “line” format. First, we create the
-line.def file:</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="15%" />
-<col width="10%" />
-<col width="7%" />
-<col width="22%" />
-<col width="12%" />
-<col width="15%" />
-<col width="20%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head" colspan="7"># Define file for the line format</th>
-</tr>
-<tr class="row-even"><th class="head" colspan="3"># SKIP 2</th>
-<th class="head" colspan="4"># Skip 2 header records</th>
-</tr>
-<tr class="row-odd"><th class="head" colspan="3"># GEO</th>
-<th class="head" colspan="4"># Data are geographic</th>
-</tr>
-<tr class="row-even"><th class="head">#name</th>
-<th class="head">type</th>
-<th class="head">NaN</th>
-<th class="head">NaN-proxy</th>
-<th class="head">scale</th>
-<th class="head">offset</th>
-<th class="head">oformat</th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-odd"><td>lat</td>
-<td>a</td>
-<td>N</td>
-<td>0</td>
-<td>1</td>
-<td>0</td>
-<td>%9.5f</td>
-</tr>
-<tr class="row-even"><td>lon</td>
-<td>a</td>
-<td>N</td>
-<td>0</td>
-<td>1</td>
-<td>0</td>
-<td>%10.5f</td>
-</tr>
-<tr class="row-odd"><td>time</td>
-<td>a</td>
-<td>N</td>
-<td>0</td>
-<td>1</td>
-<td>0</td>
-<td>%7.1f</td>
-</tr>
-<tr class="row-even"><td>obs1</td>
-<td>a</td>
-<td>N</td>
-<td>0</td>
-<td>1</td>
-<td>0</td>
-<td>%7.2f</td>
-</tr>
-<tr class="row-odd"><td>obs2</td>
-<td>a</td>
-<td>N</td>
-<td>0</td>
-<td>1</td>
-<td>0</td>
-<td>%7.2f</td>
-</tr>
-<tr class="row-even"><td>obs3</td>
-<td>a</td>
-<td>N</td>
-<td>0</td>
-<td>1</td>
-<td>0</td>
-<td>%7.2f</td>
-</tr>
-</tbody>
-</table>
-<p>Next we create the TAG and the TAG directory with the databases for
-these line track files. Assuming these contain geographic data and that
-we want to keep track of the data distribution at a 1 x 1 degree
-resolution, with distances in km calculated along geodesics and with
-speeds given in knots, we may run</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt x2sys_init LINE -V -G -Dline -Rg -Ce -Ndk -NsN -I1/1 -Etrk
-</pre></div>
-</div>
-</div></blockquote>
-<p>where we have selected LINE to be our x2sys tag. When x2sys tools try to
-read your line data files they will first look in the current directory
-and second look in the file <em>TAG</em>_paths.txt for a list of additional
-directories to examine. Therefore, create such a file (here
-LINE_paths.txt) and stick the full paths to your data directories
-there. All TAG-related files (definition files, tag files, and track
-data bases created) will be expected to be in the directory pointed to
-by <strong>$X2SYS_HOME</strong>/<em>TAG</em> (in our case <strong>$X2SYS_HOME</strong>/LINE). Note that
-the argument to <strong>-D</strong> must contain the full path if the *.def file is
-not in the current directory. <strong>x2sys_init</strong> will copy this file to the
-<strong>$X2SYS_HOME</strong>/<em>TAG</em> directory where all other x2sys tools will expect
-to find it.</p>
-<dl class="docutils">
-<dt><strong>Create tbf file(s):</strong></dt>
-<dd><p class="first">Once the (empty) TAG databases have been initialized we go through a
-two-step process to populate them. First we run <strong>x2sys_binlist</strong>
-on all our track files to create one (or more) multisegment track
-bin-index files (tbf). These contain information on which 1 x 1
-degree bins (or any other blocksize; see <strong>-I</strong>) each track has
-visited and which observations (in your case obs1, obs2, obs3) were
-actually observed (not all tracks may have all three kinds of
-observations everywhere). For instance, if your tracks are listed in
-the file tracks.lis we may run this command:</p>
-<blockquote class="last">
-<div><div class="highlight-python"><div class="highlight"><pre>gmt x2sys_binlist -V -TLINE :tracks.lis > tracks.tbf
-</pre></div>
-</div>
-</div></blockquote>
-</dd>
-<dt><strong>Update index data base:</strong></dt>
-<dd><p class="first">Next, the track bin-index files are fed to <strong>x2sys_put</strong> which will
-insert the information into the TAG databases:</p>
-<blockquote class="last">
-<div><div class="highlight-python"><div class="highlight"><pre>gmt x2sys_put -V -TLINE tracks.tbf
-</pre></div>
-</div>
-</div></blockquote>
-</dd>
-<dt><strong>Search for data:</strong></dt>
-<dd><p class="first">You may now use <strong>x2sys_get</strong> to find all the tracks within a
-certain sub-region, and optionally limit the search to those tracks
-that have a particular combination of observables. E.g., to find all
-the tracks which has both obs1 and obs3 inside the specified region, run</p>
-<blockquote class="last">
-<div><div class="highlight-python"><div class="highlight"><pre>gmt x2sys_get -V -TLINE -R20/40/-40/-20 -Fobs1,obs3 > tracks.tbf
-</pre></div>
-</div>
-</div></blockquote>
-</dd>
-<dt><strong>MGD77[+] or GMT:</strong></dt>
-<dd><p class="first">Definition files already exist for MGD77 files (both standard ASCII
-and enhanced netCDF-based MGD77+ files) and the old *.gmt files
-manipulated by the mgg supplements; for these data sets the <strong>-C</strong>
-and <strong>-N</strong> will default to great circle distance calculation in km
-and speed in m/s. There are also definition files for plain x,y[,z]
-and lon,lat[,z] tracks. To initiate new track databases to be used
-with MGD77 data from NGDC, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt x2sys_init MGD77 -V -Dmgd77 -Emgd77 -Rd -Gd -Nsn -I1/1 -Wt900 -Wd5
-</pre></div>
-</div>
-</div></blockquote>
-<p class="last">where we have chosen a 15 minute (900 sec) or 5 km threshold to
-indicate a data gap and selected knots as the speed; the other steps
-are similar.</p>
-</dd>
-<dt><strong>Binary files:</strong></dt>
-<dd><p class="first">Let us pretend that your line files actually are binary files with a
-128-byte header structure (to be skipped) followed by the data
-records and where <em>lon</em>, <em>lat</em>, <em>time</em> are double precision numbers
-while the three observations are 2-byte integers which must be
-multiplied by 0.1. Finally, the first two observations may be -32768
-which means there is no data available. All that is needed is a
-different line.def file:</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="15%" />
-<col width="10%" />
-<col width="7%" />
-<col width="22%" />
-<col width="12%" />
-<col width="15%" />
-<col width="20%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head" colspan="7"># Define file for the binary line format</th>
-</tr>
-<tr class="row-even"><th class="head" colspan="3"># BINARY</th>
-<th class="head" colspan="4"># File is now binary</th>
-</tr>
-<tr class="row-odd"><th class="head" colspan="3"># SKIP 128</th>
-<th class="head" colspan="4"># Skip 128 bytes</th>
-</tr>
-<tr class="row-even"><th class="head" colspan="3"># GEO</th>
-<th class="head" colspan="4"># Data are geographic</th>
-</tr>
-<tr class="row-odd"><th class="head">#name</th>
-<th class="head">type</th>
-<th class="head">NaN</th>
-<th class="head">NaN-proxy</th>
-<th class="head">scale</th>
-<th class="head">offset</th>
-<th class="head">oformat</th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-even"><td>lon</td>
-<td>d</td>
-<td>N</td>
-<td>0</td>
-<td>1</td>
-<td>0</td>
-<td>%10.5f</td>
-</tr>
-<tr class="row-odd"><td>lat</td>
-<td>d</td>
-<td>N</td>
-<td>0</td>
-<td>1</td>
-<td>0</td>
-<td>%9.5f</td>
-</tr>
-<tr class="row-even"><td>time</td>
-<td>d</td>
-<td>N</td>
-<td>0</td>
-<td>1</td>
-<td>0</td>
-<td>%7.1f</td>
-</tr>
-<tr class="row-odd"><td>obs1</td>
-<td>h</td>
-<td>Y</td>
-<td>-32768</td>
-<td>0.1</td>
-<td>0</td>
-<td>%6.1f</td>
-</tr>
-<tr class="row-even"><td>obs2</td>
-<td>h</td>
-<td>Y</td>
-<td>-32768</td>
-<td>0.1</td>
-<td>0</td>
-<td>%6.1f</td>
-</tr>
-<tr class="row-odd"><td>obs3</td>
-<td>h</td>
-<td>N</td>
-<td>0</td>
-<td>0.1</td>
-<td>0</td>
-<td>%6.1f</td>
-</tr>
-</tbody>
-</table>
-<p class="last">The rest of the steps are identical.</p>
-</dd>
-<dt><strong>COARDS 1-D netCDF files:</strong></dt>
-<dd><p class="first">Finally, suppose that your line files actually are netCDF files that
-conform to the COARDS convention, with data columns named <em>lon</em>,
-<em>lat</em>, <em>time</em>, <em>obs1</em>, <em>obs2</em>, and <em>obs3</em>. All that is needed is a
-different line.def file:</p>
-<table border="1" class="docutils">
-<colgroup>
-<col width="15%" />
-<col width="10%" />
-<col width="7%" />
-<col width="22%" />
-<col width="12%" />
-<col width="15%" />
-<col width="20%" />
-</colgroup>
-<thead valign="bottom">
-<tr class="row-odd"><th class="head" colspan="7"># Define file for the netCDF COARDS line format</th>
-</tr>
-<tr class="row-even"><th class="head" colspan="3"># NETCDF</th>
-<th class="head" colspan="4"># File is now netCDF</th>
-</tr>
-<tr class="row-odd"><th class="head" colspan="3"># GEO</th>
-<th class="head" colspan="4"># Data are geographic</th>
-</tr>
-<tr class="row-even"><th class="head">#name</th>
-<th class="head">type</th>
-<th class="head">NaN</th>
-<th class="head">NaN-proxy</th>
-<th class="head">scale</th>
-<th class="head">offset</th>
-<th class="head">oformat</th>
-</tr>
-</thead>
-<tbody valign="top">
-<tr class="row-odd"><td>lon</td>
-<td>d</td>
-<td>N</td>
-<td>0</td>
-<td>1</td>
-<td>0</td>
-<td>%10.5f</td>
-</tr>
-<tr class="row-even"><td>lat</td>
-<td>d</td>
-<td>N</td>
-<td>0</td>
-<td>1</td>
-<td>0</td>
-<td>%9.5f</td>
-</tr>
-<tr class="row-odd"><td>time</td>
-<td>d</td>
-<td>N</td>
-<td>0</td>
-<td>1</td>
-<td>0</td>
-<td>%7.1f</td>
-</tr>
-<tr class="row-even"><td>obs1</td>
-<td>d</td>
-<td>N</td>
-<td>0</td>
-<td>1</td>
-<td>0</td>
-<td>%6.1f</td>
-</tr>
-<tr class="row-odd"><td>obs2</td>
-<td>d</td>
-<td>N</td>
-<td>0</td>
-<td>1</td>
-<td>0</td>
-<td>%6.1f</td>
-</tr>
-<tr class="row-even"><td>obs3</td>
-<td>d</td>
-<td>N</td>
-<td>0</td>
-<td>1</td>
-<td>0</td>
-<td>%6.1f</td>
-</tr>
-</tbody>
-</table>
-<p class="last">Note we use no scaling or NAN proxies since those issues are usually
-handled internally in the netCDF format description.</p>
-</dd>
-</dl>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="x2sys_binlist.html"><em>x2sys_binlist</em></a>,
-<a class="reference internal" href="x2sys_datalist.html"><em>x2sys_datalist</em></a>,
-<a class="reference internal" href="x2sys_get.html"><em>x2sys_get</em></a>,
-<a class="reference internal" href="x2sys_list.html"><em>x2sys_list</em></a>,
-<a class="reference internal" href="x2sys_put.html"><em>x2sys_put</em></a>,
-<a class="reference internal" href="x2sys_report.html"><em>x2sys_report</em></a>,
-<a class="reference internal" href="x2sys_solve.html"><em>x2sys_solve</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">x2sys_init</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#definition-files">Definition Files</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="x2sys_get.html"
- title="previous chapter">x2sys_get</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="x2sys_list.html"
- title="next chapter">x2sys_list</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/x2sys/x2sys_init.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="x2sys_list.html" title="x2sys_list"
- >next</a> </li>
- <li class="right" >
- <a href="x2sys_get.html" title="x2sys_get"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_X2SYS.html" >X2SYS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/x2sys/x2sys_list.html b/doc_release/html/supplements/x2sys/x2sys_list.html
deleted file mode 100644
index 1a74988..0000000
--- a/doc_release/html/supplements/x2sys/x2sys_list.html
+++ /dev/null
@@ -1,331 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>x2sys_list — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="X2SYS" href="../../SUP_X2SYS.html" />
- <link rel="next" title="x2sys_merge" href="x2sys_merge.html" />
- <link rel="prev" title="x2sys_init" href="x2sys_init.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="x2sys_merge.html" title="x2sys_merge"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="x2sys_init.html" title="x2sys_init"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_X2SYS.html" accesskey="U">X2SYS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="x2sys-list">
-<span id="index-0"></span><h1>x2sys_list<a class="headerlink" href="#x2sys-list" title="Permalink to this headline">¶</a></h1>
-<p>x2sys_list - Extract subset from crossover data base</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>x2sys_list</strong> <strong>-C</strong><em>column</em> <strong>-T</strong><em>TAG</em> [ <em>coedbase.txt</em> ]
-[ <strong>-A</strong><em>asymm_max</em> ] [ <strong>-E</strong> ] [ <strong>-F</strong><em>acdhiInNtTvwxyz</em> ]
-[ <strong>-I</strong>[<em>list</em>] ] [ <strong>-L</strong>[<em>corrtable</em>] ] [ <strong>-N</strong><em>nx_min</em> ]
-[ <strong>-Qe</strong>|<strong>i</strong> ]
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ]
-[ <strong>-S</strong><em>track</em> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W</strong>[<em>list</em>] ]
-[ <strong>-bo</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>x2sys_list</strong> will read the crossover ASCII data base <em>coedbase.txt</em>
-(or <em>stdin</em>) and extract a subset of the crossovers based on the other
-arguments. The output may be ASCII or binary.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-C</strong><em>column</em></dt>
-<dd>Specify which data column you want to process. Crossovers related to
-this column name must be present in the crossover data base.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-T</strong><em>TAG</em></dt>
-<dd>Specify the x2sys <em>TAG</em> which tracks the attributes of this data type.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>coedbase.txt</em></dt>
-<dd>The name of the input ASCII crossover error data base as produced by
-<strong>x2sys_cross</strong>. If not given we read standard input instead.</dd>
-<dt><strong>-A</strong><em>asymm_max</em></dt>
-<dd>Specifies maximum asymmetry in the distribution of crossovers
-relative to the mid point in time (or distance, if not time is
-available). Asymmetry is computed as (n_right - n_left)/(n_right
-+ n_left), referring the the number of crossovers that falls in the
-left or right half of the range. Symmetric distributions will have
-values close to zero. If specified, we exclude tracks whose
-asymmetry exceeds the specify cutoff in absolute value [1, i.e.,
-include all].</dd>
-<dt><strong>-E</strong></dt>
-<dd>Enhance ASCII output by writing GMT segment headers with name of the
-two tracks and their total number of cross-overs [no segment
-headers].</dd>
-<dt><strong>-F</strong><em>acdhiInNtTvwxyz</em></dt>
-<dd>Specify your desired output using any combination of
-<em>acdhiInNtTvwxyz</em>, in any order. Do not use space between the
-letters, and note your selection is case-sensitive. The output will
-be ASCII (or binary, <strong>-bo</strong>) columns of
-values. Description of codes: <strong>a</strong> is the angle (< 90) defined by
-the crossing tracks, <strong>c</strong> is crossover value of chosen observation
-(see <strong>-C</strong>), <strong>d</strong> is distance along track, <strong>h</strong> is heading along
-track, <strong>i</strong> is the signed time interval between the visit at the
-crossover of the two tracks involved, <strong>I</strong> is same as <strong>i</strong> but is
-unsigned, <strong>n</strong> is the names of the two tracks, <strong>N</strong> is the id
-numbers of the two tracks, <strong>t</strong> is time along track in
-<em>date</em><strong>T</strong><em>clock</em> format (NaN if not available), <strong>T</strong> is
-elapsed time since start of track along track (NaN if not
-available), <strong>v</strong> is speed along track, <strong>w</strong> is the composite
-weight, <strong>x</strong> is <em>x</em>-coordinate (or longitude), <strong>y</strong> is
-<em>y</em>-coordinate (or latitude), and <strong>z</strong> is observed value (see
-<strong>-C</strong>) along track. If <strong>-S</strong> is not specified then
-<strong>d</strong>,<strong>h</strong>,<strong>n</strong>,<strong>N</strong>,<strong>t</strong>,<strong>T</strong>,<strong>v</strong> results in two
-output columns each: first for track one and next for track two (in
-lexical order of track names); otherwise, they refer to the
-specified track only (except for <strong>n</strong>,<strong>N</strong> which then refers to
-the other track). The sign convention for <strong>c</strong>,<strong>i</strong> is track one
-minus track two (lexically sorted). Time intervals will be returned
-according to the <strong>TIME_UNIT</strong> GMT defaults setting.</dd>
-<dt><strong>-I</strong>[<em>list</em>]</dt>
-<dd>Name of ASCII file with a list of track names (one per record) that
-should be excluded from consideration [Default includes all tracks].</dd>
-<dt><strong>-L</strong>[<em>corrtable</em>]</dt>
-<dd>Apply optimal corrections to the chosen observable. Append the
-correction table to use [Default uses the correction table
-<em>TAG</em>_corrections.txt which is expected to reside in the
-<strong>$X2SYS_HOME</strong>/<em>TAG</em> directory]. For the format of this file, see
-<strong>x2sys_solve</strong>.</dd>
-<dt><strong>-N</strong><em>nx_min</em></dt>
-<dd>Only report data from pairs that generated at least <em>nx_min</em>
-crossovers between them [use all pairs].</dd>
-<dt><strong>-Qe</strong>|<strong>i</strong></dt>
-<dd>Append <strong>e</strong> for external crossovers or <strong>i</strong> for internal
-crossovers only [Default is all crossovers].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]</dt>
-<dd><em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> specify the region of interest,
-and you may specify them in decimal degrees or in
-[+-]dd:mm[:ss.xxx][W|E|S|N] format. Append <strong>r</strong> if lower left
-and upper right map coordinates are given instead of w/e/s/n. The
-two shorthands <strong>-Rg</strong> and <strong>-Rd</strong> stand for global domain (0/360
-and -180/+180 in longitude respectively, with -90/+90 in latitude).
-Alternatively, specify the name of an existing grid file and the
-<strong>-R</strong> settings (and grid spacing, if applicable) are copied from
-the grid. Using <strong>-R</strong><em>unit</em> expects projected (Cartesian)
-coordinates compatible with chosen <strong>-J</strong> and we inversely project
-to determine actual rectangular geographic region.
-For perspective view (<strong>-p</strong>), optionally append /<em>zmin</em>/<em>zmax</em>.
-In case of perspective view (<strong>-p</strong>), a z-range (<em>zmin</em>, <em>zmax</em>)
-can be appended to indicate the third dimension. This needs to be
-done only when using the <strong>-Jz</strong> option, not when using only the
-<strong>-p</strong> option. In the latter case a perspective view of the plane is
-plotted, with no third dimension. For Cartesian
-data just give <em>xmin/xmax/ymin/ymax</em>. This option bases the
-statistics on those COE that fall inside the specified domain.</dd>
-<dt><strong>-S</strong><em>track</em></dt>
-<dd>Name of a single track. If given we restrict output to those
-crossovers involving this track [Default output is crossovers
-involving any track pair].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong>[<em>list</em>]</dt>
-<dd>Name of ASCII file with a list of track names and their relative
-weights (one track per record) that should be used to calculate the
-composite crossover weight (output code <strong>w</strong> above). [Default sets
-weights to 1].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="../../gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To find all the magnetic crossovers associated with the tag MGD77 from
-the file COE_data.txt, restricted to occupy a certain region in the
-south Pacific, and return location, time, and crossover value, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt x2sys_list COE_data.txt -V -TMGD77 -R180/240/-60/-30 -Cmag -Fxytz > mag_coe.txt
-</pre></div>
-</div>
-</div></blockquote>
-<p>To find all the faa crossovers globally that involves track 12345678 and
-output time since start of the year, using a binary double precision
-format, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt x2sys_list COE_data.txt -V -TMGD77 -Cfaa -S12345678 -FTz -bod > faa_coe.b
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="x2sys_binlist.html"><em>x2sys_binlist</em></a>,
-<a class="reference internal" href="x2sys_cross.html"><em>x2sys_cross</em></a>,
-<a class="reference internal" href="x2sys_datalist.html"><em>x2sys_datalist</em></a>,
-<a class="reference internal" href="x2sys_get.html"><em>x2sys_get</em></a>,
-<a class="reference internal" href="x2sys_init.html"><em>x2sys_init</em></a>,
-<a class="reference internal" href="x2sys_put.html"><em>x2sys_put</em></a>,
-<a class="reference internal" href="x2sys_report.html"><em>x2sys_report</em></a>,
-<a class="reference internal" href="x2sys_solve.html"><em>x2sys_solve</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">x2sys_list</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="x2sys_init.html"
- title="previous chapter">x2sys_init</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="x2sys_merge.html"
- title="next chapter">x2sys_merge</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/x2sys/x2sys_list.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="x2sys_merge.html" title="x2sys_merge"
- >next</a> </li>
- <li class="right" >
- <a href="x2sys_init.html" title="x2sys_init"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_X2SYS.html" >X2SYS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/x2sys/x2sys_merge.html b/doc_release/html/supplements/x2sys/x2sys_merge.html
deleted file mode 100644
index c689b6f..0000000
--- a/doc_release/html/supplements/x2sys/x2sys_merge.html
+++ /dev/null
@@ -1,207 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>x2sys_merge — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="X2SYS" href="../../SUP_X2SYS.html" />
- <link rel="next" title="x2sys_put" href="x2sys_put.html" />
- <link rel="prev" title="x2sys_list" href="x2sys_list.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="x2sys_put.html" title="x2sys_put"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="x2sys_list.html" title="x2sys_list"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_X2SYS.html" accesskey="U">X2SYS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="x2sys-merge">
-<span id="index-0"></span><h1>x2sys_merge<a class="headerlink" href="#x2sys-merge" title="Permalink to this headline">¶</a></h1>
-<p>x2sys_merge - Merge an updated COEs table (smaller) into the main table (bigger)</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>x2sys_merge</strong> <strong>-A</strong><em>main_COElist.d</em> <strong>-M</strong><em>new_COElist.d</em></p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>x2sys_merge</strong> will read two crossovers data base and output the
-contents of the main one updated with the COEs in the second one. The
-second file should only contain updated COEs relatively to the first
-one. That is, it MUST NOT contain any new two tracks intersections (This
-point is NOT checked in the code). This program is useful when, for any
-good reason like file editing NAV correction or whatever, one had to
-recompute only the COEs between the edited files and the rest of the
-database.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong><em>main_COElist.d</em></dt>
-<dd>Specify the file <em>main_COElist.d</em> with the main crossover error
-data base.</dd>
-<dt><strong>-M</strong><em>new_COElist.d</em></dt>
-<dd>Specify the file <em>new_COElist.d</em> with the newly computed crossover
-error data base.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To update the main COE_data.txt with the new COEs estimations saved in
-the smaller COE_fresh.txt, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt x2sys_merge -ACOE_data.txt -MCOE_fresh.txt > COE_updated.txt
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="x2sys_binlist.html"><em>x2sys_binlist</em></a>,
-<a class="reference internal" href="x2sys_cross.html"><em>x2sys_cross</em></a>,
-<a class="reference internal" href="x2sys_datalist.html"><em>x2sys_datalist</em></a>,
-<a class="reference internal" href="x2sys_get.html"><em>x2sys_get</em></a>,
-<a class="reference internal" href="x2sys_init.html"><em>x2sys_init</em></a>,
-<a class="reference internal" href="x2sys_list.html"><em>x2sys_list</em></a>,
-<a class="reference internal" href="x2sys_put.html"><em>x2sys_put</em></a>,
-<a class="reference internal" href="x2sys_report.html"><em>x2sys_report</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">x2sys_merge</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="x2sys_list.html"
- title="previous chapter">x2sys_list</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="x2sys_put.html"
- title="next chapter">x2sys_put</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/x2sys/x2sys_merge.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="x2sys_put.html" title="x2sys_put"
- >next</a> </li>
- <li class="right" >
- <a href="x2sys_list.html" title="x2sys_list"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_X2SYS.html" >X2SYS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/x2sys/x2sys_put.html b/doc_release/html/supplements/x2sys/x2sys_put.html
deleted file mode 100644
index 5d6485c..0000000
--- a/doc_release/html/supplements/x2sys/x2sys_put.html
+++ /dev/null
@@ -1,242 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>x2sys_put — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="X2SYS" href="../../SUP_X2SYS.html" />
- <link rel="next" title="x2sys_report" href="x2sys_report.html" />
- <link rel="prev" title="x2sys_merge" href="x2sys_merge.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="x2sys_report.html" title="x2sys_report"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="x2sys_merge.html" title="x2sys_merge"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_X2SYS.html" accesskey="U">X2SYS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="x2sys-put">
-<span id="index-0"></span><h1>x2sys_put<a class="headerlink" href="#x2sys-put" title="Permalink to this headline">¶</a></h1>
-<p>x2sys_put - Update track index database from track bin file</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>x2sys_put</strong> [ <em>info.tbf</em> ] <strong>-T</strong><em>TAG</em> [ <strong>-D</strong> ] [ <strong>-F</strong> ]
-[ <strong>-V</strong>[<em>level</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>x2sys_put</strong> accepts a track bin-index file created by
-<strong>x2sys_binlist</strong> and adds this information about the data tracks to
-the relevant data base. You may chose to overwrite existing data with
-new information for older tracks (<strong>-F</strong>) and even completely remove
-information for certain tracks (<strong>-D</strong>). The x2sys <em>TAG</em> must match the
-tag encoded in the <em>info.tbf</em> file. To inquire about tracks in the data
-base, use <strong>x2sys_get</strong>.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>info.tbf</em></dt>
-<dd>Name of a single track bin file. If not given, <em>stdin</em> will be read.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-T</strong><em>TAG</em></dt>
-<dd>Specify the x2sys <em>TAG</em> which tracks the attributes of this data type.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-D</strong></dt>
-<dd>Delete all tracks found in the track bin file [Default will try to
-add them as new track entries].</dd>
-<dt><strong>-F</strong></dt>
-<dd>Replace any existing database information for these tracks with the
-new information in the track bin file [Default refuses to process
-tracks already in the database].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To add the information stored in the track bin-index file latest.tbf to
-the track data bases associated with the tag MGD77, and replace any
-exiting information for these tracks, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt x2sys_put latest.tbf -F -V -TMGD77
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="x2sys-databases">
-<h2>X2sys Databases<a class="headerlink" href="#x2sys-databases" title="Permalink to this headline">¶</a></h2>
-<p>The <strong>x2sys_put</strong> utility adds new information to the x2sys data bases.
-These consists of two files: The first file contains a listing of all
-the tracks that have been added to the system; it is named
-<em>TAG</em>_tracks.d and is in ASCII format. The second file is named
-<em>TAG</em>_index.b and is in native binary format. It contains information
-on which tracks cross each of the bins, and what data sets were observed
-while crossing the bin. The bins are defined by the <strong>-R</strong> and <strong>-I</strong>
-options passed to <strong>x2sys_init</strong> when the <em>TAG</em> was first initiated.
-Both data base files are stored in the <strong>$X2SYS_HOME</strong>/<em>TAG</em> directory.
-Do not attempt to edit these files by hand.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="x2sys_binlist.html"><em>x2sys_binlist</em></a>, <a class="reference internal" href="x2sys_get.html"><em>x2sys_get</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">x2sys_put</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#x2sys-databases">X2sys Databases</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="x2sys_merge.html"
- title="previous chapter">x2sys_merge</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="x2sys_report.html"
- title="next chapter">x2sys_report</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/x2sys/x2sys_put.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="x2sys_report.html" title="x2sys_report"
- >next</a> </li>
- <li class="right" >
- <a href="x2sys_merge.html" title="x2sys_merge"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_X2SYS.html" >X2SYS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/x2sys/x2sys_report.html b/doc_release/html/supplements/x2sys/x2sys_report.html
deleted file mode 100644
index b71f1fc..0000000
--- a/doc_release/html/supplements/x2sys/x2sys_report.html
+++ /dev/null
@@ -1,295 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>x2sys_report — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="X2SYS" href="../../SUP_X2SYS.html" />
- <link rel="next" title="x2sys_solve" href="x2sys_solve.html" />
- <link rel="prev" title="x2sys_put" href="x2sys_put.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="x2sys_solve.html" title="x2sys_solve"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="x2sys_put.html" title="x2sys_put"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_X2SYS.html" accesskey="U">X2SYS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="x2sys-report">
-<span id="index-0"></span><h1>x2sys_report<a class="headerlink" href="#x2sys-report" title="Permalink to this headline">¶</a></h1>
-<p>x2sys_report - Report statistics from crossover data base</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>x2sys_report</strong> <strong>-C</strong><em>column</em> <strong>-T</strong><em>TAG</em> [ <em>coedbase.txt</em> ]
-[ <strong>-A</strong> ] [ <strong>-I</strong>[<em>list</em>] ] [ <strong>-L</strong>[<em>corrtable</em>] ]
-[ <strong>-N</strong><em>nx_min</em> ] [ <strong>-Qe</strong>|<strong>i</strong> ]
-[ [ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ]
-[ <strong>-S</strong><em>track</em> ]
-[ <strong>-V</strong>[<em>level</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>x2sys_report</strong> will read the input crossover ASCII data base
-<em>coedbase.txt</em> (or <em>stdin</em>) and report on the statistics of crossovers
-(<em>n</em>, <em>mean</em>, <em>stdev</em>, <em>rms</em>, <em>weight</em>) for each track. Options are
-available to let you exclude tracks and limit the output.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>coedbase.txt</em></dt>
-<dd>The name of the input ASCII crossover error data base as produced by
-<strong>x2sys_cross</strong>. If not given we read standard input instead.</dd>
-<dt><strong>-C</strong><em>column</em></dt>
-<dd>Specify which data column you want to process. Crossovers related to
-this column name must be present in the crossover data base.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-T</strong><em>TAG</em></dt>
-<dd>Specify the x2sys <em>TAG</em> which tracks the attributes of this data type.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-A</strong></dt>
-<dd>Eliminate COEs by distributing the COE between the two tracks in
-proportion to track weight and producing (dist, adjustment) spline
-knots files for each track (for the selected <em>column</em>). Such
-adjustments may be used by <strong>x2sys_datalist</strong>. The adjustment files
-are called <em>track.column</em>.adj and are placed in the
-<strong>$X2SYS_HOME</strong>/<em>TAG</em> directory. For background information on how
-these adjustments are designed, see <em>Mittal</em> [1984].</dd>
-<dt><strong>-I</strong>[<em>list</em>]</dt>
-<dd>Name of ASCII file with a list of track names (one per record) that
-should be excluded from consideration [Default includes all tracks].</dd>
-<dt><strong>-L</strong>[<em>corrtable</em>]</dt>
-<dd>Apply optimal corrections to the chosen observable. Append the
-correction table to use [Default uses the correction table
-<em>TAG</em>_corrections.txt which is expected to reside in the
-<strong>$X2SYS_HOME</strong>/<em>TAG</em> directory]. For the format of this file, see
-<strong>x2sys_solve</strong>.</dd>
-<dt><strong>-N</strong><em>nx_min</em></dt>
-<dd>Only report data from tracks involved in at least <em>nx_min</em>
-crossovers [all tracks].</dd>
-<dt><strong>-Qe</strong>|<strong>i</strong></dt>
-<dd>Append <strong>e</strong> for external crossovers or <strong>i</strong> for internal
-crossovers only [Default is external].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>west</em>/<em>east</em>/<em>south</em>/<em>north</em>[/<em>zmin</em>/<em>zmax</em>][<strong>r</strong>]</dt>
-<dd><em>west</em>, <em>east</em>, <em>south</em>, and <em>north</em> specify the region of interest,
-and you may specify them in decimal degrees or in
-[+-]dd:mm[:ss.xxx][W|E|S|N] format. Append <strong>r</strong> if lower left
-and upper right map coordinates are given instead of w/e/s/n. The
-two shorthands <strong>-Rg</strong> and <strong>-Rd</strong> stand for global domain (0/360
-and -180/+180 in longitude respectively, with -90/+90 in latitude).
-Alternatively, specify the name of an existing grid file and the
-<strong>-R</strong> settings (and grid spacing, if applicable) are copied from
-the grid. Using <strong>-R</strong><em>unit</em> expects projected (Cartesian)
-coordinates compatible with chosen <strong>-J</strong> and we inversely project
-to determine actual rectangular geographic region.
-For perspective view (<strong>-p</strong>), optionally append /<em>zmin</em>/<em>zmax</em>.
-In case of perspective view (<strong>-p</strong>), a z-range (<em>zmin</em>, <em>zmax</em>)
-can be appended to indicate the third dimension. This needs to be
-done only when using the <strong>-Jz</strong> option, not when using only the
-<strong>-p</strong> option. In the latter case a perspective view of the plane is
-plotted, with no third dimension. For Cartesian
-data just give <em>xmin/xmax/ymin/ymax</em>. This option bases the
-statistics on those COE that fall inside the specified domain.</dd>
-<dt><strong>-S</strong><em>track</em></dt>
-<dd>Name of a single track. If given we restrict output to those
-crossovers involving this track [Default output is crossovers
-involving any track pair].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To report statistics of all the external magnetic crossovers associated
-with the tag MGD77 from the file COE_data.txt, restricted to occupy a
-certain region in the south Pacific, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt x2sys_report COE_data.txt -V -TMGD77 -R180/240/-60/-30 -Cmag >
- mag_report.txt
-</pre></div>
-</div>
-</div></blockquote>
-<p>To report on the faa crossovers globally that involves track 12345678, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt x2sys_report COE_data.txt -V -TMGD77 -Cfaa -S2345678 > faa_report.txt
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>Mittal, P. K. (1984), Algorithm for error adjustment of potential field
-data along a survey network, <em>Geophysics</em>, <strong>49</strong>(4), 467-469.</p>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="x2sys_binlist.html"><em>x2sys_binlist</em></a>
-<a class="reference internal" href="x2sys_cross.html"><em>x2sys_cross</em></a>
-<a class="reference internal" href="x2sys_datalist.html"><em>x2sys_datalist</em></a>
-<a class="reference internal" href="x2sys_get.html"><em>x2sys_get</em></a>
-<a class="reference internal" href="x2sys_init.html"><em>x2sys_init</em></a>
-<a class="reference internal" href="x2sys_list.html"><em>x2sys_list</em></a>
-<a class="reference internal" href="x2sys_put.html"><em>x2sys_put</em></a>
-<a class="reference internal" href="x2sys_solve.html"><em>x2sys_solve</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">x2sys_report</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="x2sys_put.html"
- title="previous chapter">x2sys_put</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="x2sys_solve.html"
- title="next chapter">x2sys_solve</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/x2sys/x2sys_report.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="x2sys_solve.html" title="x2sys_solve"
- >next</a> </li>
- <li class="right" >
- <a href="x2sys_put.html" title="x2sys_put"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_X2SYS.html" >X2SYS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/supplements/x2sys/x2sys_solve.html b/doc_release/html/supplements/x2sys/x2sys_solve.html
deleted file mode 100644
index dd9106b..0000000
--- a/doc_release/html/supplements/x2sys/x2sys_solve.html
+++ /dev/null
@@ -1,304 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>x2sys_solve — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="../../_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: '../../',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="../../_static/jquery.js"></script>
- <script type="text/javascript" src="../../_static/underscore.js"></script>
- <script type="text/javascript" src="../../_static/doctools.js"></script>
- <script type="text/javascript" src="../../../../_static/searchtools.js"></script>
- <script type="text/javascript" src="../../../../_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="../../index.html" />
- <link rel="up" title="X2SYS" href="../../SUP_X2SYS.html" />
- <link rel="next" title="The GMT historical collection" href="../../Gallery.html" />
- <link rel="prev" title="x2sys_report" href="x2sys_report.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="../../Gallery.html" title="The GMT historical collection"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="x2sys_report.html" title="x2sys_report"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_X2SYS.html" accesskey="U">X2SYS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="x2sys-solve">
-<span id="index-0"></span><h1>x2sys_solve<a class="headerlink" href="#x2sys-solve" title="Permalink to this headline">¶</a></h1>
-<p>x2sys_solve - Determine least-squares systematic correction from crossovers</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>x2sys_solve</strong> <strong>-C</strong><em>column</em> <strong>-T</strong><em>TAG</em> <strong>-E</strong><em>mode</em>
-[ <em>COE_list.d</em> ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-W[u]</strong> ]
-[ <strong>-bi</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>x2sys_solve</strong> will use the supplied crossover information to solve
-for systematic corrections that can then be applied per track to improve
-data quality. Several systematic corrections can be solved for using a
-least-squares approach. Note: Only one data column can be processed at
-the time.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>COE_list.d</em></dt>
-<dd>Name of file with the required crossover columns as produced by
-<strong>x2sys_list</strong>. NOTE: If <strong>-bi</strong> is used
-then the first two columns are expected to hold the integer track
-IDs; otherwise we expect those columns to hold the text string names
-of the two tracks. If no file is given we will read from <em>stdin</em>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-T</strong><em>TAG</em></dt>
-<dd>Specify the x2sys <em>TAG</em> which tracks the attributes of this data type.</dd>
-<dt><strong>-C</strong><em>column</em></dt>
-<dd>Specify which data column you want to process. Needed for proper
-formatting of the output correction table and must match the same
-option used in <strong>x2sys_list</strong> when preparing the input data.</dd>
-<dt><strong>-E</strong><em>mode</em></dt>
-<dd><p class="first">The correction type you wish to model. Choose among the following
-functions f(<em>p</em>) , where <em>p</em> are the <em>m</em>
-parameters per track that we will fit simultaneously using a least
-squares approach:</p>
-<p><strong>c</strong> will fit f(<em>p</em>) = <em>a</em> (a constant offset);
-records must contain cruise ID1, ID2, COE.</p>
-<p><strong>d</strong> will fit f(<em>p</em>) = <em>a</em> + <em>b</em> * <em>d</em> (linear
-drift; <em>d</em> is distance; records must contain cruise ID1, ID2, d1,
-d2, COE.</p>
-<p><strong>g</strong> will fit f(<em>p</em>) = <em>a</em> + <em>b</em> sin(y)^2
-(1980-1930 gravity correction); records must contain cruise ID1,
-ID2, latitude y, COE.</p>
-<p><strong>h</strong> will fit f(<em>p</em>) = <em>a</em> + <em>b</em> cos(H) + <em>c</em>
-cos(2H) + <em>d</em> sin(H) + <em>e</em> sin(2H)
-(magnetic heading correction); records must contain cruise ID1, ID2,
-heading H, COE.</p>
-<p><strong>s</strong> will fit f(<em>p</em>) = <em>a</em> * z (a unit scale
-correction); records must contain cruise ID1, ID2, z1, z2.</p>
-<p class="last"><strong>t</strong> will fit f(<em>p</em>) = <em>a</em> + <em>b</em> * (<em>t - t0</em>)
-(linear drift; <em>t0</em> is the start time of the track); records must
-contain cruise ID1, ID2, t1-t0, t2-t0, COE.</p>
-</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="../../gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong></dt>
-<dd>Means that each input records has an extra column with the composite
-weight for each crossover record. These are used to obtain a
-weighted least squares solution [no weights]. Append <strong>u</strong> to report
-unweighted mean/std [Default, report weighted stats].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="../../gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="notes">
-<h2>Notes<a class="headerlink" href="#notes" title="Permalink to this headline">¶</a></h2>
-<p>Most of the model corrections in <strong>-E</strong> involve a constant offset.
-Because crossovers are differences between values, any absolute level
-will cancel out and hence the constant offsets we obtain are relative
-to an undetermined absolute level. To obtain a solvable solution we
-add the constraint that the sum of all constant offsets equal zero.
-If the tracks form clusters in which no tracks from one cluster cross
-any track from another cluster then these are two independent data
-sets and require they own constraint equation for their offsets. We
-determine the number of clusters and automatically add the required
-constraint equations. If you need a particular reference track to have
-a particular offset (e.g., 0) then you can subtract the offset you
-found from every track correction and add in the desired offset.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To fit a simple bias offset to faa for all tracks under the MGD77 tag, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt x2sys_list COE_data.txt -V -TMGD77 -Cfaa -Fnc > faa_coe.txt
-gmt x2sys_solve faa_coe.txt -V -TMGD77 -Cfaa -Ec > coe_table.txt
-</pre></div>
-</div>
-</div></blockquote>
-<p>To fit a faa linear drift with time instead, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt x2sys_list COE_data.txt -V -TMGD77 -Cfaa -FnTc > faa_coe.txt
-gmt x2sys_solve faa_coe.txt -V -TMGD77 -Cfaa -Et > coe_table.txt
-</pre></div>
-</div>
-</div></blockquote>
-<p>To estimate heading corrections based on magnetic crossovers associated
-with the tag MGD77 from the file COE_data.txt, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt x2sys_list COE_data.txt -V -TMGD77 -Cmag -Fnhc > mag_coe.txt
-gmt x2sys_solve mag_coe.txt -V -TMGD77 -Cmag -Eh > coe_table.txt
-</pre></div>
-</div>
-</div></blockquote>
-<p>To estimate unit scale corrections based on bathymetry crossovers, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt x2sys_list COE_data.txt -V -TMGD77 -Cdepth -Fnz > depth_coe.txt
-gmt x2sys_solve depth_coe.txt -V -TMGD77 -Cdepth -Es > coe_table.txt
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="x2sys_binlist.html"><em>x2sys_binlist</em></a>,
-<a class="reference internal" href="x2sys_cross.html"><em>x2sys_cross</em></a>,
-<a class="reference internal" href="x2sys_datalist.html"><em>x2sys_datalist</em></a>,
-<a class="reference internal" href="x2sys_get.html"><em>x2sys_get</em></a>,
-<a class="reference internal" href="x2sys_init.html"><em>x2sys_init</em></a>,
-<a class="reference internal" href="x2sys_list.html"><em>x2sys_list</em></a>,
-<a class="reference internal" href="x2sys_put.html"><em>x2sys_put</em></a>,
-<a class="reference internal" href="x2sys_report.html"><em>x2sys_report</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="../../index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">x2sys_solve</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#notes">Notes</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="x2sys_report.html"
- title="previous chapter">x2sys_report</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="../../Gallery.html"
- title="next chapter">The GMT historical collection</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="../../_sources/supplements/x2sys/x2sys_solve.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="../../genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="../../Gallery.html" title="The GMT historical collection"
- >next</a> </li>
- <li class="right" >
- <a href="x2sys_report.html" title="x2sys_report"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="../../index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="../../SUP_X2SYS.html" >X2SYS</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/surface.html b/doc_release/html/surface.html
deleted file mode 100644
index 0c20681..0000000
--- a/doc_release/html/surface.html
+++ /dev/null
@@ -1,398 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>surface — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="S" href="S.html" />
- <link rel="next" title="T" href="T.html" />
- <link rel="prev" title="splitxyz" href="splitxyz.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="T.html" title="T"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="splitxyz.html" title="splitxyz"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="S.html" accesskey="U">S</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="surface">
-<span id="index-0"></span><h1>surface<a class="headerlink" href="#surface" title="Permalink to this headline">¶</a></h1>
-<p>surface - Grid table data using adjustable tension continuous curvature splines</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>surface</strong> [ <em>table</em> ] <strong>-G</strong><em>outputfile.nc</em>
-<strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]
-<strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>]
-[ <strong>-A</strong><em>aspect_ratio</em> ] [ <strong>-C</strong><em>convergence_limit</em> ]
-[ <strong>-Ll</strong><em>lower</em> ] [ <strong>-Lu</strong><em>upper</em> ] [ <strong>-N</strong><em>max_iterations</em> ]
-[ <strong>-Q</strong> ] [ <strong>-S</strong><em>search_radius</em>[<strong>m</strong>|<strong>s</strong>] ]
-[ <strong>-T</strong>[<strong>i</strong>|<strong>b</strong>] ]<em>tension_factor</em> [ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-Z</strong><em>over-relaxation_factor</em> ]
-[ <strong>-a</strong><em>col</em>=<em>name</em>[<em>...</em>] ]
-[ <strong>-bi</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>surface</strong> reads randomly-spaced (x,y,z) triples from standard input
-[or <em>table</em>] and produces a binary grid file of gridded values z(x,y) by
-solving:</p>
-<blockquote>
-<div>(1 - T) * L (L (z)) + T * L (z) = 0</div></blockquote>
-<p>where T is a tension factor between 0 and 1, and L indicates the
-Laplacian operator. T = 0 gives the “minimum curvature” solution which
-is equivalent to SuperMISP and the ISM packages. Minimum curvature can
-cause undesired oscillations and false local maxima or minima (See Smith
-and Wessel, 1990), and you may wish to use T > 0 to suppress these
-effects. Experience suggests T ~ 0.25 usually looks good for potential
-field data and T should be larger (T ~ 0.35) for steep topography data.
-T = 1 gives a harmonic surface (no maxima or minima are possible except
-at control data points). It is recommended that the user pre-process the
-data with <strong>blockmean</strong>, <strong>blockmedian</strong>, or <strong>blockmode</strong> to avoid
-spatial aliasing and eliminate redundant data. You may impose lower
-and/or upper bounds on the solution. These may be entered in the form of
-a fixed value, a grid with values, or simply be the minimum/maximum
-input data values. Natural boundary conditions are applied at the edges,
-except for geographic data with 360-degree range where we apply periodic
-boundary conditions in the longitude direction.</p>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc4">Required Arguments</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-G</strong><em>outputfile.nc</em></dt>
-<dd>Output file name. Output is a binary 2-D <em>.nc</em> file. Note that the
-smallest grid dimension must be at least 4.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]</dt>
-<dd><em>x_inc</em> [and optionally <em>y_inc</em>] is the grid spacing. Optionally,
-append a suffix modifier. <strong>Geographical (degrees) coordinates</strong>: Append
-<strong>m</strong> to indicate arc minutes or <strong>s</strong> to indicate arc seconds. If one
-of the units <strong>e</strong>, <strong>f</strong>, <strong>k</strong>, <strong>M</strong>, <strong>n</strong> or <strong>u</strong> is appended
-instead, the increment is assumed to be given in meter, foot, km, Mile,
-nautical mile or US survey foot, respectively, and will be converted to
-the equivalent degrees longitude at the middle latitude of the region
-(the conversion depends on <a class="reference internal" href="gmt.conf.html#projection-parameters"><em>PROJ_ELLIPSOID</em></a>). If /<em>y_inc</em> is given
-but set to 0 it will be reset equal to <em>x_inc</em>; otherwise it will be
-converted to degrees latitude. <strong>All coordinates</strong>: If <strong>=</strong> is appended
-then the corresponding max <em>x</em> (<em>east</em>) or <em>y</em> (<em>north</em>) may be slightly
-adjusted to fit exactly the given increment [by default the increment
-may be adjusted slightly to fit the given domain]. Finally, instead of
-giving an increment you may specify the <em>number of nodes</em> desired by
-appending <strong>+</strong> to the supplied integer argument; the increment is then
-recalculated from the number of nodes and the domain. The resulting
-increment value depends on whether you have selected a
-gridline-registered or pixel-registered grid; see <a class="reference internal" href="GMT_Docs.html#app-file-formats"><em>B. GMT File Formats</em></a> for
-details. Note: if <strong>-R</strong><em>grdfile</em> is used then the grid spacing has
-already been initialized; use <strong>-I</strong> to override the values.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-</dl>
-</div>
-<div class="section" id="id2">
-<h2><a class="reference external" href="#toc5">Optional Arguments</a><a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>[<em>ncols</em>][<em>type</em>]) data
-table file(s) holding a number of data columns. If no tables are given
-then we read from standard input. </dd>
-<dt><strong>-A</strong><em>aspect_ratio</em></dt>
-<dd>Aspect ratio. If desired, grid anisotropy can be added to the
-equations. Enter <em>aspect_ratio</em>, where dy = dx / <em>aspect_ratio</em>
-relates the grid dimensions. [Default = 1 assumes isotropic grid.]</dd>
-<dt><strong>-C</strong><em>convergence_limit</em></dt>
-<dd>Convergence limit. Iteration is assumed to have converged when the
-maximum absolute change in any grid value is less than
-<em>convergence_limit</em>. (Units same as data z units). [Default is
-scaled to 0.1 percent of typical gradient in input data.]</dd>
-<dt><strong>-Ll</strong><em>lower</em> and <strong>-Lu</strong><em>upper</em></dt>
-<dd>Impose limits on the output solution. <strong>l</strong><em>lower</em> sets the lower
-bound. <em>lower</em> can be the name of a grid file with lower bound
-values, a fixed value, <strong>d</strong> to set to minimum input value, or <strong>u</strong>
-for unconstrained [Default]. <strong>u</strong><em>upper</em> sets the upper bound and
-can be the name of a grid file with upper bound values, a fixed
-value, <strong>d</strong> to set to maximum input value, or <strong>u</strong> for
-unconstrained [Default]. Grid files used to set the limits may
-contain NaNs. In the presence of NaNs, the limit of a node masked
-with NaN is unconstrained.</dd>
-<dt><strong>-N</strong><em>max_iterations</em></dt>
-<dd>Number of iterations. Iteration will cease when <em>convergence_limit</em>
-is reached or when number of iterations reaches <em>max_iterations</em>.
-[Default is 250.]</dd>
-<dt><strong>-Q</strong></dt>
-<dd>Suggest grid dimensions which have a highly composite greatest
-common factor. This allows surface to use several intermediate steps
-in the solution, yielding faster run times and better results. The
-sizes suggested by <strong>-Q</strong> can be achieved by altering <strong>-R</strong> and/or
-<strong>-I</strong>. You can recover the <strong>-R</strong> and <strong>-I</strong> you want later by
-using <strong>grdsample</strong> or <strong>grdcut</strong> on the output of <strong>surface</strong>.</dd>
-<dt><strong>-S</strong><em>search_radius</em>[<strong>m</strong>|<strong>s</strong>]</dt>
-<dd>Search radius. Enter <em>search_radius</em> in same units as x,y data;
-append <strong>m</strong> to indicate arc minutes or <strong>s</strong> for arc seconds. This
-is used to initialize the grid before the first iteration; it is not
-worth the time unless the grid lattice is prime and cannot have
-regional stages. [Default = 0.0 and no search is made.]</dd>
-<dt><strong>-T</strong>[<strong>i</strong>|<strong>b</strong>] ]<em>tension_factor</em></dt>
-<dd>Tension factor[s]. These must be between 0 and 1. Tension may be
-used in the interior solution (above equation, where it suppresses
-spurious oscillations) and in the boundary conditions (where it
-tends to flatten the solution approaching the edges). Using zero for
-both values results in a minimum curvature surface with free edges,
-i.e., a natural bicubic spline. Use <strong>-Ti</strong><em>tension_factor</em>
-to set interior tension, and <strong>-Tb</strong><em>tension_factor</em> to set
-boundary tension. If you do not prepend <strong>i</strong> or <strong>b</strong>, both will be
-set to the same value. [Default = 0 for both gives minimum curvature
-solution.]</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. <strong>-V3</strong> will report the convergence after each iteration;
-<strong>-V</strong> will report only after each regional grid is converged.</dd>
-<dt><strong>-Z</strong><em>over-relaxation_factor</em></dt>
-<dd>Over-relaxation factor. This parameter is used to accelerate the
-convergence; it is a number between 1 and 2. A value of 1 iterates
-the equations exactly, and will always assure stable convergence.
-Larger values overestimate the incremental changes during
-convergence, and will reach a solution more rapidly but may become
-unstable. If you use a large value for this factor, it is a good
-idea to monitor each iteration with the <strong>-Vl</strong> option. [Default =
-1.4 converges quickly and is almost always stable.]</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-a</strong><em>col</em>=<em>name</em>[<em>...</em>] <a class="reference internal" href="gmt.html#aspatial-full"><em>(more ...)</em></a></dt>
-<dd>Set aspatial column associations <em>col</em>=<em>name</em>.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 3 input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). Not used with binary data.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="grid-values-precision">
-<h2>Grid Values Precision<a class="headerlink" href="#grid-values-precision" title="Permalink to this headline">¶</a></h2>
-<p>Regardless of the precision of the input data, GMT programs that create
-grid files will internally hold the grids in 4-byte floating point
-arrays. This is done to conserve memory and furthermore most if not all
-real data can be stored using 4-byte floating point values. Data with
-higher precision (i.e., double precision values) will lose that
-precision once GMT operates on the grid or writes out new grids. To
-limit loss of precision when processing data you should always consider
-normalizing the data prior to processing.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To grid 5 by 5 minute gravity block means from the ASCII data in
-hawaii_5x5.xyg, using a <em>tension_factor</em> = 0.25, a
-<em>convergence_limit</em> = 0.1 milligal, writing the result to a file called
-hawaii_grd.nc, and monitoring each iteration, try:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt surface hawaii_5x5.xyg -R198/208/18/25 -I5m -Ghawaii_grd.nc -T0.25 -C0.1 -Vl
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="bugs">
-<h2>Bugs<a class="headerlink" href="#bugs" title="Permalink to this headline">¶</a></h2>
-<p><strong>surface</strong> will complain when more than one data point is found for any
-node and suggest that you run <strong>blockmean</strong>, <strong>blockmedian</strong>, or
-<a class="reference internal" href="blockmode.html"><em>blockmode</em></a> first. If you did run <strong>blockm*</strong> and still get this
-message it usually means that your grid spacing is so small that you
-need more decimals in the output format used by <strong>blockm*</strong>. You may
-specify more decimal places by editing the parameter
-<strong>FORMAT_FLOAT_OUT</strong> in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file prior to running
-<strong>blockm*</strong>, or choose binary input and/or output using single or
-double precision storage.</p>
-<p>Note that only gridline registration is possible with <strong>surface</strong>. If
-you need a pixel-registered grid you can resample a gridline registered
-grid using <a class="reference internal" href="grdsample.html"><em>grdsample</em></a> <strong>-T</strong>.</p>
-</div>
-<div class="section" id="id3">
-<h2><a class="reference external" href="#toc9">See Also</a><a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="blockmean.html"><em>blockmean</em></a>,
-<a class="reference internal" href="blockmedian.html"><em>blockmedian</em></a>,
-<a class="reference internal" href="blockmode.html"><em>blockmode</em></a>,
-<a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="greenspline.html"><em>greenspline</em></a>,
-<a class="reference internal" href="nearneighbor.html"><em>nearneighbor</em></a>,
-<a class="reference internal" href="triangulate.html"><em>triangulate</em></a>,
-<a class="reference internal" href="sphtriangulate.html"><em>sphtriangulate</em></a></p>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>Smith, W. H. F, and P. Wessel, 1990, Gridding with continuous curvature
-splines in tension, <em>Geophysics</em>, 55, 293-305.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">surface</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#id1">Required Arguments</a></li>
-<li><a class="reference internal" href="#id2">Optional Arguments</a></li>
-<li><a class="reference internal" href="#grid-values-precision">Grid Values Precision</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#bugs">Bugs</a></li>
-<li><a class="reference internal" href="#id3">See Also</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="splitxyz.html"
- title="previous chapter">splitxyz</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="T.html"
- title="next chapter">T</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/surface.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="T.html" title="T"
- >next</a> </li>
- <li class="right" >
- <a href="splitxyz.html" title="splitxyz"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="S.html" >S</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/testapi.html b/doc_release/html/testapi.html
deleted file mode 100644
index a80a150..0000000
--- a/doc_release/html/testapi.html
+++ /dev/null
@@ -1,211 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>testapi — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="testapi">
-<span id="index-0"></span><h1>testapi<a class="headerlink" href="#testapi" title="Permalink to this headline">¶</a></h1>
-<p>testapi - Test API i/o methods for any data type</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>testapi</strong>
-<strong>-I</strong><strong>c</strong>|<strong>d</strong>|<strong>f</strong>|<strong>r</strong>|<strong>s</strong>[/<strong>m</strong>|<strong>v</strong>]
-<strong>-T</strong><strong>c</strong>|<strong>d</strong>|<strong>g</strong>|<strong>i</strong>|<strong>t</strong>
-<strong>-W</strong><strong>c</strong>|<strong>d</strong>|<strong>f</strong>|<strong>r</strong>|<strong>s</strong>[/<strong>m</strong>|<strong>v</strong>]
-[ <strong>-V</strong>[<em>level</em>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="id1">
-<h2><a class="reference external" href="#toc2">Description</a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
-<p><strong>testapi</strong> will test the API for all i/o combinations. In general, data
-types (DATASET, TEXTSET, CPT, GRID, and IMAGE) can be read from or
-written to 5 different ways (file, stream, file descriptor, copy from
-memory, reference from memory). We use this tool to check the various
-possibilities, for each data type.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-I</strong><strong>c</strong>|<strong>d</strong>|<strong>f</strong>|<strong>r</strong>|<strong>s</strong>[/<strong>m</strong>|<strong>v</strong>]</dt>
-<dd>Set input method; choose from <strong>c</strong>opy from memory, file
-<strong>d</strong>escriptor, <strong>f</strong>ile, memory <strong>r</strong>eference, or
-<strong>s</strong>tream. For methods <strong>c</strong>|<strong>r</strong>, optionally append
-/<strong>m</strong>|<strong>v</strong>. Then, we obtain the values for the input dataset
-or grid via either a user matrix (<strong>m</strong>) or a set of user vectors
-(<strong>v</strong>). We simulate this internally by filling out a matrix or
-vectors and pass that as the source instead of a data file. <strong>-Td</strong>
-may take either <strong>m</strong>|<strong>v</strong> while <strong>-Tg</strong> can only take the
-<strong>m</strong> modifier.</dd>
-<dt><strong>-T</strong><strong>c</strong>|<strong>d</strong>|<strong>g</strong>|<strong>i</strong>|<strong>t</strong></dt>
-<dd>Specify data type; choose from <strong>c</strong>pt, <strong>d</strong>ataset, <strong>g</strong>rid,
-<strong>i</strong>mage, or <strong>t</strong>extset.</dd>
-<dt><strong>-W</strong><strong>c</strong>|<strong>d</strong>|<strong>f</strong>|<strong>r</strong>|<strong>s</strong>[/<strong>m</strong>|<strong>v</strong>]</dt>
-<dd>Set output method; choose from <strong>c</strong>opy to memory, file
-<strong>d</strong>escriptor, <strong>f</strong>ile, memory <strong>r</strong>eference, or
-<strong>s</strong>tream. For methods <strong>c</strong>|<strong>r</strong>, optionally append
-/<strong>m</strong>|<strong>v</strong>. Then, we first write the values of the output
-dataset or grid via either a user matrix (<strong>m</strong>) or a set of user
-vectors (<strong>v</strong>). Finally, the matrix or vectors are written out to
-file. <strong>-Td</strong> may take either <strong>m</strong>|<strong>v</strong> while <strong>-Tg</strong> can
-only take the <strong>m</strong> modifier.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-</dl>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To check if reading and writing the test dataset file yields an identical copy, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre><span class="n">testapi</span> <span class="o">-</span><span class="n">Td</span> <span class="o">-</span><span class="n">If</span> <span class="o">-</span><span class="n">Wf</span> <span class="o">-</span><span class="n">V</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>To check if reading the test grid from memory and writing it to file
-yields an identical copy, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre><span class="n">testapi</span> <span class="o">-</span><span class="n">Tg</span> <span class="o">-</span><span class="n">Ic</span> <span class="o">-</span><span class="n">Wf</span> <span class="o">-</span><span class="n">V</span>
-</pre></div>
-</div>
-</div></blockquote>
-<p>To read the test grid via user matrix memory and writing it via another
-user matrix before saving to a grid file, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre><span class="n">testapi</span> <span class="o">-</span><span class="n">Tg</span> <span class="o">-</span><span class="n">Ic</span><span class="o">/</span><span class="n">m</span> <span class="o">-</span><span class="n">Wf</span><span class="o">/</span><span class="n">m</span> <span class="o">-</span><span class="n">V</span>
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">testapi</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#id1">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/testapi.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/trend1d.html b/doc_release/html/trend1d.html
deleted file mode 100644
index 370f4b9..0000000
--- a/doc_release/html/trend1d.html
+++ /dev/null
@@ -1,350 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>trend1d — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="T" href="T.html" />
- <link rel="next" title="trend2d" href="trend2d.html" />
- <link rel="prev" title="T" href="T.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="trend2d.html" title="trend2d"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="T.html" title="T"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="T.html" accesskey="U">T</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="trend1d">
-<span id="index-0"></span><h1>trend1d<a class="headerlink" href="#trend1d" title="Permalink to this headline">¶</a></h1>
-<p>trend1d - Fit a [weighted] [robust] polynomial [or Fourier] model for y = f(x) to xy[w] data</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>trend1d</strong> [ <em>table</em> ] <strong>-F</strong><strong>xymrw|p</strong>
-<strong>-N</strong>[<strong>f</strong>]<em>n_model</em>[<strong>r</strong>] [ <em>xy[w]file</em> ]
-[ <strong>-C</strong><em>condition_number</em> ] [ <strong>-I</strong>[<em>confidence_level</em>] ]
-[ <strong>-V</strong>[<em>level</em>] ] [ <strong>-W</strong> ]
-[ <strong>-b</strong>[<strong>i</strong>|<strong>o</strong>][<em>ncol</em>][<strong>type</strong>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>trend1d</strong> reads x,y [and w] values from the first two [three] columns
-on standard input [or <em>file</em>] and fits a regression model y = f(x) + e
-by [weighted] least squares. The functional form of f(x) may be chosen
-as polynomial or Fourier, and the fit may be made robust by iterative
-reweighting of the data. The user may also search for the number of
-terms in f(x) which significantly reduce the variance in y.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-F</strong><strong>xymrw|p</strong></dt>
-<dd>Specify up to five letters from the set {<strong>x y m r w</strong>} in any
-order to create columns of ASCII [or binary] output. <strong>x</strong> = x,
-<strong>y</strong> = y, <strong>m</strong> = model f(x), <strong>r</strong> = residual y - <strong>m</strong>, <strong>w</strong> =
-weight used in fitting. Alternatively choose <strong>-F</strong><strong>p</strong> (i.e., no
-other of the 5 letters) to output only the model coefficients
-(Polynomial).</dd>
-<dt><strong>-N</strong>[<strong>f</strong>]<em>n_model</em>[<strong>r</strong>]</dt>
-<dd>Specify the number of terms in the model, <em>n_model</em>, whether to fit
-a Fourier (<strong>-Nf</strong>) or polynomial [Default] model, and append <strong>r</strong>
-to do a robust fit. E.g., a robust quadratic model is
-<strong>-N</strong><em>3</em><strong>r</strong>.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII [or binary, see <strong>-bi</strong>]
-files containing x,y [w] values in the first 2 [3] columns. If no
-files are specified, <strong>trend1d</strong> will read from standard input.</dd>
-<dt><strong>-C</strong><em>condition_number</em></dt>
-<dd>Set the maximum allowed condition number for the matrix solution.
-<strong>trend1d</strong> fits a damped least squares model, retaining only that
-part of the eigenvalue spectrum such that the ratio of the largest
-eigenvalue to the smallest eigenvalue is <em>condition_#</em>. [Default:
-<em>condition_#</em> = 1.0e06. ].</dd>
-<dt><strong>-I</strong>[<em>confidence_level</em>]</dt>
-<dd>Iteratively increase the number of model parameters, starting at
-one, until <em>n_model</em> is reached or the reduction in variance of the
-model is not significant at the <em>confidence_level</em> level. You may
-set <strong>-I</strong> only, without an attached number; in this case the fit
-will be iterative with a default confidence level of 0.51. Or choose
-your own level between 0 and 1. See remarks section.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong></dt>
-<dd>Weights are supplied in input column 3. Do a weighted least squares
-fit [or start with these weights when doing the iterative robust
-fit]. [Default reads only the first 2 columns.]</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 2 (or 3 if <strong>-W</strong> is set) columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. [Default is 1-5 columns as given by <strong>-F</strong>].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="ascii-format-precision">
-<h2>Ascii Format Precision<a class="headerlink" href="#ascii-format-precision" title="Permalink to this headline">¶</a></h2>
-<p>The ASCII output formats of numerical data are controlled by parameters
-in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file. Longitude and latitude are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>, whereas other values are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>. Be aware that the format in effect
-can lead to loss of precision in the output, which can lead to various
-problems downstream. If you find the output is not written with enough
-precision, consider switching to binary output (<strong>-bo</strong> if available) or
-specify more decimals using the <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> setting.</p>
-</div>
-<div class="section" id="remarks">
-<h2>Remarks<a class="headerlink" href="#remarks" title="Permalink to this headline">¶</a></h2>
-<p>If a Fourier model is selected, the domain of x will be shifted and
-scaled to [-pi, pi] and the basis functions used will be 1, cos(x),
-sin(x), cos(2x), sin(2x), ... If a
-polynomial model is selected, the domain of x will be shifted and scaled
-to [-1, 1] and the basis functions will be Chebyshev polynomials. These
-have a numerical advantage in the form of the matrix which must be
-inverted and allow more accurate solutions. The Chebyshev polynomial of
-degree n has n+1 extrema in [-1, 1], at all of which its value is either
--1 or +1. Therefore the magnitude of the polynomial model coefficients
-can be directly compared. NOTE: The stable model coefficients are
-Chebyshev coefficients. The corresponding polynomial coefficients in a +
-bx + cxx + ... are also given in Verbose mode but users must realize
-that they are NOT stable beyond degree 7 or 8. See Numerical Recipes for
-more discussion. For evaluating Chebyshev polynomials, see <strong>gmtmath</strong>.</p>
-<p>The <strong>-Nr</strong> (robust) and <strong>-I</strong> (iterative) options evaluate the
-significance of the improvement in model misfit Chi-Squared by an F
-test. The default confidence limit is set at 0.51; it can be changed
-with the <strong>-I</strong> option. The user may be surprised to find that in most
-cases the reduction in variance achieved by increasing the number of
-terms in a model is not significant at a very high degree of confidence.
-For example, with 120 degrees of freedom, Chi-Squared must decrease by
-26% or more to be significant at the 95% confidence level. If you want
-to keep iterating as long as Chi-Squared is decreasing, set
-<em>confidence_level</em> to zero.</p>
-<p>A low confidence limit (such as the default value of 0.51) is needed to
-make the robust method work. This method iteratively reweights the data
-to reduce the influence of outliers. The weight is based on the Median
-Absolute Deviation and a formula from Huber [1964], and is 95% efficient
-when the model residuals have an outlier-free normal distribution. This
-means that the influence of outliers is reduced only slightly at each
-iteration; consequently the reduction in Chi-Squared is not very
-significant. If the procedure needs a few iterations to successfully
-attenuate their effect, the significance level of the F test must be
-kept low.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To remove a linear trend from data.xy by ordinary least squares, use:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt trend1d data.xy -Fxr -N2 > detrended_data.xy
-</pre></div>
-</div>
-</div></blockquote>
-<p>To make the above linear trend robust with respect to outliers, use:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt trend1d data.xy -Fxr -N2r > detrended_data.xy
-</pre></div>
-</div>
-</div></blockquote>
-<p>To find out how many terms (up to 20, say in a robust Fourier
-interpolant are significant in fitting data.xy, use:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt trend1d data.xy -Nf20r -I -V
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="gmtmath.html"><em>gmtmath</em></a>,
-<a class="reference internal" href="grdtrend.html"><em>grdtrend</em></a>,
-<a class="reference internal" href="trend2d.html"><em>trend2d</em></a></p>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>Huber, P. J., 1964, Robust estimation of a location parameter, <em>Ann.
-Math. Stat.</em>, <strong>35</strong>, 73-101.</p>
-<p>Menke, W., 1989, Geophysical Data Analysis: Discrete Inverse Theory,
-Revised Edition, Academic Press, San Diego.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">trend1d</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#ascii-format-precision">Ascii Format Precision</a></li>
-<li><a class="reference internal" href="#remarks">Remarks</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="T.html"
- title="previous chapter">T</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="trend2d.html"
- title="next chapter">trend2d</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/trend1d.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="trend2d.html" title="trend2d"
- >next</a> </li>
- <li class="right" >
- <a href="T.html" title="T"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="T.html" >T</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/trend2d.html b/doc_release/html/trend2d.html
deleted file mode 100644
index ed2daee..0000000
--- a/doc_release/html/trend2d.html
+++ /dev/null
@@ -1,361 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>trend2d — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="T" href="T.html" />
- <link rel="next" title="triangulate" href="triangulate.html" />
- <link rel="prev" title="trend1d" href="trend1d.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="triangulate.html" title="triangulate"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="trend1d.html" title="trend1d"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="T.html" accesskey="U">T</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="trend2d">
-<span id="index-0"></span><h1>trend2d<a class="headerlink" href="#trend2d" title="Permalink to this headline">¶</a></h1>
-<p>trend2d - Fit a [weighted] [robust] polynomial model for z = f(x,y) to xyz[w] data</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>trend2d</strong> [ <em>table</em> ] <strong>-F</strong><strong>xyzmrw</strong> <strong>-N</strong><em>n_model</em>[<strong>r</strong>]
-[ <em>xyz[w]file</em> ] [ <strong>-C</strong><em>condition_number</em> ]
-[ <strong>-I</strong>[<em>confidence_level</em>] ] [ <strong>-V</strong>[<em>level</em>] ] [ <strong>-W</strong> ] [
-[ <strong>-b</strong>[<strong>i</strong>|<strong>o</strong>][<em>ncol</em>][<strong>type</strong>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>trend2d</strong> reads x,y,z [and w] values from the first three [four]
-columns on standard input [or <em>xyz[w]file</em>] and fits a regression model
-z = f(x,y) + e by [weighted] least squares. The fit may be made robust
-by iterative reweighting of the data. The user may also search for the
-number of terms in f(x,y) which significantly reduce the variance in z.
-n_model may be in [1,10] to fit a model of the following form (similar
-to grdtrend):</p>
-<blockquote>
-<div>m1 + m2*x + m3*y + m4*x*y + m5*x*x + m6*y*y + m7*x*x*x +
-m8*x*x*y + m9*x*y*y + m10*y*y*y.</div></blockquote>
-<p>The user must specify <strong>-N</strong><em>n_model</em>, the number of model parameters
-to use; thus, <strong>-N</strong><em>4</em> fits a bilinear trend, <strong>-N</strong><em>6</em> a quadratic
-surface, and so on. Optionally, append <strong>r</strong> to perform a robust fit. In
-this case, the program will iteratively reweight the data based on a
-robust scale estimate, in order to converge to a solution insensitive to
-outliers. This may be handy when separating a “regional” field from a
-“residual” which should have non-zero mean, such as a local mountain on
-a regional surface.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-F</strong><strong>xyzmrw</strong></dt>
-<dd>Specify up to six letters from the set {<strong>x y z m r w</strong>} in any
-order to create columns of ASCII [or binary] output. <strong>x</strong> = x,
-<strong>y</strong> = y, <strong>z</strong> = z, <strong>m</strong> = model f(x,y), <strong>r</strong> = residual z -
-<strong>m</strong>, <strong>w</strong> = weight used in fitting.</dd>
-<dt><strong>-N</strong><em>n_model</em>[<strong>r</strong>]</dt>
-<dd>Specify the number of terms in the model, <em>n_model</em>, and append
-<strong>r</strong> to do a robust fit. E.g., a robust bilinear model is
-<strong>-N</strong><em>4</em><strong>r</strong>.</dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII [or binary, see <strong>-bi</strong>]
-files containing x,y,z [w] values in the first 3 [4] columns. If no
-files are specified, <strong>trend2d</strong> will read from standard input.</dd>
-<dt><strong>-C</strong><em>condition_number</em></dt>
-<dd>Set the maximum allowed condition number for the matrix solution.
-<strong>trend2d</strong> fits a damped least squares model, retaining only that
-part of the eigenvalue spectrum such that the ratio of the largest
-eigenvalue to the smallest eigenvalue is <em>condition_#</em>. [Default:
-<em>condition_#</em> = 1.0e06. ].</dd>
-<dt><strong>-I</strong>[<em>confidence_level</em>]</dt>
-<dd>Iteratively increase the number of model parameters, starting at
-one, until <em>n_model</em> is reached or the reduction in variance of the
-model is not significant at the <em>confidence_level</em> level. You may
-set <strong>-I</strong> only, without an attached number; in this case the fit
-will be iterative with a default confidence level of 0.51. Or choose
-your own level between 0 and 1. See remarks section.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-W</strong></dt>
-<dd>Weights are supplied in input column 4. Do a weighted least squares
-fit [or start with these weights when doing the iterative robust
-fit]. [Default reads only the first 3 columns.]</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 3 (or 4 if <strong>-W</strong> is set) input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. [Default is 1-6 columns as set by <strong>-F</strong>].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="remarks">
-<h2>Remarks<a class="headerlink" href="#remarks" title="Permalink to this headline">¶</a></h2>
-<p>The domain of x and y will be shifted and scaled to [-1, 1] and the
-basis functions are built from Chebyshev polynomials. These have a
-numerical advantage in the form of the matrix which must be inverted and
-allow more accurate solutions. In many applications of <strong>trend2d</strong> the
-user has data located approximately along a line in the x,y plane which
-makes an angle with the x axis (such as data collected along a road or
-ship track). In this case the accuracy could be improved by a rotation
-of the x,y axes. <strong>trend2d</strong> does not search for such a rotation;
-instead, it may find that the matrix problem has deficient rank.
-However, the solution is computed using the generalized inverse and
-should still work out OK. The user should check the results graphically
-if <strong>trend2d</strong> shows deficient rank. NOTE: The model parameters listed
-with <strong>-V</strong> are Chebyshev coefficients; they are not numerically
-equivalent to the m#s in the equation described above. The description
-above is to allow the user to match <strong>-N</strong> with the order of the
-polynomial surface. For evaluating Chebyshev polynomials, see
-<a class="reference internal" href="grdmath.html"><em>grdmath</em></a>.</p>
-<p>The <strong>-N</strong><em>n_model</em><strong>r</strong> (robust) and <strong>-I</strong> (iterative) options
-evaluate the significance of the improvement in model misfit Chi-Squared
-by an F test. The default confidence limit is set at 0.51; it can be
-changed with the <strong>-I</strong> option. The user may be surprised to find that
-in most cases the reduction in variance achieved by increasing the
-number of terms in a model is not significant at a very high degree of
-confidence. For example, with 120 degrees of freedom, Chi-Squared must
-decrease by 26% or more to be significant at the 95% confidence level.
-If you want to keep iterating as long as Chi-Squared is decreasing, set
-<em>confidence_level</em> to zero.</p>
-<p>A low confidence limit (such as the default value of 0.51) is needed to
-make the robust method work. This method iteratively reweights the data
-to reduce the influence of outliers. The weight is based on the Median
-Absolute Deviation and a formula from Huber [1964], and is 95% efficient
-when the model residuals have an outlier-free normal distribution. This
-means that the influence of outliers is reduced only slightly at each
-iteration; consequently the reduction in Chi-Squared is not very
-significant. If the procedure needs a few iterations to successfully
-attenuate their effect, the significance level of the F test must be
-kept low.</p>
-</div>
-<div class="section" id="ascii-format-precision">
-<h2>Ascii Format Precision<a class="headerlink" href="#ascii-format-precision" title="Permalink to this headline">¶</a></h2>
-<p>The ASCII output formats of numerical data are controlled by parameters
-in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file. Longitude and latitude are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>, whereas other values are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>. Be aware that the format in effect
-can lead to loss of precision in the output, which can lead to various
-problems downstream. If you find the output is not written with enough
-precision, consider switching to binary output (<strong>-bo</strong> if available) or
-specify more decimals using the <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> setting.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To remove a planar trend from data.xyz by ordinary least squares, use:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt trend2d data.xyz -Fxyr -N2 > detrended_data.xyz
-</pre></div>
-</div>
-</div></blockquote>
-<p>To make the above planar trend robust with respect to outliers, use:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt trend2d data.xzy -Fxyr -N2r > detrended_data.xyz
-</pre></div>
-</div>
-</div></blockquote>
-<p>To find out how many terms (up to 10 in a robust interpolant are
-significant in fitting data.xyz, use:</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt trend2d data.xyz -N10r -I -V
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="grdmath.html"><em>grdmath</em></a>,
-<a class="reference internal" href="grdtrend.html"><em>grdtrend</em></a>,
-<a class="reference internal" href="trend1d.html"><em>trend1d</em></a></p>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>Huber, P. J., 1964, Robust estimation of a location parameter, <em>Ann.
-Math. Stat.</em>, <strong>35</strong>, 73-101.</p>
-<p>Menke, W., 1989, Geophysical Data Analysis: Discrete Inverse Theory,
-Revised Edition, Academic Press, San Diego.</p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">trend2d</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#remarks">Remarks</a></li>
-<li><a class="reference internal" href="#ascii-format-precision">Ascii Format Precision</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="trend1d.html"
- title="previous chapter">trend1d</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="triangulate.html"
- title="next chapter">triangulate</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/trend2d.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="triangulate.html" title="triangulate"
- >next</a> </li>
- <li class="right" >
- <a href="trend1d.html" title="trend1d"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="T.html" >T</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/triangulate.html b/doc_release/html/triangulate.html
deleted file mode 100644
index db177ce..0000000
--- a/doc_release/html/triangulate.html
+++ /dev/null
@@ -1,359 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>triangulate — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="T" href="T.html" />
- <link rel="next" title="X" href="X.html" />
- <link rel="prev" title="trend2d" href="trend2d.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="X.html" title="X"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="trend2d.html" title="trend2d"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="T.html" accesskey="U">T</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="triangulate">
-<span id="index-0"></span><h1>triangulate<a class="headerlink" href="#triangulate" title="Permalink to this headline">¶</a></h1>
-<p>triangulate - Do optimal (Delaunay) triangulation and gridding of Cartesian table data [method]</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>triangulate</strong> [ <em>table</em> ] [ <strong>-Dx</strong>|<strong>y</strong> ] [ <strong>-E</strong><em>empty</em> ]
-[ <strong>-G</strong><em>grdfile</em> ]
-[ <strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]] ]
-[ <strong>-J</strong><em>parameters</em> ] [ <strong>-M</strong> ] [ <strong>-N</strong> ] [ <strong>-Q</strong> ]
-[ <strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] ] [ <strong>-S</strong> ]
-[ <strong>-V</strong>[<em>level</em>] ] [ <strong>-Z</strong> ]
-[ <strong>-b</strong>[<strong>i</strong>|<strong>o</strong>][<em>ncol</em>][<strong>type</strong>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-r</strong> ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>triangulate</strong> reads one or more ASCII [or binary] files (or standard
-input) containing x,y[,z] and performs Delaunay triangulation, i.e., it
-find how the points should be connected to give the most equilateral
-triangulation possible. If a map projection (give <strong>-R</strong> and <strong>-J</strong>) is
-chosen then it is applied before the triangulation is calculated. By
-default, the output is triplets of point id numbers that make up each
-triangle and is written to standard output. The id numbers refer to the
-points position (line number, starting at 0 for the first line) in the
-input file. As an option, you may choose to create a multiple segment
-file that can be piped through <a class="reference internal" href="psxy.html"><em>psxy</em></a> to draw the triangulation
-network. If <strong>-G</strong> <strong>-I</strong> are set a grid will be calculated based on the
-surface defined by the planar triangles. The actual algorithm used in
-the triangulations is either that of Watson [1982] [Default] or Shewchuk
-[1996] (if installed; type <strong>triangulate -</strong> to see which method is
-selected). This choice is made during the GMT installation.</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<p>None.</p>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII (or binary, see <strong>-bi</strong>[<em>ncols</em>][<em>type</em>]) data
-table file(s) holding a number of data columns. If no tables are given
-then we read from standard input. </dd>
-<dt><strong>-Dx</strong>|<strong>y</strong></dt>
-<dd>Take either the <em>x</em>- or <em>y</em>-derivatives of surface represented by
-the planar facets (only used when <strong>-G</strong> is set).</dd>
-<dt><strong>-E</strong><em>empty</em></dt>
-<dd>Set the value assigned to empty nodes when <strong>-G</strong> is set [NaN].</dd>
-<dt><strong>-G</strong><em>grdfile</em></dt>
-<dd>Use triangulation to grid the data onto an even grid (specified with
-<strong>-R</strong> <strong>-I</strong>). Append the name of the output grid file. The
-interpolation is performed in the original coordinates, so if your
-triangles are close to the poles you are better off projecting all
-data to a local coordinate system before using <strong>triangulate</strong> (this
-is true of all gridding routines).</dd>
-<dt><strong>-I</strong></dt>
-<dd><em>x_inc</em> [and optionally <em>y_inc</em>] sets the grid size for optional
-grid output (see <strong>-G</strong>). Append <strong>m</strong> to indicate arc minutes or
-<strong>s</strong> to indicate arc seconds.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-J</strong><em>parameters</em> <a class="reference internal" href="gmt.html#j-full"><em>(more ...)</em></a></dt>
-<dd>Select map projection.</dd>
-<dt><strong>-M</strong></dt>
-<dd>Output triangulation network as multiple line segments separated by
-a segment header record.</dd>
-<dt><strong>-N</strong></dt>
-<dd>Used in conjunction with <strong>-G</strong> to also write the triplets of the
-ids of all the Delaunay vertices [Default only writes the grid].</dd>
-<dt><strong>-Q</strong></dt>
-<dd>Output the edges of the Voronoi cells instead [Default is Delaunay
-triangle edges]. Requires <strong>-R</strong> and is only available if linked
-with the Shewchuk [1996] library. Note that <strong>-Z</strong> is ignored on
-output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-<dt><strong>-S</strong></dt>
-<dd>Output triangles as polygon segments separated by a segment header
-record. Requires Delaunay triangulation.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-Z</strong></dt>
-<dd>Controls whether we read (x,y) or (x,y,z) data and if z should be
-output when <strong>-M</strong> or <strong>-S</strong> are used [Read (x,y) only].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 2 input columns].</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bo</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bo-full"><em>(more ...)</em></a></dt>
-<dd>Select binary output. [Default is same as input]. Node ids are stored as double triplets.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-r</strong> <a class="reference internal" href="gmt.html#nodereg-full"><em>(more ...)</em></a></dt>
-<dd>Set pixel node registration [gridline]. (Only valid with <strong>-G</strong>).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="ascii-format-precision">
-<h2>Ascii Format Precision<a class="headerlink" href="#ascii-format-precision" title="Permalink to this headline">¶</a></h2>
-<p>The ASCII output formats of numerical data are controlled by parameters
-in your <a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file. Longitude and latitude are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-geo-out"><em>FORMAT_GEO_OUT</em></a>, whereas other values are formatted
-according to <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a>. Be aware that the format in effect
-can lead to loss of precision in the output, which can lead to various
-problems downstream. If you find the output is not written with enough
-precision, consider switching to binary output (<strong>-bo</strong> if available) or
-specify more decimals using the <a class="reference internal" href="gmt.conf.html#format-float-out"><em>FORMAT_FLOAT_OUT</em></a> setting.</p>
-</div>
-<div class="section" id="grid-values-precision">
-<h2>Grid Values Precision<a class="headerlink" href="#grid-values-precision" title="Permalink to this headline">¶</a></h2>
-<p>Regardless of the precision of the input data, GMT programs that create
-grid files will internally hold the grids in 4-byte floating point
-arrays. This is done to conserve memory and furthermore most if not all
-real data can be stored using 4-byte floating point values. Data with
-higher precision (i.e., double precision values) will lose that
-precision once GMT operates on the grid or writes out new grids. To
-limit loss of precision when processing data you should always consider
-normalizing the data prior to processing.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To triangulate the points in the file samples.xyz, store the triangle
-information in a binary file, and make a grid for the given area and spacing, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt triangulate samples.xyz -bo -R0/30/0/30 -I2 -Gsurf.nc > samples.ijk
-</pre></div>
-</div>
-</div></blockquote>
-<p>To draw the optimal Delaunay triangulation network based on the same
-file using a 15-cm-wide Mercator map, use</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt triangulate samples.xyz -M -R-100/-90/30/34 -JM15c | gmt psxy \
- -R-100/-90/30/34 -JM15c -W0.5p -B1 > network.ps
-</pre></div>
-</div>
-</div></blockquote>
-<p>To instead plot the Voronoi cell outlines, try</p>
-<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>gmt triangulate samples.xyz -M -Q -R-100/-90/30/34 -JM15c | \
- gmt psxy -R-100/-90/30/34 -JM15c -W0.5p -B1 > cells.ps
-</pre></div>
-</div>
-</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="greenspline.html"><em>greenspline</em></a>,
-<a class="reference internal" href="nearneighbor.html"><em>nearneighbor</em></a>,
-<a class="reference internal" href="pscontour.html"><em>pscontour</em></a>,
-<a class="reference internal" href="sphinterpolate.html"><em>sphinterpolate</em></a>,
-<a class="reference internal" href="sphtriangulate.html"><em>sphtriangulate</em></a>,
-<a class="reference internal" href="surface.html"><em>surface</em></a></p>
-</div>
-<div class="section" id="references">
-<h2>References<a class="headerlink" href="#references" title="Permalink to this headline">¶</a></h2>
-<p>Watson, D. F., 1982, Acord: Automatic contouring of raw data, <em>Comp. &
-Geosci.</em>, <strong>8</strong>, 97-101.</p>
-<p>Shewchuk, J. R., 1996, Triangle: Engineering a 2D Quality Mesh Generator
-and Delaunay Triangulator, First Workshop on Applied Computational
-Geometry (Philadelphia, PA), 124-133, ACM, May 1996.</p>
-<p><a class="reference external" href="http://www.cs.cmu.edu/~quake/triangle.html">Shewchuk’s Homepage</a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">triangulate</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#ascii-format-precision">Ascii Format Precision</a></li>
-<li><a class="reference internal" href="#grid-values-precision">Grid Values Precision</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-<li><a class="reference internal" href="#references">References</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="trend2d.html"
- title="previous chapter">trend2d</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="X.html"
- title="next chapter">X</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/triangulate.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="X.html" title="X"
- >next</a> </li>
- <li class="right" >
- <a href="trend2d.html" title="trend2d"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="T.html" >T</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/html/xyz2grd.html b/doc_release/html/xyz2grd.html
deleted file mode 100644
index 6210981..0000000
--- a/doc_release/html/xyz2grd.html
+++ /dev/null
@@ -1,432 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-
-
- <title>xyz2grd — GMT 5.1.2 documentation</title>
-
-<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0"/>
-
-
-
- <link rel="stylesheet" href="_static/rtd.css" type="text/css" />
- <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
-
- <script type="text/javascript">
- var DOCUMENTATION_OPTIONS = {
- URL_ROOT: './',
- VERSION: '5.1.2',
- COLLAPSE_INDEX: false,
- FILE_SUFFIX: '.html',
- HAS_SOURCE: true
- };
- </script>
- <script type="text/javascript" src="_static/jquery.js"></script>
- <script type="text/javascript" src="_static/underscore.js"></script>
- <script type="text/javascript" src="_static/doctools.js"></script>
- <script type="text/javascript" src="_static/searchtools.js"></script>
- <script type="text/javascript" src="_static/rtd-sidebar.js"></script>
- <link rel="top" title="GMT 5.1.2 documentation" href="index.html" />
- <link rel="up" title="X" href="X.html" />
- <link rel="next" title="GSHHG" href="SUP_GSHHS.html" />
- <link rel="prev" title="X" href="X.html" />
- </head>
- <body>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- accesskey="I">index</a></li>
- <li class="right" >
- <a href="SUP_GSHHS.html" title="GSHHG"
- accesskey="N">next</a> </li>
- <li class="right" >
- <a href="X.html" title="X"
- accesskey="P">previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="X.html" accesskey="U">X</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-
- <div class="document">
- <div class="documentwrapper">
- <div class="bodywrapper">
- <div class="body">
-
- <div class="section" id="xyz2grd">
-<span id="index-0"></span><h1>xyz2grd<a class="headerlink" href="#xyz2grd" title="Permalink to this headline">¶</a></h1>
-<p>xyz2grd - Convert data table to a grid file</p>
-<div class="section" id="synopsis">
-<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
-<p><strong>xyz2grd</strong> [ <em>table</em> ] <strong>-G</strong><em>grdfile</em>
-<strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]
-<strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>]
-[ <strong>-A</strong>[<strong>f</strong>|<strong>l</strong>|<strong>m</strong>|<strong>n</strong>|<strong>r</strong>|<strong>s</strong>|<strong>u</strong>|<strong>z</strong>] ]
-[ <strong>-D</strong><em>xname</em>/<em>yname</em>/<em>zname</em>/<em>scale</em>/<em>offset</em>/<em>invalid</em>/<em>title</em>/<em>remark</em> ]
-[ <strong>-N</strong><em>nodata</em> ] [ <strong>-S</strong>[<em>zfile</em>] ]
-[ <strong>-V</strong>[<em>level</em>] ]
-[ <strong>-Z</strong>[<em>flags</em>] ]
-[ <strong>-bi</strong>[<em>ncols</em>][<em>type</em>][w][<strong>+L</strong>|<strong>+B</strong>] ]
-[ <strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> ]
-[ <strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] ]
-[ <strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,...] ]
-[ <strong>-r</strong> ]
-[ <strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] ]</p>
-<p><strong>Note:</strong> No space is allowed between the option flag and the associated arguments.</p>
-</div>
-<div class="section" id="description">
-<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><strong>xyz2grd</strong> reads one or more z or xyz tables and creates a binary grid
-file. <strong>xyz2grd</strong> will report if some of the nodes are not filled in
-with data. Such unconstrained nodes are set to a value specified by the
-user [Default is NaN]. Nodes with more than one value will be set to the
-mean value. As an option (using <strong>-Z</strong>), a 1-column z-table may be read
-assuming all nodes are present (z-tables can be in organized in a number
-of formats, see <strong>-Z</strong> below.)</p>
-</div>
-<div class="section" id="required-arguments">
-<h2>Required Arguments<a class="headerlink" href="#required-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><strong>-G</strong><em>grdfile</em></dt>
-<dd><em>grdfile</em> is the name of the binary output grid file. (See GRID FILE
-FORMAT below.)</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-I</strong><em>xinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>][/<em>yinc</em>[<em>unit</em>][<strong>=</strong>|<strong>+</strong>]]</dt>
-<dd><em>x_inc</em> [and optionally <em>y_inc</em>] is the grid spacing. Optionally,
-append a suffix modifier. <strong>Geographical (degrees) coordinates</strong>: Append
-<strong>m</strong> to indicate arc minutes or <strong>s</strong> to indicate arc seconds. If one
-of the units <strong>e</strong>, <strong>f</strong>, <strong>k</strong>, <strong>M</strong>, <strong>n</strong> or <strong>u</strong> is appended
-instead, the increment is assumed to be given in meter, foot, km, Mile,
-nautical mile or US survey foot, respectively, and will be converted to
-the equivalent degrees longitude at the middle latitude of the region
-(the conversion depends on <a class="reference internal" href="gmt.conf.html#projection-parameters"><em>PROJ_ELLIPSOID</em></a>). If /<em>y_inc</em> is given
-but set to 0 it will be reset equal to <em>x_inc</em>; otherwise it will be
-converted to degrees latitude. <strong>All coordinates</strong>: If <strong>=</strong> is appended
-then the corresponding max <em>x</em> (<em>east</em>) or <em>y</em> (<em>north</em>) may be slightly
-adjusted to fit exactly the given increment [by default the increment
-may be adjusted slightly to fit the given domain]. Finally, instead of
-giving an increment you may specify the <em>number of nodes</em> desired by
-appending <strong>+</strong> to the supplied integer argument; the increment is then
-recalculated from the number of nodes and the domain. The resulting
-increment value depends on whether you have selected a
-gridline-registered or pixel-registered grid; see <a class="reference internal" href="GMT_Docs.html#app-file-formats"><em>B. GMT File Formats</em></a> for
-details. Note: if <strong>-R</strong><em>grdfile</em> is used then the grid spacing has
-already been initialized; use <strong>-I</strong> to override the values.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-R</strong>[<em>unit</em>]<em>xmin</em>/<em>xmax</em>/<em>ymin</em>/<em>ymax</em>[<strong>r</strong>] <a class="reference internal" href="gmt.html#r-full"><em>(more ...)</em></a></dt>
-<dd>Specify the region of interest. </dd>
-</dl>
-</div>
-<div class="section" id="optional-arguments">
-<h2>Optional Arguments<a class="headerlink" href="#optional-arguments" title="Permalink to this headline">¶</a></h2>
-<dl class="docutils">
-<dt><em>table</em></dt>
-<dd>One or more ASCII [or binary, see <strong>-bi</strong>]
-files holding z or (x,y,z) values. The xyz triplets do not have to
-be sorted. One-column z tables must be sorted and the <strong>-Z</strong> must be
-set.</dd>
-<dt><strong>-A</strong>[<strong>f</strong>|<strong>l</strong>|<strong>m</strong>|<strong>n</strong>|<strong>r</strong>|<strong>s</strong>|<strong>u</strong>|<strong>z</strong>]</dt>
-<dd>By default we will calculate mean values if multiple entries fall on
-the same node. Use <strong>-A</strong> to change this behavior, except it is
-ignored if <strong>-Z</strong> is given. Append <strong>f</strong> or <strong>s</strong> to simply keep the
-first or last data point that was assigned to each node. Append
-<strong>l</strong> or <strong>u</strong> to find the lowest (minimum) or upper (maximum) value
-at each node, respectively. Append <strong>m</strong> or <strong>r</strong> to compute mean or
-RMS value at each node, respectively. Append <strong>n</strong> to simply count
-the number of data points that were assigned to each node. Append
-<strong>z</strong> to sum multiple values that belong to the same node.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-D</strong><em>xname</em>/<em>yname</em>/<em>zname</em>/<em>scale</em>/<em>offset</em>/<em>invalid</em>/<em>title</em>/<em>remark</em></dt>
-<dd>Give values for <em>xname</em>, <em>yname</em>, <em>zname</em> (give the names of those variables
-and in square bracket their units, e.g., “distance [km]”), <em>scale</em> (to multiply grid values after
-read [normally 1]), <em>offset</em> (to add to grid after scaling [normally 0]),
-<em>invalid</em> (a value to represent missing data [NaN]), <em>title</em> (anything you
-like), and <em>remark</em> (anything you like). To leave some of these values untouched,
-leave field blank. Empty fields in the end may be skipped. Alternatively,
-to allow “/” to be part of one of the values, use any non-alphanumeric
-character (and not the equal sign) as separator by both starting and ending
-with it. For example:
-<strong>-D</strong>:<em>xname</em>:<em>yname</em>:<em>zname</em>:<em>scale</em>:<em>offset</em>:<em>invalid</em>:<em>title</em>:<em>remark</em>:
-Use quotes to group texts with more than one word.
-Note that for geographic grids (<strong>-fg</strong>) <em>xname</em> and <em>yname</em> are set automatically.</dd>
-<dt><strong>-N</strong><em>nodata</em></dt>
-<dd>No data. Set nodes with no input xyz triplet to this value [Default
-is NaN]. For z-tables, this option is used to replace z-values that
-equal <em>nodata</em> with NaN.</dd>
-<dt><strong>-S</strong>[<em>zfile</em>]</dt>
-<dd>Swap the byte-order of the input only. No grid file is produced. You
-must also supply the <strong>-Z</strong> option. The output is written to <em>zfile</em>
-(or stdout if not supplied).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-V</strong>[<em>level</em>] <a class="reference internal" href="gmt.html#v-full"><em>(more ...)</em></a></dt>
-<dd>Select verbosity level [c]. </dd>
-<dt><strong>-Z</strong>[<em>flags</em>]</dt>
-<dd><p class="first">Read a 1-column ASCII [or binary] table. This assumes that all the
-nodes are present and sorted according to specified ordering
-convention contained in <em>flags</em>. If incoming data represents rows,
-make <em>flags</em> start with <strong>T</strong>(op) if first row is y
-= ymax or <strong>B</strong>(ottom) if first row is y = ymin.
-Then, append <strong>L</strong> or <strong>R</strong> to indicate that first element is at
-left or right end of row. Likewise for column formats: start with
-<strong>L</strong> or <strong>R</strong> to position first column, and then append <strong>T</strong> or
-<strong>B</strong> to position first element in a row. Note: These two row/column
-indicators are only required for grids; for other tables they do not
-apply. For gridline registered grids: If data are periodic in x but
-the incoming data do not contain the (redundant) column at x = xmax,
-append <strong>x</strong>. For data periodic in y without redundant row at y =
-ymax, append <strong>y</strong>. Append <strong>s</strong><em>n</em> to skip the first <em>n</em> number
-of bytes (probably a header). If the byte-order or the words needs
-to be swapped, append <strong>w</strong>. Select one of several data types (all
-binary except <strong>a</strong>):</p>
-<p><strong>A</strong> ASCII representation of one or more floating point values per record</p>
-<p><strong>a</strong> ASCII representation of a single item per record</p>
-<p><strong>c</strong> int8_t, signed 1-byte character</p>
-<p><strong>u</strong> uint8_t, unsigned 1-byte character</p>
-<p><strong>h</strong> int16_t, signed 2-byte integer</p>
-<p><strong>H</strong> uint16_t, unsigned 2-byte integer</p>
-<p><strong>i</strong> int32_t, signed 4-byte integer</p>
-<p><strong>I</strong> uint32_t, unsigned 4-byte integer</p>
-<p><strong>l</strong> int64_t, long (8-byte) integer</p>
-<p><strong>L</strong> uint64_t, unsigned long (8-byte) integer</p>
-<p><strong>f</strong> 4-byte floating point single precision</p>
-<p><strong>d</strong> 8-byte floating point double precision</p>
-<p class="last">Default format is scanline orientation of ASCII numbers: <strong>-ZTLa</strong>.
-Note that <strong>-Z</strong> only applies to 1-column input. The difference
-between <strong>A</strong> and <strong>a</strong> is that the latter can decode both
-<em>date</em><strong>T</strong><em>clock</em> and <em>ddd:mm:ss[.xx]</em> formats while the former
-is strictly for regular floating point values.</p>
-</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-bi</strong>[<em>ncols</em>][<em>type</em>] <a class="reference internal" href="gmt.html#bi-full"><em>(more ...)</em></a></dt>
-<dd>Select binary input. [Default is 3 input columns]. This option only applies
-to xyz input files; see <strong>-Z</strong> for z tables.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-f</strong>[<strong>i</strong>|<strong>o</strong>]<em>colinfo</em> <a class="reference internal" href="gmt.html#f-full"><em>(more ...)</em></a></dt>
-<dd>Specify data types of input and/or output columns. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-h</strong>[<strong>i</strong>|<strong>o</strong>][<em>n</em>][<strong>+c</strong>][<strong>+d</strong>][<strong>+r</strong><em>remark</em>][<strong>+r</strong><em>title</em>] <a class="reference internal" href="gmt.html#h-full"><em>(more ...)</em></a></dt>
-<dd>Skip or produce header record(s). Not used with binary data.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-i</strong><em>cols</em>[<strong>l</strong>][<strong>s</strong><em>scale</em>][<strong>o</strong><em>offset</em>][,<em>...</em>] <a class="reference internal" href="gmt.html#icols-full"><em>(more ...)</em></a></dt>
-<dd>Select input columns (0 is first column).</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-r</strong> <a class="reference internal" href="gmt.html#nodereg-full"><em>(more ...)</em></a></dt>
-<dd>Set pixel node registration [gridline]. </dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-:</strong>[<strong>i</strong>|<strong>o</strong>] <a class="reference internal" href="gmt.html#colon-full"><em>(more ...)</em></a></dt>
-<dd>Swap 1st and 2nd column on input and/or output.</dd>
-</dl>
-<dl class="docutils">
-<dt><strong>-^</strong> or just <strong>-</strong></dt>
-<dd>Print a short message about the syntax of the command, then exits (NOTE: on Windows use just <strong>-</strong>).</dd>
-<dt><strong>-+</strong> or just <strong>+</strong></dt>
-<dd>Print an extensive usage (help) message, including the explanation of
-any module-specific option (but not the GMT common options), then exits.</dd>
-<dt><strong>-?</strong> or no arguments</dt>
-<dd>Print a complete usage (help) message, including the explanation of
-options, then exits.</dd>
-<dt><strong>-</strong><strong>-version</strong></dt>
-<dd>Print GMT version and exit.</dd>
-<dt><strong>-</strong><strong>-show-datadir</strong></dt>
-<dd>Print full path to GMT share directory and exit.</dd>
-</dl>
-</div>
-<div class="section" id="grid-values-precision">
-<h2>Grid Values Precision<a class="headerlink" href="#grid-values-precision" title="Permalink to this headline">¶</a></h2>
-<p>Regardless of the precision of the input data, GMT programs that create
-grid files will internally hold the grids in 4-byte floating point
-arrays. This is done to conserve memory and furthermore most if not all
-real data can be stored using 4-byte floating point values. Data with
-higher precision (i.e., double precision values) will lose that
-precision once GMT operates on the grid or writes out new grids. To
-limit loss of precision when processing data you should always consider
-normalizing the data prior to processing.</p>
-</div>
-<div class="section" id="grid-file-formats">
-<h2>Grid File Formats<a class="headerlink" href="#grid-file-formats" title="Permalink to this headline">¶</a></h2>
-<p>By default GMT writes out grid as single precision floats in a
-COARDS-complaint netCDF file format. However, GMT is able to produce
-grid files in many other commonly used grid file formats and also
-facilitates so called “packing” of grids, writing out floating point
-data as 1- or 2-byte integers. To specify the precision, scale and
-offset, the user should add the suffix
-<strong>=</strong><em>id</em>[<strong>/</strong><em>scale</em><strong>/</strong><em>offset</em>[<strong>/</strong><em>nan</em>]], where
-<em>id</em> is a two-letter identifier of the grid type and precision, and
-<em>scale</em> and <em>offset</em> are optional scale factor and offset to be applied
-to all grid values, and <em>nan</em> is the value used to indicate missing
-data. See <a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a> and Section
-<a class="reference internal" href="GMT_Docs.html#grid-file-format"><em>Grid file format specifications</em></a>
-of the GMT Technical Reference and Cookbook for more information.</p>
-<p>When writing a netCDF file, the grid is stored by default with the
-variable name “z”. To specify another variable name <em>varname</em>, append
-<strong>?</strong><em>varname</em> to the file name. Note that you may need to escape the
-special meaning of <strong>?</strong> in your shell program by putting a backslash in
-front of it, or by placing the filename and suffix between quotes or
-double quotes.</p>
-</div>
-<div class="section" id="geographical-and-time-coordinates">
-<h2>Geographical And Time Coordinates<a class="headerlink" href="#geographical-and-time-coordinates" title="Permalink to this headline">¶</a></h2>
-<p>When the output grid type is netCDF, the coordinates will be labeled
-“longitude”, “latitude”, or “time” based on the attributes of the input
-data or grid (if any) or on the <strong>-f</strong> or <strong>-R</strong> options. For example,
-both <strong>-f0x</strong> <strong>-f1t</strong> and <strong>-R</strong>90w/90e/0t/3t will result in a
-longitude/time grid. When the x, y, or z coordinate is time, it will be
-stored in the grid as relative time since epoch as specified by
-<a class="reference internal" href="gmt.conf.html#time-unit"><em>TIME_UNIT</em></a> and <a class="reference internal" href="gmt.conf.html#time-epoch"><em>TIME_EPOCH</em></a> in the
-<a class="reference internal" href="gmt.conf.html"><em>gmt.conf</em></a> file or on the
-command line. In addition, the <strong>unit</strong> attribute of the time variable
-will indicate both this unit and epoch.</p>
-</div>
-<div class="section" id="swapping-limitations">
-<h2>Swapping Limitations<a class="headerlink" href="#swapping-limitations" title="Permalink to this headline">¶</a></h2>
-<p>All data types can be read, even 64-bit integers, but internally grids
-are stored using floats. Hence, integer values exceeding the float
-type’s 23-bit mantissa may not be represented exactly. When <strong>-S</strong> is
-used no grids are implied and we read data into an intermediate double
-container. This means all but 64-bit integers can be represented using
-the double type’s 53-bit mantissa.</p>
-</div>
-<div class="section" id="examples">
-<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
-<p>To create a grid file from the ASCII data in hawaii_grv.xyz, use</p>
-<blockquote>
-<div><dl class="docutils">
-<dt>gmt xyz2grd hawaii_grv.xyz -Ddegree/degree/mGal/1/0//”Hawaiian Gravity”/”GRS-80 Ellipsoid used” </dt>
-<dd>-Ghawaii_grv_new.nc -R198/208/18/25 -I5m -V</dd>
-</dl>
-</div></blockquote>
-<p>To create a grid file from the raw binary (3-column, single-precision
-scanline-oriented data raw.b, use</p>
-<blockquote>
-<div>gmt xyz2grd raw.b -Dm/m/m/1/0 -Graw.nc -R0/100/0/100 -I1 -V -Z -bi3f</div></blockquote>
-<p>To make a grid file from the raw binary USGS DEM (short integer
-scanline-oriented data topo30. on the NGDC global relief Data CD-ROM,
-with values of -9999 indicate missing data, one must on some machine
-reverse the byte-order. On such machines (like Sun, use</p>
-<blockquote>
-<div>gmt xyz2grd topo30. -Dm/m/m/1/0 -Gustopo.nc -R234/294/24/50 -I30s -N-9999 -B -ZTLhw</div></blockquote>
-<p>Say you have received a binary file with 4-byte floating points that
-were written on a machine of different byte-order than yours. You can
-swap the byte-order with</p>
-<blockquote>
-<div>gmt xyz2grd floats.bin -Snew_floats.bin -V -Zf</div></blockquote>
-</div>
-<div class="section" id="see-also">
-<h2>See Also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="gmt.html"><em>gmt</em></a>,
-<a class="reference internal" href="grd2xyz.html"><em>grd2xyz</em></a>,
-<a class="reference internal" href="grdedit.html"><em>grdedit</em></a>,
-<a class="reference internal" href="grdreformat.html"><em>grdreformat</em></a></p>
-</div>
-</div>
-
-
- </div>
- </div>
- </div>
- <div class="sphinxsidebar">
- <div class="sphinxsidebarwrapper">
- <h3><a href="index.html">Table Of Contents</a></h3>
- <ul>
-<li><a class="reference internal" href="#">xyz2grd</a><ul>
-<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
-<li><a class="reference internal" href="#description">Description</a></li>
-<li><a class="reference internal" href="#required-arguments">Required Arguments</a></li>
-<li><a class="reference internal" href="#optional-arguments">Optional Arguments</a></li>
-<li><a class="reference internal" href="#grid-values-precision">Grid Values Precision</a></li>
-<li><a class="reference internal" href="#grid-file-formats">Grid File Formats</a></li>
-<li><a class="reference internal" href="#geographical-and-time-coordinates">Geographical And Time Coordinates</a></li>
-<li><a class="reference internal" href="#swapping-limitations">Swapping Limitations</a></li>
-<li><a class="reference internal" href="#examples">Examples</a></li>
-<li><a class="reference internal" href="#see-also">See Also</a></li>
-</ul>
-</li>
-</ul>
-
- <h4>Previous topic</h4>
- <p class="topless"><a href="X.html"
- title="previous chapter">X</a></p>
- <h4>Next topic</h4>
- <p class="topless"><a href="SUP_GSHHS.html"
- title="next chapter">GSHHG</a></p>
- <h3>This Page</h3>
- <ul class="this-page-menu">
- <li><a href="_sources/xyz2grd.txt"
- rel="nofollow">Show Source</a></li>
- </ul>
- </div>
- </div>
- <div class="clearer"></div>
- </div>
- <div class="related">
- <h3>Navigation</h3>
- <ul>
- <li class="right" style="margin-right: 10px">
- <a href="genindex.html" title="General Index"
- >index</a></li>
- <li class="right" >
- <a href="SUP_GSHHS.html" title="GSHHG"
- >next</a> </li>
- <li class="right" >
- <a href="X.html" title="X"
- >previous</a> </li>
- <li><a href="/projects/gmt/wiki/Documentation">Project Home</a> »</li>
-
- <li><a href="index.html">GMT 5.1.2 documentation</a> »</li>
-
- <li><a href="X.html" >X</a> »</li>
-<li class="right">
-<form class="search" accept-charset="UTF-8" action="search.html" method="get">
- <div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="✓"></div>
- <label for="q">
- <a class="search" href="search.html" accesskey="s" original-title="">Search:</a>
- </label>
- <input accesskey="f" class="small" id="q" name="q" size="20" type="text">
- <input type="hidden" name="check_keywords" value="yes">
- <input type="hidden" name="area" value="default">
-</form></li>
-
-
- </ul>
- </div>
-<div class="footer">
- © Copyright 2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe.
- Last updated on May 04, 2015.
- Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.3.
- <br />Theme based on <a href="http://readthedocs.org/">Read The Docs</a>
-
-</div>
-
-
- </body>
-</html>
\ No newline at end of file
diff --git a/doc_release/pdf/GMT_API.pdf b/doc_release/pdf/GMT_API.pdf
deleted file mode 100644
index 63eccf2..0000000
Binary files a/doc_release/pdf/GMT_API.pdf and /dev/null differ
diff --git a/doc_release/pdf/GMT_Docs.pdf b/doc_release/pdf/GMT_Docs.pdf
deleted file mode 100644
index bf9112b..0000000
Binary files a/doc_release/pdf/GMT_Docs.pdf and /dev/null differ
diff --git a/doc_release/pdf/GMT_Manpages.pdf b/doc_release/pdf/GMT_Manpages.pdf
deleted file mode 100644
index 0707230..0000000
Binary files a/doc_release/pdf/GMT_Manpages.pdf and /dev/null differ
diff --git a/doc_release/pdf/GMT_RGBchart_a4.pdf b/doc_release/pdf/GMT_RGBchart_a4.pdf
deleted file mode 100644
index da11c1c..0000000
Binary files a/doc_release/pdf/GMT_RGBchart_a4.pdf and /dev/null differ
diff --git a/doc_release/pdf/GMT_RGBchart_letter.pdf b/doc_release/pdf/GMT_RGBchart_letter.pdf
deleted file mode 100644
index 2284b45..0000000
Binary files a/doc_release/pdf/GMT_RGBchart_letter.pdf and /dev/null differ
diff --git a/doc_release/pdf/GMT_RGBchart_tabloid.pdf b/doc_release/pdf/GMT_RGBchart_tabloid.pdf
deleted file mode 100644
index d84f4f5..0000000
Binary files a/doc_release/pdf/GMT_RGBchart_tabloid.pdf and /dev/null differ
diff --git a/man_release/backtracker.1.gz b/man_release/backtracker.1.gz
deleted file mode 100644
index d631262..0000000
Binary files a/man_release/backtracker.1.gz and /dev/null differ
diff --git a/man_release/blockmean.1.gz b/man_release/blockmean.1.gz
deleted file mode 100644
index 9028d16..0000000
Binary files a/man_release/blockmean.1.gz and /dev/null differ
diff --git a/man_release/blockmedian.1.gz b/man_release/blockmedian.1.gz
deleted file mode 100644
index 37b1476..0000000
Binary files a/man_release/blockmedian.1.gz and /dev/null differ
diff --git a/man_release/blockmode.1.gz b/man_release/blockmode.1.gz
deleted file mode 100644
index bd0445a..0000000
Binary files a/man_release/blockmode.1.gz and /dev/null differ
diff --git a/man_release/dimfilter.1.gz b/man_release/dimfilter.1.gz
deleted file mode 100644
index c08d9fd..0000000
Binary files a/man_release/dimfilter.1.gz and /dev/null differ
diff --git a/man_release/filter1d.1.gz b/man_release/filter1d.1.gz
deleted file mode 100644
index 54ad5de..0000000
Binary files a/man_release/filter1d.1.gz and /dev/null differ
diff --git a/man_release/fitcircle.1.gz b/man_release/fitcircle.1.gz
deleted file mode 100644
index 348aa1d..0000000
Binary files a/man_release/fitcircle.1.gz and /dev/null differ
diff --git a/man_release/gmt.1.gz b/man_release/gmt.1.gz
deleted file mode 100644
index b50d300..0000000
Binary files a/man_release/gmt.1.gz and /dev/null differ
diff --git a/man_release/gmt.conf.5.gz b/man_release/gmt.conf.5.gz
deleted file mode 100644
index e35c4d5..0000000
Binary files a/man_release/gmt.conf.5.gz and /dev/null differ
diff --git a/man_release/gmt2kml.1.gz b/man_release/gmt2kml.1.gz
deleted file mode 100644
index 410fe77..0000000
Binary files a/man_release/gmt2kml.1.gz and /dev/null differ
diff --git a/man_release/gmt5syntax.1.gz b/man_release/gmt5syntax.1.gz
deleted file mode 100644
index b0c11d9..0000000
Binary files a/man_release/gmt5syntax.1.gz and /dev/null differ
diff --git a/man_release/gmt_shell_functions.sh.1.gz b/man_release/gmt_shell_functions.sh.1.gz
deleted file mode 100644
index 76ee562..0000000
Binary files a/man_release/gmt_shell_functions.sh.1.gz and /dev/null differ
diff --git a/man_release/gmtcolors.5.gz b/man_release/gmtcolors.5.gz
deleted file mode 100644
index e7eacf6..0000000
Binary files a/man_release/gmtcolors.5.gz and /dev/null differ
diff --git a/man_release/gmtconnect.1.gz b/man_release/gmtconnect.1.gz
deleted file mode 100644
index e190484..0000000
Binary files a/man_release/gmtconnect.1.gz and /dev/null differ
diff --git a/man_release/gmtconvert.1.gz b/man_release/gmtconvert.1.gz
deleted file mode 100644
index 5b522f5..0000000
Binary files a/man_release/gmtconvert.1.gz and /dev/null differ
diff --git a/man_release/gmtdefaults.1.gz b/man_release/gmtdefaults.1.gz
deleted file mode 100644
index 5fbba54..0000000
Binary files a/man_release/gmtdefaults.1.gz and /dev/null differ
diff --git a/man_release/gmtget.1.gz b/man_release/gmtget.1.gz
deleted file mode 100644
index f12b91f..0000000
Binary files a/man_release/gmtget.1.gz and /dev/null differ
diff --git a/man_release/gmtgravmag3d.1.gz b/man_release/gmtgravmag3d.1.gz
deleted file mode 100644
index 0dfd8fa..0000000
Binary files a/man_release/gmtgravmag3d.1.gz and /dev/null differ
diff --git a/man_release/gmtinfo.1.gz b/man_release/gmtinfo.1.gz
deleted file mode 100644
index 66e652b..0000000
Binary files a/man_release/gmtinfo.1.gz and /dev/null differ
diff --git a/man_release/gmtlogo.1.gz b/man_release/gmtlogo.1.gz
deleted file mode 100644
index dedf28d..0000000
Binary files a/man_release/gmtlogo.1.gz and /dev/null differ
diff --git a/man_release/gmtmath.1.gz b/man_release/gmtmath.1.gz
deleted file mode 100644
index f3ecc7c..0000000
Binary files a/man_release/gmtmath.1.gz and /dev/null differ
diff --git a/man_release/gmtselect.1.gz b/man_release/gmtselect.1.gz
deleted file mode 100644
index 37f2a68..0000000
Binary files a/man_release/gmtselect.1.gz and /dev/null differ
diff --git a/man_release/gmtset.1.gz b/man_release/gmtset.1.gz
deleted file mode 100644
index a4d3f18..0000000
Binary files a/man_release/gmtset.1.gz and /dev/null differ
diff --git a/man_release/gmtsimplify.1.gz b/man_release/gmtsimplify.1.gz
deleted file mode 100644
index 24305b8..0000000
Binary files a/man_release/gmtsimplify.1.gz and /dev/null differ
diff --git a/man_release/gmtspatial.1.gz b/man_release/gmtspatial.1.gz
deleted file mode 100644
index aa55773..0000000
Binary files a/man_release/gmtspatial.1.gz and /dev/null differ
diff --git a/man_release/gmtswitch.1.gz b/man_release/gmtswitch.1.gz
deleted file mode 100644
index 0d7ed82..0000000
Binary files a/man_release/gmtswitch.1.gz and /dev/null differ
diff --git a/man_release/gmtvector.1.gz b/man_release/gmtvector.1.gz
deleted file mode 100644
index 5864c99..0000000
Binary files a/man_release/gmtvector.1.gz and /dev/null differ
diff --git a/man_release/gmtwhich.1.gz b/man_release/gmtwhich.1.gz
deleted file mode 100644
index 87e3e1f..0000000
Binary files a/man_release/gmtwhich.1.gz and /dev/null differ
diff --git a/man_release/gravfft.1.gz b/man_release/gravfft.1.gz
deleted file mode 100644
index 2cbc05b..0000000
Binary files a/man_release/gravfft.1.gz and /dev/null differ
diff --git a/man_release/grd2cpt.1.gz b/man_release/grd2cpt.1.gz
deleted file mode 100644
index b1feb8d..0000000
Binary files a/man_release/grd2cpt.1.gz and /dev/null differ
diff --git a/man_release/grd2rgb.1.gz b/man_release/grd2rgb.1.gz
deleted file mode 100644
index 0db8d76..0000000
Binary files a/man_release/grd2rgb.1.gz and /dev/null differ
diff --git a/man_release/grd2xyz.1.gz b/man_release/grd2xyz.1.gz
deleted file mode 100644
index ab16453..0000000
Binary files a/man_release/grd2xyz.1.gz and /dev/null differ
diff --git a/man_release/grdblend.1.gz b/man_release/grdblend.1.gz
deleted file mode 100644
index 775162f..0000000
Binary files a/man_release/grdblend.1.gz and /dev/null differ
diff --git a/man_release/grdclip.1.gz b/man_release/grdclip.1.gz
deleted file mode 100644
index 1959ec6..0000000
Binary files a/man_release/grdclip.1.gz and /dev/null differ
diff --git a/man_release/grdcontour.1.gz b/man_release/grdcontour.1.gz
deleted file mode 100644
index 1ad148c..0000000
Binary files a/man_release/grdcontour.1.gz and /dev/null differ
diff --git a/man_release/grdcut.1.gz b/man_release/grdcut.1.gz
deleted file mode 100644
index 1b09031..0000000
Binary files a/man_release/grdcut.1.gz and /dev/null differ
diff --git a/man_release/grdedit.1.gz b/man_release/grdedit.1.gz
deleted file mode 100644
index 566d8ab..0000000
Binary files a/man_release/grdedit.1.gz and /dev/null differ
diff --git a/man_release/grdfft.1.gz b/man_release/grdfft.1.gz
deleted file mode 100644
index d817bd5..0000000
Binary files a/man_release/grdfft.1.gz and /dev/null differ
diff --git a/man_release/grdfilter.1.gz b/man_release/grdfilter.1.gz
deleted file mode 100644
index 576258f..0000000
Binary files a/man_release/grdfilter.1.gz and /dev/null differ
diff --git a/man_release/grdgradient.1.gz b/man_release/grdgradient.1.gz
deleted file mode 100644
index eb4327b..0000000
Binary files a/man_release/grdgradient.1.gz and /dev/null differ
diff --git a/man_release/grdgravmag3d.1.gz b/man_release/grdgravmag3d.1.gz
deleted file mode 100644
index 9d678e3..0000000
Binary files a/man_release/grdgravmag3d.1.gz and /dev/null differ
diff --git a/man_release/grdhisteq.1.gz b/man_release/grdhisteq.1.gz
deleted file mode 100644
index d5cc2c5..0000000
Binary files a/man_release/grdhisteq.1.gz and /dev/null differ
diff --git a/man_release/grdimage.1.gz b/man_release/grdimage.1.gz
deleted file mode 100644
index a87d178..0000000
Binary files a/man_release/grdimage.1.gz and /dev/null differ
diff --git a/man_release/grdinfo.1.gz b/man_release/grdinfo.1.gz
deleted file mode 100644
index 8c609b7..0000000
Binary files a/man_release/grdinfo.1.gz and /dev/null differ
diff --git a/man_release/grdlandmask.1.gz b/man_release/grdlandmask.1.gz
deleted file mode 100644
index 49e94d3..0000000
Binary files a/man_release/grdlandmask.1.gz and /dev/null differ
diff --git a/man_release/grdmask.1.gz b/man_release/grdmask.1.gz
deleted file mode 100644
index 811fac7..0000000
Binary files a/man_release/grdmask.1.gz and /dev/null differ
diff --git a/man_release/grdmath.1.gz b/man_release/grdmath.1.gz
deleted file mode 100644
index 9857a36..0000000
Binary files a/man_release/grdmath.1.gz and /dev/null differ
diff --git a/man_release/grdpaste.1.gz b/man_release/grdpaste.1.gz
deleted file mode 100644
index a41dab0..0000000
Binary files a/man_release/grdpaste.1.gz and /dev/null differ
diff --git a/man_release/grdpmodeler.1.gz b/man_release/grdpmodeler.1.gz
deleted file mode 100644
index 1abff77..0000000
Binary files a/man_release/grdpmodeler.1.gz and /dev/null differ
diff --git a/man_release/grdproject.1.gz b/man_release/grdproject.1.gz
deleted file mode 100644
index 16b9f78..0000000
Binary files a/man_release/grdproject.1.gz and /dev/null differ
diff --git a/man_release/grdraster.1.gz b/man_release/grdraster.1.gz
deleted file mode 100644
index c520b90..0000000
Binary files a/man_release/grdraster.1.gz and /dev/null differ
diff --git a/man_release/grdredpol.1.gz b/man_release/grdredpol.1.gz
deleted file mode 100644
index 54ea499..0000000
Binary files a/man_release/grdredpol.1.gz and /dev/null differ
diff --git a/man_release/grdreformat.1.gz b/man_release/grdreformat.1.gz
deleted file mode 100644
index 18fecca..0000000
Binary files a/man_release/grdreformat.1.gz and /dev/null differ
diff --git a/man_release/grdrotater.1.gz b/man_release/grdrotater.1.gz
deleted file mode 100644
index b745084..0000000
Binary files a/man_release/grdrotater.1.gz and /dev/null differ
diff --git a/man_release/grdsample.1.gz b/man_release/grdsample.1.gz
deleted file mode 100644
index a2237e3..0000000
Binary files a/man_release/grdsample.1.gz and /dev/null differ
diff --git a/man_release/grdseamount.1.gz b/man_release/grdseamount.1.gz
deleted file mode 100644
index 5515792..0000000
Binary files a/man_release/grdseamount.1.gz and /dev/null differ
diff --git a/man_release/grdspotter.1.gz b/man_release/grdspotter.1.gz
deleted file mode 100644
index ff5c1a2..0000000
Binary files a/man_release/grdspotter.1.gz and /dev/null differ
diff --git a/man_release/grdtrack.1.gz b/man_release/grdtrack.1.gz
deleted file mode 100644
index 71cb21f..0000000
Binary files a/man_release/grdtrack.1.gz and /dev/null differ
diff --git a/man_release/grdtrend.1.gz b/man_release/grdtrend.1.gz
deleted file mode 100644
index db16362..0000000
Binary files a/man_release/grdtrend.1.gz and /dev/null differ
diff --git a/man_release/grdvector.1.gz b/man_release/grdvector.1.gz
deleted file mode 100644
index b68b59c..0000000
Binary files a/man_release/grdvector.1.gz and /dev/null differ
diff --git a/man_release/grdview.1.gz b/man_release/grdview.1.gz
deleted file mode 100644
index 7cf6bc2..0000000
Binary files a/man_release/grdview.1.gz and /dev/null differ
diff --git a/man_release/grdvolume.1.gz b/man_release/grdvolume.1.gz
deleted file mode 100644
index a0f9b39..0000000
Binary files a/man_release/grdvolume.1.gz and /dev/null differ
diff --git a/man_release/greenspline.1.gz b/man_release/greenspline.1.gz
deleted file mode 100644
index c693d7b..0000000
Binary files a/man_release/greenspline.1.gz and /dev/null differ
diff --git a/man_release/gshhg.1.gz b/man_release/gshhg.1.gz
deleted file mode 100644
index b80fd5c..0000000
Binary files a/man_release/gshhg.1.gz and /dev/null differ
diff --git a/man_release/hotspotter.1.gz b/man_release/hotspotter.1.gz
deleted file mode 100644
index 1799989..0000000
Binary files a/man_release/hotspotter.1.gz and /dev/null differ
diff --git a/man_release/img2grd.1.gz b/man_release/img2grd.1.gz
deleted file mode 100644
index c409418..0000000
Binary files a/man_release/img2grd.1.gz and /dev/null differ
diff --git a/man_release/isogmt.1.gz b/man_release/isogmt.1.gz
deleted file mode 100644
index 2dc5e29..0000000
Binary files a/man_release/isogmt.1.gz and /dev/null differ
diff --git a/man_release/kml2gmt.1.gz b/man_release/kml2gmt.1.gz
deleted file mode 100644
index b732aad..0000000
Binary files a/man_release/kml2gmt.1.gz and /dev/null differ
diff --git a/man_release/makecpt.1.gz b/man_release/makecpt.1.gz
deleted file mode 100644
index 7f9fb53..0000000
Binary files a/man_release/makecpt.1.gz and /dev/null differ
diff --git a/man_release/mapproject.1.gz b/man_release/mapproject.1.gz
deleted file mode 100644
index 3470940..0000000
Binary files a/man_release/mapproject.1.gz and /dev/null differ
diff --git a/man_release/mgd77convert.1.gz b/man_release/mgd77convert.1.gz
deleted file mode 100644
index fbac983..0000000
Binary files a/man_release/mgd77convert.1.gz and /dev/null differ
diff --git a/man_release/mgd77info.1.gz b/man_release/mgd77info.1.gz
deleted file mode 100644
index d349f26..0000000
Binary files a/man_release/mgd77info.1.gz and /dev/null differ
diff --git a/man_release/mgd77list.1.gz b/man_release/mgd77list.1.gz
deleted file mode 100644
index 8c3dad6..0000000
Binary files a/man_release/mgd77list.1.gz and /dev/null differ
diff --git a/man_release/mgd77magref.1.gz b/man_release/mgd77magref.1.gz
deleted file mode 100644
index 5b93b39..0000000
Binary files a/man_release/mgd77magref.1.gz and /dev/null differ
diff --git a/man_release/mgd77manage.1.gz b/man_release/mgd77manage.1.gz
deleted file mode 100644
index de602a3..0000000
Binary files a/man_release/mgd77manage.1.gz and /dev/null differ
diff --git a/man_release/mgd77path.1.gz b/man_release/mgd77path.1.gz
deleted file mode 100644
index e475c1e..0000000
Binary files a/man_release/mgd77path.1.gz and /dev/null differ
diff --git a/man_release/mgd77sniffer.1.gz b/man_release/mgd77sniffer.1.gz
deleted file mode 100644
index 35b22e7..0000000
Binary files a/man_release/mgd77sniffer.1.gz and /dev/null differ
diff --git a/man_release/mgd77track.1.gz b/man_release/mgd77track.1.gz
deleted file mode 100644
index f951953..0000000
Binary files a/man_release/mgd77track.1.gz and /dev/null differ
diff --git a/man_release/nearneighbor.1.gz b/man_release/nearneighbor.1.gz
deleted file mode 100644
index 069ec7b..0000000
Binary files a/man_release/nearneighbor.1.gz and /dev/null differ
diff --git a/man_release/originator.1.gz b/man_release/originator.1.gz
deleted file mode 100644
index e2d99b9..0000000
Binary files a/man_release/originator.1.gz and /dev/null differ
diff --git a/man_release/project.1.gz b/man_release/project.1.gz
deleted file mode 100644
index 48d8a93..0000000
Binary files a/man_release/project.1.gz and /dev/null differ
diff --git a/man_release/ps2raster.1.gz b/man_release/ps2raster.1.gz
deleted file mode 100644
index 115a7b8..0000000
Binary files a/man_release/ps2raster.1.gz and /dev/null differ
diff --git a/man_release/psbasemap.1.gz b/man_release/psbasemap.1.gz
deleted file mode 100644
index 1bcc5f4..0000000
Binary files a/man_release/psbasemap.1.gz and /dev/null differ
diff --git a/man_release/psclip.1.gz b/man_release/psclip.1.gz
deleted file mode 100644
index 28c6a7b..0000000
Binary files a/man_release/psclip.1.gz and /dev/null differ
diff --git a/man_release/pscoast.1.gz b/man_release/pscoast.1.gz
deleted file mode 100644
index 4a06162..0000000
Binary files a/man_release/pscoast.1.gz and /dev/null differ
diff --git a/man_release/pscontour.1.gz b/man_release/pscontour.1.gz
deleted file mode 100644
index ea99240..0000000
Binary files a/man_release/pscontour.1.gz and /dev/null differ
diff --git a/man_release/pscoupe.1.gz b/man_release/pscoupe.1.gz
deleted file mode 100644
index 5a89acf..0000000
Binary files a/man_release/pscoupe.1.gz and /dev/null differ
diff --git a/man_release/pshistogram.1.gz b/man_release/pshistogram.1.gz
deleted file mode 100644
index 2e300d0..0000000
Binary files a/man_release/pshistogram.1.gz and /dev/null differ
diff --git a/man_release/psimage.1.gz b/man_release/psimage.1.gz
deleted file mode 100644
index 204c32e..0000000
Binary files a/man_release/psimage.1.gz and /dev/null differ
diff --git a/man_release/pslegend.1.gz b/man_release/pslegend.1.gz
deleted file mode 100644
index 5cfca68..0000000
Binary files a/man_release/pslegend.1.gz and /dev/null differ
diff --git a/man_release/pslib.3.gz b/man_release/pslib.3.gz
deleted file mode 100644
index 742b0ba..0000000
Binary files a/man_release/pslib.3.gz and /dev/null differ
diff --git a/man_release/psmask.1.gz b/man_release/psmask.1.gz
deleted file mode 100644
index 6720e4d..0000000
Binary files a/man_release/psmask.1.gz and /dev/null differ
diff --git a/man_release/psmeca.1.gz b/man_release/psmeca.1.gz
deleted file mode 100644
index b4bd8bd..0000000
Binary files a/man_release/psmeca.1.gz and /dev/null differ
diff --git a/man_release/pspolar.1.gz b/man_release/pspolar.1.gz
deleted file mode 100644
index b22e0b3..0000000
Binary files a/man_release/pspolar.1.gz and /dev/null differ
diff --git a/man_release/psrose.1.gz b/man_release/psrose.1.gz
deleted file mode 100644
index 9fa38c2..0000000
Binary files a/man_release/psrose.1.gz and /dev/null differ
diff --git a/man_release/psscale.1.gz b/man_release/psscale.1.gz
deleted file mode 100644
index bb28353..0000000
Binary files a/man_release/psscale.1.gz and /dev/null differ
diff --git a/man_release/pssegy.1.gz b/man_release/pssegy.1.gz
deleted file mode 100644
index 3a4a055..0000000
Binary files a/man_release/pssegy.1.gz and /dev/null differ
diff --git a/man_release/pssegyz.1.gz b/man_release/pssegyz.1.gz
deleted file mode 100644
index 0d05d8e..0000000
Binary files a/man_release/pssegyz.1.gz and /dev/null differ
diff --git a/man_release/pstext.1.gz b/man_release/pstext.1.gz
deleted file mode 100644
index 537149c..0000000
Binary files a/man_release/pstext.1.gz and /dev/null differ
diff --git a/man_release/psvelo.1.gz b/man_release/psvelo.1.gz
deleted file mode 100644
index 15c5a96..0000000
Binary files a/man_release/psvelo.1.gz and /dev/null differ
diff --git a/man_release/pswiggle.1.gz b/man_release/pswiggle.1.gz
deleted file mode 100644
index 5e8056d..0000000
Binary files a/man_release/pswiggle.1.gz and /dev/null differ
diff --git a/man_release/psxy.1.gz b/man_release/psxy.1.gz
deleted file mode 100644
index 2bc4cb9..0000000
Binary files a/man_release/psxy.1.gz and /dev/null differ
diff --git a/man_release/psxyz.1.gz b/man_release/psxyz.1.gz
deleted file mode 100644
index 11ce84f..0000000
Binary files a/man_release/psxyz.1.gz and /dev/null differ
diff --git a/man_release/rotconverter.1.gz b/man_release/rotconverter.1.gz
deleted file mode 100644
index 2ace087..0000000
Binary files a/man_release/rotconverter.1.gz and /dev/null differ
diff --git a/man_release/sample1d.1.gz b/man_release/sample1d.1.gz
deleted file mode 100644
index 5d9b378..0000000
Binary files a/man_release/sample1d.1.gz and /dev/null differ
diff --git a/man_release/segy2grd.1.gz b/man_release/segy2grd.1.gz
deleted file mode 100644
index 6378fcb..0000000
Binary files a/man_release/segy2grd.1.gz and /dev/null differ
diff --git a/man_release/spectrum1d.1.gz b/man_release/spectrum1d.1.gz
deleted file mode 100644
index 19af602..0000000
Binary files a/man_release/spectrum1d.1.gz and /dev/null differ
diff --git a/man_release/sph2grd.1.gz b/man_release/sph2grd.1.gz
deleted file mode 100644
index 250697e..0000000
Binary files a/man_release/sph2grd.1.gz and /dev/null differ
diff --git a/man_release/sphdistance.1.gz b/man_release/sphdistance.1.gz
deleted file mode 100644
index 64c32df..0000000
Binary files a/man_release/sphdistance.1.gz and /dev/null differ
diff --git a/man_release/sphinterpolate.1.gz b/man_release/sphinterpolate.1.gz
deleted file mode 100644
index 2bec1fa..0000000
Binary files a/man_release/sphinterpolate.1.gz and /dev/null differ
diff --git a/man_release/sphtriangulate.1.gz b/man_release/sphtriangulate.1.gz
deleted file mode 100644
index ae367ec..0000000
Binary files a/man_release/sphtriangulate.1.gz and /dev/null differ
diff --git a/man_release/splitxyz.1.gz b/man_release/splitxyz.1.gz
deleted file mode 100644
index 73eb460..0000000
Binary files a/man_release/splitxyz.1.gz and /dev/null differ
diff --git a/man_release/surface.1.gz b/man_release/surface.1.gz
deleted file mode 100644
index 517eca3..0000000
Binary files a/man_release/surface.1.gz and /dev/null differ
diff --git a/man_release/trend1d.1.gz b/man_release/trend1d.1.gz
deleted file mode 100644
index cb8d99d..0000000
Binary files a/man_release/trend1d.1.gz and /dev/null differ
diff --git a/man_release/trend2d.1.gz b/man_release/trend2d.1.gz
deleted file mode 100644
index 76aa418..0000000
Binary files a/man_release/trend2d.1.gz and /dev/null differ
diff --git a/man_release/triangulate.1.gz b/man_release/triangulate.1.gz
deleted file mode 100644
index c787fbe..0000000
Binary files a/man_release/triangulate.1.gz and /dev/null differ
diff --git a/man_release/x2sys_binlist.1.gz b/man_release/x2sys_binlist.1.gz
deleted file mode 100644
index 8068894..0000000
Binary files a/man_release/x2sys_binlist.1.gz and /dev/null differ
diff --git a/man_release/x2sys_cross.1.gz b/man_release/x2sys_cross.1.gz
deleted file mode 100644
index 5ce02cd..0000000
Binary files a/man_release/x2sys_cross.1.gz and /dev/null differ
diff --git a/man_release/x2sys_datalist.1.gz b/man_release/x2sys_datalist.1.gz
deleted file mode 100644
index 7a038e3..0000000
Binary files a/man_release/x2sys_datalist.1.gz and /dev/null differ
diff --git a/man_release/x2sys_get.1.gz b/man_release/x2sys_get.1.gz
deleted file mode 100644
index e72702c..0000000
Binary files a/man_release/x2sys_get.1.gz and /dev/null differ
diff --git a/man_release/x2sys_init.1.gz b/man_release/x2sys_init.1.gz
deleted file mode 100644
index acc6162..0000000
Binary files a/man_release/x2sys_init.1.gz and /dev/null differ
diff --git a/man_release/x2sys_list.1.gz b/man_release/x2sys_list.1.gz
deleted file mode 100644
index 5924f34..0000000
Binary files a/man_release/x2sys_list.1.gz and /dev/null differ
diff --git a/man_release/x2sys_merge.1.gz b/man_release/x2sys_merge.1.gz
deleted file mode 100644
index 4d15f0e..0000000
Binary files a/man_release/x2sys_merge.1.gz and /dev/null differ
diff --git a/man_release/x2sys_put.1.gz b/man_release/x2sys_put.1.gz
deleted file mode 100644
index d4487aa..0000000
Binary files a/man_release/x2sys_put.1.gz and /dev/null differ
diff --git a/man_release/x2sys_report.1.gz b/man_release/x2sys_report.1.gz
deleted file mode 100644
index 45c9853..0000000
Binary files a/man_release/x2sys_report.1.gz and /dev/null differ
diff --git a/man_release/x2sys_solve.1.gz b/man_release/x2sys_solve.1.gz
deleted file mode 100644
index 2ac935a..0000000
Binary files a/man_release/x2sys_solve.1.gz and /dev/null differ
diff --git a/man_release/xyz2grd.1.gz b/man_release/xyz2grd.1.gz
deleted file mode 100644
index 5c63e22..0000000
Binary files a/man_release/xyz2grd.1.gz and /dev/null differ
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-grass/gmt.git
More information about the Pkg-grass-devel
mailing list